Retrieve an Existing Block Storage Volume

client.GPUDroplets.Volumes.Get(ctx, volumeID) (*GPUDropletVolumeGetResponse, error)

get/v2/volumes/{volume_id}

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

ParametersExpand Collapse

volumeID string

formatuuid

ReturnsExpand Collapse

type GPUDropletVolumeGetResponse struct{…}

Volume GPUDropletVolumeGetResponseVolumeoptional

ID stringoptional

The unique identifier for the block storage volume.

CreatedAt stringoptional

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

Description stringoptional

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

DropletIDs []int64optional

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.

FilesystemLabel stringoptional

The label currently applied to the filesystem.

FilesystemType stringoptional

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

Name stringoptional

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.

Region Regionoptional

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.

Available bool

This is a boolean value that represents whether new Droplets can be created in this region.

Features []string

This attribute is set to an array which contains features available in this region

Name string

The display name of the region. This will be a full name that is used in the control panel and other interfaces.

Sizes []string

This attribute is set to an array which contains the identifying slugs for the sizes available in this region. sizes:read is required to view.

Slug string

A human-readable string that is used as a unique identifier for each region.

SizeGigabytes int64optional

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

Tags []stringoptional

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

Requires tag:read scope.

Retrieve an Existing Block Storage Volume

package main

import (
  "context"
  "fmt"

  "github.com/stainless-sdks/-go"
  "github.com/stainless-sdks/-go/option"
)

func main() {
  client := gradient.NewClient(
    option.WithAccessToken("My Access Token"),
  )
  volume, err := client.GPUDroplets.Volumes.Get(context.TODO(), "7724db7c-e098-11e5-b522-000f53304e51")
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", volume.Volume)
}

{
  "volume": {
    "id": "506f78a4-e098-11e5-ad9f-000f53306ae1",
    "created_at": "2020-03-02T17:00:49Z",
    "description": "Block store for examples",
    "droplet_ids": [
      0
    ],
    "filesystem_label": "example",
    "filesystem_type": "ext4",
    "name": "example",
    "region": {
      "available": true,
      "features": [
        "private_networking",
        "backups",
        "ipv6",
        "metadata"
      ],
      "name": "New York 1",
      "sizes": [
        "s-1vcpu-1gb",
        "s-1vcpu-2gb",
        "s-1vcpu-3gb",
        "s-2vcpu-2gb",
        "s-3vcpu-1gb",
        "s-2vcpu-4gb",
        "s-4vcpu-8gb",
        "s-6vcpu-16gb",
        "s-8vcpu-32gb",
        "s-12vcpu-48gb",
        "s-16vcpu-64gb",
        "s-20vcpu-96gb",
        "s-24vcpu-128gb",
        "s-32vcpu-192gb"
      ],
      "slug": "nyc1"
    },
    "size_gigabytes": 10,
    "tags": [
      "base-image",
      "prod"
    ]
  }
}

Returns Examples

{
  "volume": {
    "id": "506f78a4-e098-11e5-ad9f-000f53306ae1",
    "created_at": "2020-03-02T17:00:49Z",
    "description": "Block store for examples",
    "droplet_ids": [
      0
    ],
    "filesystem_label": "example",
    "filesystem_type": "ext4",
    "name": "example",
    "region": {
      "available": true,
      "features": [
        "private_networking",
        "backups",
        "ipv6",
        "metadata"
      ],
      "name": "New York 1",
      "sizes": [
        "s-1vcpu-1gb",
        "s-1vcpu-2gb",
        "s-1vcpu-3gb",
        "s-2vcpu-2gb",
        "s-3vcpu-1gb",
        "s-2vcpu-4gb",
        "s-4vcpu-8gb",
        "s-6vcpu-16gb",
        "s-8vcpu-32gb",
        "s-12vcpu-48gb",
        "s-16vcpu-64gb",
        "s-20vcpu-96gb",
        "s-24vcpu-128gb",
        "s-32vcpu-192gb"
      ],
      "slug": "nyc1"
    },
    "size_gigabytes": 10,
    "tags": [
      "base-image",
      "prod"
    ]
  }
}