Skip to content
Gradient SDK Docs
  • Auto
  • Light
  • Dark

List

List All Droplet Sizes
gpu_droplets.sizes.list(SizeListParams**kwargs) -> metaMetaPropertiessizeslistlinksPageLinksSizeListResponse
get/v2/sizes

To list all of available Droplet sizes, send a GET request to /v2/sizes. The response will be a JSON object with a key called sizes. The value of this will be an array of size objects each of which contain the standard size attributes.

Parameters
pageint
optional

Which 'page' of paginated results to return.

minimum1
per_pageint
optional

Number of items returned per page

minimum1
maximum200
Returns
SizeListResponseclass
Hide ParametersShow Parameters
metatotalintMetaProperties

Information about the response itself.

sizeslist
List[availablebooldescriptionstrdiskintmemoryintprice_hourlyfloatprice_monthlyfloatregionslistslugstrtransferfloatvcpusintdisk_infolistgpu_infoGPUInfoSize]
Hide ParametersShow Parameters
availablebool

This is a boolean value that represents whether new Droplets can be created with this size.

descriptionstr

A string describing the class of Droplets created from this size. For example: Basic, General Purpose, CPU-Optimized, Memory-Optimized, or Storage-Optimized.

diskint

The amount of disk space set aside for Droplets of this size. The value is represented in gigabytes.

memoryint

The amount of RAM allocated to Droplets created of this size. The value is represented in megabytes.

multipleOf8
minimum8
price_hourlyfloat

This describes the price of the Droplet size as measured hourly. The value is measured in US dollars.

formatfloat
price_monthlyfloat

This attribute describes the monthly cost of this Droplet size if the Droplet is kept for an entire month. The value is measured in US dollars.

formatfloat
regionslist
List[str]

An array containing the region slugs where this size is available for Droplet creates. regions:read is required to view.

slugstr

A human-readable string that is used to uniquely identify each size.

transferfloat

The amount of transfer bandwidth that is available for Droplets created in this size. This only counts traffic on the public interface. The value is given in terabytes.

formatfloat
vcpusint

The number of CPUs allocated to Droplets of this size.

disk_infolist
optional
Optional[List[sizeSizetypeliteralDiskInfo]]

An array of objects containing information about the disks available to Droplets created with this size.

Hide ParametersShow Parameters
sizeamountintunitstrSize
optional
Hide ParametersShow Parameters
amountint
optional

The amount of space allocated to the disk.

unitstr
optional

The unit of measure for the disk size.

typeliteral
optional
Optional[Literal["local", "scratch"]]

The type of disk. All Droplets contain a local disk. Additionally, GPU Droplets can also have a scratch disk for non-persistent data.

Hide ParametersShow Parameters
"local"
"scratch"
gpu_infoGPUInfo
optional

An object containing information about the GPU capabilities of Droplets created with this size.

from do_gradientai import GradientAI

client = GradientAI()
sizes = client.gpu_droplets.sizes.list()
print(sizes.meta)
200 Example
{
  "meta": {
    "total": 64
  },
  "sizes": [
    {
      "available": true,
      "description": "Basic",
      "disk": 25,
      "memory": 1024,
      "price_hourly": 0.00743999984115362,
      "price_monthly": 5,
      "regions": [
        "ams2",
        "ams3",
        "blr1",
        "fra1",
        "lon1",
        "nyc1",
        "nyc2",
        "nyc3",
        "sfo1",
        "sfo2",
        "sfo3",
        "sgp1",
        "tor1"
      ],
      "slug": "s-1vcpu-1gb",
      "transfer": 1,
      "vcpus": 1,
      "disk_info": [
        {
          "size": {
            "amount": 25,
            "unit": "gib"
          },
          "type": "local"
        }
      ],
      "gpu_info": {
        "count": 1,
        "model": "nvidia_h100",
        "vram": {
          "amount": 25,
          "unit": "gib"
        }
      }
    }
  ],
  "links": {
    "pages": {
      "last": "https://api.digitalocean.com/v2/sizes?page=64&per_page=1",
      "next": "https://api.digitalocean.com/v2/sizes?page=2&per_page=1"
    }
  }
}