Deploy an instance
POST/instances
Queues a new instance for deployment and returns immediately with its UUID. Deploy either from an OS image (os) or by restoring a snapshot (snapshot_uuid). For password auth on an OS deploy the generated root password is returned exactly once in the response; it is empty for SSH-key and snapshot deploys. Poll GET /instances/{uuid} to watch it provision.
Request
Responses
- 202
- 400
- 401
- 402
- 403
- 409
The deployment has been accepted and queued.
The request was malformed or failed validation.
The API key is missing, invalid or expired.
The account balance is too low to complete the operation.
The API key is valid but not authorized for the required scope.
The requested resources cannot be satisfied — e.g. the plan or IP pool is out of stock (out_of_stock), or the account's instance limit is reached (too_many_instances).