API

Update a node

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

This operation updates the details of a node.

Path Params
integer
required

Uniquely identifies a node.

Body Params

Node update schema.

string
enum
required

The administrative state of the node, either ACTIVE or MAINTENANCE. The default is ACTIVE. Use MAINTENANCE to remove a node from service, do routine software maintenance, or add or remove storage devices on a service node.

Allowed:
attributes
array of objects
length ≤ 20

Array of mappings of attributeType to value for this node.

attributes
string
enum
required

When booting, the action the node should take BOOT, REINSTALL, INSTALL, or UPGRADE. In BOOT state, the node completes a normal boot process and runs in production mode. REINSTALL causes the node to reinstall and overwrite the system partition and boot partition on all disks and the associated data, but does not update the kernel partition. Use the INSTALL state for a node on which no Aura software is installed. Do not use UPGRADE to upgrade the software on a service node; use the upgrade_step.py script. For detailed information about upgrading a service node using the upgrade_step.py script, see the "Service Node Upgrade with upgrade_step.py" in the Aura LCDN/LMS Upgrade Guide.

Allowed:
dnsServers
array of strings
required
length between 1 and 2

List of DNS Server IP addresses.

dnsServers*
string
required

The unique fully qualified domain name (FQDN) for this node.

interfaces
array
required
length between 1 and 36

List of interfaces for the node. Bond interfaces lag0, lag1, lag2, and lag3 must exist. If not supplied on a POST, they will be added. A minimum of one and maximum of 32 ethernet interfaces must exist. One of the ethernet interfaces must contain the management address, and this interface may not be part of a bond.

interfaces*

A node ethernet interface.

string
required

Interface name, such as eth0.

string
required

Interface MAC address.

string
enum
required

Identifies the interface type. The only supported type is ETHERNET.

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
integer
required
≥ 1

The unique identifier for a node.

integer
required
≥ 1

The unique identifier for a site.

Responses

Updated 2 months ago

Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago