v57

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

SKU

Retrieve SKU

Retrieve a specific SKU (Stock Keeping Unit) by ID.

SKUs represent unique hardware configurations discovered at sites. They are automatically derived from machine characteristics.

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

For Tenants: Org must have a Tenant with TargetedInstanceCreation capability enabled. User must have authorization role with TENANT_ADMIN suffix. The Tenant must have an account with the SKU's Site's Infrastructure Provider.

get/v2/org/{org}/nico/sku/{skuId}

Response

idstring

Unique identifier for the SKU

siteIdstring uuid

ID of the Site this SKU belongs to

descriptionstring

Human-readable SKU description

schemaVersioninteger

Core SKU schema version when available

deviceTypestring nullable

Optional device type identifier (e.g. "gpu", "cpu", "storage")

associatedMachineIdsstring[]

List of machine IDs associated with this SKU

createdstring date-time

ISO 8601 datetime when the SKU was created

updatedstring date-time

ISO 8601 datetime when the SKU was last updated

Example response

{
  "id": "lenovo.sr650v2.cpu.1",
  "siteId": "60189e9c-7d12-438c-b9ca-6998d9c364b1",
  "description": "Lenovo SR650 V2 compute node",
  "schemaVersion": 5,
  "deviceType": "gpu",
  "associatedMachineIds": [
    "fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g"
  ],
  "components": {
    "cpus": [
      {
        "vendor": "Intel",
        "model": "Xeon Platinum 8480+",
        "threadCount": 112,
        "count": 2
      }
    ],
    "gpus": [
      {
        "vendor": "NVIDIA",
        "model": "H100 SXM5",
        "totalMemory": "80GB HBM3",
        "count": 8
      }
    ],
    "memory": [
      {
        "capacityMb": 65536,
        "memoryType": "DDR5",
        "count": 16
      }
    ],
    "storage": [
      {
        "vendor": "Samsung",
        "model": "PM9A3",
        "capacityMb": 7680000,
        "count": 4
      }
    ],
    "chassis": {
      "vendor": "Supermicro",
      "model": "SYS-420GP-TNR"
    }
  },
  "created": "2019-08-24T14:15:22Z",
  "updated": "2019-08-24T14:15:22Z"
}