Sign in

v57

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-08-012143051018.3 KB
Tray

Retrieve a Tray

Get a Tray by ID.

Org must have an Infrastructure Provider entity. User must have authorization role with PROVIDER_ADMIN suffix.

get/v2/org/{org}/nico/tray/{id}

Query parameters

siteIdstring uuid required

ID of the Site

Response

OK

idstring uuid

Unique identifier of the Tray

componentIdstring

ID of the component

type'compute' | 'switch' | 'powershelf'

Type of the tray

namestring

Name of the tray

manufacturerstring

Manufacturer of the tray

modelstring

Model of the tray

serialNumberstring

Serial number of the tray

descriptionstring

Description of the tray

firmwareVersionstring

Firmware version of the tray

powerStatestring

Current power state of the tray

operationStatus'Unknown' | 'Initializing' | 'Ready' | 'InUse' | 'Error' | 'Deleting'

Flow-derived operability phase of the tray

leakStatus'Unknown' | 'NoLeak' | 'Leaking'

Whether the tray is considered leaking coolant

rackIdstring uuid

ID of the rack this tray belongs to

Example response

{
  "id": "660e8400-e29b-41d4-a716-446655440001",
  "componentId": "fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g",
  "type": "compute",
  "name": "compute-tray-1",
  "manufacturer": "NVIDIA",
  "model": "GB200",
  "serialNumber": "TSN001",
  "description": "Compute tray in slot 1",
  "firmwareVersion": "2.1.0",
  "powerState": "on",
  "position": {
    "slotId": 1,
    "trayIdx": 0,
    "hostId": 1
  },
  "bmcs": [
    {
      "type": "BmcTypeHost",
      "macAddress": "00:11:22:33:44:55",
      "ipAddress": "192.168.1.100"
    }
  ],
  "rackId": "550e8400-e29b-41d4-a716-446655440000"
}