Validate a Rack

View as Markdown

Validate a Rack’s components by comparing expected vs actual state.

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

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 ```

Path parameters

orgstringRequired
Name of the Org
idstringRequired
ID of the Rack

Query parameters

siteIdstringRequiredformat: "uuid"
ID of the Site

Response

OK
diffslist of objectsOptional
List of component differences found during validation
totalDiffsintegerOptional
Total number of component differences found
missingCountintegerOptional
Number of components expected but missing from the source system
unexpectedCountintegerOptional
Number of components found in the source system but not expected
mismatchCountintegerOptional
Number of components present in both but with field differences
matchCountintegerOptional
Number of components that match between expected and actual

Errors

400
Bad Request Error
403
Forbidden Error
504
Gateway Timeout Error