Create SKU

POST

https://nico-rest-api.nico.svc.cluster.local/v2/org/:org/nico/sku

POST

/v2/org/:org/nico/sku

$ curl -X POST https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/sku \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "siteId": "60189e9c-7d12-438c-b9ca-6998d9c364b1",
>   "id": "dgx-h100",
>   "components": {
>     "chassis": {
>       "vendor": "NVIDIA",
>       "model": "DGX H100",
>       "architecture": "x86_64"
>     }
>   },
>   "description": "DGX H100 compute node",
>   "deviceType": "gpu-server"
> }'

1 {
2   "id": "lenovo.sr650v2.cpu.1",
3   "siteId": "60189e9c-7d12-438c-b9ca-6998d9c364b1",
4   "description": "Lenovo SR650 V2 compute node",
5   "schemaVersion": 5,
6   "deviceType": "gpu",
7   "associatedMachineIds": [
8     "fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g"
9   ],
10   "components": {
11     "cpus": [
12       {
13         "vendor": "Intel",
14         "model": "Xeon Platinum 8480+",
15         "threadCount": 112,
16         "count": 2
17       }
18     ],
19     "gpus": [
20       {
21         "vendor": "NVIDIA",
22         "model": "H100 SXM5",
23         "totalMemory": "80GB HBM3",
24         "count": 8
25       }
26     ],
27     "memory": [
28       {
29         "capacityMb": 65536,
30         "memoryType": "DDR5",
31         "count": 16
32       }
33     ],
34     "storage": [
35       {
36         "vendor": "Samsung",
37         "model": "PM9A3",
38         "capacityMb": 7680000,
39         "count": 4
40       }
41     ],
42     "chassis": {
43       "vendor": "Supermicro",
44       "model": "SYS-420GP-TNR"
45     }
46   },
47   "created": "2019-08-24T14:15:22Z",
48   "updated": "2019-08-24T14:15:22Z"
49 }

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.

Authentication

AuthorizationBearer

export JWT_BEARER_TOKEN="<jwt-bearer-token>"
# Example org name: "acme-inc
export ORG_NAME=<org-name>
# Use the JWT bearer token in your API request auth header:
curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current

``` export JWT_BEARER_TOKEN="<jwt-bearer-token>" # Example org name: "acme-inc export ORG_NAME=<org-name> # Use the JWT bearer token in your API request auth header: curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current ```

Path parameters

orgstringRequired

Name of the Org

Request

This endpoint expects an object.

siteIdstringRequiredformat: "uuid"

ID of the Site where the SKU will be created

idstringRequired>=1 character

Unique SKU identifier

componentsobjectRequired

Hardware components that make up a SKU

descriptionstringOptional

Human-readable SKU description

deviceTypestring or nullOptional

Optional device type identifier

Response

Created

idstringOptionalRead-only

Unique identifier for the SKU

siteIdstringOptionalRead-onlyformat: "uuid"

ID of the Site this SKU belongs to

descriptionstringOptionalRead-only

Human-readable SKU description

schemaVersionuintOptionalRead-only

Core SKU schema version when available

deviceTypestring or nullOptionalRead-only

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

associatedMachineIdslist of stringsOptionalRead-only

List of machine IDs associated with this SKU

componentsobjectOptional

Hardware components of this SKU

createddatetimeOptionalRead-only

ISO 8601 datetime when the SKU was created

updateddatetimeOptionalRead-only

ISO 8601 datetime when the SKU was last updated

Errors

400

Bad Request Error

403

Forbidden Error