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.

post/v2/nodes/{id}/replace

Path parameters

idstring required

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

Node ID

Request body

templatestring nullable

Response

Replacement node

object'node'
idstring required

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

status'pending' | 'running' | 'terminated' | 'node_failure' required
capacitystring required

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

templatestring required

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

Example response

{
  "object": "node"
}

Changes