Get a disk

//native

type Linode = {

  token: string;

};

/**

 * Get a disk

 * View Disk information for a Disk associated with this Linode.

>

---

- __CLI__.

    ```

    linode-cli linodes disk-view 123 25674

    ```

    [Learn more...](https://techdocs.akamai.com/cloud-computing/docs/getting-started-with-the-linode-cli)

- __OAuth scopes__.

    ```

    linodes:read_only

    ```

    [Learn more...](https://techdocs.akamai.com/linode-api/reference/get-started#oauth)

 */

export async function main(

  auth: Linode,

  apiVersion: "v4" | "v4beta",

  linodeId: string,

  diskId: string,

) {

  const url = new URL(

    `https://api.linode.com/${apiVersion}/linode/instances/${linodeId}/disks/${diskId}`,

  );

  const response = await fetch(url, {

    method: "GET",

    headers: {

      Authorization: "Bearer " + auth.token,

    },

    body: undefined,

  });

  if (!response.ok) {

    const text = await response.text();

    throw new Error(`${response.status} ${text}`);

  }

  return await response.json();

}