v57

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

Create SKU

Create a SKU.

The Org must have an Infrastructure Provider that owns the Site. The user must have an authorization role with the PROVIDER_ADMIN suffix.

post/v2/org/{org}/nico/sku

Request body

siteIdstring uuid required

ID of the Site where the SKU will be created

idstring required

Unique SKU identifier

descriptionstring

Human-readable SKU description

deviceTypestring nullable

Optional device type identifier

Example request

{
  "siteId": "60189e9c-7d12-438c-b9ca-6998d9c364b1",
  "id": "dgx-h100",
  "description": "DGX H100 compute node",
  "deviceType": "gpu-server",
  "components": {
    "chassis": {
      "vendor": "NVIDIA",
      "model": "DGX H100",
      "architecture": "x86_64"
    }
  }
}

Response

Created

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