v1

latestSwagger 2.02026-08-04232286653.5 KB
Disks

Lists all disks in the project and returns their details.

Size of disks will be in gibibytes (GiB)

get/projects/{project_id}/storage/disks

Path parameters

project_idstring required

ID of the project that owns the disks.

Query parameters

disk_idsstring[]

Filters results to disks with these IDs.

locationstring

Filters results to disks in this location.

disk_namesstring[]

Filters results to disks with these names.

exclude_osboolean

Excludes OS disks from the results when true.

Response

Example response

{
  "items": [
    {
      "attached_to": [
        {
          "vm_id": "123e4567-e89b-12d3-a456-426614174000"
        }
      ],
      "block_size": 4096,
      "created_at": "2021-12-03T19:58:34Z",
      "dns_name": "nfs.crusoecloudcompute.com",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "location": "us-northcentral1-a",
      "name": "my-disk",
      "serial_number": "96FD14FDBCF7E21E8EC",
      "size": "10GiB",
      "type": "persistent-ssd",
      "updated_at": "2021-12-03T19:58:34Z",
      "vips": [
        "1.2.3.4",
        "1.2.3.8"
      ]
    }
  ]
}