Nodes

Replace node

Replace a node by destroying the existing one and creating a new node in the same capacity. Optionally specify a new image and cloud-init user data.

put/v2/nodes/{id}/replace

Path parameters

idstring required

Generated ID with format 'n_[0-9a-zA-Z]+' used for referencing a NodeId resource.

Node ID

Request body

image_idstring nullable
cloud_init_user_datastring byte nullable

Response

Replacement node

object'node'
idstring required

Generated ID with format 'n_[0-9a-zA-Z]+' used for referencing a NodeId resource.

ownerstring required
status'pending' | 'running' | 'destroyed' | 'node_failure' required
started_atinteger required

Unix timestamp in seconds since epoch

is_destroyedboolean required
capacity_idstring required

Generated ID with format 'cap_[0-9a-zA-Z]+' used for referencing a CapacityId resource.

image_idstring nullable

Example response

{
  "object": "node"
}

Changes