Validate Racks | NVIDIA Infra Controller

Validate Rack components by comparing expected vs actual state.

If no filter is specified, validates all racks in the Site. Filters can narrow the scope to specific racks by name or manufacturer.

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 Rack components by comparing expected vs actual state. If no filter is specified, validates all racks in the Site. Filters can narrow the scope to specific racks by name or manufacturer. 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

namestringOptional

Filter racks by name

manufacturerstringOptional

Filter racks by manufacturer

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/rack/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	}