SKU

Update SKU

Changed on

Update selected mutable fields on a SKU. The Site is determined from the saved SKU record.

Fields omitted from the request retain their current values. If a user updates the components field, the schema version will be updated to the current version (5).

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

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

Request

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

Request body

descriptionstring

Replacement SKU description

deviceTypestring

Replacement device type identifier

Example request

{
  "description": "DGX H100 compute node with InfiniBand",
  "components": {
    "infinibandDevices": [
      {
        "vendor": "Mellanox Technologies",
        "model": "MT2910 Family [ConnectX-7]",
        "count": 4,
        "inactiveDevices": []
      }
    ]
  }
}

Response

OK

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, using the Site-reported timestamp when available

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

Changes

  • 273aadbf1c41Revision changes
    • breaking

      the / request property type changed from array to no type

    • breaking

      added subschema #2 to the / response property oneOf list for the response status

    • breaking

      the / response's property type changed from array to no type for status

    • info

      added subschema #2 to the / request property oneOf list

  • 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