v1

latestOpenAPI 3.0.02026-07-1410578280.2 KB
Node

Update a node

post/nodes/{id}/update

Path parameters

idstring required

The ID of the node

Query parameters

versioninteger required

The version number of the node object being updated. This is required to avoid conflicting writes.

Request body

Availability'active' | 'pause' | 'drain'

Availability of the node.

Labelsobject

User-defined key/value metadata.

Namestring

Name for the node.

Role'worker' | 'manager'

Role of the node.

Example request

{
  "Availability": "active",
  "Labels": {
    "foo": "bar"
  },
  "Name": "node-name",
  "Role": "manager"
}

Response

no error