Question

High CPU Droplet availability via the DigtialOcean API

Are High CPU Droplet available via the DigtialOcean API? Are there any special considerations when creating them via the API?

Subscribe
Share

Submit an answer
You can type!ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

These answers are provided by our Community. If you find them useful, show some love by clicking the heart. If you run into issues leave a comment, or add your own answer to help others.

High CPU Droplets can be created via the DigitalOcean API like any other Droplet. In order to use them, provide a “size slug” prefixed with c- when creating your Droplet.

Slug Memory CPUs
c-2 3 GB 2
c-4 6 GB 4
c-8 12 GB 8
c-16 24 GB 16
c-32 48 GB 32
c-48 72 GB 48

For example:

curl -X POST -H "Content-Type: application/json" \
    -H "Authorization: Bearer $DO_TOKEN" \
    -d '{"name":"example.com","region":"nyc3","size":"c-32","image":"ubuntu-14-04-x64", "monitoring": true, "tags":["web"]}' \
    "https://api.digitalocean.com/v2/droplets"

High CPU Droplets may have limited availability in certain datacenters. When a Droplet create is unsuccessful because of insufficient capacity, the API call will return an error message in the following format with 422 for the HTTP status code. The available_regions key will contain a list of regions which can currently handle the desired High-CPU Droplet of that size at that time.

{
  "id": "unprocessable_entity",
  "message": "The size you selected is temporarily unavailable because of High CPU server capacity",
  "error_attributes": {
    "available_regions": [
      "nyc3",
      "nyc1",
      "sfo2"
    ]
  }
}