Update a node

put

https://{hostname}/api/infrastructure/v1/nodes/{nodeId}

Path Params

nodeId

integer

required

Body Params

administrativeState

string

enum

required

Allowed:

attributes

array of objects

length ≤ 20

attributes

bootState

string

enum

required

Allowed:

dnsServers

array of strings

required

length between 1 and 2

dnsServers*

hostname

string

required

interfaces

array

required

length between 1 and 36

interfaces*

A node ethernet interface.

name

string

required

macAddress

string

required

type

string

enum

required

Allowed:

ip4Addresses

array of objects

length between 0 and 32

ip4Addresses

ip6Addresses

array of objects

length between 0 and 32

ip6Addresses

ip4Routes

array of objects

length ≤ 256

ip4Routes

ip6Routes

array of objects

length ≤ 256

ip6Routes

nodeId

integer

required

≥ 1

siteId

integer

required

≥ 1

Responses

Language

Credentials

OAuth2

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200An HTTP 200 will signify the successful update of an node instance.

400An HTTP 400 will be returned if the request is badly formed or has constraint violations

403An HTTP 403 will be returned if the principal is not authorized to access the instance of node that the request was made against.

404An HTTP 404 will be returned if the node with the specified entityId is not found.

409An HTTP 409 will be returned if the node offered for create/update would lead to a conflicting state.