Sign in
SKU

Retrieve all SKUs

Retrieve all SKUs (Stock Keeping Units) for a Site.

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

A siteId query parameter is required for all requests.

For Infrastructure Providers: Org must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with PROVIDER_ADMIN suffix.

For Tenants: Org must have a Tenant with TargetedInstanceCreation capability enabled and Tenant Account with Machine's Provider. User must have authorization role with TENANT_ADMIN suffix.

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

Query parameters

siteIdstring uuid required

ID of the Site to retrieve SKUs from

pageNumberinteger
Example:1

Page number for pagination query

pageSizeinteger
Example:20

Page size for pagination query

orderBy'CREATED_ASC' | 'CREATED_DESC' | 'UPDATED_ASC' | 'UPDATED_DESC' | 'ID_ASC' | 'ID_DESC'

Ordering for pagination query

Response

OK

idstring

Unique identifier for the SKU

siteIdstring uuid

ID of the Site this SKU belongs to

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",
    "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"
  }
]

Changes