Skip to navigation

Mark a system node early access

View as MarkdownOpen in Claude

Sets early_access on a global system node (simulation null); a simulation’s system node is refused 403. Any other field sent is ignored.

early_access is a label only: it does not change who can see or use the system node.

Required scope: SRE (roles: Air SRE)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequiredformat: "uuid"
A UUID string identifying this template node.

Request

This endpoint expects an object.
early_accessbooleanOptional
Whether this system node is offered as early access rather than generally available. This is informational only and does not affect who can see or use the system node.

Response

idstringRead-onlyformat: "uuid"
createddatetimeRead-only
modifieddatetimeRead-only
namestring<=255 characters
imagestringformat: "uuid"
The image representing the operating system of the node.
simulationstring or nullOptionalformat: "uuid"
The simulation which owns the template node. If null, the template node will be globally available.
memoryintegerOptional1-2147483647
RAM, in MiB.
storageintegerOptional1-2147483647
Disk space, in GB.
cpuintegerOptional1-2147483647
Number of CPU cores.
categoryenumOptional

The Air specific category the node belongs to.

  • “ - None
  • SERVER - Server
  • SWITCH - Switch
  • OOB_SERVER - OOB Management Server
  • OOB_SWITCH - OOB Management Switch
labelsobjectOptional
Labels associated with the system node.
split_optionsany or nullOptional
A list of possible split options for interfaces for this node
early_accessbooleanOptional
Whether this system node is offered as early access rather than generally available. This is informational only and does not affect who can see or use the system node.

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error