Retrieve a Tray

GET

https://nico-rest-api.nico.svc.cluster.local/v2/org/:org/nico/tray/:id

Get a Tray by ID.

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

Authentication

AuthorizationBearer

export JWT_BEARER_TOKEN="<jwt-bearer-token>"
# Example org name: "acme-inc
export ORG_NAME=<org-name>
# Use the JWT bearer token in your API request auth header:
curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current

``` export JWT_BEARER_TOKEN="<jwt-bearer-token>" # Example org name: "acme-inc export ORG_NAME=<org-name> # Use the JWT bearer token in your API request auth header: curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current ```

Path parameters

orgstringRequired

Name of the Org

idstringRequiredformat: "uuid"

ID of the Tray

Query parameters

siteIdstringRequiredformat: "uuid"

ID of the Site

Response

idstringformat: "uuid"

Unique identifier of the Tray

componentIdstring

ID of the component

typeenum

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

operationStatusenum

Flow-derived operability phase of the tray

leakStatusenum

Whether the tray is considered leaking coolant

positionobject

Position of the Tray within the Rack

bmcslist of objects

BMC (Baseboard Management Controller) entries for the tray

rackIdstringformat: "uuid"

ID of the rack this tray belongs to

Errors

403

Forbidden Error

404

Not Found Error

1	{
2	"id": "660e8400-e29b-41d4-a716-446655440001",
3	"componentId": "fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g",
4	"type": "compute",
5	"name": "compute-tray-1",
6	"manufacturer": "NVIDIA",
7	"model": "GB200",
8	"serialNumber": "TSN001",
9	"description": "Compute tray in slot 1",
10	"firmwareVersion": "2.1.0",
11	"powerState": "on",
12	"position": {
13	"slotId": 1,
14	"trayIdx": 0,
15	"hostId": 1
16	},
17	"rackId": "550e8400-e29b-41d4-a716-446655440000"
18	}

$	curl -G https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/tray/id \
>	-H "Authorization: Bearer <token>" \
>	-d siteId=siteId