Sign in
SKU

Update SKU

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

Changed in 3 of the 99 revisions of this API.123

  • 484497856a9411See the full diff
    • ●

      the /// request property's min was set to 0.00

      request-property-min-set

    • ●

      the /// request property's min was set to 0.00

      request-property-min-set

    • ●

      the /// request property's min was set to 0.00

      request-property-min-set

    • ●

      the /// request property's min was set to 0.00

      request-property-min-set

    • ●

      the /// request property's min was set to 0.00

      request-property-min-set

    • ●

      the //// request property's min was set to 0.00

      request-property-min-set

    • ●

      the /// request property's min was set to 0.00

      request-property-min-set

    • ●

      the /// request property's min was set to 0.00

      request-property-min-set

    • ●

      the /// request property's min was set to 0.00

      request-property-min-set

    • ●

      the /// request property's min was set to 0.00

      request-property-min-set

    • ●

      the /// request property's min was set to 0.00

      request-property-min-set

  • 4c29fe59bd4e12See the full diff
    • ●

      removed the optional property from the response with the status

      response-optional-property-removed

    • ○

      the request optional property / became read-only

      request-optional-property-became-read-only

    • ○

      the response optional property / became read-only for the status

      response-optional-property-became-read-only

  • 7d155f726f881See the full diff
    • ○

      endpoint added

      endpoint-added