PUT /v2/droplets/autoscale/{autoscale_pool_id}

To update the configuration of an existing autoscale pool, send a PUT request to /v2/droplets/autoscale/$AUTOSCALE_POOL_ID. The request must contain a full representation of the autoscale pool including existing attributes.

Servers

Path parameters

Name Type Required Description
autoscale_pool_id String Yes

A unique identifier for an autoscale pool.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
droplet_template Object Yes
droplet_template.vpc_uuid String No

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.

droplet_template.region String Yes

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

Possible values:

  • "sfo3"
  • "sfo1"
  • "sgp1"
  • "sfo2"
  • "blr1"
  • "nyc1"
  • "nyc2"
  • "nyc3"
  • "lon1"
  • "fra1"
  • "ams3"
  • "ams2"
  • "syd1"
  • "tor1"
droplet_template.project_id String No

The project that the Droplets in the autoscale pool will belong to.

droplet_template.name String No

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

droplet_template.size String Yes

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

droplet_template.user_data String No

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.

droplet_template.ssh_keys[] Array Yes

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

droplet_template.tags[] Array No

The tags to apply to each of the Droplets in the autoscale pool.

droplet_template.with_droplet_agent Boolean No

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

droplet_template.image String Yes

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

droplet_template.ipv6 Boolean No

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

name String Yes

The human-readable name of the autoscale pool. This field cannot be updated

config Object Yes

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

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.