List

API Reference

GPU Droplets

Autoscale

List All Autoscale Pools

client.gpuDroplets.autoscale.list(AutoscaleListParams { name, page, per_page } query?, RequestOptionsoptions?): AutoscaleListResponse { meta, autoscale_pools, links }

get/v2/droplets/autoscale

To list all autoscale pools in your team, send a GET request to /v2/droplets/autoscale. The response body will be a JSON object with a key of autoscale_pools containing an array of autoscale pool objects. These each contain the standard autoscale pool attributes.

ParametersExpand Collapse

query: AutoscaleListParams { name, page, per_page }

name?: string

The name of the autoscale pool

page?: number

Which 'page' of paginated results to return.

minimum1

per_page?: number

Number of items returned per page

minimum1

maximum200

ReturnsExpand Collapse

AutoscaleListResponse { meta, autoscale_pools, links }

meta: MetaProperties { total }

Information about the response itself.

total?: number

Number of objects returned by the request.

autoscale_pools?: Array<AutoscalePool { id, active_resources_count, config, 6 more } >

id: string

A unique identifier for each autoscale pool instance. This is automatically generated upon autoscale pool creation.

active_resources_count: number

The number of active Droplets in the autoscale pool.

config: AutoscalePoolStaticConfig { target_number_instances } | AutoscalePoolDynamicConfig { max_instances, min_instances, cooldown_minutes, 2 more }

The scaling configuration for an autoscale pool, which is how the pool scales up and down (either by resource utilization or static configuration).

Accepts one of the following:

AutoscalePoolStaticConfig { target_number_instances }

target_number_instances: number

Fixed number of instances in an autoscale pool.

minimum1

maximum1000

AutoscalePoolDynamicConfig { max_instances, min_instances, cooldown_minutes, 2 more }

max_instances: number

The maximum number of Droplets in an autoscale pool.

minimum1

maximum1000

min_instances: number

The minimum number of Droplets in an autoscale pool.

minimum1

maximum500

cooldown_minutes?: number

The number of minutes to wait between scaling events in an autoscale pool. Defaults to 10 minutes.

minimum5

maximum20

target_cpu_utilization?: number

Target CPU utilization as a decimal.

formatfloat

minimum0.05

maximum1

target_memory_utilization?: number

Target memory utilization as a decimal.

formatfloat

minimum0.05

maximum1

created_at: string

A time value given in ISO8601 combined date and time format that represents when the autoscale pool was created.

formatdate-time

droplet_template: AutoscalePoolDropletTemplate { image, region, size, 8 more }

image: string

The Droplet image to be used for all Droplets in the autoscale pool. You may specify the slug or the image ID.

region: "nyc1" | "nyc2" | "nyc3" | 11 more

The datacenter in which all of the Droplets will be created.

Accepts one of the following:

"nyc1"

"nyc2"

"nyc3"

"ams2"

"ams3"

"sfo1"

"sfo2"

"sfo3"

"sgp1"

"lon1"

"fra1"

"tor1"

"blr1"

"syd1"

size: string

The Droplet size to be used for all Droplets in the autoscale pool.

ssh_keys: Array<string>

The SSH keys to be installed on the Droplets in the autoscale pool. You can either specify the key ID or the fingerprint. Requires ssh_key:read scope.

ipv6?: boolean

Assigns a unique IPv6 address to each of the Droplets in the autoscale pool.

name?: string

The name(s) to be applied to all Droplets in the autoscale pool.

project_id?: string

The project that the Droplets in the autoscale pool will belong to. Requires project:read scope.

tags?: Array<string>

The tags to apply to each of the Droplets in the autoscale pool. Requires tag:read scope.

user_data?: string

A string containing user data that cloud-init consumes to configure a Droplet on first boot. User data is often a cloud-config file or Bash script. It must be plain text and may not exceed 64 KiB in size.

vpc_uuid?: string

The VPC where the Droplets in the autoscale pool will be created. The VPC must be in the region where you want to create the Droplets. Requires vpc:read scope.

with_droplet_agent?: boolean

Installs the Droplet agent. This must be set to true to monitor Droplets for resource utilization scaling.

name: string

The human-readable name set for the autoscale pool.

status: "active" | "deleting" | "error"

The current status of the autoscale pool.

Accepts one of the following:

"active"

"deleting"

"error"

updated_at: string

A time value given in ISO8601 combined date and time format that represents when the autoscale pool was last updated.

formatdate-time

current_utilization?: CurrentUtilization { cpu, memory }

cpu?: number

The average CPU utilization of the autoscale pool.

formatfloat

minimum0

maximum1

memory?: number

The average memory utilization of the autoscale pool.

formatfloat

minimum0

maximum1

links?: PageLinks { pages }

pages?: ForwardLinks { last, next } | BackwardLinks { first, prev } | unknown

Accepts one of the following:

ForwardLinks { last, next }

last?: string

URI of the last page of the results.

next?: string

URI of the next page of the results.

BackwardLinks { first, prev }

first?: string

URI of the first page of the results.

prev?: string

URI of the previous page of the results.

unknown

List All Autoscale Pools

typescript

• http
• typescript
• python

import Gradient from '@digitalocean/gradient';

const client = new Gradient();

const autoscales = await client.gpuDroplets.autoscale.list();

console.log(autoscales.meta);

200 example

{
  "autoscale_pools": [
    {
      "id": "0d3db13e-a604-4944-9827-7ec2642d32ac",
      "name": "test-autoscaler-group-01",
      "config": {
        "min_instances": 1,
        "max_instances": 5,
        "target_cpu_utilization": 0.5,
        "cooldown_minutes": 10
      },
      "droplet_template": {
        "name": "droplet-name",
        "size": "c-2",
        "region": "tor1",
        "image": "ubuntu-20-04-x64",
        "tags": [
          "my-tag"
        ],
        "ssh_keys": [
          "3b:16:e4:bf:8b:00:8b:b8:59:8c:a9:d3:f0:19:fa:45"
        ],
        "vpc_uuid": "760e09ef-dc84-11e8-981e-3cfdfeaae000",
        "with_droplet_agent": true,
        "project_id": "746c6152-2fa2-11ed-92d3-27aaa54e4988",
        "ipv6": true,
        "user_data": "#cloud-config\nruncmd:\n  - touch /test.txt\n"
      },
      "created_at": "2020-11-19T20:27:18Z",
      "updated_at": "2020-12-01T00:42:16Z",
      "current_utilization": {
        "memory": 0.3588531587713522,
        "cpu": 0.0007338008770232183
      },
      "status": "active",
      "active_resources_count": 1
    }
  ],
  "links": {
    "pages": null
  },
  "meta": {
    "total": 1
  }
}

Returns Examples

200 example

{
  "autoscale_pools": [
    {
      "id": "0d3db13e-a604-4944-9827-7ec2642d32ac",
      "name": "test-autoscaler-group-01",
      "config": {
        "min_instances": 1,
        "max_instances": 5,
        "target_cpu_utilization": 0.5,
        "cooldown_minutes": 10
      },
      "droplet_template": {
        "name": "droplet-name",
        "size": "c-2",
        "region": "tor1",
        "image": "ubuntu-20-04-x64",
        "tags": [
          "my-tag"
        ],
        "ssh_keys": [
          "3b:16:e4:bf:8b:00:8b:b8:59:8c:a9:d3:f0:19:fa:45"
        ],
        "vpc_uuid": "760e09ef-dc84-11e8-981e-3cfdfeaae000",
        "with_droplet_agent": true,
        "project_id": "746c6152-2fa2-11ed-92d3-27aaa54e4988",
        "ipv6": true,
        "user_data": "#cloud-config\nruncmd:\n  - touch /test.txt\n"
      },
      "created_at": "2020-11-19T20:27:18Z",
      "updated_at": "2020-12-01T00:42:16Z",
      "current_utilization": {
        "memory": 0.3588531587713522,
        "cpu": 0.0007338008770232183
      },
      "status": "active",
      "active_resources_count": 1
    }
  ],
  "links": {
    "pages": null
  },
  "meta": {
    "total": 1
  }
}