Create a new node

post

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

Body Params

administrativeState

string

enum

Allowed:

attributes

array of objects

length ≤ 20

attributes

bootState

string

enum

Allowed:

dnsServers

array of strings

required

length between 1 and 2

dnsServers*

hostname

string

required

interfaces

array

required

length between 1 and 36

interfaces*

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

siteId

integer

required

≥ 1

Responses

`Location` header.

Language

Credentials

OAuth2

URL

Loading…

Response

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

application/json

*/*

200Successful response

201An HTTP 201 will be returned if the request is successfully processed, and a new node object is created. The location of the new object will be specified in the Location header.

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.

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

`Location` header.