Launch an instance
Asynchronous: answers 202 with the CreateInstance operation once capacity is claimed and every volume, interface and firewall attachment is reserved. 409 insufficient_capacity when no cell has room.
https://compute-api.ezghcloud.com/v1/organizations/{orgId}/projects/{projectId}/instancesAuthorization
Path parameters
Header parameters
Request bodyJSONrequired
- botoptionalstring
A Bot of the organization (its bot_ ID) to attach: code on the instance gets short-lived API keys acting as it from the metadata service. Needs bots.pass on the Bot (403 access_denied naming bots.pass). An unknown Bot or a UUID is 400 invalid_request at bot.
pattern: ^bot_[a-z0-9]{12}$ - rootDeviceoptionalvolumeorinstanceStore
instanceStore boots from the type's first instance store disk (store0): the type must have instanceStore (400 invalid_request at rootDevice), rootVolume must be absent (400 at rootVolume), the image must fit the disk (400 image_too_large), and the instance can't be stopped or resized (409 instance_store_root). Its rootVolumeId is null.
Default: "volume"
Returns
202
The operation, which Location names; poll it until it finishes.
400
invalid_request (with issues), invalid_cursor, or the endpoint's own 400 codes.
403
access_denied: the caller's policies don't allow the action; forbidden_origin: a cookie-authenticated write from an origin that isn't allowed; spend_limit_reached.
404
not_found: unknown, malformed, or in an organization the caller isn't in.
409
quota_exceeded (an allocation quota, with quota), idempotency_conflict, idempotency_in_progress (with Retry-After), organization_deletion_pending, operation_in_progress, or the endpoint's own 409 codes.
413
payload_too_large: the body is over the endpoint's limit (1 MiB unless it says otherwise).
429
too_many_requests, with Retry-After; or quota_exceeded (a rate, usage or concurrency quota, with quota), never with Retry-After.
500
internal_error: a bug; the details are in the logs, under the request ID.