Virtual Machines

Deploy an instant virtual machine

Using a preset found at /virtual-machines/instant/locations, deploy a preconfigured virtual machine in seconds.

post/virtual-machines/instant

Request

Request body

config_idstring uuid required
namestring required
passwordstring nullable
ssh_keysstring[]

A list of SSH keys which will be added to this deploy only. Either this or organization_ssh_keys must be provided.

tagsstring[]

Example request

{
  "name": "My Instant Virtual Machine",
  "password": "super_secret_instant_vm_password",
  "ssh_keys": [
    "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDAKOgHv82A6Oi7AWLvBC9N..."
  ],
  "tags": [
    "tag1",
    "tag2"
  ]
}

Response

Successful Response

vm_idstring uuid required

Changes

No recorded changes to this operation across all 3 revisions of this API.