Skip to content
  • Auto
  • Light
  • Dark

Autoscale

Autoscale

Create a New Autoscale Pool
post/v2/droplets/autoscale
Delete autoscale pool
delete/v2/droplets/autoscale/{autoscale_pool_id}
Delete autoscale pool and resources
delete/v2/droplets/autoscale/{autoscale_pool_id}/dangerous
List All Autoscale Pools
get/v2/droplets/autoscale
List history events
get/v2/droplets/autoscale/{autoscale_pool_id}/history
List members
get/v2/droplets/autoscale/{autoscale_pool_id}/members
Retrieve an Existing Autoscale Pool
get/v2/droplets/autoscale/{autoscale_pool_id}
Update Autoscale Pool
put/v2/droplets/autoscale/{autoscale_pool_id}
ModelsExpand Collapse
AutoscalePool = object { 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.

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

created_at: string

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

formatdate-time
name: string

The human-readable name set for the autoscale pool.

status: "active" or "deleting" or "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: optional CurrentUtilization
AutoscalePoolDropletTemplate = object { 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" or "nyc2" or "nyc3" or 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 of 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: optional boolean

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

name: optional string

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

project_id: optional string

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

tags: optional array of string

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

user_data: optional 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: optional 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: optional boolean

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

AutoscalePoolDynamicConfig = object { 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: optional number

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

minimum5
maximum20
target_cpu_utilization: optional number

Target CPU utilization as a decimal.

formatfloat
minimum0.05
maximum1
target_memory_utilization: optional number

Target memory utilization as a decimal.

formatfloat
minimum0.05
maximum1
AutoscalePoolStaticConfig = object { target_number_instances }
target_number_instances: number

Fixed number of instances in an autoscale pool.

minimum1
maximum1000
CurrentUtilization = object { cpu, memory }
cpu: optional number

The average CPU utilization of the autoscale pool.

formatfloat
minimum0
maximum1
memory: optional number

The average memory utilization of the autoscale pool.

formatfloat
minimum0
maximum1