Update a device
Update a device: its name, its PCI slot, its engine configuration, and - for one that boots an operating system of its own - the node it runs.
Required scope: Simulation Edit (roles: Air Org Administrator, Air User)
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Request
Move the device to a different PCI slot on its parent node. Editable only before boot; must be unique among the parent’s children.
Update the node this device runs. Merges into the stored configuration: keys left out keep their current value. Only accepted for a device which boots an operating system of its own.
Simulator-engine configuration for the device. The payload completely replaces the stored configuration: keys left out are removed. Keys the manifest does not declare are rejected, as are service-derived keys (model, number_of_ports, port_type, pci_address, pci_index) - set those via their own fields.
Response
The emulation type of this device (e.g. NIC_ETHERNET).
The hardware model this device emulates (e.g. connectx7).
The number of ports this device emulates. Resolved at create, so it can differ from what was requested. null when the platform declares no port count.
The port type this device emulates (e.g. ethernet). null when neither the request nor the model’s default set one.
The port split override this device was created with. null for a device with no OS of its own, and when it uses the platform’s own default split.
The id of the emulated node this device is plugged into.
Simulator-engine configuration for this device. The service-derived keys (model, number_of_ports, port_type, pci_address, pci_index) are excluded - they surface as their own fields.
Whether this device boots an operating system of its own (e.g. a DPU), rather than being emulated hardware with no OS to run (e.g. a NIC). Tells which children accept instructions, resets and console access.