Rack

Validate Racks

Changed on

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 mismatched components.

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

get/v2/org/{org}/nico/rack/validation

Request

  • Base URL
    https://nico-rest-api.nico.svc.cluster.local
  • URL
    https://nico-rest-api.nico.svc.cluster.local/v2/org/{org}/nico/rack/validation
  • Auth
    HTTP bearer

Query parameters

siteIdstring uuid required

ID of the Site

namestring

Filter racks by name

manufacturerstring

Filter racks by manufacturer

Response

OK

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

mismatchCountinteger

Number of components present in both but with field differences

matchCountinteger

Number of components that match between expected and actual

Example response

{
  "diffs": [
    {
      "expected": {
        "health": {
          "source": "aggregate-host-health",
          "observedAt": null,
          "successes": [
            {
              "id": "FanSpeed",
              "target": "System Board Fan1A"
            },
            {
              "id": "PowerSupply",
              "target": "PS1 Status"
            }
          ],
          "alerts": [
            {
              "id": "FailedValidationTest",
              "target": "DcgmFullShort",
              "inAlertSince": null,
              "message": "Failed validation test",
              "tenantMessage": null,
              "classifications": [
                "PreventAllocations"
              ]
            }
          ]
        }
      },
      "actual": {
        "health": {
          "source": "aggregate-host-health",
          "observedAt": null,
          "successes": [
            {
              "id": "FanSpeed",
              "target": "System Board Fan1A"
            },
            {
              "id": "PowerSupply",
              "target": "PS1 Status"
            }
          ],
          "alerts": [
            {
              "id": "FailedValidationTest",
              "target": "DcgmFullShort",
              "inAlertSince": null,
              "message": "Failed validation test",
              "tenantMessage": null,
              "classifications": [
                "PreventAllocations"
              ]
            }
          ]
        }
      }
    }
  ]
}

Changes

  • 293dc126ab73Revision changes
    • info

      removed the nico enum value from the response property for the response status

    • info

      removed the nico enum value from the response property for the response status

    • info

      removed the nico enum value from the response property for the response status

  • 3f3fd1bde76aRevision changes
    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status