Batch Create Expected Machines | NVIDIA Infra Controller

Create multiple Expected Machines in a single request. All machines must belong to the same site.

Org must have an Infrastructure Provider entity. User must have FORGE_PROVIDER_ADMIN role.

Alternatively, Tenant Admins with TargetedInstanceCreation capability can also create Expected Machines if they have an account with the Site’s Infrastructure Provider.

Maximum batch size: 100 Expected Machines per request.

Create multiple Expected Machines in a single request. All machines must belong to the same site. Org must have an Infrastructure Provider entity. User must have `FORGE_PROVIDER_ADMIN` role. Alternatively, Tenant Admins with `TargetedInstanceCreation` capability can also create Expected Machines if they have an account with the Site's Infrastructure Provider. Maximum batch size: 100 Expected Machines per request.

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://carbide-rest-api.carbide.svc.cluster.local/v2/org/$ORG_NAME/carbide/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://carbide-rest-api.carbide.svc.cluster.local/v2/org/$ORG_NAME/carbide/user/current ```

Path parameters

orgstringRequired

Request

Array of Expected Machine creation requests

siteIdstringRequiredformat: "uuid"

ID of the site the Expected Machine belongs to

bmcMacAddressstringRequiredformat: "^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$"

MAC address of the Expected Machine’s BMC (Baseboard Management Controller)

chassisSerialNumberstringRequired1-100 characters

Serial number of the Expected Machine's chassis

bmcUsernamestring or nullOptional<=20 characters

Username for accessing the Expected Machine's BMC

bmcPasswordstring or nullOptional<=50 characters

Password for accessing the Expected Machine's BMC

fallbackDPUSerialNumberslist of strings or nullOptional

Serial numbers of the Expected Machine’s fallback DPUs (Data Processing Units)

skuIdstring or nullOptional

Optional ID of the SKU to associate with this Expected Machine

rackIdstring or nullOptional

Optional rack identifier for this component

namestring or nullOptional

Display name for this component

manufacturerstring or nullOptional

Manufacturer of this component

modelstring or nullOptional

Model of this component

descriptionstring or nullOptional

Description of this component

firmwareVersionstring or nullOptional

Firmware version of this component

slotIdinteger or nullOptional

Slot ID within the rack

trayIdxinteger or nullOptional

Tray index within the rack

hostIdinteger or nullOptional

Host ID within the tray

labelsmap from strings to stringsOptional

User-defined key-value pairs for organizing and categorizing Expected Machines

Response

Created

idstringRead-onlyformat: "uuid"

Unique identifier for the Expected Machine

siteIdstringRead-onlyformat: "uuid"

ID of the site the Expected Machine belongs to

bmcMacAddressstringformat: "^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$"

MAC address of the Expected Machine’s BMC (Baseboard Management Controller)

chassisSerialNumberstring

Serial number of the Expected Machine's chassis

fallbackDPUSerialNumberslist of strings

Serial numbers of the Expected Machine’s fallback DPUs (Data Processing Units)

skuIdstring or null

Optional ID of the SKU associated with this Expected Machine

skuobject

SKU information for this Expected Machine (populated when includeRelation=Sku is specified)

machineIdstring or null

Optional ID of the Machine associated with this Expected Machine

machineobject

Machine information for this Expected Machine (populated when includeRelation=Machine is specified)

rackIdstring or null

Optional rack identifier for this component

namestring or null

Display name for this component

manufacturerstring or null

Manufacturer of this component

modelstring or null

Model of this component

descriptionstring or null

Description of this component

firmwareVersionstring or null

Firmware version of this component

slotIdinteger or null

Slot ID within the rack

trayIdxinteger or null

Tray index within the rack

hostIdinteger or null

Host ID within the tray

labelsmap from strings to strings

User-defined key-value pairs for organizing and categorizing Expected Machines

createddatetimeRead-only

ISO 8601 datetime when the Expected Machine was created

updateddatetimeRead-only

ISO 8601 datetime when the Expected Machine was last updated

Errors

400

Bad Request Error

403

Forbidden Error

1	curl -X POST https://carbide-rest-api.carbide.svc.cluster.local/v2/org/org/carbide/expected-machine/batch \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '[
5	{
6	"siteId": "f97df110-f4de-492e-8849-4a6af68026b0",
7	"bmcMacAddress": "00:1A:2B:3C:4D:5E",
8	"chassisSerialNumber": "CHASSIS-12345",
9	"bmcUsername": "admin",
10	"bmcPassword": "password123",
11	"fallbackDPUSerialNumbers": [
12	"DPU-001",
13	"DPU-002"
14	],
15	"labels": {
16	"environment": "production",
17	"rack": "A1"
18	}
19	},
20	{
21	"siteId": "f97df110-f4de-492e-8849-4a6af68026b0",
22	"bmcMacAddress": "00:1A:2B:3C:4D:5F",
23	"chassisSerialNumber": "CHASSIS-12346",
24	"bmcUsername": "admin",
25	"bmcPassword": "password456",
26	"fallbackDPUSerialNumbers": [
27	"DPU-003",
28	"DPU-004"
29	],
30	"labels": {
31	"environment": "production",
32	"rack": "A2"
33	}
34	}
35	]'

1	[
2	{
3	"id": "string",
4	"siteId": "string",
5	"bmcMacAddress": "string",
6	"chassisSerialNumber": "string",
7	"fallbackDPUSerialNumbers": [
8	"string"
9	],
10	"skuId": "string",
11	"sku": {
12	"id": "lenovo.sr650v2.cpu.1",
13	"siteId": "60189e9c-7d12-438c-b9ca-6998d9c364b1",
14	"deviceType": "gpu",
15	"associatedMachineIds": [
16	"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g"
17	],
18	"components": {
19	"cpus": [
20	{
21	"vendor": "Intel",
22	"model": "Xeon Platinum 8480+",
23	"threadCount": 112,
24	"count": 2
25	}
26	],
27	"gpus": [
28	{
29	"vendor": "NVIDIA",
30	"model": "H100 SXM5",
31	"totalMemory": "80GB HBM3",
32	"count": 8
33	}
34	],
35	"memory": [
36	{
37	"capacityMb": 65536,
38	"memoryType": "DDR5",
39	"count": 16
40	}
41	],
42	"storage": [
43	{
44	"vendor": "Samsung",
45	"model": "PM9A3",
46	"capacityMb": 7680000,
47	"count": 4
48	}
49	],
50	"chassis": {
51	"vendor": "Supermicro",
52	"model": "SYS-420GP-TNR"
53	}
54	},
55	"created": "2019-08-24T14:15:22Z",
56	"updated": "2019-08-24T14:15:22Z"
57	},
58	"machineId": "string",
59	"machine": {
60	"id": "fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g",
61	"controllerMachineId": "fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g",
62	"controllerMachineType": "x86_64",
63	"hwSkuDeviceType": "cpu",
64	"vendor": "Lenovo",
65	"productName": "ThinkSystem SR670 V2",
66	"maintenanceMessage": null,
67	"status": "Ready"
68	},
69	"rackId": "string",
70	"name": "string",
71	"manufacturer": "string",
72	"model": "string",
73	"description": "string",
74	"firmwareVersion": "string",
75	"slotId": 1,
76	"trayIdx": 1,
77	"hostId": 1,
78	"labels": {},
79	"created": "2024-01-15T09:30:00Z",
80	"updated": "2024-01-15T09:30:00Z"
81	}
82	]