Retrieve

Retrieve an Existing Block Storage Volume

gpu_droplets.volumes.retrieve(strvolume_id) -> volumeVolumeVolumeRetrieveResponse

get/v2/volumes/{volume_id}

To show information about a block storage volume, send a GET request to /v2/volumes/$VOLUME_ID.

Parameters

volume_idstr

formatuuid

Returns

VolumeRetrieveResponseclass

Hide ParametersShow Parameters

volumeidstrcreated_atstrdescriptionstrdroplet_idslistfilesystem_labelstrfilesystem_typestrnamestrregionRegionsize_gigabytesinttagslistVolume

optional

Hide ParametersShow Parameters

idstr

optional

The unique identifier for the block storage volume.

created_atstr

optional

A time value given in ISO8601 combined date and time format that represents when the block storage volume was created.

descriptionstr

optional

An optional free-form text field to describe a block storage volume.

droplet_idslist

optional

Optional[List[int]]

An array containing the IDs of the Droplets the volume is attached to. Note that at this time, a volume can only be attached to a single Droplet.

filesystem_labelstr

optional

The label currently applied to the filesystem.

filesystem_typestr

optional

The type of filesystem currently in-use on the volume.

namestr

optional

A human-readable name for the block storage volume. Must be lowercase and be composed only of numbers, letters and "-", up to a limit of 64 characters. The name must begin with a letter.

regionRegion

optional

The region that the block storage volume is located in. When setting a region, the value should be the slug identifier for the region. When you query a block storage volume, the entire region object will be returned.

size_gigabytesint

optional

The size of the block storage volume in GiB (1024^3). This field does not apply when creating a volume from a snapshot.

tagslist

optional

Optional[List[str]]

A flat array of tag names as strings applied to the resource.

Requires tag:read scope.

HTTPPython

from do_gradientai import GradientAI

client = GradientAI()
volume = client.gpu_droplets.volumes.retrieve(
    "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
print(volume.volume)

200 Example

{
  "volume": {
    "description": "Block store for examples",
    "filesystem_label": "example",
    "filesystem_type": "ext4",
    "name": "example",
    "size_gigabytes": 10,
    "tags": [
      "base-image",
      "prod"
    ]
  }
}