Validate Trays | NVIDIA Infra Controller

Validate Tray components by comparing expected vs actual state.

If no filter is specified, validates all trays in the Site. Use rackId/rackName to scope to a specific rack, and name/manufacturer/type to filter by tray attributes.

Compares the expected component configuration against the actual state. Returns a detailed diff report showing missing, extra, and drifted components.

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

Validate Tray components by comparing expected vs actual state. If no filter is specified, validates all trays in the Site. Use rackId/rackName to scope to a specific rack, and name/manufacturer/type to filter by tray attributes. Compares the expected component configuration against the actual state. Returns a detailed diff report showing missing, extra, and drifted components. 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

Query parameters

siteIdstringRequiredformat: "uuid"

ID of the Site

rackIdstringOptionalformat: "uuid"

Scope to a specific Rack by ID (mutually exclusive with rackName)

rackNamestringOptional

Scope to a specific Rack by name (mutually exclusive with rackId)

namestringOptional

Filter trays by name

manufacturerstringOptional

Filter trays by manufacturer

typeenumOptional

Filter trays by type

Allowed values:

componentIdstringOptional

Filter by external component ID (requires type; mutually exclusive with rackId/rackName; use repeated params for multiple values)

Response

diffslist of objects

List of component differences found during validation

totalDiffsinteger

Total number of component differences found

missingCountinteger

Number of components expected but missing from the source system

unexpectedCountinteger

Number of components found in the source system but not expected

driftCountinteger

Number of components present in both but with field differences

matchCountinteger

Number of components that match between expected and actual

Errors

400

Bad Request Error

403

Forbidden Error

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

1	{
2	"diffs": [],
3	"totalDiffs": 0,
4	"missingCount": 0,
5	"unexpectedCount": 0,
6	"driftCount": 0,
7	"matchCount": 10
8	}