Retrieve a Tray | NVIDIA Infra Controller

Get a Tray by ID.

Org must have an Infrastructure Provider entity. User must have FORGE_PROVIDER_ADMIN authorization role.

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://carbide-rest-api.carbide.svc.cluster.local/v2/org/$ORG_NAME/carbide/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://carbide-rest-api.carbide.svc.cluster.local/v2/org/$ORG_NAME/carbide/user/current ```

Path parameters

orgstringRequired

idstringRequired

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

Allowed values:

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

positionobject

Position of a tray within a 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	}

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