Sign in

v57

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-08-012143051018.3 KB
Expected Rack

Retrieve Expected Rack

Retrieve a specific Expected Rack by its id.

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

Alternatively, Tenant Admins with TargetedInstanceCreation capability can also retrieve Expected Racks if they have an account with the Site's Infrastructure Provider.

get/v2/org/{org}/nico/expected-rack/{id}

Query parameters

includeRelation'Site'

Related entity to expand

Response

OK

idstring uuid

Unique identifier (UUID) for the Expected Rack

rackIdstring

Operator-supplied identifier for the rack (string, not UUID). Unique within a Site.

siteIdstring uuid

ID of the Site the Expected Rack belongs to

rackProfileIdstring

Identifier of the Rack Profile this rack conforms to

namestring

Human-readable name of the Expected Rack

descriptionstring

Human-readable description of the Expected Rack

labelsLabels
createdstring date-time

ISO 8601 datetime when the Expected Rack was created

updatedstring date-time

ISO 8601 datetime when the Expected Rack was last updated

Example response

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "rackId": "rack-01",
  "siteId": "f97df110-f4de-492e-8849-4a6af68026b0",
  "rackProfileId": "rp-standard-42u",
  "name": "Rack 01",
  "description": "Production rack in row A",
  "labels": {
    "chassis.manufacturer": "NVIDIA",
    "chassis.serial-number": "NVRK0001001",
    "chassis.model": "GB200-NVL72",
    "location.region": "us-west-2",
    "location.datacenter": "phx-dc01",
    "location.room": "room-1",
    "location.position": "A1"
  },
  "created": "2019-08-24T14:15:22Z",
  "updated": "2019-08-24T14:15:22Z"
}