diff --git a/api/pkg/api/handler/rack.go b/api/pkg/api/handler/rack.go
index e6acc5320..bb2583128 100644
--- a/api/pkg/api/handler/rack.go
+++ b/api/pkg/api/handler/rack.go
@@ -1150,7 +1150,7 @@ func (furh UpdateRackFirmwareHandler) Handle(c echo.Context) error {
 	}
 
 	flowResp, err := common.ExecuteFirmwareUpdateWorkflow(ctx, c, logger, stc, targetSpec, apiRequest.Version,
-		fmt.Sprintf("rack-firmware-update-%s", rackStrID), "Rack")
+		nil, fmt.Sprintf("rack-firmware-update-%s", rackStrID), "Rack")
 	if err != nil {
 		return err
 	}
@@ -1268,7 +1268,7 @@ func (furbh BatchUpdateRackFirmwareHandler) Handle(c echo.Context) error {
 	targetSpec := request.Filter.ToTargetSpec()
 
 	flowResp, err := common.ExecuteFirmwareUpdateWorkflow(ctx, c, logger, stc, targetSpec, request.Version,
-		fmt.Sprintf("rack-firmware-batch-update-%s", common.RequestHash(request.Filter)), "Rack")
+		nil, fmt.Sprintf("rack-firmware-batch-update-%s", common.RequestHash(request.Filter)), "Rack")
 	if err != nil {
 		return err
 	}
diff --git a/api/pkg/api/handler/tray.go b/api/pkg/api/handler/tray.go
index 3dbb102e5..c085326bd 100644
--- a/api/pkg/api/handler/tray.go
+++ b/api/pkg/api/handler/tray.go
@@ -1144,7 +1144,7 @@ func (futh UpdateTrayFirmwareHandler) Handle(c echo.Context) error {
 	}
 
 	flowResp, err := common.ExecuteFirmwareUpdateWorkflow(ctx, c, logger, stc, targetSpec, apiRequest.Version,
-		fmt.Sprintf("tray-firmware-update-%s", trayStrID), "Tray")
+		apiRequest.Targets, fmt.Sprintf("tray-firmware-update-%s", trayStrID), "Tray")
 	if err != nil {
 		return err
 	}
@@ -1259,7 +1259,7 @@ func (futbh BatchUpdateTrayFirmwareHandler) Handle(c echo.Context) error {
 	targetSpec := request.Filter.ToTargetSpec()
 
 	flowResp, err := common.ExecuteFirmwareUpdateWorkflow(ctx, c, logger, stc, targetSpec, request.Version,
-		fmt.Sprintf("tray-firmware-batch-update-%s", common.RequestHash(request.Filter)), "Tray")
+		request.Targets, fmt.Sprintf("tray-firmware-batch-update-%s", common.RequestHash(request.Filter)), "Tray")
 	if err != nil {
 		return err
 	}
diff --git a/api/pkg/api/handler/util/common/common.go b/api/pkg/api/handler/util/common/common.go
index 88161b179..92c295e0e 100644
--- a/api/pkg/api/handler/util/common/common.go
+++ b/api/pkg/api/handler/util/common/common.go
@@ -1762,6 +1762,13 @@ func ExecuteBringUpRackWorkflow(
 
 // ExecuteFirmwareUpdateWorkflow builds an UpgradeFirmwareRequest, executes the UpgradeFirmware
 // workflow via Temporal, and returns the raw SubmitTaskResponse.
+//
+// targets, when non-empty, restricts the upgrade to the listed firmware
+// sub-parts within each targeted tray (e.g. ["bmc", "nvos"] for switch
+// trays). An empty/nil slice keeps the historical "update everything in
+// the bundle" behavior. Names are passed through verbatim to Flow as
+// `sub_targets`, which resolves them against the tray-type-specific
+// component-manager enums (see flow/pkg/common/firmwarecomponents).
 func ExecuteFirmwareUpdateWorkflow(
 	ctx context.Context,
 	c echo.Context,
@@ -1769,12 +1776,14 @@ func ExecuteFirmwareUpdateWorkflow(
 	stc tclient.Client,
 	targetSpec *flowv1.OperationTargetSpec,
 	version *string,
+	targets []string,
 	workflowID string,
 	entityName string,
 ) (*flowv1.SubmitTaskResponse, error) {
 	flowRequest := &flowv1.UpgradeFirmwareRequest{
 		TargetSpec:    targetSpec,
 		TargetVersion: version,
+		SubTargets:    targets,
 		Description:   fmt.Sprintf("API firmware update %s", entityName),
 	}
 
diff --git a/api/pkg/api/model/firmware.go b/api/pkg/api/model/firmware.go
index 894e33f7b..5f1d8d0d0 100644
--- a/api/pkg/api/model/firmware.go
+++ b/api/pkg/api/model/firmware.go
@@ -29,6 +29,22 @@ import (
 type APIUpdateFirmwareRequest struct {
 	SiteID  string  `json:"siteId"`
 	Version *string `json:"version,omitempty"`
+	// Targets, when non-empty, restricts the update to a subset of
+	// firmware sub-parts within the targeted tray (e.g. ["bmc", "nvos"]
+	// for switch trays). Names are lowercase. The authoritative supported
+	// set per tray type is derived from the Flow service's NICo proto
+	// bindings (mirroring Core's per-tray-type enums in
+	// carbide-core/crates/rpc/proto/forge.proto); see
+	// flow/pkg/common/firmwarecomponents for the resolution logic and
+	// helpers like SupportedNICoNVSwitchNames.
+	// Empty/nil means "update everything in the bundle". When non-empty,
+	// requires Version.
+	//
+	// REST surface intentionally calls these "targets" to avoid confusion
+	// with carbide's tray-level "Component" vocabulary; the downstream
+	// Flow proto field is named `sub_targets` and represents the same
+	// enum subset.
+	Targets []string `json:"targets,omitempty"`
 }
 
 // Validate validates the firmware update request
@@ -36,7 +52,7 @@ func (r *APIUpdateFirmwareRequest) Validate() error {
 	if r.SiteID == "" {
 		return fmt.Errorf("siteId is required")
 	}
-	return nil
+	return validateFirmwareTargets(r.Targets, r.Version)
 }
 
 // ========== Firmware Update Response ==========
@@ -89,6 +105,10 @@ type APIBatchTrayFirmwareUpdateRequest struct {
 	SiteID  string      `json:"siteId"`
 	Filter  *TrayFilter `json:"filter,omitempty"`
 	Version *string     `json:"version,omitempty"`
+	// Targets, when non-empty, restricts the update to a subset of
+	// firmware sub-parts within each matched tray. Same semantics as the
+	// single-tray variant. When non-empty, requires Version.
+	Targets []string `json:"targets,omitempty"`
 }
 
 // Validate checks required fields and filter constraints.
@@ -96,5 +116,29 @@ func (r *APIBatchTrayFirmwareUpdateRequest) Validate() error {
 	if r.SiteID == "" {
 		return fmt.Errorf("siteId is required")
 	}
-	return r.Filter.Validate()
+	if r.Filter != nil {
+		if err := r.Filter.Validate(); err != nil {
+			return err
+		}
+	}
+	return validateFirmwareTargets(r.Targets, r.Version)
+}
+
+// validateFirmwareTargets enforces the cross-field constraint that a
+// firmware-target subset selection is only meaningful when a target version
+// is also supplied. Per-tray-type name validation is delegated to Flow,
+// where the mapping from string to component-manager enum lives.
+func validateFirmwareTargets(targets []string, version *string) error {
+	if len(targets) == 0 {
+		return nil
+	}
+	for _, t := range targets {
+		if t == "" {
+			return fmt.Errorf("targets must not contain empty strings")
+		}
+	}
+	if version == nil || *version == "" {
+		return fmt.Errorf("targets requires version to be set")
+	}
+	return nil
 }
diff --git a/api/pkg/api/model/firmware_test.go b/api/pkg/api/model/firmware_test.go
index c5d8b93ae..d094d6487 100644
--- a/api/pkg/api/model/firmware_test.go
+++ b/api/pkg/api/model/firmware_test.go
@@ -45,6 +45,97 @@ func TestAPIUpdateFirmwareRequest_Validate(t *testing.T) {
 			request: APIUpdateFirmwareRequest{Version: strPtr("24.11.0")},
 			wantErr: true,
 		},
+		{
+			name: "valid - targets with version",
+			request: APIUpdateFirmwareRequest{
+				SiteID:  "site-1",
+				Version: strPtr("24.11.0"),
+				Targets: []string{"bmc", "nvos"},
+			},
+			wantErr: false,
+		},
+		{
+			name: "invalid - targets without version",
+			request: APIUpdateFirmwareRequest{
+				SiteID:  "site-1",
+				Targets: []string{"bmc"},
+			},
+			wantErr: true,
+		},
+		{
+			name: "invalid - targets with empty version string",
+			request: APIUpdateFirmwareRequest{
+				SiteID:  "site-1",
+				Version: strPtr(""),
+				Targets: []string{"bmc"},
+			},
+			wantErr: true,
+		},
+		{
+			name: "invalid - targets contains empty string",
+			request: APIUpdateFirmwareRequest{
+				SiteID:  "site-1",
+				Version: strPtr("24.11.0"),
+				Targets: []string{"bmc", ""},
+			},
+			wantErr: true,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			err := tt.request.Validate()
+			if tt.wantErr {
+				assert.Error(t, err)
+			} else {
+				assert.NoError(t, err)
+			}
+		})
+	}
+}
+
+func TestAPIBatchTrayFirmwareUpdateRequest_Validate(t *testing.T) {
+	tests := []struct {
+		name    string
+		request APIBatchTrayFirmwareUpdateRequest
+		wantErr bool
+	}{
+		{
+			name:    "valid - siteId only",
+			request: APIBatchTrayFirmwareUpdateRequest{SiteID: "site-1"},
+			wantErr: false,
+		},
+		{
+			name: "valid - with filter and version",
+			request: APIBatchTrayFirmwareUpdateRequest{
+				SiteID:  "site-1",
+				Filter:  &TrayFilter{IDs: []string{"550e8400-e29b-41d4-a716-446655440000"}},
+				Version: strPtr("24.11.0"),
+			},
+			wantErr: false,
+		},
+		{
+			name: "valid - targets with version",
+			request: APIBatchTrayFirmwareUpdateRequest{
+				SiteID:  "site-1",
+				Version: strPtr("24.11.0"),
+				Targets: []string{"bmc"},
+			},
+			wantErr: false,
+		},
+		{
+			name: "invalid - targets without version",
+			request: APIBatchTrayFirmwareUpdateRequest{
+				SiteID:  "site-1",
+				Targets: []string{"bmc"},
+			},
+			wantErr: true,
+		},
+		{
+			name:    "invalid - missing siteId",
+			request: APIBatchTrayFirmwareUpdateRequest{},
+			wantErr: true,
+		},
 	}
 
 	for _, tt := range tests {
diff --git a/docs/index.html b/docs/index.html
index a2bd4b3da..4892973f5 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -7700,8 +7700,46 @@ <h3 id="typical-api-call-flow-for-tenant">Typical API Call Flow for Tenant</h3>
 " class="sc-iJuXkV sc-cBNeAB iNuSsz dyntKg"><p>ID of the Rack</p>
 </div></div></div></td></tr></tbody></table></div><h5 class="sc-iqHZue iFTCOQ">Request Body schema: <span class="sc-gWHgjU eBDHRN">application/json</span><div class="sc-gTgAvG sc-eJMOEj sc-dUrlDD gCMUGw egFobb eEdthm">required</div></h5><div html="" class="sc-iJuXkV sc-cBNeAB iNuSsz jtfGmi"></div><table class="sc-hHfrpe juzVUC"><tbody><tr class=""><td kind="field" title="siteId" class="sc-hBFaCF sc-fFubTW DPwQp hUqyua"><span class="sc-idOkdQ iNiPzl"></span><span class="property-name">siteId</span><div class="sc-gTgAvG sc-eJMOEj gCMUGw egFobb">required</div></td><td class="sc-bkAakD gNQdZ"><div><div><span class="sc-gTgAvG sc-laROWl gCMUGw dCeeDp"></span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA">string</span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA"> <!-- -->&lt;<!-- -->uuid<!-- -->&gt;<!-- --> </span></div> <div><div html="&lt;p&gt;ID of the Site&lt;/p&gt;
 " class="sc-iJuXkV sc-cBNeAB iNuSsz dyntKg"><p>ID of the Site</p>
-</div></div></div></td></tr><tr class="last "><td kind="field" title="version" class="sc-hBFaCF sc-fFubTW DPwQp hUqyua"><span class="sc-idOkdQ iNiPzl"></span><span class="property-name">version</span></td><td class="sc-bkAakD gNQdZ"><div><div><span class="sc-gTgAvG sc-laROWl gCMUGw dCeeDp"></span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA">string or null</span></div> <div><div html="&lt;p&gt;Target firmware version.&lt;/p&gt;
+</div></div></div></td></tr><tr class=""><td kind="field" title="version" class="sc-hBFaCF sc-fFubTW DPwQp hUqyua"><span class="sc-idOkdQ iNiPzl"></span><span class="property-name">version</span></td><td class="sc-bkAakD gNQdZ"><div><div><span class="sc-gTgAvG sc-laROWl gCMUGw dCeeDp"></span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA">string or null</span></div> <div><div html="&lt;p&gt;Target firmware version.&lt;/p&gt;
 " class="sc-iJuXkV sc-cBNeAB iNuSsz dyntKg"><p>Target firmware version.</p>
+</div></div></div></td></tr><tr class="last "><td kind="field" title="targets" class="sc-hBFaCF sc-fFubTW DPwQp hUqyua"><span class="sc-idOkdQ iNiPzl"></span><span class="property-name">targets</span></td><td class="sc-bkAakD gNQdZ"><div><div><span class="sc-gTgAvG sc-laROWl gCMUGw dCeeDp">Array of </span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA">strings</span><span class="sc-gTgAvG sc-laROWl sc-aencn gCMUGw dCeeDp dktZnO">[ items<span> <span class="sc-gTgAvG sc-clsJvZ gCMUGw gAOGaI"> <!-- -->non-empty<!-- --> </span></span> ]</span></div><div><span class="sc-gTgAvG gCMUGw">Items<!-- --> <!-- -->Enum<!-- -->:</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;bmc&quot;</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;cpld&quot;</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;bios&quot;</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;nvos&quot;</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;pmc&quot;</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;psu&quot;</span> </div> <div><div html="&lt;p&gt;Optional subset of firmware targets to update within the targeted tray.
+Names are lowercase and select sub-parts of the tray
+(BMC, BIOS, etc.). The accepted set per tray type comes from
+the Flow service&amp;#39;s NICo proto bindings (which mirror Core&amp;#39;s
+per-tray-type enums in &lt;code&gt;carbide-core/crates/rpc/proto/forge.proto&lt;/code&gt;),
+so the supported values track Core as new sub-parts are added:&lt;/p&gt;
+&lt;ul&gt;
+&lt;li&gt;switch trays (NvSwitchComponent): currently bmc, cpld, bios, nvos&lt;/li&gt;
+&lt;li&gt;powershelf trays (PowerShelfComponent): currently pmc, psu&lt;/li&gt;
+&lt;li&gt;compute trays (ComputeTrayComponent): currently bmc, bios
+(currently NOT honored end-to-end: the NICo compute-firmware
+path goes through SetFirmwareUpdateTimeWindow + auto-update,
+which has no per-target selection; the request is logged
+and the whole bundle is applied. Will be honored once
+compute moves to UpdateComponentFirmware.)
+Omitted or empty means &amp;quot;update everything in the bundle&amp;quot;
+(the historical default). Unknown names are rejected.
+Requires &lt;code&gt;version&lt;/code&gt; to be set.&lt;/li&gt;
+&lt;/ul&gt;
+" class="sc-iJuXkV sc-cBNeAB iNuSsz dyntKg"><p>Optional subset of firmware targets to update within the targeted tray.
+Names are lowercase and select sub-parts of the tray
+(BMC, BIOS, etc.). The accepted set per tray type comes from
+the Flow service&#39;s NICo proto bindings (which mirror Core&#39;s
+per-tray-type enums in <code>carbide-core/crates/rpc/proto/forge.proto</code>),
+so the supported values track Core as new sub-parts are added:</p>
+<ul>
+<li>switch trays (NvSwitchComponent): currently bmc, cpld, bios, nvos</li>
+<li>powershelf trays (PowerShelfComponent): currently pmc, psu</li>
+<li>compute trays (ComputeTrayComponent): currently bmc, bios
+(currently NOT honored end-to-end: the NICo compute-firmware
+path goes through SetFirmwareUpdateTimeWindow + auto-update,
+which has no per-target selection; the request is logged
+and the whole bundle is applied. Will be honored once
+compute moves to UpdateComponentFirmware.)
+Omitted or empty means &quot;update everything in the bundle&quot;
+(the historical default). Unknown names are rejected.
+Requires <code>version</code> to be set.</li>
+</ul>
 </div></div></div></td></tr></tbody></table><div><h3 class="sc-fHYzZk ihqrCS">Responses</h3><div><button class="sc-cbDJdZ ciHfuN" aria-expanded="true"><svg class="sc-dQoBM lfvciC" version="1.1" viewBox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true"><polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon></svg><strong class="sc-fWPeRB mtsUp">200<!-- --> </strong><div html="&lt;p&gt;OK&lt;/p&gt;
 " class="sc-iJuXkV sc-cBNeAB sc-cittYi iNuSsz eBjiEo hynizp"><p>OK</p>
 </div></button><div class="sc-hjWTnH dzJsxj"><h5 class="sc-iqHZue iFTCOQ">Response Schema: <span class="sc-gWHgjU eBDHRN">application/json</span></h5><table class="sc-hHfrpe juzVUC"><tbody><tr class="last "><td kind="field" title="taskIds" class="sc-hBFaCF sc-fFubTW DPwQp hUqyua"><span class="sc-idOkdQ iNiPzl"></span><span class="property-name">taskIds</span></td><td class="sc-bkAakD gNQdZ"><div><div><span class="sc-gTgAvG sc-laROWl gCMUGw dCeeDp">Array of </span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA">strings</span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA"> <!-- -->&lt;<!-- -->uuid<!-- -->&gt;<!-- --> </span><span class="sc-gTgAvG sc-laROWl sc-aencn gCMUGw dCeeDp dktZnO">[ items<span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA"> &lt;<!-- -->uuid<!-- --> &gt;</span> ]</span></div> <div><div html="&lt;p&gt;List of task IDs created for the firmware update operation&lt;/p&gt;
@@ -8198,8 +8236,46 @@ <h3 id="typical-api-call-flow-for-tenant">Typical API Call Flow for Tenant</h3>
 " class="sc-iJuXkV sc-cBNeAB iNuSsz dyntKg"><p>Filter by component ID. Requires &#39;type&#39;.</p>
 </div></div></div></td></tr><tr class="last "><td kind="field" title="ids" class="sc-hBFaCF sc-fFubTW DPwQp hUqyua"><span class="sc-idOkdQ iNiPzl"></span><span class="property-name">ids</span></td><td class="sc-bkAakD gNQdZ"><div><div><span class="sc-gTgAvG sc-laROWl gCMUGw dCeeDp">Array of </span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA">strings</span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA"> <!-- -->&lt;<!-- -->uuid<!-- -->&gt;<!-- --> </span><span class="sc-gTgAvG sc-laROWl sc-aencn gCMUGw dCeeDp dktZnO">[ items<span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA"> &lt;<!-- -->uuid<!-- --> &gt;</span> ]</span></div> <div><div html="&lt;p&gt;Filter by tray UUID&lt;/p&gt;
 " class="sc-iJuXkV sc-cBNeAB iNuSsz dyntKg"><p>Filter by tray UUID</p>
-</div></div></div></td></tr></tbody></table></div></td></tr><tr class="last "><td kind="field" title="version" class="sc-hBFaCF sc-fFubTW DPwQp hUqyua"><span class="sc-idOkdQ iNiPzl"></span><span class="property-name">version</span></td><td class="sc-bkAakD gNQdZ"><div><div><span class="sc-gTgAvG sc-laROWl gCMUGw dCeeDp"></span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA">string or null</span></div> <div><div html="&lt;p&gt;Target firmware version.&lt;/p&gt;
+</div></div></div></td></tr></tbody></table></div></td></tr><tr class=""><td kind="field" title="version" class="sc-hBFaCF sc-fFubTW DPwQp hUqyua"><span class="sc-idOkdQ iNiPzl"></span><span class="property-name">version</span></td><td class="sc-bkAakD gNQdZ"><div><div><span class="sc-gTgAvG sc-laROWl gCMUGw dCeeDp"></span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA">string or null</span></div> <div><div html="&lt;p&gt;Target firmware version.&lt;/p&gt;
 " class="sc-iJuXkV sc-cBNeAB iNuSsz dyntKg"><p>Target firmware version.</p>
+</div></div></div></td></tr><tr class="last "><td kind="field" title="targets" class="sc-hBFaCF sc-fFubTW DPwQp hUqyua"><span class="sc-idOkdQ iNiPzl"></span><span class="property-name">targets</span></td><td class="sc-bkAakD gNQdZ"><div><div><span class="sc-gTgAvG sc-laROWl gCMUGw dCeeDp">Array of </span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA">strings</span><span class="sc-gTgAvG sc-laROWl sc-aencn gCMUGw dCeeDp dktZnO">[ items<span> <span class="sc-gTgAvG sc-clsJvZ gCMUGw gAOGaI"> <!-- -->non-empty<!-- --> </span></span> ]</span></div><div><span class="sc-gTgAvG gCMUGw">Items<!-- --> <!-- -->Enum<!-- -->:</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;bmc&quot;</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;cpld&quot;</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;bios&quot;</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;nvos&quot;</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;pmc&quot;</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;psu&quot;</span> </div> <div><div html="&lt;p&gt;Optional subset of firmware targets to update within each matched tray.
+Names are lowercase and select sub-parts of the tray
+(BMC, BIOS, etc.). The accepted set per tray type comes from
+the Flow service&amp;#39;s NICo proto bindings (which mirror Core&amp;#39;s
+per-tray-type enums in &lt;code&gt;carbide-core/crates/rpc/proto/forge.proto&lt;/code&gt;),
+so the supported values track Core as new sub-parts are added:&lt;/p&gt;
+&lt;ul&gt;
+&lt;li&gt;switch trays (NvSwitchComponent): currently bmc, cpld, bios, nvos&lt;/li&gt;
+&lt;li&gt;powershelf trays (PowerShelfComponent): currently pmc, psu&lt;/li&gt;
+&lt;li&gt;compute trays (ComputeTrayComponent): currently bmc, bios
+(currently NOT honored end-to-end: the NICo compute-firmware
+path goes through SetFirmwareUpdateTimeWindow + auto-update,
+which has no per-target selection; the request is logged
+and the whole bundle is applied. Will be honored once
+compute moves to UpdateComponentFirmware.)
+Omitted or empty means &amp;quot;update everything in the bundle&amp;quot;
+(the historical default). Unknown names are rejected.
+Requires &lt;code&gt;version&lt;/code&gt; to be set.&lt;/li&gt;
+&lt;/ul&gt;
+" class="sc-iJuXkV sc-cBNeAB iNuSsz dyntKg"><p>Optional subset of firmware targets to update within each matched tray.
+Names are lowercase and select sub-parts of the tray
+(BMC, BIOS, etc.). The accepted set per tray type comes from
+the Flow service&#39;s NICo proto bindings (which mirror Core&#39;s
+per-tray-type enums in <code>carbide-core/crates/rpc/proto/forge.proto</code>),
+so the supported values track Core as new sub-parts are added:</p>
+<ul>
+<li>switch trays (NvSwitchComponent): currently bmc, cpld, bios, nvos</li>
+<li>powershelf trays (PowerShelfComponent): currently pmc, psu</li>
+<li>compute trays (ComputeTrayComponent): currently bmc, bios
+(currently NOT honored end-to-end: the NICo compute-firmware
+path goes through SetFirmwareUpdateTimeWindow + auto-update,
+which has no per-target selection; the request is logged
+and the whole bundle is applied. Will be honored once
+compute moves to UpdateComponentFirmware.)
+Omitted or empty means &quot;update everything in the bundle&quot;
+(the historical default). Unknown names are rejected.
+Requires <code>version</code> to be set.</li>
+</ul>
 </div></div></div></td></tr></tbody></table><div><h3 class="sc-fHYzZk ihqrCS">Responses</h3><div><button class="sc-cbDJdZ ciHfuN" aria-expanded="true"><svg class="sc-dQoBM lfvciC" version="1.1" viewBox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true"><polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon></svg><strong class="sc-fWPeRB mtsUp">200<!-- --> </strong><div html="&lt;p&gt;OK&lt;/p&gt;
 " class="sc-iJuXkV sc-cBNeAB sc-cittYi iNuSsz eBjiEo hynizp"><p>OK</p>
 </div></button><div class="sc-hjWTnH dzJsxj"><h5 class="sc-iqHZue iFTCOQ">Response Schema: <span class="sc-gWHgjU eBDHRN">application/json</span></h5><table class="sc-hHfrpe juzVUC"><tbody><tr class="last "><td kind="field" title="taskIds" class="sc-hBFaCF sc-fFubTW DPwQp hUqyua"><span class="sc-idOkdQ iNiPzl"></span><span class="property-name">taskIds</span></td><td class="sc-bkAakD gNQdZ"><div><div><span class="sc-gTgAvG sc-laROWl gCMUGw dCeeDp">Array of </span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA">strings</span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA"> <!-- -->&lt;<!-- -->uuid<!-- -->&gt;<!-- --> </span><span class="sc-gTgAvG sc-laROWl sc-aencn gCMUGw dCeeDp dktZnO">[ items<span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA"> &lt;<!-- -->uuid<!-- --> &gt;</span> ]</span></div> <div><div html="&lt;p&gt;List of task IDs created for the firmware update operation&lt;/p&gt;
@@ -8220,8 +8296,46 @@ <h3 id="typical-api-call-flow-for-tenant">Typical API Call Flow for Tenant</h3>
 " class="sc-iJuXkV sc-cBNeAB iNuSsz dyntKg"><p>ID of the Tray</p>
 </div></div></div></td></tr></tbody></table></div><h5 class="sc-iqHZue iFTCOQ">Request Body schema: <span class="sc-gWHgjU eBDHRN">application/json</span><div class="sc-gTgAvG sc-eJMOEj sc-dUrlDD gCMUGw egFobb eEdthm">required</div></h5><div html="" class="sc-iJuXkV sc-cBNeAB iNuSsz jtfGmi"></div><table class="sc-hHfrpe juzVUC"><tbody><tr class=""><td kind="field" title="siteId" class="sc-hBFaCF sc-fFubTW DPwQp hUqyua"><span class="sc-idOkdQ iNiPzl"></span><span class="property-name">siteId</span><div class="sc-gTgAvG sc-eJMOEj gCMUGw egFobb">required</div></td><td class="sc-bkAakD gNQdZ"><div><div><span class="sc-gTgAvG sc-laROWl gCMUGw dCeeDp"></span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA">string</span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA"> <!-- -->&lt;<!-- -->uuid<!-- -->&gt;<!-- --> </span></div> <div><div html="&lt;p&gt;ID of the Site&lt;/p&gt;
 " class="sc-iJuXkV sc-cBNeAB iNuSsz dyntKg"><p>ID of the Site</p>
-</div></div></div></td></tr><tr class="last "><td kind="field" title="version" class="sc-hBFaCF sc-fFubTW DPwQp hUqyua"><span class="sc-idOkdQ iNiPzl"></span><span class="property-name">version</span></td><td class="sc-bkAakD gNQdZ"><div><div><span class="sc-gTgAvG sc-laROWl gCMUGw dCeeDp"></span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA">string or null</span></div> <div><div html="&lt;p&gt;Target firmware version.&lt;/p&gt;
+</div></div></div></td></tr><tr class=""><td kind="field" title="version" class="sc-hBFaCF sc-fFubTW DPwQp hUqyua"><span class="sc-idOkdQ iNiPzl"></span><span class="property-name">version</span></td><td class="sc-bkAakD gNQdZ"><div><div><span class="sc-gTgAvG sc-laROWl gCMUGw dCeeDp"></span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA">string or null</span></div> <div><div html="&lt;p&gt;Target firmware version.&lt;/p&gt;
 " class="sc-iJuXkV sc-cBNeAB iNuSsz dyntKg"><p>Target firmware version.</p>
+</div></div></div></td></tr><tr class="last "><td kind="field" title="targets" class="sc-hBFaCF sc-fFubTW DPwQp hUqyua"><span class="sc-idOkdQ iNiPzl"></span><span class="property-name">targets</span></td><td class="sc-bkAakD gNQdZ"><div><div><span class="sc-gTgAvG sc-laROWl gCMUGw dCeeDp">Array of </span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA">strings</span><span class="sc-gTgAvG sc-laROWl sc-aencn gCMUGw dCeeDp dktZnO">[ items<span> <span class="sc-gTgAvG sc-clsJvZ gCMUGw gAOGaI"> <!-- -->non-empty<!-- --> </span></span> ]</span></div><div><span class="sc-gTgAvG gCMUGw">Items<!-- --> <!-- -->Enum<!-- -->:</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;bmc&quot;</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;cpld&quot;</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;bios&quot;</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;nvos&quot;</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;pmc&quot;</span> <span class="sc-gTgAvG sc-lcukLb gCMUGw jzGNYG">&quot;psu&quot;</span> </div> <div><div html="&lt;p&gt;Optional subset of firmware targets to update within the targeted tray.
+Names are lowercase and select sub-parts of the tray
+(BMC, BIOS, etc.). The accepted set per tray type comes from
+the Flow service&amp;#39;s NICo proto bindings (which mirror Core&amp;#39;s
+per-tray-type enums in &lt;code&gt;carbide-core/crates/rpc/proto/forge.proto&lt;/code&gt;),
+so the supported values track Core as new sub-parts are added:&lt;/p&gt;
+&lt;ul&gt;
+&lt;li&gt;switch trays (NvSwitchComponent): currently bmc, cpld, bios, nvos&lt;/li&gt;
+&lt;li&gt;powershelf trays (PowerShelfComponent): currently pmc, psu&lt;/li&gt;
+&lt;li&gt;compute trays (ComputeTrayComponent): currently bmc, bios
+(currently NOT honored end-to-end: the NICo compute-firmware
+path goes through SetFirmwareUpdateTimeWindow + auto-update,
+which has no per-target selection; the request is logged
+and the whole bundle is applied. Will be honored once
+compute moves to UpdateComponentFirmware.)
+Omitted or empty means &amp;quot;update everything in the bundle&amp;quot;
+(the historical default). Unknown names are rejected.
+Requires &lt;code&gt;version&lt;/code&gt; to be set.&lt;/li&gt;
+&lt;/ul&gt;
+" class="sc-iJuXkV sc-cBNeAB iNuSsz dyntKg"><p>Optional subset of firmware targets to update within the targeted tray.
+Names are lowercase and select sub-parts of the tray
+(BMC, BIOS, etc.). The accepted set per tray type comes from
+the Flow service&#39;s NICo proto bindings (which mirror Core&#39;s
+per-tray-type enums in <code>carbide-core/crates/rpc/proto/forge.proto</code>),
+so the supported values track Core as new sub-parts are added:</p>
+<ul>
+<li>switch trays (NvSwitchComponent): currently bmc, cpld, bios, nvos</li>
+<li>powershelf trays (PowerShelfComponent): currently pmc, psu</li>
+<li>compute trays (ComputeTrayComponent): currently bmc, bios
+(currently NOT honored end-to-end: the NICo compute-firmware
+path goes through SetFirmwareUpdateTimeWindow + auto-update,
+which has no per-target selection; the request is logged
+and the whole bundle is applied. Will be honored once
+compute moves to UpdateComponentFirmware.)
+Omitted or empty means &quot;update everything in the bundle&quot;
+(the historical default). Unknown names are rejected.
+Requires <code>version</code> to be set.</li>
+</ul>
 </div></div></div></td></tr></tbody></table><div><h3 class="sc-fHYzZk ihqrCS">Responses</h3><div><button class="sc-cbDJdZ ciHfuN" aria-expanded="true"><svg class="sc-dQoBM lfvciC" version="1.1" viewBox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true"><polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon></svg><strong class="sc-fWPeRB mtsUp">200<!-- --> </strong><div html="&lt;p&gt;OK&lt;/p&gt;
 " class="sc-iJuXkV sc-cBNeAB sc-cittYi iNuSsz eBjiEo hynizp"><p>OK</p>
 </div></button><div class="sc-hjWTnH dzJsxj"><h5 class="sc-iqHZue iFTCOQ">Response Schema: <span class="sc-gWHgjU eBDHRN">application/json</span></h5><table class="sc-hHfrpe juzVUC"><tbody><tr class="last "><td kind="field" title="taskIds" class="sc-hBFaCF sc-fFubTW DPwQp hUqyua"><span class="sc-idOkdQ iNiPzl"></span><span class="property-name">taskIds</span></td><td class="sc-bkAakD gNQdZ"><div><div><span class="sc-gTgAvG sc-laROWl gCMUGw dCeeDp">Array of </span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA">strings</span><span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA"> <!-- -->&lt;<!-- -->uuid<!-- -->&gt;<!-- --> </span><span class="sc-gTgAvG sc-laROWl sc-aencn gCMUGw dCeeDp dktZnO">[ items<span class="sc-gTgAvG sc-iNqMfM gCMUGw cxjEEA"> &lt;<!-- -->uuid<!-- --> &gt;</span> ]</span></div> <div><div html="&lt;p&gt;List of task IDs created for the firmware update operation&lt;/p&gt;
@@ -9556,7 +9670,7 @@ <h3 id="typical-api-call-flow-for-tenant">Typical API Call Flow for Tenant</h3>
 </ul>
 </div></div></div></div><div class="sc-elsZMO dQcVAt"></div></div></div>
       <script>
-      const __redoc_state = {"menu":{"activeItemIdx":-1},"spec":{"data":{"openapi":"3.1.0","info":{"title":"NVIDIA Infra Controller REST API","version":"1.5.0","summary":"NVIDIA Infra Controller REST API is the centralized RESTful gateway to access NVIDIA Infra Controller service","description":"NVIDIA Infra Controller REST API allows users to create and manage resources e.g. VPC, Subnets, Instances across all connected NVIDIA Infra Controller datacenters, also referred to as Sites.","license":{"name":"Apache-2.0","url":"https://www.apache.org/licenses/LICENSE-2.0"},"contact":{"name":"NVIDIA Infra Controller Dev Team"}},"servers":[{"url":"https://nico-rest-api.nico.svc.cluster.local","description":"Kubernetes Cluster"}],"tags":[{"name":"Getting Started","description":"This section provides a quick overview of the API and how to get started.\n\n### Authentication\nThe first step is to authenticate using a JWT bearer token. Organization structures and roles depend on the authentication configuration used. For details on authentication, please consult the\nNICo REST `auth` module [README](https://github.com/NVIDIA/infra-controller-rest/tree/main/auth).\n\n### API Version\nThe next step is to be aware of the API version being used. The API version can be retrieved by calling the [Retrieve Metadata endpoint](#tag/Metadata/operation/get-metadata). In general, the API maintains backward\ncompatibility with the previous versions. Any breaking changes are announced using a deprecation notice. Current and past deprecations are listed in the [Deprecations](#tag/Deprecations) section.\n\n### Service Account Mode\nDepending on the auth configuration used, the NICo REST API may be configured in Service Account mode. In this mode, API users can act as both Provider and Tenant as part of the same organization.\nIf this is the case, the user must first retrieve the Service Account by making a call to the [Retrieve Service Account endpoint](#tag/Service-Account/operation/get-current-service-account).\nFor service accounts, the Tenant entity is initialized as a privileged Tenant with `targetedInstanceCreation` capability enabled.\n\n### Provider or Tenant Mode\nIf NICo REST API is not configured in Service Account mode, the user should retrieve the Infrastructure Provider by making a call to the [Retrieve Infrastructure Provider endpoint](#tag/Infrastructure-Provider/operation/get-current-infrastructure-provider)\nor the Tenant by making a call to the [Retrieve Tenant endpoint](#tag/Tenant/operation/get-current-tenant).\n\nIn both cases, these calls initialize Provider and Tenant entities for the organization. All resources created are anchored to either the Provider or Tenant entity.\n\nOnce the Provider and the Tenant are initialized, the user can create resources by making calls to the appropriate endpoints.\n\n### Creating Site Level IP Blocks\nTo utilize a NICo Site, the Provider or Service Account holder must create IP Blocks for each network overlay defined in NICo Core [Site configuration toml file](https://github.com/NVIDIA/infra-controller-core/blob/v0.5.8/deploy/files/nico-api/nico-api-site-config.toml#L30).\n\nTo create an IP Block, the user must make a call to the [Create IP Block endpoint](#tag/IP-Block/operation/create-ipblock).\n\n> **Note:** From this point onwards, a brief outline is provided for the typical API call flows for various use cases.\n\n### Typical API Call Flow for Service Account\n\n- Retrieve available Sites using the [Retrieve All Sites endpoint](#tag/Site/operation/get-all-site) and choose a Site to create resources in. For _Disconnected_ NICo installations where NICo\nREST is deployed alongside NICo Core, typically there will be a single Site available.\n- For each Site IP Block, create a Network Allocation for the Tenant entity using the [Create Allocation endpoint](#tag/Allocation/operation/create-allocation) using the full prefix length.\nThis will create a Tenant IP Block for each Site IP Block.\n  - Creating an Allocation will create the Tenant in NICo Core.\n- Create a VPC using the [Create VPC endpoint](#tag/VPC/operation/create-vpc).\n- Create a VPC Prefix or Subnet referencing the VPC and a Tenant IP Block\n  - If the Site supports Native Networking (FNN), create a VPC Prefix using the [Create VPC Prefix endpoint](#tag/VPC-Prefix/operation/create-vpc-prefix). Otherwise the user should create a Subnet\n  using the [Create Subnet endpoint](#tag/Subnet/operation/create-subnet).\n- Create an Operating System using the [Create Operating System endpoint](#tag/Operating-System/operation/create-operating-system) specifying iPXE script and user data.\n- Retrieve available Machines on Site using the [Retrieve All Machines endpoint](#tag/Machine/operation/get-all-machine)\n- Create an Instance specifying the VPC, VPC Prefix or Subnet, Operating System, and Machine\n\n### Typical API Call Flow for Provider\n\n- Create a Tenant Account using the [Create Tenant Account endpoint](#tag/Tenant-Account/operation/create-tenant-account). Provider must know the Tenant org name.\n- Once the Tenant has accepted the Tenant Account, the Provider can allocate resources to the Tenant.\n- Retrieve available Sites using the [Retrieve All Sites endpoint](#tag/Site/operation/get-all-site) and choose a Site to create resources in.\n- Create an Instance Type using the [Create Instance Type endpoint](#tag/Instance-Type/operation/create-instance-type)\n- Retrieve available Machines on Site using the [Retrieve All Machines endpoint](#tag/Machine/operation/get-all-machine)\n- Update a Machine's Instance Type using the [Update Machine endpoint](#tag/Machine/operation/update-machine) or assign multiple Machines to an Instance Type using the\n[Create Instance Type/Machine Association endpoint](#tag/Instance-Type/operation/create-instance-type-machine-association)\n- Create a Compute Allocation for Tenant using the [Create Compute Allocation endpoint](#tag/Allocation/operation/create-allocation) referencing the Instance Type\n  - Creating any type of Allocation for a Tenant will create the Tenant in NICo Core.\n- Create a Network Allocation for Tenant using the [Create Allocation endpoint](#tag/Allocation/operation/create-allocation) referencing a Site IP Block\n  - Creating a Network Allocation will create a Tenant IP Block\n\n### Typical API Call Flow for Tenant\n\n- Accept the Tenant Account using the [Update Tenant Account endpoint](#tag/Tenant-Account/operation/update-tenant-account).\n- Retrieve available Sites using the [Retrieve All Sites endpoint](#tag/Site/operation/get-all-site) and choose a Site to create resources in. Any Site where the Tenant\nhas an Allocation will be returned.\n- Create a VPC using the [Create VPC endpoint](#tag/VPC/operation/create-vpc).\n- Retrieve available Site IP Blocks using the [Retrieve All IP Blocks endpoint](#tag/IP-Block/operation/get-all-ipblock). Any IP Block for which the Tenant has received\na Network Allocation from the Provider will be returned.\n- Create a VPC Prefix or Subnet referencing the VPC and a Tenant IP Block\n  - Site supports Native Networking (FNN), create a VPC Prefix using the [Create VPC Prefix endpoint](#tag/VPC-Prefix/operation/create-vpc-prefix)\n  - Otherwise the user should create a Subnet using the [Create Subnet endpoint](#tag/Subnet/operation/create-subnet)\n- Create an Operating System using the [Create Operating System endpoint](#tag/Operating-System/operation/create-operating-system) specifying iPXE script and user data.\n- Retrieve available Instance Types using the [Retrieve All Instance Types endpoint](#tag/Instance-Type/operation/get-all-instance-type). Any Instance Type for which\nthe Tenant has received a Compute Allocation from the Provider will be returned.\n- Create an Instance specifying the VPC, VPC Prefix or Subnet, Operating System, and Instance Type"},{"name":"Service Account","description":"When API service is configured in Service Account mode, API users can act as both Provider and Tenant. For service accounts, the Tenant entity is initialized as a\nprivileged Tenant with `targetedInstanceCreation` capability enabled."},{"name":"Infrastructure Provider","description":"Infrastructure Provider is the anchor entity for an organization that owns and manages Site resources.\n\nDeprecation history:\n\n- `name` attribute was deprecated and was removed on August 17th, 2023 0:00 UTC. Please use `orgDisplayName` instead.\n- `POST /org/:orgName/nico/infrastructure-provider` endpoint was deprecated and was removed on August 17th, 2023 0:00 UTC. Infrastructure Providers are automatically created when retrieved by a Provider Admin.\n- `PATCH /org/:orgName/nico/infrastructure-provider/current` endpoint was deprecated and was removed on August 17th, 2023 0:00 UTC. Infrastructure Provider details are populated from Org information and cannot be updated by the user."},{"name":"Tenant","description":"Tenant is the anchor entity for an organization that consumes Network and Compute resources on a Site.\n\nDeprecation history:\n\n- `name` attribute was deprecated and was removed on August 17th, 2023. Please use `orgDisplayName` instead.\n- `enableSSHAccess` attribute was deprecated and was removed on August 17th, 2023 0:00 UTC. Please use 'isSerialConsoleSSHKeysEnabled' attribute of Site instead.\n- `POST /org/:orgName/nico/tenant` endpoint was deprecated and was removed on August 17th, 2023 0:00 UTC. Tenants are automatically created when retrieved by a Tenant Admin.\n- `PATCH /org/:orgName/nico/tenant/current` endpoint was deprecated and was removed on August 17th, 2023 0:00 UTC. Tenant details are populated from Org information and cannot be updated by the user."},{"name":"Tenant Account","description":"Tenant Account connects a Tenant with an Infrastructure Provider. It represents/contains any information pertaining to their relationship."},{"name":"Site","description":"Site is a datacenter that contains physical hardware and networking resources. All resources created by Provider or Tenant are directly or indirectly anchored to the Site object.\n\nDeprecation history:\n\n- `rackLevelAdministration` capability attribute was deprecated in favor of `flow` and was removed on May 13th, 2026 0:00 UTC. Please use `flow` instead.\n- `isRackLevelAdministrationEnabled` query parameter was deprecated in favor of `isFlowEnabled` and was removed on May 13th, 2026 0:00 UTC. Please use `isFlowEnabled` instead."},{"name":"Allocation","description":"Allocations are the mechanism by which Provider can delegate Network and Compute resources to Tenant."},{"name":"VPC","description":"VPC defines the networking isolation boundary for Tenant's Instances."},{"name":"VPC Peering","description":"VPC Peering allows Instances in one VPC to communicate with Instances in another VPC on the same Site."},{"name":"VPC Prefix","description":"VPC Prefix is a network prefix belonging to an IP Block allocated to a Tenant. Tenant can use VPC Prefixes to enable network connectivity between their Instances.\n\nOnly Sites that support Native Networking (FNN) offer VPC Prefix management."},{"name":"Subnet","description":"Subnet is a network prefix belonging to an IP Block allocated to a Tenant. Tenant can use Subnets to enable network connectivity between their Instances.\n\nSubnets are used on Sites that do not support Native Networking (FNN).\n\nDeprecation history:\n\n- `ipBlockSize` was deprecated in favor of `prefixLength` and was removed on April 15th, 2023 0:00 UTC. Please use `prefixLength` instead."},{"name":"Expected Machine","description":"Expected Machine identifies a Machine that is expected to be discovered at a Site. Infrastructure Providers can pre-register Expected Machines using BMC credentials\nand serial numbers to help with Machine discovery and ingestion."},{"name":"Expected Power Shelf","description":"Expected Power Shelf identifies a Power Shelf that is expected to be discovered at a Site. Infrastructure Providers can pre-register Expected Power Shelves using BMC\ncredentials and serial numbers to help with Power Shelf discovery and ingestion."},{"name":"Expected Rack","description":"Expected Rack identifies a Rack that is expected to be discovered at a Site. Infrastructure Providers can pre-register Expected Racks with an operator-supplied\nrack identifier and a Rack Profile reference to help with Rack discovery and ingestion. Chassis identity and physical location information are conveyed via\nwell-known label keys (`chassis.manufacturer`, `chassis.serial-number`, `chassis.model`, `location.region`, `location.datacenter`, `location.room`, `location.position`)."},{"name":"Expected Switch","description":"Expected Switch identifies a Switch that is expected to be discovered at a Site. Infrastructure Providers can pre-register Expected Switches using BMC, NvOS credentials\nand serial numbers to help with Switch discovery and ingestion."},{"name":"SKU","description":"SKU (Stock Keeping Unit) defines one or more hardware configurations or Machine Bill of Materials (BOM).\n\nSKUs are automatically derived from machine hardware characteristics and used to group similar machines. SKUs are read-only and managed by the system."},{"name":"InfiniBand Partition","description":"InfiniBand (IB) is a high-performance, low-latency networking standard designed for interconnecting servers and storage in HPC (High-Performance Computing) and AI systems,\nutilizing RDMA (Remote Direct Memory Access) to reduce CPU overhead. InfiniBand Partitions are used to group Machines into logical partitions for network isolation and load distribution."},{"name":"NVLink Logical Partition","description":"NVLink Logical Partitions are used to group GPUs into logical partitions for shared memory and low-latency direct communication between GPUs."},{"name":"Operating System","description":"Operating Systems in NICo are typically iPXE scripts that are used to boot Machines."},{"name":"Instance Type","description":"Instance Types allow grouping Machines into a pool defined by their capabilities. Providers can then allocate a portion of the Instance Type pool to a Tenant.\n\nDeprecation history:\n\n- `includeMachineAssociation` was deprecated in favor of `includeMachineAssignment` and was removed on July 26th, 2023 0:00 UTC. Please use `includeMachineAssignment` instead.\n- `displayName` attribute was deprecated and removed on October 30, 2024 0:00 UTC. Please update your usage accordingly."},{"name":"Instance","description":"Instance is a Machine provisioned with an Operating System by a Tenant and attached to one or more VPC Prefixes or Subnets.\n\nDeprecation history:\n\n- `sshUrl` was deprecated in favor of `serialConsoleUrl` and was removed on April 25th, 2023 0:00 UTC. Please use `serialConsoleUrl` instead.\n- `instanceSubnets` was deprecated in favor of `interfaces` and was removed on May 10th, 2023 0:00 UTC. Please use `interfaces` instead.\n- `sshkeygroups` was deprecated in favor of `sshKeyGroups` and was removed on September 4th, 2025 0:00 UTC. Please use `sshKeyGroups` instead."},{"name":"Machine","description":"Machine is a physical server that contains CPUs, GPUs, memory, storage, and networking hardware. Machines are the physical building blocks of a Site."},{"name":"Machine Capability","description":"Machine Capability defines the hardware capabilities of a Machine. Machine Capabilities can be used to group Machines into Instance Types."},{"name":"Rack","description":"Rack is a physical enclosure that contains a number of Machines. Racks are the physical building blocks of a Site."},{"name":"Tray","description":"Tray represents a component within a Rack."},{"name":"Network Security Group","description":"Network Security Group is a security policy that controls the traffic flowing between Instances."},{"name":"IP Block","description":"IP Block is a contiguous block of IP addresses defined by a prefix and prefix length.\n\nIt can be used by the Provider to describe the overlay network of a particular Site. Providers can also use Allocations to delegate portions of these IP Blocks to Tenants.\n\nDeprecation history:\n\n- `blockSize` was deprecated in favor of `prefixLength` and was removed on April 15th, 2023 0:00 UTC. Please use `prefixLength` instead."},{"name":"DPU Extension Service","description":"DPU Extension Service allows users to run custom services in the DPUs of their Instances. Currently K8s pods are the only supported service type."},{"name":"SSH Key Group","description":"SSH Key Groups allow grouping several SSH Keys together so they can be synced to Sites and used to access the Serial Console of Instances."},{"name":"SSH Key","description":"SSH Key is a public key that can be used to access the Serial Console of an Instance."},{"name":"User","description":"User is a logical entity that identifies individuals operating on behalf of an organization."},{"name":"Audit","description":"Audit is a record of actions taken by users on the API."},{"name":"Metadata","description":"Metadata describes various system level attributes of the API service."},{"name":"Deprecations","description":"NICo REST API maintains backward compatibility with the previous versions. Any breaking changes are announced using deprecation notices.\n\nEndpoints that have deprecations will be grouped here. Following deprecations are in effect or slated to be effective in future:\n\nInfrastructure Provider:\n- `name` attribute was deprecated and was removed on August 17th, 2023 0:00 UTC. Please use `orgDisplayName` instead.\n- `POST /org/:orgName/nico/infrastructure-provider` endpoint was deprecated and was removed on August 17th, 2023 0:00 UTC. Infrastructure Providers are automatically created when retrieved by a Provider Admin.\n- `PATCH /org/:orgName/nico/infrastructure-provider/current` endpoint was deprecated and was removed on August 17th, 2023 0:00 UTC. Infrastructure Provider details are populated from Org information and cannot be updated by user.\n\nTenant:\n- `name` attribute was deprecated and was removed on August 17th, 2023. Please use `orgDisplayName` instead.\n- `enableSSHAccess` attribute was deprecated and was removed on August 17th, 2023 0:00 UTC. Please use 'isSerialConsoleSSHKeysEnabled' attribute of Site instead.\n- `POST /org/:orgName/nico/tenant` endpoint was deprecated and was removed on August 17th, 2023 0:00 UTC. Tenants are automatically created when retrieved by a Tenant Admin.\n- `PATCH /org/:orgName/nico/tenant/current` endpoint was deprecated and was removed on August 17th, 2023 0:00 UTC. Tenant details are populated from Org information and cannot be updated by user.\n\nInstance Type:\n- `includeMachineAssociation` was deprecated in favor of `includeMachineAssignment` and was removed on July 26th, 2023 0:00 UTC. Please use `includeMachineAssignment` instead.\n- `displayName` attribute was deprecated and removed on October 30, 2024 0:00 UTC. Please update your usage accordingly.\n\nInstance:\n- `sshUrl` was deprecated in favor of `serialConsoleUrl` and was removed on April 25th, 2023 0:00 UTC. Please use `serialConsoleUrl` instead.\n- `instanceSubnets` was deprecated in favor of `interfaces` and was removed on May 10th, 2023 0:00 UTC. Please use `interfaces` instead.\n- `sshkeygroups` was deprecated in favor of `sshKeyGroups` and was removed on September 4th, 2025 0:00 UTC. Please use `sshKeyGroups` instead.\n\nIP Block:\n- `blockSize` was deprecated in favor of `prefixLength` and was removed on April 15th, 2023 0:00 UTC. Please use `prefixLength` instead.\n\nSubnet:\n- `ipBlockSize` was deprecated in favor of `prefixLength` and was removed on April 15th, 2023 0:00 UTC. Please use `prefixLength` instead.\n\nSite:\n- `rackLevelAdministration` capability attribute was deprecated in favor of `flow` and was removed on May 13th, 2026 0:00 UTC. Please use `flow` instead.\n- `isRackLevelAdministrationEnabled` query parameter was deprecated in favor of `isFlowEnabled` and was removed on May 13th, 2026 0:00 UTC. Please use `isFlowEnabled` instead."}],"paths":{"/v2/org/{org}/nico/service-account/current":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve Service Account status for current org","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceAccount"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-current-service-account","description":"Retrieve Service Account status for current org\n\nAPI service must be configured for Service Account access at the time of deployment. It cannot be enabled or disabled via API.","parameters":[],"tags":["Service Account"]}},"/v2/org/{org}/nico/infrastructure-provider/current":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve Infrastructure Provider for current Org","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfrastructureProvider"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","org":"rf43bbtnb9c5","orgDisplayName":"Dell Corporation","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-current-infrastructure-provider","description":"Retrieve Infrastructure Provider entity for current Org.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[],"tags":["Infrastructure Provider"]}},"/v2/org/{org}/nico/infrastructure-provider/current/stats":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve Stats for current Infrastructure Provider","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfrastructureProviderStats"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-current-infrastructure-provider-stats","description":"Retrieve stats for current Infrastructure Provider.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[],"tags":["Infrastructure Provider"]}},"/v2/org/{org}/nico/tenant/current":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve Tenant for current Org","tags":["Tenant"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tenant"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","org":"qygdmg8oqik8","orgDisplayName":"Echo Corporation","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z","capabilities":{"targetedInstanceCreation":false}}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-current-tenant","description":"Retrieve Tenant entity for current Org.\n\nUser must have authorization role with `TENANT_ADMIN` suffix.","parameters":[]}},"/v2/org/{org}/nico/tenant/current/stats":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve Stats for current Tenant","tags":["Tenant"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantStats"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-current-tenant-stats","description":"Retrieve stats for current Tenant.\n\nUser must have authorization role with `TENANT_ADMIN` suffix.","parameters":[]}},"/v2/org/{org}/nico/tenant/account":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Tenant Accounts","tags":["Tenant Account"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TenantAccount"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","infrastructureProviderOrg":"xskkpgqpeakn","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","tenantOrg":"rf43bbtnb9c5","tenantContact":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","email":"janed@nvidia.com","firstName":"Jane","lastName":"Doe","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},"allocationCount":0,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-tenant-account","description":"Retrieve all Tenant Accounts.\n\nEither `infrastructureProviderId` or `tenantId` query param must be specified.\n\nIf `infrastructureProviderId` query param is provided, then org must have an Infrastructure Provider entity and its ID should match the query param value. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nIf `tenantId` query param is provided, then org must have a Tenant entity and its ID should match the query param value. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","description":"Filter TenantAccounts by Infrastructure Provider ID"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","description":"Filter TenantAccounts by Tenant ID"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search string to filter Tenant Accounts by account number, tenant org, or tenant org display name"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC","ACCOUNT_NUMBER_ASC","ACCOUNT_NUMBER_DESC","TENANT_ORG_NAME_ASC","TENANT_ORG_NAME_DESC","TENANT_ORG_DISPLAY_NAME_ASC","TENANT_ORG_DISPLAY_NAME_DESC","TENANT_CONTACT_EMAIL_ASC","TENANT_CONTACT_EMAIL_DESC","TENANT_CONTACT_FULL_NAME_ASC","TENANT_CONTACT_FULL_NAME_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create Tenant Account","operationId":"create-tenant-account","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantAccount"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","infrastructureProviderOrg":"xskkpgqpeakn","tenantId":null,"tenantOrg":"rf43bbtnb9c5","tenantContact":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","email":"janed@nvidia.com","firstName":"Jane","lastName":"Doe","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},"allocationCount":0,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create a Tenant Account.\n\nOrg must have an Infrastructure Provider entity and its ID must match the Infrastructure Provider ID in request data. User must have authorization role with `PROVIDER_ADMIN` suffix\n\nInfrastructure Provider can create a Tenant Account by specifying the Tenant's UUID or Tenant's org name. This will set the status of the Tenant Account to \"Invited\". Then the Tenant can view this account information and are able to confirm/accept the account by updating the Tenant Account.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantAccountCreateRequest"},"examples":{"example-1":{"value":{"infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantOrg":"rf43bbtnb9c5"}}}}}},"tags":["Tenant Account"]}},"/v2/org/{org}/nico/tenant/account/{accountId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"accountId","in":"path","required":true,"description":"ID of the Tenant Account"}],"get":{"summary":"Retrieve Tenant Account","tags":["Tenant Account"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantAccount"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","infrastructureProviderOrg":"xskkpgqpeakn","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","tenantOrg":"rf43bbtnb9c5","tenantContact":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","email":"janed@nvidia.com","firstName":"Jane","lastName":"Doe","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},"allocationCount":2,"status":"Ready","statusHistory":[{"status":"Ready","message":"Account ready, Tenant accepted invite","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"status":"Invited","message":"Request received, pending Tenant acceptance","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-tenant-account","description":"Retrieve a Tenant Account by ID\n\nEither `infrastructureProviderId` or `tenantId` query param must be specified.\n\nIf `infrastructureProviderId` query param is provided, then org must have an Infrastructure Provider entity and its ID should match the query param value. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nIf `tenantId` query param is provided, then org must have a Tenant entity and its ID should match the query param value. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","description":"Filter Tenant Accounts by Infrastructure Provider ID"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","description":"Filter Tenant Accounts by Tenant ID"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"patch":{"summary":"Update Tenant Account","operationId":"update-tenant-account","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantAccount"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","infrastructureProviderOrg":"xskkpgqpeakn","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","tenantOrg":"rf43bbtnb9c5","tenantContact":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","email":"janed@nvidia.com","firstName":"Jane","lastName":"Doe","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},"allocationCount":0,"status":"Ready","statusHistory":[{"status":"Ready","message":"Account ready, Tenant accepted invite","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"status":"Invited","message":"Request received, pending Tenant acceptance","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Tenant Account"],"description":"Update a Tenant Account.\n\nCan be used to accept an invitation sent by Infrastructure Provider.\n\nOrg must have a tenant entity whose ID matches the `tenantId` of the Tenant Account object. User must have authorization role with `TENANT_ADMIN` suffix. Can only update a TenantAccount that has `Invited` status.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantAccountUpdateRequest"},"examples":{"example-1":{"value":{}}}}},"description":"No params needed, an empty request body will suffice."}},"delete":{"summary":"Delete Tenant Account","operationId":"delete-tenant-account","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a Tenant Account by ID.\n\nOrg must have an Infrastructure Provider entity, specified Tenant Account must be created by said Provider. Requesting user must have `PROVIDER_ADMIN` role.\n\nTenant cannot delete a Tenant Account.","tags":["Tenant Account"]}},"/v2/org/{org}/nico/site":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Sites","tags":["Site"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Site"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-site","description":"Retrieve all Sites for org.\n\nUser must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix. `infrastructureProviderId` or `tenantId` query param may be required for older API versions.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","description":"Filter Sites by Infrastructure Provider ID"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","description":"Filter Sites by Tenant ID"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Sites by Status. Can be specified multiple times to filter on more than one status"},{"schema":{"type":"boolean"},"in":"query","name":"isNativeNetworkingEnabled","description":"Filter Sites by native networking enabled flag. Requires Provider Admin role."},{"schema":{"type":"boolean"},"in":"query","name":"isNetworkSecurityGroupEnabled","description":"Filter Sites by network security group enabled flag. Requires Provider Admin role."},{"schema":{"type":"boolean"},"in":"query","name":"isNVLinkPartitionEnabled","description":"Filter Sites by NVLink partitioning enabled flag. Requires Provider Admin role."},{"schema":{"type":"boolean"},"in":"query","name":"isFlowEnabled","description":"Filter Sites by NICo Flow enabled flag. Requires Provider Admin role."},{"schema":{"type":"boolean"},"in":"query","name":"includeMachineStats","description":"Include a breakdown of Machine counts by life-cycle status and health. Requires Provider Admin role."},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description, location, contact, and status fields"},{"schema":{"type":"string","enum":["InfrastructureProvider"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC","DESCRIPTION_ASC","DESCRIPTION_DESC","LOCATION_ASC","LOCATION_DESC","CONTACT_ASC","CONTACT_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create Site","operationId":"create-site","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Site"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create a Site for the org.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nTenants cannot create Sites.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteCreateRequest"},"examples":{"example-1":{"value":{"name":"San Jose Central 4","description":"Datacenter serving San Jose central region","location":{"city":"San Jose","state":"CA","country":"USA"},"contact":{"email":"johndoe@nvidia.com"}}}}}}},"tags":["Site"]}},"/v2/org/{org}/nico/site/{siteId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"path","required":true,"description":"ID of the Site"}],"get":{"summary":"Retrieve Site","tags":["Site"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Site"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-site","description":"Retrieve a specific Site by ID.\n\nUser must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix.\n\nAccess is granted if:\n- The Site is owned by the org's Infrastructure Provider\n- The org's Tenant has an Allocation for Site\n- The org's Tenant is privileged and has Account with Site's Provider","parameters":[]},"patch":{"summary":"Update Site","operationId":"update-site","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Site"}}}}},"tags":["Site"],"description":"Update a specific Site\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix.\n\nInfrastructure Provider updating the Site must be the owner of the Site. At present, there are no other Site specific configurations modifiable by Tenant.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteUpdateRequest"},"examples":{"example-1":{"value":{"name":"San Jose Central No.4","description":"Datacenter 4 serving central San Jose","renewRegistrationToken":true,"serialConsoleHostname":"sol.nico.acme.com","location":{"city":"San Jose","state":"CA","country":"USA"},"contact":{"email":"johndoe@nvidia.com"}}},"example-2":{"value":{"isSerialConsoleSSHKeysEnabled":true,"contact":{"email":"janedoe@nvidia.com"}}}}}}}},"delete":{"summary":"Delete Site","operationId":"delete-site","responses":{"202":{"description":"Deletion request was accepted"}},"tags":["Site"],"description":"Delete a specific Site\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nSite can only be deleted if all Allocations have been deleted.","parameters":[{"schema":{"type":"boolean"},"in":"query","name":"purgeMachines","description":"Scrub all Machine data associated with this Site to re-pair"}]}},"/v2/org/{org}/nico/site/{siteId}/status-history":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"path","required":true,"description":"ID of the Site"}],"get":{"summary":"Retrieve Site status history","tags":["Site"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"examples":{"Example 1":{"value":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-site-status-history","description":"Retrieve a specific Site status history\n\nUser must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix.\n\nAccess is granted if:\n- The Site is owned by the org's Infrastructure Provider\n- The org's Tenant has an Allocation for Site\n- The org's Tenant is privileged and has Account with Site's Provider","parameters":[{"schema":{"type":"integer"},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer"},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string"},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/allocation":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Allocations","tags":["Allocation"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Allocation"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Echo Studios","description":"Echo Studios resource allocation in SJC4","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z","allocationConstraints":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"instanceType":{"name":"x3.large","infrastructureProviderId":"63c29416-8833-4eaf-9e1c-7c0173cc3150","siteId":"c9f4f276-6f7a-4209-953c-2b9870ce7cc1","status":"Ready"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-allocation","description":"Retrieve all Allocations for the org.\n\nProvider and Tenant roles are inferred from the org's membership. User must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix.\n\nResults are returned from both Provider and Tenant perspectives when the org has both roles.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","deprecated":true,"description":"Filter Allocations by Infrastructure Provider ID."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","description":"Filter Allocations by Tenant ID."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter Allocations by Site ID.  Can be specified multiple times to filter on more than one Site ID."},{"schema":{"type":"string"},"in":"query","name":"id","description":"Filter Allocations by ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string","enum":["InstanceType","IPBlock"]},"in":"query","name":"resourceType","description":"Filter Allocations by Constraint Resource Type.  Can be specified multiple times to filter on more than one Constraint Resource Type."},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Allocations by Status.  Can be specified multiple times to filter on more than one Status."},{"schema":{"type":"string"},"in":"query","name":"resourceTypeId","description":"Filter Allocations by Constraint Resource Type ID.  Can be specified multiple times to filter on more than one Constraint Resource Type ID."},{"schema":{"type":"string","enum":["Reserved","OnDemand","Preemptible"]},"in":"query","name":"constraintType","description":"Filter Allocations by Constraint Type.  Can be specified multiple times to filter on more than one Constraint Type."},{"schema":{"type":"integer"},"in":"query","name":"constraintValue","description":"Filter Allocations by Constraint Value.  Can be specified multiple times to filter on more than one Constraint Value."},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description and status fields"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC","SITE_NAME_ASC","SITE_NAME_DESC","TENANT_ORG_DISPLAY_NAME_ASC","TENANT_ORG_DISPLAY_NAME_DESC","INSTANCE_TYPE_NAME_ASC","INSTANCE_TYPE_NAME_DESC","IP_BLOCK_NAME_ASC","IP_BLOCK_NAME_DESC","CONSTRAINT_VALUE_ASC","CONSTRAINT_VALUE_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create Allocation","operationId":"create-allocation","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Allocation"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Echo Studios","description":"Echo Studios resource allocation in SJC4","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z","allocationConstraints":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"bd5a0240-eb62-4bff-91f7-335e6bb86459","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an Allocation for the org.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nTo successfully create a compute Allocation, there must be enough unallocated Machines associated with the Instance Type to satisfy the constraint value.\nFor network Allocation, the source site-level IP Block must have an available prefix with length equal to constraint value.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllocationCreateRequest"},"examples":{"example-1":{"value":{"name":"Echo Studios","description":"Echo Studios resource allocation in SJC4","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","allocationConstraints":[{"resourceType":"InstanceType","resourceTypeId":"bd5a0240-eb62-4bff-91f7-335e6bb86459","constraintType":"Reserved","constraintValue":10}]}}}}}},"tags":["Allocation"]}},"/v2/org/{org}/nico/allocation/{allocationId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"allocationId","in":"path","description":"ID of the Allocation","required":true}],"get":{"summary":"Retrieve Allocation","tags":["Allocation"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Allocation"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Echo Studios","description":"Echo Studios resource allocation in SJC4","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z","allocationConstraints":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"instanceType":{"name":"x3.large","infrastructureProviderId":"63c29416-8833-4eaf-9e1c-7c0173cc3150","siteId":"c9f4f276-6f7a-4209-953c-2b9870ce7cc1","status":"Ready"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-allocation","description":"Retrieve Allocation by ID\n\nProvider and Tenant roles are inferred from the org's membership. Allocation must belong to the Provider or Tenant associated with the org.\n\nUser must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","deprecated":true,"description":"Filter Allocations by Infrastructure Provider ID."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","deprecated":true,"description":"Filter Allocations by Tenant ID."},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"delete":{"summary":"Delete Allocation","operationId":"delete-allocation","responses":{"202":{"description":"Accepted"}},"description":"Delete an Allocation by ID.\n\nOrg must have an Infrastructure Provider entity, specified Allocation must be created by said Provider. Requesting user must have `PROVIDER_ADMIN` role.\n\nTenant management of Allocation is not supported in MVP.","tags":["Allocation"]},"patch":{"summary":"Update Allocation","operationId":"update-allocation","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Allocation"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Echo Studios Compute","description":"Echo Studios compute resource allocation in SJC4","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z","allocationConstraints":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}}}}},"description":"Update an existing Allocation\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix. Provider must own the Allocation.\n\nTenant management of Allocation is not supported in MVP.","tags":["Allocation"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllocationUpdateRequest"},"examples":{"example-1":{"value":{"name":"Echo Studios Compute","description":"Echo Studios compute resource allocation in SJC4"}}}}}}}},"/v2/org/{org}/nico/allocation/{allocationId}/constraint":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"allocationId","in":"path","required":true,"description":"ID of the Allocation"}],"get":{"summary":"Retrieve all Allocation Constraints","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AllocationConstraint"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"instanceType":{"name":"x3.large","infrastructureProviderId":"63c29416-8833-4eaf-9e1c-7c0173cc3150","siteId":"c9f4f276-6f7a-4209-953c-2b9870ce7cc1","status":"Ready"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-allocation-constraint","description":"Retrieve all Allocation Constraints for a given Allocation ID.\n\nIf org has an Infrastructure Provider entity, then specified Allocation must have been created by the Provider and requesting user must have `PROVIDER_ADMIN` role.\n\nIf org does not have an Infrastructure Provider entity but has a Tenant entity, then specified Allocation must belong to the Tenant and requesting user must have `TENANT_ADMIN` role.","parameters":[{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["RESOURCE_TYPE_ASC","RESOURCE_TYPE_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"tags":["Allocation"]},"post":{"summary":"Create Allocation Constraint","operationId":"create-allocation-constraint","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllocationConstraint"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"instanceType":{"name":"x3.large","infrastructureProviderId":"63c29416-8833-4eaf-9e1c-7c0173cc3150","siteId":"c9f4f276-6f7a-4209-953c-2b9870ce7cc1","status":"Ready"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an Allocation Constraint for a given Allocation ID.\n\nOrg must have an Infrastructure Provider entity and specified Allocation must have been created by the Provider. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllocationConstraintCreateRequest"},"examples":{"example-1":{"value":{"resourceType":"InstanceType","resourceTypeId":"bd5a0240-eb62-4bff-91f7-335e6bb86459","constraintType":"Reserved","constraintValue":10}}}}}},"tags":["Allocation"]}},"/v2/org/{org}/nico/allocation/{allocationId}/constraint/{allocationConstraintId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"allocationId","in":"path","required":true,"description":"ID of the Allocation"},{"schema":{"type":"string","format":"uuid"},"name":"allocationConstraintId","in":"path","required":true,"description":"ID of the Allocation Constraint"}],"get":{"summary":"Retrieve Allocation Constraint","tags":["Allocation"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AllocationConstraint"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"instanceType":{"name":"x3.large","infrastructureProviderId":"63c29416-8833-4eaf-9e1c-7c0173cc3150","siteId":"c9f4f276-6f7a-4209-953c-2b9870ce7cc1","status":"Ready"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-allocation-constraint","description":"Retrieve an Allocation Constraint for a given Allocation ID.\n\nIf org has an Infrastructure Provider entity, then specified Allocation must have been created by the Provider and requesting user must have `PROVIDER_ADMIN` role.\n\nIf org does not have an Infrastructure Provider entity but has a Tenant entity, then specified Allocation must belong to the Tenant and requesting user must have `TENANT_ADMIN` role.","parameters":[]},"patch":{"summary":"Update Allocation Constraint","operationId":"update-allocation-constraint","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllocationConstraint"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":20,"derivedResourceId":null,"instanceType":{"name":"x3.large","infrastructureProviderId":"63c29416-8833-4eaf-9e1c-7c0173cc3150","siteId":"c9f4f276-6f7a-4209-953c-2b9870ce7cc1","status":"Ready"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}}},"description":"Update an existing Allocation Constraint by ID\n\nOrg must have an Infrastructure Provider. Specified Allocation must have been created by the Provider and requesting user must have `PROVIDER_ADMIN` role.\n\nModifying allocations may not be possible if Tenant has started utilizing resources from this allocation.\n\nIn case of InstanceType resource, `constraintValue` can be incremented anytime, but not decremented if it requires decommissioning Tenant resources.\n\nIn case of IPBlock resource, `constraintValue` can not be modified if Tenant resources are using IPs from the block.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllocationConstraintUpdateRequest"},"examples":{"example-1":{"value":{"constraintValue":20}}}}}},"tags":["Allocation"]},"delete":{"summary":"Delete Allocation Constraint","operationId":"delete-allocation-constraint","responses":{"202":{"description":"Accepted"}},"description":"Delete an existing Allocation Constraint by ID\n\nOrg must have an Infrastructure Provider. Specified Allocation must have been created by the Provider and requesting user must have `PROVIDER_ADMIN` role.\n","tags":["Allocation"]}},"/v2/org/{org}/nico/ipblock":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all IP Blocks","tags":["IP Block"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/IpBlock"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Public Network Overlay for Site SJC4","description":"This is the primary IP overlay for SJC4. All IPs are publicly routable","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantId":null,"routingType":"Public","prefix":"202.168.1.0","prefixLength":24,"protocolVersion":"IPv4","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-ipblock","description":"Retrieve all IP blocks for the org.\n\nUser must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix. `infrastructureProviderId` or `tenantId` query param may be required for older API versions.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","description":"Filter IP Blocks by Infrastructure Provider ID"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","description":"Filter IP Blocks by Tenant ID"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter IP Blocks by Site ID"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter IP Blocks by Status"},{"schema":{"type":"boolean"},"in":"query","name":"includeUsageStats","description":"Include IP Block usage stats in response"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description and status fields"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","PREFIX_ASC","PREFIX_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create IP Block","operationId":"create-ipblock","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IpBlock"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Public Network Overlay for Site SJC4","description":"This is the primary IP overlay for SJC4. All IPs are publicly routable","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantId":null,"routingType":"Public","prefix":"202.168.1.0","prefixLength":24,"protocolVersion":"IPv4","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an IP block for the org.\n\nOnly Infrastructure Providers can create a root IP Block. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nTenant IP Blocks are created via Allocation.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IpBlockCreateRequest"},"examples":{"example-1":{"value":{"name":"Public Network Overlay for Site SJC4","description":"This is the primary IP overlay for SJC4. All IPs are publicly routable","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","routingType":"Public","prefix":"202.168.1.0","prefixLength":24,"protocolVersion":"IPv4"}}}}}},"tags":["IP Block"]}},"/v2/org/{org}/nico/ipblock/{ipBlockId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"ipBlockId","in":"path","required":true,"description":"ID of the IP Block"}],"get":{"summary":"Retrieve IP Block","tags":["IP Block"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IpBlock"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Public Network Overlay for Site SJC4","description":"This is the primary IP overlay for SJC4. All IPs are publicly routable","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantId":null,"routingType":"Public","prefix":"202.168.16.0","prefixLength":20,"protocolVersion":"IPv4","usageStats":{"availableIPs":256,"acquiredIPs":2,"availablePrefixes":["192.168.201.0/24"],"availableSmallestPrefixes":64,"acquiredPrefixes":0},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-ipblock","description":"Retrieve an IP Block by ID.\n\nUser must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","description":"Filter IP Blocks by Infrastructure Provider ID"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","description":"Filter IP Blocks by Tenant ID"},{"schema":{"type":"boolean"},"in":"query","name":"includeUsageStats","description":"Include IP Block usage stats in response"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"delete":{"summary":"Delete IP Block","operationId":"delete-ipblock","responses":{"202":{"description":"Accepted"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete an IP block\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix. Only root IP Blocks can be deleted if there are no allocations associated with it.\n\nTenant IP Blocks are managed via Allocation.","tags":["IP Block"]},"patch":{"summary":"Update IP Block","operationId":"update-ipblock","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IpBlock"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Public Network Overlay for Site SJC-4","description":"This is the primary IP overlay for SJC-4. All IPs are publicly routable","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantId":null,"routingType":"Public","prefix":"202.168.16.0","prefixLength":20,"protocolVersion":"IPv4","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}}},"description":"Update an existing IP Block\n\nOrg must have an Infrastructure Provider. Specified IP Block must have been created by the Provider and requesting user must have `PROVIDER_ADMIN` role. Only root IP Blocks can be patched.\n\nTenant IP Blocks are managed via Allocation.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IpBlockUpdateRequest"},"examples":{"example-1":{"value":{"name":"Public Network Overlay for Site SJC-4","description":"This is the primary IP overlay for SJC-4. All IPs are publicly routable"}}}}}},"tags":["IP Block"]}},"/v2/org/{org}/nico/ipblock/{ipBlockId}/derived":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"ipBlockId","in":"path","required":true,"description":"ID of the IP Block"}],"get":{"summary":"Retrieve All Derived IP Blocks","tags":["IP Block"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/IpBlock"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Public Network Overlay for Site SJC4","description":"This is the primary IP overlay for SJC4. All IPs are publicly routable","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantId":"97c57510-b443-43b4-881c-974d4b86c87c","routingType":"Public","prefix":"202.168.1.0","prefixLength":24,"protocolVersion":"IPv4","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-derived-ipblock","description":"Retrieve all child IP Blocks allocated to Tenants from a specific Provider super IP Block. When allocations are created from a super block, individual Tenant IP Blocks are created as a result.\n\nThe IP Block in URL must belong to the Infrastructure Provider associated with the Org.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter IP Blocks by Status"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description and status fields"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","PREFIX_ASC","PREFIX_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/vpc":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all VPCs","tags":["VPC"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VPC"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-vpc","description":"Virtual network for machines executing Spark jobs","org":"xskkpgqpeakn","tenantId":"34f5c98e-f430-457b-a812-92637d0c6fd0","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","controllerVpcId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","networkVirtualizationType":"ETHERNET_VIRTUALIZER","requestedVni":12001,"vni":12001,"networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e","networkSecurityGroupPropagationDetails":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","detailedStatus":"Partial","status":"Synchronizing","details":"","unpropagatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"relatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"]},"nvLinkLogicalPartitionId":"dd887330-dbd3-45ce-b400-c42fc8e47315","labels":{"region":"us-west-1","env":"dev"},"status":"Ready","statusHistory":[{"status":"Ready","message":"Vpc has been successfully provisioned on Site","created":"2019-08-24T16:02:00Z","updated":"2019-08-24T16:02:00Z"},{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-vpc","description":"Retrieve all VPCs for the org.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter VPCs by Site ID. Can be specified multiple times to filter on more than one Site."},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter VPCs by Status. Can be specified multiple times to filter on more than one Status."},{"schema":{"type":"string"},"in":"query","name":"networkSecurityGroupId","description":"Filter VPCs by Network Security Group ID. Can be specified multiple times to filter on more than one Network Security Group."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"nvLinkLogicalPartitionId","description":"Filter VPCs by NVLink Logical Partition ID. Can be specified multiple times to filter on more than one NVLink Logical Partition."},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all VPCs. Input will be matched against name, description, labels and status fields"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site","NetworkSecurityGroup"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create VPC","operationId":"create-vpc","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VPC"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-vpc","description":"Virtual network for machines executing Spark jobs","org":"xskkpgqpeakn","tenantId":"34f5c98e-f430-457b-a812-92637d0c6fd0","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","controllerVpcId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","networkVirtualizationType":"ETHERNET_VIRTUALIZER","requestedVni":12001,"vni":12001,"nvLinkLogicalPartitionId":"dd887330-dbd3-45ce-b400-c42fc8e47315","labels":{"region":"us-west-1","env":"dev"},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create a VPC for the org.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcCreateRequest"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-vpc","description":"Virtual network for machines executing Spark jobs","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","networkVirtualizationType":"ETHERNET_VIRTUALIZER","vni":12001,"nvLinkLogicalPartitionId":"dd887330-dbd3-45ce-b400-c42fc8e47315","labels":{"region":"us-west-1","env":"dev"}}}}}},"description":""},"tags":["VPC"]}},"/v2/org/{org}/nico/vpc/{vpcId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"vpcId","in":"path","required":true,"description":"ID of the VPC"}],"get":{"summary":"Retrieve a VPC","tags":["VPC"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VPC"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-vpc","description":"Virtual network for machines executing Spark jobs","org":"xskkpgqpeakn","tenantId":"34f5c98e-f430-457b-a812-92637d0c6fd0","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","controllerVpcId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","networkVirtualizationType":"ETHERNET_VIRTUALIZER","requestedVni":12001,"vni":12001,"nvLinkLogicalPartitionId":"dd887330-dbd3-45ce-b400-c42fc8e47315","labels":{"region":"us-west-1","env":"dev"},"status":"Ready","networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e,","networkSecurityGroupPropagationDetails":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","detailedStatus":"Partial","status":"Synchronizing","details":"","unpropagatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"relatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"]},"statusHistory":[{"status":"Ready","message":"Vpc has been successfully provisioned on Site","created":"2019-08-24T16:02:00Z","updated":"2019-08-24T16:02:00Z"},{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-vpc","description":"Retrieve a specific VPC by ID.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site","NetworkSecurityGroup"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"delete":{"summary":"Delete a VPC","operationId":"delete-vpc","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a specific VPC by ID.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["VPC"]},"patch":{"summary":"Update VPC","operationId":"update-vpc","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VPC"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-vpc-v1","description":"Virtual network for machines executing Spark jobs v1","org":"xskkpgqpeakn","tenantId":"34f5c98e-f430-457b-a812-92637d0c6fd0","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","controllerVpcId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","networkVirtualizationType":"ETHERNET_VIRTUALIZER","requestedVni":12001,"vni":12001,"nvLinkLogicalPartitionId":"dd887330-dbd3-45ce-b400-c42fc8e47315","labels":{"region":"us-west-1","env":"dev"},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["VPC"],"description":"Update an existing VPC\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcUpdateRequest"},"examples":{"example-1":{"value":{"name":"spark-vpc-v1","description":"Virtual network for machines executing Spark jobs v1","labels":{"region":"us-west-1","env":"dev"}}}}}}}}},"/v2/org/{org}/nico/vpc/{vpcId}/virtualization":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"vpcId","in":"path","required":true,"description":"ID of the VPC"}],"patch":{"summary":"Update VPC Virtualization","operationId":"update-vpc-virtualization","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VPC"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-vpc-v1","description":"Virtual network for machines executing Spark jobs v1","org":"xskkpgqpeakn","tenantId":"34f5c98e-f430-457b-a812-92637d0c6fd0","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","controllerVpcId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","networkVirtualizationType":"FNN","requestedVni":12001,"vni":12001,"nvLinkLogicalPartitionId":"dd887330-dbd3-45ce-b400-c42fc8e47315","labels":{"region":"us-west-1","env":"dev"},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["VPC"],"description":"Update network virtualization type for a VPC\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix\n\nTenant must own the VPC\nRequest is rejected if the VPC already has Subnets or Instances","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcVirtualizationUpdateRequest"},"examples":{"Example 1":{"value":{"networkVirtualizationType":"FNN"}}}}}}}},"/v2/org/{org}/nico/vpc-peering":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all VPC peerings","tags":["VPC Peering"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VpcPeering"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-vpc-peering","description":"Get all VPC peerings.\nTenant Admin can get all peerings where the tenant owns at least one VPC.\nProvider Admin can get all peerings in a site.\nUser must have authorization role with `TENANT_ADMIN` or `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","required":false,"description":"Optional Site ID filter. If provided, caller must have access to the specified Site."},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string"},"in":"query","name":"orderBy","description":"Ordering for pagination query"},{"schema":{"type":"boolean"},"in":"query","name":"isMultiTenant","required":false,"description":"Optional filter by peering tenancy type (single-tenant or multi-tenant)."},{"schema":{"type":"string","enum":["Vpc1","Vpc2","Site"]},"in":"query","name":"includeRelation","required":false,"description":"Related entity to expand"}]},"post":{"summary":"Create VPC peering","tags":["VPC Peering"],"operationId":"create-vpc-peering","description":"Create a VPC peering between two VPCs on the same site.\n\nTenant Admin can create single-tenant peerings (both VPCs belong to their tenant).\nProvider Admin can create multi-tenant peerings (VPCs from different tenants).\n\nUser must have authorization role with `TENANT_ADMIN` or `PROVIDER_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcPeeringCreateRequest"},"examples":{"example-1":{"value":{"vpc1Id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","vpc2Id":"34f5c98e-f430-457b-a812-92637d0c6fd0","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811"}}}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcPeering"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}}}},"/v2/org/{org}/nico/vpc-peering/{id}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"VPC Peering ID"}],"get":{"summary":"Retrieve a VPC peering","tags":["VPC Peering"],"operationId":"get-vpc-peering","description":"Get details of a VPC peering by ID.\n\nTenant Admin can get a peering if at least one VPC belongs to their tenant.\nProvider Admin can get a peering if it is in a site provided by their org.\n\nUser must have authorization role with `TENANT_ADMIN` or `PROVIDER_ADMIN` suffix.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcPeering"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"parameters":[{"schema":{"type":"string","enum":["Vpc1","Vpc2","Site"]},"in":"query","name":"includeRelation","required":false,"description":"Related entity to expand"}]},"delete":{"summary":"Delete a VPC peering","tags":["VPC Peering"],"operationId":"delete-vpc-peering","description":"Delete a VPC peering by ID.\n\nTenant Admin can delete only peerings where both VPCs belong to their tenant.\nProvider Admin can delete only multi-tenant peerings in sites they provide.\n\nUser must have authorization role with `TENANT_ADMIN` or `PROVIDER_ADMIN` suffix.","responses":{"204":{"description":"No Content"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}}}},"/v2/org/{org}/nico/vpc-prefix":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all VPC Prefixes","tags":["VPC Prefix"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VpcPrefix"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-vpc-prefix","description":"Retrieve all VPC Prefixes for the org\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter VPC Prefixes by Site, required if vpcId query param is not specified"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"vpcId","description":"Filter VPC Prefixes by VPC"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter VPC Prefixes by Status"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name and status fields"},{"schema":{"type":"string","enum":["VPC","Tenant","IPBlock"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create VPC Prefix","operationId":"create-vpc-prefix","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcPrefix"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create a VPC Prefix for the org.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcPrefixCreateRequest"}}}},"tags":["VPC Prefix"]}},"/v2/org/{org}/nico/vpc-prefix/{vpcPrefixId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"vpcPrefixId","in":"path","required":true,"description":"ID of the VPC Prefix"}],"get":{"summary":"Retrieve VPC Prefix","tags":["VPC Prefix"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcPrefix"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-vpc-prefix","description":"Retrieve a specific VPC Prefix\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","enum":["VPC","Tenant","IPBlock"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"delete":{"summary":"Delete VPC Prefix","operationId":"delete-vpc-prefix","responses":{"204":{"description":"No Content"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a specific VPC Prefix by ID.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["VPC Prefix"]},"patch":{"summary":"Update VPC Prefix","operationId":"update-vpc-prefix","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcPrefix"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["VPC Prefix"],"description":"Update an existing VPC Prefix\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcPrefixUpdateRequest"}}}}}},"/v2/org/{org}/nico/subnet":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Subnets","tags":["Subnet"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Subnet"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-gpu-net","siteId":"ea144def-d68f-44c3-9485-4b103fa2686f","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerNetworkSegmentId":"abe7b0e8-67db-4e89-903e-fc4f2bd7f034","ipv4Prefix":"202.168.16.0","ipv4BlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","ipv4Gateway":"202.168.0.1","ipv6Prefix":null,"ipv6BlockId":null,"ipv6Gateway":null,"prefixLength":20,"routingType":"Public","status":"Ready","statusHistory":[{"status":"Ready","message":"Subnet has been successfully provisioned on Site","created":"2019-08-24T16:02:38Z","updated":"2019-08-24T16:02:38Z"},{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-subnet","description":"Retrieve all Subnets for the org\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter subnets by Site, required if vpcId query param is not specified"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"vpcId","description":"Filter subnets by VPC"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Subnets by Status"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description and status fields"},{"schema":{"type":"string","enum":["VPC","Tenant","IPv4Block","IPv6Block"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create Subnet","operationId":"create-subnet","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subnet"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-gpu-net","siteId":"ea144def-d68f-44c3-9485-4b103fa2686f","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerNetworkSegmentId":null,"ipv4Prefix":"202.168.16.0","ipv4BlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","ipv4Gateway":"202.168.0.1","ipv6Prefix":null,"ipv6BlockId":null,"ipv6Gateway":null,"prefixLength":20,"routingType":"Public","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create a Subnet for the org.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n\nAt least 1 IPv4 IP block or 1 IPv6 IP block must be specified.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubnetCreateRequest"},"examples":{"Example 1":{"value":{"name":"spark-gpu-net","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","ipv4BlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","prefixLength":20}}}}}},"tags":["Subnet"]}},"/v2/org/{org}/nico/subnet/{subnetId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"subnetId","in":"path","required":true,"description":"ID of the Subnet"}],"get":{"summary":"Retrieve Subnet","tags":["Subnet"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subnet"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-gpu-net","siteId":"ea144def-d68f-44c3-9485-4b103fa2686f","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerNetworkSegmentId":"abe7b0e8-67db-4e89-903e-fc4f2bd7f034","ipv4Prefix":"202.168.16.0","ipv4BlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","ipv4Gateway":"202.168.0.1","ipv6Prefix":null,"ipv6BlockId":null,"ipv6Gateway":null,"prefixLength":20,"routingType":"Public","status":"Ready","statusHistory":[{"status":"Ready","message":"Subnet has been successfully provisioned on Site","created":"2019-08-24T16:02:38Z","updated":"2019-08-24T16:02:38Z"},{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-subnet","description":"Retrieve a specific Subnet\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","enum":["VPC","Tenant","IPv4Block","IPv6Block"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"delete":{"summary":"Delete Subnet","operationId":"delete-subnet","responses":{"204":{"description":"No Content"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a specific Subnet by ID.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["Subnet"]},"patch":{"summary":"Update Subnet","operationId":"update-subnet","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subnet"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-gpu-subnet","description":"Subnet for dedicated GPU nodes","siteId":"ea144def-d68f-44c3-9485-4b103fa2686f","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerNetworkSegmentId":null,"ipv4Prefix":"212.168.0.250","ipv4BlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","ipv4Gateway":"202.168.0.1","ipv6Prefix":null,"ipv6BlockId":null,"ipv6Gateway":null,"prefixLength":20,"routingType":"Public","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Subnet"],"description":"Update an existing Subnet\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubnetUpdateRequest"},"examples":{"example-1":{"value":{"name":"spark-gpu-subnet","description":"Subnet for dedicated GPU nodes"}}}}}}}},"/v2/org/{org}/nico/expected-machine":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create Expected Machine","operationId":"create-expected-machine","description":"Create an Expected Machine to pre-register Machines expected to be discovered at a Site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also create Expected Machines if they have an account with the Site's Infrastructure Provider.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedMachineCreateRequest"},"examples":{"example-1":{"value":{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","defaultBmcUsername":"admin","defaultBmcPassword":"password123","chassisSerialNumber":"CHASSIS-12345","fallbackDPUSerialNumbers":["DPU-001","DPU-002"],"labels":{"environment":"production","rack":"A1"}}}}}},"description":"Expected Machine creation request","required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedMachine"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Machine"]},"get":{"summary":"Retrieve all Expected Machines","operationId":"get-all-expected-machine","description":"Retrieve all Expected Machines.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Machines if they have an account with the Site's Infrastructure Provider (siteId query parameter is required for Tenants).","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","description":"ID of the Site to filter Expected Machines by"},{"schema":{"type":"string","enum":["Site","Sku"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["BMC_MAC_ADDRESS_ASC","BMC_MAC_ADDRESS_DESC","CHASSIS_SERIAL_NUMBER_ASC","CHASSIS_SERIAL_NUMBER_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExpectedMachine"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Machine"]}},"/v2/org/{org}/nico/expected-machine/{expectedMachineId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"expectedMachineId","in":"path","required":true,"description":"ID of the Expected Machine"}],"get":{"summary":"Retrieve Expected Machine","operationId":"get-expected-machine","description":"Retrieve a specific Expected Machine by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Machines if they have an account with the Site's Infrastructure Provider.","parameters":[{"schema":{"type":"string","enum":["Site","Sku"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedMachine"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Machine"]},"patch":{"summary":"Update Expected Machine","operationId":"update-expected-machine","description":"Update an existing Expected Machine by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nInfrastructure Provider must own the Expected Machine.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also update Expected Machines if they have an account with the Site's Infrastructure Provider.","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedMachineUpdateRequest"},"examples":{"example-1":{"value":{"defaultBmcUsername":"newadmin","defaultBmcPassword":"newpassword123","chassisSerialNumber":"CHASSIS-54321","labels":{"environment":"staging","rack":"B2"}}}}}},"description":"Expected Machine update request","required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedMachine"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Machine"]},"delete":{"summary":"Delete Expected Machine","operationId":"delete-expected-machine","description":"Delete an existing Expected Machine by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nInfrastructure Provider must own the Expected Machine.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also delete Expected Machines if they have an account with the Site's Infrastructure Provider.","parameters":[],"responses":{"204":{"description":"ExpectedMachine deleted successfully"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Machine"]}},"/v2/org/{org}/nico/expected-machine/batch":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Batch Create Expected Machines","operationId":"batch-create-expected-machines","description":"Create multiple Expected Machines in a single request. All machines must belong to the same site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also create Expected Machines if they have an account with the Site's Infrastructure Provider.\n\nMaximum batch size: 100 Expected Machines per request.","requestBody":{"content":{"application/json":{"schema":{"type":"array","minItems":1,"maxItems":100,"items":{"$ref":"#/components/schemas/ExpectedMachineCreateRequest"}},"examples":{"example-1":{"value":[{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","defaultBmcUsername":"admin","defaultBmcPassword":"password123","chassisSerialNumber":"CHASSIS-12345","fallbackDPUSerialNumbers":["DPU-001","DPU-002"],"labels":{"environment":"production","rack":"A1"}},{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5F","defaultBmcUsername":"admin","defaultBmcPassword":"password456","chassisSerialNumber":"CHASSIS-12346","fallbackDPUSerialNumbers":["DPU-003","DPU-004"],"labels":{"environment":"production","rack":"A2"}}]}}}},"description":"Array of Expected Machine creation requests","required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExpectedMachine"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Machine"]},"patch":{"summary":"Batch Update Expected Machines","operationId":"batch-update-expected-machines","description":"Update multiple Expected Machines in a single request. All machines must belong to the same site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nInfrastructure Provider must own the Expected Machines.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also update Expected Machines if they have an account with the Site's Infrastructure Provider.\n\nMaximum batch size: 100 Expected Machines per request.","requestBody":{"content":{"application/json":{"schema":{"type":"array","minItems":1,"maxItems":100,"items":{"$ref":"#/components/schemas/ExpectedMachineUpdateRequest"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","defaultBmcUsername":"newadmin","defaultBmcPassword":"newpassword123","chassisSerialNumber":"CHASSIS-54321","labels":{"environment":"staging","rack":"B2"}},{"id":"597f6eca-6276-4993-bfeb-53cbbbba6f09","defaultBmcUsername":"newadmin2","defaultBmcPassword":"newpassword456","chassisSerialNumber":"CHASSIS-54322","labels":{"environment":"staging","rack":"B3"}}]}}}},"description":"Array of Expected Machine update requests","required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExpectedMachine"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"description":"One or more Expected Machines not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"}}}}},"tags":["Expected Machine"]}},"/v2/org/{org}/nico/expected-power-shelf":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create Expected Power Shelf","operationId":"create-expected-power-shelf","description":"Create an Expected Power Shelf to pre-register power shelves expected to be discovered at a Site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also create Expected Power Shelves if they have an account with the Site's Infrastructure Provider.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedPowerShelfCreateRequest"},"examples":{"example-1":{"value":{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","defaultBmcUsername":"admin","defaultBmcPassword":"password123","shelfSerialNumber":"SHELF-12345","bmcIpAddress":"192.168.1.100","labels":{"environment":"production","rack":"A1"}}}}}},"description":"Expected Power Shelf creation request","required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedPowerShelf"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Power Shelf"]},"get":{"summary":"Retrieve all Expected Power Shelves","operationId":"get-all-expected-power-shelf","description":"Retrieve all Expected Power Shelves.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Power Shelves if they have an account with the Site's Infrastructure Provider (siteId query parameter is required for Tenants).","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","description":"ID of the Site to filter Expected Power Shelves by"},{"schema":{"type":"string","enum":["Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["BMC_MAC_ADDRESS_ASC","BMC_MAC_ADDRESS_DESC","SHELF_SERIAL_NUMBER_ASC","SHELF_SERIAL_NUMBER_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExpectedPowerShelf"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Power Shelf"]}},"/v2/org/{org}/nico/expected-power-shelf/{expectedPowerShelfId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"expectedPowerShelfId","in":"path","required":true,"description":"ID of the Expected Power Shelf"}],"get":{"summary":"Retrieve Expected Power Shelf","operationId":"get-expected-power-shelf","description":"Retrieve a specific Expected Power Shelf by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Power Shelves if they have an account with the Site's Infrastructure Provider.","parameters":[{"schema":{"type":"string","enum":["Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedPowerShelf"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Power Shelf"]},"patch":{"summary":"Update Expected Power Shelf","operationId":"update-expected-power-shelf","description":"Update an existing Expected Power Shelf by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nInfrastructure Provider must own the Expected Power Shelf.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also update Expected Power Shelves if they have an account with the Site's Infrastructure Provider.","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedPowerShelfUpdateRequest"},"examples":{"example-1":{"value":{"defaultBmcUsername":"newadmin","defaultBmcPassword":"newpassword123","shelfSerialNumber":"SHELF-54321","bmcIpAddress":"192.168.1.200","labels":{"environment":"staging","rack":"B2"}}}}}},"description":"Expected Power Shelf update request","required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedPowerShelf"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Power Shelf"]},"delete":{"summary":"Delete Expected Power Shelf","operationId":"delete-expected-power-shelf","description":"Delete an existing Expected Power Shelf by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nInfrastructure Provider must own the Expected Power Shelf.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also delete Expected Power Shelves if they have an account with the Site's Infrastructure Provider.","parameters":[],"responses":{"204":{"description":"Expected Power Shelf deleted successfully"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Power Shelf"]}},"/v2/org/{org}/nico/expected-rack":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create Expected Rack","operationId":"create-expected-rack","description":"Create an Expected Rack to pre-register a rack expected to be discovered at a Site. The `rackId` is an operator-supplied string identifier (not a UUID) that uniquely identifies the rack within the Site.\n\nOrg must have an Infrastructure Provider entity. User must have `FORGE_PROVIDER_ADMIN` role.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also create Expected Racks if they have an account with the Site's Infrastructure Provider.\n\nChassis identity and physical location information are conveyed via well-known label keys in `labels`:\n- `chassis.manufacturer`, `chassis.serial-number`, `chassis.model`\n- `location.region`, `location.datacenter`, `location.room`, `location.position`","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedRackCreateRequest"},"examples":{"example-1":{"value":{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","rackId":"rack-01","rackProfileId":"rp-standard-42u","name":"Rack 01","description":"Production rack in row A","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001001","chassis.model":"GB200-NVL72","location.region":"us-west-2","location.datacenter":"phx-dc01","location.room":"room-1","location.position":"A1"}}}}}},"description":"Expected Rack creation request","required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedRack"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Rack"]},"get":{"summary":"Retrieve all Expected Racks","operationId":"get-all-expected-rack","description":"Retrieve all Expected Racks.\n\nOrg must have an Infrastructure Provider entity. User must have `FORGE_PROVIDER_ADMIN` or `FORGE_PROVIDER_VIEWER` role.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Racks if they have an account with the Site's Infrastructure Provider (siteId query parameter is required for Tenants).","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","description":"ID of the Site to filter Expected Racks by"},{"schema":{"type":"string","enum":["Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["RACK_ID_ASC","RACK_ID_DESC","RACK_PROFILE_ID_ASC","RACK_PROFILE_ID_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExpectedRack"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Rack"]},"put":{"summary":"Replace all Expected Racks","operationId":"replace-all-expected-rack","description":"Replace the full set of Expected Racks for a Site with the provided list. All existing Expected Racks for the Site that are not in the request body will be deleted, and any new Expected Racks in the request will be created. Existing Expected Racks with matching `rackId` values will be updated.\n\nEvery entry in `expectedRacks` must reference the same `siteId` as the top-level `siteId`. `rackId` values must be unique within the request. The `expectedRacks` array may be empty to clear all Expected Racks for the Site.\n\nOrg must have an Infrastructure Provider entity. User must have `FORGE_PROVIDER_ADMIN` role.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also replace Expected Racks if they have an account with the Site's Infrastructure Provider.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedRackList"},"examples":{"example-1":{"value":{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","expectedRacks":[{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","rackId":"rack-01","rackProfileId":"rp-standard-42u","name":"Rack 01","description":"Production rack in row A","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001001","chassis.model":"GB200-NVL72","location.datacenter":"phx-dc01","location.position":"A1"}},{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","rackId":"rack-02","rackProfileId":"rp-standard-42u","name":"Rack 02","description":"Production rack in row A","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001002","chassis.model":"GB200-NVL72","location.datacenter":"phx-dc01","location.position":"A2"}}]}}}}},"description":"Replace-all Expected Racks request","required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExpectedRack"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Rack"]}},"/v2/org/{org}/nico/expected-rack/all":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"delete":{"summary":"Delete all Expected Racks","operationId":"delete-all-expected-rack","description":"Delete all Expected Racks for a Site.\n\nOrg must have an Infrastructure Provider entity. User must have `FORGE_PROVIDER_ADMIN` role.\n\nInfrastructure Provider must own the Expected Racks.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also delete Expected Racks if they have an account with the Site's Infrastructure Provider.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site whose Expected Racks should be deleted"}],"responses":{"204":{"description":"All Expected Racks deleted successfully"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Rack"]}},"/v2/org/{org}/nico/expected-rack/{id}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Expected Rack"}],"get":{"summary":"Retrieve Expected Rack","operationId":"get-expected-rack","description":"Retrieve a specific Expected Rack by its `id`.\n\nOrg must have an Infrastructure Provider entity. User must have `FORGE_PROVIDER_ADMIN` or `FORGE_PROVIDER_VIEWER` role.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Racks if they have an account with the Site's Infrastructure Provider.","parameters":[{"schema":{"type":"string","enum":["Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedRack"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Rack"]},"patch":{"summary":"Update Expected Rack","operationId":"update-expected-rack","description":"Update an existing Expected Rack identified by its `id`.\n\nOrg must have an Infrastructure Provider entity. User must have `FORGE_PROVIDER_ADMIN` role.\n\nInfrastructure Provider must own the Expected Rack.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also update Expected Racks if they have an account with the Site's Infrastructure Provider.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedRackUpdateRequest"},"examples":{"example-1":{"value":{"rackProfileId":"rp-standard-48u","name":"Rack 01 (updated)","description":"Production rack in row A, upgraded chassis","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001001","chassis.model":"GB200-NVL72","location.datacenter":"phx-dc01","location.position":"A1"}}}}}},"description":"Expected Rack update request","required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedRack"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Rack"]},"delete":{"summary":"Delete Expected Rack","operationId":"delete-expected-rack","description":"Delete an existing Expected Rack identified by its `id`.\n\nOrg must have an Infrastructure Provider entity. User must have `FORGE_PROVIDER_ADMIN` role.\n\nInfrastructure Provider must own the Expected Rack.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also delete Expected Racks if they have an account with the Site's Infrastructure Provider.","responses":{"204":{"description":"Expected Rack deleted successfully"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Rack"]}},"/v2/org/{org}/nico/expected-switch":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create Expected Switch","operationId":"create-expected-switch","description":"Create an Expected Switch to pre-register network switches expected to be discovered at a Site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also create Expected Switches if they have an account with the Site's Infrastructure Provider.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedSwitchCreateRequest"},"examples":{"example-1":{"value":{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","defaultBmcUsername":"admin","defaultBmcPassword":"password123","switchSerialNumber":"SWITCH-12345","nvOsUsername":"nvadmin","nvOsPassword":"nvpassword123","labels":{"environment":"production","rack":"A1"}}}}}},"description":"Expected Switch creation request","required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedSwitch"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Switch"]},"get":{"summary":"Retrieve all Expected Switches","operationId":"get-all-expected-switch","description":"Retrieve all Expected Switches.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Switches if they have an account with the Site's Infrastructure Provider (siteId query parameter is required for Tenants).","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","description":"ID of the Site to filter Expected Switches by"},{"schema":{"type":"string","enum":["Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["BMC_MAC_ADDRESS_ASC","BMC_MAC_ADDRESS_DESC","SWITCH_SERIAL_NUMBER_ASC","SWITCH_SERIAL_NUMBER_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExpectedSwitch"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Switch"]}},"/v2/org/{org}/nico/expected-switch/{expectedSwitchId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"expectedSwitchId","in":"path","required":true,"description":"ID of the Expected Switch"}],"get":{"summary":"Retrieve Expected Switch","operationId":"get-expected-switch","description":"Retrieve a specific Expected Switch by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Switches if they have an account with the Site's Infrastructure Provider.","parameters":[{"schema":{"type":"string","enum":["Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedSwitch"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Switch"]},"patch":{"summary":"Update Expected Switch","operationId":"update-expected-switch","description":"Update an existing Expected Switch by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nInfrastructure Provider must own the Expected Switch.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also update Expected Switches if they have an account with the Site's Infrastructure Provider.","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedSwitchUpdateRequest"},"examples":{"example-1":{"value":{"defaultBmcUsername":"newadmin","defaultBmcPassword":"newpassword123","switchSerialNumber":"SWITCH-54321","nvOsUsername":"newnvadmin","nvOsPassword":"newnvpassword123","labels":{"environment":"staging","rack":"B2"}}}}}},"description":"Expected Switch update request","required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedSwitch"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Switch"]},"delete":{"summary":"Delete Expected Switch","operationId":"delete-expected-switch","description":"Delete an existing Expected Switch by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nInfrastructure Provider must own the Expected Switch.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also delete Expected Switches if they have an account with the Site's Infrastructure Provider.","parameters":[],"responses":{"204":{"description":"Expected Switch deleted successfully"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Switch"]}},"/v2/org/{org}/nico/sku":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all SKUs","operationId":"get-all-sku","description":"Retrieve all SKUs (Stock Keeping Units) for the Infrastructure Provider or privileged Tenant.\n\nSKUs represent unique hardware configurations discovered at sites. They are automatically derived from machine characteristics.\n\nA `siteId` query parameter is required for all requests.\n\nFor Infrastructure Providers: Org must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled. User must have authorization role with `TENANT_ADMIN` suffix. The Tenant must have an account with the Site's Infrastructure Provider.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site to retrieve SKUs from"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC","ID_ASC","ID_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Sku"}},"examples":{"example-1":{"value":[{"id":"lenovo.sr650v2.cpu.1","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","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"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["SKU"]}},"/v2/org/{org}/nico/sku/{skuId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"skuId","in":"path","required":true,"description":"ID of the SKU"}],"get":{"summary":"Retrieve SKU","operationId":"get-sku","description":"Retrieve a specific SKU (Stock Keeping Unit) by ID.\n\nSKUs represent unique hardware configurations discovered at sites. They are automatically derived from machine characteristics.\n\nFor Infrastructure Providers: Org must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled. User must have authorization role with `TENANT_ADMIN` suffix. The Tenant must have an account with the SKU's Site's Infrastructure Provider.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sku"},"examples":{"example-1":{"value":{"id":"lenovo.sr650v2.cpu.1","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","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"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["SKU"]}},"/v2/org/{org}/nico/infiniband-partition":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all InfiniBand Partitions","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InfiniBandPartition"}},"examples":{"Example 1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"turbo-net","description":"InfiniBand Partition for model training Instances","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerIBPartitionId":"0e60d064-3d38-4812-84d9-c3353bd96eaf","partitionKey":"0x1","partitionName":"turbo-net","serviceLevel":5,"rateLimit":40,"mtu":4000,"enableSharp":true,"labels":{"environment":"production","team":"devops"},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-infiniband-partition","description":"Retrieve all InfiniBand Partitions for the org\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter Partitions by Site"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Partitions by Status"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description and status fields"},{"schema":{"type":"string","enum":["Site","VPC","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"tags":["InfiniBand Partition"]},"post":{"summary":"Create InfiniBand Partition","operationId":"create-infiniband-partition","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfiniBandPartition"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"turbo-net","description":"InfiniBand Partition for model training Instances","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerIBPartitionId":"0e60d064-3d38-4812-84d9-c3353bd96eaf","partitionKey":"0x1","partitionName":"turbo-net","serviceLevel":5,"rateLimit":40,"mtu":4000,"enableSharp":true,"labels":{"environment":"production","team":"devops"},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an InfiniBand Partition for the org.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfiniBandPartitionCreateRequest"},"examples":{"Example 1":{"value":{"name":"turbo-net","siteId":"69dae3c8-3554-4a1f-b391-858c6dc47fff","labels":{"environment":"production","team":"devops"}}}}}}},"tags":["InfiniBand Partition"]}},"/v2/org/{org}/nico/infiniband-partition/{infiniBandPartitionId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"infiniBandPartitionId","in":"path","required":true,"description":"ID of the InfiniBand Partition"}],"get":{"summary":"Retrieve InfiniBand Partition","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfiniBandPartition"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"turbo-net","description":"InfiniBand Partition for model training Instances","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerIBPartitionId":"0e60d064-3d38-4812-84d9-c3353bd96eaf","partitionKey":"0x1","partitionName":"turbo-net","serviceLevel":5,"rateLimit":40,"mtu":4000,"enableSharp":true,"labels":{"environment":"production","team":"devops"},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-infiniband-partition","description":"Retrieve a specific InfiniBand Partition\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n\nTenant must own the Partition.","parameters":[{"schema":{"type":"string","enum":["Site","VPC","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}],"tags":["InfiniBand Partition"]},"delete":{"summary":"Delete InfiniBand Partition","operationId":"delete-infiniband-partition","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a specific InfiniBand Partition by ID.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n\nTenant must own the Partition.","tags":["InfiniBand Partition"]},"patch":{"summary":"Update InfiniBand Partition","operationId":"update-infiniband-partition","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfiniBandPartition"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"turbo-net-v2","description":"Second version of the model training network","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerIBPartitionId":"0e60d064-3d38-4812-84d9-c3353bd96eaf","partitionKey":"0x1","partitionName":"turbo-net","serviceLevel":5,"rateLimit":40,"mtu":4000,"enableSharp":true,"labels":{"environment":"production","team":"devops"},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Update an existing InfiniBand Partition\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n\nTenant must own the Partition.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfiniBandPartitionUpdateRequest"},"examples":{"Example 1":{"value":{"name":"turbo-net-v2","description":"Second version of the model training network","labels":{"environment":"production","team":"devops"}}}}}}},"tags":["InfiniBand Partition"]}},"/v2/org/{org}/nico/nvlink-logical-partition":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the NGC Org"}],"get":{"summary":"Retrieve all NVLink Logical Partitions","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NVLinkLogicalPartition"}},"examples":{"Example 1":{"value":[{"id":"ded96bdf-905e-40dd-8a58-3472aab60042","name":"partition-east-gpu","description":"NVLink Logical Partition for model training Instances","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-nvlink-logical-partition","description":"Retrieve all NVLink Logical Partitions for the org\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter NVLink Logical Partitions by Site"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter NVLink Logical Partitions by Status"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description and status fields"},{"schema":{"type":"boolean"},"in":"query","name":"includeInterfaces","description":"Include NVLink Interfaces in response."},{"schema":{"type":"boolean"},"in":"query","name":"includeStats","description":"Include NVLink Logical Partition Stats in response."},{"schema":{"type":"boolean"},"in":"query","name":"includeVpcs","description":"Include VPCs in response."},{"schema":{"type":"string","enum":["Site","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"tags":["NVLink Logical Partition"]},"post":{"summary":"Create NVLink Logical Partition","operationId":"create-nvlink-logical-partition","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NVLinkLogicalPartition"},"examples":{"Example 1":{"value":{"id":"ded96bdf-905e-40dd-8a58-3472aab60042","name":"partition-east-gpu","description":"NVLink Logical Partition for model training Instances","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an NVLink Logical Partition for the org.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NVLinkLogicalPartitionCreateRequest"},"examples":{"Example 1":{"value":{"name":"partition-east-gpu","siteId":"69dae3c8-3554-4a1f-b391-858c6dc47fff"}}}}}},"tags":["NVLink Logical Partition"]}},"/v2/org/{org}/nico/nvlink-logical-partition/{nvLinkLogicalPartitionId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the NGC Org"},{"schema":{"type":"string"},"name":"nvLinkLogicalPartitionId","in":"path","required":true,"description":"ID of the NVLink Logical Partition"}],"get":{"summary":"Retrieve NVLink Logical Partition","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NVLinkLogicalPartition"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-nvlink-logical-partition","description":"Retrieve a specific NVLink Logical Partition by ID\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["NVLink Logical Partition"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"includeInterfaces","description":"Include all attached NVLink Interfaces in response"},{"schema":{"type":"boolean"},"in":"query","name":"includeStats","description":"Include NVLink Logical Partition Stats in response"},{"schema":{"type":"boolean"},"in":"query","name":"includeVpcs","description":"Include all attached VPCs in response"},{"schema":{"type":"string","enum":["Site","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"patch":{"summary":"Update NVLink Logical Partition","operationId":"update-nvlink-logical-partition","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NVLinkLogicalPartition"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Update a specific NVLink Logical Partition\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NVLinkLogicalPartitionUpdateRequest"}}}},"tags":["NVLink Logical Partition"]},"delete":{"summary":"Delete NVLink Logical Partition","operationId":"delete-nvlink-logical-partition","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete an NVLink Logical Partition by ID\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["NVLink Logical Partition"]}},"/v2/org/{org}/nico/instance/type":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Instance Types","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InstanceType"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"x3.large","description":"Part of X family, the X3 Large features increased compute power","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"queryParam":"includeMachineAssociation","replacedBy":"includeMachineAssignment","takeActionBy":"2023-07-26T00:00:00Z","notice":"'includeMachineAssociation' has been deprecated in favor of 'includeMachineAssignment'. Please take action immediately."},{"attribute":"displayName","takeActionBy":"2024-10-30T00:00:00Z","notice":"'displayName' has been deprecated. Please take action immediately."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]},"example-2":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"ib.general","description":"General Purpose InfiniBand Instances","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","machineCapabilities":[{"type":"InfiniBand","name":"Mellanox Technologies MT28908 Family [ConnectX-6]","vendor":"Mellanox Technologies","count":2}],"machineInstanceTypes":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"queryParam":"includeMachineAssociation","replacedBy":"includeMachineAssignment","takeActionBy":"2023-07-26T00:00:00Z","notice":"'includeMachineAssociation' has been deprecated in favor of 'includeMachineAssignment'. Please take action immediately."},{"attribute":"displayName","takeActionBy":"2024-10-30T00:00:00Z","notice":"'displayName' has been deprecated. Please take action immediately."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]},"example-3":{"value":[{"id":"0327339b-f3b7-4de3-9468-7dc29f9f6914","name":"ib.multi-dpu","description":"Multi DPU Instances","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","machineCapabilities":[{"type":"Network","name":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","vendor":"Mellanox Technologies","count":2,"deviceType":"DPU"}],"machineInstanceTypes":[{"id":"0327339b-f3b7-4de3-9468-7dc29f9f6914","machineId":"fm100dsg23d2f4tq4tt5m2hgib5pcldrm3gvefbduau7gj3itgc3iqg3lpg","instanceTypeId":"771b066a-f2ff-4550-a65d-baef8551167d","created":"2025-05-24T14:15:22Z","updated":"2025-05-24T14:15:22Z"}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2025-05-24T14:15:22Z","updated":"2025-05-24T14:15:22Z"}],"deprecations":[{"queryParam":"includeMachineAssociation","replacedBy":"includeMachineAssignment","takeActionBy":"2023-07-26T00:00:00Z","notice":"'includeMachineAssociation' has been deprecated in favor of 'includeMachineAssignment'. Please take action immediately."},{"attribute":"displayName","takeActionBy":"2024-10-30T00:00:00Z","notice":"'displayName' has been deprecated. Please take action immediately."}],"created":"2025-05-24T14:15:22Z","updated":"2025-05-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-instance-type","description":"Get all Instance Types for the org.\n\nProvider and Tenant roles are inferred from the org's membership. User must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix.\n\nResults are returned from both Provider and Tenant perspectives when the org has both roles.\n","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter Instance Types by Site ID"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","deprecated":true,"description":"Filter Instance Types by Infrastructure Provider ID."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","deprecated":true,"description":"Filter Instance Types by Tenant ID."},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Instance Types by Status"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, display name, description, labels and status fields"},{"schema":{"type":"string","enum":["InfrastructureProvider","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"boolean"},"in":"query","name":"includeMachineAssignment","description":"Include Machine assignments for each Instance Type. Can only be requested by Provider."},{"schema":{"type":"boolean"},"in":"query","name":"includeAllocationStats","description":"Include Allocation stats."},{"schema":{"type":"boolean"},"in":"query","name":"excludeUnallocated","description":"Excludes InstanceType records that have no allocations from being returned in the result set. Currently can only be requested by Tenant."},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"tags":["Instance Type"]},"post":{"summary":"Create an Instance Type","operationId":"create-instance-type","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstanceType"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"x3.large","description":"Part of X family, the X3 Large features increased compute power","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","labels":{"region":"portland","env":"staging"},"machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"queryParam":"includeMachineAssociation","replacedBy":"includeMachineAssignment","takeActionBy":"2023-07-26T00:00:00Z","notice":"'includeMachineAssociation' has been deprecated in favor of 'includeMachineAssignment'. Please take action immediately."},{"attribute":"displayName","takeActionBy":"2024-10-30T00:00:00Z","notice":"'displayName' has been deprecated. Please take action immediately."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an Instance Type for Infrastructure Provider.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstanceTypeCreateRequest"},"examples":{"example-1":{"value":{"name":"x3.large","description":"Part of X family, the X3 Large features increased compute power","siteId":"8d97fa69-9199-49ff-bcf3-168c62d3874e","labels":{"region":"portland","env":"staging"},"machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4}]}},"example-2":{"value":{"name":"infiniband-mt2910-4x2","description":"Machines with 2 active InfiniBand MT2910 NICs","siteId":"8d97fa69-9199-49ff-bcf3-168c62d3874e","labels":{"region":"portland","env":"dev"},"machineCapabilities":[{"type":"InfiniBand","name":"MT2910 Family [ConnectX-7]","vendor":"Mellanox Technologies","count":4,"inactiveDevices":[1,3]}]}}}}}},"tags":["Instance Type"]}},"/v2/org/{org}/nico/instance/type/{instanceTypeId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"instanceTypeId","in":"path","required":true,"description":"ID of the Instance Type"}],"get":{"summary":"Retrieve an Instance Type","tags":["Instance Type"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstanceType"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"x3.large","description":"Part of X family, the X3 Large features increased compute power","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","labels":{"region":"portland","env":"staging"},"machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2}],"allocationStats":{"assigned":30,"total":10,"used":3,"unused":7,"unusedUsable":7,"maxAllocatable":20},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"queryParam":"includeMachineAssociation","replacedBy":"includeMachineAssignment","takeActionBy":"2023-07-26T00:00:00Z","notice":"'includeMachineAssociation' has been deprecated in favor of 'includeMachineAssignment'. Please take action immediately."},{"attribute":"displayName","takeActionBy":"2024-10-30T00:00:00Z","notice":"'displayName' has been deprecated. Please take action immediately."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-instance-type","description":"Get an Instance Type by ID.\n\nIf the org has an Infrastructure Provider entity that owns the Instance Type, then the Instance Type detail is returned. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nIf the org has a Tenant entity and it has a Tenant Account with the Infrastructure Provider of the Instance Type, then the Instance Type detail is returned. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"boolean"},"in":"query","name":"includeMachineAssociation","description":"Include Machine associations for each Instance Type. Can only be requested by Provider"},{"schema":{"type":"boolean"},"in":"query","name":"includeAllocationStats","description":"Include Allocation stats. Currently can only be requested by Tenant"},{"schema":{"type":"string","enum":["InfrastructureProvider","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"delete":{"summary":"Delete Instance Type","operationId":"delete-instance-type","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete an Instance Type by ID.\n\nOrg must have an Infrastructure Provider entity that owns the Instance Type. User must have authorization role with `PROVIDER_ADMIN` suffix.","tags":["Instance Type"]},"patch":{"summary":"Update Instance Type","operationId":"update-instance-type","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstanceType"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"x3.large","description":"Updated version of the X3 Large family of machines","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","labels":{"region":"portland","env":"staging"},"machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"queryParam":"includeMachineAssociation","replacedBy":"includeMachineAssignment","takeActionBy":"2023-07-26T00:00:00Z","notice":"'includeMachineAssociation' has been deprecated in favor of 'includeMachineAssignment'. Please take action immediately."},{"attribute":"displayName","takeActionBy":"2024-10-30T00:00:00Z","notice":"'displayName' has been deprecated. Please take action immediately."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Update an Instance Type by ID.\n\nOrg must have an Infrastructure Provider entity that owns the Instance Type. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstanceTypeUpdateRequest"},"examples":{"example-1":{"value":{"description":"Updated version of the X3 Large family of machines","labels":{"region":"portland","env":"staging"},"machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2}]}}}}},"description":""},"tags":["Instance Type"]}},"/v2/org/{org}/nico/instance/type/{instanceTypeId}/machine":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"instanceTypeId","in":"path","required":true,"description":"ID of the Instance Type"}],"get":{"summary":"Retrieve all Machines/Instance Type associations","tags":["Instance Type"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MachineInstanceType"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"f690ffcd-06b7-430c-9c2a-b9afd18d77c3","machineId":"fm100htrh18t1lrjg2pqagkh3sfigr9m65dejvkq168ako07sc0uibpp5q0","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-instance-type-machine-association","description":"Get all Machines for a given Instance Type\n\nOrg must have an Infrastructure Provider entity that owns the Instance Type and the Machine. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create a Machine/Instance Type association","operationId":"create-instance-type-machine-association","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MachineInstanceType"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"f690ffcd-06b7-430c-9c2a-b9afd18d77c3","machineId":"fm100ht68sf2m52idrpslcjkpdj5r3tb3j5o0bkfubhoglbq47u18nknfog","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"f690ffcd-06b7-430c-9c2a-b9afd18d77c3","machineId":"fm100htrh18t1lrjg2pqagkh3sfigr9m65dejvkq168ako07sc0uibpp5q0","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Instance Type"],"description":"Associate a Machine to an Instance Type\n\nOrg must have an Infrastructure Provider entity that owns the Instance Type and the Machine. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nThe Machine's capabilities must be a superset of the Instance Type's required capabilities for the association to succeed.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MachineInstanceTypeCreateRequest"},"examples":{"example-1":{"value":{"machineIds":["fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","fm100htrh18t1lrjg2pqagkh3sfigr9m65dejvkq168ako07sc0uibpp5q0","fm100ht68sf2m52idrpslcjkpdj5r3tb3j5o0bkfubhoglbq47u18nknfog"]}}}}}}}},"/v2/org/{org}/nico/instance/type/{instanceTypeId}/machine/{machineAssociationId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"instanceTypeId","in":"path","required":true,"description":"ID of the Instance Type"},{"schema":{"type":"string"},"name":"machineAssociationId","in":"path","required":true,"description":"Can be ID of the Machine (`machineId`) or ID of Machine/Instance Type Association (`machineAssociationId`). Use of `machineAssociationId` is now deprecated and will no longer be accepted after July 9th, 2026 00:00 UTC."}],"delete":{"summary":"Delete a Machine/Instance Type association","operationId":"delete-instance-type-machine-association","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a Machine's association with an Instance Type.\n\n`machineAssociationId` path parameter has been renamed to `machineId`. The path parameter will continue to accept both Machine ID and Machine/Instance Type ID until July 9th, 2026 00:00 UTC. After that time, Machine/Instance Type ID will no longer be accepted.\n\nOrg must have an Infrastructure Provider entity that owns the Instance Type and the Machine. User must have authorization role with `PROVIDER_ADMIN` suffix.","tags":["Instance Type"]}},"/v2/org/{org}/nico/instance":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Instances","tags":["Instance"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Instance"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-monitor-1","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":"158fc2bc-f2fb-4e1f-a5a4-2211062d14df","ipxeScript":null,"alwaysBootWithCustomIpxe":false,"userData":null,"labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e,","networkSecurityGroupPropagationDetails":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","detailedStatus":"Partial","status":"Synchronizing","details":"","unpropagatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"relatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"]},"networkSecurityGroupInherited":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"64d2028c-ae87-4069-a624-66089d957ef9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true,"device":null,"deviceInstance":null,"virtualFunctionId":null,"macAddress":"2F-FC-34-AE-9C-2A","ipAddresses":["200.32.11.190"],"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"infinibandInterfaces":[{"id":"c518a0e8-3f49-4a1a-8935-a6d3dee6911e","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","partitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"nvLinkInterfaces":[{"id":"fc19ab3f-1e52-4846-91bd-98743ff2752c","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":0,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"c0ae6ec4-9a77-4358-baad-ee8cc3332c91","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":1,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"aa44ff62-d86b-4db6-9fa4-90a19b05be01","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":2,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"a403d1ca-2c07-410a-9678-3eb44d570ad9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":3,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"dpuExtensionServiceDeployments":[],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"tpmEkCertificate":"LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUMxVENDQWJ5Z0F3SUJBZ0lVTEE1ZHFPK1E5OXZQM3VYRTRKcjBncVRtOW93d0RRWUpLb1pJaHZjTkFRRUwKQlFBd0xqRUxNQWtHQTFVRUJoTUNWVk14RXpBUkJnTlZCQW9NQ2s1MmFXUnBZU0JEYjNKNw==","status":"Ready","statusHistory":[{"status":"BootCompleted","message":"The Instance successfully completed boot up","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"attribute":"sshkeygroups","replacedBy":"sshKeyGroups","takeActionBy":"2025-09-04T00:00:00Z","notice":"'sshkeygroups' is being deprecated in favor of 'sshKeyGroups'. Please take action prior to the specified date."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]},"example-2":{"value":[{"id":"37804b21-0a00-4668-81cb-af9e1b07ad3e","name":"spark-monitor-vpc-prefix-1","description":"Node for monitoring Spark VPC prefix region","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":"37804b21-0a00-4668-81cb-af9e1b07ad3e","ipxeScript":null,"alwaysBootWithCustomIpxe":false,"userData":null,"networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e","networkSecurityGroupPropagationDetails":{"id":"37804b21-0a00-4668-81cb-af9e1b07ad3e","detailedStatus":"Partial","status":"Synchronizing","details":"","unpropagatedInstanceIds":["37804b21-0a00-4668-81cb-af9e1b07ad3e"],"relatedInstanceIds":["37804b21-0a00-4668-81cb-af9e1b07ad3e"]},"networkSecurityGroupInherited":false,"labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"07cd865e-5512-4fe9-8063-8f4c8f442b1a","instanceId":"37804b21-0a00-4668-81cb-af9e1b07ad3e","vpcPrefixId":"915443b6-d164-48d4-89dd-041968e1f9d7","isPhysical":true,"virtualFunctionId":null,"macAddress":"2F-FC-34-AE-9C-2A","ipAddresses":["200.32.11.190"],"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"infinibandInterfaces":[{"id":"c518a0e8-3f49-4a1a-8935-a6d3dee6911e","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","partitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"dpuExtensionServiceDeployments":[{"id":"3951ec37-d78f-4ad7-92e1-3fdc76ccf246","dpuExtensionService":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"busybox","serviceType":"KubernetesPod","latestVersion":"V1-T1761856992374052","status":"Ready"},"version":"V1-T1761856992374052","status":"Running","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Ready","statusHistory":[{"status":"BootCompleted","message":"The Instance successfully completed boot up","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"attribute":"sshkeygroups","replacedBy":"sshKeyGroups","takeActionBy":"2025-09-04T00:00:00Z","notice":"'sshkeygroups' is being deprecated in favor of 'sshKeyGroups' and will be removed on September 9th, 2025. Please update your usage accordingly."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]},"example-3":{"value":[{"id":"bba44e11-facc-4d7f-a2b5-ffdca3935b8b","name":"spark-monitor-vpc-prefix-multi-dpu","description":"Node for monitoring Spark VPC prefix region with Multi DPU","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"9fda8e2b-9656-4f96-9d79-14d03951e2d2","vpcId":"745f757f-894b-45ef-be63-b1044e76a87d","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":"8d76c56e-4a1c-4862-bf1c-8c2b794f3315","ipxeScript":null,"alwaysBootWithCustomIpxe":false,"userData":null,"networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e","networkSecurityGroupPropagationDetails":{"id":"37804b21-0a00-4668-81cb-af9e1b07ad3e","detailedStatus":"Partial","status":"Synchronizing","details":"","unpropagatedInstanceIds":["37804b21-0a00-4668-81cb-af9e1b07ad3e"],"relatedInstanceIds":["37804b21-0a00-4668-81cb-af9e1b07ad3e"]},"networkSecurityGroupInherited":false,"labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"fa84f327-cad4-458b-94b7-c320cdf48d4d","instanceId":"bba44e11-facc-4d7f-a2b5-ffdca3935b8b","vpcPrefixId":"915443b6-d164-48d4-89dd-041968e1f9d7","isPhysical":true,"device":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceInstance":0,"virtualFunctionId":null,"macAddress":"A0:88:C2:0C:91:B8","ipAddresses":["10.217.98.143"],"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"fa84f327-cad4-458b-94b7-c320cdf48d4d","instanceId":"bba44e11-facc-4d7f-a2b5-ffdca3935b8b","vpcPrefixId":"56944877-3bc0-48c9-8290-21f9e0e31eca","isPhysical":true,"device":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceInstance":1,"virtualFunctionId":null,"macAddress":"A0:88:C2:0C:91:20","ipAddresses":["10.217.98.149"],"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"infinibandInterfaces":[],"dpuExtensionServiceDeployments":[],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Ready","statusHistory":[{"status":"BootCompleted","message":"The Instance successfully completed boot up","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"attribute":"sshkeygroups","replacedBy":"sshKeyGroups","takeActionBy":"2025-09-04T00:00:00Z","notice":"'sshkeygroups' is being deprecated in favor of 'sshKeyGroups' and will be removed on September 9th, 2025. Please update your usage accordingly."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-instance","description":"Get all Instances for Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","description":"Filter by Infrastructure Provider ID"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter by Site ID. Can be specified multiple times to filter on more than one site."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"vpcId","description":"Filter by VPC ID. Can be specified multiple times to filter on more than one VPC."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"instanceTypeId","description":"Filter by instance type ID. Can be specified multiple times to filter on more than one instance type."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"operatingSystemId","description":"Filter by operating system ID. Can be specified multiple times to filter on more than one operating system."},{"schema":{"type":"string"},"in":"query","name":"machineId","description":"Filter by machine ID. Can be specified multiple times to filter on more than one machine."},{"schema":{"type":"string"},"in":"query","name":"name","description":"Filter by Instance name"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Instances by Status. Can be specified multiple times to filter on more than one status."},{"schema":{"type":"string"},"in":"query","name":"ipAddress","description":"Filter by IP address. Can be specified multiple times to filter on more than one IP address."},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description, status, and labels fields"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site","InstanceType","Allocation","VPC","Machine","OperatingSystem","NetworkSecurityGroup"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC","MACHINE_ID_ASC","MACHINE_ID_DESC","TENANT_ORG_DISPLAY_NAME_ASC","TENANT_ORG_DISPLAY_NAME_DESC","INSTANCE_TYPE_NAME_ASC","INSTANCE_TYPE_NAME_DESC","HAS_INFINIBAND_ASC","HAS_INFINIBAND_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"},{"schema":{"type":"string"},"in":"query","name":"networkSecurityGroupId","description":"Filter by NetworkSecurityGroup ID.  Can be specified multiple times to filter on more than one Network Security Group."}]},"post":{"summary":"Create an Instance","operationId":"create-instance","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Instance"},"examples":{"With iPXE override and Ethernet/InfiniBand Interfaces":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-monitor-1","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":null,"ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\nshell","alwaysBootWithCustomIpxe":true,"userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports","labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"64d2028c-ae87-4069-a624-66089d957ef9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true,"virtualFunctionId":null,"macAddress":null,"ipAddresses":[],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"infinibandInterfaces":[{"id":"c518a0e8-3f49-4a1a-8935-a6d3dee6911e","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","partitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"nvLinkInterfaces":[{"id":"fc19ab3f-1e52-4846-91bd-98743ff2752c","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":0,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"dpuExtensionServiceDeployments":[],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"attribute":"sshkeygroups","replacedBy":"sshKeyGroups","takeActionBy":"2025-09-04T00:00:00Z","notice":"'sshkeygroups' is being deprecated in favor of 'sshKeyGroups'. Please take action prior to the specified date."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}},"With DPU Extension Service Deployments":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-monitor-1","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":null,"labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"64d2028c-ae87-4069-a624-66089d957ef9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true,"virtualFunctionId":null,"macAddress":null,"ipAddresses":[],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"dpuExtensionServiceDeployments":[{"id":"3951ec37-d78f-4ad7-92e1-3fdc76ccf246","dpuExtensionService":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"busybox","serviceType":"KubernetesPod","latestVersion":"V1-T1761856992374052","status":"Ready"},"version":"V1-T1761856992374052","status":"Running","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an Instance for Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstanceCreateRequest"},"examples":{"With Subnet/InfiniBand Interfaces & iPXE Override":{"value":{"name":"spark-monitor-1","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\nshell","alwaysBootWithCustomIpxe":true,"userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports","labels":{"region":"portland","env":"staging"},"interfaces":[{"subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true}],"infinibandInterfaces":[{"partitionId":"4f4decba-7d7f-46b9-9e5f-e5d71c2e0666","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null}],"nvLinkInterfaces":[{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":0},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":1},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":2},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":3}],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"]}},"With Machine ID & VPC Prefix Interface":{"value":{"name":"spark-monitor-3","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","machineId":"fm100htq4o8j3bere298as19mdgnbu6hg6guiqp32tghj7gogv05hlr7lgg","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","labels":{"region":"portland","env":"staging"},"interfaces":[{"vpcPrefixId":"000bc42b-f946-472e-83d4-ddf7e365e148","isPhysical":true}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]}},"With Multiple Ethernet Device Interfaces":{"value":{"name":"spark-monitor-3","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","machineId":"fm100htq4o8j3bere298as19mdgnbu6hg6guiqp32tghj7gogv05hlr7lgg","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","labels":{"region":"portland","env":"staging"},"interfaces":[{"vpcPrefixId":"8c7422d7-abf5-41ae-8b6d-9d62442a8b31","isPhysical":true,"device":"MT43244 BlueField-3 integrated ConnectX-7 network controller","deviceInstance":0},{"vpcPrefixId":"8988dbd3-f038-4338-b961-8e5cbf89a77e","isPhysical":true,"device":"MT43244 BlueField-3 integrated ConnectX-7 network controller","deviceInstance":1}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]}},"With DPU Extension Services":{"value":{"name":"llm-training-1","description":"Node for training LLMs","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","machineId":"fm100htq4o8j3bere298as19mdgnbu6hg6guiqp32tghj7gogv05hlr7lgg","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","labels":{"region":"portland","env":"staging"},"interfaces":[{"vpcPrefixId":"8c7422d7-abf5-41ae-8b6d-9d62442a8b31","isPhysical":true,"device":"MT43244 BlueField-3 integrated ConnectX-7 network controller","deviceInstance":0},{"vpcPrefixId":"8988dbd3-f038-4338-b961-8e5cbf89a77e","isPhysical":true,"device":"MT43244 BlueField-3 integrated ConnectX-7 network controller","deviceInstance":1}],"dpuExtensionServiceDeployments":[{"dpuExtensionServiceId":"3bddb7b4-0963-4278-b311-c212dc758357","version":"V1-T1761856992374052"},{"dpuExtensionServiceId":"cd4a8168-c206-430a-9a4b-bf7dbbac3b40","version":"V1-T1762294647497908"}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]}}}}}},"tags":["Instance"]}},"/v2/org/{org}/nico/instance/batch":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Batch Create Instances","operationId":"batch-create-instance","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Instance"}},"examples":{"Batch created Instances":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"worker-abc123","description":"Worker node for distributed training","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":null,"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"85c5e7b2-89f1-4e32-9d3a-8e1f5a2c7d90","name":"worker-def456","description":"Worker node for distributed training","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"gn200iu5w5ndf3rtukol9081ook4jf7fdfl5nuok38qfb5lsf6hub50kh1h","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":null,"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Batch create multiple Instances for Tenant with NVLink domain-aware machine allocation.\n\nThis endpoint creates multiple instances in a single atomic transaction. All instances share the same configuration (interfaces, OS, SSH keys, etc.) but are assigned different machines.\n\nWhen `topologyOptimized` is true (default), all instances must be allocated on machines within the same NVLink domain. If insufficient machines are available in a single NVLink domain, the request will fail.\n\nWhen `topologyOptimized` is false, instances can be spread across different NVLink domains.\n\nInstance names are automatically generated using the `namePrefix` with a random 6-character suffix (e.g., \"worker\" becomes \"worker-abc123\", \"worker-def456\").\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchInstanceCreateRequest"},"examples":{"Topology-optimized batch with InfiniBand":{"value":{"namePrefix":"gpu-worker","count":4,"description":"GPU worker nodes for distributed training","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","topologyOptimized":true,"interfaces":[{"subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true}],"infinibandInterfaces":[{"partitionId":"4f4decba-7d7f-46b9-9e5f-e5d71c2e0666","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true}],"nvLinkInterfaces":[{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":0},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":1}],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"]}},"Cross-domain batch with VPC Prefix":{"value":{"namePrefix":"inference-node","count":8,"description":"Inference nodes spread across NVLink domains","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","instanceTypeId":"83e71f8f-65d3-44ba-92ba-19daac2e497a","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","topologyOptimized":false,"labels":{"workload":"inference","tier":"production"},"interfaces":[{"vpcPrefixId":"000bc42b-f946-472e-83d4-ddf7e365e148","isPhysical":true}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]}}}}}},"tags":["Instance"]}},"/v2/org/{org}/nico/instance/{instanceId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"instanceId","in":"path","required":true,"description":"ID of the Instance"}],"get":{"summary":"Retrieve Instance","tags":["Instance"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Instance"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-monitor-1","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":null,"ipxeScript":null,"alwaysBootWithCustomIpxe":false,"userData":null,"networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e","networkSecurityGroupPropagationDetails":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","detailedStatus":"Partial","status":"Synchronizing","details":"","unpropagatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"relatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"]},"networkSecurityGroupInherited":false,"labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"64d2028c-ae87-4069-a624-66089d957ef9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true,"virtualFunctionId":null,"macAddress":"2F-FC-34-AE-9C-2A","ipAddresses":["200.32.11.190"],"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"infinibandInterfaces":[{"id":"c518a0e8-3f49-4a1a-8935-a6d3dee6911e","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","partitionId":"4f4decba-7d7f-46b9-9e5f-e5d71c2e0666","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"nvLinkInterfaces":[{"id":"fc19ab3f-1e52-4846-91bd-98743ff2752c","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":0,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"c0ae6ec4-9a77-4358-baad-ee8cc3332c91","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":1,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"aa44ff62-d86b-4db6-9fa4-90a19b05be01","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":2,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"a403d1ca-2c07-410a-9678-3eb44d570ad9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":3,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"dpuExtensionServiceDeployments":[{"id":"3951ec37-d78f-4ad7-92e1-3fdc76ccf246","dpuExtensionService":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"busybox","serviceType":"KubernetesPod","latestVersion":"V1-T1761856992374052","status":"Ready"},"version":"V1-T1761856992374052","status":"Running","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"tpmEkCertificate":"LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUMxVENDQWJ5Z0F3SUJBZ0lVTEE1ZHFPK1E5OXZQM3VYRTRKcjBncVRtOW93d0RRWUpLb1pJaHZjTkFRRUwKQlFBd0xqRUxNQWtHQTFVRUJoTUNWVk14RXpBUkJnTlZCQW9NQ2s1MmFXUnBZU0JEYjNKNw==","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"attribute":"sshkeygroups","replacedBy":"sshKeyGroups","takeActionBy":"2025-09-04T00:00:00Z","notice":"'sshkeygroups' is being deprecated in favor of 'sshKeyGroups'. Please take action prior to the specified date."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-instance","description":"Get an Instance by ID\n\nOrg must have a Tenant entity. Instance must belong to Tenant. User must have authorization role with `TENANT_ADMIN` suffix.\n","parameters":[{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site","InstanceType","Allocation","VPC","OperatingSystem","NetworkSecurityGroup"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"delete":{"summary":"Delete Instance","operationId":"delete-instance","responses":{"202":{"description":"Accepted"}},"description":"Delete an Instance by ID\n\nOrg must have a Tenant entity. Instance must belong to Tenant. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["Instance"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstanceDeleteRequest"},"examples":{"Example 1":{"value":{"machineHealthIssue":{"category":"Network","summary":"Machine has DPU connectivity error","details":"Tenant observed repeated link flaps on the DPU uplink."},"isRepairTenant":false}}}}},"description":"Optional request data to report health issues with the underlying Machine"}},"patch":{"summary":"Update Instance","operationId":"update-instance","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Instance"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-monitor-2","description":"Spark Monitor Node 1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":"158fc2bc-f2fb-4e1f-a5a4-2211062d14df","ipxeScript":null,"alwaysBootWithCustomIpxe":false,"userData":null,"labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"64d2028c-ae87-4069-a624-66089d957ef9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true,"virtualFunctionId":null,"macAddress":"2F-FC-34-AE-9C-2A","ipAddresses":["200.32.11.190"],"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"infinibandInterfaces":[{"id":"c518a0e8-3f49-4a1a-8935-a6d3dee6911e","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","partitionId":"550e8400-e29b-41d4-a716-446655440000","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"3cc0206e-8ac9-4572-8f72-e1dd124c4351","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","partitionId":"6ba7b810-9dad-11d1-80b4-00c04fd430c8","device":"MT2910 Family [ConnectX-7]","deviceInstance":1,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"84a2cf1e-73fc-42f4-974e-33a4e9889eb9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","partitionId":"8b05d5c3-8de4-48c8-8d1c-399a8abc3ab8","device":"MT2910 Family [ConnectX-7]","deviceInstance":2,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"dpuExtensionServiceDeployments":[{"id":"3951ec37-d78f-4ad7-92e1-3fdc76ccf246","dpuExtensionService":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"busybox","serviceType":"KubernetesPod","latestVersion":"V1-T1761856992374052","status":"Ready"},"version":"V1-T1761856992374052","status":"Running","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"60d3ad40-62c6-44ca-b6b1-74bc6dd04f1c","dpuExtensionService":{"id":"cd4a8168-c206-430a-9a4b-bf7dbbac3b40","name":"openssh-server","serviceType":"KubernetesPod","latestVersion":"V1-T1762294647497908","status":"Ready"},"version":"V1-T1762294647497908","status":"Running","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"tpmEkCertificate":"LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUMxVENDQWJ5Z0F3SUJBZ0lVTEE1ZHFPK1E5OXZQM3VYRTRKcjBncVRtOW93d0RRWUpLb1pJaHZjTkFRRUwKQlFBd0xqRUxNQWtHQTFVRUJoTUNWVk14RXpBUkJnTlZCQW9NQ2s1MmFXUnBZU0JEYjNKNw==","status":"Rebooting","statusHistory":[{"status":"Rebooting","message":"Reboot request received, processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"status":"Provisioning","message":"Instance is being provisioned on Site","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"attribute":"sshkeygroups","replacedBy":"sshKeyGroups","takeActionBy":"2025-09-04T00:00:00Z","notice":"'sshkeygroups' is being deprecated in favor of 'sshKeyGroups'. Please take action prior to the specified date."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Update an Instance by ID\n\nOrg must have a Tenant entity. Instance must belong to Tenant. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstanceUpdateRequest"},"examples":{"example-1":{"value":{"name":"spark-monitor-1","description":"Spark Monitor Node 1","triggerReboot":true,"rebootWithCustomIpxe":true,"applyUpdatesOnReboot":true,"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"],"labels":{"region":"portland","env":"staging"},"interfaces":[{"vpcPrefixId":"1f492faa-2963-4f21-aab5-9f00b2e40119","device":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceInstance":0,"virtualFunctionId":null,"isPhysical":true},{"vpcPrefixId":"1f3677dd-5794-4e57-b9b0-aebaf49b84fe","device":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceInstance":0,"virtualFunctionId":1,"isPhysical":false},{"vpcPrefixId":"29e6f51b-145c-4f89-8c26-accaa8328398","device":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceInstance":0,"virtualFunctionId":2,"isPhysical":false}],"infinibandInterfaces":[{"partitionId":"550e8400-e29b-41d4-a716-446655440000","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true},{"partitionId":"6ba7b810-9dad-11d1-80b4-00c04fd430c8","device":"MT2910 Family [ConnectX-7]","deviceInstance":1,"isPhysical":false},{"partitionId":"8b05d5c3-8de4-48c8-8d1c-399a8abc3ab8","device":"MT2910 Family [ConnectX-7]","deviceInstance":2,"isPhysical":false}],"nvLinkInterfaces":[{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":0},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":1},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":2},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":3}],"dpuExtensionServiceDeployments":[{"dpuExtensionServiceId":"3bddb7b4-0963-4278-b311-c212dc758357","version":"V1-T1761856992374052"},{"dpuExtensionServiceId":"cd4a8168-c206-430a-9a4b-bf7dbbac3b40","version":"V1-T1762294647497908"}]}}}}},"description":""},"tags":["Instance"]}},"/v2/org/{org}/nico/instance/{instanceId}/status-history":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"instanceId","in":"path","required":true,"description":"ID of the Instance"}],"get":{"summary":"Retrieve Instance status history","tags":["Instance"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"examples":{"Example 1":{"value":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-instance-status-history","description":"Get Instance status history\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n","parameters":[{"schema":{"type":"integer"},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer"},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string"},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/instance/{instanceId}/interface":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"instanceId","in":"path","required":true,"description":"ID of the Instance"}],"get":{"summary":"Retrieve all Interfaces","tags":["Instance"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Interface"}},"examples":{"Example 1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true,"virtualFunctionId":null,"macAddress":"2F-FC-34-AE-9C-2A","ipAddresses":["200.32.11.190"],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"d57b373a-5a59-4fa4-b080-50e9a1095aeb","vpcPrefixId":"26be5f71-3d51-487b-a940-6513c7725cfd","isPhysical":true,"virtualFunctionId":null,"macAddress":"2F-FC-34-AE-9C-2A","ipAddresses":["200.32.11.190"],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-interface","description":"Get all Interfaces for an Instance\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Interfaces by Status"},{"schema":{"type":"string","enum":["Instance","Subnet"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/instance/{instanceId}/infiniband-interface":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"instanceId","in":"path","required":true,"description":"ID of the Instance"}],"get":{"summary":"Retrieve all Instance InfiniBand Interfaces","tags":["Instance"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InfiniBandInterface"}},"examples":{"Example 1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","partitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Provisioning","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"c518a0e8-3f49-4a1a-8935-a6d3dee6911e","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","partitionId":"6ba7b810-9dad-11d1-80b4-00c04fd430c8","device":"MT2910 Family [ConnectX-7]","deviceInstance":1,"isPhysical":false,"virtualFunctionId":1,"guid":"946dae0300339499","status":"Provisioning","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-instance-infiniband-interface","description":"Get all InfiniBand Interfaces for an Instance\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter InfiniBand Interfaces by Status"},{"schema":{"type":"string","enum":["Instance","InfiniBandPartition"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/instance/{instanceId}/nvlink-interface":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"instanceId","in":"path","required":true,"description":"ID of the Instance"}],"get":{"summary":"Retrieve all Instance NVLink Interfaces","tags":["Instance"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NVLinkInterface"}},"examples":{"Example 1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","nvLinkLogicalPartitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","nvLinkDomainId":"4b145552-0d8f-45ff-b652-eed105f93e50","deviceInstance":0,"gpuGuid":"5108732638879268442","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"8a7c3b21-1ffc-4c78-9a00-2a6f3859d099","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","nvLinkLogicalPartitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","nvLinkDomainId":"4b145552-0d8f-45ff-b652-eed105f93e50","deviceInstance":1,"gpuGuid":"5108732638879268443","status":"Provisioning","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-instance-nvlink-interface","description":"Get all NVLink Interfaces for an Instance\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter NVLink Interfaces by Status. Can be specified multiple times to filter on more than one status."},{"schema":{"type":"string","enum":["Instance","NVLinkLogicalPartition"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/infiniband-interface":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all InfiniBand Interfaces","tags":["InfiniBand Partition"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InfiniBandInterface"}},"examples":{"Example 1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","partitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-infiniband-interface","description":"Get all InfiniBand Interfaces\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"siteId","description":"Filter InfiniBand Interfaces by Site ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string"},"in":"query","name":"instanceId","description":"Filter InfiniBand Interfaces by Instance ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string"},"in":"query","name":"infinibandPartitionId","description":"Filter InfiniBand Interfaces by InfiniBand Partition ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter InfiniBand Interfaces by Status. Can be specified multiple times to filter on more than one status."},{"schema":{"type":"string","enum":["Instance","InfiniBandPartition","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/nvlink-interface":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the NGC Org"}],"get":{"summary":"Retrieve all NVLink Interfaces","tags":["NVLink Logical Partition"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NVLinkInterface"}},"examples":{"Example 1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","nvLinkLogicalPartitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","nvLinkDomainId":"4b145552-0d8f-45ff-b652-eed105f93e50","deviceInstance":0,"gpuGuid":"5108732638879268442","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-nvlink-interface","description":"Get all NVLink Interfaces\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter NVLink Interfaces by Status. Can be specified multiple times to filter on more than one status."},{"schema":{"type":"string"},"in":"query","name":"siteId","description":"Filter NVLink Interfaces by Site ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string"},"in":"query","name":"instanceId","description":"Filter NVLink Interfaces by Instance ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string"},"in":"query","name":"nvLinkLogicalPartitionId","description":"Filter NVLink Interfaces by NVLink Logical Partition ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string"},"in":"query","name":"nvLinkDomainId","description":"Filter NVLink Interfaces by NVLink Domain ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string","enum":["Instance","NVLinkLogicalPartition"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/operating-system":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Operating Systems","tags":["Operating System"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OperatingSystem"}},"examples":{"example-1":{"value":[{"id":"42b0f982-5c61-4d2f-a018-41ece61f4641","name":"debian-12-amd64","description":"Official Debian 12 for AMD/Intel","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","type":"Image","imageUrl":"https://saimei.ftp.acc.umu.se/images/cloud/bookworm/latest/debian-12-generic-amd64.qcow2","imageSha":"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae","imageAuthType":"Bearer","imageAuthToken":"acbd18db4cc2f85cedef654fccc4a4d8","imageDisk":"/dev/sda","rootFsId":"6c2ac315-3040-4728-94eb-b66d320206c1","ipxeScript":null,"userData":null,"isCloudInit":true,"phoneHomeEnabled":false,"allowOverride":false,"siteAssociations":[{"site":{"id":"4b36152c-f48d-4bcc-a722-0fd8e2ad209a","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"site":{"id":"219b7913-4494-4589-940e-e78ca879b302","name":"sc-west-4","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":false,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"isActive":true,"deactivationNote":null,"status":"Syncing","statusHistory":[{"status":"Syncing","message":"received Operating System creation request, syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]},"example-2":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"ubuntu-22.04","description":"Ubuntu 22.04","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","type":"iPXE","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports","isCloudInit":true,"phoneHomeEnabled":false,"allowOverride":false,"imageAuthToken":null,"imageAuthType":null,"imageDisk":null,"imageSha":null,"imageUrl":null,"rootFsId":null,"rootFsLabel":null,"isActive":true,"deactivationNote":null,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-operating-system","description":"Get an Operating System by ID\n\nIf the Operating System has `infrastructureProviderId` set, then org must have an Infrastructure Provider entity and its ID should match the Operating System Infrastructure Provider ID. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nIf the Operating System has `tenantId` set, then org must have a Tenant entity and its ID should match the Operating System Tenant ID. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"siteId","description":"Filter Operating Systems by Site ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string","enum":["Image","iPXE"]},"in":"query","name":"type","description":"Filter Operating Systems by Type"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Operating Systems by Status.  Can be specified multiple times to filter on more than one status."},{"schema":{"type":"string"},"in":"query","name":"query","description":"Provide query to search for matches. Input will be matched against name, description and status fields"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create Operating System","operationId":"create-operating-system","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatingSystem"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"ubuntu-22.04","description":"Ubuntu 22.04","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","type":"iPXE","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports","isCloudInit":true,"phoneHomeEnabled":false,"allowOverride":false,"imageAuthToken":null,"imageAuthType":null,"imageDisk":null,"imageSha":null,"imageUrl":null,"rootFsId":null,"rootFsLabel":null,"siteAssociations":[],"isActive":true,"deactivationNote":null,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an Operating System for the org.\n\nEither `infrastructureProviderId` or `tenantId` must be provided in request data. Both cannot be provided at the same time.\n\nIf `infrastructureProviderId` is provided in request data, then org must have an Infrastructure Provider entity and its ID should match the query param value. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nIf `tenantId` is provided in request data, then org must have a Tenant entity and its ID should match the query param value. User must have authorization role with `TENANT_ADMIN` suffix.\n\nOnly Tenants are allowed to create Operating System for MVP.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatingSystemCreateRequest"},"examples":{"example-1":{"value":{"name":"ubuntu-official-22.04","description":"Official Ubuntu 22.04","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports","isCloudInit":true,"phoneHomeEnabled":true,"allowOverride":false}},"example-2":{"value":{"name":"debian-12-amd64","description":"Official Debian 12 for AMD/Intel","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","siteIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"imageUrl":"https://saimei.ftp.acc.umu.se/images/cloud/bookworm/latest/debian-12-generic-amd64.qcow2","imageSha":"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae","imageAuthType":"Bearer","imageAuthToken":"acbd18db4cc2f85cedef654fccc4a4d8","imageDisk":"/dev/sda","rootFsId":"6c2ac315-3040-4728-94eb-b66d320206c1","rootFsLabel":null,"userData":null,"isCloudInit":true,"phoneHomeEnabled":false,"allowOverride":false}}}}}},"tags":["Operating System"]}},"/v2/org/{org}/nico/operating-system/{operatingSystemId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"operatingSystemId","in":"path","required":true,"description":"ID of the Operating System"}],"get":{"summary":"Retrieve Operating System","tags":["Operating System"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatingSystem"},"examples":{"Image Based OS":{"value":{"id":"42b0f982-5c61-4d2f-a018-41ece61f4641","name":"debian-12-amd64","description":"Official Debian 12 for AMD/Intel","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","type":"Image","imageUrl":"https://saimei.ftp.acc.umu.se/images/cloud/bookworm/latest/debian-12-generic-amd64.qcow2","imageSha":"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae","imageAuthType":"Bearer","imageAuthToken":"acbd18db4cc2f85cedef654fccc4a4d8","imageDisk":"/dev/sda","rootFsId":"6c2ac315-3040-4728-94eb-b66d320206c1","rootFsLabel":null,"ipxeScript":null,"userData":null,"isCloudInit":true,"phoneHomeEnabled":false,"allowOverride":false,"siteAssociations":[{"site":{"id":"4b36152c-f48d-4bcc-a722-0fd8e2ad209a","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"site":{"id":"219b7913-4494-4589-940e-e78ca879b302","name":"sc-west-4","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":false,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"isActive":true,"deactivationNote":null,"status":"Syncing","statusHistory":[{"status":"Syncing","message":"received Operating System creation request, syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}},"iPXE OS":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"ubuntu-22.04","description":"Ubuntu 22.04","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","type":"iPXE","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports","isCloudInit":true,"phoneHomeEnabled":false,"allowOverride":false,"imageAuthToken":null,"imageAuthType":null,"imageDisk":null,"imageSha":null,"imageUrl":null,"rootFsId":null,"rootFsLabel":null,"siteAssociations":[],"isActive":true,"deactivationNote":null,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-operating-system","description":"Get an Operating System by ID\n\nIf the Operating System has `infrastructureProviderId` set, then org must have an Infrastructure Provider entity and its ID should match the Operating System Infrastructure Provider ID. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nIf the Operating System has `tenantId` set, then org must have a Tenant entity and its ID should match the Operating System Tenant ID. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"delete":{"summary":"Delete Operating System","operationId":"delete-operating-system","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete an Operating System by ID\n\nIf the Operating System has `infrastructureProviderId` set, then org must have an Infrastructure Provider entity and its ID should match the Operating System Infrastructure Provider ID. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nIf the Operating System has `tenantId` set, then org must have a Tenant entity and its ID should match the Operating System Tenant ID. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["Operating System"]},"patch":{"summary":"Update Operating System","operationId":"update-operating-system","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatingSystem"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"ubuntu-22.04-lts","description":"Ubuntu 22.04 LTS","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","type":"iPXE","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports","isCloudInit":true,"allowOverride":true,"phoneHomeEnabled":true,"imageAuthToken":null,"imageAuthType":null,"imageDisk":null,"imageSha":null,"imageUrl":null,"rootFsId":null,"rootFsLabel":null,"siteAssociations":[],"isActive":true,"deactivationNote":null,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Update an Operating System by ID\n\nIf the Operating System has `infrastructureProviderId` set, then org must have an Infrastructure Provider entity and its ID should match the Operating System Infrastructure Provider ID. User must have authorization role with `PROVIDER_ADMIN` suffix. Provider must own the Operating System.\n\nIf the Operating System has `tenantId` set, then org must have a Tenant entity and its ID should match the Operating System Tenant ID. User must have authorization role with `TENANT_ADMIN` suffix. Tenant must own the Operating System.","tags":["Operating System"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatingSystemUpdateRequest"},"examples":{"example-1":{"value":{"name":"ubuntu-22.04-lts","description":"Ubuntu 22.04 LTS","allowOverride":true}}}}}}}},"/v2/org/{org}/nico/machine":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Machines","tags":["Machine"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Machine"}},"examples":{"example-1":{"value":[{"id":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":null,"instanceId":null,"tenantId":null,"controllerMachineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerMachineType":"x86_64","hwSkuDeviceType":"cpu","vendor":"Lenovo","productName":"ThinkSystem SR670 V2","serialNumber":"J1060ACR.D3KS2CS001G","machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4}],"machineInterfaces":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerInterfaceId":"ad3dac49-741d-4c1f-815c-c020127c532f","controllerSegmentId":"f2207a3c-1847-42e5-bf2c-cd015f87a2bc","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","hostname":"example.com","isPrimary":true,"macAddress":"00:00:5e:00:53:af","ipAddresses":["192.156.7.23","202.88.37.112"],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"maintenanceMessage":null,"health":{"source":"aggregate-host-health","observedAt":null,"successes":[{"id":"BgpDaemonEnabled","target":null},{"id":"BgpStats","target":null},{"id":"DhcpServer","target":null},{"id":"DpuDiskUtilizationCheck","target":null},{"id":"FanSpeed","target":"System Board Fan1A"},{"id":"PowerSupply","target":"PS1 Status"},{"id":"Temperature","target":"CPU1 Temp"},{"id":"Temperature","target":"System Board Exhaust Temp"},{"id":"Voltage","target":"CPU1 1P8 PG"}],"alerts":[]},"labels":{"RackIdentifier":"GVX11F01C02","ServerName":"SITE1-C03-Server-02"},"status":"Ready","isUsableByTenant":true,"statusHistory":[{"status":"Ready","message":"Machine is online and ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-machine","description":"Get all Machines for Infrastructure Provider.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n","parameters":[{"schema":{"type":"string"},"in":"query","name":"siteId","description":"Filter Machines by Site ID"},{"schema":{"type":"string"},"in":"query","name":"id","description":"Filter Machines by ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"boolean"},"in":"query","name":"hasInstanceType","description":"Filter Machines that have been assigned an Instance Type."},{"schema":{"type":"string"},"in":"query","name":"instanceTypeId","description":"Filter Machines by Instance Type ID.  Can be specified multiple times to filter on more than one Instance Type ID."},{"schema":{"type":"string"},"in":"query","name":"tenantId","description":"Filter Machines by ID of tenant of assigned instance. Can be specified multiple times to filter on more than one Tenant ID."},{"schema":{"type":"boolean"},"in":"query","name":"hasInstance","description":"Filter Machines that are assigned to an Instance. siteId must be specified when using this param."},{"schema":{"type":"boolean"},"in":"query","name":"isMissingOnSite","description":"Filter Machines that are missing on Site."},{"schema":{"type":"boolean"},"in":"query","name":"includeMetadata","description":"Include Machine metadata e.g. BMC, DPU, GPU and Interface data. Can only be requested by Provider."},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Machines by Status.  Can be specified multiple times to filter on more than one Status."},{"schema":{"type":"string"},"in":"query","name":"capabilityType","description":"Filter Machines by Capability Type"},{"schema":{"type":"string"},"in":"query","name":"capabilityName","description":"Filter Machines by Capability Name.  Can be specified multiple times to filter on more than one Capability Name."},{"schema":{"type":"string"},"in":"query","name":"hwSkuDeviceType","description":"Filter Machines by hardware SKU Device Type. Example values: \"gpu\", \"cpu\", \"storage\", \"cache\""},{"schema":{"type":"string"},"in":"query","name":"query","description":"Provide query to search for matches. Input will be matched against Machine ID, vendor, product name, hostname and status"},{"schema":{"type":"string","enum":["InfrastructureProvider","Site","InstanceType"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC","ID_ASC","ID_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/machine/{machineId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"machineId","in":"path","required":true,"description":"ID of the Machine"}],"get":{"summary":"Retrieve a Machine","tags":["Machine"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Machine"},"examples":{"Without Metadata":{"value":{"id":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"2e016c02-2c67-48aa-b289-5d3ca6320c52","instanceId":"59bdaaff-3998-4fd9-a140-8749beeb605e","tenantId":"99819e6e-4017-4021-9edd-ea1bdf4dbd59","controllerMachineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerMachineType":"x86_64","hwSkuDeviceType":"cpu","vendor":"Lenovo","productName":"ThinkSystem SR670 V2","serialNumber":"J1060ACR.D3KS2CS001G","machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4},{"type":"Network","name":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","count":2,"deviceType":"DPU"},{"type":"Storage","name":"Dell Ent NVMe CM6 RI 1.92TB","capacity":"1.92TB","count":2},{"type":"GPU","name":"NVIDIA A100 PCIe","capacity":"80GB","count":2},{"type":"InfiniBand","name":"MT28908 Family [ConnectX-6]","vendor":"Mellanox Technologies","count":2}],"machineInterfaces":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerInterfaceId":"ad3dac49-741d-4c1f-815c-c020127c532f","controllerSegmentId":"f2207a3c-1847-42e5-bf2c-cd015f87a2bc","attachedDpuMachineID":"fm100dsg4ekcb4sdi6hkqn0iojhj18okrr8vct64luh8957lfe8e69vme20,","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","hostname":"example.com","isPrimary":true,"macAddress":"00:00:5e:00:53:af","ipAddresses":["192.156.7.23","202.88.37.112"],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"maintenanceMessage":null,"health":{"source":"aggregate-host-health","observedAt":null,"successes":[{"id":"BgpDaemonEnabled","target":null},{"id":"BgpStats","target":null},{"id":"DhcpServer","target":null},{"id":"DpuDiskUtilizationCheck","target":null},{"id":"FanSpeed","target":"System Board Fan1A"},{"id":"PowerSupply","target":"PS1 Status"},{"id":"Temperature","target":"CPU1 Temp"},{"id":"Temperature","target":"System Board Exhaust Temp"},{"id":"Voltage","target":"CPU1 1P8 PG"}],"alerts":[]},"labels":{"RackIdentifier":"GVX11F01C02","ServerName":"SITE1-C03-Server-02"},"status":"Ready","isUsableByTenant":true,"statusHistory":[{"status":"Ready","message":"Machine is online and ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}},"With Metadata":{"value":{"id":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"2e016c02-2c67-48aa-b289-5d3ca6320c52","instanceId":"59bdaaff-3998-4fd9-a140-8749beeb605e","tenantId":"99819e6e-4017-4021-9edd-ea1bdf4dbd59","controllerMachineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerMachineType":"x86_64","hwSkuDeviceType":"cpu","vendor":"Lenovo","productName":"ThinkSystem SR670 V2","serialNumber":"J1060ACR.D3KS2CS001G","machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4},{"type":"Network","name":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","count":2,"deviceType":"DPU"},{"type":"Storage","name":"Dell Ent NVMe CM6 RI 1.92TB","capacity":"1.92TB","count":2,"deviceType":"DPU"},{"type":"GPU","name":"NVIDIA A100 PCIe","capacity":"80GB","count":2},{"type":"InfiniBand","name":"MT28908 Family [ConnectX-6]","vendor":"Mellanox Technologies","count":2}],"machineInterfaces":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerInterfaceId":"ad3dac49-741d-4c1f-815c-c020127c532f","controllerSegmentId":"f2207a3c-1847-42e5-bf2c-cd015f87a2bc","attachedDpuMachineID":"fm100dsg4ekcb4sdi6hkqn0iojhj18okrr8vct64luh8957lfe8e69vme20,","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","hostname":"example.com","isPrimary":true,"macAddress":"00:00:5e:00:53:af","ipAddresses":["192.156.7.23","202.88.37.112"],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"maintenanceMessage":null,"labels":{"RackIdentifier":"GVX11F01C02","ServerName":"SITE1-C03-Server-02"},"health":{"source":"aggregate-host-health","observedAt":null,"successes":[{"id":"BgpDaemonEnabled","target":null},{"id":"BgpStats","target":null},{"id":"DhcpServer","target":null},{"id":"DpuDiskUtilizationCheck","target":null},{"id":"FanSpeed","target":"System Board Fan1A"},{"id":"PowerSupply","target":"PS1 Status"},{"id":"Temperature","target":"CPU1 Temp"},{"id":"Temperature","target":"System Board Exhaust Temp"},{"id":"Voltage","target":"CPU1 1P8 PG"}],"alerts":[]},"metadata":{"dmiData":{"boardName":"7Z23CTOLWB","boardSerial":".C1KS2CS002G.","boardVersion":"06","biosDate":"03/30/2023","biosVersion":"U8E122J-1.51","productSerial":"J1050ACR","chassisSerial":"J1050ACR"},"bmcInfo":{"ip":"10.217.133.5","mac":"C8:4B:D6:7A:C9:8A","version":"1","firmwareRevision":"6.00"},"gpus":[{"name":"NVIDIA H100 PCIe","serial":"1654422006434","driverVersion":"530.30.02s","vbiosVersion":"96.00.30.00.01","inforomVersion":"1010.0200.00.02","totalMemory":"81559 MiB","frequency":"1755 MHz","pciBusId":"00000000:17:00.0"}],"networkInterfaces":[{"macAddress":"c8:4b:d6:7b:ac:a8","vendor":"Broadcom Inc. and subsidiaries","device":"NetXtreme BCM5720 Gigabit Ethernet PCIe (PowerEdge Rx5xx LOM Board)","path":"/devices/pci0000:00/0000:00:1c.5/0000:04:00.0/net/eno8303","numaNode":0,"description":"NetXtreme BCM5720 Gigabit Ethernet PCIe (PowerEdge Rx5xx LOM Board)","slot":"0000:04:00.0"}],"infinibandInterfaces":[{"guid":"1070fd0300bd43ac","vendor":"Mellanox Technologies","device":"MT28908 Family [ConnectX-6]","path":"/devices/pci0000:c9/0000:c9:02.0/0000:ca:00.0/infiniband/ibp202s0f0","numaNode":1,"description":"MT28908 Family [ConnectX-6]","slot":"0000:ca:00.0"}]},"status":"Ready","isUsableByTenant":true,"statusHistory":[{"status":"Ready","message":"Machine is online and ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}},"With Machine Health Alerts":{"value":{"id":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"2e016c02-2c67-48aa-b289-5d3ca6320c52","instanceId":"59bdaaff-3998-4fd9-a140-8749beeb605e","tenantId":"99819e6e-4017-4021-9edd-ea1bdf4dbd59","controllerMachineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerMachineType":"x86_64","hwSkuDeviceType":"cpu","vendor":"Lenovo","productName":"ThinkSystem SR670 V2","serialNumber":"J1060ACR.D3KS2CS001G","machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4},{"type":"Network","name":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","count":2,"deviceType":"DPU"},{"type":"Storage","name":"Dell Ent NVMe CM6 RI 1.92TB","capacity":"1.92TB","count":2},{"type":"GPU","name":"NVIDIA A100 PCIe","capacity":"80GB","count":2},{"type":"InfiniBand","name":"MT28908 Family [ConnectX-6]","vendor":"Mellanox Technologies","count":2}],"machineInterfaces":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerInterfaceId":"ad3dac49-741d-4c1f-815c-c020127c532f","controllerSegmentId":"f2207a3c-1847-42e5-bf2c-cd015f87a2bc","attachedDpuMachineID":"fm100dsg4ekcb4sdi6hkqn0iojhj18okrr8vct64luh8957lfe8e69vme20,","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","hostname":"example.com","isPrimary":true,"macAddress":"00:00:5e:00:53:af","ipAddresses":["192.156.7.23","202.88.37.112"],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"maintenanceMessage":null,"labels":{"RackIdentifier":"GVX11F01C02","ServerName":"SITE1-C03-Server-02"},"health":{"source":"aggregate-host-health","observedAt":"2024-10-07T18:08:46.715956831Z","successes":[{"id":"BgpDaemonEnabled","target":null},{"id":"FanSpeed","target":"System Board Fan1A"},{"id":"FanSpeed","target":"System Board Fan2A"},{"id":"FanSpeed","target":"System Board Fan3A"},{"id":"FanSpeed","target":"System Board Fan4A"},{"id":"FanSpeed","target":"System Board Fan5A"},{"id":"FanSpeed","target":"System Board Fan6A"},{"id":"FileExists","target":"/var/lib/hbn/etc/frr/daemons"},{"id":"PowerSupply","target":"PS2 Status"},{"id":"Voltage","target":"System Board PS1 PG FAIL"},{"id":"Temperature","target":"GPU Temp 2"},{"id":"Temperature","target":"CPU1 Temp"}],"alerts":[{"id":"HeartbeatTimeout","target":"hardware-health","inAlertSince":"2024-10-07T18:08:46.715149530Z","message":"","tenantMessage":"nil","classifications":["PreventAllocations","PreventHostStateChanges"]},{"id":"HeartbeatTimeout","target":"nico-dpu-agent","inAlertSince":"2024-10-07T18:08:46.716147472Z","message":"","tenantMessage":"nil","classifications":["PreventAllocations","PreventHostStateChanges"]}]},"status":"Error","isUsableByTenant":false,"statusHistory":[{"status":"Error","message":"Machine has one or more health alerts that prevent allocation","created":"2019-08-28T14:15:22Z","updated":"2019-08-28T14:15:22Z"},{"status":"Ready","message":"Machine is online and ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-machine","description":"Org must have either an Infrastructure Provider entity or a Tenant entity.\n\nIf org has an Infrastructure Provider entity, then a user with `PROVIDER_ADMIN` role can request details for any Machine on any Site owned by the Provider.\n\nIf org has a Tenant entity, then a user with `TENANT_ADMIN` role can request details for any Machine associated with Tenant's active Instances.\n","parameters":[{"schema":{"type":"string","enum":["InfrastructureProvider","Site","InstanceType"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"boolean"},"in":"query","name":"includeMetadata","description":"Include Machine metadata e.g. BMC, DPU, GPU and Interface data. Can only be requested by Provider."}]},"patch":{"summary":"Update Machine","operationId":"update-machine","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Machine"},"examples":{"Example 1":{"value":{"id":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"2e016c02-2c67-48aa-b289-5d3ca6320c52","instanceId":"59bdaaff-3998-4fd9-a140-8749beeb605e","tenantId":"99819e6e-4017-4021-9edd-ea1bdf4dbd59","controllerMachineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerMachineType":"x86_64","hwSkuDeviceType":"cpu","vendor":"Lenovo","productName":"ThinkSystem SR670 V2","serialNumber":"J1060ACR.D3KS2CS001G","machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4}],"machineInterfaces":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerInterfaceId":"ad3dac49-741d-4c1f-815c-c020127c532f","controllerSegmentId":"f2207a3c-1847-42e5-bf2c-cd015f87a2bc","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","hostname":"example.com","isPrimary":true,"macAddress":"00:00:5e:00:53:af","ipAddresses":["192.156.7.23","202.88.37.112"],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"maintenanceMessage":null,"health":{"source":"aggregate-host-health","observedAt":null,"successes":[{"id":"BgpDaemonEnabled","target":null},{"id":"BgpStats","target":null},{"id":"DhcpServer","target":null},{"id":"DpuDiskUtilizationCheck","target":null},{"id":"FanSpeed","target":"System Board Fan1A"},{"id":"PowerSupply","target":"PS1 Status"},{"id":"Temperature","target":"CPU1 Temp"},{"id":"Temperature","target":"System Board Exhaust Temp"},{"id":"Voltage","target":"CPU1 1P8 PG"}],"alerts":[]},"labels":{"RackIdentifier":"GVX11F01C02","ServerName":"SITE1-C03-Server-02"},"status":"Ready","isUsableByTenant":true,"statusHistory":[{"status":"Ready","message":"Machine is online and ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}}},"tags":["Machine"],"description":"Update a Machine\n\nInstance Type attribute updates, maintenance attribute updates and labels updates must be specified in separate requests. They cannot be processed at the same time.\n\nSome attributes can only be updated by Provider, while others can be updated by Provider or a Privileged Tenant.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MachineUpdateRequest"},"examples":{"Update Instance Type":{"value":{"instanceTypeId":"2e016c02-2c67-48aa-b289-5d3ca6320c52"}},"Clear Instance Type":{"value":{"clearInstanceType":true}},"Set Maintenance Message":{"value":{"setMaintenanceMode":true,"maintenanceMessage":"Machine requires re-cabling to connect with revised underlay network. Estimated maintenance time is 2 days"}},"Remove Maintenance Message":{"value":{"setMaintenanceMode":false}},"Update Labels":{"value":{"labels":{"RackIdentifier":"GVX11F01C02","ServerName":"SITE1-C03-Server-02","RepairStatus":"InProgress"}}}}}}}},"delete":{"tags":["Machine"],"summary":"Delete a Machine from a Site","operationId":"delete-machine","responses":{"202":{"description":"Accepted"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"description":"Describes an error response for 404 Not Found","$ref":"#/components/responses/GenericHttpError"},"422":{"description":"Describes an error response for 422 Unprocessable Content","$ref":"#/components/responses/GenericHttpError"},"500":{"description":"Describes an error response for 500 Internal Server Error","$ref":"#/components/responses/GenericHttpError"}},"description":"Org must have an Infrastructure Provider entity. Machine must belong to the Provider. User must have authorization role with `PROVIDER_ADMIN` suffix. Machine must meet certain criteria to be eligible for deletion."}},"/v2/org/{org}/nico/machine/{machineId}/status-history":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"machineId","in":"path","required":true,"description":"ID of the Machine"}],"get":{"summary":"Retrieve Machine status history","tags":["Machine"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"examples":{"Example 1":{"value":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-machine-status-history","description":"Org must have either an Infrastructure Provider entity or a Tenant entity.\n\nIf org has an Infrastructure Provider entity, then a user with `PROVIDER_ADMIN` role can request details for any Machine on any Site owned by the Provider.\n\nIf org has a Tenant entity, then a user with `TENANT_ADMIN` role can request details for any Machine associated with Tenant's active Instances.\n","parameters":[{"schema":{"type":"integer"},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer"},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string"},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/machine/gpu/stats":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve GPU stats for machines at a site","tags":["Machine"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MachineGPUStats"}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-machine-gpu-stats","description":"Returns GPU summary stats grouped by GPU name for machines at the specified site.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix. The specified site must belong to the Provider.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","required":true,"description":"ID of the Site"}]}},"/v2/org/{org}/nico/machine/instance-type/stats/summary":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve machine instance type assignment summary for a site","tags":["Machine"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MachineInstanceTypeSummary"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-machine-instance-type-stats-summary","description":"Returns machine counts grouped by assigned (has instance type) vs unassigned, broken down by status.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix. The specified site must belong to the Provider.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","required":true,"description":"ID of the Site"}]}},"/v2/org/{org}/nico/machine/instance-type/stats":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve detailed per-instance-type machine stats for a site","tags":["Machine"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MachineInstanceTypeStats"}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-machine-instance-type-stats","description":"Returns machine stats for each instance type including allocation details and tenant breakdown.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix. The specified site must belong to the Provider.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","required":true,"description":"ID of the Site"}]}},"/v2/org/{org}/nico/tenant/instance-type/stats":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve per-tenant instance type allocation stats for a site","tags":["Tenant"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TenantInstanceTypeStats"}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-tenant-instance-type-stats","description":"Returns instance type allocation stats grouped by tenant for the specified site.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix. The specified site must belong to the Provider.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","required":true,"description":"ID of the Site"}]}},"/v2/org/{org}/nico/machine-capability":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Machine Capabilities","tags":["Machine"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MachineCapability"}},"examples":{"Example 1":{"value":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","cores":18,"threads":36,"count":2},{"name":"Intel(R) Xeon(R) Platinum 8362 CPU @ 2.80GHz","cores":32,"threads":64,"count":2},{"type":"Network","name":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","count":2},{"type":"Storage","name":"Dell Ent NVMe v2 AGN RI U.2 1.92TB","capacity":"1.92TB","count":2},{"type":"Storage","name":"Dell Ent NVMe CM6 RI 1.92TB","capacity":"1.92TB","count":2},{"type":"InfiniBand","name":"MT28908 Family [ConnectX-6]","vendor":"Mellanox Technologies","count":2}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-machine-capabilities","description":"Get all distinct Machine Capabilities across all Machines\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n","parameters":[{"schema":{"type":"string"},"in":"query","name":"siteId","description":"Filter Capabilities by Machines from a particular Site","required":true},{"schema":{"type":"boolean"},"in":"query","name":"hasInstanceType","description":"Filter Capabilities by Machines that have an Instance Type"},{"schema":{"type":"string"},"in":"query","name":"type","description":"Filter Capabilities by Type"},{"schema":{"type":"string"},"in":"query","name":"name","description":"Filter Capabilities by Name"},{"schema":{"type":"string"},"in":"query","name":"frequency","description":"Filter Capabilities by Frequency value"},{"schema":{"type":"string"},"in":"query","name":"capacity","description":"Filter Capabilities by Capacity value"},{"schema":{"type":"string"},"in":"query","name":"vendor","description":"Filter Capabilities by Vendor"},{"schema":{"type":"string"},"in":"query","name":"inactiveDevices","description":"Filter Capabilities by Inactive Devices value. Since the value is an array, multiple query params should be specified in correct order in order to filter. For example, to filter for [1, 3], specify inactiveDevices=1&inactiveDevices=3"},{"schema":{"type":"string"},"in":"query","name":"count","description":"Filter Capabilities by Count"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/rack":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Racks","operationId":"get-all-rack","description":"Get all Racks for the specified Site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site to retrieve Racks from"},{"schema":{"type":"boolean"},"in":"query","name":"includeComponents","description":"Include rack components in response"},{"schema":{"type":"string"},"in":"query","name":"name","description":"Filter by rack name"},{"schema":{"type":"string"},"in":"query","name":"manufacturer","description":"Filter by manufacturer"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","MANUFACTURER_ASC","MANUFACTURER_DESC","MODEL_ASC","MODEL_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Rack"}},"examples":{"example-1":{"value":[{"id":"550e8400-e29b-41d4-a716-446655440000","name":"Rack-01","manufacturer":"Dell","model":"PowerEdge R750","serialNumber":"SN-RACK-001","description":"Primary compute rack","location":{"region":"us-east-1","datacenter":"DC-01","room":"Room-A","position":"A1"},"components":[{"id":"660e8400-e29b-41d4-a716-446655440001","componentId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","type":"ComponentTypeCompute","name":"Server-01","serialNumber":"SN-SRV-001","manufacturer":"Dell","firmwareVersion":"2.1.0","slotId":1,"trayIdx":0,"hostId":0,"bmcs":[{"type":"BmcTypeHost","macAddress":"AA:BB:CC:DD:EE:01","ipAddress":"10.0.0.101"}],"powerState":"on"}]}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\":\"NAME_ASC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/{id}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Rack"}],"get":{"summary":"Retrieve a Rack","operationId":"get-rack","description":"Get a Rack by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site"},{"schema":{"type":"boolean"},"in":"query","name":"includeComponents","description":"Include rack components in response"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Rack"},"examples":{"example-1":{"value":{"id":"550e8400-e29b-41d4-a716-446655440000","name":"Rack-01","manufacturer":"Dell","model":"PowerEdge R750","serialNumber":"SN-RACK-001","description":"Primary compute rack","location":{"region":"us-east-1","datacenter":"DC-01","room":"Room-A","position":"A1"},"components":[{"id":"660e8400-e29b-41d4-a716-446655440001","componentId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","type":"ComponentTypeCompute","name":"Server-01","serialNumber":"SN-SRV-001","manufacturer":"Dell","firmwareVersion":"2.1.0","slotId":1,"trayIdx":0,"hostId":0,"bmcs":[{"type":"BmcTypeHost","macAddress":"AA:BB:CC:DD:EE:01","ipAddress":"10.0.0.101"}],"powerState":"on"}]}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/validation":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Validate Racks","operationId":"validate-racks","description":"Validate Rack components by comparing expected vs actual state.\n\nIf no filter is specified, validates all racks in the Site. Filters can narrow the scope to specific racks by name or manufacturer.\n\nCompares the expected component configuration against the actual state. Returns a detailed diff report showing missing, extra, and mismatched components.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site"},{"schema":{"type":"string"},"name":"name","in":"query","required":false,"description":"Filter racks by name"},{"schema":{"type":"string"},"name":"manufacturer","in":"query","required":false,"description":"Filter racks by manufacturer"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RackValidationResult"},"examples":{"example-no-diffs":{"value":{"diffs":[],"totalDiffs":0,"missingCount":0,"unexpectedCount":0,"mismatchCount":0,"matchCount":10}},"example-with-diffs":{"value":{"diffs":[{"type":"Missing","id":"660e8400-e29b-41d4-a716-446655440001","componentId":"comp-1","expected":{"id":"660e8400-e29b-41d4-a716-446655440001","componentId":"comp-1","type":"ComponentTypeCompute","name":"Server-01","serialNumber":"SN-SRV-001","manufacturer":"Dell","firmwareVersion":"2.1.0","slotId":1,"trayIdx":0,"hostId":0,"bmcs":[{"type":"BmcTypeHost","macAddress":"AA:BB:CC:DD:EE:01","ipAddress":"10.0.0.101"}],"powerState":"on"}},{"type":"Mismatch","id":"770e8400-e29b-41d4-a716-446655440002","componentId":"comp-2","fieldDiffs":[{"fieldName":"firmware_version","expectedValue":"1.0.0","actualValue":"2.0.0"}]}],"totalDiffs":2,"missingCount":1,"unexpectedCount":0,"mismatchCount":1,"matchCount":8}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/{id}/validation":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Rack"}],"get":{"summary":"Validate a Rack","operationId":"validate-rack","description":"Validate a Rack's components by comparing expected vs actual state.\n\nCompares the rack's expected component configuration against the actual state. Returns a detailed diff report showing missing, extra, and mismatched components.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RackValidationResult"},"examples":{"example-no-diffs":{"value":{"diffs":[],"totalDiffs":0,"missingCount":0,"unexpectedCount":0,"mismatchCount":0,"matchCount":5}},"example-with-diffs":{"value":{"diffs":[{"type":"Missing","id":"660e8400-e29b-41d4-a716-446655440001","componentId":"comp-1","expected":{"id":"660e8400-e29b-41d4-a716-446655440001","componentId":"comp-1","type":"ComponentTypeCompute","name":"Server-01","serialNumber":"SN-SRV-001","manufacturer":"Dell","firmwareVersion":"2.1.0","slotId":1,"trayIdx":0,"hostId":0,"bmcs":[{"type":"BmcTypeHost","macAddress":"AA:BB:CC:DD:EE:01","ipAddress":"10.0.0.101"}],"powerState":"on"}},{"type":"Mismatch","id":"770e8400-e29b-41d4-a716-446655440002","componentId":"comp-2","fieldDiffs":[{"fieldName":"firmware_version","expectedValue":"1.0.0","actualValue":"2.0.0"}]}],"totalDiffs":2,"missingCount":1,"unexpectedCount":0,"mismatchCount":1,"matchCount":3}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/power":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"patch":{"summary":"Power control Racks","operationId":"power-control-racks","description":"Power control Racks with optional filters. If no filter is specified, targets all racks in the Site.\n\nSupported power states: `on`, `off`, `cycle`, `forceoff`, `forcecycle`.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchUpdateRackPowerStateRequest"},"examples":{"power-off-all":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"off"}},"power-on-filtered":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","filter":{"names":["Rack-001","Rack-002"]},"state":"on"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePowerStateResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000","660e8400-e29b-41d4-a716-446655440001"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/{id}/power":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Rack"}],"patch":{"summary":"Power control a Rack","operationId":"power-control-rack","description":"Power control a Rack identified by Rack UUID.\n\nSupported power states: `on`, `off`, `cycle`, `forceoff`, `forcecycle`.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePowerStateRequest"},"examples":{"power-on":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"on"}},"power-cycle":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"cycle"}},"force-cycle":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"forcecycle"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePowerStateResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/firmware":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"patch":{"summary":"Firmware update Racks","operationId":"firmware-update-racks","description":"Update firmware on Racks with optional name filter. If no filter is specified, targets all racks in the Site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchRackFirmwareUpdateRequest"},"examples":{"all-racks-latest":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000"}},"filtered-with-version":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","filter":{"names":["Rack-001"]},"version":"24.11.0"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirmwareUpdateResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000","660e8400-e29b-41d4-a716-446655440001"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/{id}/firmware":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Rack"}],"patch":{"summary":"Firmware update a Rack","operationId":"firmware-update-rack","description":"Update firmware on a Rack identified by Rack UUID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirmwareUpdateRequest"},"examples":{"with-version":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","version":"24.11.0"}},"without-version":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirmwareUpdateResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/bringup":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Bring up Racks","operationId":"bringup-racks","description":"Bring up Racks with optional name filter. If no filter is specified, targets all racks in the Site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchBringUpRackRequest"},"examples":{"all-racks":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000"}},"filtered":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","filter":{"names":["Rack-001"]},"description":"Bring up Rack-001"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BringUpRackResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000","660e8400-e29b-41d4-a716-446655440001"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/{id}/bringup":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Rack"}],"post":{"summary":"Bring up a Rack","operationId":"bringup-rack","description":"Bring up a Rack identified by Rack UUID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BringUpRackRequest"},"examples":{"basic":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000"}},"with-description":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","description":"Initial bring up for production rack"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BringUpRackResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/task/{id}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"UUID of the Task"}],"get":{"summary":"Retrieve a Task","operationId":"get-rack-task","description":"Get a Task by UUID.\n\nTasks are site-scoped; `siteId` must be the Site where the task was created.\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site that owns the task (tasks are site-scoped)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RackTask"},"examples":{"example-1":{"value":{"id":"550e8400-e29b-41d4-a716-446655440000","status":"Running","description":"Power on rack components","message":"Processing 3 of 5 components"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/task/{id}/cancel":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"UUID of the Task"}],"post":{"summary":"Cancel a Task","operationId":"cancel-rack-task","description":"Cancel a Task.\n\nCancellation is best-effort and idempotent: tasks in non-terminal\nstates (`Pending`, `Running`, `Waiting`) are marked `Terminated`\nand any underlying Temporal workflow is terminated. Cancelling an\nalready-`Terminated` task returns the same task without changes.\nTasks that have already finished (`Succeeded` or `Failed`) cannot\nbe cancelled.\n\nTasks are site-scoped; `siteId` must be the Site where the task was\ncreated. Org must have an Infrastructure Provider entity. User must\nhave `FORGE_PROVIDER_ADMIN` authorization role.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site that owns the task (tasks are site-scoped)."}}},"examples":{"example-1":{"value":{"siteId":"660e8400-e29b-41d4-a716-446655440000"}}}}}},"responses":{"202":{"description":"Accepted. The cancellation request was accepted and the task as\nlast reported by Flow is returned. Clients should `GET` the task\nto observe the final state, since cancellation is best-effort\nand the underlying workflow may still be terminating.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RackTask"},"examples":{"example-1":{"value":{"id":"550e8400-e29b-41d4-a716-446655440000","status":"Terminated","description":"Power on rack components","message":"Cancelled by user"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/tray":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Trays","operationId":"get-all-tray","description":"Get all Trays (components) for the specified Site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\n**Filter constraints:**\n- `rackId` and `rackName` are mutually exclusive\n- `rackId`/`rackName` cannot be combined with `id`/`componentId` (rack-level vs component-level targeting)\n- `componentId` requires `type` to be specified","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site to retrieve Trays from"},{"schema":{"type":"string","format":"uuid"},"name":"rackId","in":"query","description":"Filter by Rack ID"},{"schema":{"type":"string"},"name":"rackName","in":"query","description":"Filter by Rack name"},{"schema":{"type":"string","enum":["compute","switch","powershelf"]},"name":"type","in":"query","description":"Filter by tray type"},{"schema":{"type":"string"},"name":"componentId","in":"query","description":"Filter by component ID. Can be specified multiple times to filter on more than one component ID. Requires 'type' parameter."},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"query","description":"Filter by tray UUID. Can be specified multiple times to filter on more than one tray ID."},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","MANUFACTURER_ASC","MANUFACTURER_DESC","MODEL_ASC","MODEL_DESC","TYPE_ASC","TYPE_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Tray"}},"examples":{"example-1":{"value":[{"id":"660e8400-e29b-41d4-a716-446655440001","componentId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","type":"compute","name":"compute-tray-1","manufacturer":"NVIDIA","model":"GB200","serialNumber":"TSN001","description":"Compute tray in slot 1","firmwareVersion":"2.1.0","powerState":"on","position":{"slotId":1,"trayIdx":0,"hostId":1},"rackId":"550e8400-e29b-41d4-a716-446655440000"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\":\"NAME_ASC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/tray/{id}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Tray"}],"get":{"summary":"Retrieve a Tray","operationId":"get-tray","description":"Get a Tray by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tray"},"examples":{"example-1":{"value":{"id":"660e8400-e29b-41d4-a716-446655440001","componentId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","type":"compute","name":"compute-tray-1","manufacturer":"NVIDIA","model":"GB200","serialNumber":"TSN001","description":"Compute tray in slot 1","firmwareVersion":"2.1.0","powerState":"on","position":{"slotId":1,"trayIdx":0,"hostId":1},"rackId":"550e8400-e29b-41d4-a716-446655440000"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/tray/validation":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Validate Trays","operationId":"validate-trays","description":"Validate Tray components by comparing expected vs actual state.\n\nIf no filter is specified, validates all trays in the Site. Use rackId/rackName to scope to a specific rack, and name/manufacturer/type to filter by tray attributes.\n\nCompares the expected component configuration against the actual state. Returns a detailed diff report showing missing, extra, and mismatched components.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site"},{"schema":{"type":"string","format":"uuid"},"name":"rackId","in":"query","required":false,"description":"Scope to a specific Rack by ID (mutually exclusive with rackName)"},{"schema":{"type":"string"},"name":"rackName","in":"query","required":false,"description":"Scope to a specific Rack by name (mutually exclusive with rackId)"},{"schema":{"type":"string"},"name":"name","in":"query","required":false,"description":"Filter trays by name"},{"schema":{"type":"string"},"name":"manufacturer","in":"query","required":false,"description":"Filter trays by manufacturer"},{"schema":{"type":"string","enum":["compute","switch","powershelf"]},"name":"type","in":"query","required":false,"description":"Filter trays by type"},{"schema":{"type":"string"},"name":"componentId","in":"query","required":false,"description":"Filter by external component ID (requires type; mutually exclusive with rackId/rackName; use repeated params for multiple values)"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RackValidationResult"},"examples":{"example-no-diffs":{"value":{"diffs":[],"totalDiffs":0,"missingCount":0,"unexpectedCount":0,"mismatchCount":0,"matchCount":10}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/tray/{id}/validation":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Tray"}],"get":{"summary":"Validate a Tray","operationId":"validate-tray","description":"Validate a Tray by comparing expected vs actual state.\n\nCompares the expected component configuration against the actual state. Returns a detailed diff report showing missing, extra, and mismatched components.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RackValidationResult"},"examples":{"example-no-diffs":{"value":{"diffs":[],"totalDiffs":0,"missingCount":0,"unexpectedCount":0,"mismatchCount":0,"matchCount":5}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/tray/power":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"patch":{"summary":"Power control Trays","operationId":"power-control-trays","description":"Power control Trays with optional filters. If no filter is specified, targets all trays in the Site.\n\nSupported power states: `on`, `off`, `cycle`, `forceoff`, `forcecycle`.\n\n**Filter constraints:**\n- `rackId` and `rackName` are mutually exclusive\n- `rackId`/`rackName` cannot be combined with `ids`/`componentIds` (rack-level vs component-level targeting)\n- `componentIds` requires `type` to be specified\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchUpdateTrayPowerStateRequest"},"examples":{"power-on-all":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"on"}},"power-off-by-rack":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","filter":{"rackId":"660e8400-e29b-41d4-a716-446655440001"},"state":"off"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePowerStateResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/tray/{id}/power":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Tray"}],"patch":{"summary":"Power control a Tray","operationId":"power-control-tray","description":"Power control a Tray identified by Tray UUID.\n\nSupported power states: `on`, `off`, `cycle`, `forceoff`, `forcecycle`.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePowerStateRequest"},"examples":{"power-on":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"on"}},"power-off":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"off"}},"power-cycle":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"cycle"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePowerStateResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/tray/firmware":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"patch":{"summary":"Firmware update Trays","operationId":"firmware-update-trays","description":"Update firmware on Trays with optional filters. If no filter is specified, targets all trays in the Site.\n\n**Filter constraints:**\n- `rackId` and `rackName` are mutually exclusive\n- `rackId`/`rackName` cannot be combined with `ids`/`componentIds` (rack-level vs component-level targeting)\n- `componentIds` requires `type` to be specified\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchTrayFirmwareUpdateRequest"},"examples":{"all-trays-latest":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000"}},"filtered-with-version":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","filter":{"rackId":"660e8400-e29b-41d4-a716-446655440001"},"version":"24.11.0"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirmwareUpdateResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/tray/{id}/firmware":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Tray"}],"patch":{"summary":"Firmware update a Tray","operationId":"firmware-update-tray","description":"Update firmware on a Tray identified by Tray UUID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirmwareUpdateRequest"},"examples":{"with-version":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","version":"24.11.0"}},"without-version":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirmwareUpdateResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/network-security-group":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Network Security Groups","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NetworkSecurityGroup"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"412":{"description":"Precondition Failed"},"500":{"description":"Describes an error response for 500 Internal Server Error","$ref":"#/components/responses/GenericHttpError"},"501":{"description":"Describes an error response for 501 Not Implemented","$ref":"#/components/responses/GenericHttpError"}},"operationId":"get-all-network-security-group","description":"Get all Network Security Groups for Tenant\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter By Site ID"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Network Security Groups by Status"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description and status fields"},{"schema":{"type":"string","enum":["Tenant","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"},{"schema":{"type":"boolean"},"in":"query","name":"includeAttachmentStats","description":"Include counts for the number objects that have attached the Network Security Group"}],"tags":["Network Security Group"]},"post":{"summary":"Create Network Security Group","operationId":"create-network-security-group","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkSecurityGroup"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"description":"Describes an error response for 404 Not Found","$ref":"#/components/responses/GenericHttpError"},"412":{"description":"Describes an error response for 412 Precondition Failed","$ref":"#/components/responses/GenericHttpError"},"500":{"description":"Describes an error response for 500 Internal Server Error","$ref":"#/components/responses/GenericHttpError"},"501":{"description":"Describes an error response for 501 Not Implemented","$ref":"#/components/responses/GenericHttpError"}},"description":"Create a Network Security Group for Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkSecurityGroupCreateRequest"}}}},"tags":["Network Security Group"]}},"/v2/org/{org}/nico/network-security-group/{networkSecurityGroupId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"networkSecurityGroupId","in":"path","required":true,"description":"ID of the Network Security Group"}],"get":{"summary":"Retrieve Network Security Group","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkSecurityGroup"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"description":"Describes an error response for 404 Not Found","$ref":"#/components/responses/NotFoundError"},"500":{"description":"Describes an error response for 500 Internal Server Error","$ref":"#/components/responses/GenericHttpError"},"501":{"description":"Describes an error response for 501 Not Implemented","$ref":"#/components/responses/GenericHttpError"}},"operationId":"get-network-security-group","description":"Get a Network Security Group by ID\n\nOrg must have a Tenant entity. Instance must belong to Tenant. User must have authorization role with `TENANT_ADMIN` suffix.\n","parameters":[{"schema":{"type":"string","enum":["Tenant","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}],"tags":["Network Security Group"]},"patch":{"summary":"Update Network Security Group","operationId":"update-network-security-group","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkSecurityGroup"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"description":"Describes an error response for 404 Not Found","$ref":"#/components/responses/GenericHttpError"},"500":{"description":"Describes an error response for 500 Internal Server Error","$ref":"#/components/responses/GenericHttpError"},"501":{"description":"Describes an error response for 501 Not Implemented","$ref":"#/components/responses/GenericHttpError"}},"description":"Update a Network Security Group by ID\n\nOrg must have a Tenant entity. Instance must belong to Tenant. User must have authorization role with `TENANT_ADMIN` suffix.\n\nAfter a group has been created, policy updates are absolute.  The complete desired policy set must be specified.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkSecurityGroupUpdateRequest"}}}},"tags":["Network Security Group"]},"delete":{"summary":"Delete Network Security Group","operationId":"delete-network-security-group","responses":{"202":{"description":"Accepted"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"description":"Describes an error response for 403 Forbidden","$ref":"#/components/responses/GenericHttpError"},"404":{"description":"Describes an error response for 404 Not Found","$ref":"#/components/responses/GenericHttpError"},"412":{"description":"Describes an error response for 412 Precondition Failed","$ref":"#/components/responses/GenericHttpError"},"500":{"description":"Describes an error response for 500 Internal Server Error","$ref":"#/components/responses/GenericHttpError"},"501":{"description":"Describes an error response for 501 Not Implemented","$ref":"#/components/responses/GenericHttpError"}},"description":"Delete a Network Security Group by ID\n\nOrg must have a Tenant entity. Instance must belong to Tenant. User must have authorization role with `TENANT_ADMIN` suffix.\n\nDeleting a Network Security Group will also delete all the associations and all policies.","tags":["Network Security Group"]}},"/v2/org/{org}/nico/dpu-extension-service":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all DPU Extension Services","responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DpuExtensionService"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-dpu-extension-service","description":"Retrieve all DPU Extension Services for the current Tenant\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"siteId","description":"Filter DPU Extension Services by Site ID"},{"schema":{"type":"string","enum":["Pending","Ready","Error","Deleting"]},"in":"query","name":"status","description":"Status filter for the DPU Extension Services"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description and status"},{"schema":{"type":"string","enum":["Site","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"tags":["DPU Extension Service"]},"post":{"summary":"Create DPU Extension Service","operationId":"create-dpu-extension-service","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DpuExtensionService"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create a DPU Extension Service for the current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DpuExtensionServiceCreateRequest"}}}},"tags":["DPU Extension Service"]}},"/v2/org/{org}/nico/dpu-extension-service/{dpuExtensionServiceId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"dpuExtensionServiceId","in":"path","required":true,"description":"ID of the DPU Extension Service"}],"get":{"summary":"Retrieve DPU Extension Service","operationId":"get-dpu-extension-service","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DpuExtensionService"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Retrieve a DPU Extension Service for the current Tenant by ID\n\nDPU Extension Service must be owned by current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["DPU Extension Service"]},"delete":{"summary":"Delete DPU Extension Service","operationId":"delete-dpu-extension-service","responses":{"204":{"description":"No Content"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a specific DPU Extension Service by ID. All versions will be deleted.\n\nDPU Extension Service must be owned by current Tenant. No versions of the DPU Extension Service can have active deployments.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["DPU Extension Service"]},"patch":{"summary":"Update DPU Extension Service","operationId":"update-dpu-extension-service","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DpuExtensionService"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"description":"Update a specific DPU Extension Service.\n\nDPU Extension Service must be owned by current Tenant. A new version will be created if data or credentials are modified.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DpuExtensionServiceUpdateRequest"}}}},"tags":["DPU Extension Service"]}},"/v2/org/{org}/nico/dpu-extension-service/{dpuExtensionServiceId}/version/{version}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"dpuExtensionServiceId","in":"path","required":true,"description":"ID of the DPU Extension Service"},{"schema":{"type":"string"},"name":"version","in":"path","required":true,"description":"Version of the DPU Extension Service"}],"get":{"summary":"Retrieve DPU Extension Service Version","operationId":"get-dpu-extension-service-version","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DpuExtensionServiceVersionInfo"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"description":"Retrieve details for a specific version of a DPU Extension Service.\n\nDPU Extension Service must be owned by current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["DPU Extension Service"]},"delete":{"summary":"Delete DPU Extension Service Version","operationId":"delete-dpu-extension-service-version","responses":{"204":{"description":"No Content"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a specific version of a DPU Extension Service.\n\nDPU Extension Service must be owned by current Tenant. The version being deleted cannot have active deployments.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["DPU Extension Service"]}},"/v2/org/{org}/nico/sshkeygroup":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all SSH Key Groups","responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SshKeyGroup"}},"examples":{"Example 1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","siteAssociations":[{"site":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeys":[{"id":"ff06da79-707a-4069-8623-211d49ae96c8","name":"sre-ssh-reno","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Syncing","statusHistory":[{"status":"Syncing","message":"Group is being synced to Sites","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-ssh-key-group","description":"Retrieve all SSH Key Groups for the current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"siteId","description":"Filter SSH Key Groups by Site ID"},{"schema":{"type":"string"},"in":"query","name":"instanceId","description":"Filter SSH Key Groups by Instance ID"},{"schema":{"type":"string","enum":["Syncing","Synced","Error","Deleting"]},"in":"query","name":"status","description":"Status filter for the SSH Key Groups"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name field"},{"schema":{"type":"string","enum":["Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"tags":["SSH Key Group"]},"post":{"summary":"Create SSH Key Group","operationId":"create-ssh-key-group","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKeyGroup"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","siteAssociations":[{"site":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":true,"networkSecurityGroup":true},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeys":[{"id":"ff06da79-707a-4069-8623-211d49ae96c8","name":"sre-ssh-reno","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Syncing","statusHistory":[{"status":"Syncing","message":"Group is being synced to Sites","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an SSH Key Group for the current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKeyGroupCreateRequest"},"examples":{"Example 1":{"value":{"name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","siteIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyIds":["ff06da79-707a-4069-8623-211d49ae96c8"]}}}}}},"tags":["SSH Key Group"]}},"/v2/org/{org}/nico/sshkeygroup/{sshKeyGroupId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"sshKeyGroupId","in":"path","required":true,"description":"ID of the SSH Key Group"}],"get":{"summary":"Retrieve an SSH Key Group","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKeyGroup"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","siteAssociations":[{"site":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":true,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeys":[{"id":"ff06da79-707a-4069-8623-211d49ae96c8","name":"sre-ssh-reno","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Syncing","statusHistory":[{"status":"Syncing","message":"Group is being synced to Sites","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-ssh-key-group","description":"Retrieve an SSH Key Group for the current Tenant by ID\n\nSSH Key Group must be owned by current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["SSH Key Group"]},"delete":{"summary":"Delete an SSH Key Group","operationId":"delete-ssh-key-group","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a specific SSH key Group.\n\nSSH Key Group must be owned by current Tenant. All Sites associated must be online to proceed.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["SSH Key Group"]},"patch":{"summary":"Update an SSH Key Group","operationId":"update-ssh-key-group","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKeyGroup"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-int-sre","description":"SRE access SSH keys for Reno Integration Site","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","siteAssociations":[{"site":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":true,"networkSecurityGroup":true},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"site":{"id":"05d6e108-9f06-44c9-be47-7ab4d62b20d0","name":"Reno Integration","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":true,"networkSecurityGroup":true},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeys":[{"id":"ff06da79-707a-4069-8623-211d49ae96c8","name":"sre-ssh-reno","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"30fc7238-133d-42f7-8d29-866658b0c019","name":"sre-ssh-reno-ext","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Syncing","statusHistory":[{"status":"Syncing","message":"Group is being synced to Sites","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Update a specific SSH Key Group.\n\nSSH Key Group must be owned by current Tenant. All Sites being added or removed must be online to proceed.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKeyGroupUpdateRequest"},"examples":{"Example 1":{"value":{"name":"reno-int-sre","description":"SRE access SSH keys for Reno Integration Site","siteIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08","05d6e108-9f06-44c9-be47-7ab4d62b20d0"],"sshKeyIds":["ff06da79-707a-4069-8623-211d49ae96c8","30fc7238-133d-42f7-8d29-866658b0c019"],"version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75"}}}}}},"tags":["SSH Key Group"]}},"/v2/org/{org}/nico/sshkey":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all SSH Keys","responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SshKey"}},"examples":{"Example 1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"staging-sre-access","org":"xskkpgqpeakn","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-ssh-key","description":"Retrieve all SSH Keys for the current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["SSH Key"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"sshKeyGroupId","description":"ID of the SSH Key Group"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name field"},{"schema":{"type":"string","enum":["Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create SSH Key","operationId":"create-ssh-key","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKey"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-sre-access","org":"xskkpgqpeakn","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["SSH Key"],"description":"Create an SSH Key for the current Tenant. If an SSH Key Group is specified, all Sites associated with the SSH Key Group must be online.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKeyCreateRequest"},"examples":{"Example 1":{"value":{"name":"reno-sre-access","publicKey":"ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAICip4hl6WjuVHs60PeikVUs0sWE/kPhk2D0rRHWsIuyL jdoe@test.com","sshKeyGroupId":"86ca8cab-b285-4c2d-9e00-25c88810dc2e"}}}}}}}},"/v2/org/{org}/nico/sshkey/{sshKeyId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"sshKeyId","in":"path","required":true,"description":"ID of the SSH Key"}],"get":{"summary":"Retrieve an SSH key","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKey"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"staging-sre-access","org":"xskkpgqpeakn","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-ssh-key","description":"Retrieve an SSH key for the current Tenant by ID\n\nSSH Key must be owned by current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["SSH Key"]},"delete":{"summary":"Delete an SSH Key","operationId":"delete-ssh-key","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete an SSH key for the current Tenant by ID.\n\nSSH Key must be owned by current Tenant. All Site associated with the SSH Key Groups this SSH Key is part of must be online to proceed.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["SSH Key"]},"patch":{"summary":"Update an SSH Key","operationId":"update-ssh-key","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKey"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-sre-access-v2","org":"xskkpgqpeakn","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Update an SSH Key for the current Tenant by ID.\n\nSSH Key must be owned by current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n\nTo add this SSH Key to various SSH Key Groups or remove it from an SSH Key Group, please use SSH Key Group update endpoint.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKeyUpdateRequest"},"examples":{"Example 1":{"value":{"name":"reno-sre-access-v2"}}}}}},"tags":["SSH Key"]}},"/v2/org/{org}/nico/user/current":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve Current User","tags":["User"],"responses":{"200":{"description":"User Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","email":"janed@nvidia.com","firstName":"Jane","lastName":"Doe","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}}},"operationId":"get-user","description":"Retrieve details of the current user."}},"/v2/org/{org}/nico/metadata":{"get":{"summary":"Retrieve metadata about the API server","tags":["Metadata"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Metadata"},"examples":{"example-1":{"value":{"version":"0.1.24","buildTime":"2019-08-24T14:15:22Z"}}}}}}},"operationId":"get-metadata","description":"Retrieve system metadata providing information about the API server"},"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}]},"/v2/org/{org}/nico/audit":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Audit Log Entries","tags":["Audit"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AuditEntry"}},"examples":{"Example 1":{"value":[{"id":"e313b3ca-c47a-4ec1-a79b-a147fad51a50","endpoint":"/v2/org/test-org-1/nico/ep","queryParams":"{\"test\":[\"1234\"]}","method":"POST","body":"{\"key1\":\"value1\"}","statusCode":200,"clientIP":"12.123.43.112","userID":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","user":{"id":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","firstName":"John","lastName":"Doe","email":"jdoe@test.com"},"orgName":"test-org-1","timestamp":"2024-12-04T21:06:33.849293-08:00","durationMs":250,"apiVersion":"0.1.91"},{"id":"e313b3ca-c47a-4ec1-a79b-a147fad51a50","endpoint":"/v2/org/test-org-1/nico/ep","queryParams":"{\"test\":[\"1234\"]}","method":"POST","body":"{\"key1\":\"value1\"}","statusCode":403,"statusMessage":"User does not have permissions","clientIP":"12.123.43.112","userID":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","user":{"id":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","firstName":"John","lastName":"Doe","email":"jdoe@test.com"},"orgName":"test-org-1","timestamp":"2024-12-04T21:06:33.849293-08:00","durationMs":50,"apiVersion":"0.1.91"}]}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-audit-entry","description":"Get all Audit Log entries\n\nUser must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix.\n","parameters":[{"schema":{"type":"boolean"},"in":"query","name":"failedOnly","description":"Return only audit log entries that have failed status code (>= 400)"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["TIMESTAMP_ASC","TIMESTAMP_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/audit/{auditEntryId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"auditEntryId","in":"path","required":true,"description":"ID of the Audit Log Entry"}],"get":{"summary":"Retrieve Audit Log Entry","tags":["Audit"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditEntry"},"examples":{"example-1":{"value":{"id":"e313b3ca-c47a-4ec1-a79b-a147fad51a50","endpoint":"/v2/org/test-org-1/nico/ep","queryParams":"{\"test\":[\"1234\"]}","method":"POST","body":"{\"key1\":\"value1\"}","statusCode":200,"clientIP":"12.123.43.112","userID":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","user":{"id":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","firstName":"John","lastName":"Doe","email":"jdoe@test.com"},"orgName":"test-org-1","timestamp":"2024-12-04T21:06:33.849293-08:00","durationMs":250,"apiVersion":"0.1.91"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-audit-entry","description":"Retrieve a specific Audit Log Entry by ID\n\nUser must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix"}}},"components":{"schemas":{"InfrastructureProvider":{"description":"Infrastructure providers own and manage datacenters","type":"object","title":"InfrastructureProvider","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","org":"rf43bbtnb9c5","orgDisplayName":"Dell Corporation","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"org":{"type":"string"},"orgDisplayName":{"type":["string","null"]},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"InfrastructureProviderStats":{"title":"InfrastructureProviderStats","type":"object","description":"Provide operational stats for Infrastructure Provider","examples":[{"machine":{"total":27,"initializing":8,"assigned":12,"ready":5,"error":2,"decommissioned":0,"unknown":0},"ipBlock":{"total":4,"pending":1,"provisioning":1,"ready":2,"deleting":0,"error":0},"tenantAccount":{"total":8,"pending":0,"invited":3,"ready":5,"error":0}}],"properties":{"machine":{"$ref":"#/components/schemas/MachineCountByStatus"},"ipBlock":{"$ref":"#/components/schemas/IpBlockCountByStatus"},"tenantAccount":{"$ref":"#/components/schemas/TenantAccountCountByStatus"}}},"MachineCountByStatus":{"title":"MachineCountByStatus","type":"object","description":"Describes count of Machines in various statuses","examples":[{"total":27,"initializing":8,"assigned":12,"ready":5,"error":2,"decommissioned":0,"unknown":0}],"properties":{"total":{"type":"integer"},"initializing":{"type":"integer"},"reset":{"type":"integer"},"assigned":{"type":"integer"},"ready":{"type":"integer"},"error":{"type":"integer"},"decommissioned":{"type":"integer"},"unknown":{"type":"integer"}}},"IpBlockCountByStatus":{"title":"IpBlockCountByStatus","type":"object","description":"Describes counts of IP Blocks in various statuses","examples":[{"total":4,"pending":1,"provisioning":1,"ready":2,"deleting":0,"error":0}],"properties":{"total":{"type":"integer"},"pending":{"type":"integer"},"provisioning":{"type":"integer"},"ready":{"type":"integer"},"deleting":{"type":"integer"},"error":{"type":"integer"}}},"TenantAccountCountByStatus":{"title":"TenantAccountCountByStatus","type":"object","description":"Describes counts of Tenant Accounts in various statuses","examples":[{"total":8,"pending":0,"invited":3,"ready":5,"error":0}],"properties":{"total":{"type":"integer"},"pending":{"type":"integer"},"invited":{"type":"integer"},"ready":{"type":"integer"},"error":{"type":"integer"}}},"Tenant":{"title":"Tenant","type":"object","description":"Tenant is the consumer of resources that Infrastructure Providers serve","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","org":"qygdmg8oqik8","orgDisplayName":"Echo Corporation","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z","capabilities":{"targetedInstanceCreation":false}}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique ID of the Tenant","readOnly":true},"org":{"type":"string","description":"Name/external ID of Tenant's organization"},"orgDisplayName":{"type":["string","null"],"description":"Display name of Tenant's organization"},"created":{"type":"string","format":"date-time","description":"Date/time the Tenant was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"Date/time when Tenant was last updated"},"capabilities":{"$ref":"#/components/schemas/TenantCapabilities","description":"Features that are enabled/disabled for Tenant"}}},"TenantCapabilities":{"title":"TenantCapabilities","type":"object","description":"TenantCapabilities defines the set of features enabled for Tenant","examples":[{"targetedInstanceCreation":false}],"properties":{"targetedInstanceCreation":{"type":"boolean","format":"uuid","description":"Indicates whether Tenant can create Instances by specifying Machine ID","readOnly":true}}},"TenantStats":{"title":"TenantStats","type":"object","description":"Provide operational stats for Tenant","examples":[{"instance":{"total":12,"pending":2,"provisioning":1,"ready":8,"terminating":2,"error":1},"vpc":{"total":4,"pending":1,"provisioning":1,"ready":2,"deleting":0,"error":0},"subnet":{"total":4,"pending":1,"provisioning":1,"ready":2,"deleting":0,"error":0}}],"properties":{"instance":{"$ref":"#/components/schemas/InstanceCountByStatus"},"vpc":{"$ref":"#/components/schemas/VpcCountByStatus"},"subnet":{"$ref":"#/components/schemas/SubnetCountByStatus"}}},"InstanceCountByStatus":{"title":"InstanceCountByStatus","type":"object","description":"Describes count of Instances in various statuses","examples":[{"total":12,"pending":2,"provisioning":1,"ready":8,"terminating":2,"error":1}],"properties":{"total":{"type":"integer"},"pending":{"type":"integer"},"provisioning":{"type":"integer"},"ready":{"type":"integer"},"terminating":{"type":"integer"},"error":{"type":"integer"}}},"VpcCountByStatus":{"title":"VpcCountByStatus","type":"object","description":"Describes counts of VPCs in various statuses","examples":[{"total":4,"pending":1,"provisioning":1,"ready":2,"deleting":0,"error":0}],"properties":{"total":{"type":"integer"},"pending":{"type":"integer"},"provisioning":{"type":"integer"},"ready":{"type":"integer"},"deleting":{"type":"integer"},"error":{"type":"integer"}}},"SubnetCountByStatus":{"title":"SubnetCountByStatus","type":"object","description":"Describes counts of Subnets in various statuses","examples":[{"total":4,"pending":1,"provisioning":1,"ready":2,"deleting":0,"error":0}],"properties":{"total":{"type":"integer"},"pending":{"type":"integer"},"provisioning":{"type":"integer"},"ready":{"type":"integer"},"deleting":{"type":"integer"},"error":{"type":"integer"}}},"TenantAccount":{"title":"TenantAccount","type":"object","description":"Associates a Tenant with an Infrastructure Provider","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","infrastructureProviderOrg":"xskkpgqpeakn","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","tenantOrg":"rf43bbtnb9c5","tenantContact":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","email":"janed@nvidia.com","firstName":"Jane","lastName":"Doe","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},"allocationCount":0,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"infrastructureProviderId":{"type":"string","format":"uuid"},"infrastructureProviderOrg":{"type":"string"},"tenantId":{"type":["string","null"],"format":"uuid"},"tenantOrg":{"type":["string","null"]},"tenantContact":{"$ref":"#/components/schemas/User"},"allocationCount":{"type":"integer"},"status":{"$ref":"#/components/schemas/TenantAccountStatus"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"TenantAccountStatus":{"title":"TenantAccountStatus","type":"string","description":"Status values for Tenant Account objects","enum":["Pending","Invited","Ready","Error"]},"TenantAccountCreateRequest":{"title":"TenantAccountCreateRequest","type":"object","description":"Request data to create a TenantAccount","examples":[{"infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantOrg":"rf43bbtnb9c5"}],"properties":{"infrastructureProviderId":{"type":"string","format":"uuid"},"tenantOrg":{"type":"string","pattern":"^[A-Za-z0-9-_]+$","minLength":1,"description":"Must be a valid Org name"}},"required":["infrastructureProviderId","tenantOrg"]},"TenantAccountUpdateRequest":{"title":"TenantAccountUpdateRequest","type":"object","description":"Request data to update a TenantAccount.\n\nNo params needed, an empty request will suffice.","examples":[{}]},"Site":{"title":"Site","type":"object","description":"Site is a datacenter that is running NVIDIA Infra Controller (NICo) services","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"San Jose Central 4","description":"Datacenter serving the San Jose central region","org":"qygdmg8oqik8","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteControllerVersion":"0.1","siteAgentVersion":"0.1","registrationToken":"J7KO-89RR-Y7WQ-AD90","registrationTokenExpiration":"2019-08-25T12:00:00Z","serialConsoleHostname":"sjc.nico.acme.com","isSerialConsoleEnabled":true,"serialConsoleIdleTimeout":60,"serialConsoleMaxSessionLength":3600,"isSerialConsoleSSHKeysEnabled":true,"machineStats":{"total":15,"totalByStatus":{"Initializing":0,"Ready":7,"Reset":0,"Maintenance":0,"InUse":3,"Error":5,"Decommissioned":0,"Unknown":0},"totalByHealth":{"healthy":12,"unhealthy":3},"totalByStatusAndHealth":{"Initializing":{"healthy":0,"unhealthy":0},"Ready":{"healthy":5,"unhealthy":0},"Reset":{"healthy":0,"unhealthy":0},"Maintenance":{"healthy":5,"unhealthy":0},"InUse":{"healthy":3,"unhealthy":0},"Error":{"healthy":2,"unhealthy":3},"Decommissioned":{"healthy":0,"unhealthy":0},"Unknown":{"healthy":0,"unhealthy":0}},"totalByAllocation":{"allocatedInUse":3,"allocatedNotInUse":3,"unallocated":5}},"capabilities":{"nativeNetworking":true,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"isOnline":false,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z","location":{"city":"San Jose","state":"CA","country":"USA"},"contact":{"email":"johndoe@nvidia.com"}}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the Site"},"description":{"type":["string","null"],"description":"Optional description for the Site"},"org":{"type":"string"},"infrastructureProviderId":{"type":"string","format":"uuid"},"siteControllerVersion":{"type":["string","null"],"description":"Version of the Site Controller software"},"siteAgentVersion":{"type":["string","null"],"description":"Version of the Site Agent software"},"registrationToken":{"type":["string","null"],"description":"Token that can be used to register a Site. Value only exposed to Provider"},"registrationTokenExpiration":{"type":["string","null"],"format":"date-time","description":"Date/time when registration token expires. Value only exposed to Provider","readOnly":true},"serialConsoleHostname":{"type":["string","null"],"format":"hostname"},"isSerialConsoleEnabled":{"type":"boolean","description":"Indicates if Serial Console is enabled for the Site by the Provider"},"serialConsoleIdleTimeout":{"type":["integer","null"],"description":"Maximum idle time in seconds before Serial Console is disconnected"},"serialConsoleMaxSessionLength":{"type":["integer","null"],"description":"Maximum length of Serial Console session in seconds"},"isSerialConsoleSSHKeysEnabled":{"type":"boolean","description":"Only visible to Tenant retrieving the Site. Indicates if Serial Console access using SSH Keys is enabled by Tenant"},"isOnline":{"type":"boolean","description":"Indicates if the Site is currently reachable from Cloud"},"status":{"$ref":"#/components/schemas/SiteStatus","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"},"location":{"$ref":"#/components/schemas/SiteLocation"},"contact":{"$ref":"#/components/schemas/SiteContact"},"capabilities":{"$ref":"#/components/schemas/SiteCapabilities"},"machineStats":{"$ref":"#/components/schemas/SiteMachineStats"}}},"SiteSummary":{"title":"SiteSummary","type":"object","description":"SiteSummary contains a subset of data for Site object, used when nesting in other objects","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"San Jose Central 4","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":false,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Pending"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the Site"},"infrastructureProviderId":{"type":"string","format":"uuid"},"isSerialConsoleEnabled":{"type":"boolean","description":"Indicates if Serial Console is enabled for the Site by the Provider"},"isOnline":{"type":"boolean","description":"Indicates if the Site is currently reachable from Cloud"},"capabilities":{"$ref":"#/components/schemas/SiteCapabilities"},"status":{"$ref":"#/components/schemas/SiteStatus","readOnly":true}}},"SiteStatus":{"title":"SiteStatus","type":"string","description":"Status values for Site objects","enum":["Pending","Registered","Error"]},"SiteCapabilities":{"title":"SiteCapabilities","type":"object","description":"Boolean flags to indicate features supported by a Site","properties":{"nativeNetworking":{"type":"boolean"},"networkSecurityGroup":{"type":"boolean"},"nvLinkPartition":{"type":"boolean"},"flow":{"type":"boolean"},"imageBasedOperatingSystem":{"type":"boolean"}}},"SiteMachineStats":{"title":"SiteMachineStats","type":"object","description":"Machine stats for a Site","properties":{"total":{"type":"integer"},"totalByStatus":{"$ref":"#/components/schemas/SiteMachineStatsByStatus"},"totalByHealth":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"},"totalByStatusAndHealth":{"$ref":"#/components/schemas/SiteMachineStatsByStatusAndHealth"},"totalByAllocation":{"$ref":"#/components/schemas/SiteMachineStatsByAllocation"}}},"SiteMachineStatsByAllocation":{"title":"SiteMachineStatsByAllocation","type":"object","description":"Machine stats for a Site by allocation","properties":{"allocatedInUse":{"type":"integer"},"allocatedNotInUse":{"type":"integer"},"unallocated":{"type":"integer"}}},"SiteMachineStatsByHealth":{"title":"SiteMachineStatsByHealth","type":"object","description":"Machine stats for a Site by health","properties":{"healthy":{"type":"integer"},"unhealthy":{"type":"integer"}}},"SiteMachineStatsByStatus":{"title":"SiteMachineStatsByStatus","type":"object","description":"Machine stats for a Site by status","properties":{"Decommissioned":{"type":"integer"},"Error":{"type":"integer"},"Initializing":{"type":"integer"},"InUse":{"type":"integer"},"Maintenance":{"type":"integer"},"Ready":{"type":"integer"},"Reset":{"type":"integer"},"Unknown":{"type":"integer"}}},"SiteMachineStatsByStatusAndHealth":{"title":"SiteMachineStatsByStatusAndHealth","type":"object","description":"Machine stats for a Site by status and health","properties":{"Decommissioned":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"},"Error":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"},"Initializing":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"},"InUse":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"},"Maintenance":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"},"Ready":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"},"Reset":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"},"Unknown":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"}}},"SiteCreateRequest":{"title":"SiteCreateRequest","type":"object","description":"Request data to create a Site","examples":[{"name":"sjc4","description":"Datacenter serving San Jose central region, zone 4","serialConsoleHostname":"nico.acme.com","location":{"city":"San Jose","state":"CA","country":"USA"},"contact":{"email":"johndoe@nvidia.com"}}],"properties":{"name":{"type":"string","description":"Name for the Site","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description for the Site"},"serialConsoleHostname":{"type":["string","null"],"description":"Hostname to reach Serial Console for the Site","format":"hostname"},"location":{"$ref":"#/components/schemas/SiteLocation"},"contact":{"$ref":"#/components/schemas/SiteContact"}},"required":["name"]},"SiteCapabilitiesUpdateRequest":{"title":"SiteCapabilitiesUpdateRequest","type":"object","description":"Request to modify Site's capabilities. Partial update allowed, only specify capabilities that should be updated.","properties":{"nativeNetworking":{"type":["boolean","null"],"description":"Enable or disable native networking for the Site"},"networkSecurityGroup":{"type":["boolean","null"],"description":"Enable or disable network security groups for the Site"},"nvLinkPartition":{"type":["boolean","null"],"description":"Enable or disable NVLink partition support for the Site"},"flow":{"type":["boolean","null"],"description":"Enable or disable NICo Flow for the Site"},"imageBasedOperatingSystem":{"type":["boolean","null"],"description":"Enable or disable image-based operating system support for the Site"}}},"SiteUpdateRequest":{"title":"SiteUpdateRequest","type":"object","description":"Request data to update a Site","examples":[{"name":"sjc04","description":"Datacenter 4 serving central San Jose","renewRegistrationToken":true,"serialConsoleHostname":"sol.nico.acme.com","location":{"city":"San Jose","state":"CA","country":"USA"},"contact":{"email":"johndoe@nvidia.com"}}],"properties":{"name":{"type":["string","null"],"description":"Update name of the Site. Can only be updated by Provider"},"description":{"type":["string","null"],"description":"Update description for the Site. Can only be updated by Provider"},"renewRegistrationToken":{"type":"boolean","description":"Set to true to issue a new registration token. Can only be updated by Provider"},"serialConsoleHostname":{"type":["string","null"],"description":"Hostname to reach Serial Console for the Site. Can only be updated by Provider","format":"hostname"},"isSerialConsoleEnabled":{"type":"boolean","description":"Enable/disable Serial Console. Can only be updated by Provider. Modifying this attribute has no actual effect on SOL. It will be removed in a future API version.","deprecated":true},"serialConsoleIdleTimeout":{"type":"integer","description":"Maximum idle time in seconds before Serial Console is disconnected. Can only be updated by Provider. Modifying this attribute has no actual effect on SOL. It will be removed in a future API version.","deprecated":true},"serialConsoleMaxSessionLength":{"type":"integer","description":"Maximum length of Serial Console session in seconds. Can only be updated by Provider. Modifying this attribute has no actual effect on SOL. It will be removed in a future API version.","deprecated":true},"isSerialConsoleSSHKeysEnabled":{"type":"boolean","description":"Enable/disable Serial Console access using SSH Keys. Previously updateable only by Tenants, modifying this value is no longer supported, update SSH Key Groups to remove Site instead.","deprecated":true},"location":{"$ref":"#/components/schemas/SiteLocation"},"contact":{"$ref":"#/components/schemas/SiteContact"},"capabilities":{"$ref":"#/components/schemas/SiteCapabilitiesUpdateRequest","description":"Modify Site capabilities. Can only be updated by Provider. Partial update allowed, only specify capabilities that should be updated."}}},"SiteLocation":{"title":"SiteLocation","type":"object","description":"Location of the Site","examples":[{"city":"San Jose","state":"CA","country":"USA"}],"properties":{"city":{"type":"string","description":"City where the site is located"},"state":{"type":"string","description":"State where the site is located"},"country":{"type":"string","description":"Country where the site is located"}}},"SiteContact":{"title":"SiteContact","type":"object","description":"Contact for the Site","examples":[{"email":"johndoe@nvidia.com"}],"properties":{"email":{"type":"string","description":"Email address of the Site contact"}}},"Allocation":{"title":"Allocation","type":"object","description":"Specifies a group of resources on a Site that has been allocated to a Tenant","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Echo Studios Allocations","description":"Echo Studios resource allocation in SJC4","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z","allocationConstraints":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}],"properties":{"id":{"type":"string","description":"ID of the Allocation","format":"uuid","readOnly":true},"name":{"type":"string","description":"Concise and descriptive name of the Allocation","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Detailed description of the Allocation"},"infrastructureProviderId":{"type":"string","description":"ID of the Infrastructure Provider that created the Allocation","format":"uuid"},"tenantId":{"type":"string","description":"ID of the Tenant that received the Allocation","format":"uuid"},"siteId":{"type":"string","description":"ID of the Site where resources are allocated","format":"uuid"},"status":{"$ref":"#/components/schemas/AllocationStatus","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"readOnly":true},"allocationConstraints":{"type":"array","items":{"$ref":"#/components/schemas/AllocationConstraint"}},"created":{"type":"string","description":"Date/time when the Allocation was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Allocation was last updated","format":"date-time","readOnly":true}}},"AllocationStatus":{"title":"AllocationStatus","type":"string","description":"Status values for Allocation objects","enum":["Pending","Registered","Deleting","Error"]},"AllocationCreateRequest":{"title":"AllocationCreateRequest","type":"object","description":"Request data to create an Allocation","examples":[{"name":"Echo Studios","description":"Echo Studios resource allocation in SJC4","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","allocationConstraints":[{"resourceType":"InstanceType","resourceTypeId":"bd5a0240-eb62-4bff-91f7-335e6bb86459","constraintType":"Reserved","constraintValue":10}]}],"properties":{"name":{"type":"string","description":"Concise and descriptive name for the Allocation","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Detailed description for the Allocation"},"tenantId":{"type":"string","format":"uuid","description":"ID of the Tenant that should receive the Allocation"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site where resources should be allocated"},"allocationConstraints":{"type":"array","items":{"$ref":"#/components/schemas/AllocationConstraintCreateRequest"}}},"required":["name","tenantId","siteId"]},"AllocationUpdateRequest":{"title":"AllocationUpdateRequest","type":"object","description":"Request data to update an Allocation","examples":[{"name":"Echo Studios Compute","description":"Echo Studios resource allocation in SJC4"}],"properties":{"name":{"type":["string","null"],"description":"Update name of the Allocation","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Update description of the Allocation"}}},"AllocationConstraint":{"title":"AllocationConstraint","type":"object","description":"Constraints on an Allocation that specify limits for different resource types","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"instanceType":{"name":"x3.large","infrastructureProviderId":"63c29416-8833-4eaf-9e1c-7c0173cc3150","siteId":"c9f4f276-6f7a-4209-953c-2b9870ce7cc1","status":"Ready"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"IPBlock","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":20,"derivedResourceId":"6b7d0abe-8403-4e9f-9300-a788d6377648","ipBlock":{"name":"Public Network Overlay for Site SJC4","routingType":"Public","prefix":"202.168.16.0","prefixLength":20,"status":"Ready"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","description":"ID of the Allocation Constraint","format":"uuid","readOnly":true},"allocationId":{"type":"string","format":"uuid","description":"ID of the Allocation that contains the Allocation Constraint"},"resourceType":{"type":"string","description":"Type of the Resource that the Allocation Constraint applies to","enum":["InstanceType","IPBlock"]},"resourceTypeId":{"type":"string","format":"uuid","description":"ID of the Resource Type that acts as the source of the Allocation. For resource type: `InstanceType`, this is the ID of the Instance Type whose associated Machines are allocated to the Tenant. For resource type `IPBlock`, this is the ID of the Site level IP Block from where a prefix is allocated to the Tenant."},"constraintType":{"type":"string","description":"Type of the Allocation Constraint. `Reserved` is the only constraint type supported by current implementation.","enum":["Reserved","OnDemand","Preemptible"]},"constraintValue":{"type":"integer","description":"Value of the Allocation Constraint. For resource type: `InstanceType`, this value represents number of Machines associated with the Instance Type that is allocated to the Tenant. For resource type `IPBlock`, this value represents the prefix length of the IP Block allocated to the Tenant."},"derivedResourceId":{"type":["string","null"],"description":"ID of the allocated Tenant IP Block when resource type is IPBlock"},"instanceType":{"$ref":"#/components/schemas/InstanceTypeSummary"},"ipBlock":{"$ref":"#/components/schemas/IpBlockSummary"},"created":{"type":"string","description":"Date/time when the Allocation Constraint was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Allocation Constraint was last updated","format":"date-time","readOnly":true}}},"AllocationConstraintCreateRequest":{"title":"AllocationConstraintCreateRequest","type":"object","description":"Request data to create an AllocationConstraint","examples":[{"resourceType":"InstanceType","resourceTypeId":"bd5a0240-eb62-4bff-91f7-335e6bb86459","constraintType":"Reserved","constraintValue":10},{"resourceType":"IPBlock","resourceTypeId":"67de813e-37ec-4ff3-ae38-c22351855de8","constraintType":"Reserved","constraintValue":24}],"properties":{"resourceType":{"type":"string","description":"Type of the Resource that the Allocation Constraint applies to","enum":["InstanceType","IPBlock"]},"resourceTypeId":{"type":"string","format":"uuid","description":"ID of the Resource Type that the Allocation Constraint applies to. For InstanceType, this is the ID of the Instance Type. For IPBlock, this is the ID of the IP Block."},"constraintType":{"type":"string","description":"Type of the Allocation Constraint. Please note that OnDemand and Preemptible are not supported by current implementation.","enum":["Reserved","OnDemand","Preemptible"]},"constraintValue":{"type":"integer","description":"Value of the Allocation Constraint. For InstanceType, this value represents number of Machines allocated for Tenant. For IPBlock, this value represents the prefix Length of the IP Block."}},"required":["resourceType","resourceTypeId","constraintType","constraintValue"]},"AllocationConstraintUpdateRequest":{"title":"AllocationConstraintUpdateRequest","type":"object","description":"Request data to update an AllocationConstraint","examples":[{"constraintValue":10}],"properties":{"constraintValue":{"type":"integer","description":"Value of the Allocation Constraint. For InstanceType, this value represents number of Machines allocated for Tenant. For IPBlock, this value represents the prefix Length of the IP Block."}},"required":["constraintValue"]},"VPC":{"title":"VPC","type":"object","description":"VPCs are grouping constructs that bind resources together","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-vpc","description":"Virtual network for machines executing Spark jobs","org":"xskkpgqpeakn","tenantId":"34f5c98e-f430-457b-a812-92637d0c6fd0","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","labels":{"region":"us-west-1","env":"dev"},"controllerVpcId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","networkVirtualizationType":"ETHERNET_VIRTUALIZER","requestedVni":12001,"vni":12001,"networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e","networkSecurityGroupPropagationDetails":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","detailedStatus":"Partial","status":"Synchronizing","details":"","unpropagatedInstanceIds":["b1a5a05e-303c-11f0-b618-7f2e7f9b64ed"],"relatedInstanceIds":["b1a5a05e-303c-11f0-b618-7f2e7f9b64ed"]},"nvLinkLogicalPartitionId":"dd887330-dbd3-45ce-b400-c42fc8e47315","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the VPC"},"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the VPC"},"description":{"type":["string","null"],"description":"Description of the VPC, can be empty"},"org":{"type":"string","readOnly":true,"description":"Organization the VPC belongs to"},"tenantId":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the Tenant the VPC belongs to"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site the VPC belongs to"},"controllerVpcId":{"type":["string","null"],"format":"uuid","description":"Legacy attribute, contains the same value as ID"},"networkVirtualizationType":{"type":["string","null"],"enum":["ETHERNET_VIRTUALIZER","FNN"],"description":"Network virtualization type of the VPC"},"routingProfile":{"type":["string","null"],"minLength":3,"maxLength":64,"description":"Routing profile type for the VPC. Populated when Site has Native Networking enabled and network virtualization type is `FNN`."},"requestedVni":{"type":["integer","null"],"minimum":1,"maximum":65535,"readOnly":true,"description":"Explicitly requested VNI for the VPC if one was requested at creation time"},"vni":{"type":["integer","null"],"minimum":1,"maximum":65535,"readOnly":true,"description":"Active VNI assigned to the VPC"},"networkSecurityGroupId":{"type":["string","null"],"description":"ID of the Network Security Group attached to the VPC"},"networkSecurityGroupPropagationDetails":{"$ref":"#/components/schemas/NetworkSecurityGroupPropagationDetails","description":"Propagation details for the attached Network Security Group"},"nvLinkLogicalPartitionId":{"type":["string","null"],"format":"uuid","description":"ID of the default NVLink Logical Partition that GPUs for all Instances in the VPC will attach to"},"labels":{"$ref":"#/components/schemas/Labels","description":"String key value pairs describing VPC labels"},"status":{"$ref":"#/components/schemas/VpcStatus","readOnly":true,"description":"Status of the VPC"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"readOnly":true,"description":"History of status changes for the VPC"},"created":{"type":"string","format":"date-time","readOnly":true,"description":"Date/time when VPC was created"},"updated":{"type":"string","format":"date-time","readOnly":true,"description":"Date/time when VPC was last updated"}}},"VpcStatus":{"title":"VpcStatus","type":"string","description":"Status values for VPC objects","enum":["Pending","Provisioning","Ready","Configuring","Deleting","Error"]},"VpcCreateRequest":{"title":"VpcCreateRequest","type":"object","description":"Request data to create a VPC","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-id-vpc","description":"Virtual network with user-specified VPC ID","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","networkVirtualizationType":"ETHERNET_VIRTUALIZER","vni":12001},{"name":"spark-ethernet-virtualization-vpc","description":"Virtual network for machines executing Spark jobs","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","networkVirtualizationType":"ETHERNET_VIRTUALIZER","vni":12001,"networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e"},{"name":"spark-fnn-vpc","description":"Virtual network for machines executing Spark jobs","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","networkVirtualizationType":"FNN","routingProfile":"internal","vni":12001,"nvLinkLogicalPartitionId":"dd887330-dbd3-45ce-b400-c42fc8e47315","labels":{"region":"us-west-1","env":"dev"}}],"properties":{"id":{"type":"string","format":"uuid","description":"Optional user-specified UUID for the VPC"},"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the VPC"},"description":{"type":["string","null"],"description":"Optional description for the VPC"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the VPC should be created"},"networkVirtualizationType":{"type":["string","null"],"enum":["ETHERNET_VIRTUALIZER","FNN"],"description":"Network virtualization type of the VPC. If no value is specified, then defaults to `FNN` if Site has native networking enabled, or ETHERNET_VIRTUALIZER if native networking is disabled"},"routingProfile":{"type":["string","null"],"minLength":3,"maxLength":64,"description":"Specify routing profile for the VPC. Only supported when `networkVirtualizationType` is set to `FNN`, or when `networkVirtualizationType` is omitted and Site has Native Networking enabled. Requires Tenant to have elevated privilege. Current accepted values are `privileged-internal`, `internal`, and `external`."},"networkSecurityGroupId":{"type":["string","null"],"description":"ID of the Network Security Group to attach to the VPC"},"vni":{"type":["integer","null"],"minimum":1,"maximum":65535,"description":"Explicitly requested VNI for the VPC"},"nvLinkLogicalPartitionId":{"type":["string","null"],"format":"uuid","description":"ID of the default NVLink Logical Partition that GPUs for all Instances in the VPC will attach to"},"labels":{"$ref":"#/components/schemas/Labels","description":"String key value pairs describing VPC labels. Up to 10 key value pairs can be specified"}},"required":["name","siteId"]},"VpcUpdateRequest":{"title":"VpcUpdateRequest","type":"object","description":"Request data to update a VPC","examples":[{"name":"spark-vpc-v1","description":"Virtual network for machines executing Spark jobs v1"}],"properties":{"name":{"type":["string","null"],"minLength":2,"maxLength":256,"description":"Updated name of the VPC"},"description":{"type":["string","null"],"description":"Updated description of the VPC"},"networkSecurityGroupId":{"type":["string","null"],"description":"ID of the Network Security Group to attach to the VPC"},"nvLinkLogicalPartitionId":{"type":["string","null"],"format":"uuid","description":"ID of the default NVLink Logical Partition that GPUs for all Instances in the VPC will attach to. Can only be updated if VPC currently has no active Instances"},"labels":{"$ref":"#/components/schemas/Labels","description":"Update labels of the VPC. Up to 10 key value pairs can be specified. The labels will be entirely replaced by those sent in the request. Any labels not included in the request will be removed. To retain existing labels, first fetch them and include them along with this request."}}},"VpcVirtualizationUpdateRequest":{"title":"VpcVirtualizationUpdateRequest","type":"object","description":"Request data to update network virtualization type for VPC. Requests are rejected if the VPC already has Subnets or Instances.","examples":[{"networkVirtualizationType":"FNN"}],"properties":{"networkVirtualizationType":{"type":"string","enum":["FNN"],"description":"Network virtualization type of the VPC. Can only be updated to `FNN`"}}},"VpcPeeringCreateRequest":{"title":"VpcPeeringCreateRequest","type":"object","description":"Request data to create a VPC peering between two VPCs, the ordering of VPCs is not important","required":["vpc1Id","vpc2Id","siteId"],"properties":{"vpc1Id":{"type":"string","format":"uuid","description":"ID of the first VPC in the peering"},"vpc2Id":{"type":"string","format":"uuid","description":"ID of the second VPC to peer with"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the peering exists"}}},"VpcPeering":{"title":"VpcPeering","type":"object","description":"VPC peering connection between two VPCs on the same site","properties":{"id":{"type":"string","format":"uuid","readOnly":true,"description":"Unique identifier of the VPC peering"},"vpc1Id":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the first VPC in the peering"},"vpc2Id":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the second VPC in the peering"},"siteId":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the Site where the peering exists"},"isMultiTenant":{"type":"boolean","readOnly":true,"description":"Indicates if this is a multi-tenant peering (VPCs from different tenants)"},"status":{"$ref":"#/components/schemas/VpcPeeringStatus","readOnly":true,"description":"Status of the VPC peering"},"created":{"type":"string","format":"date-time","readOnly":true,"description":"Date and time when the VPC peering was created"},"updated":{"type":"string","format":"date-time","readOnly":true,"description":"Date and time when the VPC peering was last updated"}}},"VpcPeeringStatus":{"title":"VpcPeeringStatus","type":"string","description":"Status values for VPC peering objects","enum":["Pending","Configuring","Requested","Ready","Deleting","Error"]},"VpcPrefix":{"title":"VpcPrefix","type":"object","description":"VPC Prefixes are network grouping constructs for baremetal machines.","examples":[{"id":"0c03ba01-d86b-4a57-a41e-cc359b380a6f","name":"east-vpc-traffic-net","siteId":"ea144def-d68f-44c3-9485-4b103fa2686f","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","prefix":"192.168.1.0/24","ipBlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","prefixLength":20,"status":"Ready","statusHistory":[{"status":"Ready","message":"Received VPC prefix creation request, ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the VPC Prefix"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site the VPC Prefix belongs to"},"vpcId":{"type":"string","format":"uuid","description":"ID of the VPC the VPC Prefix belongs to"},"tenantId":{"type":"string","format":"uuid","description":"ID of the Tenant the VPC Prefix belongs to"},"ipBlockId":{"type":["string","null"],"format":"uuid","description":"ID of the IP Block that contains the prefix of the VPC Prefix"},"prefix":{"type":["string","null"],"description":"The network prefix including prefix length in CIDR notation"},"prefixLength":{"type":"integer","minimum":8,"maximum":31,"example":24,"description":"Length of the prefix. Valid range is 8 to 31, and max usable value depends on prefix length of parent IP Block."},"status":{"$ref":"#/components/schemas/VpcPrefixStatus","readOnly":true,"description":"Status of the VPC Prefix"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"readOnly":true,"description":"Details of 20 most recent status changes"},"created":{"type":"string","format":"date-time","readOnly":true,"description":"Date and time when the VPC Prefix was created"},"updated":{"type":"string","format":"date-time","readOnly":true,"description":"Date and time when the VPC Prefix was updated"}}},"VpcPrefixStatus":{"title":"VpcPrefixStatus","type":"string","description":"Status values for VPC Prefix objects","enum":["Ready","Deleting","Error"]},"VpcPrefixCreateRequest":{"title":"VpcPrefixCreateRequest","type":"object","examples":[{"name":"east-vpc-traffic-net","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","ipBlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","prefixLength":20}],"description":"Request data for creating VPC Prefix","properties":{"name":{"type":"string","minLength":2,"maxLength":256,"description":"Human readable name for the VPC Prefix"},"vpcId":{"type":"string","format":"uuid","description":"ID of the VPC"},"ipBlockId":{"type":"string","format":"uuid","description":"ID of the IP Block to allocate the VPC Prefix from"},"prefixLength":{"type":"integer","minimum":8,"maximum":31,"description":"Prefix length for the VPC Prefix. Valid range is 8 to 31, and max usable value depends on prefix length of parent IP Block."}},"required":["name","vpcId","ipBlockId","prefixLength"]},"VpcPrefixUpdateRequest":{"title":"VpcPrefixUpdateRequest","type":"object","examples":[{"name":"east-vpc-traffic-net"}],"description":"Request data for updating a VPC Prefix","properties":{"name":{"type":"string","minLength":2,"maxLength":256}},"required":["name"]},"Subnet":{"title":"Subnet","type":"object","description":"Subnets are network grouping constructs for baremetal machines.","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-gpu-net","description":"Subnet for GPU nodes","siteId":"ea144def-d68f-44c3-9485-4b103fa2686f","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerNetworkSegmentId":"abe7b0e8-67db-4e89-903e-fc4f2bd7f034","ipv4Prefix":"204.168.0.250","ipv4BlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","ipv4Gateway":"204.168.0.1","ipv6Prefix":null,"ipv6BlockId":null,"ipv6Gateway":null,"prefixLength":20,"routingType":"Public","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"siteId":{"type":"string","format":"uuid"},"vpcId":{"type":"string","format":"uuid"},"tenantId":{"type":"string","format":"uuid"},"controllerNetworkSegmentId":{"type":["string","null"],"format":"uuid"},"ipv4Prefix":{"type":["string","null"],"format":"ipv4","description":"The prefix that gets assigned to the subnet if ipv4 block is chosen"},"ipv4BlockId":{"type":["string","null"],"format":"uuid"},"ipv4Gateway":{"type":["string","null"],"format":"ipv4"},"ipv6Prefix":{"type":["string","null"],"format":"ipv6"},"ipv6BlockId":{"type":["string","null"],"format":"uuid"},"ipv6Gateway":{"type":["string","null"],"format":"ipv6"},"mtu":{"type":"integer","description":"Maximum Transmission Unit size in bytes. This property is system-determined and read-only.","readOnly":true},"prefixLength":{"type":"integer","example":24,"description":"Max value depends on prefix length of parent IP Block"},"routingType":{"type":["string","null"],"enum":["Public","DatacenterOnly"]},"status":{"$ref":"#/components/schemas/SubnetStatus","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"readOnly":true},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"}}}},"SubnetStatus":{"title":"SubnetStatus","type":"string","description":"Status values for Subnet objects","enum":["Pending","Provisioning","Ready","Deleting","Error"]},"SubnetCreateRequest":{"title":"SubnetCreateRequest","type":"object","examples":[{"name":"spark-gpu-net","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","ipv4BlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","prefixLength":20}],"description":"Request data for creating Subnet","properties":{"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"vpcId":{"type":"string","format":"uuid"},"ipv4BlockId":{"type":["string","null"],"format":"uuid"},"ipv6BlockId":{"type":["string","null"],"format":"uuid"},"prefixLength":{"type":"integer"}},"required":["name","vpcId","prefixLength"]},"SubnetUpdateRequest":{"title":"SubnetUpdateRequest","type":"object","examples":[{"name":"spark-gpu-subnet","description":"Subnet for dedicated GPU nodes"}],"description":"Request data for updating a Subnet","properties":{"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]}},"required":["name"]},"InfiniBandPartition":{"title":"InfiniBandPartition","type":"object","description":"InfiniBand Partitions are network segments utilizing InfiniBand topology","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"turbo-net","description":"InfiniBand Partition for model training Instances","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerIBPartitionId":"0e60d064-3d38-4812-84d9-c3353bd96eaf","partitionKey":"0x1","partitionName":"turbo-net","serviceLevel":5,"rateLimit":40,"mtu":4000,"enableSharp":true,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"siteId":{"type":"string","format":"uuid"},"tenantId":{"type":"string","format":"uuid"},"controllerIBPartitionId":{"type":["string","null"],"format":"uuid"},"partitionKey":{"type":["string","null"],"readOnly":true},"partitionName":{"type":["string","null"],"readOnly":true},"serviceLevel":{"type":["integer","null"],"minimum":0,"maximum":15,"readOnly":true},"rateLimit":{"type":["number","null"],"enum":[2,5,10,14,20,25,30,40,56,60,80,100,112,120,168,200,300],"readOnly":true},"mtu":{"type":["integer","null"],"enum":[4000,8000],"readOnly":true},"enableSharp":{"type":"boolean","readOnly":true},"labels":{"$ref":"#/components/schemas/Labels","description":"String key value pairs describing InfiniBand Partition labels. Up to 10 key value pairs can be specified"},"status":{"$ref":"#/components/schemas/InfiniBandPartitionStatus","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"readOnly":true},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"InfiniBandPartitionStatus":{"title":"InfiniBandPartitionStatus","type":"string","description":"Status values for InfiniBand Partition objects","enum":["Pending","Provisioning","Ready","Configuring","Deleting","Error"]},"InfiniBandPartitionCreateRequest":{"title":"InfiniBandPartitionCreateRequest","type":"object","examples":[{"name":"turbo-net","siteId":"8c43e859-d301-4ecf-9d0e-46bf374473c4"}],"description":"Request data to create an InfiniBand Partition","properties":{"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the Partition to create"},"description":{"type":["string","null"],"description":"Optional description of the Partition"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site the Partition should belong to"},"labels":{"$ref":"#/components/schemas/Labels","description":"String key value pairs describing Partition labels. Up to 10 key value pairs can be specified"}},"required":["name","siteId"]},"InfiniBandPartitionUpdateRequest":{"title":"InfiniBandPartitionUpdateRequest","type":"object","examples":[{"name":"turbo-net","description":"InfiniBand Partition for model training Instances"}],"description":"Request data to update an InfiniBand Partition","properties":{"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"labels":{"$ref":"#/components/schemas/Labels","description":"String key value pairs describing Partition labels. Up to 10 key value pairs can be specified"}},"required":["name"]},"NVLinkLogicalPartition":{"title":"NVLinkLogicalPartition","type":"object","description":"NVLink Logical Partitions are logical GPU fabric segments for high bandwidth communication among selective GPUs","examples":[{"id":"ded96bdf-905e-40dd-8a58-3472aab60042","name":"partition-east-gpu","description":"Partition for model training Instances","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true,"description":"Unique ID of the NVLink Logical Partition"},"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the NVLink Logical Partition"},"description":{"type":["string","null"],"description":"Optional description of the NVLink Logical Partition"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site the NVLink Logical Partition belongs to"},"tenantId":{"type":"string","format":"uuid","description":"ID of the Tenant the NVLink Logical Partition belongs to"},"status":{"$ref":"#/components/schemas/NVLinkLogicalPartitionStatus","readOnly":true,"description":"Status of the NVLink Logical Partition"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Details of status changes for the NVLink Logical Partition over time","readOnly":true},"created":{"type":"string","format":"date-time","readOnly":true,"description":"Date and time the NVLink Logical Partition was created"},"updated":{"type":"string","format":"date-time","readOnly":true,"description":"Date and time the NVLink Logical Partition was last updated"}}},"NVLinkLogicalPartitionStatus":{"title":"NVLinkLogicalPartitionStatus","type":"string","description":"Status values for NVLink Logical Partition objects","enum":["Pending","Provisioning","Configuring","Ready","Deleting","Error"]},"NVLinkLogicalPartitionCreateRequest":{"title":"NVLinkLogicalPartitionCreateRequest","type":"object","examples":[{"name":"partition-east-gpu","siteId":"69dae3c8-3554-4a1f-b391-858c6dc47fff"}],"description":"Request data to create an NVLink Logical Partition","properties":{"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the NVLink Logical Partition to create"},"description":{"type":["string","null"],"description":"Optional description of the NVLink Logical Partition"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site the NVLink Logical Partition should belong to"}},"required":["name","siteId"]},"NVLinkLogicalPartitionUpdateRequest":{"title":"NVLinkLogicalPartitionUpdateRequest","type":"object","examples":[{"name":"partition-east-gpu","description":"NVLink Logical Partition for model training Instances"}],"description":"Request data to update an NVLink Logical Partition","properties":{"name":{"type":["string","null"],"minLength":2,"maxLength":256,"description":"Updated name for the NVLink Logical Partition"},"description":{"type":["string","null"],"description":"Updated description for the NVLink Logical Partition"}}},"OperatingSystem":{"title":"OperatingSystem","type":"object","description":"Describes the attributes of the operating system/bootloader that can be used on instances","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"ubuntu-22.04","description":"Ubuntu 22.04","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports\nphone_home:\n  url: http://169.254.169.254:7777/latest/meta-data/phone_home\n  post: all","isCloudInit":true,"phoneHomeEnabled":true,"isActive":true,"deactivationNote":null,"allowOverride":false,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"42b0f982-5c61-4d2f-a018-41ece61f4641","name":"debian-12-amd64","description":"Official Debian 12 for AMD/Intel","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","type":"Image","imageUrl":"https://saimei.ftp.acc.umu.se/images/cloud/bookworm/latest/debian-12-generic-amd64.qcow2","imageSha":"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae","imageAuthType":"Bearer","imageAuthToken":"acbd18db4cc2f85cedef654fccc4a4d8","imageDisk":"/dev/sda","rootFsId":"6c2ac315-3040-4728-94eb-b66d320206c1","rootFsLabel":null,"ipxeScript":null,"userData":null,"isCloudInit":true,"phoneHomeEnabled":false,"isActive":true,"deactivationNote":null,"allowOverride":false,"siteAssociations":[{"site":{"id":"4b36152c-f48d-4bcc-a722-0fd8e2ad209a","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"site":{"id":"219b7913-4494-4589-940e-e78ca879b302","name":"sc-west-4","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":false,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]},{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"ubuntu-22.04","description":"Ubuntu 22.04","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports\nphone_home:\n  url: http://169.254.169.254:7777/latest/meta-data/phone_home\n  post: all","isCloudInit":true,"phoneHomeEnabled":true,"isActive":false,"deactivationNote":"iPXE script is referencing a URL that is unreachable, needs to be researched","allowOverride":false,"status":"Deactivated","statusHistory":[{"status":"Deactivated","message":"Operating System has been deactivated","created":"2019-08-24T20:25:17Z","updated":"2019-08-24T20:25:17Z"},{"status":"Ready","message":"Operating System is now ready to use","created":"2019-08-24T14:17:34Z","updated":"2019-08-24T14:17:34Z"},{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","description":"ID of the Operating System","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the Operating System"},"description":{"type":["string","null"],"description":"Optional description of the Operating System"},"infrastructureProviderId":{"type":["string","null"],"format":"uuid","description":"Specified if a Provider owns the Operating System"},"tenantId":{"type":["string","null"],"format":"uuid","description":"Specified if a Tenant owns the Operating System"},"type":{"type":["string","null"],"description":"Type of the Operating System","enum":["iPXE","Image"]},"imageUrl":{"type":["string","null"],"format":"uri","description":"Original URL from where the Operating System image can be retrieved"},"imageSha":{"type":["string","null"],"description":"SHA hash of the image file, only present for image based OS"},"imageAuthType":{"type":["string","null"],"description":"Authentication type for image URL e.g. 'Basic' or 'Bearer'"},"imageAuthToken":{"type":["string","null"],"description":"Auth token to retrieve the image from image URL"},"imageDisk":{"type":["string","null"],"description":"Disk path where the image should be monuted"},"rootFsId":{"type":["string","null"],"description":"Root filesystem UUID, only applicable for image based Operating System"},"rootFsLabel":{"type":["string","null"],"description":"Root filesystem label, only applicable for image based Operating System"},"ipxeScript":{"type":["string","null"],"description":"iPXE script or URL, only applicable for iPXE based Operating System"},"userData":{"type":["string","null"],"description":"User data for the Operating System"},"isCloudInit":{"type":"boolean","description":"Specified when the Operating System is Cloud Init based"},"phoneHomeEnabled":{"type":"boolean","description":"Indicates whether the Phone Home service should be enabled or disabled for Operating System"},"isActive":{"type":"boolean","description":"Indicates if the Operating System is active"},"deactivationNote":{"type":["string","null"],"description":"Optional deactivation note if OS is inactive"},"allowOverride":{"type":"boolean","description":"Indicates if the user data can be overridden at Instance creation time"},"siteAssociations":{"type":"array","description":"Sites the Operating System is synced to","items":{"$ref":"#/components/schemas/OperatingSystemSiteAssociation"}},"status":{"$ref":"#/components/schemas/OperatingSystemStatus","description":"Status of the Operating System"},"statusHistory":{"type":"array","description":"History of status changes over time","items":{"$ref":"#/components/schemas/StatusDetail"}},"created":{"type":"string","format":"date-time","description":"Date/time when the Operating System was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"Date/time when the Operating System was updated","readOnly":true}}},"OperatingSystemStatus":{"title":"OperatingSystemStatus","type":"string","description":"Status values for Operating System objects","enum":["Pending","Provisioning","Syncing","Ready","Deleting","Error","Deactivated"]},"OperatingSystemSiteAssociation":{"title":"OperatingSystemSiteAssociation","type":"object","description":"Describes the relationship between Operating Systems and Sites","examples":[{"site":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"sjc-central4","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":false,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":false,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Pending"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"site":{"$ref":"#/components/schemas/SiteSummary"},"status":{"$ref":"#/components/schemas/SshKeyGroupStatus"},"version":{"type":["string","null"],"description":"Version of the Key Group on Site","example":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3"},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"OperatingSystemCreateRequest":{"title":"OperatingSystemCreateRequest","type":"object","examples":[{"name":"ubuntu-official-22.04","description":"Official Ubuntu 22.04","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports","phoneHomeEnabled":true,"isCloudInit":true,"allowOverride":false},{"name":"debian-12-amd64","description":"Official Debian 12 for AMD/Intel","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","siteIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"imageUrl":"https://saimei.ftp.acc.umu.se/images/cloud/bookworm/latest/debian-12-generic-amd64.qcow2","imageSha":"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae","imageAuthType":"Bearer","imageAuthToken":"acbd18db4cc2f85cedef654fccc4a4d8","imageDisk":"/dev/sda","rootFsId":"6c2ac315-3040-4728-94eb-b66d320206c1","isCloudInit":true,"allowOverride":false}],"description":"Request data to create an OperatingSystem","properties":{"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the Operating System"},"description":{"type":["string","null"],"description":"Optional description of the Operating System"},"infrastructureProviderId":{"type":["string","null"],"format":"uuid","description":"Deprecated: Infrastructure Provider is now inferred from org membership.","deprecated":true},"tenantId":{"type":["string","null"],"format":"uuid","description":"Deprecated: Tenant is now inferred from org membership.","deprecated":true},"siteIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Specified only one Site if an Operating System is Image based, more than one Site is not supported\""},"ipxeScript":{"type":["string","null"],"description":"iPXE script or URL, only applicable for iPXE based OS. Cannot be specified if imageUrl is specified"},"imageUrl":{"type":["string","null"],"format":"uri","description":"Original URL from where the Operating System image can be retreived from, required for image based OS. Cannot be specified if ipxeScript is specified"},"imageSha":{"type":["string","null"],"description":"SHA hash of the image file, required for image based OS"},"imageAuthType":{"type":["string","null"],"description":"Authentication type for image URL if needed e.g. basic/bearer/token, required is imageAuthToken is specified"},"imageAuthToken":{"type":["string","null"],"description":"Auth token to retrieve the image from image URL, required if imageAuthType is specified"},"imageDisk":{"type":["string","null"],"description":"Disk path where the image should be mounted, optional"},"rootFsId":{"type":["string","null"],"description":"Root filesystem UUID, this or `rootFsLabel` required for image based OS"},"rootFsLabel":{"type":["string","null"],"description":"Root filesystem label, this or `rootFsId` required for image based OS"},"phoneHomeEnabled":{"type":["boolean","null"],"description":"Indicates whether the Phone Home service should be enabled or disabled for Operating System"},"userData":{"type":["string","null"],"description":"User data for the Operating System"},"isCloudInit":{"type":"boolean","description":"Specified when the Operating System is Cloud Init based"},"allowOverride":{"type":"boolean","description":"Indicates if the user data can be overridden at Instance creation time"}},"required":["name"]},"OperatingSystemUpdateRequest":{"title":"OperatingSystemUpdateRequest","type":"object","examples":[{"name":"ubuntu-22.04","description":"Ubuntu 22.04","phoneHomeEnabled":true,"allowOverride":false},{"name":"debian-12-amd64","description":"Official Debian 12 for AMD/Intel","imageUrl":"https://saimei.ftp.acc.umu.se/images/cloud/bookworm/latest/debian-12-generic-amd64.qcow2","imageSha":"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae","imageAuthType":"Bearer","imageAuthToken":"acbd18db4cc2f85cedef654fccc4a4d8","imageDisk":"/dev/sda","rootFsId":"6c2ac315-3040-4728-94eb-b66d320206c1","isCloudInit":true,"allowOverride":false},{"isActive":false,"deactivationNote":"iPXE script is referencing a URL that is unreachable, needs to be researched"}],"description":"Request data to update an OperatingSystem. Only image related attributes can be updated for image based OS and only iPXE attributes can be updated for iPXE based OS","properties":{"name":{"type":["string","null"],"minLength":2,"maxLength":256,"description":"Name of the Operating System"},"description":{"type":["string","null"],"description":"Optional description of the Operating System"},"ipxeScript":{"type":["string","null"],"description":"iPXE script or URL, only applicable for iPXE based OS. Cannot be specified if imageUrl is specified"},"imageUrl":{"type":["string","null"],"format":"uri","description":"Original URL from where the Operating System image can be retreived from, required for image based OS"},"imageSha":{"type":["string","null"],"description":"SHA hash of the image file, required for image based OS"},"imageAuthType":{"type":["string","null"],"description":"Authentication type for image URL if needed e.g. basic/bearer/token, required is imageAuthToken is specified"},"imageAuthToken":{"type":["string","null"],"description":"Auth token to retrieve the image from image URL, required if imageAuthType is specified"},"imageDisk":{"type":["string","null"],"description":"Disk path where the image should be mounted, optional"},"rootFsId":{"type":["string","null"],"description":"Root filesystem UUID, this or `rootFsLabel` required for image based OS"},"rootFsLabel":{"type":["string","null"],"description":"Root filesystem label, this or `rootFsId` required for image based OS"},"phoneHomeEnabled":{"type":["boolean","null"],"description":"Indicates whether the Phone Home service should be enabled or disabled for Operating System"},"userData":{"type":["string","null"],"description":"User data for the Operating System"},"isCloudInit":{"type":["boolean","null"],"description":"Specified when the Operating System is Cloud Init based"},"allowOverride":{"type":["boolean","null"],"description":"Indicates if the user data can be overridden at Instance creation time"},"isActive":{"type":["boolean","null"],"description":"Indicates if the Operating System is active"},"deactivationNote":{"type":["string","null"],"description":"Optional deactivation note if OS is inactive"}}},"InstanceType":{"title":"InstanceType","type":"object","description":"Instance types describe a set of machines that match a certain criteria","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"x3.large","description":"Part of X family, the X3 Large features increased compute power","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","labels":{"region":"portland","env":"staging"},"machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2}],"machineInstanceTypes":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"queryParam":"includeMachineAssociation","replacedBy":"includeMachineAssignment","takeActionBy":"2023-07-26T00:00:00Z","notice":"'includeMachineAssociation' has been deprecated in favor of 'includeMachineAssignment'. Please take action immediately."},{"attribute":"displayName","takeActionBy":"2024-10-30T00:00:00Z","notice":"'displayName' has been deprecated. Please take action immediately."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"controllerMachineType":{"type":["string","null"]},"infrastructureProviderId":{"type":"string","format":"uuid"},"siteId":{"type":"string","format":"uuid"},"labels":{"$ref":"#/components/schemas/Labels"},"machineCapabilities":{"type":"array","items":{"$ref":"#/components/schemas/MachineCapability"}},"machineInstanceTypes":{"type":"array","description":"Available only for Providers","items":{"$ref":"#/components/schemas/MachineInstanceType"}},"allocationStats":{"$ref":"#/components/schemas/InstanceTypeAllocationStats","description":"summary of machine counts by allocation status"},"status":{"$ref":"#/components/schemas/InstanceTypeStatus"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"}},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"InstanceTypeSummary":{"title":"InstanceTypeSummary","type":"object","description":"Describes a subset of core attributes of an Instance Type","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"x3.large","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","status":"Pending"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256},"infrastructureProviderId":{"type":"string","format":"uuid"},"siteId":{"type":"string","format":"uuid"},"status":{"$ref":"#/components/schemas/InstanceTypeStatus"}}},"InstanceTypeStatus":{"title":"InstanceTypeStatus","type":"string","description":"Status values for Instance Type objects","enum":["Pending","Registering","Ready","Deleting","Error"]},"InstanceTypeAllocationStats":{"title":"InstanceTypeAllocationStats","type":"object","examples":[{"assigned":30,"total":10,"used":3,"unused":7,"unusedUsable":7,"maxAllocatable":20}],"description":"Allocation statistics for Instance Type","properties":{"assigned":{"type":"integer","description":"Total number of Machines assigned to this Instance Type"},"total":{"type":"integer","description":"Total number of Machines allocated to different Tenants for this Instance Type"},"used":{"type":"integer","description":"Total number of allocated Machines of this Instance Type currently being used by Tenants"},"unused":{"type":"integer","description":"Total number of allocated Machines of this Instance Type that is currently not being used by Tenants"},"unusedUsable":{"type":"integer","description":"Total number of allocated Machines of this Instance Type that is currently not in use but in Ready state, therefore can be provisioned by Tenant"},"maxAllocatable":{"type":"integer","description":"Maximum number of Machines of this Instance Type that can be allocated to a Tenant"}}},"InstanceTypeCreateRequest":{"title":"InstanceTypeCreateRequest","type":"object","examples":[{"name":"x3.large","description":"Part of X family, the X3 Large features increased compute power","siteId":"8d97fa69-9199-49ff-bcf3-168c62d3874e","labels":{"region":"portland","env":"staging"},"machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4}]}],"description":"Request data to create an Instance Type","properties":{"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"siteId":{"type":"string","format":"uuid"},"labels":{"$ref":"#/components/schemas/Labels"},"controllerMachineType":{"type":["string","null"]},"machineCapabilities":{"type":"array","items":{"$ref":"#/components/schemas/InstanceTypeCapabilityCreateRequest"}}},"required":["name","siteId"]},"InstanceTypeUpdateRequest":{"title":"InstanceTypeUpdateRequest","type":"object","examples":[{"description":"Updated version of the X3 Large family of machines"}],"description":"Request data to update an Instance Type","properties":{"name":{"type":["string","null"],"minLength":2,"maxLength":256},"description":{"type":["string","null"]},"labels":{"$ref":"#/components/schemas/Labels"},"machineCapabilities":{"type":"array","items":{"$ref":"#/components/schemas/MachineCapability"}}}},"InstanceTypeCapabilityCreateRequest":{"title":"InstanceTypeCapabilityCreateRequest","type":"object","description":"Describes request attributes for Instance Type Capability","examples":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","count":2},{"type":"Memory","name":"DDR4","capacity":"131072GB","count":4},{"type":"Network","name":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceType":"DPU","count":2},{"type":"Storage","name":"Dell Ent NVMe CM6 RI 1.92TB","capacity":"1.92TB","count":2},{"type":"GPU","name":"NVIDIA A100 PCIe","capacity":"80GB","count":2},{"type":"InfiniBand","name":"MT2910 Family [ConnectX-7]","vendor":"Mellanox Technologies","inactiveDevices":[1,3],"count":4},{"type":"DPU","name":"DPU","count":2}],"properties":{"type":{"type":"string","enum":["CPU","Memory","Storage","Network","GPU","InfiniBand","DPU"],"description":"Type of the Capability"},"name":{"type":["string"],"description":"Name of the Capability component"},"frequency":{"type":["string","null"],"description":"Frequency of the Capability component, if available"},"capacity":{"type":["string","null"],"description":"Capacity of the Capability component, if applicable"},"vendor":{"type":["string","null"],"description":"Vendor of the Capability component, if available"},"count":{"type":["integer","null"],"description":"Count of the Capability component"},"inactiveDevices":{"type":"array","description":"Indices of those devices that are inactive, only valid for InfiniBand Capability type","items":{"type":"integer"}},"deviceType":{"type":["string","null"],"description":"Device Type of the Capability component, if available"}}},"Instance":{"title":"Instance","type":"object","description":"Instance is a baremetal Machine that has been provisioned for a Tenant","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-monitor-1","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":null,"ipxeScript":null,"alwaysBootWithCustomIpxe":false,"networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e","networkSecurityGroupPropagationDetails":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","detailedStatus":"Partial","status":"Synchronizing","details":"","unpropagatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"relatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"]},"networkSecurityGroupInherited":false,"userData":null,"labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"64d2028c-ae87-4069-a624-66089d957ef9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true,"virtualFunctionId":null,"macAddress":null,"ipAddresses":[],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"infinibandInterfaces":[{"id":"c518a0e8-3f49-4a1a-8935-a6d3dee6911e","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","partitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"nvLinkInterfaces":[{"id":"fc19ab3f-1e52-4846-91bd-98743ff2752c","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":0,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"fc19ab3f-1e52-4846-91bd-98743ff2752c","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":1,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"fc19ab3f-1e52-4846-91bd-98743ff2752c","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":2,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"fc19ab3f-1e52-4846-91bd-98743ff2752c","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":3,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"dpuExtensionServiceDeployments":[],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"tpmEkCertificate":"LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUMxVENDQWJ5Z0F3SUJBZ0lVTEE1ZHFPK1E5OXZQM3VYRTRKcjBncVRtOW93d0RRWUpLb1pJaHZjTkFRRUwKQlFBd0xqRUxNQWtHQTFVRUJoTUNWVk14RXpBUkJnTlZCQW9NQ2s1MmFXUnBZU0JEYjNKNw==","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"attribute":"sshkeygroups","replacedBy":"sshKeyGroups","takeActionBy":"2025-09-04T00:00:00Z","notice":"'sshkeygroups' is being deprecated in favor of 'sshKeyGroups'. Please take action prior to the specified date."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"f61fbc1b-ba32-4476-aab5-5ac7c64c3f26","name":"spark-monitor-2","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","secondaryVpcIds":["5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3"],"machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":null,"ipxeScript":null,"alwaysBootWithCustomIpxe":false,"userData":null,"labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"64d2028c-ae87-4069-a624-66089d957ef9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","vpcPrefixId":"000bc42b-f946-472e-83d4-ddf7e365e148","isPhysical":true,"virtualFunctionId":null,"macAddress":null,"ipAddresses":[],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"infinibandInterfaces":[{"id":"c518a0e8-3f49-4a1a-8935-a6d3dee6911e","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","partitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"dpuExtensionServiceDeployments":[{"id":"3951ec37-d78f-4ad7-92e1-3fdc76ccf246","dpuExtensionService":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"busybox","serviceType":"KubernetesPod","latestVersion":"V1-T1761856992374052","status":"Ready"},"version":"V1-T1761856992374052","status":"Running","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"tpmEkCertificate":"LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUMxVENDQWJ5Z0F3SUJBZ0lVTEE1ZHFPK1E5OXZQM3VYRTRKcjBncVRtOW93d0RRWUpLb1pJaHZjTkFRRUwKQlFBd0xqRUxNQWtHQTFVRUJoTUNWVk14RXpBUkJnTlZCQW9NQ2s1MmFXUnBZU0JEYjNKNw==","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"attribute":"sshkeygroups","replacedBy":"sshKeyGroups","takeActionBy":"2025-09-04T00:00:00Z","notice":"'sshkeygroups' is being deprecated in favor of 'sshKeyGroups'. Please take action prior to the specified date."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the Instance","readOnly":true},"name":{"type":"string","description":"Name for the Instance","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description for the Instance"},"tenantId":{"type":"string","format":"uuid","description":"ID of the Tenant the Instance belongs to"},"infrastructureProviderId":{"type":"string","format":"uuid","description":"ID of the Infrastructure Provider that owns the Site where the Instance is located"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the Instance is located"},"instanceTypeId":{"type":["string","null"],"format":"uuid"},"vpcId":{"type":"string","format":"uuid"},"secondaryVpcIds":{"type":"array","description":"IDs of VPCs attached to the Instance through non-primary interfaces","items":{"type":"string","format":"uuid"}},"machineId":{"type":["string","null"]},"operatingSystemId":{"type":["string","null"],"format":"uuid"},"networkSecurityGroupId":{"type":["string","null"]},"networkSecurityGroupPropagationDetails":{"$ref":"#/components/schemas/NetworkSecurityGroupPropagationDetails","description":"Propagation details for the attached Network Security Group"},"networkSecurityGroupInherited":{"type":"boolean","description":"Indicates if the Network Security Group is inherited from VPC"},"controllerInstanceId":{"type":["string","null"],"format":"uuid"},"ipxeScript":{"type":["string","null"]},"alwaysBootWithCustomIpxe":{"type":"boolean","description":"Indicates whether the Instance should always execute custom iPXE script when rebooting"},"phoneHomeEnabled":{"type":"boolean","description":"Indicates whether the Phone Home service should be enabled or disabled for Instance"},"userData":{"type":["string","null"]},"labels":{"$ref":"#/components/schemas/Labels"},"isUpdatePending":{"type":"boolean","description":"Indicates whether an update is available for the Instance. Updates can be applied on reboot"},"serialConsoleUrl":{"type":["string","null"],"description":"Serial Console URL for the Instance. Format: ssh://<id>@siteSerialConsoleHostname"},"interfaces":{"type":"array","items":{"$ref":"#/components/schemas/Interface"}},"infinibandInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/InfiniBandInterface"}},"nvLinkInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/NVLinkInterface"}},"dpuExtensionServiceDeployments":{"type":"array","description":"DPU Extension Services deployed on DPUs of this Instance","items":{"$ref":"#/components/schemas/DpuExtensionServiceDeployment"}},"sshKeyGroupIds":{"type":"array","description":"IDs of SSH Key Groups associated with this Instance","items":{"type":"string","format":"uuid"}},"sshKeyGroups":{"type":"array","description":"IDs of SSH Key Groups associated with this Instance","items":{"$ref":"#/components/schemas/SshKeyGroup"}},"tpmEkCertificate":{"type":["string","null"],"description":"base64 encoded TPM EK Certificate associated with this Instance"},"status":{"$ref":"#/components/schemas/InstanceStatus","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"}},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"InstanceStatus":{"title":"InstanceStatus","type":"string","description":"Status values for Instance objects","enum":["Pending","Provisioning","Configuring","Ready","Updating","Repairing","Rebooting","Terminating","Error"]},"InstanceCreateRequest":{"title":"InstanceCreateRequest","type":"object","examples":[{"name":"spark-monitor-1","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","alwaysBootWithCustomIpxe":true,"phoneHomeEnabled":true,"userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports\nphone_home:\n  url: http://169.254.169.254:7777/latest/meta-data/phone_home\n  post: all","labels":{"region":"portland","env":"staging"},"interfaces":[{"subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":false},{"subnetId":"31074c90-3061-4d90-bc62-eaf479989b97","isPhysical":true}],"infinibandInterfaces":[{"partitionId":"4f4decba-7d7f-46b9-9e5f-e5d71c2e0666","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null}],"nvLinkInterfaces":[{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":0},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":1},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":2},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":3}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]},{"name":"spark-monitor-2","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","alwaysBootWithCustomIpxe":true,"phoneHomeEnabled":true,"userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports\nphone_home:\n  url: http://169.254.169.254:7777/latest/meta-data/phone_home\n  post: all","labels":{"region":"portland","env":"staging"},"interfaces":[{"vpcPrefixId":"000bc42b-f946-472e-83d4-ddf7e365e148","isPhysical":true},{"vpcPrefixId":"72bfbc86-34eb-4108-8509-2ffd7ca45e04","isPhysical":true}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]},{"name":"llm-training-1","description":"Node for LLM Training","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","instanceTypeId":"83e71f8f-65d3-44ba-92ba-19daac2e497a","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","labels":{"region":"portland","env":"staging"},"interfaces":[{"vpcPrefixId":"000bc42b-f946-472e-83d4-ddf7e365e148","isPhysical":true}],"dpuExtensionServiceDeployments":[{"dpuExtensionServiceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","version":"V1-T1761856992374052"}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]},{"name":"gitlab-runner-1","description":"Node for GitLab Runner","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","machineId":"fm100htq4o8j3bere298as19mdgnbu6hg6guiqp32tghj7gogv05hlr7lgg","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","labels":{"region":"portland","env":"staging"},"interfaces":[{"vpcPrefixId":"000bc42b-f946-472e-83d4-ddf7e365e148","isPhysical":true}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"],"allowUnhealthyMachine":true}],"description":"Request data to create Instance","properties":{"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the Instance"},"description":{"type":["string","null"],"description":"Description of the Instance, optional","maxLength":1024},"tenantId":{"type":"string","format":"uuid","description":"ID of the Tenant creating the Instance"},"instanceTypeId":{"type":["string","null"],"format":"uuid","description":"ID of the Instance Type to use for Instance"},"machineId":{"type":["string","null"],"description":"ID of of specific Machine to use for Instance. Requires Targeted Instance Creation capability enabled for Tenant"},"vpcId":{"type":"string","format":"uuid","description":"ID of the VPC the Instance should belong to"},"secondaryVpcIds":{"type":"array","uniqueItems":true,"description":"IDs of additional VPCs the Instance should attach to through non-primary interfaces. This field may only be specified when every entry in `interfaces` uses `vpcPrefixId`. IDs must be unique, must be valid UUIDs, and must not include the primary `vpcId`.","items":{"type":"string","format":"uuid"}},"userData":{"type":["string","null"],"description":"Can only be specified if allowOverride is set to true in Operating System"},"operatingSystemId":{"type":["string","null"],"format":"uuid","description":"Must be specified if iPXE Script field is empty"},"networkSecurityGroupId":{"type":["string","null"]},"ipxeScript":{"type":["string","null"],"description":"Override iPXE script specified in OS, must be specified if Operating System is not specified"},"alwaysBootWithCustomIpxe":{"type":"boolean","description":"When set to true, the iPXE script specified by OS or overridden here will always be run when rebooting the Instance. OS must be of iPXE type."},"phoneHomeEnabled":{"type":"boolean","description":"When set to true, the Instance will be enabled with the Phone Home service."},"labels":{"$ref":"#/components/schemas/Labels"},"interfaces":{"type":"array","description":"At least one interface must be specified. Either Subnet or VPC Prefix interfaces allowed. Only one of the Subnets or VPC Prefixes can be attached over Physical interface. If only one Subnet is specified, then it will be attached over physical interface regardless of the value of isPhysical. In case of VPC Prefix, isPhysical will always be true","items":{"$ref":"#/components/schemas/InterfaceCreateRequest"}},"infinibandInterfaces":{"type":"array","description":"Associate one or more Partitions with this Instance","items":{"$ref":"#/components/schemas/InfiniBandInterfaceCreateRequest"}},"dpuExtensionServiceDeployments":{"type":"array","description":"DPU Extension Services to deploy to the DPUs of this Instance","items":{"$ref":"#/components/schemas/DpuExtensionServiceDeploymentRequest"}},"nvLinkInterfaces":{"type":"array","description":"Define Interfaces to associate Instance GPUs with NVLink Logical Partitions. A subset of GPUs may be specified (it is not required to include all GPUs). Each item references one GPU index (`deviceInstance`) and one NVLink Logical Partition. Different interfaces may reference different NVLink Logical Partitions.","items":{"$ref":"#/components/schemas/NVLinkInterfaceCreateOrUpdateRequest"}},"sshKeyGroupIds":{"type":"array","description":"Specify list of SSH Key Group IDs that will provide Serial over LAN access","items":{"type":"string","format":"uuid"}},"allowUnhealthyMachine":{"type":"boolean","description":"Set to true in order to target Machines are in maintenance or have health alerts preventing regular provision flow. Requires Targeted Instance Creation capability enabled for Tenant"}},"required":["name","tenantId","vpcId","interfaces"]},"BatchInstanceCreateRequest":{"title":"BatchInstanceCreateRequest","type":"object","description":"Request data to batch create multiple Instances with topology-optimized machine allocation. Explicit interface `ipAddress` values are not supported in batch requests.","examples":[{"namePrefix":"gpu-worker","count":4,"description":"GPU worker nodes for distributed training","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","topologyOptimized":true,"labels":{"workload":"training","env":"production"},"interfaces":[{"subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true}],"infinibandInterfaces":[{"partitionId":"4f4decba-7d7f-46b9-9e5f-e5d71c2e0666","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true}],"nvLinkInterfaces":[{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":0},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":1}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]},{"namePrefix":"inference-node","count":8,"description":"Inference nodes spread across racks","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","instanceTypeId":"83e71f8f-65d3-44ba-92ba-19daac2e497a","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","topologyOptimized":false,"interfaces":[{"vpcPrefixId":"000bc42b-f946-472e-83d4-ddf7e365e148","isPhysical":true}],"dpuExtensionServiceDeployments":[{"dpuExtensionServiceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","version":"V1-T1761856992374052"}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]}],"properties":{"namePrefix":{"type":"string","minLength":2,"maxLength":240,"description":"Prefix for instance names. Instances will be named with this prefix followed by a random 6-character suffix (e.g., \"worker\" becomes \"worker-abc123\")"},"count":{"type":"integer","minimum":2,"maximum":18,"description":"Number of instances to create in this batch. Minimum 2, maximum 18 (limited by topology domain size)"},"description":{"type":["string","null"],"description":"Description applied to all instances in the batch, optional","maxLength":1024},"tenantId":{"type":"string","format":"uuid","description":"ID of the Tenant creating the Instances"},"instanceTypeId":{"type":"string","format":"uuid","description":"ID of the Instance Type to use for all Instances in the batch"},"vpcId":{"type":"string","format":"uuid","description":"ID of the VPC the Instances should belong to"},"secondaryVpcIds":{"type":"array","uniqueItems":true,"description":"IDs of additional VPCs the Instances should attach to through non-primary interfaces. This field may only be specified when every entry in `interfaces` uses `vpcPrefixId`. IDs must be unique, must be valid UUIDs, and must not include the primary `vpcId`.","items":{"type":"string","format":"uuid"}},"userData":{"type":["string","null"],"description":"User data applied to all instances. Can only be specified if allowOverride is set to true in Operating System"},"operatingSystemId":{"type":["string","null"],"format":"uuid","description":"Must be specified if iPXE Script field is empty"},"networkSecurityGroupId":{"type":["string","null"],"format":"uuid","description":"ID of a Network Security Group to attach to all instances"},"ipxeScript":{"type":["string","null"],"description":"Override iPXE script specified in OS, must be specified if Operating System is not specified"},"alwaysBootWithCustomIpxe":{"type":"boolean","description":"When set to true, the iPXE script specified by OS or overridden here will always be run when rebooting the Instances. OS must be of iPXE type."},"phoneHomeEnabled":{"type":"boolean","description":"When set to true, the Instances will be enabled with the Phone Home service."},"labels":{"$ref":"#/components/schemas/Labels"},"interfaces":{"type":"array","description":"Interface configuration shared across all instances. At least one interface must be specified. Either Subnet or VPC Prefix interfaces allowed, only one of the Subnets or VPC Prefixes can be attached over Physical interface. Interface `ipAddress` is not supported for batch instance creation requests.","items":{"$ref":"#/components/schemas/InterfaceCreateRequest"}},"infinibandInterfaces":{"type":"array","description":"InfiniBand interface configuration shared across all instances","items":{"$ref":"#/components/schemas/InfiniBandInterfaceCreateRequest"}},"dpuExtensionServiceDeployments":{"type":"array","description":"DPU Extension Services to deploy to all instances in the batch","items":{"$ref":"#/components/schemas/DpuExtensionServiceDeploymentRequest"}},"nvLinkInterfaces":{"type":"array","description":"NVLink interface configuration shared across all instances. A subset of GPUs may be specified. Each item references one GPU index (`deviceInstance`) and one NVLink Logical Partition. Different interfaces may reference different NVLink Logical Partitions.","items":{"$ref":"#/components/schemas/NVLinkInterfaceCreateOrUpdateRequest"}},"sshKeyGroupIds":{"type":"array","description":"SSH Key Group IDs that will provide Serial over LAN access to all instances","items":{"type":"string","format":"uuid"}},"topologyOptimized":{"type":"boolean","default":true,"description":"When true (default), all instances must be allocated on machines within the same NVLink domain. When false, instances can be spread across different NVLink domains."}},"required":["namePrefix","count","tenantId","instanceTypeId","vpcId","interfaces"]},"InstanceUpdateRequest":{"title":"InstanceUpdateRequest","type":"object","examples":[{"name":"spark-monitor-1","description":"Spark Monitor Node 1","alwaysBootWithCustomIpxe":true,"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"],"operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports\nphone_home:\n  url: http://169.254.169.254:7777/latest/meta-data/phone_home\n  post: all","labels":{"region":"portland","env":"staging"},"interfaces":[{"subnetId":"1f492faa-2963-4f21-aab5-9f00b2e40119","isPhysical":true}],"infinibandInterfaces":[{"partitionId":"550e8400-e29b-41d4-a716-446655440000","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null},{"partitionId":"6ba7b810-9dad-11d1-80b4-00c04fd430c8","device":"MT2910 Family [ConnectX-7]","deviceInstance":1,"isPhysical":false,"virtualFunctionId":null},{"partitionId":"8b05d5c3-8de4-48c8-8d1c-399a8abc3ab8","device":"MT2910 Family [ConnectX-7]","deviceInstance":2,"isPhysical":false,"virtualFunctionId":null}],"dpuExtensionServiceDeployments":[{"dpuExtensionServiceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","version":"V1-T1761856992374052"}],"nvLinkInterfaces":[{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":0},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":1},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":2},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":3}]},{"triggerReboot":true,"rebootWithCustomIpxe":true,"applyUpdatesOnReboot":true}],"description":"Request data to update Instance","properties":{"name":{"type":["string","null"],"minLength":2,"maxLength":256,"description":"Updated name for the Instance"},"description":{"type":["string","null"],"description":"Updated description of the Instance","maxLength":1024},"triggerReboot":{"type":["boolean","null"],"description":"Trigger power cycle for Instance"},"rebootWithCustomIpxe":{"type":["boolean","null"],"description":"When specified along with triggerReboot, the Instance will boot using the custom iPXE specified by OS. If Instance has alwaysBootWithCustomIpxe flag set then this value will be ignored."},"applyUpdatesOnReboot":{"type":["boolean","null"],"description":"When specified, any updates pending for the Instance e.g. DPU reprovisioning, will be applied on reboot"},"operatingSystemId":{"type":["string","null"],"description":"The UUID of the desired operating system."},"ipxeScript":{"type":["string","null"],"description":"The iPXE script content to be used for booting."},"sshKeyGroupIds":{"type":"array","description":"Specify a new list of SSH Key Group IDs that will provide Serial over LAN and SSH access.  This will overwrite an existing list.","items":{"type":"string","format":"uuid"}},"networkSecurityGroupId":{"type":["string","null"]},"userData":{"type":["string","null"],"description":"Any user-data to be sent to the booting OS.  For example, cloud-init data."},"alwaysBootWithCustomIpxe":{"type":["boolean","null"],"description":"Whether the custom iPXE data should be used for every boot."},"phoneHomeEnabled":{"type":["boolean","null"],"description":"Indicates whether the Phone Home service should be enabled or disabled for Instance"},"labels":{"$ref":"#/components/schemas/Labels","description":"Update labels of the Instance. The labels will be entirely replaced by those sent in the request. Any labels not included in the request will be removed. To retain existing labels, first fetch them and include them along with this request."},"secondaryVpcIds":{"type":"array","uniqueItems":true,"description":"IDs of additional VPCs the Instance should attach to through non-primary interfaces. This field may only be specified when every entry in `interfaces` uses `vpcPrefixId`. IDs must be unique, must be valid UUIDs, and must not include the primary `vpcId`.","items":{"type":"string","format":"uuid"}},"interfaces":{"type":"array","description":"Update Interfaces of the Instance","items":{"$ref":"#/components/schemas/InterfaceCreateRequest"}},"infinibandInterfaces":{"type":"array","description":"Update InfiniBand Interfaces of the Instance","items":{"$ref":"#/components/schemas/InfiniBandInterfaceCreateRequest"}},"nvLinkInterfaces":{"type":"array","description":"Update NVLink Interfaces of the Instance. A subset of GPUs may be specified. Each item references a GPU index (`deviceInstance`) and an NVLink Logical Partition. Different interfaces may reference different NVLink Logical Partitions. Partial updates are not allowed, specified interfaces will delete or replace existing Interfaces. Updating is not allowed if Instance's VPC has `nvLinkLogicalPartitionId` attribute set.","items":{"$ref":"#/components/schemas/NVLinkInterfaceCreateOrUpdateRequest"}},"dpuExtensionServiceDeployments":{"type":"array","description":"Updated set of DPU Extension Services to deploy to the DPUs of this Instance","items":{"$ref":"#/components/schemas/DpuExtensionServiceDeploymentRequest"}}}},"InstanceDeleteRequest":{"title":"InstanceDeleteRequest","type":"object","examples":[{"machineHealthIssue":{"category":"Network","summary":"Machine has DPU connectivity error","details":"Tenant observed repeated link flaps on the DPU uplink."},"isRepairTenant":false}],"description":"Request data to delete Instance","properties":{"machineHealthIssue":{"$ref":"#/components/schemas/MachineHealthIssue","description":"Information regarding issue with the underlying Machine experienced by Tenant"},"isRepairTenant":{"type":["boolean","null"],"description":"Should be set to true for Tenants who are performing investigation/repairing the Machine. Otherwise omit or set to false"}}},"Interface":{"title":"Interface","type":"object","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true,"virtualFunctionId":null,"macAddress":"2F-FC-34-AE-9C-2A","ipAddresses":["200.32.11.190"],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"94c4c8c0-c3c4-4a52-9518-3e165b1de036","instanceId":"371ddf80-a7ff-4ff6-9a37-0557cec8b9be","vpcPrefixId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","requestedIpAddress":"10.0.0.191","isPhysical":true,"device":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceInstance":0,"virtualFunctionId":null,"macAddress":"2F-FC-34-AE-9C-2B","ipAddresses":["200.32.11.191"],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"45d89d4f-2dde-4fc5-a20d-9f96faa4e9fa","instanceId":"371ddf80-a7ff-4ff6-9a37-0557cec8b9be","vpcPrefixId":"d89d8cc6-d66e-4bf2-bf62-40238837cc90","requestedIpAddress":"10.0.0.193","isPhysical":false,"device":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceInstance":0,"virtualFunctionId":1,"macAddress":"2F-FC-34-AM-9C-2C","ipAddresses":["200.32.11.193"],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"236ee9d1-5f61-4aaa-abf3-0f72693e1189","instanceId":"371ddf80-a7ff-4ff6-9a37-0557cec8b9be","vpcPrefixId":"d5dd56e2-1b0b-4913-927e-b5896d7aca7b","requestedIpAddress":"10.0.0.195","isPhysical":true,"device":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceInstance":1,"virtualFunctionId":null,"macAddress":"2F-FC-34-AM-9C-2C","ipAddresses":["200.32.11.194"],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"description":"Associates an Instance with a Subnet","properties":{"id":{"type":"string","minLength":1,"format":"uuid"},"instanceId":{"type":"string","format":"uuid"},"subnetId":{"type":["string","null"],"format":"uuid"},"vpcPrefixId":{"type":["string","null"],"format":"uuid"},"isPhysical":{"type":"boolean"},"device":{"type":["string","null"],"description":"Name of the device to use"},"deviceInstance":{"type":["integer","null"],"description":"Index of the device, used to identify which interface card to attache the Partition to"},"virtualFunctionId":{"type":["integer","null"],"description":"Must be specified if isPhysical is false"},"macAddress":{"type":["string","null"]},"ipAddresses":{"type":"array","description":"A list of IPv4 or IPv6 addresses","items":{"type":"string"}},"requestedIpAddress":{"type":["string","null"],"description":"Explicitly requested IP address for the interface. This is only used for VPC Prefix based interfaces and is not valid for Subnet based interfaces. The least-significant host bit must be 1."},"status":{"$ref":"#/components/schemas/InterfaceStatus"},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"InterfaceStatus":{"title":"InterfaceStatus","type":"string","description":"Status values for Interface objects","enum":["Pending","Provisioning","Ready","Deleting","Error"]},"InterfaceCreateRequest":{"title":"InterfaceCreateRequest","type":"object","examples":[{"subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true},{"vpcPrefixId":"000bc42b-f946-472e-83d4-ddf7e365e148","ipAddress":"10.0.0.11","isPhysical":true}],"description":"Request data to create an Interface for an Instance by associating it with a Subnet or VPC Prefix.\n\nIf VPC specified in request has FNN virtualization type, then all interfaces must specify VPC Prefix.\n\nIf the VPC has Ethernet network virtualization type then all interfaces must specify Subnet.","properties":{"subnetId":{"type":"string","format":"uuid"},"vpcPrefixId":{"type":"string","format":"uuid"},"ipAddress":{"type":["string","null"],"description":"Explicitly requested IP address for the interface. It cannot be specified for Subnet based interfaces. The least-significant host bit must be 1."},"isPhysical":{"type":"boolean","description":"Specifies whether this Subnet or VPC Prefix should be attached to the Instance over physical interface."},"device":{"type":"string","description":"Name of the device to use"},"deviceInstance":{"type":"integer","description":"Index of the device, used to identify which interface card to attache the Partition to"},"virtualFunctionId":{"type":["integer","null"],"description":"Index of the virtual function to use, must be specified if isPhysical is false","minimum":1,"maximum":16}}},"InfiniBandInterface":{"title":"InfiniBandInterface","type":"object","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","partitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"description":"Defines an interface created by associating an Instance with an InfiniBand Partition","properties":{"id":{"type":"string","minLength":1,"format":"uuid"},"instanceId":{"type":"string","format":"uuid"},"partitionId":{"type":"string","format":"uuid","description":"ID of the InfiniBand Partition associated with this interface"},"device":{"type":"string","description":"Name of the InfiniBand device associated with this interface"},"deviceInstance":{"type":"integer"},"isPhysical":{"type":"boolean","description":"Indicates whether this is a physical interface"},"virtualFunctionId":{"type":["integer","null"]},"guid":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/InfiniBandInterfaceStatus"},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"InfiniBandInterfaceStatus":{"title":"InfiniBandInterfaceStatus","type":"string","description":"Status values for InfiniBand Interface objects","enum":["Pending","Provisioning","Ready","Deleting","Error"]},"InfiniBandInterfaceCreateRequest":{"title":"InfiniBandInterfaceCreateRequest","type":"object","examples":[{"partitionId":"4f4decba-7d7f-46b9-9e5f-e5d71c2e0666","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null},{"partitionId":"4f4decba-7d7f-46b9-9e5f-e5d71c2e0666","device":"MT2910 Family [ConnectX-7]","deviceInstance":3,"isPhysical":false,"virtualFunctionId":2}],"description":"Request data to create an InfiniBand Interface for an Instance by associating it with an InfiniBand Partition","properties":{"partitionId":{"type":"string","format":"uuid","description":"ID of the Partition the Interface should attach to"},"device":{"type":"string","description":"Name of the InfiniBand device to use"},"vendor":{"type":["string","null"],"description":"Name of the InfiniBand device vendor, optional"},"deviceInstance":{"type":"integer","description":"Index of the device, used to identify which interface card to attache the Partition to"},"isPhysical":{"type":"boolean","description":"Specifies whether this Partition should be attached to the Instance over physical interface"},"virtualFunctionId":{"type":["integer","null"],"description":"Must be specified if isPhysical is false"}}},"NVLinkInterface":{"title":"NVLinkInterface","type":"object","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","nvLinklogicalPartitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":0,"gpuGuid":"4fe82bc6-1e30-4dfd-8839-996596209883","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"description":"Defines an interface created by associating a GPU of an Instance with an NVLink Logical Partition","properties":{"id":{"type":"string","minLength":1,"format":"uuid"},"instanceId":{"type":"string","format":"uuid"},"nvLinkLogicalPartitionId":{"type":"string","format":"uuid","description":"ID of the NVLink Logical Partition associated with this interface"},"nvLinkDomainId":{"type":["string","null"],"format":"uuid","description":"ID of the NVLink Domain associated with this Interface"},"deviceInstance":{"type":"integer","description":"Index of the device, used to identify the GPU associated with this Interface"},"gpuGuid":{"type":["string","null"],"description":"Unique ID of the GPU"},"status":{"$ref":"#/components/schemas/NVLinkInterfaceStatus"},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"NVLinkInterfaceStatus":{"title":"NVLinkInterfaceStatus","type":"string","description":"Status values for NVLink Interface objects","enum":["Pending","Provisioning","Ready","Deleting","Error"]},"NVLinkInterfaceCreateOrUpdateRequest":{"title":"NVLinkInterfaceCreateOrUpdateRequest","type":"object","examples":[{"nvLinklogicalPartitionId":"505e07bc-86bf-489a-807d-92dc8b80e6ff","deviceInstance":0},{"nvLinklogicalPartitionId":"4f4decba-7d7f-46b9-9e5f-e5d71c2e0666","deviceInstance":1}],"description":"Request data to create an NVLink Interface for an Instance by associating a specific GPU index with an NVLink Logical Partition.","properties":{"nvLinklogicalPartitionId":{"type":"string","format":"uuid","description":"ID of the NVLink Logical Partition the Interface should attach to"},"deviceInstance":{"type":"integer","minimum":0,"description":"GPU index for this NVLink interface. Must be non-negative, unique within the request, and within the GPU count exposed by the selected Machine or Instance Type."}}},"MachineCapability":{"title":"MachineCapability","type":"object","description":"Describes capabilities of a Machine","examples":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2},{"type":"Memory","name":"DDR4","capacity":"131072GB","count":4},{"type":"Network","name":"MT43244 BlueField-3 integrated ConnectX-7 network controller","vendor":"Mellanox Technologies","deviceType":"DPU","count":2},{"type":"Storage","name":"Dell Ent NVMe CM6 RI 1.92TB","capacity":"1.92TB","count":2},{"type":"GPU","name":"NVIDIA A100 PCIe","capacity":"80GB","count":2},{"type":"InfiniBand","name":"MT28908 Family [ConnectX-6]","vendor":"Mellanox Technologies","count":2},{"type":"DPU","name":"DPU","count":2}],"properties":{"type":{"type":"string","enum":["CPU","Memory","Storage","Network","GPU","InfiniBand","DPU"],"description":"Type of the Capability"},"name":{"type":["string"],"description":"Name of the Capability component"},"frequency":{"type":["string","null"],"description":"Frequency of the Capability component, if available"},"cores":{"type":["integer","null"],"description":"Number of Cores in the Capability component, if applicable"},"threads":{"type":["integer","null"],"description":"Number of Threads in the Capability component, if applicable"},"capacity":{"type":["string","null"],"description":"Capacity of the Capability component, if applicable"},"vendor":{"type":["string","null"],"description":"Vendor of the Capability component, if available"},"inactiveDevices":{"type":"array","description":"A list of inactive devices","items":{"type":"integer"}},"count":{"type":["integer","null"],"description":"Count of the Capability component"},"deviceType":{"type":["string","null"],"description":"Device Type of the Capability component, if available"}}},"Rack":{"title":"Rack","type":"object","description":"Rack represents a physical rack in the datacenter","examples":[{"id":"550e8400-e29b-41d4-a716-446655440000","name":"Rack-01","manufacturer":"Dell","model":"PowerEdge R750","serialNumber":"SN-RACK-001","description":"Primary compute rack","location":{"region":"us-east-1","datacenter":"DC-01","room":"Room-A","position":"A1"},"components":[{"id":"660e8400-e29b-41d4-a716-446655440001","componentId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","type":"ComponentTypeCompute","name":"Server-01","serialNumber":"SN-SRV-001","manufacturer":"Dell","firmwareVersion":"2.1.0","slotId":1,"trayIdx":0,"hostId":0,"bmcs":[{"type":"BmcTypeHost","macAddress":"AA:BB:CC:DD:EE:01","ipAddress":"10.0.0.101"}],"powerState":"on"}]}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the Rack"},"name":{"type":"string","description":"Name of the Rack"},"manufacturer":{"type":"string","description":"Manufacturer of the Rack"},"model":{"type":"string","description":"Model of the Rack"},"serialNumber":{"type":"string","description":"Serial number of the Rack"},"description":{"type":"string","description":"Description of the Rack"},"location":{"$ref":"#/components/schemas/RackLocation"},"components":{"type":"array","description":"Components within the Rack. Only returned when includeComponents is true.","items":{"$ref":"#/components/schemas/RackComponent"}}}},"RackLocation":{"title":"RackLocation","type":"object","description":"Physical location of a Rack","properties":{"region":{"type":"string","description":"Region where the rack is located"},"datacenter":{"type":"string","description":"Datacenter where the rack is located"},"room":{"type":"string","description":"Room within the datacenter"},"position":{"type":"string","description":"Position of the rack within the room"}}},"RackValidationResult":{"title":"RackValidationResult","type":"object","description":"Result of validating a rack's components by comparing expected vs actual state","properties":{"diffs":{"type":"array","description":"List of component differences found during validation","items":{"$ref":"#/components/schemas/ComponentDiff"}},"totalDiffs":{"type":"integer","description":"Total number of component differences found"},"missingCount":{"type":"integer","description":"Number of components expected but missing from the source system"},"unexpectedCount":{"type":"integer","description":"Number of components found in the source system but not expected"},"mismatchCount":{"type":"integer","description":"Number of components present in both but with field differences"},"matchCount":{"type":"integer","description":"Number of components that match between expected and actual"}}},"ComponentDiff":{"title":"ComponentDiff","type":"object","description":"A single component difference found during rack validation","properties":{"type":{"type":"string","description":"Type of difference: Unknown, Missing, Unexpected, or Mismatch","enum":["Unknown","Missing","Unexpected","Mismatch"]},"id":{"type":"string","format":"uuid","description":"Flow internal component UUID"},"componentId":{"type":"string","description":"Component ID assigned by the component manager service"},"expected":{"$ref":"#/components/schemas/RackComponent"},"actual":{"$ref":"#/components/schemas/RackComponent"},"fieldDiffs":{"type":"array","description":"List of field differences (populated when type is Mismatch)","items":{"$ref":"#/components/schemas/FieldDiff"}}}},"FieldDiff":{"title":"FieldDiff","type":"object","description":"A single field difference between expected and actual component state","properties":{"fieldName":{"type":"string","description":"Name of the field that differs (e.g. firmware_version, position.slot_id)"},"expectedValue":{"type":"string","description":"Expected value of the field"},"actualValue":{"type":"string","description":"Actual value of the field"}}},"RackComponent":{"title":"RackComponent","type":"object","description":"A component within a Rack (e.g. compute node, switch, PDU)","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the component"},"componentId":{"type":"string","description":"ID of the component"},"rackId":{"type":"string","format":"uuid","description":"ID of the rack this component belongs to"},"type":{"type":"string","description":"Type of the component (e.g. ComponentTypeCompute, ComponentTypeNVSwitch)"},"name":{"type":"string","description":"Name of the component"},"serialNumber":{"type":"string","description":"Serial number of the component"},"manufacturer":{"type":"string","description":"Manufacturer of the component"},"model":{"type":"string","description":"Model of the component"},"description":{"type":"string","description":"Description of the component (JSON string)"},"firmwareVersion":{"type":"string","description":"Firmware version of the component"},"slotId":{"type":"integer","description":"Slot ID of the component within the rack"},"trayIdx":{"type":"integer","description":"Tray index of the component"},"hostId":{"type":"integer","description":"Host ID of the component"},"bmcs":{"type":"array","description":"BMC (Baseboard Management Controller) entries for the component","items":{"$ref":"#/components/schemas/BMCInfo"}},"powerState":{"type":"string","description":"Current power state of the component"}}},"BMCInfo":{"title":"BMCInfo","type":"object","description":"BMC (Baseboard Management Controller) information","properties":{"type":{"type":"string","description":"BMC type (e.g. BmcTypeHost, BmcTypeDpu)"},"macAddress":{"type":"string","description":"MAC address of the BMC"},"ipAddress":{"type":"string","description":"IP address of the BMC"}}},"Tray":{"title":"Tray","type":"object","description":"Tray represents a component within a rack (e.g. compute node, NVSwitch, power shelf)","examples":[{"id":"660e8400-e29b-41d4-a716-446655440001","componentId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","type":"compute","name":"compute-tray-1","manufacturer":"NVIDIA","model":"GB200","serialNumber":"TSN001","description":"Compute tray in slot 1","firmwareVersion":"2.1.0","powerState":"on","position":{"slotId":1,"trayIdx":0,"hostId":1},"bmcs":[{"type":"BmcTypeHost","macAddress":"00:11:22:33:44:55","ipAddress":"192.168.1.100"}],"rackId":"550e8400-e29b-41d4-a716-446655440000"}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the Tray"},"componentId":{"type":"string","description":"ID of the component"},"type":{"type":"string","enum":["compute","switch","powershelf"],"description":"Type of the tray"},"name":{"type":"string","description":"Name of the tray"},"manufacturer":{"type":"string","description":"Manufacturer of the tray"},"model":{"type":"string","description":"Model of the tray"},"serialNumber":{"type":"string","description":"Serial number of the tray"},"description":{"type":"string","description":"Description of the tray"},"firmwareVersion":{"type":"string","description":"Firmware version of the tray"},"powerState":{"type":"string","description":"Current power state of the tray"},"position":{"$ref":"#/components/schemas/TrayPosition"},"bmcs":{"type":"array","description":"BMC (Baseboard Management Controller) entries for the tray","items":{"$ref":"#/components/schemas/BMCInfo"}},"rackId":{"type":"string","format":"uuid","description":"ID of the rack this tray belongs to"}}},"TrayPosition":{"title":"TrayPosition","type":"object","description":"Position of a tray within a rack","properties":{"slotId":{"type":"integer","description":"Slot number of the tray in the rack"},"trayIdx":{"type":"integer","description":"Index of the tray within its slot"},"hostId":{"type":"integer","description":"Host ID associated with the tray"}}},"RackFilter":{"title":"RackFilter","type":"object","description":"Filter criteria for selecting racks in batch operations. If omitted or empty, all racks in the site are targeted.","properties":{"names":{"type":"array","items":{"type":"string"},"description":"Filter racks by name"}}},"TrayFilter":{"title":"TrayFilter","type":"object","description":"Filter criteria for selecting trays in batch operations. If omitted or empty, all trays in the site are targeted.\n\nConstraints: `rackId` and `rackName` are mutually exclusive. `rackId`/`rackName` cannot be combined with `ids`/`componentIds`. `componentIds` requires `type`.","properties":{"rackId":{"type":"string","format":"uuid","description":"Filter by Rack ID"},"rackName":{"type":"string","description":"Filter by Rack name"},"type":{"type":"string","enum":["compute","switch","powershelf"],"description":"Filter by tray type"},"componentIds":{"type":"array","items":{"type":"string"},"description":"Filter by component ID. Requires 'type'."},"ids":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Filter by tray UUID"}}},"BatchUpdateRackPowerStateRequest":{"title":"BatchUpdateRackPowerStateRequest","type":"object","description":"Request body for batch rack power control operations","required":["siteId","state"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site"},"filter":{"$ref":"#/components/schemas/RackFilter"},"state":{"type":"string","enum":["on","off","cycle","forceoff","forcecycle"],"description":"Target power state"}}},"BatchUpdateTrayPowerStateRequest":{"title":"BatchUpdateTrayPowerStateRequest","type":"object","description":"Request body for batch tray power control operations","required":["siteId","state"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site"},"filter":{"$ref":"#/components/schemas/TrayFilter"},"state":{"type":"string","enum":["on","off","cycle","forceoff","forcecycle"],"description":"Target power state"}}},"BatchRackFirmwareUpdateRequest":{"title":"BatchRackFirmwareUpdateRequest","type":"object","description":"Request body for batch rack firmware update operations","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site"},"filter":{"$ref":"#/components/schemas/RackFilter"},"version":{"type":["string","null"],"description":"Target firmware version."}}},"BringUpRackRequest":{"title":"BringUpRackRequest","type":"object","description":"Request body for single-rack bring up operations","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site"},"description":{"type":"string","description":"Optional description for the bring up operation"}},"examples":[{"siteId":"550e8400-e29b-41d4-a716-446655440000"},{"siteId":"550e8400-e29b-41d4-a716-446655440000","description":"Initial bring up for production rack"}]},"BatchBringUpRackRequest":{"title":"BatchBringUpRackRequest","type":"object","description":"Request body for batch rack bring up operations","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site"},"filter":{"$ref":"#/components/schemas/RackFilter"},"description":{"type":"string","description":"Optional description for the bring up operation"}}},"BringUpRackResponse":{"title":"BringUpRackResponse","type":"object","description":"Response for bring up operations containing task IDs for tracking","properties":{"taskIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"List of task IDs created for the bring up operation (one per rack)"}},"examples":[{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}]},"RackTask":{"title":"RackTask","type":"object","description":"A task representing an asynchronous operation on rack infrastructure.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the task."},"status":{"type":"string","enum":["Unknown","Pending","Waiting","Running","Succeeded","Failed","Terminated"],"description":"Current state of the task."},"description":{"type":"string","description":"Human-readable description provided when the task was created."},"message":{"type":"string","description":"Optional status or error message describing the current state or result."},"started":{"type":"string","format":"date-time","description":"Timestamp when the task started execution."},"finished":{"type":"string","format":"date-time","description":"Timestamp when the task finished (succeeded, failed or terminated)."},"created":{"type":"string","format":"date-time","description":"Timestamp when the task was created."},"updated":{"type":"string","format":"date-time","description":"Timestamp when the task was last updated."}},"examples":[{"id":"550e8400-e29b-41d4-a716-446655440000","status":"Running","description":"Power on rack components","message":"Processing 3 of 5 components"}]},"BatchTrayFirmwareUpdateRequest":{"title":"BatchTrayFirmwareUpdateRequest","type":"object","description":"Request body for batch tray firmware update operations","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site"},"filter":{"$ref":"#/components/schemas/TrayFilter"},"version":{"type":["string","null"],"description":"Target firmware version."}}},"UpdatePowerStateRequest":{"title":"UpdatePowerStateRequest","type":"object","description":"Request body for single-resource power control operations","required":["siteId","state"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site"},"state":{"type":"string","enum":["on","off","cycle","forceoff","forcecycle"],"description":"Power control state to apply:\n- `on`: Power on the target(s)\n- `off`: Graceful power off\n- `cycle`: Graceful power cycle (restart)\n- `forceoff`: Forced power off (immediate)\n- `forcecycle`: Forced power cycle (immediate restart)"}},"examples":[{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"on"},{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"off"},{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"cycle"}]},"UpdatePowerStateResponse":{"title":"UpdatePowerStateResponse","type":"object","description":"Response for power control operations containing task IDs for tracking","properties":{"taskIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"List of task IDs created for the power control operation (one per rack)"}},"examples":[{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}]},"FirmwareUpdateRequest":{"title":"FirmwareUpdateRequest","type":"object","description":"Request body for firmware update operations.","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site"},"version":{"type":["string","null"],"description":"Target firmware version."}},"examples":[{"siteId":"550e8400-e29b-41d4-a716-446655440000","version":"24.11.0"},{"siteId":"550e8400-e29b-41d4-a716-446655440000"}]},"FirmwareUpdateResponse":{"title":"FirmwareUpdateResponse","type":"object","description":"Response for firmware update operations containing task IDs for tracking","properties":{"taskIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"List of task IDs created for the firmware update operation"}},"examples":[{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}]},"Machine":{"title":"Machine","type":"object","description":"Machine is the baremetal server that sits in the datacenter","examples":[{"id":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"2e016c02-2c67-48aa-b289-5d3ca6320c52","instanceId":"59bdaaff-3998-4fd9-a140-8749beeb605e","tenantId":"99819e6e-4017-4021-9edd-ea1bdf4dbd59","controllerMachineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerMachineType":"x86_64","hwSkuDeviceType":"cpu","vendor":"Lenovo","productName":"ThinkSystem SR670 V2","serialNumber":"J1060ACR.D3KS2CS001G","machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4}],"machineInterfaces":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerInterfaceId":"ad3dac49-741d-4c1f-815c-c020127c532f","controllerSegmentId":"f2207a3c-1847-42e5-bf2c-cd015f87a2bc","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","hostname":"example.com","isPrimary":true,"macAddress":"00:00:5e:00:53:af","ipAddresses":["192.156.7.23","202.88.37.112"],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"maintenanceMessage":null,"health":{"source":"aggregate-host-health","observedAt":null,"successes":[{"id":"BgpDaemonEnabled","target":null},{"id":"BgpStats","target":null},{"id":"DhcpServer","target":null},{"id":"DpuDiskUtilizationCheck","target":null},{"id":"FanSpeed","target":"System Board Fan1A"},{"id":"PowerSupply","target":"PS1 Status"},{"id":"Temperature","target":"CPU1 Temp"},{"id":"Temperature","target":"System Board Exhaust Temp"},{"id":"Voltage","target":"CPU1 1P8 PG"}],"alerts":[{"id":"FailedValidationTest","target":"DcgmFullShort","inAlertSince":null,"message":"Failed validation test:\nName:DcgmFullShort\nCommand:dcgmi\nArgs:diag -r 2","tenantMessage":null,"classifications":["PreventAllocations"]}]},"labels":{"RackIdentifier":"GVX11F01C02","ServerName":"SITE1-C03-Server-02"},"status":"Ready","isUsableByTenant":true,"statusHistory":[{"status":"Ready","message":"Machine is online and ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","description":"Unique ID of Machine","readOnly":true},"infrastructureProviderId":{"type":"string","format":"uuid","description":"ID of the Provider that owns the Machine","readOnly":true},"siteId":{"type":"string","format":"uuid","description":"ID of the Site the Machine belongs to"},"instanceTypeId":{"type":["string","null"],"format":"uuid","description":"ID of the Instance Type, if assigned"},"instanceId":{"type":["string","null"],"format":"uuid","description":"ID of the Instance if this Machine is assigned to one"},"tenantId":{"type":["string","null"],"format":"uuid","description":"ID of the Tenant that owns the Instance if the Machine is assigned to one"},"controllerMachineId":{"type":"string","description":"ID of the Machine at Site, now same as the primary ID"},"controllerMachineType":{"type":["string","null"],"description":"Denotes architecture (x86 vs ARM) of the Machine"},"hwSkuDeviceType":{"type":["string","null"],"description":"SKU derived device type of the machine, e.g. cpu, gpu, cache, storage, etc."},"vendor":{"type":["string","null"],"description":"Name of the vendor of the Machine"},"productName":{"type":["string","null"],"description":"Product name of the Machine"},"serialNumber":{"type":["string","null"],"description":"Serial number of the Machine, only visible to Provider"},"machineCapabilities":{"type":"array","items":{"$ref":"#/components/schemas/MachineCapability"}},"machineInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/MachineInterface"}},"maintenanceMessage":{"type":["string","null"],"description":"If the Machine is in maintenance mode, this message will typically describe the reason and how long it is expected to be in maintenance"},"health":{"$ref":"#/components/schemas/MachineHealth"},"metadata":{"$ref":"#/components/schemas/MachineMetadata","description":"Only available to Providers. Returned if includeMetadata query param is specified. Otherwise attribute is omitted from response."},"labels":{"$ref":"#/components/schemas/Labels"},"status":{"$ref":"#/components/schemas/MachineStatus","readOnly":true},"isUsableByTenant":{"type":"boolean","description":"Indicates whether the machine is usable by or currently in use by a tenant.","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"MachineStatus":{"title":"MachineStatus","type":"string","description":"Status values for Machine objects","enum":["Initializing","Ready","Reset","Maintenance","InUse","Error","Decommissioned","Unknown"]},"MachineSummary":{"title":"MachineSummary","type":"object","description":"Describes a subset of core attributes for a Machine","examples":[{"id":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerMachineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerMachineType":"x86_64","hwSkuDeviceType":"cpu","vendor":"Lenovo","productName":"ThinkSystem SR670 V2","maintenanceMessage":null,"status":"Ready"}],"properties":{"id":{"type":"string","description":"Unique ID of Machine","readOnly":true},"controllerMachineId":{"type":"string","description":"ID of the Machine at Site, now same as the primary ID"},"controllerMachineType":{"type":["string","null"],"description":"Denotes architecture (x86 vs ARM) of the Machine"},"hwSkuDeviceType":{"type":["string","null"],"description":"SKU derived device type of the machine, e.g. cpu, gpu, cache, storage, etc."},"vendor":{"type":["string","null"],"description":"Name of the vendor of the Machine"},"productName":{"type":["string","null"],"description":"Product name of the Machine"},"maintenanceMessage":{"type":["string","null"],"description":"If the Machine is in maintenance mode, this message will typically describe the reason and how long it is expected to be in maintenance"},"status":{"$ref":"#/components/schemas/MachineStatus","readOnly":true}}},"MachineHealthIssue":{"title":"MachineHealthIssue","type":"object","required":["category","summary","details"],"properties":{"category":{"type":"string","enum":["Hardware","Network","Performance","Storage","Software","Other"],"description":"High-level category for the tenant-reported issue."},"summary":{"type":["string","null"],"maxLength":512,"description":"Brief description of the issue for operators."},"details":{"type":["string","null"],"maxLength":8192,"description":"Diagnostic information, logs, ticket numbers, etc."}}},"MachineOnlineRepairPolicy":{"title":"MachineOnlineRepairPolicy","type":"object","required":["allowAutoInstanceDeletionOnFailure"],"properties":{"allowAutoInstanceDeletionOnFailure":{"type":"boolean","description":"When true, escalation to offline breakfix (permanent delete / deallocate) is allowed if online repair cannot be completed."}}},"MachineOnlineRepairAcknowledgments":{"title":"MachineOnlineRepairAcknowledgments","type":"object","required":["acceptDataCorruptionRisk","acceptRepairTeamAccess","acceptInstanceDeletionRisk"],"properties":{"acceptDataCorruptionRisk":{"type":"boolean","enum":[true],"description":"Tenant confirms data may be corrupted during repair."},"acceptRepairTeamAccess":{"type":"boolean","enum":[true],"description":"Tenant confirms the dedicated repair team will have access to the instance."},"acceptInstanceDeletionRisk":{"type":"boolean","enum":[true],"description":"Tenant confirms risk of instance deletion if escalation to offline breakfix occurs."}}},"MachineOnlineRepair":{"title":"MachineOnlineRepair","type":"object","required":["enabled"],"description":"Enable or disable online repair of a Machine. Online repair facilitates repairing a Machine without the Tenant having to release the Machine by deleting the Instance. When `enabled` is true, `policy` and `acknowledgments` are required inside this object,\nand `healthIssue` is required at the top level of the MachineUpdateRequest. When `enabled` is false, none of those fields may be set.","properties":{"enabled":{"type":"boolean","description":"When true, initiates the online repair process: applies the tenant-reported OnlineRepair health override on the Machine and sets the associated Instance status to Repairing.\nWhen false, exits online repair: clears the health override and returns the Instance to Ready. Cannot be combined with instance type, maintenance, or label updates in the same request."},"policy":{"$ref":"#/components/schemas/MachineOnlineRepairPolicy"},"acknowledgments":{"$ref":"#/components/schemas/MachineOnlineRepairAcknowledgments"}}},"MachineUpdateRequest":{"title":"MachineUpdateRequest","type":"object","examples":[{"instanceTypeId":"2e016c02-2c67-48aa-b289-5d3ca6320c52"},{"clearInstanceType":true},{"setMaintenanceMode":true,"maintenanceMessage":"Machine requires re-cabling to connect with revised underlay network. Estimated maintenance time is 2 days"},{"setMaintenanceMode":false},{"labels":{"RackIdentifier":"GVX11F01C02","ServerName":"SITE1-C03-Server-02","RepairStatus":"InProgress"}},{"onlineRepair":{"enabled":true,"policy":{"allowAutoInstanceDeletionOnFailure":false},"acknowledgments":{"acceptDataCorruptionRisk":true,"acceptRepairTeamAccess":true,"acceptInstanceDeletionRisk":true}}},{"healthIssue":{"category":"Storage","summary":"Disk errors on OSD","details":"Ticket FORGE-12345; smartctl logs attached"}}],"description":"Request data to update Machine. Instance Type attribute updates, maintenance attribute updates, labels updates, and in-pool online repair (enter or exit) must be specified in separate requests. They cannot be processed at the same time.","properties":{"instanceTypeId":{"type":["string","null"],"minLength":2,"maxLength":256,"format":"uuid","description":"Update the Instance Type of the Machine. Cannot be specified when clearing Instance Type. Can only be updated by Provider."},"clearInstanceType":{"type":["boolean","null"],"description":"Set to true to clear the existing Instance Type. Cannot be specified if Instance Type ID is specified. Can only be set by Provider."},"setMaintenanceMode":{"type":["boolean","null"],"description":"Set to `true` to enable maintenance mode and to `false` to disable maintenance mode. Can be set by Provider or Privileged Tenant."},"maintenanceMessage":{"type":["string","null"],"description":"Optional message describing the reason for moving Machine into maintenance mode. Can be updated by Provider or Privileged Tenant.","minLength":5,"maxLength":256},"labels":{"description":"Machine labels will be overwritten, include existing labels to preserve them. Can be updated by Provider or Privileged Tenant.","$ref":"#/components/schemas/Labels"},"onlineRepair":{"$ref":"#/components/schemas/MachineOnlineRepair"},"healthIssue":{"description":"Required when `onlineRepair.enabled` is true. Must not be set when exiting online repair (`onlineRepair.enabled` false).","$ref":"#/components/schemas/MachineHealthIssue"}}},"MachineInterface":{"title":"MachineInterface","type":"object","description":"Describes an interface attached to a machine","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerInterfaceId":"ad3dac49-741d-4c1f-815c-c020127c532f","controllerSegmentId":"f2207a3c-1847-42e5-bf2c-cd015f87a2bc","attachedDpuMachineID":"fm100dsg4ekcb4sdi6hkqn0iojhj18okrr8vct64luh8957lfe8e69vme20","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","hostname":"example.com","isPrimary":true,"macAddress":"00:00:5e:00:53:af","ipAddresses":["192.156.7.23","202.88.37.112"],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid"},"machineId":{"type":"string"},"controllerInterfaceId":{"type":["string","null"],"format":"uuid"},"controllerSegmentId":{"type":["string","null"],"format":"uuid"},"attachedDpuMachineID":{"type":["string","null"]},"subnetId":{"type":["string","null"],"format":"uuid"},"hostname":{"type":["string","null"],"format":"hostname"},"isPrimary":{"type":"boolean"},"macAddress":{"type":["string","null"]},"ipAddresses":{"type":"array","description":"Array of IP addresses","items":{"type":"string"}},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"MachineMetadata":{"title":"MachineMetadata","type":"object","description":"Describes metadata for various Machine components","examples":[{"dmiData":{"boardName":"7Z23CTOLWB","boardSerial":".C1KS2CS002G.","boardVersion":"06","biosDate":"03/30/2023","biosVersion":"U8E122J-1.51","productSerial":"J1050ACR","chassisSerial":"J1050ACR"},"bmcInfo":{"ip":"10.217.133.5","mac":"C8:4B:D6:7A:C9:8A","version":"1","firmwareRevision":"6.00"},"gpus":[{"name":"NVIDIA H100 PCIe","serial":"1654422006434","driverVersion":"530.30.02","vbiosVersion":"96.00.30.00.01","inforomVersion":"1010.0200.00.02","totalMemory":"81559 MiB","frequency":"1755 MHz","pciBusId":"00000000:17:00.0"}],"networkInterfaces":[{"macAddress":"c8:4b:d6:7b:ac:a8","vendor":"Broadcom Inc. and subsidiaries","device":"NetXtreme BCM5720 Gigabit Ethernet PCIe (PowerEdge Rx5xx LOM Board)","path":"/devices/pci0000:00/0000:00:1c.5/0000:04:00.0/net/eno8303","numaNode":0,"description":"NetXtreme BCM5720 Gigabit Ethernet PCIe (PowerEdge Rx5xx LOM Board)","slot":"0000:04:00.0"}],"infinibandInterfaces":[{"guid":"1070fd0300bd43ac","vendor":"Mellanox Technologies","device":"MT28908 Family [ConnectX-6]","path":"/devices/pci0000:c9/0000:c9:02.0/0000:ca:00.0/infiniband/ibp202s0f0","numaNode":1,"description":"MT28908 Family [ConnectX-6]","slot":"0000:ca:00.0"}]}],"properties":{"dmiData":{"$ref":"#/components/schemas/MachineDMIData"},"bmcInfo":{"$ref":"#/components/schemas/MachineBMCInfo"},"gpus":{"type":"array","items":{"$ref":"#/components/schemas/MachineGPUInfo"}},"networkInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/MachineNetworkInterface"}},"infinibandInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/MachineInfiniBandInterface"}}}},"MachineBMCInfo":{"title":"MachineBMCInfo","type":"object","description":"Describes BMC information of a Machine","examples":[{"ip":"10.217.133.5","mac":"C8:4B:D6:7A:C9:8A","version":"1","firmwareRevision":"6.00"}],"properties":{"ip":{"type":["string","null"],"format":"ipv4"},"mac":{"type":["string","null"]},"version":{"type":["string","null"]},"firmwareRevision":{"type":["string","null"]}}},"MachineDMIData":{"title":"MachineDMIData","type":"object","description":"Describes DMI data of a Machine","examples":[{"boardName":"7Z23CTOLWB","boardSerial":".C1KS2CS002G.","boardVersion":"06","biosDate":"03/30/2023","biosVersion":"U8E122J-1.51","productSerial":"J1050ACR","chassisSerial":"J1050ACR"}],"properties":{"boardName":{"type":["string","null"]},"boardSerial":{"type":["string","null"]},"boardVersion":{"type":["string","null"]},"biosDate":{"type":["string","null"]},"biosVersion":{"type":["string","null"]},"productSerial":{"type":["string","null"]},"chassisSerial":{"type":["string","null"]}}},"MachineGPUInfo":{"title":"MachineGPUInfo","type":"object","description":"Describes information about GPU of a Machine","examples":[{"name":"NVIDIA H100 PCIe","serial":"1654422006434","driverVersion":"530.30.02","vbiosVersion":"96.00.30.00.01","inforomVersion":"1010.0200.00.02","totalMemory":"81559 MiB","frequency":"1755 MHz","pciBusId":"00000000:17:00.0"}],"properties":{"name":{"type":["string","null"]},"serial":{"type":["string","null"]},"driverVersion":{"type":["string","null"]},"vbiosVersion":{"type":["string","null"]},"inforomVersion":{"type":["string","null"]},"totalMemory":{"type":["string","null"]},"frequency":{"type":["string","null"]},"pciBusId":{"type":["string","null"]}}},"MachineHealth":{"title":"MachineHealth","type":"object","description":"Describes results of various Machine health probes and alerts","examples":[{"source":"aggregate-host-health","observedAt":null,"successes":[{"id":"BgpDaemonEnabled","target":null},{"id":"BgpStats","target":null},{"id":"DhcpServer","target":null},{"id":"DpuDiskUtilizationCheck","target":null},{"id":"FanSpeed","target":"System Board Fan1A"},{"id":"PowerSupply","target":"PS1 Status"},{"id":"Temperature","target":"CPU1 Temp"},{"id":"Temperature","target":"System Board Exhaust Temp"},{"id":"Voltage","target":"CPU1 1P8 PG"}],"alerts":[{"id":"FailedValidationTest","target":"DcgmFullShort","inAlertSince":null,"message":"Failed validation test:\nName:DcgmFullShort\nCommand:dcgmi\nArgs:diag -r 2","tenantMessage":null,"classifications":["PreventAllocations"]}]}],"properties":{"source":{"type":"string","description":"Describes how the health report was generated"},"observedAt":{"type":["string","null"],"description":"Date/time when health report was generated"},"successes":{"type":"array","items":{"$ref":"#/components/schemas/MachineHealthProbeSuccess"},"description":"Results from successful health probes for the Machine"},"alerts":{"type":"array","items":{"$ref":"#/components/schemas/MachineHealthProbeAlert"},"description":"Results from failed health probes for the Machine"}}},"MachineHealthProbeSuccess":{"title":"MachineHealthProbeSuccess","type":"object","description":"Describes results of successful Machine health probe","examples":[{"id":"FanSpeed","target":"System Board Fan1A"}],"properties":{"id":{"type":"string","description":"Health probe identifier"},"target":{"type":["string","null"],"description":"Specific component targeted by health probe"}}},"MachineHealthProbeAlert":{"title":"MachineHealthProbeAlert","type":"object","description":"Describes results of a failed Machine health probe","examples":[{"id":"FailedValidationTest","target":"DcgmFullShort","inAlertSince":null,"message":"Failed validation test:\nName:DcgmFullShort\nCommand:dcgmi\nArgs:diag -r 2","tenantMessage":null,"classifications":["PreventAllocations"]}],"properties":{"id":{"type":"string","description":"Health probe identifier"},"target":{"type":["string","null"],"description":"Specific component targeted by health probe"},"inAlertSince":{"type":["string","null"],"description":"Date/time since the alert has been in effect"},"message":{"type":"string","description":"Details of the failed health probe result"},"tenantMessage":{"type":["string","null"],"description":"Information provided by Tenant, if any"},"classifications":{"type":"array","items":{"type":"string"},"description":"Classifications for this alert, category or impact"}}},"MachineNetworkInterface":{"title":"MachineNetworkInterface","type":"object","description":"Describes information about an Ethernet Interface of a Machine","examples":[{"macAddress":"c8:4b:d6:7b:ac:a8","vendor":"Broadcom Inc. and subsidiaries","device":"NetXtreme BCM5720 Gigabit Ethernet PCIe (PowerEdge Rx5xx LOM Board)","path":"/devices/pci0000:00/0000:00:1c.5/0000:04:00.0/net/eno8303","numaNode":0,"description":"NetXtreme BCM5720 Gigabit Ethernet PCIe (PowerEdge Rx5xx LOM Board)","slot":"0000:04:00.0"}],"properties":{"macAddress":{"type":["string","null"]},"vendor":{"type":["string","null"]},"device":{"type":["string","null"]},"path":{"type":["string","null"]},"numaNode":{"type":"integer"},"description":{"type":["string","null"]},"slot":{"type":["string","null"]}}},"MachineInfiniBandInterface":{"title":"MachineInfiniBandInterface","description":"Describes information about an Infiniband Interface of a Machine","type":"object","examples":[{"guid":"1070fd0300bd43ac","vendor":"Mellanox Technologies","device":"MT28908 Family [ConnectX-6]","path":"/devices/pci0000:c9/0000:c9:02.0/0000:ca:00.0/infiniband/ibp202s0f0","numaNode":1,"description":"MT28908 Family [ConnectX-6]","slot":"0000:ca:00.0"}],"properties":{"guid":{"type":["string","null"]},"vendor":{"type":["string","null"]},"device":{"type":["string","null"]},"path":{"type":["string","null"]},"numaNode":{"type":"integer"},"description":{"type":["string","null"]},"slot":{"type":["string","null"]}}},"MachineInstanceType":{"title":"MachineInstanceType","type":"object","description":"Associates a machine with an Instance Type","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","deprecations":[{"attribute":"id","replacedBy":"machineId","takeActionBy":"2026-07-09T00:00:00Z","notice":"'id' is being deprecated in favor of 'machineId'. Please take action prior to the specified date."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true,"description":"Deprecated: Use `machineId` when identifying a Machine/Instance Type association. This field will be removed on July 9th, 2026 0:00 UTC.","deprecated":true},"machineId":{"type":"string"},"instanceTypeId":{"type":"string","format":"uuid"},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"}},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time"}}},"MachineInstanceTypeCreateRequest":{"title":"MachineInstanceTypeCreateRequest","type":"object","description":"Associates one or more Machines with an Instance Type.\n\nThe Machine's capabilities must be a superset of the Instance Type's required capabilities for the association to succeed.","examples":[{"machineIds":["fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","fm100htrh18t1lrjg2pqagkh3sfigr9m65dejvkq168ako07sc0uibpp5q0","fm100ht68sf2m52idrpslcjkpdj5r3tb3j5o0bkfubhoglbq47u18nknfog"]}],"properties":{"machineIds":{"type":"array","minItems":1,"items":{"type":"string"}}},"required":["machineIds"]},"ExpectedMachine":{"title":"ExpectedMachine","type":"object","description":"An Expected Machine represents a physical machine that is expected to be discovered at a site, with hardware identifiers and metadata.\n\nNote: BMC credentials (username/password) are only accepted during creation and updates but are not returned in responses.","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","bmcIpAddress":"192.168.1.100","chassisSerialNumber":"CHASSIS-12345","fallbackDPUSerialNumbers":["DPU-001","DPU-002"],"skuId":"lenovo.sr650v2.cpu.1","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","rackId":"rack-01","manufacturer":"Lenovo","labels":{"environment":"production","rack":"A1"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the Expected Machine","readOnly":true},"siteId":{"type":"string","format":"uuid","description":"ID of the site the Expected Machine belongs to","readOnly":true},"bmcMacAddress":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Machine's BMC (Baseboard Management Controller)"},"chassisSerialNumber":{"type":"string","description":"Serial number of the Expected Machine's chassis"},"fallbackDPUSerialNumbers":{"type":"array","description":"Serial numbers of the Expected Machine's fallback DPUs (Data Processing Units)","items":{"type":"string"}},"skuId":{"type":["string","null"],"description":"Optional ID of the SKU associated with this Expected Machine"},"sku":{"$ref":"#/components/schemas/Sku","description":"SKU information for this Expected Machine (populated when includeRelation=Sku is specified)"},"machineId":{"type":["string","null"],"description":"Optional ID of the Machine associated with this Expected Machine"},"machine":{"$ref":"#/components/schemas/MachineSummary","description":"Machine information for this Expected Machine (populated when includeRelation=Machine is specified)"},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Machines"},"created":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the Expected Machine was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the Expected Machine was last updated","readOnly":true}}},"ExpectedMachineCreateRequest":{"title":"ExpectedMachineCreateRequest","type":"object","description":"Request data to create a new ExpectedMachine.\n\nNote: BMC credentials (username/password) are only accepted during creation and updates but are not returned in responses.","examples":[{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","bmcIpAddress":"192.168.1.100","defaultBmcUsername":"admin","defaultBmcPassword":"password123","chassisSerialNumber":"CHASSIS-12345","fallbackDPUSerialNumbers":["DPU-001","DPU-002"],"skuId":"lenovo.sr650v2.cpu.1","rackId":"rack-01","manufacturer":"Lenovo","labels":{"environment":"production","rack":"A1"}}],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the site the Expected Machine belongs to"},"bmcMacAddress":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Machine's BMC (Baseboard Management Controller)"},"defaultBmcUsername":{"type":["string","null"],"maxLength":20,"description":"Username for accessing the Expected Machine's BMC"},"defaultBmcPassword":{"type":["string","null"],"maxLength":50,"description":"Password for accessing the Expected Machine's BMC"},"chassisSerialNumber":{"type":"string","minLength":1,"maxLength":100,"description":"Serial number of the Expected Machine's chassis"},"fallbackDPUSerialNumbers":{"type":["array","null"],"description":"Serial numbers of the Expected Machine's fallback DPUs (Data Processing Units)","items":{"type":"string"}},"skuId":{"type":["string","null"],"description":"Optional ID of the SKU to associate with this Expected Machine"},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Machines"}},"required":["siteId","bmcMacAddress","chassisSerialNumber"]},"ExpectedMachineUpdateRequest":{"title":"ExpectedMachineUpdateRequest","type":"object","description":"Request data to update an existing Expected Machine.\n\nNote: BMC credentials (username/password) are only accepted during creation and updates but are not returned in responses.\n\nFor single updates (PATCH /expected-machine/{id}), the id field is optional in body and will be ignored if provided (the ID from the URL path is used).\n\nFor batch updates (PATCH /expected-machine/batch), the id field is required to identify which Expected Machine to update.","examples":[{"defaultBmcUsername":"newadmin","defaultBmcPassword":"newpassword123","chassisSerialNumber":"CHASSIS-54321","skuId":"sku-xyz789","rackId":"rack-02","manufacturer":"Lenovo","labels":{"environment":"staging","rack":"B2"}}],"properties":{"id":{"type":["string","null"],"format":"uuid","description":"ID of the Expected Machine to update.\n\nOptional for individual Expected Machine update (ignored if provided, ID from URL path is used).\n\nRequired for batch update operations."},"bmcMacAddress":{"type":["string","null"],"pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Machine's BMC (Baseboard Management Controller)"},"defaultBmcUsername":{"type":["string","null"],"maxLength":20,"description":"Username for accessing the Expected Machine's BMC"},"defaultBmcPassword":{"type":["string","null"],"maxLength":50,"description":"Password for accessing the Expected Machine's BMC"},"chassisSerialNumber":{"type":["string","null"],"minLength":1,"maxLength":100,"description":"Serial number of the Expected Machine's chassis"},"fallbackDPUSerialNumbers":{"type":["array","null"],"description":"Serial numbers of the Expected Machine's fallback DPUs (Data Processing Units)","items":{"type":"string"}},"skuId":{"type":["string","null"],"description":"Optional ID of the SKU to associate with this Expected Machine"},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Machines"}}},"ExpectedPowerShelf":{"title":"ExpectedPowerShelf","type":"object","description":"An Expected Power Shelf represents a power shelf that is expected to be discovered at a site, with hardware identifiers and metadata.\n\nNote: BMC credentials (username/password) are only accepted during creation and updates but are not returned in responses.","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","shelfSerialNumber":"SHELF-12345","bmcIpAddress":"192.168.1.100","rackId":"rack-01","manufacturer":"Delta","labels":{"environment":"production","rack":"A1"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the Expected Power Shelf","readOnly":true},"siteId":{"type":"string","format":"uuid","description":"ID of the site the Expected Power Shelf belongs to","readOnly":true},"bmcMacAddress":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Power Shelf's BMC (Baseboard Management Controller)"},"shelfSerialNumber":{"type":"string","description":"Serial number of the Expected Power Shelf"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Power Shelves"},"created":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the Expected Power Shelf was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the Expected Power Shelf was last updated","readOnly":true}}},"ExpectedPowerShelfCreateRequest":{"title":"ExpectedPowerShelfCreateRequest","type":"object","description":"Request data to create a new Expected Power Shelf.\n\nNote: BMC credentials (username/password) are only accepted during creation and updates but are not returned in responses.","examples":[{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","defaultBmcUsername":"admin","defaultBmcPassword":"password123","shelfSerialNumber":"SHELF-12345","bmcIpAddress":"192.168.1.100","rackId":"rack-01","manufacturer":"Delta","labels":{"environment":"production","rack":"A1"}}],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the site the Expected Power Shelf belongs to"},"bmcMacAddress":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Power Shelf's BMC (Baseboard Management Controller)"},"defaultBmcUsername":{"type":["string","null"],"maxLength":16,"description":"Username for accessing the Expected Power Shelf's BMC"},"defaultBmcPassword":{"type":["string","null"],"maxLength":20,"description":"Password for accessing the Expected Power Shelf's BMC"},"shelfSerialNumber":{"type":"string","minLength":1,"maxLength":32,"description":"Serial number of the Expected Power Shelf"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Power Shelves"}},"required":["siteId","bmcMacAddress","shelfSerialNumber"]},"ExpectedPowerShelfUpdateRequest":{"title":"ExpectedPowerShelfUpdateRequest","type":"object","description":"Request data to update an existing Expected Power Shelf.\n\nNote: BMC credentials (username/password) are only accepted during creation and updates but are not returned in responses.","examples":[{"defaultBmcUsername":"newadmin","defaultBmcPassword":"newpassword123","shelfSerialNumber":"SHELF-54321","bmcIpAddress":"192.168.1.200","rackId":"rack-02","manufacturer":"Delta","labels":{"environment":"staging","rack":"B2"}}],"properties":{"id":{"type":["string","null"],"format":"uuid","description":"ID of the Expected Power Shelf to update (ignored for single update, used for identification in batch operations)."},"bmcMacAddress":{"type":["string","null"],"pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Power Shelf's BMC (Baseboard Management Controller)"},"defaultBmcUsername":{"type":["string","null"],"maxLength":16,"description":"Username for accessing the Expected Power Shelf's BMC"},"defaultBmcPassword":{"type":["string","null"],"maxLength":20,"description":"Password for accessing the Expected Power Shelf's BMC"},"shelfSerialNumber":{"type":["string","null"],"minLength":1,"maxLength":32,"description":"Serial number of the Expected Power Shelf"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Power Shelves"}}},"ExpectedRack":{"title":"ExpectedRack","type":"object","description":"An Expected Rack represents a rack that is expected to be discovered at a Site. The `rackId` is an operator-supplied string identifier (not a UUID) that uniquely identifies the rack within the Site. Each Expected Rack references a Rack Profile that describes the rack's expected layout and capabilities.\n\nChassis identity and physical location information are conveyed via well-known label keys in `labels`:\n- `chassis.manufacturer`, `chassis.serial-number`, `chassis.model`\n- `location.region`, `location.datacenter`, `location.room`, `location.position`","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","rackId":"rack-01","siteId":"f97df110-f4de-492e-8849-4a6af68026b0","rackProfileId":"rp-standard-42u","name":"Rack 01","description":"Production rack in row A","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001001","chassis.model":"GB200-NVL72","location.region":"us-west-2","location.datacenter":"phx-dc01","location.room":"room-1","location.position":"A1"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier (UUID) for the Expected Rack","readOnly":true},"rackId":{"type":"string","description":"Operator-supplied identifier for the rack (string, not UUID). Unique within a Site.","readOnly":true},"siteId":{"type":"string","format":"uuid","description":"ID of the Site the Expected Rack belongs to","readOnly":true},"rackProfileId":{"type":"string","description":"Identifier of the Rack Profile this rack conforms to"},"name":{"type":"string","description":"Human-readable name of the Expected Rack"},"description":{"type":"string","description":"Human-readable description of the Expected Rack"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Racks. Well-known keys (`chassis.*`, `location.*`) are used to convey chassis identity and physical location."},"created":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the Expected Rack was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the Expected Rack was last updated","readOnly":true}}},"ExpectedRackCreateRequest":{"title":"ExpectedRackCreateRequest","type":"object","description":"Request data to create a new Expected Rack.\n\nThe `rackId` is an operator-supplied string identifier (not a UUID) that must be unique within the Site. Chassis identity and physical location information are conveyed via well-known label keys in `labels`:\n- `chassis.manufacturer`, `chassis.serial-number`, `chassis.model`\n- `location.region`, `location.datacenter`, `location.room`, `location.position`","examples":[{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","rackId":"rack-01","rackProfileId":"rp-standard-42u","name":"Rack 01","description":"Production rack in row A","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001001","chassis.model":"GB200-NVL72","location.region":"us-west-2","location.datacenter":"phx-dc01","location.room":"room-1","location.position":"A1"}}],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site the Expected Rack belongs to"},"rackId":{"type":"string","minLength":1,"description":"Operator-supplied identifier for the rack (string, not UUID). Must be non-empty and unique within the Site."},"rackProfileId":{"type":"string","minLength":1,"description":"Identifier of the Rack Profile this rack conforms to. Must be non-empty."},"name":{"type":["string","null"],"minLength":1,"description":"Human-readable name of the Expected Rack"},"description":{"type":["string","null"],"minLength":1,"description":"Human-readable description of the Expected Rack"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Racks. Well-known keys (`chassis.*`, `location.*`) are used to convey chassis identity and physical location."}},"required":["siteId","rackId","rackProfileId"]},"ExpectedRackList":{"title":"ExpectedRackList","type":"object","description":"Replace-all request body for Expected Racks. The `expectedRacks` array contains the full desired set of Expected Racks for the Site identified by `siteId`. All entries must reference the same `siteId` as the top-level field, and `rackId` values must be unique within the request. The array may be empty to clear all Expected Racks for the Site.","examples":[{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","expectedRacks":[{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","rackId":"rack-01","rackProfileId":"rp-standard-42u","name":"Rack 01","description":"Production rack in row A","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001001","chassis.model":"GB200-NVL72","location.datacenter":"phx-dc01","location.position":"A1"}},{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","rackId":"rack-02","rackProfileId":"rp-standard-42u","name":"Rack 02","description":"Production rack in row A","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001002","chassis.model":"GB200-NVL72","location.datacenter":"phx-dc01","location.position":"A2"}}]}],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site whose Expected Racks should be replaced"},"expectedRacks":{"type":"array","description":"The full desired set of Expected Racks for the Site. Every entry must reference the same `siteId` as the top-level field, and `rackId` values must be unique within the request. May be empty to clear all Expected Racks for the Site.","items":{"$ref":"#/components/schemas/ExpectedRackCreateRequest"}}},"required":["siteId","expectedRacks"]},"ExpectedRackUpdateRequest":{"title":"ExpectedRackUpdateRequest","type":"object","description":"Request data to update an existing Expected Rack.\n\nFor single updates (PATCH /expected-rack/{id}), the `id` field is optional in the body and will be ignored if provided (the `id` from the URL path is used).\n\nChassis identity and physical location information are conveyed via well-known label keys in `labels`:\n- `chassis.manufacturer`, `chassis.serial-number`, `chassis.model`\n- `location.region`, `location.datacenter`, `location.room`, `location.position`","examples":[{"rackProfileId":"rp-standard-48u","name":"Rack 01 (updated)","description":"Production rack in row A, upgraded chassis","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001001","chassis.model":"GB200-NVL72","location.datacenter":"phx-dc01","location.position":"A1"}}],"properties":{"id":{"type":["string","null"],"format":"uuid","description":"Unique identifier (UUID) of the Expected Rack to update. Optional for single Expected Rack update (must be empty or match the id from the URL path)."},"rackId":{"type":["string","null"],"minLength":1,"description":"Optional new operator-supplied rack identifier. If provided, must be non-empty and unique within the Site."},"rackProfileId":{"type":["string","null"],"minLength":1,"description":"Optional new Rack Profile identifier. If provided, must be non-empty."},"name":{"type":["string","null"],"minLength":1,"description":"Human-readable name of the Expected Rack"},"description":{"type":["string","null"],"minLength":1,"description":"Human-readable description of the Expected Rack"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Racks. Well-known keys (`chassis.*`, `location.*`) are used to convey chassis identity and physical location."}}},"ExpectedSwitch":{"title":"ExpectedSwitch","type":"object","description":"An Expected Switch represents a network switch that is expected to be discovered at a site, with hardware identifiers and metadata.\n\nNote: BMC and NvOS credentials (username/password) are only accepted during creation and updates but are not returned in responses.","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","bmcIpAddress":"192.168.1.100","switchSerialNumber":"SWITCH-12345","rackId":"rack-01","manufacturer":"NVIDIA","labels":{"environment":"production","rack":"A1"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the Expected Switch","readOnly":true},"siteId":{"type":"string","format":"uuid","description":"ID of the site the Expected Switch belongs to","readOnly":true},"bmcMacAddress":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Switch's BMC (Baseboard Management Controller)"},"switchSerialNumber":{"type":"string","description":"Serial number of the Expected Switch"},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Switches"},"created":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the Expected Switch was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the Expected Switch was last updated","readOnly":true}}},"ExpectedSwitchCreateRequest":{"title":"ExpectedSwitchCreateRequest","type":"object","description":"Request data to create a new Expected Switch.\n\nNote: BMC and NvOS credentials (username/password) are only accepted during creation and updates but are not returned in responses.","examples":[{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","bmcIpAddress":"192.168.1.100","defaultBmcUsername":"admin","defaultBmcPassword":"password123","switchSerialNumber":"SWITCH-12345","nvOsUsername":"nvadmin","nvOsPassword":"nvpassword123","rackId":"rack-01","manufacturer":"NVIDIA","labels":{"environment":"production","rack":"A1"}}],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the site the Expected Switch belongs to"},"bmcMacAddress":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Switch's BMC (Baseboard Management Controller)"},"defaultBmcUsername":{"type":["string","null"],"maxLength":16,"description":"Username for accessing the Expected Switch's BMC"},"defaultBmcPassword":{"type":["string","null"],"maxLength":20,"description":"Password for accessing the Expected Switch's BMC"},"switchSerialNumber":{"type":"string","minLength":1,"maxLength":32,"description":"Serial number of the Expected Switch"},"nvOsUsername":{"type":["string","null"],"description":"NvOS username for the Expected Switch"},"nvOsPassword":{"type":["string","null"],"description":"NvOS password for the Expected Switch"},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Switches"}},"required":["siteId","bmcMacAddress","switchSerialNumber"]},"ExpectedSwitchUpdateRequest":{"title":"ExpectedSwitchUpdateRequest","type":"object","description":"Request data to update an existing Expected Switch.\n\nNote: BMC and NvOS credentials (username/password) are only accepted during creation and updates but are not returned in responses.","examples":[{"defaultBmcUsername":"newadmin","defaultBmcPassword":"newpassword123","switchSerialNumber":"SWITCH-54321","nvOsUsername":"newnvadmin","nvOsPassword":"newnvpassword123","rackId":"rack-02","manufacturer":"NVIDIA","labels":{"environment":"staging","rack":"B2"}}],"properties":{"id":{"type":["string","null"],"format":"uuid","description":"ID of the Expected Switch to update (ignored for single update, used for identification in batch operations)."},"bmcMacAddress":{"type":["string","null"],"pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Switch's BMC (Baseboard Management Controller)"},"defaultBmcUsername":{"type":["string","null"],"maxLength":16,"description":"Username for accessing the Expected Switch's BMC"},"defaultBmcPassword":{"type":["string","null"],"maxLength":20,"description":"Password for accessing the Expected Switch's BMC"},"switchSerialNumber":{"type":["string","null"],"minLength":1,"maxLength":32,"description":"Serial number of the Expected Switch"},"nvOsUsername":{"type":["string","null"],"description":"NvOS username for the Expected Switch"},"nvOsPassword":{"type":["string","null"],"description":"NvOS password for the Expected Switch"},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Switches"}}},"Sku":{"title":"Sku","type":"object","description":"A SKU (Stock Keeping Unit) represents a unique hardware configuration discovered at a site.\nSKUs are automatically derived from machine hardware characteristics and used to group similar machines.","examples":[{"id":"lenovo.sr650v2.cpu.1","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","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"}],"properties":{"id":{"type":"string","description":"Unique identifier for the SKU","readOnly":true},"siteId":{"type":"string","format":"uuid","description":"ID of the Site this SKU belongs to","readOnly":true},"deviceType":{"type":["string","null"],"description":"Optional device type identifier (e.g. \"gpu\", \"cpu\", \"storage\")","readOnly":true},"associatedMachineIds":{"type":"array","description":"List of machine IDs associated with this SKU","items":{"type":"string"},"readOnly":true},"components":{"$ref":"#/components/schemas/SkuComponents","description":"Hardware components of this SKU"},"created":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the SKU was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the SKU was last updated","readOnly":true}}},"SkuComponents":{"title":"SkuComponents","type":"object","description":"Hardware components that make up a SKU","properties":{"cpus":{"type":"array","description":"CPU components","items":{"$ref":"#/components/schemas/SkuCpu"}},"gpus":{"type":"array","description":"GPU components","items":{"$ref":"#/components/schemas/SkuGpu"}},"memory":{"type":"array","description":"Memory components","items":{"$ref":"#/components/schemas/SkuMemory"}},"storage":{"type":"array","description":"Storage components","items":{"$ref":"#/components/schemas/SkuStorage"}},"chassis":{"$ref":"#/components/schemas/SkuChassis","description":"Chassis component"},"ethernetDevices":{"type":"array","description":"Ethernet device components","items":{"$ref":"#/components/schemas/SkuEthernetDevice"}},"infinibandDevices":{"type":"array","description":"Infiniband device components","items":{"$ref":"#/components/schemas/SkuInfinibandDevice"}},"tpm":{"type":"array","description":"TPM components","items":{"$ref":"#/components/schemas/SkuTpm"}}}},"SkuCpu":{"title":"SkuCpu","type":"object","description":"CPU component in a SKU","properties":{"vendor":{"type":"string","description":"Vendor of the CPU"},"model":{"type":"string","description":"Model of the CPU"},"threadCount":{"type":"integer","format":"uint32","description":"Number of threads for the CPU"},"count":{"type":"integer","format":"uint32","description":"Number of CPUs present"}}},"SkuGpu":{"title":"SkuGpu","type":"object","description":"GPU component in a SKU","properties":{"vendor":{"type":"string","description":"Vendor of the GPU"},"model":{"type":"string","description":"Model of the GPU"},"totalMemory":{"type":"string","description":"Total memory of the GPU (e.g. \"80GB HBM3\")"},"count":{"type":"integer","format":"uint32","description":"Number of GPUs present"}}},"SkuMemory":{"title":"SkuMemory","type":"object","description":"Memory component in a SKU","properties":{"capacityMb":{"type":"integer","format":"uint32","description":"Capacity in megabytes"},"memoryType":{"type":"string","description":"Type of memory (e.g. \"DDR4\", \"DDR5\")"},"count":{"type":"integer","format":"uint32","description":"Number of memory modules present"}}},"SkuStorage":{"title":"SkuStorage","type":"object","description":"Storage component in a SKU","properties":{"vendor":{"type":"string","description":"Vendor of the storage device"},"model":{"type":"string","description":"Model of the storage device"},"capacityMb":{"type":"integer","format":"uint32","description":"Capacity in megabytes"},"count":{"type":"integer","format":"uint32","description":"Number of storage devices present"}}},"SkuChassis":{"title":"SkuChassis","type":"object","description":"Chassis component in a SKU","properties":{"vendor":{"type":"string","description":"Vendor of the chassis"},"model":{"type":"string","description":"Model of the chassis"}}},"SkuEthernetDevice":{"title":"SkuEthernetDevice","type":"object","description":"Ethernet device component in a SKU","properties":{"vendor":{"type":"string","description":"Vendor of the ethernet device"},"model":{"type":"string","description":"Model of the ethernet device"},"count":{"type":"integer","format":"uint32","description":"Number of ethernet devices present"}}},"SkuInfinibandDevice":{"title":"SkuInfinibandDevice","type":"object","description":"Infiniband device component in a SKU","properties":{"vendor":{"type":"string","description":"Vendor of the infiniband device"},"model":{"type":"string","description":"Model of the infiniband device"},"count":{"type":"integer","format":"uint32","description":"Number of infiniband devices present"}}},"SkuTpm":{"title":"SkuTpm","type":"object","description":"TPM component in a SKU","properties":{"vendor":{"type":"string","description":"Vendor of the TPM"},"model":{"type":"string","description":"Model of the TPM"},"count":{"type":"integer","format":"uint32","description":"Number of TPMs present"}}},"IpBlock":{"title":"IpBlock","type":"object","description":"IP block contains information about an IPv4 address pool owned by the Infrastructure Provider and assigned as an overlay network for a particular Site. It is equivalent to Network Resource in product terminology.","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Public Network Overlay for Site SJC4","description":"This is the primary IP overlay for SJC4. All IPs are publicly routable","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantId":null,"routingType":"Public","prefix":"202.168.16.0","prefixLength":20,"protocolVersion":"IPv4","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"siteId":{"type":"string","format":"uuid"},"infrastructureProviderId":{"type":"string","format":"uuid"},"tenantId":{"type":["string","null"],"format":"uuid"},"routingType":{"type":"string","enum":["Public","DatacenterOnly"]},"prefix":{"type":"string","description":"Either IPv4 or IPv6 address"},"prefixLength":{"type":"integer","example":24,"description":"Min: 1, Max: 32 for ipv4, 128 for ipv6"},"protocolVersion":{"type":"string","enum":["IPv4","IPv6"]},"usageStats":{"$ref":"#/components/schemas/IpBlockUsageStats"},"status":{"$ref":"#/components/schemas/IpBlockStatus"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"}},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"IpBlockSummary":{"title":"IpBlockSummary","type":"object","description":"Describes a subset of core attributes of an IP block","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Public Network Overlay for Site SJC4","routingType":"Public","prefix":"202.168.16.0","prefixLength":20,"status":"Pending"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256},"routingType":{"type":"string","enum":["Public","DatacenterOnly"]},"prefix":{"type":"string","description":"Either IPv4 or IPv6 address"},"prefixLength":{"type":"integer","example":24,"description":"Min: 1, Max: 32 for ipv4, 128 for ipv6"},"status":{"$ref":"#/components/schemas/IpBlockStatus"}}},"IpBlockStatus":{"title":"IpBlockStatus","type":"string","description":"Status values for IP Block objects","enum":["Pending","Provisioning","Ready","Deleting","Error"]},"IpBlockUsageStats":{"title":"IpBlockUsageStats","type":"object","examples":[{"availableIPs":256,"acquiredIPs":2,"availablePrefixes":["192.168.201.0/24"],"availableSmallestPrefixes":64,"acquiredPrefixes":0}],"properties":{"availableIPs":{"type":"integer","format":"int64","description":"Number of IP addresses available in the block","readOnly":true},"acquiredIPs":{"type":"integer","format":"int64","description":"Number of individual IP addresses acquired from the block","readOnly":true},"availablePrefixes":{"type":"array","format":"uuid","description":"Example prefixes available to acquire","items":{"type":"string","readOnly":true}},"availableSmallestPrefixes":{"type":"integer","description":"Number of smallest prefixes available to acquire","format":"int64","readOnly":true},"acquiredPrefixes":{"type":"integer","format":"int64","description":"Number of prefixes acquired from this block"}},"description":"Usa statistics for an IP Block"},"IpBlockCreateRequest":{"title":"IpBlockCreateRequest","type":"object","description":"Request data for creating IP block","examples":[{"name":"Public Network Overlay for Site SJC4","description":"This is the primary IP overlay for SJC4. All IPs are publicly routable","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","routingType":"Public","prefix":"202.168.1.0","prefixLength":24,"protocolVersion":"IPv4"}],"properties":{"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"siteId":{"type":"string","format":"uuid"},"routingType":{"type":"string","enum":["Public","DatacenterOnly"]},"prefix":{"type":"string","description":"Either IPv4 or IPv6 address"},"prefixLength":{"type":"integer","description":"Min: 1, Max: 32 for IPv4, 128 for IPv6"},"protocolVersion":{"type":"string","enum":["IPv4","IPv6"]}},"required":["name","siteId","routingType","prefix","prefixLength","protocolVersion"]},"IpBlockUpdateRequest":{"title":"IpBlockUpdateRequest","type":"object","description":"Request data for editing IP block","examples":[{"name":"Public Network Overlay for Site SJC4","description":"This is the primary IP overlay for SJC4. All IPs are publicly routable"}],"properties":{"name":{"type":["string","null"],"minLength":2,"maxLength":256},"description":{"type":["string","null"]}}},"NetworkSecurityGroup":{"type":"object","examples":[{"id":"2a21cf79-ea5e-4d28-b585-2e78948fcefb","name":"Spark VPC Firewall","description":"Security policies for machines in Spark VPC","siteId":"56f1a3ed-3653-454f-b861-9136207be660","tenantId":"79595ebe-934f-4f19-bc74-c16aefd0c57a","status":"Pending","statusHistory":[{"status":"Ready","message":"processed network security group creation request","created":"2025-02-26T18:17:44.862879-05:00","updated":"2025-02-26T18:17:44.862879-05:00"}],"rules":[{"name":"allow-http-from-public","direction":"INGRESS","sourcePortRange":"80-81","destinationPortRange":"180-181","protocol":"TCP","action":"PERMIT","priority":55,"sourcePrefix":"0.0.0.0/0","destinationPrefix":"1.1.1.1/0"}],"labels":{"flavor":"coconut"},"created":"2025-02-26T18:17:44.861317-05:00","updated":"2025-02-26T18:17:44.861317-05:00"}],"description":"Network Security Group is an aggregate of security policies","properties":{"id":{"type":"string"},"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"siteId":{"type":"string","format":"uuid"},"tenantId":{"type":"string","format":"uuid"},"status":{"$ref":"#/components/schemas/NetworkSecurityGroupStatus"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"statefulEgress":{"type":"boolean"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/NetworkSecurityGroupRule"}},"labels":{"$ref":"#/components/schemas/Labels"},"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"}}},"NetworkSecurityGroupStatus":{"title":"NetworkSecurityGroupStatus","type":"string","description":"Status values for Network Security Group objects","enum":["Pending","Provisioning","Ready","Deleting","Error"]},"NetworkSecurityGroupCreateRequest":{"type":"object","examples":[{"name":"Spark VPC Firewall","description":"Security policies for machines in Spark VPC","siteId":"188a8f32-0001-45cf-b243-f62720a22cc4","rules":[{"name":"allow-http-from-public","direction":"INGRESS","sourcePortRange":"80-81","destinationPortRange":"180-181","protocol":"TCP","action":"PERMIT","priority":55,"sourcePrefix":"0.0.0.0/0","destinationPrefix":"1.1.1.1/0"}],"labels":{"flavor":"coconut"}}],"description":"Request data to create a Network Security Group","properties":{"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"siteId":{"type":"string","format":"uuid"},"statefulEgress":{"type":"boolean","description":"Egress rules with protocol and destination ports defined but without source ports defined should automatically be made stateful."},"rules":{"type":"array","items":{"$ref":"#/components/schemas/NetworkSecurityGroupRule"}},"labels":{"$ref":"#/components/schemas/Labels"}},"required":["name","siteId"]},"NetworkSecurityGroupUpdateRequest":{"type":"object","examples":[{"name":"Spark VPC Firewall","description":"Security policies for machines in Spark VPC","rules":[{"name":"allow-http-from-public","direction":"INGRESS","sourcePortRange":"80-81","destinationPortRange":"180-181","protocol":"TCP","action":"PERMIT","priority":55,"sourcePrefix":"0.0.0.0/0","destinationPrefix":"1.1.1.1/0"}],"labels":{"flavor":"coconut"}}],"description":"Request data to update a Network Security Group","properties":{"name":{"type":["string","null"],"minLength":2,"maxLength":256},"description":{"type":["string","null"]},"statefulEgress":{"type":"boolean","description":"Egress rules with protocol and destination ports defined but without source ports defined should automatically be made stateful."},"rules":{"type":"array","description":"Update rules of the NetworkSecurityGroup. The rules will be entirely replaced by those sent in the request. Any rules not included in the request will be removed. To retain existing rules, first fetch them and include them. ","items":{"$ref":"#/components/schemas/NetworkSecurityGroupRule"}},"labels":{"$ref":"#/components/schemas/Labels"}}},"NetworkSecurityGroupRule":{"title":"NetworkSecurityGroupRule","type":"object","description":"Aggregation of Network Security Group rules","properties":{"name":{"type":["string","null"]},"direction":{"type":"string","enum":["INGRESS","EGRESS"],"example":"INGRESS"},"sourcePortRange":{"type":["string","null"],"example":"80-81"},"destinationPortRange":{"type":["string","null"],"example":"80-81"},"protocol":{"type":"string","enum":["TCP","UDP","ICMP","ANY"],"example":"TCP"},"action":{"type":"string","enum":["PERMIT","DENY"],"example":"PERMIT"},"priority":{"type":"integer"},"sourcePrefix":{"type":"string","example":"10.5.44.0/24"},"destinationPrefix":{"type":"string","example":"10.5.44.0/24"}},"required":["direction","protocol","action","sourcePrefix","destinationPrefix"]},"NetworkSecurityGroupPropagationDetails":{"title":"NetworkSecurityGroupPropagationDetails","type":"object","description":"The Network Security Group propagation details for a VPC or Instance","properties":{"id":{"type":"string","format":"uuid","description":"The VPC or Instance ID"},"detailedStatus":{"type":"string","enum":["None","Partial","Full","Unknown","Error"]},"status":{"$ref":"#/components/schemas/NetworkSecurityGroupPropagationStatus"},"details":{"type":["string","null"]},"unpropagatedInstanceIds":{"type":"array","items":{"type":"string","format":"uuid"}},"relatedInstanceIds":{"type":"array","items":{"type":"string","format":"uuid"}}}},"NetworkSecurityGroupPropagationStatus":{"title":"NetworkSecurityGroupPropagationStatus","type":"string","description":"Status values for Network Security Group propagation","enum":["Synchronizing","Synchronized","Error"]},"StatusDetail":{"title":"StatusDetail","type":"object","description":"Describes the details of a status transition for a resource","properties":{"status":{"type":"string"},"message":{"type":["string","null"]},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}},"examples":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]},"SshKeyGroup":{"title":"SshKeyGroup","type":"object","description":"Describes the model that groups SSH Keys","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","siteAssociations":[{"site":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeys":[{"id":"ff06da79-707a-4069-8623-211d49ae96c8","name":"sre-ssh-reno","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Syncing","statusHistory":[{"status":"Syncing","message":"Group is being synced to Sites","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","description":"Unique identifier for the SSH Key Group","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the SSH Key Group"},"description":{"type":["string","null"],"description":"Description for the SSH Key Group, optional"},"org":{"type":"string","description":"Organization this SSH Key Group belongs to"},"tenantId":{"type":"string","format":"uuid","description":"ID of the Tenane the SSH Key Group belongs to"},"version":{"type":["string","null"],"description":"Version of the SSH Key Group","example":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75"},"sshKeys":{"type":"array","description":"SSH Keys associated with this SSH Key Group","items":{"$ref":"#/components/schemas/SshKey"}},"siteAssociations":{"type":"array","description":"Sites the SSH Key Group is synced to","items":{"$ref":"#/components/schemas/SshKeyGroupSiteAssociation"}},"status":{"$ref":"#/components/schemas/SshKeyGroupStatus","description":"Status of the SSH Key Group"},"statusHistory":{"type":"array","description":"History of the SSH Key Group states","items":{"$ref":"#/components/schemas/StatusDetail"}},"created":{"type":"string","format":"date-time","description":"Date/time when the SSH key was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"Date/time when the SSH key was last updated","readOnly":true}}},"SshKeyGroupStatus":{"title":"SshKeyGroupStatus","type":"string","description":"Status values for SSH Key Group objects","enum":["Syncing","Synced","Error","Deleting"]},"SshKeyGroupSiteAssociation":{"title":"SshKeyGroupSiteAssociation","type":"object","description":"Describes the relationship between an SSH Key Group and a Site","examples":[{"site":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":false,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Pending"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"site":{"$ref":"#/components/schemas/SiteSummary"},"status":{"$ref":"#/components/schemas/SshKeyGroupSiteAssociationStatus"},"version":{"type":["string","null"],"description":"Version of the Key Group on Site","example":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3"},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"SshKeyGroupSiteAssociationStatus":{"title":"SshKeyGroupSiteAssociationStatus","type":"string","description":"Status values for SSH Key Group Site Association objects","enum":["Syncing","Synced","Pending","Error","Deleting"]},"SshKeyGroupCreateRequest":{"title":"SshKeyGroupCreateRequest","type":"object","description":"Request data to create an SSH Key Group","examples":[{"name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","siteIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyIds":["ff06da79-707a-4069-8623-211d49ae96c8"]}],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"siteIds":{"type":"array","items":{"type":"string","format":"uuid"}},"sshKeyIds":{"type":"array","items":{"type":"string","format":"uuid"}}},"required":["name"]},"SshKeyGroupUpdateRequest":{"title":"SshKeyGroupUpdateRequest","type":"object","description":"Request data to update an SSH Key Group","examples":[{"name":"reno-int-sre","description":"SRE access SSH keys for Reno Integration Site","siteIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08","05d6e108-9f06-44c9-be47-7ab4d62b20d0"],"sshKeyIds":["ff06da79-707a-4069-8623-211d49ae96c8","30fc7238-133d-42f7-8d29-866658b0c019"],"version":"098f6bcd4621d373cade4e832627b4f6"}],"properties":{"name":{"type":["string","null"]},"description":{"type":["string","null"]},"siteIds":{"type":"array","description":"When specified, replaces existing Site associations","items":{"type":"string","format":"uuid"}},"sshKeyIds":{"type":"array","description":"When specified, replaces existing SSH Key associations","items":{"type":"string","format":"uuid"}},"version":{"type":"string","description":"Version of the SSH Key Group being modified must be provided"}},"required":["version"]},"SshKey":{"title":"SshKey","type":"object","description":"Details of SSH public key","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"sre-ssh-reno","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","description":"Unique identifier for the key","format":"uuid","readOnly":true},"name":{"type":"string"},"org":{"type":"string"},"tenantId":{"type":"string","format":"uuid"},"fingerprint":{"type":"string","description":"SHA256 fingerprint of the public key"},"created":{"type":"string","format":"date-time","description":"Date/time when the SSH key was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"Date/time when the SSH key was last updated","readOnly":true}}},"SshKeyCreateRequest":{"title":"SshKeyCreateRequest","type":"object","description":"Request data to create an SSH key","examples":[{"name":"sre-ssh-reno","publicKey":"ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAICip4hl6WjuVHs60PeikVUs0sWE/kPhk2D0rRHWsIuyL jdoe@test.com","sshKeyGroupId":"0b5be54a-65ee-4a85-9928-90e6bca22dac"}],"properties":{"name":{"type":"string","description":"Name cannot match that name an existing SSH Key"},"publicKey":{"type":"string","description":"Must be an SSH key of type: RSA, ECDSA or ED25519","pattern":"^ssh-(rsa|ecdsa|ed25519) AAAA[0-9A-Za-z+/]+[=]{0,3}(\\s+.+)?$"},"sshKeyGroupId":{"type":["string","null"],"format":"uuid","description":"ID of the SSH Key Group this key should be attached to"}},"required":["name","publicKey"]},"SshKeyUpdateRequest":{"title":"SshKeyUpdateRequest","type":"object","description":"Request data to update an SSH key","examples":[{"name":"sre-ssh-reno-integration"}],"properties":{"name":{"type":["string","null"]}}},"DpuExtensionService":{"title":"DpuExtensionService","type":"object","description":"DPU Extension Service allows user defined services to run on DPUs of their Instances","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"busybox","description":"Single, multi-call executable that contains stripped-down versions of common Unix utilities","serviceType":"KubernetesPod","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","version":"V1-T1761856992374052","versionInfo":{"version":"V1-T1761856992374052","data":"apiVersion: apps/v1\\nkind: Deployment\\nmetadata:\\n  name: busybox-deployment\\n  labels:\\n    app: busybox\\nspec:\\n  replicas: 1 # You can adjust the number of desired replicas here\\n  selector:\\n    matchLabels:\\n      app: busybox\\n  template:\\n    metadata:\\n      labels:\\n        app: busybox\\n    spec:\\n      containers:\\n      - name: busybox-container\\n        image: busybox:latest # You can specify a different BusyBox image tag\\n        command: [\"sh\", \"-c\", \"echo \\'BusyBox container running\\' && sleep 3600\"]","hasCredentials":true,"created":"2019-08-24T14:15:22Z","observability":{"configs":[{"name":"busybox-metrics","prometheus":{"scrapeIntervalSeconds":30,"endpoint":"busybox:9090"}}]}},"activeVersions":["V1-T1761857134382532","V1-T1761856992374052"],"status":"Ready","statusHistory":[{"status":"Pending","message":"DPU Service Extension is ready for use","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","description":"Unique identifier for the DPU Extension Service","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name for the DPU Extension Service. Must be unique for a given Tenant"},"description":{"type":["string","null"],"description":"Optional description for the DPU Extension Service"},"serviceType":{"type":"string","description":"Type of the DPU Extension Service","enum":["KubernetesPod"]},"siteId":{"type":"string","format":"uuid","description":"ID for the Site the DPU Extension Service belongs to"},"tenantId":{"type":"string","format":"uuid","description":"ID for the Tenant the DPU Extension Service belongs to"},"version":{"type":["string","null"],"description":"Latest version of the DPU Extension Service"},"versionInfo":{"$ref":"#/components/schemas/DpuExtensionServiceVersionInfo","description":"Details for the latest version of the DPU Extension Service"},"activeVersions":{"type":"array","description":"Latest and past versions of this DPU Extension Service that have not been deleted and are available for deployment","items":{"type":"string"}},"status":{"$ref":"#/components/schemas/DpuExtensionServiceStatus","description":"Status of the DPU Extension Service"},"statusHistory":{"type":"array","description":"History of the DPU Extension Service statuses","items":{"$ref":"#/components/schemas/StatusDetail"}},"created":{"type":"string","format":"date-time","description":"Date/time when the DPU Extension Service was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"Date/time when the DPU Extension Service was last updated","readOnly":true}}},"DpuExtensionServiceStatus":{"title":"DpuExtensionServiceStatus","type":"string","description":"Status values for DPU Extension Service objects","enum":["Pending","Ready","Error","Deleting"]},"DpuExtensionServiceSummary":{"title":"DpuExtensionServiceSummary","type":"object","description":"DPU Extension Service allows user defined services to run on DPUs of their Instances","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"busybox","serviceType":"KubernetesPod","latestVersion":"V1-T1761856992374052","status":"Ready"}],"properties":{"id":{"type":"string","description":"Unique identifier for the DPU Extension Service","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name for the DPU Extension Service. Must be unique for a given Tenant"},"serviceType":{"type":"string","description":"Type of the DPU Extension Service","enum":["KubernetesPod"]},"latestVersion":{"type":["string","null"],"description":"Latest version of the DPU Extension Service"},"status":{"$ref":"#/components/schemas/DpuExtensionServiceStatus","description":"Status of the DPU Extension Service"}}},"DpuExtensionServiceVersionInfo":{"title":"DpuExtensionServiceVersionInfo","type":"object","description":"Information about a specific version of DPU Extension Service","examples":[{"version":"V1-T1761856992374052","data":"apiVersion: apps/v1\\nkind: Deployment\\nmetadata:\\n  name: busybox-deployment\\n  labels:\\n    app: busybox\\nspec:\\n  replicas: 1 # You can adjust the number of desired replicas here\\n  selector:\\n    matchLabels:\\n      app: busybox\\n  template:\\n    metadata:\\n      labels:\\n        app: busybox\\n    spec:\\n      containers:\\n      - name: busybox-container\\n        image: busybox:latest # You can specify a different BusyBox image tag\\n        command: [\"sh\", \"-c\", \"echo \\'BusyBox container running\\' && sleep 3600\"]","hasCredentials":true,"created":"2019-08-24T14:15:22Z","observability":{"configs":[{"name":"busybox-metrics","prometheus":{"scrapeIntervalSeconds":30,"endpoint":"busybox:9090"}}]}}],"properties":{"version":{"type":["string","null"],"description":"Current version of the DPU Extension Service"},"data":{"type":"string","description":"Deployment spec for the DPU Extension Service"},"hasCredentials":{"type":"boolean","description":"Indicates whether this version was created with credentials"},"created":{"type":"string","format":"date-time","description":"Date/time when this version of the DPU Extension Service was created","readOnly":true},"observability":{"$ref":"#/components/schemas/DpuExtensionServiceObservability","description":"Observability configuration for this DPU Extension Service version"}}},"DpuExtensionServiceCreateRequest":{"title":"DpuExtensionServiceCreateRequest","type":"object","description":"Request data to create a new DPU Extension Service","examples":[{"name":"busybox","description":"Single, multi-call executable that contains stripped-down versions of common Unix utilities","serviceType":"KubernetesPod","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","data":"apiVersion: apps/v1\\nkind: Deployment\\nmetadata:\\n  name: busybox-deployment\\n  labels:\\n    app: busybox\\nspec:\\n  replicas: 1 # You can adjust the number of desired replicas here\\n  selector:\\n    matchLabels:\\n      app: busybox\\n  template:\\n    metadata:\\n      labels:\\n        app: busybox\\n    spec:\\n      containers:\\n      - name: busybox-container\\n        image: busybox:latest # You can specify a different BusyBox image tag\\n        command: [\"sh\", \"-c\", \"echo \\'BusyBox container running\\' && sleep 3600\"]","credentials":{"registryUrl":"https://registry.hub.docker.com","username":"johndoe","password":"password123"},"observability":{"configs":[{"name":"busybox-metrics","prometheus":{"scrapeIntervalSeconds":30,"endpoint":"busybox:9090"}}]}}],"properties":{"name":{"type":"string","description":"Name for the DPU Extension Service. Must be unique for a given Tenant"},"description":{"type":["string","null"],"description":"Optional description for the DPU Extension Service"},"serviceType":{"type":"string","description":"Type of the DPU Extension Service","enum":["KubernetesPod"]},"siteId":{"type":"string","format":"uuid","description":"ID for the Site the DPU Extension Service belongs to"},"data":{"type":"string","description":"Deployment spec for the DPU Extension Service"},"credentials":{"$ref":"#/components/schemas/DpuExtensionServiceCredentials","description":"Credentials to download resources specified in DPU Extension Service data"},"observability":{"$ref":"#/components/schemas/DpuExtensionServiceObservability","description":"Observability configuration for the DPU Extension Service version"}},"required":["name","serviceType","siteId","data"]},"DpuExtensionServiceUpdateRequest":{"title":"DpuExtensionServiceUpdateRequest","type":"object","description":"Request data to update an existing DPU Extension Service","examples":[{"name":"busybox-ha","data":"apiVersion: apps/v1\\nkind: Deployment\\nmetadata:\\n  name: busybox-deployment\\n  labels:\\n    app: busybox\\nspec:\\n  replicas: 3 # You can adjust the number of desired replicas here\\n  selector:\\n    matchLabels:\\n      app: busybox\\n  template:\\n    metadata:\\n      labels:\\n        app: busybox\\n    spec:\\n      containers:\\n      - name: busybox-container\\n        image: busybox:latest # You can specify a different BusyBox image tag\\n        command: [\"sh\", \"-c\", \"echo \\'BusyBox container running\\' && sleep 3600\"]","credentials":{"registryUrl":"https://registry.hub.docker.com","username":"johndoe","password":"password123"},"observability":{"configs":[{"name":"busybox-logs","logging":{"path":"/var/log/busybox.log"}}]}}],"properties":{"name":{"type":["string","null"],"description":"Name for the DPU Extension Service. Must be unique for a given Tenant"},"description":{"type":["string","null"],"description":"Optional description for the DPU Extension Service"},"data":{"type":["string","null"],"description":"Deployment spec for the DPU Extension Service"},"credentials":{"$ref":"#/components/schemas/DpuExtensionServiceCredentials","description":"Credentials to download resources specified in DPU Extension Service data"},"observability":{"$ref":"#/components/schemas/DpuExtensionServiceObservability","description":"Observability configuration for the DPU Extension Service version"}}},"DpuExtensionServiceCredentials":{"title":"DpuExtensionServiceCredentials","type":"object","description":"Credentials for retreiving resources specified in DPU Extension Service data","examples":[{"registryUrl":"https://registry.hub.docker.com","username":"johndoe","password":"password123"}],"properties":{"registryUrl":{"type":"string","description":"URL for the registry the credential should be used for"},"username":{"type":["string","null"],"description":"Username for the registry. Must be specified if registry URL is specified"},"password":{"type":["string","null"],"description":"Password for the registry. Must be specified if registry URL is specified"}}},"DpuExtensionServiceObservability":{"title":"DpuExtensionServiceObservability","type":"object","description":"Observability configuration for a DPU Extension Service version","examples":[{"configs":[{"name":"busybox-metrics","prometheus":{"scrapeIntervalSeconds":30,"endpoint":"busybox:9090"}},{"name":"busybox-logs","logging":{"path":"/var/log/busybox.log"}}]}],"properties":{"configs":{"type":"array","maxItems":20,"description":"Observability configurations to apply to the service version","items":{"$ref":"#/components/schemas/DpuExtensionServiceObservabilityConfig"}}}},"DpuExtensionServiceObservabilityConfig":{"title":"DpuExtensionServiceObservabilityConfig","type":"object","description":"A single observability configuration for a DPU Extension Service version","properties":{"name":{"type":["string","null"],"description":"Optional name of the service or component being monitored"},"prometheus":{"$ref":"#/components/schemas/DpuExtensionServiceObservabilityPrometheus"},"logging":{"$ref":"#/components/schemas/DpuExtensionServiceObservabilityLogging"}},"oneOf":[{"required":["prometheus"]},{"required":["logging"]}]},"DpuExtensionServiceObservabilityPrometheus":{"title":"DpuExtensionServiceObservabilityPrometheus","type":"object","description":"Prometheus scrape configuration for a DPU Extension Service version","properties":{"scrapeIntervalSeconds":{"type":"integer","format":"uint32","minimum":0,"maximum":4294967295,"description":"How often Prometheus should scrape the endpoint"},"endpoint":{"type":"string","description":"Prometheus scrape endpoint"}},"required":["scrapeIntervalSeconds","endpoint"]},"DpuExtensionServiceObservabilityLogging":{"title":"DpuExtensionServiceObservabilityLogging","type":"object","description":"Logging configuration for a DPU Extension Service version","properties":{"path":{"type":"string","description":"Path to the log file to collect"}},"required":["path"]},"DpuExtensionServiceDeployment":{"title":"DpuExtensionServiceDeployment","type":"object","description":"Describes a deployment of a DPU Extension Service on DPUs of an Instance","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","dpuExtensionService":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"busybox","serviceType":"KubernetesPod","latestVersion":"V1-T1761856992374052","status":"Ready"},"version":"V1-T1761856992374052","status":"Running","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the DPU Extension Service Deployment","readOnly":true},"dpuExtensionService":{"$ref":"#/components/schemas/DpuExtensionServiceSummary","description":"Summary of the DPU Extension Service. Deployed version may be different"},"version":{"type":"string","description":"Deployed version of the DPU Extension Service"},"status":{"$ref":"#/components/schemas/DpuExtensionServiceDeploymentStatus","description":"Status of the DPU Extension Service Deployment"},"created":{"type":"string","format":"date-time","description":"Date/time when this version of the DPU Extension Service Deployment was created"},"updated":{"type":"string","format":"date-time","description":"Date/time when this version of the DPU Extension Service Deployment was updated"}}},"DpuExtensionServiceDeploymentStatus":{"title":"DpuExtensionServiceDeploymentStatus","type":"string","description":"Status values for DPU Extension Service Deployment objects","enum":["Pending","Running","Error","Failed","Terminating"]},"DpuExtensionServiceDeploymentRequest":{"title":"DpuExtensionServiceDeploymentRequest","type":"object","description":"Request data to deploy of a specific version of a DPU Extension Service on DPUs of an Instance","examples":[{"dpuExtensionServiceId":"3bddb7b4-0963-4278-b311-c212dc758357","version":"V1-T1761856992374052"}],"properties":{"dpuExtensionServiceId":{"type":"string","description":"ID of the DPU Extension Service to deploy","format":"uuid"},"version":{"type":"string","description":"Version of the DPU Extension Service to deploy"}}},"User":{"title":"User","type":"object","description":"Details of the user collected from authentication tokens","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","email":"janed@nvidia.com","firstName":"Jane","lastName":"Doe","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","description":"Unique identifier for the given user.","format":"uuid","readOnly":true},"email":{"type":["string","null"],"format":"email"},"firstName":{"type":["string","null"]},"lastName":{"type":["string","null"]},"created":{"type":"string","format":"date-time","description":"The date that the user was created.","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"AuditEntry":{"title":"AuditEntry","type":"object","description":"Describes Audit Log Entry","examples":[{"id":"e313b3ca-c47a-4ec1-a79b-a147fad51a50","endpoint":"/v2/org/test-org-1/nico/ep","queryParams":"{\"test\":[\"1234\"]}","method":"POST","body":"{\"key1\":\"value1\"}","statusCode":200,"clientIP":"12.123.43.112","userID":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","user":{"id":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","firstName":"John","lastName":"Doe","email":"jdoe@test.com"},"orgName":"test-org-1","timestamp":"2024-12-04T21:06:33.849293-08:00","durationMs":250,"apiVersion":"0.1.91"},{"id":"e313b3ca-c47a-4ec1-a79b-a147fad51a50","endpoint":"/v2/org/test-org-1/nico/ep","queryParams":"{\"test\":[\"1234\"]}","method":"POST","body":"{\"key1\":\"value1\"}","statusCode":403,"statusMessage":"User does not have permissions","clientIP":"12.123.43.112","userID":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","user":{"id":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","firstName":"John","lastName":"Doe","email":"jdoe@test.com"},"orgName":"test-org-1","timestamp":"2024-12-04T21:06:33.849293-08:00","durationMs":50,"apiVersion":"0.1.91"}],"properties":{"id":{"type":"string","description":"Unique identifier","format":"uuid","readOnly":true},"endpoint":{"type":"string","description":"API endpoint"},"queryParams":{"type":"string","description":"Query parameters"},"method":{"type":"string","description":"HTTP method"},"body":{"type":"string","description":"HTTP body in JSON format"},"statusCode":{"type":"integer","description":"HTTP response status code"},"statusMessage":{"type":"string","description":"HTTP response status message"},"clientIP":{"type":"string","description":"Client IP address"},"userID":{"type":["string","null"],"format":"uuid","description":"User ID that executed the API call"},"user":{"$ref":"#/components/schemas/User","description":"User that executed the API call"},"orgName":{"type":"string","description":"Organization name"},"extraData":{"type":"object","description":"Extra data in JSON format"},"timestamp":{"type":"string","format":"date-time","description":"API execution time"},"durationMs":{"type":"integer","description":"API execution duration in milliseconds"},"apiVersion":{"type":"string","description":"API version"}}},"Metadata":{"title":"Metadata","type":"object","description":"Metadata about the API server","examples":[{"version":"0.1.24","buildTime":"2019-08-24T14:15:22Z"}],"properties":{"version":{"type":"string","description":"Current version of the API","readOnly":true},"buildTime":{"type":"string","description":"Date/time when the API was built","readOnly":true}}},"Deprecation":{"title":"Deprecation","type":"object","description":"Details of a particular deprecation in NVIDIA Infra Controller (NICo) API","examples":[{"attribute":"blockSize","replacedBy":"prefixLength","takeActionBy":"2023-04-15T00:00:00Z","notice":"blockSize' has been deprecated in favor of 'prefixLength'. Please take action as soon as possible"}],"properties":{"attribute":{"type":["string","null"]},"queryParam":{"type":["string","null"]},"endpoint":{"type":["string","null"]},"replacedBy":{"type":["string","null"]},"takeActionBy":{"type":"string","format":"date-time"},"notice":{"type":"string"}}},"NICoAPIError":{"title":"NICoAPIError","type":"object","description":"Describes the error response from NVIDIA Infra Controller REST API","properties":{"source":{"type":"string","description":"Source of the error.","enum":["nico"]},"message":{"type":"string","description":"Message describing the error"},"data":{"type":["object","null"],"description":"Additional data about the error"}}},"ServiceAccount":{"title":"ServiceAccount","type":"object","description":"Describes Service Account status and related entities","properties":{"enabled":{"type":"boolean","description":"Indicates whether Service Account is enabled"},"infrastructureProviderId":{"type":["string","null"],"format":"uuid","description":"ID of the Infrastructure Provider associated with Service Account"},"tenantId":{"type":["string","null"],"format":"uuid","description":"ID of the Tenant associated with Service Account"}},"examples":[{"enabled":true,"infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0"}]},"Labels":{"title":"Labels","type":"object","maxProperties":10,"additionalProperties":{"type":"string"}},"MachineGPUStats":{"title":"MachineGPUStats","description":"GPU summary stats for a single GPU type across machines at a site","type":"object","properties":{"name":{"type":"string","description":"GPU name from the MachineCapability record"},"gpus":{"type":"integer","description":"Total number of GPUs (summation of all Machine GPU capability counts)"},"machines":{"type":"integer","description":"Number of machines that have this GPU capability"}}},"MachineStatusBreakdown":{"title":"MachineStatusBreakdown","description":"Machine counts broken down by status","type":"object","properties":{"total":{"type":"integer"},"initializing":{"type":"integer"},"ready":{"type":"integer"},"inUse":{"type":"integer"},"error":{"type":"integer"},"maintenance":{"type":"integer"},"unknown":{"type":"integer"}}},"MachineInstanceTypeSummary":{"title":"MachineInstanceTypeSummary","description":"Summary of machines grouped by assigned vs unassigned instance type","type":"object","properties":{"assigned":{"description":"Machines that have been assigned to an instance type","$ref":"#/components/schemas/MachineStatusBreakdown"},"unassigned":{"description":"Machines that have not been assigned to any instance type","$ref":"#/components/schemas/MachineStatusBreakdown"}}},"MachineInstanceTypeStats":{"title":"MachineInstanceTypeStats","description":"Detailed stats for machines of a specific instance type","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the InstanceType"},"name":{"type":"string","description":"Name of the InstanceType"},"assignedMachineStats":{"$ref":"#/components/schemas/MachineStatusBreakdown"},"allocated":{"type":"integer","description":"Number of Machines of this Instance Type allocated to Tenants"},"maxAllocatable":{"type":"integer","description":"Number of Ready Machines of this Instance Type available for additional allocation to Tenants"},"usedMachineStats":{"$ref":"#/components/schemas/MachineStatusBreakdown"},"tenants":{"type":"array","items":{"$ref":"#/components/schemas/InstanceTypeStats"}}}},"InstanceTypeStats":{"title":"InstanceTypeStats","description":"Stats for an instance type including allocation details","type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"allocated":{"type":"integer"},"usedMachineStats":{"$ref":"#/components/schemas/MachineStatusBreakdown"},"maxAllocatable":{"type":"integer"},"allocations":{"type":"array","items":{"$ref":"#/components/schemas/AllocationStats"}}}},"AllocationStats":{"title":"AllocationStats","description":"Stats for a single allocation within an instance type","type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"total":{"type":"integer"}}},"TenantInstanceTypeStats":{"title":"TenantInstanceTypeStats","description":"Per-tenant instance type allocation stats","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the Tenant"},"org":{"type":"string","description":"Organization name for the Tenant"},"orgDisplayName":{"type":"string","description":"Display name for the Tenant's organization"},"instanceTypes":{"type":"array","items":{"$ref":"#/components/schemas/InstanceTypeStats"}}}}},"securitySchemes":{"JWTBearerToken":{"type":"http","scheme":"Bearer","description":"```\nexport JWT_BEARER_TOKEN=\"<jwt-bearer-token>\"\n\n# Example org name: \"acme-inc\nexport ORG_NAME=<org-name>\n\n# Use the JWT bearer token in your API request auth header:\ncurl -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\n```"}},"responses":{"GenericHttpError":{"description":"Response when the API handler encounters an unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"},"examples":{"Example 1":{"value":{"source":"nico","message":"Error handling API request","data":null}}}}}},"NotFoundError":{"description":"Error response when requested object is not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"},"examples":{"example-1":{"value":{"source":"nico","message":"Could not find resource with specified ID","data":null}}}}}},"ForbiddenError":{"description":"Error response when user is not authorized to call an endpoint or retrieve/modify objects","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"},"examples":{"example-1":{"value":{"source":"nico","message":"User is not allowed to perform this action","data":null}}}}}},"ValidationError":{"description":"Error response when request data cannot be validated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"},"examples":{"example-1":{"value":{"source":"nico","message":"Error validating request data","data":{"name":"A value is required"}}}}}}}},"parameters":{},"requestBodies":{}},"security":[{"JWTBearerToken":[]}]}},"searchIndex":{"store":["tag/Getting-Started","tag/Service-Account","tag/Service-Account/operation/get-current-service-account","tag/Infrastructure-Provider","tag/Infrastructure-Provider/operation/get-current-infrastructure-provider","tag/Infrastructure-Provider/operation/get-current-infrastructure-provider-stats","tag/Tenant","tag/Tenant/operation/get-current-tenant","tag/Tenant/operation/get-current-tenant-stats","tag/Tenant/operation/get-tenant-instance-type-stats","tag/Tenant-Account","tag/Tenant-Account/operation/get-all-tenant-account","tag/Tenant-Account/operation/create-tenant-account","tag/Tenant-Account/operation/get-tenant-account","tag/Tenant-Account/operation/update-tenant-account","tag/Tenant-Account/operation/delete-tenant-account","tag/Site","tag/Site/operation/get-all-site","tag/Site/operation/create-site","tag/Site/operation/get-site","tag/Site/operation/update-site","tag/Site/operation/delete-site","tag/Site/operation/get-site-status-history","tag/Allocation","tag/Allocation/operation/get-all-allocation","tag/Allocation/operation/create-allocation","tag/Allocation/operation/get-allocation","tag/Allocation/operation/delete-allocation","tag/Allocation/operation/update-allocation","tag/Allocation/operation/get-all-allocation-constraint","tag/Allocation/operation/create-allocation-constraint","tag/Allocation/operation/get-allocation-constraint","tag/Allocation/operation/update-allocation-constraint","tag/Allocation/operation/delete-allocation-constraint","tag/VPC","tag/VPC/operation/get-all-vpc","tag/VPC/operation/create-vpc","tag/VPC/operation/get-vpc","tag/VPC/operation/delete-vpc","tag/VPC/operation/update-vpc","tag/VPC/operation/update-vpc-virtualization","tag/VPC-Peering","tag/VPC-Peering/operation/get-all-vpc-peering","tag/VPC-Peering/operation/create-vpc-peering","tag/VPC-Peering/operation/get-vpc-peering","tag/VPC-Peering/operation/delete-vpc-peering","tag/VPC-Prefix","tag/VPC-Prefix/operation/get-all-vpc-prefix","tag/VPC-Prefix/operation/create-vpc-prefix","tag/VPC-Prefix/operation/get-vpc-prefix","tag/VPC-Prefix/operation/delete-vpc-prefix","tag/VPC-Prefix/operation/update-vpc-prefix","tag/Subnet","tag/Subnet/operation/get-all-subnet","tag/Subnet/operation/create-subnet","tag/Subnet/operation/get-subnet","tag/Subnet/operation/delete-subnet","tag/Subnet/operation/update-subnet","tag/Expected-Machine","tag/Expected-Machine/operation/create-expected-machine","tag/Expected-Machine/operation/get-all-expected-machine","tag/Expected-Machine/operation/get-expected-machine","tag/Expected-Machine/operation/update-expected-machine","tag/Expected-Machine/operation/delete-expected-machine","tag/Expected-Machine/operation/batch-create-expected-machines","tag/Expected-Machine/operation/batch-update-expected-machines","tag/Expected-Power-Shelf","tag/Expected-Power-Shelf/operation/create-expected-power-shelf","tag/Expected-Power-Shelf/operation/get-all-expected-power-shelf","tag/Expected-Power-Shelf/operation/get-expected-power-shelf","tag/Expected-Power-Shelf/operation/update-expected-power-shelf","tag/Expected-Power-Shelf/operation/delete-expected-power-shelf","tag/Expected-Rack","tag/Expected-Rack/operation/create-expected-rack","tag/Expected-Rack/operation/get-all-expected-rack","tag/Expected-Rack/operation/replace-all-expected-rack","tag/Expected-Rack/operation/delete-all-expected-rack","tag/Expected-Rack/operation/get-expected-rack","tag/Expected-Rack/operation/update-expected-rack","tag/Expected-Rack/operation/delete-expected-rack","tag/Expected-Switch","tag/Expected-Switch/operation/create-expected-switch","tag/Expected-Switch/operation/get-all-expected-switch","tag/Expected-Switch/operation/get-expected-switch","tag/Expected-Switch/operation/update-expected-switch","tag/Expected-Switch/operation/delete-expected-switch","tag/SKU","tag/SKU/operation/get-all-sku","tag/SKU/operation/get-sku","tag/InfiniBand-Partition","tag/InfiniBand-Partition/operation/get-all-infiniband-partition","tag/InfiniBand-Partition/operation/create-infiniband-partition","tag/InfiniBand-Partition/operation/get-infiniband-partition","tag/InfiniBand-Partition/operation/delete-infiniband-partition","tag/InfiniBand-Partition/operation/update-infiniband-partition","tag/InfiniBand-Partition/operation/get-all-infiniband-interface","tag/NVLink-Logical-Partition","tag/NVLink-Logical-Partition/operation/get-all-nvlink-logical-partition","tag/NVLink-Logical-Partition/operation/create-nvlink-logical-partition","tag/NVLink-Logical-Partition/operation/get-nvlink-logical-partition","tag/NVLink-Logical-Partition/operation/update-nvlink-logical-partition","tag/NVLink-Logical-Partition/operation/delete-nvlink-logical-partition","tag/NVLink-Logical-Partition/operation/get-all-nvlink-interface","tag/Operating-System","tag/Operating-System/operation/get-all-operating-system","tag/Operating-System/operation/create-operating-system","tag/Operating-System/operation/get-operating-system","tag/Operating-System/operation/delete-operating-system","tag/Operating-System/operation/update-operating-system","tag/Instance-Type","tag/Instance-Type/operation/get-all-instance-type","tag/Instance-Type/operation/create-instance-type","tag/Instance-Type/operation/get-instance-type","tag/Instance-Type/operation/delete-instance-type","tag/Instance-Type/operation/update-instance-type","tag/Instance-Type/operation/get-instance-type-machine-association","tag/Instance-Type/operation/create-instance-type-machine-association","tag/Instance-Type/operation/delete-instance-type-machine-association","tag/Instance","tag/Instance/operation/get-all-instance","tag/Instance/operation/create-instance","tag/Instance/operation/batch-create-instance","tag/Instance/operation/get-instance","tag/Instance/operation/delete-instance","tag/Instance/operation/update-instance","tag/Instance/operation/get-instance-status-history","tag/Instance/operation/get-all-interface","tag/Instance/operation/get-all-instance-infiniband-interface","tag/Instance/operation/get-all-instance-nvlink-interface","tag/Machine","tag/Machine/operation/get-all-machine","tag/Machine/operation/get-machine","tag/Machine/operation/update-machine","tag/Machine/operation/delete-machine","tag/Machine/operation/get-machine-status-history","tag/Machine/operation/get-machine-gpu-stats","tag/Machine/operation/get-machine-instance-type-stats-summary","tag/Machine/operation/get-machine-instance-type-stats","tag/Machine/operation/get-all-machine-capabilities","tag/Machine-Capability","tag/Rack","tag/Rack/operation/get-all-rack","tag/Rack/operation/get-rack","tag/Rack/operation/validate-racks","tag/Rack/operation/validate-rack","tag/Rack/operation/power-control-racks","tag/Rack/operation/power-control-rack","tag/Rack/operation/firmware-update-racks","tag/Rack/operation/firmware-update-rack","tag/Rack/operation/bringup-racks","tag/Rack/operation/bringup-rack","tag/Rack/operation/get-rack-task","tag/Rack/operation/cancel-rack-task","tag/Tray","tag/Tray/operation/get-all-tray","tag/Tray/operation/get-tray","tag/Tray/operation/validate-trays","tag/Tray/operation/validate-tray","tag/Tray/operation/power-control-trays","tag/Tray/operation/power-control-tray","tag/Tray/operation/firmware-update-trays","tag/Tray/operation/firmware-update-tray","tag/Network-Security-Group","tag/Network-Security-Group/operation/get-all-network-security-group","tag/Network-Security-Group/operation/create-network-security-group","tag/Network-Security-Group/operation/get-network-security-group","tag/Network-Security-Group/operation/update-network-security-group","tag/Network-Security-Group/operation/delete-network-security-group","tag/IP-Block","tag/IP-Block/operation/get-all-ipblock","tag/IP-Block/operation/create-ipblock","tag/IP-Block/operation/get-ipblock","tag/IP-Block/operation/delete-ipblock","tag/IP-Block/operation/update-ipblock","tag/IP-Block/operation/get-all-derived-ipblock","tag/DPU-Extension-Service","tag/DPU-Extension-Service/operation/get-all-dpu-extension-service","tag/DPU-Extension-Service/operation/create-dpu-extension-service","tag/DPU-Extension-Service/operation/get-dpu-extension-service","tag/DPU-Extension-Service/operation/delete-dpu-extension-service","tag/DPU-Extension-Service/operation/update-dpu-extension-service","tag/DPU-Extension-Service/operation/get-dpu-extension-service-version","tag/DPU-Extension-Service/operation/delete-dpu-extension-service-version","tag/SSH-Key-Group","tag/SSH-Key-Group/operation/get-all-ssh-key-group","tag/SSH-Key-Group/operation/create-ssh-key-group","tag/SSH-Key-Group/operation/get-ssh-key-group","tag/SSH-Key-Group/operation/delete-ssh-key-group","tag/SSH-Key-Group/operation/update-ssh-key-group","tag/SSH-Key","tag/SSH-Key/operation/get-all-ssh-key","tag/SSH-Key/operation/create-ssh-key","tag/SSH-Key/operation/get-ssh-key","tag/SSH-Key/operation/delete-ssh-key","tag/SSH-Key/operation/update-ssh-key","tag/User","tag/User/operation/get-user","tag/Audit","tag/Audit/operation/get-all-audit-entry","tag/Audit/operation/get-audit-entry","tag/Metadata","tag/Metadata/operation/get-metadata","tag/Deprecations"],"index":{"version":"2.3.9","fields":["title","description"],"fieldVectors":[["title/0",[0,5.631,1,4.66]],["description/0",[1,0.433,2,0.998,3,0.533,4,0.523,5,0.523,6,2.474,7,3.737,8,1.827,9,0.998,10,0.998,11,2.764,12,0.523,13,0.523,14,0.523,15,1.111,16,0.523,17,0.022,18,0.998,19,1.246,20,0.268,21,0.316,22,0.523,23,3.015,24,1.637,25,0.998,26,0.523,27,0.523,28,1.103,29,0.523,30,0.523,31,0.433,32,0.516,33,3.878,34,0.385,35,0.523,36,0.469,37,0.469,38,0.469,39,0.469,40,0.469,41,0.469,42,0.433,43,0.469,44,0.603,45,0.469,46,0.199,47,0.523,48,0.469,49,0.523,50,1.403,51,1.295,52,1.964,53,0.1,54,0.469,55,0.646,56,0.455,57,0.469,58,0.316,59,1.282,60,2.191,61,0.523,62,0.128,63,1.282,64,0.367,65,0.21,66,0.183,67,0.352,68,0.148,69,0.523,70,0.523,71,1.773,72,1.716,73,0.406,74,0.998,75,0.523,76,0.367,77,1.251,78,0.469,79,2.059,80,1.977,81,0.433,82,0.523,83,1.282,84,1.201,85,0.469,86,0.367,87,1.827,88,0.523,89,0.523,90,0.523,91,0.523,92,0.523,93,0.523,94,0.523,95,0.523,96,1.964,97,1.419,98,0.433,99,2.587,100,1.431,101,1.431,102,0.523,103,0.523,104,0.406,105,0.523,106,0.406,107,1.46,108,1.431,109,0.469,110,1.697,111,0.433,112,1.646,113,0.998,114,1.6,115,1.827,116,0.603,117,0.826,118,0.826,119,0.998,120,0.998,121,0.998,122,1.326,123,1.235,124,0.998,125,0.719,126,0.894,127,0.894,128,0.775,129,0.784,130,0.998,131,1.014,132,0.523,133,0.523,134,0.027,135,0.316,136,0.826,137,1.34,138,0.523,139,0.34,140,0.433,141,0.523,142,0.406,143,0.406,144,0.523,145,0.268,146,0.523,147,1.052,148,0.523,149,0.791,150,0.523,151,0.998,152,0.523]],["title/1",[50,2.527,51,1.695]],["description/1",[3,0.617,6,4.355,19,3.076,50,3.64,51,2.171,52,4.849,53,0.16,54,4.849,55,3.501,56,0.558,62,0.38,63,4.849,64,3.796,65,2.168,66,1.896,67,3.639]],["title/2",[32,0.317,46,1.301,50,1.536,51,1.03,134,0.176,153,2.067]],["description/2",[6,4.498,19,3.23,32,0.526,46,2.161,50,3.729,51,2.242,67,3.821,104,4.412,134,0.292,153,3.432,154,3.986,155,4.412,156,5.682,157,3.986,158,5.682]],["title/3",[3,0.642,68,0.835]],["description/3",[3,0.787,7,3.231,11,1.401,15,2.57,20,1.695,21,1.999,32,0.306,44,4.167,53,0.098,62,0.232,68,0.913,71,2.323,72,0.745,73,2.57,76,3.556,77,0.726,134,0.17,135,1.999,139,0.787,159,1.456,160,2.226,161,1.882,162,2.142,163,3.719,164,5.097,165,5.097,166,4.141,167,3.984,168,3.845,169,2.74,170,2.142,171,2.74,172,2.966,173,2.226,174,1.259,175,2.57,176,2.966,177,2.74,178,2.142]],["title/4",[3,0.433,32,0.351,46,1.443,68,0.562,134,0.195]],["description/4",[3,0.734,17,0.266,32,0.595,46,2.446,53,0.19,62,0.452,68,0.953,134,0.33,179,0.407,180,1.008,181,0.416,182,6.432]],["title/5",[3,0.433,32,0.351,46,1.443,68,0.562,183,2.291]],["description/5",[3,0.748,17,0.271,32,0.606,46,2.493,53,0.193,68,0.972,179,0.415,180,1.027,181,0.424,183,3.959,184,6.556]],["title/6",[56,0.462]],["description/6",[7,3.413,11,1.97,15,2.302,20,1.518,21,2.81,32,0.274,44,4.269,53,0.087,56,0.448,62,0.208,71,2.08,72,0.668,73,2.302,76,3.265,77,1.02,84,1.255,134,0.152,135,1.791,139,0.704,147,2.181,161,1.686,162,3.716,163,3.929,164,5.384,165,5.384,166,4.375,167,3.716,168,3.586,169,2.454,170,3.011,171,2.454,173,1.994,174,1.128,175,2.302,177,2.454,178,1.918,185,2.965,186,2.657,187,2.657,188,2.657,189,2.657]],["title/7",[32,0.394,46,1.619,56,0.293,134,0.219]],["description/7",[17,0.271,32,0.606,46,2.493,53,0.193,56,0.451,62,0.46,134,0.337,179,0.415,181,0.424,190,1.07,191,6.556]],["title/8",[32,0.394,46,1.619,56,0.293,183,2.571]],["description/8",[17,0.276,32,0.618,46,2.542,53,0.197,56,0.46,179,0.423,181,0.432,183,4.037,190,1.091,192,6.684]],["title/9",[32,0.288,77,0.683,107,1.058,131,0.771,137,1.146,183,1.882,193,3.117]],["description/9",[3,0.648,17,0.235,53,0.167,56,0.391,77,1.633,107,1.929,125,2.932,131,1.406,137,2.09,149,3.141,179,0.36,180,0.89,181,0.367,183,3.432,194,1.99,195,2.55,196,5.682]],["title/10",[51,1.695,56,0.387]],["description/10",[3,0.762,51,2.012,56,0.568,68,0.991,178,4.324,197,5.532,198,6.684,199,6.684,200,6.684]],["title/11",[32,0.449,51,1.459,56,0.334]],["description/11",[3,0.788,17,0.242,32,0.371,51,1.207,53,0.172,56,0.403,62,0.411,68,0.595,125,1.579,134,0.301,179,0.37,180,0.628,181,0.378,190,0.655,201,3.653,202,3.534,203,4.589,204,5.938,205,1.448,206,3.534,207,4.304,208,3.594]],["title/12",[51,1.459,56,0.334,72,1.092]],["description/12",[3,0.782,17,0.164,51,2.526,53,0.117,56,0.553,62,0.278,68,1.017,72,1.306,125,1.561,128,3.078,134,0.298,135,2.394,139,0.942,153,2.394,178,2.565,179,0.251,180,0.621,181,0.256,205,1.435,206,2.394,208,3.553,209,1.937,210,4.504,211,2.565,212,2.666,213,3.553,214,3.965,215,3.965]],["title/13",[32,0.449,51,1.459,56,0.334]],["description/13",[3,0.782,17,0.24,32,0.367,51,1.193,53,0.171,56,0.399,62,0.407,68,0.588,125,1.561,134,0.298,179,0.367,180,0.621,181,0.375,190,0.647,201,3.622,202,3.504,203,4.567,204,5.91,205,1.698,206,3.504,207,4.267,216,3.281]],["title/14",[51,1.459,56,0.334,139,1.152]],["description/14",[3,0.555,11,2.062,17,0.201,51,2.021,53,0.144,56,0.529,62,0.342,68,0.722,134,0.25,136,4.031,139,1.595,153,2.941,179,0.308,181,0.315,190,0.795,202,2.941,205,1.205,206,2.941,213,6.017,216,4.031,217,4.871,218,4.871,219,4.364,220,4.871]],["title/15",[51,1.459,56,0.334,221,1.321]],["description/15",[3,0.822,17,0.224,51,2.442,53,0.16,56,0.595,62,0.38,68,0.802,72,1.218,125,2.13,134,0.278,180,0.848,205,1.339,209,2.644,216,4.478,221,1.965]],["title/16",[77,1.472]],["description/16",[3,0.427,7,2.919,11,2.356,21,3.361,44,4.009,56,0.258,66,1.313,71,3.904,72,0.844,73,2.909,77,1.22,84,1.586,97,4.32,161,2.13,162,2.424,163,3.361,167,3.6,168,3.474,170,3.6,203,2.13,219,3.358,222,3.747,223,3.101,224,2.756,225,2.629,226,3.747,227,3.747,228,3.358,229,3.904,230,4.986,231,4.605,232,3.358,233,2.424,234,4.986]],["title/17",[32,0.521,77,1.234]],["description/17",[6,3.49,17,0.239,28,3.49,32,0.535,53,0.17,77,1.267,134,0.297,179,0.366,180,0.905,181,0.374,190,0.943,201,3.607,202,3.49,203,3.285,204,4.25,235,3.285,236,5.178,237,5.178]],["title/18",[72,1.268,77,1.234]],["description/18",[3,0.682,17,0.247,53,0.176,56,0.411,62,0.42,68,0.886,72,1.734,77,1.688,134,0.396,179,0.378,180,0.937,181,0.387,237,5.359]],["title/19",[32,0.521,77,1.234]],["description/19",[3,0.751,7,3.972,17,0.196,32,0.438,51,1.425,53,0.14,56,0.453,64,3.322,68,0.702,77,1.66,107,1.607,154,3.322,159,2.083,179,0.3,180,0.742,181,0.306,190,0.773,205,1.172,238,1.864,239,4.243,240,5.569,241,1.897,242,3.919]],["title/20",[77,1.234,139,1.338]],["description/20",[3,0.627,17,0.227,19,3.126,53,0.162,56,0.378,68,0.815,77,1.908,139,1.732,179,0.348,180,0.861,181,0.355,238,2.869,242,4.551,243,5.499,244,5.499,245,4.551]],["title/21",[77,1.234,221,1.534]],["description/21",[3,0.67,17,0.243,53,0.173,62,0.413,68,0.871,77,1.669,107,1.995,134,0.302,179,0.372,180,0.921,181,0.38,221,2.301,238,2.314,242,4.864]],["title/22",[32,0.394,77,0.933,153,2.571,161,2.42]],["description/22",[3,0.744,7,3.943,17,0.193,32,0.432,51,1.406,53,0.138,56,0.449,64,3.277,68,0.692,77,1.647,107,1.585,153,2.821,154,3.277,159,2.055,161,2.655,179,0.296,180,0.732,181,0.302,190,0.762,238,1.839,239,4.185,240,5.528,241,1.871,246,4.671]],["title/23",[107,2.279]],["description/23",[3,0.793,56,0.479,71,4.881,84,2.945,107,2.361,147,5.117,247,6.957,248,6.234]],["title/24",[32,0.521,107,1.911]],["description/24",[3,0.797,17,0.328,32,0.478,53,0.152,55,4.522,56,0.481,107,1.753,134,0.359,149,2.855,179,0.327,180,0.809,181,0.334,190,0.843,240,3.8,249,4.275,250,4.275,251,4.275,252,4.629,253,4.629]],["title/25",[72,1.268,107,1.911]],["description/25",[3,0.492,17,0.178,53,0.127,62,0.303,68,0.64,72,1.389,79,1.977,80,1.899,84,1.827,99,3.572,107,2.443,110,2.158,111,3.572,129,1.192,131,1.068,134,0.317,137,1.587,145,2.209,147,3.175,179,0.273,180,0.676,181,0.279,207,4.537,253,3.867,254,4.316,255,4.316,256,4.316,257,4.316,258,3.32,259,4.316,260,4.316,261,4.316]],["title/26",[32,0.521,107,1.911]],["description/26",[3,0.822,17,0.298,32,0.501,53,0.16,56,0.496,107,2.448,134,0.278,145,2.77,179,0.342,180,0.848,181,0.35,190,0.883,195,2.429,205,1.339,240,3.981,249,4.478,250,4.478,262,4.478]],["title/27",[107,1.911,221,1.534]],["description/27",[3,0.831,17,0.227,53,0.162,56,0.378,62,0.386,68,0.815,72,1.238,107,2.775,116,3.321,125,2.165,134,0.282,160,3.698,180,0.861,205,1.361,209,2.687,221,1.498,262,4.551,263,4.551]],["title/28",[107,1.911,139,1.338]],["description/28",[3,0.84,17,0.231,53,0.165,56,0.384,62,0.392,68,0.828,107,2.798,116,3.375,134,0.287,139,1.328,160,3.758,179,0.354,180,0.875,181,0.361,262,4.625,263,4.625,264,2.794]],["title/29",[32,0.449,107,1.646,258,2.61]],["description/29",[3,0.851,17,0.267,32,0.426,53,0.19,56,0.444,62,0.524,68,0.958,72,1.037,107,2.745,125,2.543,134,0.332,180,0.722,190,0.752,195,2.068,205,1.14,209,3.157,258,2.48,265,3.577,266,4.129]],["title/30",[72,1.092,107,1.646,258,2.61]],["description/30",[3,0.84,17,0.231,53,0.165,62,0.392,68,0.828,72,1.659,107,2.798,125,2.2,134,0.287,179,0.354,180,0.875,181,0.361,205,1.383,258,3.008,265,4.339,266,5.008]],["title/31",[32,0.449,107,1.646,258,2.61]],["description/31",[3,0.851,17,0.267,32,0.426,53,0.19,56,0.444,62,0.524,68,0.958,72,1.037,107,2.745,125,2.543,134,0.332,180,0.722,190,0.752,195,2.068,205,1.14,209,3.157,258,2.48,265,3.577,267,3.813]],["title/32",[107,1.646,139,1.152,258,2.61]],["description/32",[1,3.243,3,0.656,11,1.659,17,0.162,53,0.116,56,0.469,59,5.154,68,0.581,71,5.61,72,0.882,79,1.795,80,1.724,81,3.243,107,2.549,125,1.543,134,0.201,139,0.931,180,0.614,205,0.97,209,1.915,235,2.228,245,4.76,258,2.109,264,1.959,267,3.243,268,3.919,269,3.919,270,5.753,271,3.919,272,3.919,273,3.919,274,3.919,275,3.919]],["title/33",[107,1.646,221,1.321,258,2.61]],["description/33",[3,0.868,17,0.243,53,0.173,68,0.871,72,1.323,107,2.585,125,2.314,134,0.302,180,0.921,205,1.454,209,2.872,221,1.601,258,3.164,264,2.939,267,4.864]],["title/34",[112,2.279]],["description/34",[84,3.006,86,4.982,112,2.411,131,1.757,210,5.514,276,6.364,277,7.102]],["title/35",[32,0.521,112,1.911]],["description/35",[17,0.266,32,0.595,53,0.19,56,0.442,62,0.452,112,2.183,134,0.414,179,0.407,181,0.416,190,1.05,278,5.764]],["title/36",[72,1.268,112,1.911]],["description/36",[17,0.266,53,0.19,56,0.442,62,0.452,72,1.448,112,2.183,134,0.414,179,0.407,181,0.416,190,1.05,278,5.764]],["title/37",[32,0.521,112,1.911]],["description/37",[17,0.261,32,0.584,53,0.186,56,0.434,62,0.443,112,2.143,134,0.324,179,0.399,181,0.408,190,1.03,205,1.562,238,2.485,279,5.224]],["title/38",[112,1.911,221,1.534]],["description/38",[17,0.261,53,0.186,56,0.434,62,0.443,112,2.143,134,0.324,179,0.399,181,0.408,190,1.03,205,1.562,221,1.72,238,2.485,279,5.224]],["title/39",[112,1.911,139,1.338]],["description/39",[17,0.266,53,0.19,56,0.442,62,0.452,112,2.183,134,0.33,139,1.528,179,0.407,181,0.416,190,1.05,264,3.216,279,5.323]],["title/40",[112,1.646,139,1.152,280,4.345]],["description/40",[17,0.224,53,0.16,56,0.496,62,0.38,84,2.291,112,2.753,114,2.77,131,1.339,134,0.278,137,1.99,139,1.286,179,0.342,181,0.35,190,0.883,209,2.644,280,4.849,281,5.412,282,4.849,283,5.412]],["title/41",[112,1.911,284,3.401]],["description/41",[58,3.884,77,1.41,112,2.99,131,1.995,284,3.884,285,4.731,286,4.731,287,5.764,288,6.432]],["title/42",[32,0.449,112,1.646,284,2.928]],["description/42",[3,0.637,17,0.231,53,0.165,56,0.507,77,1.225,112,2.501,159,2.459,174,2.802,179,0.354,180,0.875,181,0.361,190,0.912,284,4.978,286,4.111,289,5.008]],["title/43",[72,1.092,112,1.646,284,2.928]],["description/43",[3,0.533,17,0.193,53,0.138,55,3.022,56,0.517,58,2.821,72,1.692,77,1.024,112,2.761,174,2.48,179,0.296,180,0.732,181,0.302,190,0.762,195,2.096,284,4.539,289,4.185,290,3.435,291,4.671,292,4.671,293,4.185,294,4.185]],["title/44",[32,0.449,112,1.646,284,2.928]],["description/44",[3,0.805,17,0.217,20,2.685,53,0.155,56,0.486,77,1.15,112,2.397,134,0.269,174,2.686,179,0.332,180,0.822,181,0.339,190,0.856,195,2.354,205,1.298,284,4.822,286,3.858,295,4.7]],["title/45",[112,1.646,221,1.321,284,2.928]],["description/45",[3,0.789,17,0.21,53,0.15,55,3.292,56,0.476,77,1.115,112,2.349,174,2.631,179,0.322,180,0.797,181,0.329,190,0.831,195,2.284,205,1.259,221,2.142,284,4.748,293,4.56,295,4.56]],["title/46",[110,2.815,112,1.911]],["description/46",[11,2.122,56,0.471,67,3.371,77,1.099,79,2.297,80,2.206,84,3.303,107,1.702,110,4.192,112,2.648,116,3.028,117,4.149,118,4.149,131,1.241,160,3.371,195,2.25,197,4.149,290,3.688,296,5.014]],["title/47",[32,0.449,110,2.424,112,1.646]],["description/47",[17,0.261,32,0.584,53,0.186,56,0.434,62,0.443,110,3.156,112,2.143,134,0.409,179,0.399,181,0.408,190,1.03,297,5.657]],["title/48",[72,1.092,110,2.424,112,1.646]],["description/48",[17,0.261,53,0.186,56,0.434,62,0.443,72,1.421,110,3.156,112,2.143,134,0.409,179,0.399,181,0.408,190,1.03,297,5.657]],["title/49",[32,0.449,110,2.424,112,1.646]],["description/49",[17,0.261,32,0.584,53,0.186,56,0.434,62,0.443,110,3.156,112,2.143,134,0.324,179,0.399,181,0.408,190,1.03,238,2.485,298,5.224]],["title/50",[110,2.424,112,1.646,221,1.321]],["description/50",[17,0.256,53,0.183,56,0.426,62,0.435,110,3.099,112,2.104,134,0.318,179,0.392,181,0.401,190,1.012,205,1.534,221,1.689,238,2.44,298,5.129]],["title/51",[110,2.424,112,1.646,139,1.152]],["description/51",[17,0.261,53,0.186,56,0.434,62,0.443,110,3.156,112,2.143,134,0.324,139,1.5,179,0.399,181,0.408,190,1.03,264,3.156,298,5.224]],["title/52",[114,3.437]],["description/52",[7,2.208,11,3.005,21,2.542,44,3.659,56,0.417,67,2.83,77,0.923,79,1.928,80,1.852,84,3.005,107,1.429,110,2.104,114,3.634,116,2.542,117,3.484,118,3.484,131,1.042,161,2.393,163,2.542,166,2.83,167,2.723,168,2.628,170,2.723,195,1.889,197,3.484,229,2.953,290,3.096,299,3.772,300,5.014,301,3.268,302,3.484]],["title/53",[32,0.521,114,2.883]],["description/53",[17,0.266,32,0.595,53,0.19,56,0.442,62,0.452,114,3.293,134,0.414,179,0.407,181,0.416,190,1.05,303,5.764]],["title/54",[72,1.268,114,2.883]],["description/54",[17,0.227,53,0.162,56,0.378,62,0.386,72,1.238,79,3.339,80,3.207,114,2.815,125,2.165,134,0.374,179,0.348,181,0.355,190,0.897,303,4.927,304,7.289,305,5.499,306,5.499]],["title/55",[32,0.521,114,2.883]],["description/55",[17,0.266,32,0.595,53,0.19,56,0.442,62,0.452,114,3.293,134,0.33,179,0.407,181,0.416,190,1.05,238,2.532,307,5.323]],["title/56",[114,2.883,221,1.534]],["description/56",[17,0.261,53,0.186,56,0.434,62,0.443,114,3.232,134,0.324,179,0.399,181,0.408,190,1.03,205,1.562,221,1.72,238,2.485,307,5.224]],["title/57",[114,2.883,139,1.338]],["description/57",[17,0.266,53,0.19,56,0.442,62,0.452,114,3.293,134,0.33,139,1.528,179,0.407,181,0.416,190,1.05,264,3.216,307,5.323]],["title/58",[129,1.556,308,1.393]],["description/58",[3,0.627,11,2.328,68,0.815,77,1.205,129,2.406,308,2.023,309,3.04,310,3.321,311,3.557,312,4.551,313,4.269,314,4.045,315,4.269,316,4.269,317,4.269,318,4.269]],["title/59",[72,1.092,129,1.34,308,1.2]],["description/59",[3,0.758,17,0.199,51,1.445,53,0.142,56,0.33,62,0.337,65,1.924,66,1.682,68,0.986,72,1.497,77,1.053,129,2.108,134,0.247,174,1.826,179,0.304,180,0.752,181,0.31,241,1.924,308,1.887,310,2.9,311,3.107,319,2.072,320,4.303]],["title/60",[32,0.449,129,1.34,308,1.2]],["description/60",[3,0.751,17,0.196,32,0.609,51,1.425,53,0.14,56,0.453,62,0.332,65,1.897,66,1.659,68,0.976,129,1.82,134,0.243,174,1.801,179,0.3,180,0.742,181,0.306,203,2.692,233,3.064,235,2.692,241,1.897,308,1.629,319,2.043,320,4.243,321,3.064,322,3.064]],["title/61",[32,0.449,129,1.34,308,1.2]],["description/61",[3,0.773,17,0.204,32,0.627,51,1.487,53,0.146,56,0.34,62,0.347,65,1.98,66,1.731,68,1.005,129,1.874,134,0.254,174,1.879,179,0.313,180,0.774,181,0.319,205,1.223,238,1.945,241,1.98,308,1.678,319,2.132,321,3.197,323,4.089]],["title/62",[129,1.34,139,1.152,308,1.2]],["description/62",[3,0.863,17,0.196,51,1.425,53,0.14,56,0.326,62,0.332,65,1.897,66,1.659,68,1.122,129,2.092,134,0.243,139,1.565,174,1.801,179,0.3,180,0.742,181,0.306,205,1.172,241,1.897,264,2.367,308,1.873,319,2.043,323,3.919]],["title/63",[129,1.34,221,1.321,308,1.2]],["description/63",[3,0.863,17,0.196,51,1.425,53,0.14,56,0.326,62,0.332,65,1.897,66,1.659,68,1.122,129,2.092,134,0.243,174,1.801,179,0.3,180,0.742,181,0.306,205,1.172,221,1.794,241,1.897,264,2.367,308,1.873,319,2.043,323,3.919]],["title/64",[72,0.958,129,1.176,308,1.053,324,2.987]],["description/64",[3,0.691,17,0.174,51,1.267,53,0.124,56,0.29,58,2.542,62,0.295,65,1.687,66,1.475,68,0.898,72,1.364,77,0.923,106,3.268,129,2.145,134,0.216,143,3.268,174,1.601,179,0.266,180,0.659,181,0.272,195,1.889,209,2.961,241,1.687,308,1.756,319,1.816,324,2.953,325,3.772,326,3.772,327,3.772,328,3.772,329,3.772]],["title/65",[129,1.176,139,1.011,308,1.053,324,2.987]],["description/65",[3,0.788,17,0.166,51,1.207,53,0.118,56,0.276,58,2.423,62,0.282,65,1.607,66,1.405,68,1.024,77,0.879,106,3.114,129,2.23,134,0.206,139,1.39,143,3.114,174,1.525,179,0.254,180,0.628,181,0.259,195,1.8,209,2.859,241,1.607,308,1.878,319,1.731,324,2.814,325,3.594,326,3.594,327,3.594,328,3.594,329,3.594]],["title/66",[308,1.2,330,2.268,331,2.928]],["description/66",[3,0.589,11,2.187,68,0.766,77,1.132,308,1.96,309,2.855,310,3.12,311,3.342,312,4.275,313,4.011,314,3.8,315,4.011,316,4.011,317,4.011,318,4.011,330,3.971,331,4.785,332,3.474]],["title/67",[72,0.958,308,1.053,330,1.991,331,2.571]],["description/67",[3,0.737,17,0.191,51,1.387,53,0.136,56,0.317,62,0.323,65,1.846,66,1.614,68,0.958,72,1.455,77,1.01,134,0.237,174,1.752,179,0.292,180,0.722,181,0.298,241,1.846,308,1.846,310,2.783,311,2.981,319,1.988,330,3.49,331,2.783,332,4.344,333,4.129]],["title/68",[32,0.394,308,1.053,330,1.991,332,2.863]],["description/68",[3,0.737,17,0.191,32,0.598,51,1.387,53,0.136,56,0.444,62,0.323,65,1.846,66,1.614,68,0.958,134,0.237,174,1.752,179,0.292,180,0.722,181,0.298,203,2.619,233,2.981,235,2.619,241,1.846,308,1.599,319,1.988,321,2.981,322,2.981,330,3.022,332,4.344,333,4.129]],["title/69",[32,0.394,308,1.053,330,1.991,331,2.571]],["description/69",[3,0.758,17,0.199,32,0.615,51,1.445,53,0.142,56,0.33,62,0.337,65,1.924,66,1.682,68,0.986,134,0.247,174,1.826,179,0.304,180,0.752,181,0.31,205,1.188,238,1.89,241,1.924,308,1.645,319,2.072,321,3.107,330,3.11,331,2.9,332,3.229,334,3.974]],["title/70",[139,1.011,308,1.053,330,1.991,331,2.571]],["description/70",[3,0.845,17,0.188,51,1.368,53,0.134,56,0.313,62,0.319,65,1.821,66,1.592,68,1.098,134,0.234,139,1.52,174,1.729,179,0.288,180,0.712,181,0.294,205,1.125,241,1.821,264,2.273,308,1.833,319,1.961,330,3.464,331,3.865,332,3.057,334,3.762]],["title/71",[221,1.16,308,1.053,330,1.991,331,2.571]],["description/71",[3,0.845,17,0.188,51,1.368,53,0.134,56,0.313,62,0.319,65,1.821,66,1.592,68,1.098,134,0.234,174,1.729,179,0.288,180,0.712,181,0.294,205,1.125,221,1.744,241,1.821,264,2.273,308,1.833,319,1.961,330,3.464,331,3.865,332,3.057,334,3.762]],["title/72",[308,1.393,335,1.882]],["description/72",[3,0.486,68,0.632,77,0.934,157,2.99,178,2.757,224,3.135,308,1.769,309,3.379,310,2.574,311,2.757,316,3.309,317,3.309,318,3.309,335,2.876,336,3.819,337,4.262,338,3.819,339,3.819,340,3.819,341,3.819,342,3.819,343,3.819,344,3.527,345,1.739,346,3.819,347,3.819,348,3.819,349,3.819,350,3.819,351,3.819,352,3.819]],["title/73",[72,1.092,308,1.2,335,1.62]],["description/73",[3,0.596,7,2.741,17,0.142,51,1.037,53,0.102,56,0.237,62,0.242,65,1.38,66,1.207,68,0.774,72,1.176,77,1.145,134,0.177,157,2.416,174,1.31,178,2.228,211,2.228,224,2.533,241,1.38,308,1.561,309,2.888,310,2.08,311,2.228,319,1.486,335,2.354,336,3.086,339,3.086,340,3.086,341,3.086,342,3.086,343,3.086,344,4.323,345,1.405,346,3.086,347,3.086,348,3.086,349,3.086,350,3.086,351,3.086,352,3.086,353,2.533,354,3.444,355,2.674,356,2.674,357,2.228,358,2.85]],["title/74",[32,0.449,308,1.2,335,1.62]],["description/74",[3,0.766,17,0.201,32,0.621,51,1.466,53,0.144,56,0.462,62,0.342,65,1.951,66,1.706,68,0.995,134,0.25,174,1.852,203,2.769,233,3.151,235,2.769,241,1.951,308,1.661,319,2.101,322,3.151,335,2.244,357,3.151,358,4.031,359,4.364]],["title/75",[308,1.2,335,1.62,360,4.345]],["description/75",[3,0.686,17,0.132,48,2.856,51,0.959,53,0.094,56,0.219,58,1.925,62,0.224,65,1.277,66,1.116,68,0.73,72,0.717,77,1.318,109,2.856,134,0.164,139,0.757,174,1.212,206,1.925,207,3.621,209,2.939,212,2.143,221,0.868,241,1.277,264,2.461,308,1.912,319,1.375,322,3.184,335,2.583,338,2.856,353,3.621,355,2.474,356,2.474,357,2.062,358,2.637,360,4.411,361,3.187,362,2.856,363,2.344,364,4.922,365,3.187,366,3.187,367,3.187,368,3.187]],["title/76",[221,1.321,308,1.2,335,1.62]],["description/76",[3,0.883,17,0.204,51,1.487,53,0.146,56,0.34,62,0.347,65,1.98,66,1.731,68,1.148,77,1.083,134,0.254,174,1.879,221,1.848,241,1.98,308,1.916,319,2.132,335,2.588,357,3.197,369,4.941]],["title/77",[32,0.449,308,1.2,335,1.62]],["description/77",[3,0.789,17,0.21,32,0.64,51,1.532,53,0.15,56,0.35,62,0.357,65,2.039,66,1.783,68,1.025,134,0.261,174,1.935,205,1.259,238,2.003,241,2.039,308,1.712,319,2.195,335,2.313,357,3.292,359,4.56,370,4.211]],["title/78",[139,1.152,308,1.2,335,1.62]],["description/78",[3,0.87,17,0.199,51,1.445,53,0.142,56,0.33,62,0.337,65,1.924,66,1.682,68,1.13,134,0.247,139,1.58,174,1.826,205,1.188,241,1.924,264,2.401,308,1.887,309,2.654,319,2.072,335,2.549,357,3.107,370,3.974]],["title/79",[221,1.321,308,1.2,335,1.62]],["description/79",[3,0.87,17,0.199,51,1.445,53,0.142,56,0.33,62,0.337,65,1.924,66,1.682,68,1.13,134,0.247,174,1.826,205,1.188,221,1.812,241,1.924,264,2.401,308,1.887,309,2.654,319,2.072,335,2.549,357,3.107,370,3.974]],["title/80",[308,1.393,371,3.201]],["description/80",[3,0.617,11,2.291,68,0.802,77,1.186,308,2.007,309,2.991,310,3.268,311,3.501,312,4.478,313,4.202,314,3.981,315,4.202,316,4.202,317,4.202,318,4.202,371,4.917,372,5.412]],["title/81",[72,1.092,308,1.2,371,2.756]],["description/81",[3,0.751,17,0.196,51,1.425,53,0.14,56,0.326,62,0.332,65,1.897,66,1.659,68,0.976,72,1.483,77,1.038,84,2.004,134,0.243,174,1.801,179,0.3,180,0.742,181,0.306,241,1.897,308,1.873,310,2.86,311,3.064,319,2.043,371,4.304,373,4.243]],["title/82",[32,0.449,308,1.2,371,2.756]],["description/82",[3,0.751,17,0.196,32,0.609,51,1.425,53,0.14,56,0.453,62,0.332,65,1.897,66,1.659,68,0.976,134,0.243,174,1.801,179,0.3,180,0.742,181,0.306,203,2.692,233,3.064,235,2.692,241,1.897,308,1.629,319,2.043,321,3.064,322,3.064,371,3.743,373,4.243]],["title/83",[32,0.449,308,1.2,371,2.756]],["description/83",[3,0.773,17,0.204,32,0.627,51,1.487,53,0.146,56,0.34,62,0.347,65,1.98,66,1.731,68,1.005,134,0.254,174,1.879,179,0.313,180,0.774,181,0.319,205,1.223,238,1.945,241,1.98,308,1.678,319,2.132,321,3.197,371,3.855,374,4.089]],["title/84",[139,1.152,308,1.2,371,2.756]],["description/84",[3,0.863,17,0.196,51,1.425,53,0.14,56,0.326,62,0.332,65,1.897,66,1.659,68,1.122,134,0.243,139,1.565,174,1.801,179,0.3,180,0.742,181,0.306,205,1.172,241,1.897,264,2.367,308,1.873,319,2.043,371,4.304,374,3.919]],["title/85",[221,1.321,308,1.2,371,2.756]],["description/85",[3,0.863,17,0.196,51,1.425,53,0.14,56,0.326,62,0.332,65,1.897,66,1.659,68,1.122,134,0.243,174,1.801,179,0.3,180,0.742,181,0.306,205,1.172,221,1.794,241,1.897,264,2.367,308,1.873,319,2.043,371,4.304,374,3.919]],["title/86",[375,4.71]],["description/86",[11,2.122,19,2.85,86,3.517,123,2.45,129,2.156,160,3.371,173,3.371,194,1.756,225,4.805,286,3.688,375,5.474,376,4.149,377,4.149,378,4.149,379,4.493,380,5.014,381,5.014,382,5.014,383,3.893,384,4.149,385,5.014,386,5.014]],["title/87",[32,0.521,375,3.95]],["description/87",[3,0.82,17,0.223,19,2.04,32,0.332,51,1.08,53,0.159,56,0.495,62,0.252,64,2.518,65,1.438,66,1.257,67,2.413,68,1.066,77,0.787,129,0.992,134,0.277,173,2.413,179,0.341,180,0.562,181,0.348,190,0.586,203,2.04,209,1.754,225,2.518,233,2.322,235,2.04,241,1.438,310,2.168,321,2.322,322,2.322,355,2.787,375,3.781,376,2.97,377,2.97,378,2.97,383,2.787,384,2.97,387,2.97,388,3.589]],["title/88",[32,0.521,375,3.95]],["description/88",[3,0.767,17,0.234,19,2.178,32,0.354,51,1.153,53,0.167,56,0.463,62,0.269,65,1.535,66,1.342,67,2.576,68,0.997,77,0.84,129,1.059,134,0.291,173,2.576,179,0.358,180,0.6,181,0.366,190,0.625,205,0.948,225,2.688,238,1.508,241,1.535,310,2.314,321,2.479,355,2.975,375,3.969,376,3.171,377,3.171,378,3.171,383,2.975,384,3.171,387,3.171,389,3.831,390,3.831]],["title/89",[391,2.883,392,2.429]],["description/89",[11,1.899,81,3.713,84,2.684,123,2.192,129,1.24,147,3.3,154,3.147,194,1.572,276,4.02,391,3.246,392,2.736,393,4.486,394,6.341,395,4.02,396,4.486,397,4.486,398,4.486,399,3.483,400,4.02,401,4.486,402,4.486,403,4.486,404,4.486,405,4.02,406,3.713,407,4.486,408,4.02,409,4.486,410,2.415,411,4.486,412,4.486]],["title/90",[32,0.449,391,2.482,392,2.092]],["description/90",[17,0.261,32,0.584,53,0.186,56,0.434,62,0.443,134,0.409,179,0.399,181,0.408,190,1.03,391,3.232,392,2.724,413,5.657]],["title/91",[72,1.092,391,2.482,392,2.092]],["description/91",[17,0.261,53,0.186,56,0.434,62,0.443,72,1.421,134,0.409,179,0.399,181,0.408,190,1.03,391,3.232,392,2.724,413,5.657]],["title/92",[32,0.449,391,2.482,392,2.092]],["description/92",[17,0.252,32,0.563,53,0.179,56,0.536,62,0.427,134,0.313,179,0.385,181,0.394,190,0.994,238,2.396,391,3.116,392,3.36,414,5.038]],["title/93",[221,1.321,391,2.482,392,2.092]],["description/93",[17,0.247,53,0.176,56,0.53,62,0.42,134,0.307,179,0.378,181,0.387,190,0.976,205,1.48,221,1.63,238,2.354,391,3.062,392,3.322,414,4.95]],["title/94",[139,1.152,391,2.482,392,2.092]],["description/94",[17,0.252,53,0.179,56,0.536,62,0.427,134,0.313,139,1.446,179,0.385,181,0.394,190,0.994,264,3.043,391,3.116,392,3.36,414,5.038]],["title/95",[32,0.449,391,2.482,415,2.68]],["description/95",[17,0.271,53,0.193,56,0.451,62,0.46,134,0.337,179,0.415,181,0.424,190,1.07,391,3.356,415,3.624,416,6.556]],["title/96",[392,2.092,410,2.61,417,2.424]],["description/96",[11,2.577,194,2.132,287,5.455,290,4.478,392,3.36,395,5.455,405,5.455,406,5.038,410,4.192,417,3.043,418,6.047,419,5.455]],["title/97",[32,0.394,392,1.837,410,2.291,417,2.128]],["description/97",[17,0.256,32,0.573,53,0.183,56,0.426,62,0.435,134,0.405,179,0.392,181,0.401,190,1.012,392,2.674,410,3.336,417,3.099,420,5.554]],["title/98",[72,0.958,392,1.837,410,2.291,417,2.128]],["description/98",[17,0.256,53,0.183,56,0.426,62,0.435,72,1.395,134,0.405,179,0.392,181,0.401,190,1.012,392,2.674,410,3.336,417,3.099,420,5.554]],["title/99",[32,0.394,392,1.837,410,2.291,417,2.128]],["description/99",[17,0.252,32,0.563,53,0.179,56,0.419,62,0.427,134,0.313,179,0.385,181,0.394,190,0.994,205,1.506,238,2.396,392,2.626,410,3.277,417,3.043,421,5.038]],["title/100",[139,1.011,392,1.837,410,2.291,417,2.128]],["description/100",[17,0.256,53,0.183,56,0.426,62,0.435,134,0.318,139,1.473,179,0.392,181,0.401,190,1.012,238,2.44,392,2.674,410,3.336,417,3.099,421,5.129]],["title/101",[221,1.16,392,1.837,410,2.291,417,2.128]],["description/101",[17,0.256,53,0.183,56,0.426,62,0.435,134,0.318,179,0.392,181,0.401,190,1.012,205,1.534,221,1.689,392,2.674,410,3.336,417,3.099,421,5.129]],["title/102",[32,0.449,415,2.68,417,2.424]],["description/102",[17,0.271,53,0.193,56,0.451,62,0.46,134,0.337,179,0.415,181,0.424,190,1.07,415,3.624,417,3.277,422,6.556]],["title/103",[122,2.954,123,2.751]],["description/103",[11,2.886,23,5.642,96,6.109,122,3.577,123,3.331,126,6.109,127,6.109,129,1.884,423,6.818]],["title/104",[32,0.449,122,2.544,123,2.369]],["description/104",[3,0.679,17,0.246,53,0.175,56,0.41,62,0.418,68,0.882,122,4.276,123,3.982,134,0.306,179,0.377,180,0.644,181,0.385,190,0.67,201,2.565,202,2.481,205,2.016,206,3.595,212,4.003,424,3.681]],["title/105",[72,1.092,122,2.544,123,2.369]],["description/105",[3,0.875,17,0.221,53,0.158,55,2.298,56,0.368,58,2.145,62,0.375,68,0.526,72,1.204,122,2.805,123,2.612,128,4.992,134,0.33,155,2.758,179,0.338,180,0.556,181,0.346,190,0.58,201,3.338,202,3.229,203,3.039,204,3.933,205,1.323,206,3.229,207,3.933,209,3.142,263,2.939,285,2.613,424,3.183]],["title/106",[32,0.449,122,2.544,123,2.369]],["description/106",[3,0.679,17,0.246,53,0.175,56,0.41,62,0.418,68,0.882,122,4.276,123,3.982,134,0.306,179,0.377,180,0.644,181,0.385,190,0.67,201,2.565,202,2.481,205,2.016,206,3.595,212,4.003,425,3.4]],["title/107",[122,2.544,123,2.369,221,1.321]],["description/107",[3,0.673,17,0.244,53,0.174,56,0.406,62,0.414,68,0.875,122,4.255,123,3.963,134,0.303,179,0.373,180,0.636,181,0.381,190,0.663,201,2.534,202,2.451,205,2.007,206,3.564,212,3.968,221,1.106,425,3.359]],["title/108",[122,2.544,123,2.369,139,1.152]],["description/108",[3,0.762,17,0.232,53,0.165,56,0.46,62,0.394,68,0.832,122,4.483,123,4.176,134,0.288,139,0.9,179,0.355,180,0.593,181,0.363,190,0.618,201,2.365,202,2.288,205,1.951,206,3.388,212,3.773,425,3.135]],["title/109",[131,1.393,137,2.071]],["description/109",[3,0.447,7,3.018,11,1.659,21,3.474,44,4.116,56,0.27,66,1.373,86,2.75,107,1.33,129,1.083,131,1.423,137,2.115,139,0.931,161,2.228,162,2.535,163,3.474,166,2.635,167,3.721,168,3.591,170,2.535,194,1.373,229,2.75,285,2.883,426,5.753,427,3.512,428,3.512,429,5.154,430,3.243,431,3.512,432,3.512,433,3.512,434,3.512,435,3.512,436,3.512,437,3.512]],["title/110",[32,0.449,131,1.2,137,1.783]],["description/110",[3,0.797,17,0.328,53,0.152,55,4.522,56,0.481,131,1.278,134,0.359,137,1.9,149,2.855,179,0.327,180,0.809,181,0.334,190,0.843,240,3.8,249,4.275,250,4.275,251,4.275,252,4.629,438,4.629]],["title/111",[72,1.092,131,1.2,137,1.783]],["description/111",[3,0.888,17,0.252,53,0.179,62,0.427,68,1.154,72,1.371,131,1.506,134,0.313,137,2.239,179,0.385,180,0.954,181,0.394,438,5.455]],["title/112",[32,0.449,131,1.2,137,1.783]],["description/112",[3,0.703,17,0.255,20,3.158,51,1.299,53,0.182,56,0.424,62,0.433,68,0.914,131,2.056,134,0.317,137,3.055,149,3.41,159,1.899,179,0.39,180,0.676,181,0.399,190,0.704,205,1.068,439,3.572]],["title/113",[131,1.2,137,1.783,221,1.321]],["description/113",[3,0.67,17,0.243,53,0.173,62,0.413,68,0.871,131,1.884,134,0.302,137,2.8,159,2.586,179,0.372,180,0.921,181,0.38,205,1.454,221,1.601,439,4.864]],["title/114",[131,1.2,137,1.783,139,1.152]],["description/114",[3,0.67,17,0.243,53,0.173,62,0.413,68,0.871,131,1.884,134,0.302,137,2.8,139,1.396,159,2.586,179,0.372,180,0.921,181,0.38,205,1.454,439,4.864]],["title/115",[32,0.394,137,1.566,145,2.179,440,4.257]],["description/115",[3,0.659,17,0.239,53,0.17,62,0.406,68,0.856,129,2.081,131,1.863,134,0.297,137,2.769,159,2.542,179,0.366,180,0.905,181,0.374,265,4.486,441,5.178]],["title/116",[72,0.958,137,1.566,145,2.179,442,3.523]],["description/116",[3,0.572,17,0.207,53,0.148,62,0.352,66,2.399,68,0.743,129,1.893,131,1.93,134,0.258,137,2.519,140,4.149,145,3.507,159,2.206,179,0.317,180,0.785,181,0.324,235,2.85,441,4.493,443,5.014,444,5.014,445,5.014]],["title/117",[137,1.566,145,2.179,221,1.16,442,3.523]],["description/117",[3,0.447,17,0.162,53,0.116,55,2.535,62,0.275,68,0.581,129,1.589,131,1.423,134,0.201,136,4.76,137,2.761,140,3.243,145,2.006,155,3.043,159,1.724,168,2.447,179,0.248,180,0.614,181,0.253,205,1.686,221,1.068,231,3.243,233,3.721,430,3.243,442,4.76,446,3.919,447,5.753,448,3.919,449,3.919,450,3.919,451,3.919,452,3.919,453,3.919,454,3.919,455,3.919]],["title/118",[131,1.661]],["description/118",[7,3.311,11,2.671,21,3.811,44,4.254,56,0.237,110,1.722,112,1.169,114,1.763,122,1.807,123,1.683,129,0.952,131,0.852,161,1.958,163,3.811,166,3.513,167,4.083,168,3.94,170,4.083,229,4.427,286,2.533,301,2.674,379,3.086,415,2.888,456,3.444,457,3.444,458,3.086,459,4.681,460,3.086,461,3.086,462,3.086,463,5.655,464,3.086,465,3.086,466,3.086]],["title/119",[32,0.521,131,1.393]],["description/119",[17,0.271,53,0.193,56,0.561,62,0.46,131,1.622,134,0.337,179,0.415,181,0.424,190,1.07,467,5.874]],["title/120",[72,1.268,131,1.393]],["description/120",[17,0.266,53,0.19,56,0.555,62,0.452,72,1.448,131,1.591,134,0.33,179,0.407,181,0.416,190,1.05,467,5.764]],["title/121",[72,1.092,131,1.2,324,3.402]],["description/121",[11,1.234,17,0.121,19,1.657,36,2.612,53,0.086,56,0.316,58,2.773,62,0.205,72,1.034,76,2.045,99,2.412,106,3.564,107,1.558,129,1.781,131,1.842,134,0.15,135,1.76,142,2.263,143,3.564,173,1.96,179,0.184,181,0.297,190,0.476,209,1.424,294,4.114,324,2.045,345,1.189,356,2.263,415,1.611,417,3.222,419,2.612,468,2.915,469,2.915,470,2.915,471,2.915,472,1.234,473,2.915,474,4.591,475,2.915,476,2.915,477,5.68,478,2.915,479,2.612,480,2.915,481,2.915,482,2.915,483,2.915,484,2.915,485,2.915,486,2.915,487,2.915,488,2.915,489,2.915,490,2.915]],["title/122",[32,0.521,131,1.393]],["description/122",[17,0.256,53,0.183,56,0.542,62,0.435,131,1.949,134,0.318,179,0.392,181,0.401,190,1.012,195,2.782,205,1.534,491,5.129]],["title/123",[131,1.393,221,1.534]],["description/123",[17,0.252,53,0.179,56,0.536,62,0.427,131,1.927,134,0.313,179,0.385,181,0.394,190,0.994,195,2.732,205,1.506,221,1.659,491,5.038]],["title/124",[131,1.393,139,1.338]],["description/124",[17,0.252,53,0.179,56,0.536,62,0.427,131,1.927,134,0.313,139,1.446,179,0.385,181,0.394,190,0.994,195,2.732,205,1.506,491,5.038]],["title/125",[32,0.394,131,1.053,153,2.571,161,2.42]],["description/125",[17,0.266,53,0.19,56,0.442,62,0.452,131,1.591,134,0.33,153,3.884,161,3.656,179,0.407,181,0.416,190,1.05,492,6.432]],["title/126",[32,0.521,415,3.113]],["description/126",[17,0.271,53,0.193,56,0.451,62,0.46,131,1.622,134,0.337,179,0.415,181,0.424,190,1.07,415,3.624,493,6.556]],["title/127",[32,0.394,131,1.053,391,2.179,415,2.353]],["description/127",[17,0.266,53,0.19,56,0.442,62,0.452,131,1.591,134,0.33,179,0.407,181,0.416,190,1.05,391,3.293,415,3.555,494,6.432]],["title/128",[32,0.394,131,1.053,415,2.353,417,2.128]],["description/128",[17,0.266,53,0.19,56,0.442,62,0.452,131,1.591,134,0.33,179,0.407,181,0.416,190,1.05,415,3.555,417,3.216,495,6.432]],["title/129",[129,1.855]],["description/129",[77,1.334,80,2.678,84,2.577,129,2.152,223,5.038,224,5.729,225,4.271,399,4.727,400,5.455,406,5.038,408,5.455,418,4.727,496,5.455]],["title/130",[32,0.521,129,1.556]],["description/130",[3,0.909,17,0.261,53,0.186,62,0.443,68,1.181,129,1.744,134,0.324,179,0.399,180,0.989,181,0.408,497,6.313]],["title/131",[32,0.521,129,1.556]],["description/131",[3,0.851,17,0.267,20,3.307,53,0.19,56,0.444,62,0.568,68,0.958,77,1.01,129,1.785,131,1.14,134,0.383,145,2.359,159,2.027,180,0.722,190,0.752,209,3.157,210,3.577,498,3.577,499,3.813]],["title/132",[129,1.556,139,1.338]],["description/132",[3,0.789,56,0.35,58,3.073,64,3.57,125,2.003,129,1.406,131,1.259,137,1.871,139,2.163,155,3.951,162,5.086,209,2.486,344,4.211,499,4.211,500,5.089,501,5.089,502,5.089,503,5.089]],["title/133",[77,1.063,129,1.34,221,1.321]],["description/133",[3,0.849,17,0.235,53,0.167,62,0.399,68,0.842,129,2.058,134,0.292,179,0.36,180,0.89,181,0.367,195,2.55,221,1.548,499,4.702,504,5.682,505,5.682,506,5.682,507,5.682]],["title/134",[32,0.394,129,1.176,153,2.571,161,2.42]],["description/134",[3,0.851,17,0.267,20,3.307,53,0.19,56,0.444,62,0.568,68,0.958,77,1.01,129,1.785,131,1.14,134,0.383,145,2.359,159,2.027,180,0.722,190,0.752,209,3.157,210,3.577,498,3.577,508,4.608]],["title/135",[32,0.351,77,0.832,129,1.048,183,2.291,418,2.946]],["description/135",[3,0.637,17,0.231,53,0.165,77,1.615,125,2.9,129,1.544,135,3.375,149,3.089,179,0.354,180,0.875,181,0.361,183,3.375,194,1.958,195,2.508,418,5.72,509,5.008,510,5.589]],["title/136",[32,0.288,77,0.683,129,0.861,131,0.771,137,1.146,142,2.42,509,2.793]],["description/136",[3,0.617,17,0.224,53,0.16,77,1.186,125,2.13,129,1.495,131,1.339,137,1.99,142,4.202,149,2.991,153,3.268,179,0.342,180,0.848,181,0.35,194,1.896,195,2.429,511,5.412,512,3.501,513,5.412,514,5.412,515,5.412,516,5.412]],["title/137",[20,1.752,32,0.317,77,0.75,129,0.946,183,2.067,517,3.422]],["description/137",[3,0.627,17,0.227,20,2.815,53,0.162,56,0.378,77,1.205,83,4.927,107,1.866,125,2.165,129,1.519,131,1.361,137,2.022,149,3.04,179,0.348,180,0.861,181,0.355,183,3.321,195,2.468,518,5.499,519,5.499,520,5.499]],["title/138",[32,0.449,66,1.698,129,1.34]],["description/138",[3,0.707,17,0.256,53,0.183,62,0.435,66,2.171,68,0.919,129,2.177,134,0.318,179,0.392,180,0.971,181,0.401,521,6.199,522,6.199]],["title/139",[66,1.972,129,1.556]],["description/139",[11,2.672,66,3.06,86,4.429,129,2.535,131,1.562,137,2.322,194,2.211,225,4.429]],["title/140",[335,2.244]],["description/140",[77,1.437,80,2.884,129,1.811,223,5.425,224,6.003,315,5.09,335,2.728,496,5.874,523,6.556]],["title/141",[32,0.521,335,1.882]],["description/141",[3,0.72,17,0.261,53,0.186,62,0.443,68,0.936,77,1.384,125,2.485,134,0.324,179,0.399,180,0.989,181,0.408,335,2.11,524,6.313]],["title/142",[32,0.521,335,1.882]],["description/142",[3,0.734,17,0.266,53,0.19,62,0.452,68,0.953,134,0.33,179,0.407,180,1.008,181,0.416,205,1.591,335,2.15,525,6.432]],["title/143",[335,1.882,526,3.643]],["description/143",[3,0.447,17,0.162,19,2.228,20,2.006,53,0.116,62,0.275,68,0.581,77,0.859,125,1.543,134,0.201,135,2.367,149,2.166,179,0.248,180,0.614,181,0.253,238,1.543,308,1.423,335,2.278,512,2.535,526,3.721,527,4.781,528,4.466,529,4.466,530,3.591,531,3.721,532,3.919,533,3.512,534,3.919,535,3.043,536,3.043,537,3.043,538,3.043,539,3.043,540,3.043,541,3.043,542,3.919]],["title/144",[335,1.882,526,3.643]],["description/144",[3,0.512,17,0.186,19,2.55,20,2.297,53,0.132,62,0.315,68,0.665,134,0.23,149,2.48,179,0.284,180,0.703,181,0.29,308,1.569,512,2.902,526,2.902,527,5.159,528,4.923,529,4.923,530,3.958,535,3.483,536,3.483,537,3.483,538,3.483,539,3.483,540,3.483,541,3.483,543,6.341,544,4.486]],["title/145",[330,2.268,335,1.62,545,3.027]],["description/145",[3,0.58,17,0.21,53,0.15,62,0.357,68,0.754,77,1.115,116,3.073,125,2.003,134,0.261,179,0.322,180,0.797,181,0.329,330,3.236,335,2.313,530,3.177,531,4.476,545,3.177,546,3.743,547,3.57,548,3.951,549,3.951,550,3.951,551,5.089]],["title/146",[330,2.268,335,1.62,545,3.027]],["description/146",[3,0.617,17,0.224,53,0.16,62,0.38,68,0.802,116,3.268,134,0.278,179,0.342,180,0.848,181,0.35,211,3.501,309,2.991,330,3.373,335,2.41,530,3.378,545,3.378,548,4.202,549,4.202,550,4.202,552,5.412]],["title/147",[139,1.152,335,1.62,553,3.137]],["description/147",[3,0.627,17,0.227,53,0.162,62,0.386,68,0.815,77,1.205,125,2.165,134,0.282,135,3.321,139,1.306,179,0.348,180,0.861,181,0.355,335,2.436,531,4.716,546,4.045,547,3.858,553,3.557,554,5.499]],["title/148",[139,1.152,335,1.62,553,3.137]],["description/148",[3,0.682,17,0.247,53,0.176,62,0.42,68,0.886,134,0.307,139,1.421,179,0.378,180,0.937,181,0.387,211,3.869,309,3.306,335,2.574,553,3.869,555,5.981]],["title/149",[335,1.62,556,3.764,557,3.764]],["description/149",[3,0.627,17,0.227,53,0.162,62,0.386,68,0.815,77,1.205,125,2.165,134,0.282,135,3.321,179,0.348,180,0.861,181,0.355,335,2.436,531,4.716,546,4.045,547,3.858,556,4.269,557,4.269,558,5.499]],["title/150",[335,1.62,556,3.764,557,3.764]],["description/150",[3,0.682,17,0.247,53,0.176,62,0.42,68,0.886,134,0.307,179,0.378,180,0.937,181,0.387,211,3.869,309,3.306,335,2.574,556,4.644,557,4.644,559,5.981]],["title/151",[32,0.521,560,4.372]],["description/151",[3,0.659,17,0.239,53,0.17,62,0.406,68,0.856,72,1.301,77,1.267,134,0.297,179,0.366,180,0.905,181,0.374,211,3.738,322,3.738,560,6.504,561,5.178,562,5.779]],["title/152",[560,4.372,563,5.046]],["description/152",[3,0.447,17,0.162,42,3.243,53,0.116,58,2.367,62,0.275,68,0.581,72,0.882,77,0.859,134,0.201,149,2.166,179,0.248,282,3.512,322,2.535,357,2.535,479,3.512,530,2.447,560,6.707,561,3.512,563,6.728,564,3.919,565,3.919,566,3.919,567,3.919,568,3.512,569,3.919,570,3.919,571,5.753,572,3.919,573,3.919,574,3.919,575,3.919,576,3.919,577,3.919,578,3.919,579,3.919]],["title/153",[580,3.281]],["description/153",[335,2.477,356,5.753,387,6.132,527,5.199,580,3.621]],["title/154",[32,0.521,580,2.751]],["description/154",[3,0.518,7,3.886,17,0.188,53,0.134,62,0.319,68,0.674,77,0.996,125,2.519,134,0.234,137,1.672,179,0.288,180,0.712,181,0.294,235,2.584,258,2.447,353,3.344,512,2.941,527,3.189,531,2.941,547,3.189,580,2.221,581,3.762,582,3.762,583,3.762,584,3.762,585,3.762,586,4.546,587,3.762,588,3.762,589,3.762,590,4.546]],["title/155",[32,0.521,580,2.751]],["description/155",[3,0.734,17,0.266,53,0.19,62,0.452,68,0.953,134,0.33,179,0.407,180,1.008,181,0.416,205,1.591,580,3.143,591,6.432]],["title/156",[526,3.643,580,2.751]],["description/156",[3,0.437,11,1.622,17,0.158,19,2.178,20,1.961,53,0.113,62,0.269,68,0.568,77,0.84,125,1.508,134,0.197,149,2.118,162,2.479,179,0.242,180,0.6,181,0.248,238,1.508,308,1.4,335,1.28,512,2.479,526,3.66,527,4.718,528,4.392,529,4.392,530,3.532,531,3.66,533,3.433,535,2.975,536,2.975,537,2.975,538,2.975,539,2.975,540,2.975,541,2.975,580,3.286,592,3.831,593,3.831,594,3.831]],["title/157",[526,3.643,580,2.751]],["description/157",[3,0.525,17,0.191,19,2.619,20,2.359,53,0.136,62,0.323,68,0.683,134,0.237,149,2.547,179,0.292,180,0.722,181,0.298,308,1.599,512,2.981,526,2.981,527,4.532,528,5.016,529,5.016,530,4.033,535,3.577,536,3.577,537,3.577,538,3.577,539,3.577,540,3.577,541,3.577,580,2.251,595,4.608]],["title/158",[330,2.268,545,3.027,580,2.369]],["description/158",[3,0.447,7,3.575,17,0.162,53,0.116,62,0.275,68,0.581,77,0.859,116,2.367,125,2.264,134,0.201,137,1.441,179,0.248,180,0.614,181,0.253,235,2.228,258,2.109,330,2.691,353,2.883,512,2.535,530,2.447,531,4.409,545,2.447,546,2.883,547,4.036,548,3.043,549,3.043,550,3.043,580,2.811,581,3.243,582,3.243,583,3.243,584,3.243,585,3.243,587,3.243,588,3.243,589,3.243,596,3.512,597,3.919]],["title/159",[330,2.268,545,3.027,580,2.369]],["description/159",[3,0.617,17,0.224,53,0.16,62,0.38,68,0.802,116,3.268,134,0.278,179,0.342,180,0.848,181,0.35,211,3.501,309,2.991,330,3.373,530,3.378,545,3.378,548,4.202,549,4.202,550,4.202,580,3.524,598,5.412]],["title/160",[139,1.152,553,3.137,580,2.369]],["description/160",[3,0.48,7,3.724,17,0.174,53,0.124,62,0.295,68,0.624,77,0.923,125,2.385,134,0.216,137,1.548,139,1,179,0.266,180,0.659,181,0.272,235,2.393,258,2.266,353,3.096,512,2.723,531,4.592,546,3.096,547,4.251,553,2.723,580,2.961,581,3.484,582,3.484,583,3.484,584,3.484,585,3.484,587,3.484,588,3.484,589,3.484,596,3.772,599,4.21]],["title/161",[139,1.152,553,3.137,580,2.369]],["description/161",[3,0.682,17,0.247,53,0.176,62,0.42,68,0.886,134,0.307,139,1.421,179,0.378,180,0.937,181,0.387,211,3.869,309,3.306,553,3.869,580,3.763,600,5.981]],["title/162",[84,2.052,194,1.698,601,2.756]],["description/162",[84,2.829,97,5.19,131,1.654,194,2.341,290,4.917,545,4.173,601,4.695,602,5.532,603,6.684]],["title/163",[32,0.394,84,1.802,194,1.491,601,2.42]],["description/163",[17,0.261,53,0.186,56,0.548,62,0.443,84,2.672,134,0.324,179,0.399,181,0.408,190,1.03,194,2.211,601,3.589,604,5.657]],["title/164",[72,0.958,84,1.802,194,1.491,601,2.42]],["description/164",[17,0.256,53,0.183,56,0.542,62,0.435,72,1.395,84,2.624,134,0.318,179,0.392,181,0.401,190,1.012,194,2.171,601,3.523,604,5.554]],["title/165",[32,0.394,84,1.802,194,1.491,601,2.42]],["description/165",[17,0.247,53,0.176,56,0.53,62,0.42,84,2.532,131,1.48,134,0.307,179,0.378,181,0.387,190,0.976,194,2.095,195,2.684,205,1.48,601,3.4,605,4.95]],["title/166",[84,1.802,139,1.011,194,1.491,601,2.42]],["description/166",[17,0.207,53,0.148,56,0.471,62,0.352,72,1.129,84,2.122,125,1.974,131,1.241,134,0.258,139,1.627,179,0.317,181,0.324,190,0.818,194,2.399,195,2.25,205,1.241,212,3.371,601,2.85,602,5.669,605,4.149,606,5.014,607,5.014,608,5.014]],["title/167",[84,1.802,194,1.491,221,1.16,601,2.42]],["description/167",[17,0.217,53,0.155,56,0.486,62,0.368,84,2.99,131,1.298,134,0.269,145,2.685,179,0.332,181,0.339,190,0.856,194,2.474,195,2.354,205,1.298,221,2.176,601,4.015,602,4.341,605,4.341]],["title/168",[79,2.579,80,2.477]],["description/168",[3,0.679,7,2.155,11,2.964,21,2.481,44,3.595,56,0.283,77,0.9,79,3.207,80,3.08,84,1.739,85,3.681,86,2.882,107,1.394,110,2.976,111,3.4,161,2.335,163,2.481,166,2.762,167,2.658,168,2.565,170,2.658,229,2.882,248,3.681,300,4.927,301,3.189,302,3.4,427,3.681,609,4.108,610,4.108,611,3.681,612,4.108,613,3.681]],["title/169",[32,0.449,79,2.221,80,2.133]],["description/169",[6,3.432,17,0.235,28,3.432,32,0.526,53,0.167,79,2.603,80,2.5,134,0.292,179,0.36,180,0.89,181,0.367,190,0.927,201,3.547,202,3.432,203,3.23,204,4.179,235,3.23,236,5.091,614,5.091]],["title/170",[72,1.092,79,2.221,80,2.133]],["description/170",[3,0.617,17,0.224,53,0.16,56,0.372,68,0.802,72,1.826,79,3.715,80,3.568,107,1.837,134,0.278,157,3.796,179,0.342,180,0.848,181,0.35,614,4.849,615,4.478]],["title/171",[32,0.449,79,2.221,80,2.133]],["description/171",[17,0.271,32,0.606,53,0.193,79,3.003,80,2.884,179,0.415,180,1.027,181,0.424,190,1.07,205,1.622,616,5.425]],["title/172",[79,2.221,80,2.133,221,1.321]],["description/172",[3,0.589,17,0.214,53,0.152,56,0.355,62,0.363,68,0.766,79,3.629,80,3.486,107,2.373,134,0.265,145,2.644,157,3.624,160,3.474,179,0.327,180,0.809,181,0.334,221,1.905,615,4.275,616,4.275]],["title/173",[79,2.221,80,2.133,139,1.152]],["description/173",[3,0.781,17,0.207,53,0.148,56,0.345,68,0.743,72,1.129,79,3.841,80,3.689,107,1.702,125,1.974,134,0.258,139,1.191,157,3.517,160,3.371,175,3.893,180,0.785,209,2.45,264,2.507,615,4.149,616,4.149]],["title/174",[32,0.394,79,1.95,80,1.873,383,3.305]],["description/174",[3,0.723,17,0.186,32,0.415,53,0.132,56,0.436,68,0.665,72,1.428,79,3.661,80,3.709,107,2.152,134,0.23,145,2.297,179,0.284,180,0.703,181,0.29,195,2.013,238,1.766,251,3.713,617,4.486,618,6.341,619,4.02,620,4.486,621,4.486]],["title/175",[50,2.176,622,2.482,623,2.482]],["description/175",[46,2.274,50,3.822,53,0.176,116,3.612,131,1.48,137,2.2,285,4.399,568,5.359,622,3.942,623,3.062,624,5.981,625,5.981,626,5.981]],["title/176",[32,0.394,50,1.911,622,2.179,623,2.179]],["description/176",[17,0.252,32,0.563,46,2.315,50,2.732,53,0.179,56,0.536,62,0.427,134,0.313,179,0.385,181,0.394,190,0.994,622,3.116,623,3.116,627,5.455]],["title/177",[50,1.911,72,0.958,622,2.179,623,2.179]],["description/177",[17,0.252,46,2.315,50,2.732,53,0.179,56,0.536,62,0.427,72,1.371,134,0.313,179,0.385,181,0.394,190,0.994,622,3.116,623,3.116,627,5.455]],["title/178",[32,0.394,50,1.911,622,2.179,623,2.179]],["description/178",[17,0.224,32,0.501,46,2.743,50,3.237,53,0.16,56,0.558,62,0.38,134,0.278,159,2.381,179,0.342,181,0.35,190,0.883,205,1.339,622,3.692,623,3.692,628,4.478]],["title/179",[50,1.911,221,1.16,622,2.179,623,2.179]],["description/179",[17,0.201,28,4.055,46,1.852,50,3.449,53,0.144,56,0.462,62,0.342,104,3.782,134,0.25,159,2.143,179,0.308,181,0.315,190,0.795,205,1.205,221,1.83,238,1.917,498,3.782,622,3.934,623,3.934,628,4.031]],["title/180",[50,1.911,139,1.011,622,2.179,623,2.179]],["description/180",[17,0.21,28,3.073,46,1.935,50,3.105,53,0.15,56,0.476,62,0.357,72,1.146,128,3.951,134,0.261,139,1.209,159,2.239,179,0.322,181,0.329,190,0.831,238,2.003,245,4.211,313,3.951,362,4.56,622,3.542,623,3.542,628,4.211]],["title/181",[28,2.291,32,0.351,50,1.703,622,1.942,623,1.942]],["description/181",[17,0.224,20,2.77,28,3.268,32,0.501,46,2.058,50,3.237,53,0.16,56,0.496,62,0.38,134,0.278,159,2.381,179,0.342,181,0.35,190,0.883,238,2.13,622,3.692,623,3.692,629,4.849]],["title/182",[28,2.291,50,1.703,221,1.034,622,1.942,623,1.942]],["description/182",[17,0.21,28,4.179,31,4.211,46,1.935,50,3.105,53,0.15,56,0.476,62,0.357,104,3.951,134,0.261,159,2.239,179,0.322,181,0.329,190,0.831,221,1.885,238,2.003,498,3.951,622,3.542,623,3.542,629,4.56]],["title/183",[194,1.698,345,1.978,472,2.052]],["description/183",[11,2.532,77,1.311,131,1.48,154,4.196,194,2.697,285,4.399,314,4.399,345,3.141,472,3.26,630,5.981,631,5.981,632,5.981,633,5.359]],["title/184",[32,0.394,194,1.491,345,1.737,472,1.802]],["description/184",[17,0.252,32,0.563,46,2.315,53,0.179,56,0.536,62,0.427,134,0.313,179,0.385,181,0.394,190,0.994,194,2.132,345,2.483,472,2.577,634,5.455]],["title/185",[72,0.958,194,1.491,345,1.737,472,1.802]],["description/185",[17,0.252,46,2.315,53,0.179,56,0.536,62,0.427,72,1.371,134,0.313,179,0.385,181,0.394,190,0.994,194,2.132,345,2.483,472,2.577,634,5.455]],["title/186",[32,0.394,194,1.491,345,1.737,472,1.802]],["description/186",[17,0.224,32,0.501,46,2.743,53,0.16,56,0.558,62,0.38,134,0.278,159,2.381,179,0.342,181,0.35,190,0.883,194,2.526,205,1.339,345,2.942,472,3.053,635,4.478]],["title/187",[194,1.491,221,1.16,345,1.737,472,1.802]],["description/187",[17,0.217,46,1.995,53,0.155,56,0.486,62,0.368,77,1.15,134,0.269,145,2.685,159,2.307,179,0.332,181,0.339,190,0.856,194,2.474,221,1.429,238,2.065,345,2.881,472,2.99,635,4.341,636,4.072,637,4.341]],["title/188",[139,1.011,194,1.491,345,1.737,472,1.802]],["description/188",[17,0.21,31,4.211,46,1.935,53,0.15,56,0.476,62,0.357,77,1.115,134,0.261,139,1.209,159,2.239,163,3.073,179,0.322,181,0.329,190,0.831,194,2.424,238,2.003,345,2.823,472,2.929,635,4.211,636,3.951,637,4.211,638,5.089]],["title/189",[345,2.297,472,2.384]],["description/189",[11,2.886,131,1.687,154,4.783,314,5.015,345,3.411,472,2.886,633,6.109,639,6.818]],["title/190",[32,0.449,345,1.978,472,2.052]],["description/190",[17,0.256,32,0.573,46,2.357,53,0.183,56,0.542,62,0.435,134,0.318,179,0.392,181,0.401,190,1.012,345,2.528,472,2.624,640,5.554]],["title/191",[72,1.092,345,1.978,472,2.052]],["description/191",[17,0.217,46,1.995,53,0.155,56,0.486,62,0.368,72,1.181,77,1.15,125,2.065,134,0.269,145,2.685,179,0.332,181,0.339,190,0.856,194,2.474,345,3.257,472,3.38,636,4.072,640,4.7]],["title/192",[32,0.449,345,1.978,472,2.052]],["description/192",[17,0.231,32,0.517,46,2.802,53,0.165,56,0.567,62,0.392,134,0.287,159,2.459,179,0.354,181,0.361,190,0.912,205,1.383,345,3.006,472,3.119,641,4.625]],["title/193",[221,1.321,345,1.978,472,2.052]],["description/193",[17,0.199,46,2.529,53,0.142,56,0.525,57,4.303,62,0.337,77,1.053,134,0.247,145,2.458,159,2.113,179,0.304,181,0.31,190,0.784,194,1.682,205,1.188,221,1.308,345,3.359,472,3.485,636,3.728,637,3.974,641,3.974]],["title/194",[139,1.152,345,1.978,472,2.052]],["description/194",[11,1.827,17,0.178,21,2.607,46,2.346,53,0.127,56,0.495,62,0.303,76,3.028,98,3.572,134,0.222,139,1.465,159,1.899,163,2.607,179,0.273,181,0.279,190,0.704,194,2.522,205,1.068,345,3.525,472,3.658,641,3.572,642,4.316]],["title/195",[53,0.198]],["description/195",[15,5.401,53,0.205,62,0.488,122,3.65,309,3.846,410,3.744,619,6.234,643,6.957]],["title/196",[32,0.449,46,1.844,53,0.143]],["description/196",[20,3.793,32,0.686,46,2.818,53,0.218,644,7.411]],["title/197",[645,4.71]],["description/197",[6,4.38,53,0.214,645,5.088,646,7.253,647,7.253,648,7.253]],["title/198",[32,0.394,363,3.131,645,2.987,649,3.305]],["description/198",[17,0.276,53,0.197,179,0.423,180,1.047,181,0.432,190,1.091,363,4.917,645,4.689,649,5.19,650,6.684]],["title/199",[32,0.394,363,3.131,645,2.987,649,3.305]],["description/199",[17,0.261,32,0.584,53,0.186,179,0.399,180,0.989,181,0.408,190,1.03,205,1.562,238,2.485,363,4.644,645,4.429,649,4.901,651,6.313]],["title/200",[34,4.939]],["description/200",[6,4.201,34,5.117,50,3.122,78,6.234,98,5.757,123,3.399,162,4.501,611,6.234]],["title/201",[6,2.571,32,0.394,34,3.131,399,3.305]],["description/201",[3,0.793,6,4.201,32,0.644,34,5.117,123,3.399,178,4.501,399,5.401,652,6.957]],["title/202",[44,4.055]],["description/202",[3,0.372,6,0.636,7,3.59,11,2.581,20,0.982,21,3.683,23,0.871,24,0.943,28,0.636,32,0.177,37,0.943,38,0.943,39,0.943,40,0.943,41,0.943,42,0.871,43,0.943,44,4.387,45,0.943,53,0.057,56,0.224,66,0.369,68,0.392,72,0.432,76,2.657,77,0.421,79,0.482,80,0.463,97,1.489,114,0.539,131,0.475,134,0.099,135,1.159,137,0.387,139,0.628,162,2.748,163,4.133,164,3.849,165,3.849,166,4.1,167,4.322,168,4.17,169,1.588,170,3.795,171,1.588,172,0.943,173,1.29,174,0.73,175,1.489,176,0.943,177,1.588,178,1.241,186,0.943,187,0.943,188,0.943,189,0.943,194,0.369,203,0.598,228,0.943,229,3.513,230,1.719,231,1.588,232,0.943,233,0.681,234,1.719,299,0.943,300,2.697,301,2.052,302,1.588,415,1.06,428,0.943,429,1.719,430,0.871,431,0.943,432,0.943,433,0.943,434,0.943,435,0.943,436,0.943,437,0.943,458,0.943,459,1.719,460,0.943,461,0.943,462,0.943,463,2.368,464,0.943,465,0.943,466,0.943,613,0.943,653,1.053,654,1.053,655,1.918,656,1.053,657,1.053]]],"invertedIndex":[["",{"_index":7,"title":{},"description":{"0":{},"3":{},"6":{},"16":{},"19":{},"22":{},"52":{},"73":{},"109":{},"118":{},"154":{},"158":{},"160":{},"168":{},"202":{}}}],["00:00",{"_index":453,"title":{},"description":{"117":{}}}],["0:00",{"_index":167,"title":{},"description":{"3":{},"6":{},"16":{},"52":{},"109":{},"118":{},"168":{},"202":{}}}],["1",{"_index":304,"title":{},"description":{"54":{}}}],["100",{"_index":327,"title":{},"description":{"64":{},"65":{}}}],["10th",{"_index":462,"title":{},"description":{"118":{},"202":{}}}],["13th",{"_index":230,"title":{},"description":{"16":{},"202":{}}}],["15th",{"_index":302,"title":{},"description":{"52":{},"168":{},"202":{}}}],["17th",{"_index":165,"title":{},"description":{"3":{},"6":{},"202":{}}}],["2023",{"_index":166,"title":{},"description":{"3":{},"6":{},"52":{},"109":{},"118":{},"168":{},"202":{}}}],["2024",{"_index":435,"title":{},"description":{"109":{},"202":{}}}],["2025",{"_index":466,"title":{},"description":{"118":{},"202":{}}}],["2026",{"_index":231,"title":{},"description":{"16":{},"117":{},"202":{}}}],["25th",{"_index":460,"title":{},"description":{"118":{},"202":{}}}],["26th",{"_index":431,"title":{},"description":{"109":{},"202":{}}}],["30",{"_index":434,"title":{},"description":{"109":{},"202":{}}}],["4th",{"_index":465,"title":{},"description":{"118":{},"202":{}}}],["6-charact",{"_index":484,"title":{},"description":{"121":{}}}],["9th",{"_index":452,"title":{},"description":{"117":{}}}],["_disconnected_",{"_index":102,"title":{},"description":{"0":{}}}],["absolut",{"_index":606,"title":{},"description":{"166":{}}}],["accept",{"_index":136,"title":{},"description":{"0":{},"14":{},"117":{}}}],["access",{"_index":154,"title":{},"description":{"2":{},"19":{},"22":{},"89":{},"183":{},"189":{}}}],["accordingli",{"_index":437,"title":{},"description":{"109":{},"202":{}}}],["account",{"_index":51,"title":{"1":{},"2":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{}},"description":{"0":{},"1":{},"2":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"19":{},"22":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"112":{}}}],["act",{"_index":54,"title":{},"description":{"0":{},"1":{}}}],["action",{"_index":647,"title":{},"description":{"197":{}}}],["activ",{"_index":498,"title":{},"description":{"131":{},"134":{},"179":{},"182":{}}}],["actual",{"_index":529,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["ad",{"_index":638,"title":{},"description":{"188":{}}}],["add",{"_index":642,"title":{},"description":{"194":{}}}],["address",{"_index":610,"title":{},"description":{"168":{}}}],["admin",{"_index":174,"title":{},"description":{"3":{},"6":{},"42":{},"43":{},"44":{},"45":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"202":{}}}],["against",{"_index":535,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["ai",{"_index":402,"title":{},"description":{"89":{}}}],["alloc",{"_index":107,"title":{"9":{},"23":{},"24":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{}},"description":{"0":{},"9":{},"19":{},"21":{},"22":{},"23":{},"24":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"46":{},"52":{},"109":{},"121":{},"137":{},"168":{},"170":{},"172":{},"173":{},"174":{}}}],["allow",{"_index":285,"title":{},"description":{"41":{},"105":{},"109":{},"175":{},"183":{}}}],["alongsid",{"_index":105,"title":{},"description":{"0":{}}}],["alreadi",{"_index":282,"title":{},"description":{"40":{},"152":{}}}],["already-`termin",{"_index":575,"title":{},"description":{"152":{}}}],["altern",{"_index":319,"title":{},"description":{"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{}}}],["anchor",{"_index":73,"title":{},"description":{"0":{},"3":{},"6":{},"16":{}}}],["announc",{"_index":43,"title":{},"description":{"0":{},"202":{}}}],["anoth",{"_index":288,"title":{},"description":{"41":{}}}],["anytim",{"_index":272,"title":{},"description":{"32":{}}}],["api",{"_index":6,"title":{"201":{}},"description":{"0":{},"1":{},"2":{},"17":{},"169":{},"197":{},"200":{},"201":{},"202":{}}}],["appropri",{"_index":75,"title":{},"description":{"0":{}}}],["april",{"_index":301,"title":{},"description":{"52":{},"118":{},"168":{},"202":{}}}],["array",{"_index":366,"title":{},"description":{"75":{}}}],["assign",{"_index":142,"title":{"136":{}},"description":{"0":{},"121":{},"136":{}}}],["associ",{"_index":145,"title":{"115":{},"116":{},"117":{}},"description":{"0":{},"25":{},"26":{},"116":{},"117":{},"131":{},"134":{},"167":{},"172":{},"174":{},"187":{},"191":{},"193":{}}}],["atom",{"_index":469,"title":{},"description":{"121":{}}}],["attach",{"_index":457,"title":{},"description":{"118":{}}}],["attribut",{"_index":162,"title":{},"description":{"3":{},"6":{},"16":{},"109":{},"132":{},"156":{},"200":{},"202":{}}}],["audit",{"_index":645,"title":{"197":{},"198":{},"199":{}},"description":{"197":{},"198":{},"199":{}}}],["august",{"_index":164,"title":{},"description":{"3":{},"6":{},"202":{}}}],["auth",{"_index":25,"title":{},"description":{"0":{}}}],["authent",{"_index":8,"title":{},"description":{"0":{}}}],["author",{"_index":179,"title":{},"description":{"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"25":{},"26":{},"28":{},"30":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"47":{},"48":{},"49":{},"50":{},"51":{},"53":{},"54":{},"55":{},"56":{},"57":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"104":{},"105":{},"106":{},"107":{},"108":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"130":{},"133":{},"135":{},"136":{},"137":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"152":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"163":{},"164":{},"165":{},"166":{},"167":{},"169":{},"170":{},"171":{},"172":{},"174":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"198":{},"199":{}}}],["automat",{"_index":173,"title":{},"description":{"3":{},"6":{},"86":{},"87":{},"88":{},"121":{},"202":{}}}],["avail",{"_index":99,"title":{},"description":{"0":{},"25":{},"121":{}}}],["awar",{"_index":30,"title":{},"description":{"0":{}}}],["backward",{"_index":38,"title":{},"description":{"0":{},"202":{}}}],["batch",{"_index":324,"title":{"64":{},"65":{},"121":{}},"description":{"64":{},"65":{},"121":{}}}],["be",{"_index":31,"title":{},"description":{"0":{},"182":{},"188":{}}}],["bearer",{"_index":13,"title":{},"description":{"0":{}}}],["becom",{"_index":487,"title":{},"description":{"121":{}}}],["behalf",{"_index":643,"title":{},"description":{"195":{}}}],["belong",{"_index":195,"title":{},"description":{"9":{},"26":{},"29":{},"31":{},"43":{},"44":{},"45":{},"46":{},"52":{},"64":{},"65":{},"122":{},"123":{},"124":{},"133":{},"135":{},"136":{},"137":{},"165":{},"166":{},"167":{},"174":{}}}],["best-effort",{"_index":564,"title":{},"description":{"152":{}}}],["between",{"_index":290,"title":{},"description":{"43":{},"46":{},"52":{},"96":{},"162":{}}}],["bill",{"_index":380,"title":{},"description":{"86":{}}}],["block",{"_index":80,"title":{"168":{},"169":{},"170":{},"171":{},"172":{},"173":{},"174":{}},"description":{"0":{},"25":{},"32":{},"46":{},"52":{},"54":{},"129":{},"140":{},"168":{},"169":{},"170":{},"171":{},"172":{},"173":{},"174":{},"202":{}}}],["blocksiz",{"_index":613,"title":{},"description":{"168":{},"202":{}}}],["bmc",{"_index":312,"title":{},"description":{"58":{},"66":{},"80":{}}}],["bodi",{"_index":361,"title":{},"description":{"75":{}}}],["bom",{"_index":382,"title":{},"description":{"86":{}}}],["boot",{"_index":423,"title":{},"description":{"103":{}}}],["both",{"_index":55,"title":{},"description":{"0":{},"1":{},"24":{},"43":{},"45":{},"105":{},"110":{},"117":{}}}],["boundari",{"_index":277,"title":{},"description":{"34":{}}}],["break",{"_index":41,"title":{},"description":{"0":{},"202":{}}}],["breakdown",{"_index":519,"title":{},"description":{"137":{}}}],["brief",{"_index":94,"title":{},"description":{"0":{}}}],["bring",{"_index":556,"title":{"149":{},"150":{}},"description":{"149":{},"150":{}}}],["broken",{"_index":514,"title":{},"description":{"136":{}}}],["build",{"_index":496,"title":{},"description":{"129":{},"140":{}}}],["call",{"_index":33,"title":{},"description":{"0":{}}}],["cancel",{"_index":563,"title":{"152":{}},"description":{"152":{}}}],["capabl",{"_index":66,"title":{"138":{},"139":{}},"description":{"0":{},"1":{},"16":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"109":{},"116":{},"138":{},"139":{},"202":{}}}],["case",{"_index":59,"title":{},"description":{"0":{},"32":{}}}],["certain",{"_index":505,"title":{},"description":{"133":{}}}],["chang",{"_index":42,"title":{},"description":{"0":{},"152":{},"202":{}}}],["characterist",{"_index":384,"title":{},"description":{"86":{},"87":{},"88":{}}}],["chassi",{"_index":339,"title":{},"description":{"72":{},"73":{}}}],["chassis.manufactur",{"_index":346,"title":{},"description":{"72":{},"73":{}}}],["chassis.model",{"_index":348,"title":{},"description":{"72":{},"73":{}}}],["chassis.serial-numb",{"_index":347,"title":{},"description":{"72":{},"73":{}}}],["child",{"_index":617,"title":{},"description":{"174":{}}}],["choos",{"_index":101,"title":{},"description":{"0":{}}}],["clear",{"_index":368,"title":{},"description":{"75":{}}}],["combin",{"_index":585,"title":{},"description":{"154":{},"158":{},"160":{}}}],["commun",{"_index":287,"title":{},"description":{"41":{},"96":{}}}],["compar",{"_index":528,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["compat",{"_index":39,"title":{},"description":{"0":{},"202":{}}}],["complet",{"_index":607,"title":{},"description":{"166":{}}}],["compon",{"_index":527,"title":{},"description":{"143":{},"144":{},"153":{},"154":{},"156":{},"157":{}}}],["component-level",{"_index":588,"title":{},"description":{"154":{},"158":{},"160":{}}}],["componentid",{"_index":589,"title":{},"description":{"154":{},"158":{},"160":{}}}],["comput",{"_index":147,"title":{},"description":{"0":{},"6":{},"23":{},"25":{},"89":{}}}],["configur",{"_index":19,"title":{},"description":{"0":{},"1":{},"2":{},"20":{},"86":{},"87":{},"88":{},"121":{},"143":{},"144":{},"156":{},"157":{}}}],["confirm/accept",{"_index":215,"title":{},"description":{"12":{}}}],["connect",{"_index":197,"title":{},"description":{"10":{},"46":{},"52":{}}}],["consol",{"_index":633,"title":{},"description":{"183":{},"189":{}}}],["constraint",{"_index":258,"title":{"29":{},"30":{},"31":{},"32":{},"33":{}},"description":{"25":{},"29":{},"30":{},"31":{},"32":{},"33":{},"154":{},"158":{},"160":{}}}],["constraintvalu",{"_index":270,"title":{},"description":{"32":{}}}],["consult",{"_index":22,"title":{},"description":{"0":{}}}],["consum",{"_index":185,"title":{},"description":{"6":{}}}],["contain",{"_index":223,"title":{},"description":{"16":{},"129":{},"140":{}}}],["contigu",{"_index":609,"title":{},"description":{"168":{}}}],["continu",{"_index":450,"title":{},"description":{"117":{}}}],["control",{"_index":545,"title":{"145":{},"146":{},"158":{},"159":{}},"description":{"145":{},"146":{},"158":{},"159":{},"162":{}}}],["convey",{"_index":342,"title":{},"description":{"72":{},"73":{}}}],["core",{"_index":87,"title":{},"description":{"0":{}}}],["count",{"_index":511,"title":{},"description":{"136":{}}}],["cpu",{"_index":408,"title":{},"description":{"89":{},"129":{}}}],["creat",{"_index":72,"title":{"12":{},"18":{},"25":{},"30":{},"36":{},"43":{},"48":{},"54":{},"59":{},"64":{},"67":{},"73":{},"81":{},"91":{},"98":{},"105":{},"111":{},"116":{},"120":{},"121":{},"164":{},"170":{},"177":{},"185":{},"191":{}},"description":{"0":{},"3":{},"6":{},"12":{},"15":{},"16":{},"18":{},"25":{},"27":{},"29":{},"30":{},"31":{},"32":{},"33":{},"36":{},"43":{},"48":{},"54":{},"59":{},"64":{},"67":{},"73":{},"75":{},"81":{},"91":{},"98":{},"105":{},"111":{},"120":{},"121":{},"151":{},"152":{},"164":{},"166":{},"170":{},"173":{},"174":{},"177":{},"180":{},"185":{},"191":{},"202":{}}}],["credenti",{"_index":313,"title":{},"description":{"58":{},"66":{},"80":{},"180":{}}}],["criteria",{"_index":506,"title":{},"description":{"133":{}}}],["current",{"_index":46,"title":{"2":{},"4":{},"5":{},"7":{},"8":{},"196":{}},"description":{"0":{},"2":{},"4":{},"5":{},"7":{},"8":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"196":{}}}],["custom",{"_index":624,"title":{},"description":{"175":{}}}],["cycl",{"_index":548,"title":{},"description":{"145":{},"146":{},"158":{},"159":{}}}],["data",{"_index":128,"title":{},"description":{"0":{},"12":{},"105":{},"180":{}}}],["datacent",{"_index":222,"title":{},"description":{"16":{}}}],["decommiss",{"_index":274,"title":{},"description":{"32":{}}}],["decrement",{"_index":273,"title":{},"description":{"32":{}}}],["default",{"_index":476,"title":{},"description":{"121":{}}}],["defin",{"_index":86,"title":{},"description":{"0":{},"34":{},"86":{},"109":{},"139":{},"168":{}}}],["deleg",{"_index":248,"title":{},"description":{"23":{},"168":{}}}],["delet",{"_index":221,"title":{"15":{},"21":{},"27":{},"33":{},"38":{},"45":{},"50":{},"56":{},"63":{},"71":{},"76":{},"79":{},"85":{},"93":{},"101":{},"107":{},"113":{},"117":{},"123":{},"133":{},"167":{},"172":{},"179":{},"182":{},"187":{},"193":{}},"description":{"15":{},"21":{},"27":{},"33":{},"38":{},"45":{},"50":{},"56":{},"63":{},"71":{},"75":{},"76":{},"79":{},"85":{},"93":{},"101":{},"107":{},"113":{},"117":{},"123":{},"133":{},"167":{},"172":{},"179":{},"182":{},"187":{},"193":{}}}],["depend",{"_index":18,"title":{},"description":{"0":{}}}],["deploy",{"_index":104,"title":{},"description":{"0":{},"2":{},"179":{},"182":{}}}],["deprec",{"_index":44,"title":{"202":{}},"description":{"0":{},"3":{},"6":{},"16":{},"52":{},"109":{},"118":{},"168":{},"202":{}}}],["deprecations](#tag/deprec",{"_index":49,"title":{},"description":{"0":{}}}],["deriv",{"_index":383,"title":{"174":{}},"description":{"86":{},"87":{},"88":{}}}],["describ",{"_index":611,"title":{},"description":{"168":{},"200":{}}}],["design",{"_index":397,"title":{},"description":{"89":{}}}],["desir",{"_index":608,"title":{},"description":{"166":{}}}],["detail",{"_index":20,"title":{"137":{}},"description":{"0":{},"3":{},"6":{},"44":{},"112":{},"131":{},"134":{},"137":{},"143":{},"144":{},"156":{},"157":{},"181":{},"196":{},"202":{}}}],["diff",{"_index":536,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["differ",{"_index":294,"title":{},"description":{"43":{},"121":{}}}],["direct",{"_index":405,"title":{},"description":{"89":{},"96":{}}}],["directli",{"_index":226,"title":{},"description":{"16":{}}}],["disabl",{"_index":156,"title":{},"description":{"2":{}}}],["discov",{"_index":310,"title":{},"description":{"58":{},"59":{},"66":{},"67":{},"72":{},"73":{},"80":{},"81":{},"87":{},"88":{}}}],["discoveri",{"_index":317,"title":{},"description":{"58":{},"66":{},"72":{},"80":{}}}],["displaynam",{"_index":432,"title":{},"description":{"109":{},"202":{}}}],["distinct",{"_index":521,"title":{},"description":{"138":{}}}],["distribut",{"_index":412,"title":{},"description":{"89":{}}}],["domain",{"_index":477,"title":{},"description":{"121":{}}}],["domain-awar",{"_index":468,"title":{},"description":{"121":{}}}],["down",{"_index":515,"title":{},"description":{"136":{}}}],["dpu",{"_index":622,"title":{"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{}},"description":{"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{}}}],["e.g",{"_index":485,"title":{},"description":{"121":{}}}],["each",{"_index":83,"title":{},"description":{"0":{},"137":{}}}],["effect",{"_index":655,"title":{},"description":{"202":{}}}],["elig",{"_index":507,"title":{},"description":{"133":{}}}],["empti",{"_index":367,"title":{},"description":{"75":{}}}],["enabl",{"_index":67,"title":{},"description":{"0":{},"1":{},"2":{},"46":{},"52":{},"87":{},"88":{}}}],["enablesshaccess",{"_index":186,"title":{},"description":{"6":{},"202":{}}}],["enclosur",{"_index":523,"title":{},"description":{"140":{}}}],["endpoint",{"_index":76,"title":{},"description":{"0":{},"3":{},"6":{},"121":{},"194":{},"202":{}}}],["endpoint](#tag/allocation/operation/create-alloc",{"_index":108,"title":{},"description":{"0":{}}}],["endpoint](#tag/infrastructure-provider/operation/get-current-infrastructure-provid",{"_index":69,"title":{},"description":{"0":{}}}],["endpoint](#tag/instance-type/operation/create-instance-typ",{"_index":138,"title":{},"description":{"0":{}}}],["endpoint](#tag/instance-type/operation/create-instance-type-machine-associ",{"_index":146,"title":{},"description":{"0":{}}}],["endpoint](#tag/instance-type/operation/get-all-instance-typ",{"_index":152,"title":{},"description":{"0":{}}}],["endpoint](#tag/ip-block/operation/create-ipblock",{"_index":90,"title":{},"description":{"0":{}}}],["endpoint](#tag/ip-block/operation/get-all-ipblock",{"_index":150,"title":{},"description":{"0":{}}}],["endpoint](#tag/machine/operation/get-all-machin",{"_index":130,"title":{},"description":{"0":{}}}],["endpoint](#tag/machine/operation/update-machin",{"_index":141,"title":{},"description":{"0":{}}}],["endpoint](#tag/metadata/operation/get-metadata",{"_index":35,"title":{},"description":{"0":{}}}],["endpoint](#tag/operating-system/operation/create-operating-system",{"_index":124,"title":{},"description":{"0":{}}}],["endpoint](#tag/service-account/operation/get-current-service-account",{"_index":61,"title":{},"description":{"0":{}}}],["endpoint](#tag/site/operation/get-all-sit",{"_index":100,"title":{},"description":{"0":{}}}],["endpoint](#tag/subnet/operation/create-subnet",{"_index":121,"title":{},"description":{"0":{}}}],["endpoint](#tag/tenant-account/operation/create-tenant-account",{"_index":132,"title":{},"description":{"0":{}}}],["endpoint](#tag/tenant-account/operation/update-tenant-account",{"_index":148,"title":{},"description":{"0":{}}}],["endpoint](#tag/tenant/operation/get-current-ten",{"_index":70,"title":{},"description":{"0":{}}}],["endpoint](#tag/vpc-prefix/operation/create-vpc-prefix",{"_index":119,"title":{},"description":{"0":{}}}],["endpoint](#tag/vpc/operation/create-vpc",{"_index":113,"title":{},"description":{"0":{}}}],["enough",{"_index":255,"title":{},"description":{"25":{}}}],["entiti",{"_index":62,"title":{},"description":{"0":{},"1":{},"3":{},"4":{},"6":{},"7":{},"11":{},"12":{},"13":{},"14":{},"15":{},"18":{},"21":{},"25":{},"27":{},"28":{},"29":{},"30":{},"31":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"47":{},"48":{},"49":{},"50":{},"51":{},"53":{},"54":{},"55":{},"56":{},"57":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"104":{},"105":{},"106":{},"107":{},"108":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"130":{},"131":{},"133":{},"134":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"152":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"163":{},"164":{},"165":{},"166":{},"167":{},"172":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{}}}],["entri",{"_index":363,"title":{"198":{},"199":{}},"description":{"75":{},"198":{},"199":{}}}],["equal",{"_index":261,"title":{},"description":{"25":{}}}],["etc",{"_index":473,"title":{},"description":{"121":{}}}],["exclus",{"_index":583,"title":{},"description":{"154":{},"158":{},"160":{}}}],["exist",{"_index":264,"title":{},"description":{"28":{},"32":{},"33":{},"39":{},"51":{},"57":{},"62":{},"63":{},"70":{},"71":{},"75":{},"78":{},"79":{},"84":{},"85":{},"94":{},"173":{}}}],["expect",{"_index":308,"title":{"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"66":{},"67":{},"68":{},"69":{},"70":{},"71":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"84":{},"85":{}},"description":{"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"66":{},"67":{},"68":{},"69":{},"70":{},"71":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"143":{},"144":{},"156":{},"157":{}}}],["expectedrack",{"_index":364,"title":{},"description":{"75":{}}}],["extens",{"_index":623,"title":{"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{}},"description":{"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{}}}],["extra",{"_index":540,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["fail",{"_index":479,"title":{},"description":{"121":{},"152":{}}}],["fals",{"_index":480,"title":{},"description":{"121":{}}}],["favor",{"_index":229,"title":{},"description":{"16":{},"52":{},"109":{},"118":{},"168":{},"202":{}}}],["file](https://github.com/nvidia/infra-controller-core/blob/v0.5.8/deploy/files/nico-api/nico-api-site-config.toml#l30",{"_index":89,"title":{},"description":{"0":{}}}],["filter",{"_index":531,"title":{},"description":{"143":{},"145":{},"147":{},"149":{},"154":{},"156":{},"158":{},"160":{}}}],["finish",{"_index":577,"title":{},"description":{"152":{}}}],["firmwar",{"_index":553,"title":{"147":{},"148":{},"160":{},"161":{}},"description":{"147":{},"148":{},"160":{},"161":{}}}],["first",{"_index":9,"title":{},"description":{"0":{}}}],["flow",{"_index":97,"title":{},"description":{"0":{},"16":{},"162":{},"202":{}}}],["fnn",{"_index":118,"title":{},"description":{"0":{},"46":{},"52":{}}}],["follow",{"_index":654,"title":{},"description":{"202":{}}}],["forcecycl",{"_index":550,"title":{},"description":{"145":{},"146":{},"158":{},"159":{}}}],["forceoff",{"_index":549,"title":{},"description":{"145":{},"146":{},"158":{},"159":{}}}],["forge_provider_admin",{"_index":357,"title":{},"description":{"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"152":{}}}],["forge_provider_view",{"_index":359,"title":{},"description":{"74":{},"77":{}}}],["full",{"_index":109,"title":{},"description":{"0":{},"75":{}}}],["futur",{"_index":657,"title":{},"description":{"202":{}}}],["gener",{"_index":36,"title":{},"description":{"0":{},"121":{}}}],["get",{"_index":0,"title":{"0":{}},"description":{}}],["given",{"_index":265,"title":{},"description":{"29":{},"30":{},"31":{},"115":{}}}],["gpu",{"_index":418,"title":{"135":{}},"description":{"96":{},"129":{},"135":{}}}],["grant",{"_index":239,"title":{},"description":{"19":{},"22":{}}}],["group",{"_index":194,"title":{"162":{},"163":{},"164":{},"165":{},"166":{},"167":{},"183":{},"184":{},"185":{},"186":{},"187":{},"188":{}},"description":{"9":{},"86":{},"89":{},"96":{},"109":{},"135":{},"136":{},"139":{},"162":{},"163":{},"164":{},"165":{},"166":{},"167":{},"183":{},"184":{},"185":{},"186":{},"187":{},"188":{},"191":{},"193":{},"194":{},"202":{}}}],["hardwar",{"_index":225,"title":{},"description":{"16":{},"86":{},"87":{},"88":{},"129":{},"139":{}}}],["help",{"_index":316,"title":{},"description":{"58":{},"66":{},"72":{},"80":{}}}],["here",{"_index":653,"title":{},"description":{"202":{}}}],["high-perform",{"_index":394,"title":{},"description":{"89":{}}}],["histori",{"_index":161,"title":{"22":{},"125":{},"134":{}},"description":{"3":{},"6":{},"16":{},"22":{},"52":{},"109":{},"118":{},"125":{},"168":{}}}],["holder",{"_index":82,"title":{},"description":{"0":{}}}],["hpc",{"_index":401,"title":{},"description":{"89":{}}}],["ib",{"_index":393,"title":{},"description":{"89":{}}}],["id",{"_index":205,"title":{},"description":{"11":{},"12":{},"13":{},"14":{},"15":{},"19":{},"26":{},"27":{},"29":{},"30":{},"31":{},"32":{},"33":{},"37":{},"38":{},"44":{},"45":{},"50":{},"56":{},"61":{},"62":{},"63":{},"69":{},"70":{},"71":{},"77":{},"78":{},"79":{},"83":{},"84":{},"85":{},"88":{},"93":{},"99":{},"101":{},"104":{},"105":{},"106":{},"107":{},"108":{},"112":{},"113":{},"114":{},"117":{},"122":{},"123":{},"124":{},"142":{},"155":{},"165":{},"166":{},"167":{},"171":{},"178":{},"179":{},"186":{},"192":{},"193":{},"194":{},"199":{}}}],["id`/`componentid",{"_index":586,"title":{},"description":{"154":{}}}],["idempot",{"_index":565,"title":{},"description":{"152":{}}}],["ident",{"_index":340,"title":{},"description":{"72":{},"73":{}}}],["identifi",{"_index":309,"title":{},"description":{"58":{},"66":{},"72":{},"73":{},"78":{},"79":{},"80":{},"146":{},"148":{},"150":{},"159":{},"161":{},"195":{}}}],["ids`/`componentid",{"_index":596,"title":{},"description":{"158":{},"160":{}}}],["includ",{"_index":518,"title":{},"description":{"137":{}}}],["includemachineassign",{"_index":429,"title":{},"description":{"109":{},"202":{}}}],["includemachineassoci",{"_index":428,"title":{},"description":{"109":{},"202":{}}}],["increment",{"_index":271,"title":{},"description":{"32":{}}}],["indirectli",{"_index":227,"title":{},"description":{"16":{}}}],["individu",{"_index":619,"title":{},"description":{"174":{},"195":{}}}],["infer",{"_index":249,"title":{},"description":{"24":{},"26":{},"110":{}}}],["infiniband",{"_index":391,"title":{"89":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"127":{}},"description":{"89":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"127":{}}}],["inform",{"_index":178,"title":{},"description":{"3":{},"6":{},"10":{},"12":{},"72":{},"73":{},"201":{},"202":{}}}],["infrastructur",{"_index":68,"title":{"3":{},"4":{},"5":{}},"description":{"0":{},"3":{},"4":{},"5":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"18":{},"19":{},"20":{},"21":{},"22":{},"25":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"66":{},"67":{},"68":{},"69":{},"70":{},"71":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"104":{},"105":{},"106":{},"107":{},"108":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"130":{},"131":{},"133":{},"134":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"152":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"170":{},"172":{},"173":{},"174":{},"202":{}}}],["infrastructureproviderid",{"_index":201,"title":{},"description":{"11":{},"13":{},"17":{},"104":{},"105":{},"106":{},"107":{},"108":{},"169":{}}}],["ingest",{"_index":318,"title":{},"description":{"58":{},"66":{},"72":{},"80":{}}}],["initi",{"_index":63,"title":{},"description":{"0":{},"1":{}}}],["instal",{"_index":103,"title":{},"description":{"0":{}}}],["instanc",{"_index":131,"title":{"9":{},"109":{},"110":{},"111":{},"112":{},"113":{},"114":{},"118":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"127":{},"128":{},"136":{}},"description":{"0":{},"9":{},"25":{},"34":{},"40":{},"41":{},"46":{},"52":{},"109":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"131":{},"132":{},"134":{},"136":{},"137":{},"139":{},"162":{},"165":{},"166":{},"167":{},"175":{},"183":{},"189":{},"202":{}}}],["instancesubnet",{"_index":461,"title":{},"description":{"118":{},"202":{}}}],["instancetyp",{"_index":269,"title":{},"description":{"32":{}}}],["instead",{"_index":170,"title":{},"description":{"3":{},"6":{},"16":{},"52":{},"109":{},"118":{},"168":{},"202":{}}}],["insuffici",{"_index":478,"title":{},"description":{"121":{}}}],["interconnect",{"_index":398,"title":{},"description":{"89":{}}}],["interfac",{"_index":415,"title":{"95":{},"102":{},"126":{},"127":{},"128":{}},"description":{"95":{},"102":{},"118":{},"121":{},"126":{},"127":{},"128":{},"202":{}}}],["invit",{"_index":213,"title":{},"description":{"12":{},"14":{}}}],["ip",{"_index":79,"title":{"168":{},"169":{},"170":{},"171":{},"172":{},"173":{},"174":{}},"description":{"0":{},"25":{},"32":{},"46":{},"52":{},"54":{},"168":{},"169":{},"170":{},"171":{},"172":{},"173":{},"174":{},"202":{}}}],["ipblock",{"_index":275,"title":{},"description":{"32":{}}}],["ipblocks",{"_index":299,"title":{},"description":{"52":{},"202":{}}}],["ipv4",{"_index":305,"title":{},"description":{"54":{}}}],["ipv6",{"_index":306,"title":{},"description":{"54":{}}}],["ipx",{"_index":126,"title":{},"description":{"0":{},"103":{}}}],["isflowen",{"_index":234,"title":{},"description":{"16":{},"202":{}}}],["isol",{"_index":276,"title":{},"description":{"34":{},"89":{}}}],["israckleveladministrationen",{"_index":232,"title":{},"description":{"16":{},"202":{}}}],["isserialconsolesshkeysen",{"_index":187,"title":{},"description":{"6":{},"202":{}}}],["juli",{"_index":430,"title":{},"description":{"109":{},"117":{},"202":{}}}],["jwt",{"_index":12,"title":{},"description":{"0":{}}}],["k8",{"_index":625,"title":{},"description":{"175":{}}}],["keep",{"_index":377,"title":{},"description":{"86":{},"87":{},"88":{}}}],["key",{"_index":345,"title":{"183":{},"184":{},"185":{},"186":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{}},"description":{"72":{},"73":{},"121":{},"183":{},"184":{},"185":{},"186":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{}}}],["know",{"_index":133,"title":{},"description":{"0":{}}}],["label",{"_index":344,"title":{},"description":{"72":{},"73":{},"132":{}}}],["length",{"_index":111,"title":{},"description":{"0":{},"25":{},"168":{}}}],["level",{"_index":78,"title":{},"description":{"0":{},"200":{}}}],["list",{"_index":48,"title":{},"description":{"0":{},"75":{}}}],["load",{"_index":411,"title":{},"description":{"89":{}}}],["locat",{"_index":341,"title":{},"description":{"72":{},"73":{}}}],["location.datacent",{"_index":350,"title":{},"description":{"72":{},"73":{}}}],["location.posit",{"_index":352,"title":{},"description":{"72":{},"73":{}}}],["location.region",{"_index":349,"title":{},"description":{"72":{},"73":{}}}],["location.room",{"_index":351,"title":{},"description":{"72":{},"73":{}}}],["log",{"_index":649,"title":{"198":{},"199":{}},"description":{"198":{},"199":{}}}],["logic",{"_index":410,"title":{"96":{},"97":{},"98":{},"99":{},"100":{},"101":{}},"description":{"89":{},"96":{},"97":{},"98":{},"99":{},"100":{},"101":{},"195":{}}}],["longer",{"_index":454,"title":{},"description":{"117":{}}}],["low-lat",{"_index":395,"title":{},"description":{"89":{},"96":{}}}],["machin",{"_index":129,"title":{"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"129":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"138":{},"139":{}},"description":{"0":{},"25":{},"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"86":{},"87":{},"88":{},"89":{},"103":{},"109":{},"115":{},"116":{},"117":{},"118":{},"121":{},"129":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"138":{},"139":{},"140":{}}}],["machine'",{"_index":140,"title":{},"description":{"0":{},"116":{},"117":{}}}],["machine/inst",{"_index":442,"title":{"116":{},"117":{}},"description":{"117":{}}}],["machineassociationid",{"_index":446,"title":{},"description":{"117":{}}}],["machineid",{"_index":449,"title":{},"description":{"117":{}}}],["machines/inst",{"_index":440,"title":{"115":{}},"description":{}}],["maintain",{"_index":37,"title":{},"description":{"0":{},"202":{}}}],["mainten",{"_index":500,"title":{},"description":{"132":{}}}],["make",{"_index":60,"title":{},"description":{"0":{}}}],["manag",{"_index":160,"title":{},"description":{"3":{},"27":{},"28":{},"46":{},"86":{},"172":{},"173":{}}}],["manufactur",{"_index":534,"title":{},"description":{"143":{}}}],["mark",{"_index":570,"title":{},"description":{"152":{}}}],["match",{"_index":206,"title":{},"description":{"11":{},"12":{},"13":{},"14":{},"75":{},"104":{},"105":{},"106":{},"107":{},"108":{}}}],["materi",{"_index":381,"title":{},"description":{"86":{}}}],["maximum",{"_index":325,"title":{},"description":{"64":{},"65":{}}}],["mechan",{"_index":247,"title":{},"description":{"23":{}}}],["meet",{"_index":504,"title":{},"description":{"133":{}}}],["membership",{"_index":250,"title":{},"description":{"24":{},"26":{},"110":{}}}],["memori",{"_index":406,"title":{},"description":{"89":{},"96":{},"129":{}}}],["metadata",{"_index":34,"title":{"200":{},"201":{}},"description":{"0":{},"200":{},"201":{}}}],["mismatch",{"_index":541,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["miss",{"_index":539,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["mode",{"_index":52,"title":{},"description":{"0":{},"1":{}}}],["modifi",{"_index":245,"title":{},"description":{"20":{},"32":{},"180":{}}}],["modul",{"_index":26,"title":{},"description":{"0":{}}}],["more",{"_index":379,"title":{},"description":{"86":{},"118":{}}}],["multi-ten",{"_index":293,"title":{},"description":{"43":{},"45":{}}}],["multipl",{"_index":143,"title":{},"description":{"0":{},"64":{},"65":{},"121":{}}}],["mutual",{"_index":582,"title":{},"description":{"154":{},"158":{},"160":{}}}],["mvp",{"_index":263,"title":{},"description":{"27":{},"28":{},"105":{}}}],["name",{"_index":135,"title":{},"description":{"0":{},"3":{},"6":{},"12":{},"121":{},"135":{},"143":{},"147":{},"149":{},"202":{}}}],["name/manufacturer/typ",{"_index":593,"title":{},"description":{"156":{}}}],["nameprefix",{"_index":482,"title":{},"description":{"121":{}}}],["narrow",{"_index":532,"title":{},"description":{"143":{}}}],["nativ",{"_index":117,"title":{},"description":{"0":{},"46":{},"52":{}}}],["network",{"_index":84,"title":{"162":{},"163":{},"164":{},"165":{},"166":{},"167":{}},"description":{"0":{},"6":{},"16":{},"23":{},"25":{},"34":{},"40":{},"46":{},"52":{},"81":{},"89":{},"129":{},"162":{},"163":{},"164":{},"165":{},"166":{},"167":{},"168":{}}}],["new",{"_index":362,"title":{},"description":{"75":{},"180":{}}}],["next",{"_index":29,"title":{},"description":{"0":{}}}],["nico",{"_index":23,"title":{},"description":{"0":{},"103":{},"202":{}}}],["non-termin",{"_index":566,"title":{},"description":{"152":{}}}],["note",{"_index":91,"title":{},"description":{"0":{}}}],["notic",{"_index":45,"title":{},"description":{"0":{},"202":{}}}],["number",{"_index":315,"title":{},"description":{"58":{},"66":{},"80":{},"140":{}}}],["nvlink",{"_index":417,"title":{"96":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"128":{}},"description":{"96":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"121":{},"128":{}}}],["nvo",{"_index":372,"title":{},"description":{"80":{}}}],["object",{"_index":219,"title":{},"description":{"14":{},"16":{}}}],["octob",{"_index":433,"title":{},"description":{"109":{},"202":{}}}],["offer",{"_index":296,"title":{},"description":{"46":{}}}],["older",{"_index":236,"title":{},"description":{"17":{},"169":{}}}],["on",{"_index":286,"title":{},"description":{"41":{},"42":{},"44":{},"86":{},"118":{}}}],["onc",{"_index":74,"title":{},"description":{"0":{}}}],["onlin",{"_index":636,"title":{},"description":{"187":{},"188":{},"191":{},"193":{}}}],["onward",{"_index":93,"title":{},"description":{"0":{}}}],["oper",{"_index":122,"title":{"103":{},"104":{},"105":{},"106":{},"107":{},"108":{}},"description":{"0":{},"103":{},"104":{},"105":{},"106":{},"107":{},"108":{},"118":{},"195":{}}}],["operator-suppli",{"_index":336,"title":{},"description":{"72":{},"73":{}}}],["option",{"_index":546,"title":{},"description":{"145":{},"147":{},"149":{},"158":{},"160":{}}}],["org",{"_index":134,"title":{"2":{},"4":{},"7":{}},"description":{"0":{},"2":{},"3":{},"4":{},"6":{},"7":{},"11":{},"12":{},"13":{},"14":{},"15":{},"17":{},"18":{},"21":{},"24":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"44":{},"47":{},"48":{},"49":{},"50":{},"51":{},"53":{},"54":{},"55":{},"56":{},"57":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"104":{},"105":{},"106":{},"107":{},"108":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"130":{},"131":{},"133":{},"134":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"152":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"163":{},"164":{},"165":{},"166":{},"167":{},"169":{},"170":{},"172":{},"173":{},"174":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"202":{}}}],["org'",{"_index":240,"title":{},"description":{"19":{},"22":{},"24":{},"26":{},"110":{}}}],["org/:orgname/nico/infrastructure-provid",{"_index":172,"title":{},"description":{"3":{},"202":{}}}],["org/:orgname/nico/infrastructure-provider/curr",{"_index":176,"title":{},"description":{"3":{},"202":{}}}],["org/:orgname/nico/ten",{"_index":188,"title":{},"description":{"6":{},"202":{}}}],["org/:orgname/nico/tenant/curr",{"_index":189,"title":{},"description":{"6":{},"202":{}}}],["organ",{"_index":15,"title":{},"description":{"0":{},"3":{},"6":{},"195":{}}}],["orgdisplaynam",{"_index":169,"title":{},"description":{"3":{},"6":{},"202":{}}}],["os",{"_index":471,"title":{},"description":{"121":{}}}],["other",{"_index":503,"title":{},"description":{"132":{}}}],["otherwis",{"_index":120,"title":{},"description":{"0":{}}}],["outlin",{"_index":95,"title":{},"description":{"0":{}}}],["overhead",{"_index":409,"title":{},"description":{"89":{}}}],["overlay",{"_index":85,"title":{},"description":{"0":{},"168":{}}}],["overview",{"_index":5,"title":{},"description":{"0":{}}}],["own",{"_index":159,"title":{},"description":{"3":{},"19":{},"22":{},"42":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"131":{},"134":{},"178":{},"179":{},"180":{},"181":{},"182":{},"186":{},"187":{},"188":{},"192":{},"193":{},"194":{}}}],["owner",{"_index":243,"title":{},"description":{"20":{}}}],["param",{"_index":204,"title":{},"description":{"11":{},"13":{},"17":{},"105":{},"169":{}}}],["paramet",{"_index":233,"title":{},"description":{"16":{},"60":{},"68":{},"74":{},"82":{},"87":{},"117":{},"202":{}}}],["part",{"_index":57,"title":{},"description":{"0":{},"193":{}}}],["particular",{"_index":612,"title":{},"description":{"168":{}}}],["partit",{"_index":392,"title":{"89":{},"90":{},"91":{},"92":{},"93":{},"94":{},"96":{},"97":{},"98":{},"99":{},"100":{},"101":{}},"description":{"89":{},"90":{},"91":{},"92":{},"93":{},"94":{},"96":{},"97":{},"98":{},"99":{},"100":{},"101":{}}}],["past",{"_index":47,"title":{},"description":{"0":{}}}],["patch",{"_index":175,"title":{},"description":{"3":{},"6":{},"173":{},"202":{}}}],["path",{"_index":447,"title":{},"description":{"117":{}}}],["peer",{"_index":284,"title":{"41":{},"42":{},"43":{},"44":{},"45":{}},"description":{"41":{},"42":{},"43":{},"44":{},"45":{}}}],["pend",{"_index":567,"title":{},"description":{"152":{}}}],["per",{"_index":328,"title":{},"description":{"64":{},"65":{}}}],["per-instance-typ",{"_index":517,"title":{"137":{}},"description":{}}],["per-ten",{"_index":193,"title":{"9":{}},"description":{}}],["perspect",{"_index":252,"title":{},"description":{"24":{},"110":{}}}],["pertain",{"_index":199,"title":{},"description":{"10":{}}}],["physic",{"_index":224,"title":{},"description":{"16":{},"72":{},"73":{},"129":{},"140":{}}}],["pleas",{"_index":21,"title":{},"description":{"0":{},"3":{},"6":{},"16":{},"52":{},"109":{},"118":{},"168":{},"194":{},"202":{}}}],["pod",{"_index":626,"title":{},"description":{"175":{}}}],["point",{"_index":92,"title":{},"description":{"0":{}}}],["polici",{"_index":602,"title":{},"description":{"162":{},"166":{},"167":{}}}],["pool",{"_index":426,"title":{},"description":{"109":{}}}],["popul",{"_index":177,"title":{},"description":{"3":{},"6":{},"202":{}}}],["portion",{"_index":427,"title":{},"description":{"109":{},"168":{}}}],["possibl",{"_index":268,"title":{},"description":{"32":{}}}],["post",{"_index":171,"title":{},"description":{"3":{},"6":{},"202":{}}}],["power",{"_index":330,"title":{"66":{},"67":{},"68":{},"69":{},"70":{},"71":{},"145":{},"146":{},"158":{},"159":{}},"description":{"66":{},"67":{},"68":{},"69":{},"70":{},"71":{},"145":{},"146":{},"158":{},"159":{}}}],["pre-regist",{"_index":311,"title":{},"description":{"58":{},"59":{},"66":{},"67":{},"72":{},"73":{},"80":{},"81":{}}}],["prefix",{"_index":110,"title":{"46":{},"47":{},"48":{},"49":{},"50":{},"51":{}},"description":{"0":{},"25":{},"46":{},"47":{},"48":{},"49":{},"50":{},"51":{},"52":{},"118":{},"168":{}}}],["prefixlength",{"_index":300,"title":{},"description":{"52":{},"168":{},"202":{}}}],["present",{"_index":244,"title":{},"description":{"20":{}}}],["previou",{"_index":40,"title":{},"description":{"0":{},"202":{}}}],["privileg",{"_index":64,"title":{},"description":{"0":{},"1":{},"19":{},"22":{},"87":{},"132":{}}}],["proce",{"_index":637,"title":{},"description":{"187":{},"188":{},"193":{}}}],["process",{"_index":502,"title":{},"description":{"132":{}}}],["profil",{"_index":337,"title":{},"description":{"72":{}}}],["provid",{"_index":3,"title":{"3":{},"4":{},"5":{}},"description":{"0":{},"1":{},"3":{},"4":{},"5":{},"9":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"18":{},"19":{},"20":{},"21":{},"22":{},"23":{},"24":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"42":{},"43":{},"44":{},"45":{},"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"66":{},"67":{},"68":{},"69":{},"70":{},"71":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"104":{},"105":{},"106":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"152":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"168":{},"170":{},"172":{},"173":{},"174":{},"201":{},"202":{}}}],["provider_admin",{"_index":180,"title":{},"description":{"4":{},"5":{},"9":{},"11":{},"12":{},"13":{},"15":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"42":{},"43":{},"44":{},"45":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"104":{},"105":{},"106":{},"107":{},"108":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"130":{},"131":{},"133":{},"134":{},"135":{},"136":{},"137":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"169":{},"170":{},"171":{},"172":{},"173":{},"174":{},"198":{},"199":{}}}],["provider_view",{"_index":321,"title":{},"description":{"60":{},"61":{},"68":{},"69":{},"82":{},"83":{},"87":{},"88":{}}}],["provis",{"_index":456,"title":{},"description":{"118":{}}}],["public",{"_index":639,"title":{},"description":{"189":{}}}],["queri",{"_index":203,"title":{},"description":{"11":{},"13":{},"16":{},"17":{},"60":{},"68":{},"74":{},"82":{},"87":{},"105":{},"169":{},"202":{}}}],["quick",{"_index":4,"title":{},"description":{"0":{}}}],["rack",{"_index":335,"title":{"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{}},"description":{"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"140":{},"141":{},"142":{},"143":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"153":{},"156":{}}}],["rack'",{"_index":543,"title":{},"description":{"144":{}}}],["rack-level",{"_index":587,"title":{},"description":{"154":{},"158":{},"160":{}}}],["rackid",{"_index":353,"title":{},"description":{"73":{},"75":{},"154":{},"158":{},"160":{}}}],["rackid/racknam",{"_index":592,"title":{},"description":{"156":{}}}],["rackid`/`racknam",{"_index":584,"title":{},"description":{"154":{},"158":{},"160":{}}}],["rackleveladministr",{"_index":228,"title":{},"description":{"16":{},"202":{}}}],["racknam",{"_index":581,"title":{},"description":{"154":{},"158":{},"160":{}}}],["random",{"_index":483,"title":{},"description":{"121":{}}}],["rdma",{"_index":403,"title":{},"description":{"89":{}}}],["read-onli",{"_index":386,"title":{},"description":{"86":{}}}],["readme](https://github.com/nvidia/infra-controller-rest/tree/main/auth",{"_index":27,"title":{},"description":{"0":{}}}],["receiv",{"_index":151,"title":{},"description":{"0":{}}}],["record",{"_index":646,"title":{},"description":{"197":{}}}],["reduc",{"_index":407,"title":{},"description":{"89":{}}}],["refer",{"_index":338,"title":{},"description":{"72":{},"75":{}}}],["referenc",{"_index":115,"title":{},"description":{"0":{}}}],["reject",{"_index":281,"title":{},"description":{"40":{}}}],["relationship",{"_index":200,"title":{},"description":{"10":{}}}],["remot",{"_index":404,"title":{},"description":{"89":{}}}],["remov",{"_index":163,"title":{},"description":{"3":{},"6":{},"16":{},"52":{},"109":{},"118":{},"168":{},"188":{},"194":{},"202":{}}}],["renam",{"_index":448,"title":{},"description":{"117":{}}}],["replac",{"_index":360,"title":{"75":{}},"description":{"75":{}}}],["report",{"_index":537,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["repres",{"_index":387,"title":{},"description":{"87":{},"88":{},"153":{}}}],["represents/contain",{"_index":198,"title":{},"description":{"10":{}}}],["request",{"_index":209,"title":{},"description":{"12":{},"15":{},"27":{},"29":{},"31":{},"32":{},"33":{},"40":{},"64":{},"65":{},"75":{},"87":{},"105":{},"121":{},"131":{},"132":{},"134":{},"173":{}}}],["requir",{"_index":235,"title":{},"description":{"17":{},"32":{},"60":{},"68":{},"74":{},"82":{},"87":{},"116":{},"154":{},"158":{},"160":{},"169":{}}}],["resourc",{"_index":71,"title":{},"description":{"0":{},"3":{},"6":{},"16":{},"23":{},"32":{}}}],["rest",{"_index":24,"title":{},"description":{"0":{},"202":{}}}],["result",{"_index":251,"title":{},"description":{"24":{},"110":{},"174":{}}}],["retriev",{"_index":32,"title":{"2":{},"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"13":{},"17":{},"19":{},"22":{},"24":{},"26":{},"29":{},"31":{},"35":{},"37":{},"42":{},"44":{},"47":{},"49":{},"53":{},"55":{},"60":{},"61":{},"68":{},"69":{},"74":{},"77":{},"82":{},"83":{},"87":{},"88":{},"90":{},"92":{},"95":{},"97":{},"99":{},"102":{},"104":{},"106":{},"110":{},"112":{},"115":{},"119":{},"122":{},"125":{},"126":{},"127":{},"128":{},"130":{},"131":{},"134":{},"135":{},"136":{},"137":{},"138":{},"141":{},"142":{},"151":{},"154":{},"155":{},"163":{},"165":{},"169":{},"171":{},"174":{},"176":{},"178":{},"181":{},"184":{},"186":{},"190":{},"192":{},"196":{},"198":{},"199":{},"201":{}},"description":{"0":{},"2":{},"3":{},"4":{},"5":{},"6":{},"7":{},"8":{},"11":{},"13":{},"17":{},"19":{},"22":{},"24":{},"26":{},"29":{},"31":{},"35":{},"37":{},"47":{},"49":{},"53":{},"55":{},"60":{},"61":{},"68":{},"69":{},"74":{},"77":{},"82":{},"83":{},"87":{},"88":{},"90":{},"92":{},"97":{},"99":{},"169":{},"171":{},"174":{},"176":{},"178":{},"181":{},"184":{},"186":{},"190":{},"192":{},"196":{},"199":{},"201":{},"202":{}}}],["return",{"_index":149,"title":{},"description":{"0":{},"9":{},"24":{},"110":{},"112":{},"135":{},"136":{},"137":{},"143":{},"144":{},"152":{},"156":{},"157":{}}}],["role",{"_index":17,"title":{},"description":{"0":{},"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"47":{},"48":{},"49":{},"50":{},"51":{},"53":{},"54":{},"55":{},"56":{},"57":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"104":{},"105":{},"106":{},"107":{},"108":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"130":{},"131":{},"133":{},"134":{},"135":{},"136":{},"137":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"152":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"163":{},"164":{},"165":{},"166":{},"167":{},"169":{},"170":{},"171":{},"172":{},"173":{},"174":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"198":{},"199":{}}}],["root",{"_index":615,"title":{},"description":{"170":{},"172":{},"173":{}}}],["run",{"_index":568,"title":{},"description":{"152":{},"175":{}}}],["same",{"_index":58,"title":{},"description":{"0":{},"41":{},"43":{},"64":{},"65":{},"75":{},"105":{},"121":{},"132":{},"152":{}}}],["satisfi",{"_index":257,"title":{},"description":{"25":{}}}],["scope",{"_index":533,"title":{},"description":{"143":{},"156":{}}}],["script",{"_index":127,"title":{},"description":{"0":{},"103":{}}}],["section",{"_index":2,"title":{},"description":{"0":{}}}],["secur",{"_index":601,"title":{"162":{},"163":{},"164":{},"165":{},"166":{},"167":{}},"description":{"162":{},"163":{},"164":{},"165":{},"166":{},"167":{}}}],["sent",{"_index":217,"title":{},"description":{"14":{}}}],["separ",{"_index":501,"title":{},"description":{"132":{}}}],["septemb",{"_index":464,"title":{},"description":{"118":{},"202":{}}}],["serial",{"_index":314,"title":{},"description":{"58":{},"66":{},"80":{},"183":{},"189":{}}}],["serialconsoleurl",{"_index":459,"title":{},"description":{"118":{},"202":{}}}],["server",{"_index":399,"title":{"201":{}},"description":{"89":{},"129":{},"201":{}}}],["servic",{"_index":50,"title":{"1":{},"2":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{}},"description":{"0":{},"1":{},"2":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"200":{}}}],["set",{"_index":212,"title":{},"description":{"12":{},"75":{},"104":{},"106":{},"107":{},"108":{},"166":{}}}],["sever",{"_index":630,"title":{},"description":{"183":{}}}],["share",{"_index":419,"title":{},"description":{"96":{},"121":{}}}],["shelf",{"_index":331,"title":{"66":{},"67":{},"69":{},"70":{},"71":{}},"description":{"66":{},"67":{},"69":{},"70":{},"71":{}}}],["shelv",{"_index":332,"title":{"68":{}},"description":{"66":{},"67":{},"68":{},"69":{},"70":{},"71":{}}}],["show",{"_index":538,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["similar",{"_index":385,"title":{},"description":{"86":{}}}],["singl",{"_index":106,"title":{},"description":{"0":{},"64":{},"65":{},"121":{}}}],["single-ten",{"_index":292,"title":{},"description":{"43":{}}}],["site",{"_index":77,"title":{"9":{},"16":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"133":{},"135":{},"136":{},"137":{}},"description":{"0":{},"3":{},"6":{},"9":{},"16":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"41":{},"42":{},"43":{},"44":{},"45":{},"46":{},"52":{},"58":{},"59":{},"64":{},"65":{},"66":{},"67":{},"72":{},"73":{},"75":{},"76":{},"80":{},"81":{},"87":{},"88":{},"129":{},"131":{},"134":{},"135":{},"136":{},"137":{},"140":{},"141":{},"143":{},"145":{},"147":{},"149":{},"151":{},"152":{},"154":{},"156":{},"158":{},"160":{},"168":{},"183":{},"187":{},"188":{},"191":{},"193":{},"202":{}}}],["site'",{"_index":241,"title":{},"description":{"19":{},"22":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{}}}],["site-level",{"_index":260,"title":{},"description":{"25":{}}}],["site-scop",{"_index":561,"title":{},"description":{"151":{},"152":{}}}],["siteid",{"_index":322,"title":{},"description":{"60":{},"68":{},"74":{},"75":{},"82":{},"87":{},"151":{},"152":{}}}],["size",{"_index":326,"title":{},"description":{"64":{},"65":{}}}],["sku",{"_index":375,"title":{"86":{},"87":{},"88":{}},"description":{"86":{},"87":{},"88":{}}}],["sku'",{"_index":389,"title":{},"description":{"88":{}}}],["slate",{"_index":656,"title":{},"description":{"202":{}}}],["sourc",{"_index":259,"title":{},"description":{"25":{}}}],["specif",{"_index":238,"title":{},"description":{"19":{},"20":{},"21":{},"22":{},"37":{},"38":{},"49":{},"50":{},"55":{},"56":{},"61":{},"69":{},"77":{},"83":{},"88":{},"92":{},"93":{},"99":{},"100":{},"143":{},"156":{},"174":{},"179":{},"180":{},"181":{},"182":{},"187":{},"188":{},"199":{}}}],["specifi",{"_index":125,"title":{},"description":{"0":{},"9":{},"11":{},"12":{},"13":{},"15":{},"27":{},"29":{},"30":{},"31":{},"32":{},"33":{},"54":{},"132":{},"135":{},"136":{},"137":{},"141":{},"143":{},"145":{},"147":{},"149":{},"154":{},"156":{},"158":{},"160":{},"166":{},"173":{},"191":{}}}],["spread",{"_index":481,"title":{},"description":{"121":{}}}],["ssh",{"_index":472,"title":{"183":{},"184":{},"185":{},"186":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{}},"description":{"121":{},"183":{},"184":{},"185":{},"186":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{}}}],["sshkeygroup",{"_index":463,"title":{},"description":{"118":{},"202":{}}}],["sshurl",{"_index":458,"title":{},"description":{"118":{},"202":{}}}],["standard",{"_index":396,"title":{},"description":{"89":{}}}],["start",{"_index":1,"title":{"0":{}},"description":{"0":{},"32":{}}}],["stat",{"_index":183,"title":{"5":{},"8":{},"9":{},"135":{},"137":{}},"description":{"5":{},"8":{},"9":{},"135":{},"137":{}}}],["state",{"_index":530,"title":{},"description":{"143":{},"144":{},"145":{},"146":{},"152":{},"156":{},"157":{},"158":{},"159":{}}}],["statu",{"_index":153,"title":{"2":{},"22":{},"125":{},"134":{}},"description":{"2":{},"12":{},"14":{},"22":{},"125":{},"136":{}}}],["step",{"_index":10,"title":{},"description":{"0":{}}}],["stock",{"_index":376,"title":{},"description":{"86":{},"87":{},"88":{}}}],["storag",{"_index":400,"title":{},"description":{"89":{},"129":{}}}],["string",{"_index":354,"title":{},"description":{"73":{}}}],["structur",{"_index":16,"title":{},"description":{"0":{}}}],["subnet",{"_index":114,"title":{"52":{},"53":{},"54":{},"55":{},"56":{},"57":{}},"description":{"0":{},"40":{},"52":{},"53":{},"54":{},"55":{},"56":{},"57":{},"118":{},"202":{}}}],["succe",{"_index":445,"title":{},"description":{"116":{}}}],["succeed",{"_index":578,"title":{},"description":{"152":{}}}],["successfulli",{"_index":254,"title":{},"description":{"25":{}}}],["suffix",{"_index":181,"title":{},"description":{"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"25":{},"26":{},"28":{},"30":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"47":{},"48":{},"49":{},"50":{},"51":{},"53":{},"54":{},"55":{},"56":{},"57":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"104":{},"105":{},"106":{},"107":{},"108":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"130":{},"133":{},"135":{},"136":{},"137":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"163":{},"164":{},"165":{},"166":{},"167":{},"169":{},"170":{},"171":{},"172":{},"174":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"198":{},"199":{}}}],["summari",{"_index":509,"title":{"136":{}},"description":{"135":{}}}],["super",{"_index":618,"title":{},"description":{"174":{}}}],["superset",{"_index":443,"title":{},"description":{"116":{}}}],["support",{"_index":116,"title":{},"description":{"0":{},"27":{},"28":{},"46":{},"52":{},"145":{},"146":{},"158":{},"159":{},"175":{}}}],["switch",{"_index":371,"title":{"80":{},"81":{},"82":{},"83":{},"84":{},"85":{}},"description":{"80":{},"81":{},"82":{},"83":{},"84":{},"85":{}}}],["sync",{"_index":632,"title":{},"description":{"183":{}}}],["system",{"_index":123,"title":{"103":{},"104":{},"105":{},"106":{},"107":{},"108":{}},"description":{"0":{},"86":{},"89":{},"103":{},"104":{},"105":{},"106":{},"107":{},"108":{},"118":{},"200":{},"201":{}}}],["taken",{"_index":648,"title":{},"description":{"197":{}}}],["target",{"_index":547,"title":{},"description":{"145":{},"147":{},"149":{},"154":{},"158":{},"160":{}}}],["targetedinstancecr",{"_index":65,"title":{},"description":{"0":{},"1":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{}}}],["task",{"_index":560,"title":{"151":{},"152":{}},"description":{"151":{},"152":{}}}],["tempor",{"_index":573,"title":{},"description":{"152":{}}}],["tenant",{"_index":56,"title":{"6":{},"7":{},"8":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{}},"description":{"0":{},"1":{},"6":{},"7":{},"8":{},"9":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"18":{},"19":{},"20":{},"22":{},"23":{},"24":{},"26":{},"27":{},"28":{},"29":{},"31":{},"32":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"48":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"55":{},"56":{},"57":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"104":{},"105":{},"106":{},"107":{},"108":{},"109":{},"110":{},"112":{},"118":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"131":{},"132":{},"134":{},"137":{},"163":{},"164":{},"165":{},"166":{},"167":{},"168":{},"170":{},"172":{},"173":{},"174":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"202":{}}}],["tenant'",{"_index":210,"title":{},"description":{"12":{},"34":{},"131":{},"134":{}}}],["tenant_admin",{"_index":190,"title":{},"description":{"7":{},"8":{},"11":{},"13":{},"14":{},"17":{},"19":{},"22":{},"24":{},"26":{},"29":{},"31":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"47":{},"48":{},"49":{},"50":{},"51":{},"53":{},"54":{},"55":{},"56":{},"57":{},"87":{},"88":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"104":{},"105":{},"106":{},"107":{},"108":{},"110":{},"112":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"131":{},"134":{},"163":{},"164":{},"165":{},"166":{},"167":{},"169":{},"171":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"198":{},"199":{}}}],["tenantaccount",{"_index":220,"title":{},"description":{"14":{}}}],["tenantid",{"_index":202,"title":{},"description":{"11":{},"13":{},"14":{},"17":{},"104":{},"105":{},"106":{},"107":{},"108":{},"169":{}}}],["termin",{"_index":571,"title":{},"description":{"152":{}}}],["time",{"_index":155,"title":{},"description":{"2":{},"105":{},"117":{},"132":{}}}],["togeth",{"_index":631,"title":{},"description":{"183":{}}}],["token",{"_index":14,"title":{},"description":{"0":{}}}],["toml",{"_index":88,"title":{},"description":{"0":{}}}],["top-level",{"_index":365,"title":{},"description":{"75":{}}}],["topologyoptim",{"_index":474,"title":{},"description":{"121":{}}}],["traffic",{"_index":603,"title":{},"description":{"162":{}}}],["transact",{"_index":470,"title":{},"description":{"121":{}}}],["tray",{"_index":580,"title":{"153":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{}},"description":{"153":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{}}}],["true",{"_index":475,"title":{},"description":{"121":{}}}],["two",{"_index":291,"title":{},"description":{"43":{}}}],["type",{"_index":137,"title":{"9":{},"109":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"136":{}},"description":{"0":{},"9":{},"25":{},"40":{},"109":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"132":{},"136":{},"137":{},"139":{},"154":{},"158":{},"160":{},"175":{},"202":{}}}],["type'",{"_index":444,"title":{},"description":{"116":{}}}],["type/machin",{"_index":144,"title":{},"description":{"0":{}}}],["typic",{"_index":96,"title":{},"description":{"0":{},"103":{}}}],["unalloc",{"_index":256,"title":{},"description":{"25":{}}}],["unassign",{"_index":513,"title":{},"description":{"136":{}}}],["underli",{"_index":572,"title":{},"description":{"152":{}}}],["uniqu",{"_index":355,"title":{},"description":{"73":{},"75":{},"87":{},"88":{}}}],["unit",{"_index":378,"title":{},"description":{"86":{},"87":{},"88":{}}}],["until",{"_index":451,"title":{},"description":{"117":{}}}],["up",{"_index":557,"title":{"149":{},"150":{}},"description":{"149":{},"150":{}}}],["updat",{"_index":139,"title":{"14":{},"20":{},"28":{},"32":{},"39":{},"40":{},"51":{},"57":{},"62":{},"65":{},"70":{},"78":{},"84":{},"94":{},"100":{},"108":{},"114":{},"124":{},"132":{},"147":{},"148":{},"160":{},"161":{},"166":{},"173":{},"180":{},"188":{},"194":{}},"description":{"0":{},"3":{},"6":{},"12":{},"14":{},"20":{},"28":{},"32":{},"39":{},"40":{},"51":{},"57":{},"62":{},"65":{},"70":{},"75":{},"78":{},"84":{},"94":{},"100":{},"108":{},"109":{},"114":{},"124":{},"132":{},"147":{},"148":{},"160":{},"161":{},"166":{},"173":{},"180":{},"188":{},"194":{},"202":{}}}],["url",{"_index":620,"title":{},"description":{"174":{}}}],["us",{"_index":11,"title":{},"description":{"0":{},"3":{},"6":{},"14":{},"16":{},"32":{},"46":{},"52":{},"58":{},"66":{},"80":{},"86":{},"89":{},"96":{},"103":{},"109":{},"118":{},"121":{},"139":{},"156":{},"168":{},"183":{},"189":{},"194":{},"202":{}}}],["usag",{"_index":436,"title":{},"description":{"109":{},"202":{}}}],["user",{"_index":53,"title":{"195":{},"196":{}},"description":{"0":{},"1":{},"3":{},"4":{},"5":{},"6":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"47":{},"48":{},"49":{},"50":{},"51":{},"53":{},"54":{},"55":{},"56":{},"57":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"104":{},"105":{},"106":{},"107":{},"108":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"130":{},"131":{},"133":{},"134":{},"135":{},"136":{},"137":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"152":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"163":{},"164":{},"165":{},"166":{},"167":{},"169":{},"170":{},"171":{},"172":{},"173":{},"174":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"196":{},"197":{},"198":{},"199":{},"202":{}}}],["utc",{"_index":168,"title":{},"description":{"3":{},"6":{},"16":{},"52":{},"109":{},"117":{},"118":{},"168":{},"202":{}}}],["util",{"_index":81,"title":{},"description":{"0":{},"32":{},"89":{}}}],["uuid",{"_index":211,"title":{},"description":{"12":{},"73":{},"146":{},"148":{},"150":{},"151":{},"159":{},"161":{}}}],["v2/org/{org}/nico/alloc",{"_index":253,"title":{},"description":{"24":{},"25":{}}}],["v2/org/{org}/nico/allocation/{allocationid",{"_index":262,"title":{},"description":{"26":{},"27":{},"28":{}}}],["v2/org/{org}/nico/allocation/{allocationid}/constraint",{"_index":266,"title":{},"description":{"29":{},"30":{}}}],["v2/org/{org}/nico/allocation/{allocationid}/constraint/{allocationconstraintid",{"_index":267,"title":{},"description":{"31":{},"32":{},"33":{}}}],["v2/org/{org}/nico/audit",{"_index":650,"title":{},"description":{"198":{}}}],["v2/org/{org}/nico/audit/{auditentryid",{"_index":651,"title":{},"description":{"199":{}}}],["v2/org/{org}/nico/dpu-extension-servic",{"_index":627,"title":{},"description":{"176":{},"177":{}}}],["v2/org/{org}/nico/dpu-extension-service/{dpuextensionserviceid",{"_index":628,"title":{},"description":{"178":{},"179":{},"180":{}}}],["v2/org/{org}/nico/dpu-extension-service/{dpuextensionserviceid}/version/{vers",{"_index":629,"title":{},"description":{"181":{},"182":{}}}],["v2/org/{org}/nico/expected-machin",{"_index":320,"title":{},"description":{"59":{},"60":{}}}],["v2/org/{org}/nico/expected-machine/batch",{"_index":329,"title":{},"description":{"64":{},"65":{}}}],["v2/org/{org}/nico/expected-machine/{expectedmachineid",{"_index":323,"title":{},"description":{"61":{},"62":{},"63":{}}}],["v2/org/{org}/nico/expected-power-shelf",{"_index":333,"title":{},"description":{"67":{},"68":{}}}],["v2/org/{org}/nico/expected-power-shelf/{expectedpowershelfid",{"_index":334,"title":{},"description":{"69":{},"70":{},"71":{}}}],["v2/org/{org}/nico/expected-rack",{"_index":358,"title":{},"description":{"73":{},"74":{},"75":{}}}],["v2/org/{org}/nico/expected-rack/al",{"_index":369,"title":{},"description":{"76":{}}}],["v2/org/{org}/nico/expected-rack/{id",{"_index":370,"title":{},"description":{"77":{},"78":{},"79":{}}}],["v2/org/{org}/nico/expected-switch",{"_index":373,"title":{},"description":{"81":{},"82":{}}}],["v2/org/{org}/nico/expected-switch/{expectedswitchid",{"_index":374,"title":{},"description":{"83":{},"84":{},"85":{}}}],["v2/org/{org}/nico/infiniband-interfac",{"_index":416,"title":{},"description":{"95":{}}}],["v2/org/{org}/nico/infiniband-partit",{"_index":413,"title":{},"description":{"90":{},"91":{}}}],["v2/org/{org}/nico/infiniband-partition/{infinibandpartitionid",{"_index":414,"title":{},"description":{"92":{},"93":{},"94":{}}}],["v2/org/{org}/nico/infrastructure-provider/curr",{"_index":182,"title":{},"description":{"4":{}}}],["v2/org/{org}/nico/infrastructure-provider/current/stat",{"_index":184,"title":{},"description":{"5":{}}}],["v2/org/{org}/nico/inst",{"_index":467,"title":{},"description":{"119":{},"120":{}}}],["v2/org/{org}/nico/instance/batch",{"_index":490,"title":{},"description":{"121":{}}}],["v2/org/{org}/nico/instance/typ",{"_index":438,"title":{},"description":{"110":{},"111":{}}}],["v2/org/{org}/nico/instance/type/{instancetypeid",{"_index":439,"title":{},"description":{"112":{},"113":{},"114":{}}}],["v2/org/{org}/nico/instance/type/{instancetypeid}/machin",{"_index":441,"title":{},"description":{"115":{},"116":{}}}],["v2/org/{org}/nico/instance/type/{instancetypeid}/machine/{machineassociationid",{"_index":455,"title":{},"description":{"117":{}}}],["v2/org/{org}/nico/instance/{instanceid",{"_index":491,"title":{},"description":{"122":{},"123":{},"124":{}}}],["v2/org/{org}/nico/instance/{instanceid}/infiniband-interfac",{"_index":494,"title":{},"description":{"127":{}}}],["v2/org/{org}/nico/instance/{instanceid}/interfac",{"_index":493,"title":{},"description":{"126":{}}}],["v2/org/{org}/nico/instance/{instanceid}/nvlink-interfac",{"_index":495,"title":{},"description":{"128":{}}}],["v2/org/{org}/nico/instance/{instanceid}/status-histori",{"_index":492,"title":{},"description":{"125":{}}}],["v2/org/{org}/nico/ipblock",{"_index":614,"title":{},"description":{"169":{},"170":{}}}],["v2/org/{org}/nico/ipblock/{ipblockid",{"_index":616,"title":{},"description":{"171":{},"172":{},"173":{}}}],["v2/org/{org}/nico/ipblock/{ipblockid}/deriv",{"_index":621,"title":{},"description":{"174":{}}}],["v2/org/{org}/nico/machin",{"_index":497,"title":{},"description":{"130":{}}}],["v2/org/{org}/nico/machine-cap",{"_index":522,"title":{},"description":{"138":{}}}],["v2/org/{org}/nico/machine/gpu/stat",{"_index":510,"title":{},"description":{"135":{}}}],["v2/org/{org}/nico/machine/instance-type/stat",{"_index":520,"title":{},"description":{"137":{}}}],["v2/org/{org}/nico/machine/instance-type/stats/summari",{"_index":516,"title":{},"description":{"136":{}}}],["v2/org/{org}/nico/machine/{machineid",{"_index":499,"title":{},"description":{"131":{},"132":{},"133":{}}}],["v2/org/{org}/nico/machine/{machineid}/status-histori",{"_index":508,"title":{},"description":{"134":{}}}],["v2/org/{org}/nico/metadata",{"_index":652,"title":{},"description":{"201":{}}}],["v2/org/{org}/nico/network-security-group",{"_index":604,"title":{},"description":{"163":{},"164":{}}}],["v2/org/{org}/nico/network-security-group/{networksecuritygroupid",{"_index":605,"title":{},"description":{"165":{},"166":{},"167":{}}}],["v2/org/{org}/nico/nvlink-interfac",{"_index":422,"title":{},"description":{"102":{}}}],["v2/org/{org}/nico/nvlink-logical-partit",{"_index":420,"title":{},"description":{"97":{},"98":{}}}],["v2/org/{org}/nico/nvlink-logical-partition/{nvlinklogicalpartitionid",{"_index":421,"title":{},"description":{"99":{},"100":{},"101":{}}}],["v2/org/{org}/nico/operating-system",{"_index":424,"title":{},"description":{"104":{},"105":{}}}],["v2/org/{org}/nico/operating-system/{operatingsystemid",{"_index":425,"title":{},"description":{"106":{},"107":{},"108":{}}}],["v2/org/{org}/nico/rack",{"_index":524,"title":{},"description":{"141":{}}}],["v2/org/{org}/nico/rack/bringup",{"_index":558,"title":{},"description":{"149":{}}}],["v2/org/{org}/nico/rack/firmwar",{"_index":554,"title":{},"description":{"147":{}}}],["v2/org/{org}/nico/rack/pow",{"_index":551,"title":{},"description":{"145":{}}}],["v2/org/{org}/nico/rack/task/{id",{"_index":562,"title":{},"description":{"151":{}}}],["v2/org/{org}/nico/rack/task/{id}/cancel",{"_index":579,"title":{},"description":{"152":{}}}],["v2/org/{org}/nico/rack/valid",{"_index":542,"title":{},"description":{"143":{}}}],["v2/org/{org}/nico/rack/{id",{"_index":525,"title":{},"description":{"142":{}}}],["v2/org/{org}/nico/rack/{id}/bringup",{"_index":559,"title":{},"description":{"150":{}}}],["v2/org/{org}/nico/rack/{id}/firmwar",{"_index":555,"title":{},"description":{"148":{}}}],["v2/org/{org}/nico/rack/{id}/pow",{"_index":552,"title":{},"description":{"146":{}}}],["v2/org/{org}/nico/rack/{id}/valid",{"_index":544,"title":{},"description":{"144":{}}}],["v2/org/{org}/nico/service-account/curr",{"_index":158,"title":{},"description":{"2":{}}}],["v2/org/{org}/nico/sit",{"_index":237,"title":{},"description":{"17":{},"18":{}}}],["v2/org/{org}/nico/site/{siteid",{"_index":242,"title":{},"description":{"19":{},"20":{},"21":{}}}],["v2/org/{org}/nico/site/{siteid}/status-histori",{"_index":246,"title":{},"description":{"22":{}}}],["v2/org/{org}/nico/sku",{"_index":388,"title":{},"description":{"87":{}}}],["v2/org/{org}/nico/sku/{skuid",{"_index":390,"title":{},"description":{"88":{}}}],["v2/org/{org}/nico/sshkey",{"_index":640,"title":{},"description":{"190":{},"191":{}}}],["v2/org/{org}/nico/sshkey/{sshkeyid",{"_index":641,"title":{},"description":{"192":{},"193":{},"194":{}}}],["v2/org/{org}/nico/sshkeygroup",{"_index":634,"title":{},"description":{"184":{},"185":{}}}],["v2/org/{org}/nico/sshkeygroup/{sshkeygroupid",{"_index":635,"title":{},"description":{"186":{},"187":{},"188":{}}}],["v2/org/{org}/nico/subnet",{"_index":303,"title":{},"description":{"53":{},"54":{}}}],["v2/org/{org}/nico/subnet/{subnetid",{"_index":307,"title":{},"description":{"55":{},"56":{},"57":{}}}],["v2/org/{org}/nico/tenant/account",{"_index":208,"title":{},"description":{"11":{},"12":{}}}],["v2/org/{org}/nico/tenant/account/{accountid",{"_index":216,"title":{},"description":{"13":{},"14":{},"15":{}}}],["v2/org/{org}/nico/tenant/curr",{"_index":191,"title":{},"description":{"7":{}}}],["v2/org/{org}/nico/tenant/current/stat",{"_index":192,"title":{},"description":{"8":{}}}],["v2/org/{org}/nico/tenant/instance-type/stat",{"_index":196,"title":{},"description":{"9":{}}}],["v2/org/{org}/nico/tray",{"_index":590,"title":{},"description":{"154":{}}}],["v2/org/{org}/nico/tray/firmwar",{"_index":599,"title":{},"description":{"160":{}}}],["v2/org/{org}/nico/tray/pow",{"_index":597,"title":{},"description":{"158":{}}}],["v2/org/{org}/nico/tray/valid",{"_index":594,"title":{},"description":{"156":{}}}],["v2/org/{org}/nico/tray/{id",{"_index":591,"title":{},"description":{"155":{}}}],["v2/org/{org}/nico/tray/{id}/firmwar",{"_index":600,"title":{},"description":{"161":{}}}],["v2/org/{org}/nico/tray/{id}/pow",{"_index":598,"title":{},"description":{"159":{}}}],["v2/org/{org}/nico/tray/{id}/valid",{"_index":595,"title":{},"description":{"157":{}}}],["v2/org/{org}/nico/user/curr",{"_index":644,"title":{},"description":{"196":{}}}],["v2/org/{org}/nico/vpc",{"_index":278,"title":{},"description":{"35":{},"36":{}}}],["v2/org/{org}/nico/vpc-p",{"_index":289,"title":{},"description":{"42":{},"43":{}}}],["v2/org/{org}/nico/vpc-peering/{id",{"_index":295,"title":{},"description":{"44":{},"45":{}}}],["v2/org/{org}/nico/vpc-prefix",{"_index":297,"title":{},"description":{"47":{},"48":{}}}],["v2/org/{org}/nico/vpc-prefix/{vpcprefixid",{"_index":298,"title":{},"description":{"49":{},"50":{},"51":{}}}],["v2/org/{org}/nico/vpc/{vpcid",{"_index":279,"title":{},"description":{"37":{},"38":{},"39":{}}}],["v2/org/{org}/nico/vpc/{vpcid}/virtu",{"_index":283,"title":{},"description":{"40":{}}}],["valid",{"_index":526,"title":{"143":{},"144":{},"156":{},"157":{}},"description":{"143":{},"144":{},"156":{},"157":{}}}],["valu",{"_index":207,"title":{},"description":{"11":{},"13":{},"25":{},"75":{},"105":{}}}],["variou",{"_index":98,"title":{},"description":{"0":{},"194":{},"200":{}}}],["version",{"_index":28,"title":{"181":{},"182":{}},"description":{"0":{},"17":{},"169":{},"179":{},"180":{},"181":{},"182":{},"202":{}}}],["via",{"_index":157,"title":{},"description":{"2":{},"72":{},"73":{},"170":{},"172":{},"173":{}}}],["view",{"_index":214,"title":{},"description":{"12":{}}}],["virtual",{"_index":280,"title":{"40":{}},"description":{"40":{}}}],["vpc",{"_index":112,"title":{"34":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"41":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"48":{},"49":{},"50":{},"51":{}},"description":{"0":{},"34":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"41":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"48":{},"49":{},"50":{},"51":{},"118":{}}}],["vs",{"_index":512,"title":{},"description":{"136":{},"143":{},"144":{},"154":{},"156":{},"157":{},"158":{},"160":{}}}],["wait",{"_index":569,"title":{},"description":{"152":{}}}],["well-known",{"_index":343,"title":{},"description":{"72":{},"73":{}}}],["whose",{"_index":218,"title":{},"description":{"14":{}}}],["within",{"_index":356,"title":{},"description":{"73":{},"75":{},"121":{},"153":{}}}],["without",{"_index":576,"title":{},"description":{"152":{}}}],["worker",{"_index":486,"title":{},"description":{"121":{}}}],["worker-abc123",{"_index":488,"title":{},"description":{"121":{}}}],["worker-def456",{"_index":489,"title":{},"description":{"121":{}}}],["workflow",{"_index":574,"title":{},"description":{"152":{}}}]],"pipeline":[]}},"options":{"expandResponses":"200,201","schemasExpansionLevel":2}};
+      const __redoc_state = {"menu":{"activeItemIdx":-1},"spec":{"data":{"openapi":"3.1.0","info":{"title":"NVIDIA Infra Controller REST API","version":"1.5.0","summary":"NVIDIA Infra Controller REST API is the centralized RESTful gateway to access NVIDIA Infra Controller service","description":"NVIDIA Infra Controller REST API allows users to create and manage resources e.g. VPC, Subnets, Instances across all connected NVIDIA Infra Controller datacenters, also referred to as Sites.","license":{"name":"Apache-2.0","url":"https://www.apache.org/licenses/LICENSE-2.0"},"contact":{"name":"NVIDIA Infra Controller Dev Team"}},"servers":[{"url":"https://nico-rest-api.nico.svc.cluster.local","description":"Kubernetes Cluster"}],"tags":[{"name":"Getting Started","description":"This section provides a quick overview of the API and how to get started.\n\n### Authentication\nThe first step is to authenticate using a JWT bearer token. Organization structures and roles depend on the authentication configuration used. For details on authentication, please consult the\nNICo REST `auth` module [README](https://github.com/NVIDIA/infra-controller-rest/tree/main/auth).\n\n### API Version\nThe next step is to be aware of the API version being used. The API version can be retrieved by calling the [Retrieve Metadata endpoint](#tag/Metadata/operation/get-metadata). In general, the API maintains backward\ncompatibility with the previous versions. Any breaking changes are announced using a deprecation notice. Current and past deprecations are listed in the [Deprecations](#tag/Deprecations) section.\n\n### Service Account Mode\nDepending on the auth configuration used, the NICo REST API may be configured in Service Account mode. In this mode, API users can act as both Provider and Tenant as part of the same organization.\nIf this is the case, the user must first retrieve the Service Account by making a call to the [Retrieve Service Account endpoint](#tag/Service-Account/operation/get-current-service-account).\nFor service accounts, the Tenant entity is initialized as a privileged Tenant with `targetedInstanceCreation` capability enabled.\n\n### Provider or Tenant Mode\nIf NICo REST API is not configured in Service Account mode, the user should retrieve the Infrastructure Provider by making a call to the [Retrieve Infrastructure Provider endpoint](#tag/Infrastructure-Provider/operation/get-current-infrastructure-provider)\nor the Tenant by making a call to the [Retrieve Tenant endpoint](#tag/Tenant/operation/get-current-tenant).\n\nIn both cases, these calls initialize Provider and Tenant entities for the organization. All resources created are anchored to either the Provider or Tenant entity.\n\nOnce the Provider and the Tenant are initialized, the user can create resources by making calls to the appropriate endpoints.\n\n### Creating Site Level IP Blocks\nTo utilize a NICo Site, the Provider or Service Account holder must create IP Blocks for each network overlay defined in NICo Core [Site configuration toml file](https://github.com/NVIDIA/infra-controller-core/blob/v0.5.8/deploy/files/nico-api/nico-api-site-config.toml#L30).\n\nTo create an IP Block, the user must make a call to the [Create IP Block endpoint](#tag/IP-Block/operation/create-ipblock).\n\n> **Note:** From this point onwards, a brief outline is provided for the typical API call flows for various use cases.\n\n### Typical API Call Flow for Service Account\n\n- Retrieve available Sites using the [Retrieve All Sites endpoint](#tag/Site/operation/get-all-site) and choose a Site to create resources in. For _Disconnected_ NICo installations where NICo\nREST is deployed alongside NICo Core, typically there will be a single Site available.\n- For each Site IP Block, create a Network Allocation for the Tenant entity using the [Create Allocation endpoint](#tag/Allocation/operation/create-allocation) using the full prefix length.\nThis will create a Tenant IP Block for each Site IP Block.\n  - Creating an Allocation will create the Tenant in NICo Core.\n- Create a VPC using the [Create VPC endpoint](#tag/VPC/operation/create-vpc).\n- Create a VPC Prefix or Subnet referencing the VPC and a Tenant IP Block\n  - If the Site supports Native Networking (FNN), create a VPC Prefix using the [Create VPC Prefix endpoint](#tag/VPC-Prefix/operation/create-vpc-prefix). Otherwise the user should create a Subnet\n  using the [Create Subnet endpoint](#tag/Subnet/operation/create-subnet).\n- Create an Operating System using the [Create Operating System endpoint](#tag/Operating-System/operation/create-operating-system) specifying iPXE script and user data.\n- Retrieve available Machines on Site using the [Retrieve All Machines endpoint](#tag/Machine/operation/get-all-machine)\n- Create an Instance specifying the VPC, VPC Prefix or Subnet, Operating System, and Machine\n\n### Typical API Call Flow for Provider\n\n- Create a Tenant Account using the [Create Tenant Account endpoint](#tag/Tenant-Account/operation/create-tenant-account). Provider must know the Tenant org name.\n- Once the Tenant has accepted the Tenant Account, the Provider can allocate resources to the Tenant.\n- Retrieve available Sites using the [Retrieve All Sites endpoint](#tag/Site/operation/get-all-site) and choose a Site to create resources in.\n- Create an Instance Type using the [Create Instance Type endpoint](#tag/Instance-Type/operation/create-instance-type)\n- Retrieve available Machines on Site using the [Retrieve All Machines endpoint](#tag/Machine/operation/get-all-machine)\n- Update a Machine's Instance Type using the [Update Machine endpoint](#tag/Machine/operation/update-machine) or assign multiple Machines to an Instance Type using the\n[Create Instance Type/Machine Association endpoint](#tag/Instance-Type/operation/create-instance-type-machine-association)\n- Create a Compute Allocation for Tenant using the [Create Compute Allocation endpoint](#tag/Allocation/operation/create-allocation) referencing the Instance Type\n  - Creating any type of Allocation for a Tenant will create the Tenant in NICo Core.\n- Create a Network Allocation for Tenant using the [Create Allocation endpoint](#tag/Allocation/operation/create-allocation) referencing a Site IP Block\n  - Creating a Network Allocation will create a Tenant IP Block\n\n### Typical API Call Flow for Tenant\n\n- Accept the Tenant Account using the [Update Tenant Account endpoint](#tag/Tenant-Account/operation/update-tenant-account).\n- Retrieve available Sites using the [Retrieve All Sites endpoint](#tag/Site/operation/get-all-site) and choose a Site to create resources in. Any Site where the Tenant\nhas an Allocation will be returned.\n- Create a VPC using the [Create VPC endpoint](#tag/VPC/operation/create-vpc).\n- Retrieve available Site IP Blocks using the [Retrieve All IP Blocks endpoint](#tag/IP-Block/operation/get-all-ipblock). Any IP Block for which the Tenant has received\na Network Allocation from the Provider will be returned.\n- Create a VPC Prefix or Subnet referencing the VPC and a Tenant IP Block\n  - Site supports Native Networking (FNN), create a VPC Prefix using the [Create VPC Prefix endpoint](#tag/VPC-Prefix/operation/create-vpc-prefix)\n  - Otherwise the user should create a Subnet using the [Create Subnet endpoint](#tag/Subnet/operation/create-subnet)\n- Create an Operating System using the [Create Operating System endpoint](#tag/Operating-System/operation/create-operating-system) specifying iPXE script and user data.\n- Retrieve available Instance Types using the [Retrieve All Instance Types endpoint](#tag/Instance-Type/operation/get-all-instance-type). Any Instance Type for which\nthe Tenant has received a Compute Allocation from the Provider will be returned.\n- Create an Instance specifying the VPC, VPC Prefix or Subnet, Operating System, and Instance Type"},{"name":"Service Account","description":"When API service is configured in Service Account mode, API users can act as both Provider and Tenant. For service accounts, the Tenant entity is initialized as a\nprivileged Tenant with `targetedInstanceCreation` capability enabled."},{"name":"Infrastructure Provider","description":"Infrastructure Provider is the anchor entity for an organization that owns and manages Site resources.\n\nDeprecation history:\n\n- `name` attribute was deprecated and was removed on August 17th, 2023 0:00 UTC. Please use `orgDisplayName` instead.\n- `POST /org/:orgName/nico/infrastructure-provider` endpoint was deprecated and was removed on August 17th, 2023 0:00 UTC. Infrastructure Providers are automatically created when retrieved by a Provider Admin.\n- `PATCH /org/:orgName/nico/infrastructure-provider/current` endpoint was deprecated and was removed on August 17th, 2023 0:00 UTC. Infrastructure Provider details are populated from Org information and cannot be updated by the user."},{"name":"Tenant","description":"Tenant is the anchor entity for an organization that consumes Network and Compute resources on a Site.\n\nDeprecation history:\n\n- `name` attribute was deprecated and was removed on August 17th, 2023. Please use `orgDisplayName` instead.\n- `enableSSHAccess` attribute was deprecated and was removed on August 17th, 2023 0:00 UTC. Please use 'isSerialConsoleSSHKeysEnabled' attribute of Site instead.\n- `POST /org/:orgName/nico/tenant` endpoint was deprecated and was removed on August 17th, 2023 0:00 UTC. Tenants are automatically created when retrieved by a Tenant Admin.\n- `PATCH /org/:orgName/nico/tenant/current` endpoint was deprecated and was removed on August 17th, 2023 0:00 UTC. Tenant details are populated from Org information and cannot be updated by the user."},{"name":"Tenant Account","description":"Tenant Account connects a Tenant with an Infrastructure Provider. It represents/contains any information pertaining to their relationship."},{"name":"Site","description":"Site is a datacenter that contains physical hardware and networking resources. All resources created by Provider or Tenant are directly or indirectly anchored to the Site object.\n\nDeprecation history:\n\n- `rackLevelAdministration` capability attribute was deprecated in favor of `flow` and was removed on May 13th, 2026 0:00 UTC. Please use `flow` instead.\n- `isRackLevelAdministrationEnabled` query parameter was deprecated in favor of `isFlowEnabled` and was removed on May 13th, 2026 0:00 UTC. Please use `isFlowEnabled` instead."},{"name":"Allocation","description":"Allocations are the mechanism by which Provider can delegate Network and Compute resources to Tenant."},{"name":"VPC","description":"VPC defines the networking isolation boundary for Tenant's Instances."},{"name":"VPC Peering","description":"VPC Peering allows Instances in one VPC to communicate with Instances in another VPC on the same Site."},{"name":"VPC Prefix","description":"VPC Prefix is a network prefix belonging to an IP Block allocated to a Tenant. Tenant can use VPC Prefixes to enable network connectivity between their Instances.\n\nOnly Sites that support Native Networking (FNN) offer VPC Prefix management."},{"name":"Subnet","description":"Subnet is a network prefix belonging to an IP Block allocated to a Tenant. Tenant can use Subnets to enable network connectivity between their Instances.\n\nSubnets are used on Sites that do not support Native Networking (FNN).\n\nDeprecation history:\n\n- `ipBlockSize` was deprecated in favor of `prefixLength` and was removed on April 15th, 2023 0:00 UTC. Please use `prefixLength` instead."},{"name":"Expected Machine","description":"Expected Machine identifies a Machine that is expected to be discovered at a Site. Infrastructure Providers can pre-register Expected Machines using BMC credentials\nand serial numbers to help with Machine discovery and ingestion."},{"name":"Expected Power Shelf","description":"Expected Power Shelf identifies a Power Shelf that is expected to be discovered at a Site. Infrastructure Providers can pre-register Expected Power Shelves using BMC\ncredentials and serial numbers to help with Power Shelf discovery and ingestion."},{"name":"Expected Rack","description":"Expected Rack identifies a Rack that is expected to be discovered at a Site. Infrastructure Providers can pre-register Expected Racks with an operator-supplied\nrack identifier and a Rack Profile reference to help with Rack discovery and ingestion. Chassis identity and physical location information are conveyed via\nwell-known label keys (`chassis.manufacturer`, `chassis.serial-number`, `chassis.model`, `location.region`, `location.datacenter`, `location.room`, `location.position`)."},{"name":"Expected Switch","description":"Expected Switch identifies a Switch that is expected to be discovered at a Site. Infrastructure Providers can pre-register Expected Switches using BMC, NvOS credentials\nand serial numbers to help with Switch discovery and ingestion."},{"name":"SKU","description":"SKU (Stock Keeping Unit) defines one or more hardware configurations or Machine Bill of Materials (BOM).\n\nSKUs are automatically derived from machine hardware characteristics and used to group similar machines. SKUs are read-only and managed by the system."},{"name":"InfiniBand Partition","description":"InfiniBand (IB) is a high-performance, low-latency networking standard designed for interconnecting servers and storage in HPC (High-Performance Computing) and AI systems,\nutilizing RDMA (Remote Direct Memory Access) to reduce CPU overhead. InfiniBand Partitions are used to group Machines into logical partitions for network isolation and load distribution."},{"name":"NVLink Logical Partition","description":"NVLink Logical Partitions are used to group GPUs into logical partitions for shared memory and low-latency direct communication between GPUs."},{"name":"Operating System","description":"Operating Systems in NICo are typically iPXE scripts that are used to boot Machines."},{"name":"Instance Type","description":"Instance Types allow grouping Machines into a pool defined by their capabilities. Providers can then allocate a portion of the Instance Type pool to a Tenant.\n\nDeprecation history:\n\n- `includeMachineAssociation` was deprecated in favor of `includeMachineAssignment` and was removed on July 26th, 2023 0:00 UTC. Please use `includeMachineAssignment` instead.\n- `displayName` attribute was deprecated and removed on October 30, 2024 0:00 UTC. Please update your usage accordingly."},{"name":"Instance","description":"Instance is a Machine provisioned with an Operating System by a Tenant and attached to one or more VPC Prefixes or Subnets.\n\nDeprecation history:\n\n- `sshUrl` was deprecated in favor of `serialConsoleUrl` and was removed on April 25th, 2023 0:00 UTC. Please use `serialConsoleUrl` instead.\n- `instanceSubnets` was deprecated in favor of `interfaces` and was removed on May 10th, 2023 0:00 UTC. Please use `interfaces` instead.\n- `sshkeygroups` was deprecated in favor of `sshKeyGroups` and was removed on September 4th, 2025 0:00 UTC. Please use `sshKeyGroups` instead."},{"name":"Machine","description":"Machine is a physical server that contains CPUs, GPUs, memory, storage, and networking hardware. Machines are the physical building blocks of a Site."},{"name":"Machine Capability","description":"Machine Capability defines the hardware capabilities of a Machine. Machine Capabilities can be used to group Machines into Instance Types."},{"name":"Rack","description":"Rack is a physical enclosure that contains a number of Machines. Racks are the physical building blocks of a Site."},{"name":"Tray","description":"Tray represents a component within a Rack."},{"name":"Network Security Group","description":"Network Security Group is a security policy that controls the traffic flowing between Instances."},{"name":"IP Block","description":"IP Block is a contiguous block of IP addresses defined by a prefix and prefix length.\n\nIt can be used by the Provider to describe the overlay network of a particular Site. Providers can also use Allocations to delegate portions of these IP Blocks to Tenants.\n\nDeprecation history:\n\n- `blockSize` was deprecated in favor of `prefixLength` and was removed on April 15th, 2023 0:00 UTC. Please use `prefixLength` instead."},{"name":"DPU Extension Service","description":"DPU Extension Service allows users to run custom services in the DPUs of their Instances. Currently K8s pods are the only supported service type."},{"name":"SSH Key Group","description":"SSH Key Groups allow grouping several SSH Keys together so they can be synced to Sites and used to access the Serial Console of Instances."},{"name":"SSH Key","description":"SSH Key is a public key that can be used to access the Serial Console of an Instance."},{"name":"User","description":"User is a logical entity that identifies individuals operating on behalf of an organization."},{"name":"Audit","description":"Audit is a record of actions taken by users on the API."},{"name":"Metadata","description":"Metadata describes various system level attributes of the API service."},{"name":"Deprecations","description":"NICo REST API maintains backward compatibility with the previous versions. Any breaking changes are announced using deprecation notices.\n\nEndpoints that have deprecations will be grouped here. Following deprecations are in effect or slated to be effective in future:\n\nInfrastructure Provider:\n- `name` attribute was deprecated and was removed on August 17th, 2023 0:00 UTC. Please use `orgDisplayName` instead.\n- `POST /org/:orgName/nico/infrastructure-provider` endpoint was deprecated and was removed on August 17th, 2023 0:00 UTC. Infrastructure Providers are automatically created when retrieved by a Provider Admin.\n- `PATCH /org/:orgName/nico/infrastructure-provider/current` endpoint was deprecated and was removed on August 17th, 2023 0:00 UTC. Infrastructure Provider details are populated from Org information and cannot be updated by user.\n\nTenant:\n- `name` attribute was deprecated and was removed on August 17th, 2023. Please use `orgDisplayName` instead.\n- `enableSSHAccess` attribute was deprecated and was removed on August 17th, 2023 0:00 UTC. Please use 'isSerialConsoleSSHKeysEnabled' attribute of Site instead.\n- `POST /org/:orgName/nico/tenant` endpoint was deprecated and was removed on August 17th, 2023 0:00 UTC. Tenants are automatically created when retrieved by a Tenant Admin.\n- `PATCH /org/:orgName/nico/tenant/current` endpoint was deprecated and was removed on August 17th, 2023 0:00 UTC. Tenant details are populated from Org information and cannot be updated by user.\n\nInstance Type:\n- `includeMachineAssociation` was deprecated in favor of `includeMachineAssignment` and was removed on July 26th, 2023 0:00 UTC. Please use `includeMachineAssignment` instead.\n- `displayName` attribute was deprecated and removed on October 30, 2024 0:00 UTC. Please update your usage accordingly.\n\nInstance:\n- `sshUrl` was deprecated in favor of `serialConsoleUrl` and was removed on April 25th, 2023 0:00 UTC. Please use `serialConsoleUrl` instead.\n- `instanceSubnets` was deprecated in favor of `interfaces` and was removed on May 10th, 2023 0:00 UTC. Please use `interfaces` instead.\n- `sshkeygroups` was deprecated in favor of `sshKeyGroups` and was removed on September 4th, 2025 0:00 UTC. Please use `sshKeyGroups` instead.\n\nIP Block:\n- `blockSize` was deprecated in favor of `prefixLength` and was removed on April 15th, 2023 0:00 UTC. Please use `prefixLength` instead.\n\nSubnet:\n- `ipBlockSize` was deprecated in favor of `prefixLength` and was removed on April 15th, 2023 0:00 UTC. Please use `prefixLength` instead.\n\nSite:\n- `rackLevelAdministration` capability attribute was deprecated in favor of `flow` and was removed on May 13th, 2026 0:00 UTC. Please use `flow` instead.\n- `isRackLevelAdministrationEnabled` query parameter was deprecated in favor of `isFlowEnabled` and was removed on May 13th, 2026 0:00 UTC. Please use `isFlowEnabled` instead."}],"paths":{"/v2/org/{org}/nico/service-account/current":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve Service Account status for current org","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceAccount"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-current-service-account","description":"Retrieve Service Account status for current org\n\nAPI service must be configured for Service Account access at the time of deployment. It cannot be enabled or disabled via API.","parameters":[],"tags":["Service Account"]}},"/v2/org/{org}/nico/infrastructure-provider/current":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve Infrastructure Provider for current Org","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfrastructureProvider"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","org":"rf43bbtnb9c5","orgDisplayName":"Dell Corporation","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-current-infrastructure-provider","description":"Retrieve Infrastructure Provider entity for current Org.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[],"tags":["Infrastructure Provider"]}},"/v2/org/{org}/nico/infrastructure-provider/current/stats":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve Stats for current Infrastructure Provider","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfrastructureProviderStats"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-current-infrastructure-provider-stats","description":"Retrieve stats for current Infrastructure Provider.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[],"tags":["Infrastructure Provider"]}},"/v2/org/{org}/nico/tenant/current":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve Tenant for current Org","tags":["Tenant"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tenant"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","org":"qygdmg8oqik8","orgDisplayName":"Echo Corporation","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z","capabilities":{"targetedInstanceCreation":false}}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-current-tenant","description":"Retrieve Tenant entity for current Org.\n\nUser must have authorization role with `TENANT_ADMIN` suffix.","parameters":[]}},"/v2/org/{org}/nico/tenant/current/stats":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve Stats for current Tenant","tags":["Tenant"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantStats"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-current-tenant-stats","description":"Retrieve stats for current Tenant.\n\nUser must have authorization role with `TENANT_ADMIN` suffix.","parameters":[]}},"/v2/org/{org}/nico/tenant/account":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Tenant Accounts","tags":["Tenant Account"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TenantAccount"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","infrastructureProviderOrg":"xskkpgqpeakn","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","tenantOrg":"rf43bbtnb9c5","tenantContact":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","email":"janed@nvidia.com","firstName":"Jane","lastName":"Doe","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},"allocationCount":0,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-tenant-account","description":"Retrieve all Tenant Accounts.\n\nEither `infrastructureProviderId` or `tenantId` query param must be specified.\n\nIf `infrastructureProviderId` query param is provided, then org must have an Infrastructure Provider entity and its ID should match the query param value. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nIf `tenantId` query param is provided, then org must have a Tenant entity and its ID should match the query param value. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","description":"Filter TenantAccounts by Infrastructure Provider ID"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","description":"Filter TenantAccounts by Tenant ID"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search string to filter Tenant Accounts by account number, tenant org, or tenant org display name"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC","ACCOUNT_NUMBER_ASC","ACCOUNT_NUMBER_DESC","TENANT_ORG_NAME_ASC","TENANT_ORG_NAME_DESC","TENANT_ORG_DISPLAY_NAME_ASC","TENANT_ORG_DISPLAY_NAME_DESC","TENANT_CONTACT_EMAIL_ASC","TENANT_CONTACT_EMAIL_DESC","TENANT_CONTACT_FULL_NAME_ASC","TENANT_CONTACT_FULL_NAME_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create Tenant Account","operationId":"create-tenant-account","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantAccount"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","infrastructureProviderOrg":"xskkpgqpeakn","tenantId":null,"tenantOrg":"rf43bbtnb9c5","tenantContact":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","email":"janed@nvidia.com","firstName":"Jane","lastName":"Doe","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},"allocationCount":0,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create a Tenant Account.\n\nOrg must have an Infrastructure Provider entity and its ID must match the Infrastructure Provider ID in request data. User must have authorization role with `PROVIDER_ADMIN` suffix\n\nInfrastructure Provider can create a Tenant Account by specifying the Tenant's UUID or Tenant's org name. This will set the status of the Tenant Account to \"Invited\". Then the Tenant can view this account information and are able to confirm/accept the account by updating the Tenant Account.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantAccountCreateRequest"},"examples":{"example-1":{"value":{"infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantOrg":"rf43bbtnb9c5"}}}}}},"tags":["Tenant Account"]}},"/v2/org/{org}/nico/tenant/account/{accountId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"accountId","in":"path","required":true,"description":"ID of the Tenant Account"}],"get":{"summary":"Retrieve Tenant Account","tags":["Tenant Account"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantAccount"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","infrastructureProviderOrg":"xskkpgqpeakn","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","tenantOrg":"rf43bbtnb9c5","tenantContact":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","email":"janed@nvidia.com","firstName":"Jane","lastName":"Doe","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},"allocationCount":2,"status":"Ready","statusHistory":[{"status":"Ready","message":"Account ready, Tenant accepted invite","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"status":"Invited","message":"Request received, pending Tenant acceptance","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-tenant-account","description":"Retrieve a Tenant Account by ID\n\nEither `infrastructureProviderId` or `tenantId` query param must be specified.\n\nIf `infrastructureProviderId` query param is provided, then org must have an Infrastructure Provider entity and its ID should match the query param value. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nIf `tenantId` query param is provided, then org must have a Tenant entity and its ID should match the query param value. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","description":"Filter Tenant Accounts by Infrastructure Provider ID"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","description":"Filter Tenant Accounts by Tenant ID"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"patch":{"summary":"Update Tenant Account","operationId":"update-tenant-account","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantAccount"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","infrastructureProviderOrg":"xskkpgqpeakn","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","tenantOrg":"rf43bbtnb9c5","tenantContact":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","email":"janed@nvidia.com","firstName":"Jane","lastName":"Doe","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},"allocationCount":0,"status":"Ready","statusHistory":[{"status":"Ready","message":"Account ready, Tenant accepted invite","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"status":"Invited","message":"Request received, pending Tenant acceptance","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Tenant Account"],"description":"Update a Tenant Account.\n\nCan be used to accept an invitation sent by Infrastructure Provider.\n\nOrg must have a tenant entity whose ID matches the `tenantId` of the Tenant Account object. User must have authorization role with `TENANT_ADMIN` suffix. Can only update a TenantAccount that has `Invited` status.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantAccountUpdateRequest"},"examples":{"example-1":{"value":{}}}}},"description":"No params needed, an empty request body will suffice."}},"delete":{"summary":"Delete Tenant Account","operationId":"delete-tenant-account","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a Tenant Account by ID.\n\nOrg must have an Infrastructure Provider entity, specified Tenant Account must be created by said Provider. Requesting user must have `PROVIDER_ADMIN` role.\n\nTenant cannot delete a Tenant Account.","tags":["Tenant Account"]}},"/v2/org/{org}/nico/site":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Sites","tags":["Site"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Site"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-site","description":"Retrieve all Sites for org.\n\nUser must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix. `infrastructureProviderId` or `tenantId` query param may be required for older API versions.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","description":"Filter Sites by Infrastructure Provider ID"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","description":"Filter Sites by Tenant ID"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Sites by Status. Can be specified multiple times to filter on more than one status"},{"schema":{"type":"boolean"},"in":"query","name":"isNativeNetworkingEnabled","description":"Filter Sites by native networking enabled flag. Requires Provider Admin role."},{"schema":{"type":"boolean"},"in":"query","name":"isNetworkSecurityGroupEnabled","description":"Filter Sites by network security group enabled flag. Requires Provider Admin role."},{"schema":{"type":"boolean"},"in":"query","name":"isNVLinkPartitionEnabled","description":"Filter Sites by NVLink partitioning enabled flag. Requires Provider Admin role."},{"schema":{"type":"boolean"},"in":"query","name":"isFlowEnabled","description":"Filter Sites by NICo Flow enabled flag. Requires Provider Admin role."},{"schema":{"type":"boolean"},"in":"query","name":"includeMachineStats","description":"Include a breakdown of Machine counts by life-cycle status and health. Requires Provider Admin role."},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description, location, contact, and status fields"},{"schema":{"type":"string","enum":["InfrastructureProvider"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC","DESCRIPTION_ASC","DESCRIPTION_DESC","LOCATION_ASC","LOCATION_DESC","CONTACT_ASC","CONTACT_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create Site","operationId":"create-site","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Site"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create a Site for the org.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nTenants cannot create Sites.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteCreateRequest"},"examples":{"example-1":{"value":{"name":"San Jose Central 4","description":"Datacenter serving San Jose central region","location":{"city":"San Jose","state":"CA","country":"USA"},"contact":{"email":"johndoe@nvidia.com"}}}}}}},"tags":["Site"]}},"/v2/org/{org}/nico/site/{siteId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"path","required":true,"description":"ID of the Site"}],"get":{"summary":"Retrieve Site","tags":["Site"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Site"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-site","description":"Retrieve a specific Site by ID.\n\nUser must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix.\n\nAccess is granted if:\n- The Site is owned by the org's Infrastructure Provider\n- The org's Tenant has an Allocation for Site\n- The org's Tenant is privileged and has Account with Site's Provider","parameters":[]},"patch":{"summary":"Update Site","operationId":"update-site","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Site"}}}}},"tags":["Site"],"description":"Update a specific Site\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix.\n\nInfrastructure Provider updating the Site must be the owner of the Site. At present, there are no other Site specific configurations modifiable by Tenant.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteUpdateRequest"},"examples":{"example-1":{"value":{"name":"San Jose Central No.4","description":"Datacenter 4 serving central San Jose","renewRegistrationToken":true,"serialConsoleHostname":"sol.nico.acme.com","location":{"city":"San Jose","state":"CA","country":"USA"},"contact":{"email":"johndoe@nvidia.com"}}},"example-2":{"value":{"isSerialConsoleSSHKeysEnabled":true,"contact":{"email":"janedoe@nvidia.com"}}}}}}}},"delete":{"summary":"Delete Site","operationId":"delete-site","responses":{"202":{"description":"Deletion request was accepted"}},"tags":["Site"],"description":"Delete a specific Site\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nSite can only be deleted if all Allocations have been deleted.","parameters":[{"schema":{"type":"boolean"},"in":"query","name":"purgeMachines","description":"Scrub all Machine data associated with this Site to re-pair"}]}},"/v2/org/{org}/nico/site/{siteId}/status-history":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"path","required":true,"description":"ID of the Site"}],"get":{"summary":"Retrieve Site status history","tags":["Site"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"examples":{"Example 1":{"value":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-site-status-history","description":"Retrieve a specific Site status history\n\nUser must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix.\n\nAccess is granted if:\n- The Site is owned by the org's Infrastructure Provider\n- The org's Tenant has an Allocation for Site\n- The org's Tenant is privileged and has Account with Site's Provider","parameters":[{"schema":{"type":"integer"},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer"},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string"},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/allocation":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Allocations","tags":["Allocation"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Allocation"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Echo Studios","description":"Echo Studios resource allocation in SJC4","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z","allocationConstraints":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"instanceType":{"name":"x3.large","infrastructureProviderId":"63c29416-8833-4eaf-9e1c-7c0173cc3150","siteId":"c9f4f276-6f7a-4209-953c-2b9870ce7cc1","status":"Ready"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-allocation","description":"Retrieve all Allocations for the org.\n\nProvider and Tenant roles are inferred from the org's membership. User must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix.\n\nResults are returned from both Provider and Tenant perspectives when the org has both roles.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","deprecated":true,"description":"Filter Allocations by Infrastructure Provider ID."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","description":"Filter Allocations by Tenant ID."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter Allocations by Site ID.  Can be specified multiple times to filter on more than one Site ID."},{"schema":{"type":"string"},"in":"query","name":"id","description":"Filter Allocations by ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string","enum":["InstanceType","IPBlock"]},"in":"query","name":"resourceType","description":"Filter Allocations by Constraint Resource Type.  Can be specified multiple times to filter on more than one Constraint Resource Type."},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Allocations by Status.  Can be specified multiple times to filter on more than one Status."},{"schema":{"type":"string"},"in":"query","name":"resourceTypeId","description":"Filter Allocations by Constraint Resource Type ID.  Can be specified multiple times to filter on more than one Constraint Resource Type ID."},{"schema":{"type":"string","enum":["Reserved","OnDemand","Preemptible"]},"in":"query","name":"constraintType","description":"Filter Allocations by Constraint Type.  Can be specified multiple times to filter on more than one Constraint Type."},{"schema":{"type":"integer"},"in":"query","name":"constraintValue","description":"Filter Allocations by Constraint Value.  Can be specified multiple times to filter on more than one Constraint Value."},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description and status fields"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC","SITE_NAME_ASC","SITE_NAME_DESC","TENANT_ORG_DISPLAY_NAME_ASC","TENANT_ORG_DISPLAY_NAME_DESC","INSTANCE_TYPE_NAME_ASC","INSTANCE_TYPE_NAME_DESC","IP_BLOCK_NAME_ASC","IP_BLOCK_NAME_DESC","CONSTRAINT_VALUE_ASC","CONSTRAINT_VALUE_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create Allocation","operationId":"create-allocation","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Allocation"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Echo Studios","description":"Echo Studios resource allocation in SJC4","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z","allocationConstraints":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"bd5a0240-eb62-4bff-91f7-335e6bb86459","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an Allocation for the org.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nTo successfully create a compute Allocation, there must be enough unallocated Machines associated with the Instance Type to satisfy the constraint value.\nFor network Allocation, the source site-level IP Block must have an available prefix with length equal to constraint value.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllocationCreateRequest"},"examples":{"example-1":{"value":{"name":"Echo Studios","description":"Echo Studios resource allocation in SJC4","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","allocationConstraints":[{"resourceType":"InstanceType","resourceTypeId":"bd5a0240-eb62-4bff-91f7-335e6bb86459","constraintType":"Reserved","constraintValue":10}]}}}}}},"tags":["Allocation"]}},"/v2/org/{org}/nico/allocation/{allocationId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"allocationId","in":"path","description":"ID of the Allocation","required":true}],"get":{"summary":"Retrieve Allocation","tags":["Allocation"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Allocation"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Echo Studios","description":"Echo Studios resource allocation in SJC4","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z","allocationConstraints":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"instanceType":{"name":"x3.large","infrastructureProviderId":"63c29416-8833-4eaf-9e1c-7c0173cc3150","siteId":"c9f4f276-6f7a-4209-953c-2b9870ce7cc1","status":"Ready"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-allocation","description":"Retrieve Allocation by ID\n\nProvider and Tenant roles are inferred from the org's membership. Allocation must belong to the Provider or Tenant associated with the org.\n\nUser must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","deprecated":true,"description":"Filter Allocations by Infrastructure Provider ID."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","deprecated":true,"description":"Filter Allocations by Tenant ID."},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"delete":{"summary":"Delete Allocation","operationId":"delete-allocation","responses":{"202":{"description":"Accepted"}},"description":"Delete an Allocation by ID.\n\nOrg must have an Infrastructure Provider entity, specified Allocation must be created by said Provider. Requesting user must have `PROVIDER_ADMIN` role.\n\nTenant management of Allocation is not supported in MVP.","tags":["Allocation"]},"patch":{"summary":"Update Allocation","operationId":"update-allocation","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Allocation"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Echo Studios Compute","description":"Echo Studios compute resource allocation in SJC4","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z","allocationConstraints":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}}}}},"description":"Update an existing Allocation\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix. Provider must own the Allocation.\n\nTenant management of Allocation is not supported in MVP.","tags":["Allocation"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllocationUpdateRequest"},"examples":{"example-1":{"value":{"name":"Echo Studios Compute","description":"Echo Studios compute resource allocation in SJC4"}}}}}}}},"/v2/org/{org}/nico/allocation/{allocationId}/constraint":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"allocationId","in":"path","required":true,"description":"ID of the Allocation"}],"get":{"summary":"Retrieve all Allocation Constraints","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AllocationConstraint"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"instanceType":{"name":"x3.large","infrastructureProviderId":"63c29416-8833-4eaf-9e1c-7c0173cc3150","siteId":"c9f4f276-6f7a-4209-953c-2b9870ce7cc1","status":"Ready"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-allocation-constraint","description":"Retrieve all Allocation Constraints for a given Allocation ID.\n\nIf org has an Infrastructure Provider entity, then specified Allocation must have been created by the Provider and requesting user must have `PROVIDER_ADMIN` role.\n\nIf org does not have an Infrastructure Provider entity but has a Tenant entity, then specified Allocation must belong to the Tenant and requesting user must have `TENANT_ADMIN` role.","parameters":[{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["RESOURCE_TYPE_ASC","RESOURCE_TYPE_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"tags":["Allocation"]},"post":{"summary":"Create Allocation Constraint","operationId":"create-allocation-constraint","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllocationConstraint"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"instanceType":{"name":"x3.large","infrastructureProviderId":"63c29416-8833-4eaf-9e1c-7c0173cc3150","siteId":"c9f4f276-6f7a-4209-953c-2b9870ce7cc1","status":"Ready"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an Allocation Constraint for a given Allocation ID.\n\nOrg must have an Infrastructure Provider entity and specified Allocation must have been created by the Provider. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllocationConstraintCreateRequest"},"examples":{"example-1":{"value":{"resourceType":"InstanceType","resourceTypeId":"bd5a0240-eb62-4bff-91f7-335e6bb86459","constraintType":"Reserved","constraintValue":10}}}}}},"tags":["Allocation"]}},"/v2/org/{org}/nico/allocation/{allocationId}/constraint/{allocationConstraintId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"allocationId","in":"path","required":true,"description":"ID of the Allocation"},{"schema":{"type":"string","format":"uuid"},"name":"allocationConstraintId","in":"path","required":true,"description":"ID of the Allocation Constraint"}],"get":{"summary":"Retrieve Allocation Constraint","tags":["Allocation"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AllocationConstraint"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"instanceType":{"name":"x3.large","infrastructureProviderId":"63c29416-8833-4eaf-9e1c-7c0173cc3150","siteId":"c9f4f276-6f7a-4209-953c-2b9870ce7cc1","status":"Ready"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-allocation-constraint","description":"Retrieve an Allocation Constraint for a given Allocation ID.\n\nIf org has an Infrastructure Provider entity, then specified Allocation must have been created by the Provider and requesting user must have `PROVIDER_ADMIN` role.\n\nIf org does not have an Infrastructure Provider entity but has a Tenant entity, then specified Allocation must belong to the Tenant and requesting user must have `TENANT_ADMIN` role.","parameters":[]},"patch":{"summary":"Update Allocation Constraint","operationId":"update-allocation-constraint","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllocationConstraint"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":20,"derivedResourceId":null,"instanceType":{"name":"x3.large","infrastructureProviderId":"63c29416-8833-4eaf-9e1c-7c0173cc3150","siteId":"c9f4f276-6f7a-4209-953c-2b9870ce7cc1","status":"Ready"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}}},"description":"Update an existing Allocation Constraint by ID\n\nOrg must have an Infrastructure Provider. Specified Allocation must have been created by the Provider and requesting user must have `PROVIDER_ADMIN` role.\n\nModifying allocations may not be possible if Tenant has started utilizing resources from this allocation.\n\nIn case of InstanceType resource, `constraintValue` can be incremented anytime, but not decremented if it requires decommissioning Tenant resources.\n\nIn case of IPBlock resource, `constraintValue` can not be modified if Tenant resources are using IPs from the block.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllocationConstraintUpdateRequest"},"examples":{"example-1":{"value":{"constraintValue":20}}}}}},"tags":["Allocation"]},"delete":{"summary":"Delete Allocation Constraint","operationId":"delete-allocation-constraint","responses":{"202":{"description":"Accepted"}},"description":"Delete an existing Allocation Constraint by ID\n\nOrg must have an Infrastructure Provider. Specified Allocation must have been created by the Provider and requesting user must have `PROVIDER_ADMIN` role.\n","tags":["Allocation"]}},"/v2/org/{org}/nico/ipblock":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all IP Blocks","tags":["IP Block"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/IpBlock"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Public Network Overlay for Site SJC4","description":"This is the primary IP overlay for SJC4. All IPs are publicly routable","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantId":null,"routingType":"Public","prefix":"202.168.1.0","prefixLength":24,"protocolVersion":"IPv4","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-ipblock","description":"Retrieve all IP blocks for the org.\n\nUser must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix. `infrastructureProviderId` or `tenantId` query param may be required for older API versions.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","description":"Filter IP Blocks by Infrastructure Provider ID"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","description":"Filter IP Blocks by Tenant ID"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter IP Blocks by Site ID"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter IP Blocks by Status"},{"schema":{"type":"boolean"},"in":"query","name":"includeUsageStats","description":"Include IP Block usage stats in response"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description and status fields"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","PREFIX_ASC","PREFIX_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create IP Block","operationId":"create-ipblock","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IpBlock"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Public Network Overlay for Site SJC4","description":"This is the primary IP overlay for SJC4. All IPs are publicly routable","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantId":null,"routingType":"Public","prefix":"202.168.1.0","prefixLength":24,"protocolVersion":"IPv4","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an IP block for the org.\n\nOnly Infrastructure Providers can create a root IP Block. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nTenant IP Blocks are created via Allocation.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IpBlockCreateRequest"},"examples":{"example-1":{"value":{"name":"Public Network Overlay for Site SJC4","description":"This is the primary IP overlay for SJC4. All IPs are publicly routable","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","routingType":"Public","prefix":"202.168.1.0","prefixLength":24,"protocolVersion":"IPv4"}}}}}},"tags":["IP Block"]}},"/v2/org/{org}/nico/ipblock/{ipBlockId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"ipBlockId","in":"path","required":true,"description":"ID of the IP Block"}],"get":{"summary":"Retrieve IP Block","tags":["IP Block"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IpBlock"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Public Network Overlay for Site SJC4","description":"This is the primary IP overlay for SJC4. All IPs are publicly routable","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantId":null,"routingType":"Public","prefix":"202.168.16.0","prefixLength":20,"protocolVersion":"IPv4","usageStats":{"availableIPs":256,"acquiredIPs":2,"availablePrefixes":["192.168.201.0/24"],"availableSmallestPrefixes":64,"acquiredPrefixes":0},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-ipblock","description":"Retrieve an IP Block by ID.\n\nUser must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","description":"Filter IP Blocks by Infrastructure Provider ID"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","description":"Filter IP Blocks by Tenant ID"},{"schema":{"type":"boolean"},"in":"query","name":"includeUsageStats","description":"Include IP Block usage stats in response"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"delete":{"summary":"Delete IP Block","operationId":"delete-ipblock","responses":{"202":{"description":"Accepted"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete an IP block\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix. Only root IP Blocks can be deleted if there are no allocations associated with it.\n\nTenant IP Blocks are managed via Allocation.","tags":["IP Block"]},"patch":{"summary":"Update IP Block","operationId":"update-ipblock","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IpBlock"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Public Network Overlay for Site SJC-4","description":"This is the primary IP overlay for SJC-4. All IPs are publicly routable","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantId":null,"routingType":"Public","prefix":"202.168.16.0","prefixLength":20,"protocolVersion":"IPv4","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}}},"description":"Update an existing IP Block\n\nOrg must have an Infrastructure Provider. Specified IP Block must have been created by the Provider and requesting user must have `PROVIDER_ADMIN` role. Only root IP Blocks can be patched.\n\nTenant IP Blocks are managed via Allocation.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IpBlockUpdateRequest"},"examples":{"example-1":{"value":{"name":"Public Network Overlay for Site SJC-4","description":"This is the primary IP overlay for SJC-4. All IPs are publicly routable"}}}}}},"tags":["IP Block"]}},"/v2/org/{org}/nico/ipblock/{ipBlockId}/derived":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"ipBlockId","in":"path","required":true,"description":"ID of the IP Block"}],"get":{"summary":"Retrieve All Derived IP Blocks","tags":["IP Block"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/IpBlock"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Public Network Overlay for Site SJC4","description":"This is the primary IP overlay for SJC4. All IPs are publicly routable","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantId":"97c57510-b443-43b4-881c-974d4b86c87c","routingType":"Public","prefix":"202.168.1.0","prefixLength":24,"protocolVersion":"IPv4","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-derived-ipblock","description":"Retrieve all child IP Blocks allocated to Tenants from a specific Provider super IP Block. When allocations are created from a super block, individual Tenant IP Blocks are created as a result.\n\nThe IP Block in URL must belong to the Infrastructure Provider associated with the Org.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter IP Blocks by Status"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description and status fields"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","PREFIX_ASC","PREFIX_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/vpc":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all VPCs","tags":["VPC"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VPC"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-vpc","description":"Virtual network for machines executing Spark jobs","org":"xskkpgqpeakn","tenantId":"34f5c98e-f430-457b-a812-92637d0c6fd0","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","controllerVpcId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","networkVirtualizationType":"ETHERNET_VIRTUALIZER","requestedVni":12001,"vni":12001,"networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e","networkSecurityGroupPropagationDetails":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","detailedStatus":"Partial","status":"Synchronizing","details":"","unpropagatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"relatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"]},"nvLinkLogicalPartitionId":"dd887330-dbd3-45ce-b400-c42fc8e47315","labels":{"region":"us-west-1","env":"dev"},"status":"Ready","statusHistory":[{"status":"Ready","message":"Vpc has been successfully provisioned on Site","created":"2019-08-24T16:02:00Z","updated":"2019-08-24T16:02:00Z"},{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-vpc","description":"Retrieve all VPCs for the org.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter VPCs by Site ID. Can be specified multiple times to filter on more than one Site."},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter VPCs by Status. Can be specified multiple times to filter on more than one Status."},{"schema":{"type":"string"},"in":"query","name":"networkSecurityGroupId","description":"Filter VPCs by Network Security Group ID. Can be specified multiple times to filter on more than one Network Security Group."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"nvLinkLogicalPartitionId","description":"Filter VPCs by NVLink Logical Partition ID. Can be specified multiple times to filter on more than one NVLink Logical Partition."},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all VPCs. Input will be matched against name, description, labels and status fields"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site","NetworkSecurityGroup"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create VPC","operationId":"create-vpc","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VPC"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-vpc","description":"Virtual network for machines executing Spark jobs","org":"xskkpgqpeakn","tenantId":"34f5c98e-f430-457b-a812-92637d0c6fd0","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","controllerVpcId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","networkVirtualizationType":"ETHERNET_VIRTUALIZER","requestedVni":12001,"vni":12001,"nvLinkLogicalPartitionId":"dd887330-dbd3-45ce-b400-c42fc8e47315","labels":{"region":"us-west-1","env":"dev"},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create a VPC for the org.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcCreateRequest"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-vpc","description":"Virtual network for machines executing Spark jobs","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","networkVirtualizationType":"ETHERNET_VIRTUALIZER","vni":12001,"nvLinkLogicalPartitionId":"dd887330-dbd3-45ce-b400-c42fc8e47315","labels":{"region":"us-west-1","env":"dev"}}}}}},"description":""},"tags":["VPC"]}},"/v2/org/{org}/nico/vpc/{vpcId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"vpcId","in":"path","required":true,"description":"ID of the VPC"}],"get":{"summary":"Retrieve a VPC","tags":["VPC"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VPC"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-vpc","description":"Virtual network for machines executing Spark jobs","org":"xskkpgqpeakn","tenantId":"34f5c98e-f430-457b-a812-92637d0c6fd0","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","controllerVpcId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","networkVirtualizationType":"ETHERNET_VIRTUALIZER","requestedVni":12001,"vni":12001,"nvLinkLogicalPartitionId":"dd887330-dbd3-45ce-b400-c42fc8e47315","labels":{"region":"us-west-1","env":"dev"},"status":"Ready","networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e,","networkSecurityGroupPropagationDetails":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","detailedStatus":"Partial","status":"Synchronizing","details":"","unpropagatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"relatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"]},"statusHistory":[{"status":"Ready","message":"Vpc has been successfully provisioned on Site","created":"2019-08-24T16:02:00Z","updated":"2019-08-24T16:02:00Z"},{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-vpc","description":"Retrieve a specific VPC by ID.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site","NetworkSecurityGroup"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"delete":{"summary":"Delete a VPC","operationId":"delete-vpc","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a specific VPC by ID.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["VPC"]},"patch":{"summary":"Update VPC","operationId":"update-vpc","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VPC"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-vpc-v1","description":"Virtual network for machines executing Spark jobs v1","org":"xskkpgqpeakn","tenantId":"34f5c98e-f430-457b-a812-92637d0c6fd0","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","controllerVpcId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","networkVirtualizationType":"ETHERNET_VIRTUALIZER","requestedVni":12001,"vni":12001,"nvLinkLogicalPartitionId":"dd887330-dbd3-45ce-b400-c42fc8e47315","labels":{"region":"us-west-1","env":"dev"},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["VPC"],"description":"Update an existing VPC\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcUpdateRequest"},"examples":{"example-1":{"value":{"name":"spark-vpc-v1","description":"Virtual network for machines executing Spark jobs v1","labels":{"region":"us-west-1","env":"dev"}}}}}}}}},"/v2/org/{org}/nico/vpc/{vpcId}/virtualization":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"vpcId","in":"path","required":true,"description":"ID of the VPC"}],"patch":{"summary":"Update VPC Virtualization","operationId":"update-vpc-virtualization","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VPC"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-vpc-v1","description":"Virtual network for machines executing Spark jobs v1","org":"xskkpgqpeakn","tenantId":"34f5c98e-f430-457b-a812-92637d0c6fd0","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","controllerVpcId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","networkVirtualizationType":"FNN","requestedVni":12001,"vni":12001,"nvLinkLogicalPartitionId":"dd887330-dbd3-45ce-b400-c42fc8e47315","labels":{"region":"us-west-1","env":"dev"},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["VPC"],"description":"Update network virtualization type for a VPC\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix\n\nTenant must own the VPC\nRequest is rejected if the VPC already has Subnets or Instances","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcVirtualizationUpdateRequest"},"examples":{"Example 1":{"value":{"networkVirtualizationType":"FNN"}}}}}}}},"/v2/org/{org}/nico/vpc-peering":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all VPC peerings","tags":["VPC Peering"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VpcPeering"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-vpc-peering","description":"Get all VPC peerings.\nTenant Admin can get all peerings where the tenant owns at least one VPC.\nProvider Admin can get all peerings in a site.\nUser must have authorization role with `TENANT_ADMIN` or `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","required":false,"description":"Optional Site ID filter. If provided, caller must have access to the specified Site."},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string"},"in":"query","name":"orderBy","description":"Ordering for pagination query"},{"schema":{"type":"boolean"},"in":"query","name":"isMultiTenant","required":false,"description":"Optional filter by peering tenancy type (single-tenant or multi-tenant)."},{"schema":{"type":"string","enum":["Vpc1","Vpc2","Site"]},"in":"query","name":"includeRelation","required":false,"description":"Related entity to expand"}]},"post":{"summary":"Create VPC peering","tags":["VPC Peering"],"operationId":"create-vpc-peering","description":"Create a VPC peering between two VPCs on the same site.\n\nTenant Admin can create single-tenant peerings (both VPCs belong to their tenant).\nProvider Admin can create multi-tenant peerings (VPCs from different tenants).\n\nUser must have authorization role with `TENANT_ADMIN` or `PROVIDER_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcPeeringCreateRequest"},"examples":{"example-1":{"value":{"vpc1Id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","vpc2Id":"34f5c98e-f430-457b-a812-92637d0c6fd0","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811"}}}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcPeering"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}}}},"/v2/org/{org}/nico/vpc-peering/{id}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"VPC Peering ID"}],"get":{"summary":"Retrieve a VPC peering","tags":["VPC Peering"],"operationId":"get-vpc-peering","description":"Get details of a VPC peering by ID.\n\nTenant Admin can get a peering if at least one VPC belongs to their tenant.\nProvider Admin can get a peering if it is in a site provided by their org.\n\nUser must have authorization role with `TENANT_ADMIN` or `PROVIDER_ADMIN` suffix.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcPeering"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"parameters":[{"schema":{"type":"string","enum":["Vpc1","Vpc2","Site"]},"in":"query","name":"includeRelation","required":false,"description":"Related entity to expand"}]},"delete":{"summary":"Delete a VPC peering","tags":["VPC Peering"],"operationId":"delete-vpc-peering","description":"Delete a VPC peering by ID.\n\nTenant Admin can delete only peerings where both VPCs belong to their tenant.\nProvider Admin can delete only multi-tenant peerings in sites they provide.\n\nUser must have authorization role with `TENANT_ADMIN` or `PROVIDER_ADMIN` suffix.","responses":{"204":{"description":"No Content"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}}}},"/v2/org/{org}/nico/vpc-prefix":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all VPC Prefixes","tags":["VPC Prefix"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VpcPrefix"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-vpc-prefix","description":"Retrieve all VPC Prefixes for the org\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter VPC Prefixes by Site, required if vpcId query param is not specified"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"vpcId","description":"Filter VPC Prefixes by VPC"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter VPC Prefixes by Status"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name and status fields"},{"schema":{"type":"string","enum":["VPC","Tenant","IPBlock"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create VPC Prefix","operationId":"create-vpc-prefix","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcPrefix"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create a VPC Prefix for the org.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcPrefixCreateRequest"}}}},"tags":["VPC Prefix"]}},"/v2/org/{org}/nico/vpc-prefix/{vpcPrefixId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"vpcPrefixId","in":"path","required":true,"description":"ID of the VPC Prefix"}],"get":{"summary":"Retrieve VPC Prefix","tags":["VPC Prefix"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcPrefix"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-vpc-prefix","description":"Retrieve a specific VPC Prefix\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","enum":["VPC","Tenant","IPBlock"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"delete":{"summary":"Delete VPC Prefix","operationId":"delete-vpc-prefix","responses":{"204":{"description":"No Content"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a specific VPC Prefix by ID.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["VPC Prefix"]},"patch":{"summary":"Update VPC Prefix","operationId":"update-vpc-prefix","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcPrefix"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["VPC Prefix"],"description":"Update an existing VPC Prefix\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpcPrefixUpdateRequest"}}}}}},"/v2/org/{org}/nico/subnet":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Subnets","tags":["Subnet"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Subnet"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-gpu-net","siteId":"ea144def-d68f-44c3-9485-4b103fa2686f","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerNetworkSegmentId":"abe7b0e8-67db-4e89-903e-fc4f2bd7f034","ipv4Prefix":"202.168.16.0","ipv4BlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","ipv4Gateway":"202.168.0.1","ipv6Prefix":null,"ipv6BlockId":null,"ipv6Gateway":null,"prefixLength":20,"routingType":"Public","status":"Ready","statusHistory":[{"status":"Ready","message":"Subnet has been successfully provisioned on Site","created":"2019-08-24T16:02:38Z","updated":"2019-08-24T16:02:38Z"},{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-subnet","description":"Retrieve all Subnets for the org\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter subnets by Site, required if vpcId query param is not specified"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"vpcId","description":"Filter subnets by VPC"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Subnets by Status"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description and status fields"},{"schema":{"type":"string","enum":["VPC","Tenant","IPv4Block","IPv6Block"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create Subnet","operationId":"create-subnet","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subnet"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-gpu-net","siteId":"ea144def-d68f-44c3-9485-4b103fa2686f","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerNetworkSegmentId":null,"ipv4Prefix":"202.168.16.0","ipv4BlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","ipv4Gateway":"202.168.0.1","ipv6Prefix":null,"ipv6BlockId":null,"ipv6Gateway":null,"prefixLength":20,"routingType":"Public","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create a Subnet for the org.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n\nAt least 1 IPv4 IP block or 1 IPv6 IP block must be specified.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubnetCreateRequest"},"examples":{"Example 1":{"value":{"name":"spark-gpu-net","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","ipv4BlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","prefixLength":20}}}}}},"tags":["Subnet"]}},"/v2/org/{org}/nico/subnet/{subnetId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"subnetId","in":"path","required":true,"description":"ID of the Subnet"}],"get":{"summary":"Retrieve Subnet","tags":["Subnet"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subnet"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-gpu-net","siteId":"ea144def-d68f-44c3-9485-4b103fa2686f","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerNetworkSegmentId":"abe7b0e8-67db-4e89-903e-fc4f2bd7f034","ipv4Prefix":"202.168.16.0","ipv4BlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","ipv4Gateway":"202.168.0.1","ipv6Prefix":null,"ipv6BlockId":null,"ipv6Gateway":null,"prefixLength":20,"routingType":"Public","status":"Ready","statusHistory":[{"status":"Ready","message":"Subnet has been successfully provisioned on Site","created":"2019-08-24T16:02:38Z","updated":"2019-08-24T16:02:38Z"},{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-subnet","description":"Retrieve a specific Subnet\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","enum":["VPC","Tenant","IPv4Block","IPv6Block"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"delete":{"summary":"Delete Subnet","operationId":"delete-subnet","responses":{"204":{"description":"No Content"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a specific Subnet by ID.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["Subnet"]},"patch":{"summary":"Update Subnet","operationId":"update-subnet","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Subnet"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-gpu-subnet","description":"Subnet for dedicated GPU nodes","siteId":"ea144def-d68f-44c3-9485-4b103fa2686f","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerNetworkSegmentId":null,"ipv4Prefix":"212.168.0.250","ipv4BlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","ipv4Gateway":"202.168.0.1","ipv6Prefix":null,"ipv6BlockId":null,"ipv6Gateway":null,"prefixLength":20,"routingType":"Public","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Subnet"],"description":"Update an existing Subnet\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubnetUpdateRequest"},"examples":{"example-1":{"value":{"name":"spark-gpu-subnet","description":"Subnet for dedicated GPU nodes"}}}}}}}},"/v2/org/{org}/nico/expected-machine":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create Expected Machine","operationId":"create-expected-machine","description":"Create an Expected Machine to pre-register Machines expected to be discovered at a Site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also create Expected Machines if they have an account with the Site's Infrastructure Provider.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedMachineCreateRequest"},"examples":{"example-1":{"value":{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","defaultBmcUsername":"admin","defaultBmcPassword":"password123","chassisSerialNumber":"CHASSIS-12345","fallbackDPUSerialNumbers":["DPU-001","DPU-002"],"labels":{"environment":"production","rack":"A1"}}}}}},"description":"Expected Machine creation request","required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedMachine"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Machine"]},"get":{"summary":"Retrieve all Expected Machines","operationId":"get-all-expected-machine","description":"Retrieve all Expected Machines.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Machines if they have an account with the Site's Infrastructure Provider (siteId query parameter is required for Tenants).","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","description":"ID of the Site to filter Expected Machines by"},{"schema":{"type":"string","enum":["Site","Sku"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["BMC_MAC_ADDRESS_ASC","BMC_MAC_ADDRESS_DESC","CHASSIS_SERIAL_NUMBER_ASC","CHASSIS_SERIAL_NUMBER_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExpectedMachine"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Machine"]}},"/v2/org/{org}/nico/expected-machine/{expectedMachineId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"expectedMachineId","in":"path","required":true,"description":"ID of the Expected Machine"}],"get":{"summary":"Retrieve Expected Machine","operationId":"get-expected-machine","description":"Retrieve a specific Expected Machine by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Machines if they have an account with the Site's Infrastructure Provider.","parameters":[{"schema":{"type":"string","enum":["Site","Sku"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedMachine"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Machine"]},"patch":{"summary":"Update Expected Machine","operationId":"update-expected-machine","description":"Update an existing Expected Machine by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nInfrastructure Provider must own the Expected Machine.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also update Expected Machines if they have an account with the Site's Infrastructure Provider.","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedMachineUpdateRequest"},"examples":{"example-1":{"value":{"defaultBmcUsername":"newadmin","defaultBmcPassword":"newpassword123","chassisSerialNumber":"CHASSIS-54321","labels":{"environment":"staging","rack":"B2"}}}}}},"description":"Expected Machine update request","required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedMachine"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Machine"]},"delete":{"summary":"Delete Expected Machine","operationId":"delete-expected-machine","description":"Delete an existing Expected Machine by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nInfrastructure Provider must own the Expected Machine.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also delete Expected Machines if they have an account with the Site's Infrastructure Provider.","parameters":[],"responses":{"204":{"description":"ExpectedMachine deleted successfully"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Machine"]}},"/v2/org/{org}/nico/expected-machine/batch":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Batch Create Expected Machines","operationId":"batch-create-expected-machines","description":"Create multiple Expected Machines in a single request. All machines must belong to the same site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also create Expected Machines if they have an account with the Site's Infrastructure Provider.\n\nMaximum batch size: 100 Expected Machines per request.","requestBody":{"content":{"application/json":{"schema":{"type":"array","minItems":1,"maxItems":100,"items":{"$ref":"#/components/schemas/ExpectedMachineCreateRequest"}},"examples":{"example-1":{"value":[{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","defaultBmcUsername":"admin","defaultBmcPassword":"password123","chassisSerialNumber":"CHASSIS-12345","fallbackDPUSerialNumbers":["DPU-001","DPU-002"],"labels":{"environment":"production","rack":"A1"}},{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5F","defaultBmcUsername":"admin","defaultBmcPassword":"password456","chassisSerialNumber":"CHASSIS-12346","fallbackDPUSerialNumbers":["DPU-003","DPU-004"],"labels":{"environment":"production","rack":"A2"}}]}}}},"description":"Array of Expected Machine creation requests","required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExpectedMachine"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Machine"]},"patch":{"summary":"Batch Update Expected Machines","operationId":"batch-update-expected-machines","description":"Update multiple Expected Machines in a single request. All machines must belong to the same site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nInfrastructure Provider must own the Expected Machines.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also update Expected Machines if they have an account with the Site's Infrastructure Provider.\n\nMaximum batch size: 100 Expected Machines per request.","requestBody":{"content":{"application/json":{"schema":{"type":"array","minItems":1,"maxItems":100,"items":{"$ref":"#/components/schemas/ExpectedMachineUpdateRequest"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","defaultBmcUsername":"newadmin","defaultBmcPassword":"newpassword123","chassisSerialNumber":"CHASSIS-54321","labels":{"environment":"staging","rack":"B2"}},{"id":"597f6eca-6276-4993-bfeb-53cbbbba6f09","defaultBmcUsername":"newadmin2","defaultBmcPassword":"newpassword456","chassisSerialNumber":"CHASSIS-54322","labels":{"environment":"staging","rack":"B3"}}]}}}},"description":"Array of Expected Machine update requests","required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExpectedMachine"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"description":"One or more Expected Machines not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"}}}}},"tags":["Expected Machine"]}},"/v2/org/{org}/nico/expected-power-shelf":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create Expected Power Shelf","operationId":"create-expected-power-shelf","description":"Create an Expected Power Shelf to pre-register power shelves expected to be discovered at a Site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also create Expected Power Shelves if they have an account with the Site's Infrastructure Provider.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedPowerShelfCreateRequest"},"examples":{"example-1":{"value":{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","defaultBmcUsername":"admin","defaultBmcPassword":"password123","shelfSerialNumber":"SHELF-12345","bmcIpAddress":"192.168.1.100","labels":{"environment":"production","rack":"A1"}}}}}},"description":"Expected Power Shelf creation request","required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedPowerShelf"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Power Shelf"]},"get":{"summary":"Retrieve all Expected Power Shelves","operationId":"get-all-expected-power-shelf","description":"Retrieve all Expected Power Shelves.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Power Shelves if they have an account with the Site's Infrastructure Provider (siteId query parameter is required for Tenants).","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","description":"ID of the Site to filter Expected Power Shelves by"},{"schema":{"type":"string","enum":["Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["BMC_MAC_ADDRESS_ASC","BMC_MAC_ADDRESS_DESC","SHELF_SERIAL_NUMBER_ASC","SHELF_SERIAL_NUMBER_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExpectedPowerShelf"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Power Shelf"]}},"/v2/org/{org}/nico/expected-power-shelf/{expectedPowerShelfId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"expectedPowerShelfId","in":"path","required":true,"description":"ID of the Expected Power Shelf"}],"get":{"summary":"Retrieve Expected Power Shelf","operationId":"get-expected-power-shelf","description":"Retrieve a specific Expected Power Shelf by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Power Shelves if they have an account with the Site's Infrastructure Provider.","parameters":[{"schema":{"type":"string","enum":["Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedPowerShelf"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Power Shelf"]},"patch":{"summary":"Update Expected Power Shelf","operationId":"update-expected-power-shelf","description":"Update an existing Expected Power Shelf by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nInfrastructure Provider must own the Expected Power Shelf.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also update Expected Power Shelves if they have an account with the Site's Infrastructure Provider.","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedPowerShelfUpdateRequest"},"examples":{"example-1":{"value":{"defaultBmcUsername":"newadmin","defaultBmcPassword":"newpassword123","shelfSerialNumber":"SHELF-54321","bmcIpAddress":"192.168.1.200","labels":{"environment":"staging","rack":"B2"}}}}}},"description":"Expected Power Shelf update request","required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedPowerShelf"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Power Shelf"]},"delete":{"summary":"Delete Expected Power Shelf","operationId":"delete-expected-power-shelf","description":"Delete an existing Expected Power Shelf by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nInfrastructure Provider must own the Expected Power Shelf.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also delete Expected Power Shelves if they have an account with the Site's Infrastructure Provider.","parameters":[],"responses":{"204":{"description":"Expected Power Shelf deleted successfully"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Power Shelf"]}},"/v2/org/{org}/nico/expected-rack":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create Expected Rack","operationId":"create-expected-rack","description":"Create an Expected Rack to pre-register a rack expected to be discovered at a Site. The `rackId` is an operator-supplied string identifier (not a UUID) that uniquely identifies the rack within the Site.\n\nOrg must have an Infrastructure Provider entity. User must have `FORGE_PROVIDER_ADMIN` role.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also create Expected Racks if they have an account with the Site's Infrastructure Provider.\n\nChassis identity and physical location information are conveyed via well-known label keys in `labels`:\n- `chassis.manufacturer`, `chassis.serial-number`, `chassis.model`\n- `location.region`, `location.datacenter`, `location.room`, `location.position`","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedRackCreateRequest"},"examples":{"example-1":{"value":{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","rackId":"rack-01","rackProfileId":"rp-standard-42u","name":"Rack 01","description":"Production rack in row A","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001001","chassis.model":"GB200-NVL72","location.region":"us-west-2","location.datacenter":"phx-dc01","location.room":"room-1","location.position":"A1"}}}}}},"description":"Expected Rack creation request","required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedRack"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Rack"]},"get":{"summary":"Retrieve all Expected Racks","operationId":"get-all-expected-rack","description":"Retrieve all Expected Racks.\n\nOrg must have an Infrastructure Provider entity. User must have `FORGE_PROVIDER_ADMIN` or `FORGE_PROVIDER_VIEWER` role.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Racks if they have an account with the Site's Infrastructure Provider (siteId query parameter is required for Tenants).","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","description":"ID of the Site to filter Expected Racks by"},{"schema":{"type":"string","enum":["Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["RACK_ID_ASC","RACK_ID_DESC","RACK_PROFILE_ID_ASC","RACK_PROFILE_ID_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExpectedRack"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Rack"]},"put":{"summary":"Replace all Expected Racks","operationId":"replace-all-expected-rack","description":"Replace the full set of Expected Racks for a Site with the provided list. All existing Expected Racks for the Site that are not in the request body will be deleted, and any new Expected Racks in the request will be created. Existing Expected Racks with matching `rackId` values will be updated.\n\nEvery entry in `expectedRacks` must reference the same `siteId` as the top-level `siteId`. `rackId` values must be unique within the request. The `expectedRacks` array may be empty to clear all Expected Racks for the Site.\n\nOrg must have an Infrastructure Provider entity. User must have `FORGE_PROVIDER_ADMIN` role.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also replace Expected Racks if they have an account with the Site's Infrastructure Provider.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedRackList"},"examples":{"example-1":{"value":{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","expectedRacks":[{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","rackId":"rack-01","rackProfileId":"rp-standard-42u","name":"Rack 01","description":"Production rack in row A","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001001","chassis.model":"GB200-NVL72","location.datacenter":"phx-dc01","location.position":"A1"}},{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","rackId":"rack-02","rackProfileId":"rp-standard-42u","name":"Rack 02","description":"Production rack in row A","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001002","chassis.model":"GB200-NVL72","location.datacenter":"phx-dc01","location.position":"A2"}}]}}}}},"description":"Replace-all Expected Racks request","required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExpectedRack"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Rack"]}},"/v2/org/{org}/nico/expected-rack/all":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"delete":{"summary":"Delete all Expected Racks","operationId":"delete-all-expected-rack","description":"Delete all Expected Racks for a Site.\n\nOrg must have an Infrastructure Provider entity. User must have `FORGE_PROVIDER_ADMIN` role.\n\nInfrastructure Provider must own the Expected Racks.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also delete Expected Racks if they have an account with the Site's Infrastructure Provider.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site whose Expected Racks should be deleted"}],"responses":{"204":{"description":"All Expected Racks deleted successfully"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Rack"]}},"/v2/org/{org}/nico/expected-rack/{id}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Expected Rack"}],"get":{"summary":"Retrieve Expected Rack","operationId":"get-expected-rack","description":"Retrieve a specific Expected Rack by its `id`.\n\nOrg must have an Infrastructure Provider entity. User must have `FORGE_PROVIDER_ADMIN` or `FORGE_PROVIDER_VIEWER` role.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Racks if they have an account with the Site's Infrastructure Provider.","parameters":[{"schema":{"type":"string","enum":["Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedRack"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Rack"]},"patch":{"summary":"Update Expected Rack","operationId":"update-expected-rack","description":"Update an existing Expected Rack identified by its `id`.\n\nOrg must have an Infrastructure Provider entity. User must have `FORGE_PROVIDER_ADMIN` role.\n\nInfrastructure Provider must own the Expected Rack.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also update Expected Racks if they have an account with the Site's Infrastructure Provider.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedRackUpdateRequest"},"examples":{"example-1":{"value":{"rackProfileId":"rp-standard-48u","name":"Rack 01 (updated)","description":"Production rack in row A, upgraded chassis","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001001","chassis.model":"GB200-NVL72","location.datacenter":"phx-dc01","location.position":"A1"}}}}}},"description":"Expected Rack update request","required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedRack"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Rack"]},"delete":{"summary":"Delete Expected Rack","operationId":"delete-expected-rack","description":"Delete an existing Expected Rack identified by its `id`.\n\nOrg must have an Infrastructure Provider entity. User must have `FORGE_PROVIDER_ADMIN` role.\n\nInfrastructure Provider must own the Expected Rack.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also delete Expected Racks if they have an account with the Site's Infrastructure Provider.","responses":{"204":{"description":"Expected Rack deleted successfully"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Rack"]}},"/v2/org/{org}/nico/expected-switch":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create Expected Switch","operationId":"create-expected-switch","description":"Create an Expected Switch to pre-register network switches expected to be discovered at a Site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also create Expected Switches if they have an account with the Site's Infrastructure Provider.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedSwitchCreateRequest"},"examples":{"example-1":{"value":{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","defaultBmcUsername":"admin","defaultBmcPassword":"password123","switchSerialNumber":"SWITCH-12345","nvOsUsername":"nvadmin","nvOsPassword":"nvpassword123","labels":{"environment":"production","rack":"A1"}}}}}},"description":"Expected Switch creation request","required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedSwitch"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Switch"]},"get":{"summary":"Retrieve all Expected Switches","operationId":"get-all-expected-switch","description":"Retrieve all Expected Switches.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Switches if they have an account with the Site's Infrastructure Provider (siteId query parameter is required for Tenants).","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","description":"ID of the Site to filter Expected Switches by"},{"schema":{"type":"string","enum":["Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["BMC_MAC_ADDRESS_ASC","BMC_MAC_ADDRESS_DESC","SWITCH_SERIAL_NUMBER_ASC","SWITCH_SERIAL_NUMBER_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExpectedSwitch"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Expected Switch"]}},"/v2/org/{org}/nico/expected-switch/{expectedSwitchId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"expectedSwitchId","in":"path","required":true,"description":"ID of the Expected Switch"}],"get":{"summary":"Retrieve Expected Switch","operationId":"get-expected-switch","description":"Retrieve a specific Expected Switch by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also retrieve Expected Switches if they have an account with the Site's Infrastructure Provider.","parameters":[{"schema":{"type":"string","enum":["Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedSwitch"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Switch"]},"patch":{"summary":"Update Expected Switch","operationId":"update-expected-switch","description":"Update an existing Expected Switch by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nInfrastructure Provider must own the Expected Switch.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also update Expected Switches if they have an account with the Site's Infrastructure Provider.","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedSwitchUpdateRequest"},"examples":{"example-1":{"value":{"defaultBmcUsername":"newadmin","defaultBmcPassword":"newpassword123","switchSerialNumber":"SWITCH-54321","nvOsUsername":"newnvadmin","nvOsPassword":"newnvpassword123","labels":{"environment":"staging","rack":"B2"}}}}}},"description":"Expected Switch update request","required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedSwitch"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Switch"]},"delete":{"summary":"Delete Expected Switch","operationId":"delete-expected-switch","description":"Delete an existing Expected Switch by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nInfrastructure Provider must own the Expected Switch.\n\nAlternatively, Tenant Admins with `TargetedInstanceCreation` capability can also delete Expected Switches if they have an account with the Site's Infrastructure Provider.","parameters":[],"responses":{"204":{"description":"Expected Switch deleted successfully"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Expected Switch"]}},"/v2/org/{org}/nico/sku":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all SKUs","operationId":"get-all-sku","description":"Retrieve all SKUs (Stock Keeping Units) for the Infrastructure Provider or privileged Tenant.\n\nSKUs represent unique hardware configurations discovered at sites. They are automatically derived from machine characteristics.\n\nA `siteId` query parameter is required for all requests.\n\nFor Infrastructure Providers: Org must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled. User must have authorization role with `TENANT_ADMIN` suffix. The Tenant must have an account with the Site's Infrastructure Provider.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site to retrieve SKUs from"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC","ID_ASC","ID_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Sku"}},"examples":{"example-1":{"value":[{"id":"lenovo.sr650v2.cpu.1","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","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"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["SKU"]}},"/v2/org/{org}/nico/sku/{skuId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"skuId","in":"path","required":true,"description":"ID of the SKU"}],"get":{"summary":"Retrieve SKU","operationId":"get-sku","description":"Retrieve a specific SKU (Stock Keeping Unit) by ID.\n\nSKUs represent unique hardware configurations discovered at sites. They are automatically derived from machine characteristics.\n\nFor Infrastructure Providers: Org must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled. User must have authorization role with `TENANT_ADMIN` suffix. The Tenant must have an account with the SKU's Site's Infrastructure Provider.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sku"},"examples":{"example-1":{"value":{"id":"lenovo.sr650v2.cpu.1","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","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"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["SKU"]}},"/v2/org/{org}/nico/infiniband-partition":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all InfiniBand Partitions","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InfiniBandPartition"}},"examples":{"Example 1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"turbo-net","description":"InfiniBand Partition for model training Instances","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerIBPartitionId":"0e60d064-3d38-4812-84d9-c3353bd96eaf","partitionKey":"0x1","partitionName":"turbo-net","serviceLevel":5,"rateLimit":40,"mtu":4000,"enableSharp":true,"labels":{"environment":"production","team":"devops"},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-infiniband-partition","description":"Retrieve all InfiniBand Partitions for the org\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter Partitions by Site"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Partitions by Status"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description and status fields"},{"schema":{"type":"string","enum":["Site","VPC","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"tags":["InfiniBand Partition"]},"post":{"summary":"Create InfiniBand Partition","operationId":"create-infiniband-partition","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfiniBandPartition"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"turbo-net","description":"InfiniBand Partition for model training Instances","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerIBPartitionId":"0e60d064-3d38-4812-84d9-c3353bd96eaf","partitionKey":"0x1","partitionName":"turbo-net","serviceLevel":5,"rateLimit":40,"mtu":4000,"enableSharp":true,"labels":{"environment":"production","team":"devops"},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an InfiniBand Partition for the org.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfiniBandPartitionCreateRequest"},"examples":{"Example 1":{"value":{"name":"turbo-net","siteId":"69dae3c8-3554-4a1f-b391-858c6dc47fff","labels":{"environment":"production","team":"devops"}}}}}}},"tags":["InfiniBand Partition"]}},"/v2/org/{org}/nico/infiniband-partition/{infiniBandPartitionId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"infiniBandPartitionId","in":"path","required":true,"description":"ID of the InfiniBand Partition"}],"get":{"summary":"Retrieve InfiniBand Partition","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfiniBandPartition"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"turbo-net","description":"InfiniBand Partition for model training Instances","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerIBPartitionId":"0e60d064-3d38-4812-84d9-c3353bd96eaf","partitionKey":"0x1","partitionName":"turbo-net","serviceLevel":5,"rateLimit":40,"mtu":4000,"enableSharp":true,"labels":{"environment":"production","team":"devops"},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-infiniband-partition","description":"Retrieve a specific InfiniBand Partition\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n\nTenant must own the Partition.","parameters":[{"schema":{"type":"string","enum":["Site","VPC","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}],"tags":["InfiniBand Partition"]},"delete":{"summary":"Delete InfiniBand Partition","operationId":"delete-infiniband-partition","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a specific InfiniBand Partition by ID.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n\nTenant must own the Partition.","tags":["InfiniBand Partition"]},"patch":{"summary":"Update InfiniBand Partition","operationId":"update-infiniband-partition","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfiniBandPartition"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"turbo-net-v2","description":"Second version of the model training network","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerIBPartitionId":"0e60d064-3d38-4812-84d9-c3353bd96eaf","partitionKey":"0x1","partitionName":"turbo-net","serviceLevel":5,"rateLimit":40,"mtu":4000,"enableSharp":true,"labels":{"environment":"production","team":"devops"},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Update an existing InfiniBand Partition\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n\nTenant must own the Partition.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfiniBandPartitionUpdateRequest"},"examples":{"Example 1":{"value":{"name":"turbo-net-v2","description":"Second version of the model training network","labels":{"environment":"production","team":"devops"}}}}}}},"tags":["InfiniBand Partition"]}},"/v2/org/{org}/nico/nvlink-logical-partition":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the NGC Org"}],"get":{"summary":"Retrieve all NVLink Logical Partitions","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NVLinkLogicalPartition"}},"examples":{"Example 1":{"value":[{"id":"ded96bdf-905e-40dd-8a58-3472aab60042","name":"partition-east-gpu","description":"NVLink Logical Partition for model training Instances","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-nvlink-logical-partition","description":"Retrieve all NVLink Logical Partitions for the org\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter NVLink Logical Partitions by Site"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter NVLink Logical Partitions by Status"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description and status fields"},{"schema":{"type":"boolean"},"in":"query","name":"includeInterfaces","description":"Include NVLink Interfaces in response."},{"schema":{"type":"boolean"},"in":"query","name":"includeStats","description":"Include NVLink Logical Partition Stats in response."},{"schema":{"type":"boolean"},"in":"query","name":"includeVpcs","description":"Include VPCs in response."},{"schema":{"type":"string","enum":["Site","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"tags":["NVLink Logical Partition"]},"post":{"summary":"Create NVLink Logical Partition","operationId":"create-nvlink-logical-partition","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NVLinkLogicalPartition"},"examples":{"Example 1":{"value":{"id":"ded96bdf-905e-40dd-8a58-3472aab60042","name":"partition-east-gpu","description":"NVLink Logical Partition for model training Instances","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an NVLink Logical Partition for the org.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NVLinkLogicalPartitionCreateRequest"},"examples":{"Example 1":{"value":{"name":"partition-east-gpu","siteId":"69dae3c8-3554-4a1f-b391-858c6dc47fff"}}}}}},"tags":["NVLink Logical Partition"]}},"/v2/org/{org}/nico/nvlink-logical-partition/{nvLinkLogicalPartitionId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the NGC Org"},{"schema":{"type":"string"},"name":"nvLinkLogicalPartitionId","in":"path","required":true,"description":"ID of the NVLink Logical Partition"}],"get":{"summary":"Retrieve NVLink Logical Partition","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NVLinkLogicalPartition"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-nvlink-logical-partition","description":"Retrieve a specific NVLink Logical Partition by ID\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["NVLink Logical Partition"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"includeInterfaces","description":"Include all attached NVLink Interfaces in response"},{"schema":{"type":"boolean"},"in":"query","name":"includeStats","description":"Include NVLink Logical Partition Stats in response"},{"schema":{"type":"boolean"},"in":"query","name":"includeVpcs","description":"Include all attached VPCs in response"},{"schema":{"type":"string","enum":["Site","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"patch":{"summary":"Update NVLink Logical Partition","operationId":"update-nvlink-logical-partition","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NVLinkLogicalPartition"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Update a specific NVLink Logical Partition\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NVLinkLogicalPartitionUpdateRequest"}}}},"tags":["NVLink Logical Partition"]},"delete":{"summary":"Delete NVLink Logical Partition","operationId":"delete-nvlink-logical-partition","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete an NVLink Logical Partition by ID\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["NVLink Logical Partition"]}},"/v2/org/{org}/nico/instance/type":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Instance Types","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InstanceType"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"x3.large","description":"Part of X family, the X3 Large features increased compute power","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"queryParam":"includeMachineAssociation","replacedBy":"includeMachineAssignment","takeActionBy":"2023-07-26T00:00:00Z","notice":"'includeMachineAssociation' has been deprecated in favor of 'includeMachineAssignment'. Please take action immediately."},{"attribute":"displayName","takeActionBy":"2024-10-30T00:00:00Z","notice":"'displayName' has been deprecated. Please take action immediately."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]},"example-2":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"ib.general","description":"General Purpose InfiniBand Instances","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","machineCapabilities":[{"type":"InfiniBand","name":"Mellanox Technologies MT28908 Family [ConnectX-6]","vendor":"Mellanox Technologies","count":2}],"machineInstanceTypes":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"queryParam":"includeMachineAssociation","replacedBy":"includeMachineAssignment","takeActionBy":"2023-07-26T00:00:00Z","notice":"'includeMachineAssociation' has been deprecated in favor of 'includeMachineAssignment'. Please take action immediately."},{"attribute":"displayName","takeActionBy":"2024-10-30T00:00:00Z","notice":"'displayName' has been deprecated. Please take action immediately."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]},"example-3":{"value":[{"id":"0327339b-f3b7-4de3-9468-7dc29f9f6914","name":"ib.multi-dpu","description":"Multi DPU Instances","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","machineCapabilities":[{"type":"Network","name":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","vendor":"Mellanox Technologies","count":2,"deviceType":"DPU"}],"machineInstanceTypes":[{"id":"0327339b-f3b7-4de3-9468-7dc29f9f6914","machineId":"fm100dsg23d2f4tq4tt5m2hgib5pcldrm3gvefbduau7gj3itgc3iqg3lpg","instanceTypeId":"771b066a-f2ff-4550-a65d-baef8551167d","created":"2025-05-24T14:15:22Z","updated":"2025-05-24T14:15:22Z"}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2025-05-24T14:15:22Z","updated":"2025-05-24T14:15:22Z"}],"deprecations":[{"queryParam":"includeMachineAssociation","replacedBy":"includeMachineAssignment","takeActionBy":"2023-07-26T00:00:00Z","notice":"'includeMachineAssociation' has been deprecated in favor of 'includeMachineAssignment'. Please take action immediately."},{"attribute":"displayName","takeActionBy":"2024-10-30T00:00:00Z","notice":"'displayName' has been deprecated. Please take action immediately."}],"created":"2025-05-24T14:15:22Z","updated":"2025-05-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-instance-type","description":"Get all Instance Types for the org.\n\nProvider and Tenant roles are inferred from the org's membership. User must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix.\n\nResults are returned from both Provider and Tenant perspectives when the org has both roles.\n","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter Instance Types by Site ID"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","deprecated":true,"description":"Filter Instance Types by Infrastructure Provider ID."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","deprecated":true,"description":"Filter Instance Types by Tenant ID."},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Instance Types by Status"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, display name, description, labels and status fields"},{"schema":{"type":"string","enum":["InfrastructureProvider","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"boolean"},"in":"query","name":"includeMachineAssignment","description":"Include Machine assignments for each Instance Type. Can only be requested by Provider."},{"schema":{"type":"boolean"},"in":"query","name":"includeAllocationStats","description":"Include Allocation stats."},{"schema":{"type":"boolean"},"in":"query","name":"excludeUnallocated","description":"Excludes InstanceType records that have no allocations from being returned in the result set. Currently can only be requested by Tenant."},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"tags":["Instance Type"]},"post":{"summary":"Create an Instance Type","operationId":"create-instance-type","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstanceType"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"x3.large","description":"Part of X family, the X3 Large features increased compute power","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","labels":{"region":"portland","env":"staging"},"machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"queryParam":"includeMachineAssociation","replacedBy":"includeMachineAssignment","takeActionBy":"2023-07-26T00:00:00Z","notice":"'includeMachineAssociation' has been deprecated in favor of 'includeMachineAssignment'. Please take action immediately."},{"attribute":"displayName","takeActionBy":"2024-10-30T00:00:00Z","notice":"'displayName' has been deprecated. Please take action immediately."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an Instance Type for Infrastructure Provider.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstanceTypeCreateRequest"},"examples":{"example-1":{"value":{"name":"x3.large","description":"Part of X family, the X3 Large features increased compute power","siteId":"8d97fa69-9199-49ff-bcf3-168c62d3874e","labels":{"region":"portland","env":"staging"},"machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4}]}},"example-2":{"value":{"name":"infiniband-mt2910-4x2","description":"Machines with 2 active InfiniBand MT2910 NICs","siteId":"8d97fa69-9199-49ff-bcf3-168c62d3874e","labels":{"region":"portland","env":"dev"},"machineCapabilities":[{"type":"InfiniBand","name":"MT2910 Family [ConnectX-7]","vendor":"Mellanox Technologies","count":4,"inactiveDevices":[1,3]}]}}}}}},"tags":["Instance Type"]}},"/v2/org/{org}/nico/instance/type/{instanceTypeId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"instanceTypeId","in":"path","required":true,"description":"ID of the Instance Type"}],"get":{"summary":"Retrieve an Instance Type","tags":["Instance Type"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstanceType"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"x3.large","description":"Part of X family, the X3 Large features increased compute power","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","labels":{"region":"portland","env":"staging"},"machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2}],"allocationStats":{"assigned":30,"total":10,"used":3,"unused":7,"unusedUsable":7,"maxAllocatable":20},"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"queryParam":"includeMachineAssociation","replacedBy":"includeMachineAssignment","takeActionBy":"2023-07-26T00:00:00Z","notice":"'includeMachineAssociation' has been deprecated in favor of 'includeMachineAssignment'. Please take action immediately."},{"attribute":"displayName","takeActionBy":"2024-10-30T00:00:00Z","notice":"'displayName' has been deprecated. Please take action immediately."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-instance-type","description":"Get an Instance Type by ID.\n\nIf the org has an Infrastructure Provider entity that owns the Instance Type, then the Instance Type detail is returned. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nIf the org has a Tenant entity and it has a Tenant Account with the Infrastructure Provider of the Instance Type, then the Instance Type detail is returned. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"boolean"},"in":"query","name":"includeMachineAssociation","description":"Include Machine associations for each Instance Type. Can only be requested by Provider"},{"schema":{"type":"boolean"},"in":"query","name":"includeAllocationStats","description":"Include Allocation stats. Currently can only be requested by Tenant"},{"schema":{"type":"string","enum":["InfrastructureProvider","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"delete":{"summary":"Delete Instance Type","operationId":"delete-instance-type","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete an Instance Type by ID.\n\nOrg must have an Infrastructure Provider entity that owns the Instance Type. User must have authorization role with `PROVIDER_ADMIN` suffix.","tags":["Instance Type"]},"patch":{"summary":"Update Instance Type","operationId":"update-instance-type","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstanceType"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"x3.large","description":"Updated version of the X3 Large family of machines","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","labels":{"region":"portland","env":"staging"},"machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"queryParam":"includeMachineAssociation","replacedBy":"includeMachineAssignment","takeActionBy":"2023-07-26T00:00:00Z","notice":"'includeMachineAssociation' has been deprecated in favor of 'includeMachineAssignment'. Please take action immediately."},{"attribute":"displayName","takeActionBy":"2024-10-30T00:00:00Z","notice":"'displayName' has been deprecated. Please take action immediately."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Update an Instance Type by ID.\n\nOrg must have an Infrastructure Provider entity that owns the Instance Type. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstanceTypeUpdateRequest"},"examples":{"example-1":{"value":{"description":"Updated version of the X3 Large family of machines","labels":{"region":"portland","env":"staging"},"machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2}]}}}}},"description":""},"tags":["Instance Type"]}},"/v2/org/{org}/nico/instance/type/{instanceTypeId}/machine":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"instanceTypeId","in":"path","required":true,"description":"ID of the Instance Type"}],"get":{"summary":"Retrieve all Machines/Instance Type associations","tags":["Instance Type"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MachineInstanceType"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"f690ffcd-06b7-430c-9c2a-b9afd18d77c3","machineId":"fm100htrh18t1lrjg2pqagkh3sfigr9m65dejvkq168ako07sc0uibpp5q0","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-instance-type-machine-association","description":"Get all Machines for a given Instance Type\n\nOrg must have an Infrastructure Provider entity that owns the Instance Type and the Machine. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create a Machine/Instance Type association","operationId":"create-instance-type-machine-association","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MachineInstanceType"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"f690ffcd-06b7-430c-9c2a-b9afd18d77c3","machineId":"fm100ht68sf2m52idrpslcjkpdj5r3tb3j5o0bkfubhoglbq47u18nknfog","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"f690ffcd-06b7-430c-9c2a-b9afd18d77c3","machineId":"fm100htrh18t1lrjg2pqagkh3sfigr9m65dejvkq168ako07sc0uibpp5q0","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Instance Type"],"description":"Associate a Machine to an Instance Type\n\nOrg must have an Infrastructure Provider entity that owns the Instance Type and the Machine. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nThe Machine's capabilities must be a superset of the Instance Type's required capabilities for the association to succeed.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MachineInstanceTypeCreateRequest"},"examples":{"example-1":{"value":{"machineIds":["fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","fm100htrh18t1lrjg2pqagkh3sfigr9m65dejvkq168ako07sc0uibpp5q0","fm100ht68sf2m52idrpslcjkpdj5r3tb3j5o0bkfubhoglbq47u18nknfog"]}}}}}}}},"/v2/org/{org}/nico/instance/type/{instanceTypeId}/machine/{machineAssociationId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"instanceTypeId","in":"path","required":true,"description":"ID of the Instance Type"},{"schema":{"type":"string"},"name":"machineAssociationId","in":"path","required":true,"description":"Can be ID of the Machine (`machineId`) or ID of Machine/Instance Type Association (`machineAssociationId`). Use of `machineAssociationId` is now deprecated and will no longer be accepted after July 9th, 2026 00:00 UTC."}],"delete":{"summary":"Delete a Machine/Instance Type association","operationId":"delete-instance-type-machine-association","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a Machine's association with an Instance Type.\n\n`machineAssociationId` path parameter has been renamed to `machineId`. The path parameter will continue to accept both Machine ID and Machine/Instance Type ID until July 9th, 2026 00:00 UTC. After that time, Machine/Instance Type ID will no longer be accepted.\n\nOrg must have an Infrastructure Provider entity that owns the Instance Type and the Machine. User must have authorization role with `PROVIDER_ADMIN` suffix.","tags":["Instance Type"]}},"/v2/org/{org}/nico/instance":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Instances","tags":["Instance"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Instance"}},"examples":{"example-1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-monitor-1","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":"158fc2bc-f2fb-4e1f-a5a4-2211062d14df","ipxeScript":null,"alwaysBootWithCustomIpxe":false,"userData":null,"labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e,","networkSecurityGroupPropagationDetails":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","detailedStatus":"Partial","status":"Synchronizing","details":"","unpropagatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"relatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"]},"networkSecurityGroupInherited":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"64d2028c-ae87-4069-a624-66089d957ef9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true,"device":null,"deviceInstance":null,"virtualFunctionId":null,"macAddress":"2F-FC-34-AE-9C-2A","ipAddresses":["200.32.11.190"],"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"infinibandInterfaces":[{"id":"c518a0e8-3f49-4a1a-8935-a6d3dee6911e","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","partitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"nvLinkInterfaces":[{"id":"fc19ab3f-1e52-4846-91bd-98743ff2752c","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":0,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"c0ae6ec4-9a77-4358-baad-ee8cc3332c91","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":1,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"aa44ff62-d86b-4db6-9fa4-90a19b05be01","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":2,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"a403d1ca-2c07-410a-9678-3eb44d570ad9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":3,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"dpuExtensionServiceDeployments":[],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"tpmEkCertificate":"LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUMxVENDQWJ5Z0F3SUJBZ0lVTEE1ZHFPK1E5OXZQM3VYRTRKcjBncVRtOW93d0RRWUpLb1pJaHZjTkFRRUwKQlFBd0xqRUxNQWtHQTFVRUJoTUNWVk14RXpBUkJnTlZCQW9NQ2s1MmFXUnBZU0JEYjNKNw==","status":"Ready","statusHistory":[{"status":"BootCompleted","message":"The Instance successfully completed boot up","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"attribute":"sshkeygroups","replacedBy":"sshKeyGroups","takeActionBy":"2025-09-04T00:00:00Z","notice":"'sshkeygroups' is being deprecated in favor of 'sshKeyGroups'. Please take action prior to the specified date."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]},"example-2":{"value":[{"id":"37804b21-0a00-4668-81cb-af9e1b07ad3e","name":"spark-monitor-vpc-prefix-1","description":"Node for monitoring Spark VPC prefix region","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":"37804b21-0a00-4668-81cb-af9e1b07ad3e","ipxeScript":null,"alwaysBootWithCustomIpxe":false,"userData":null,"networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e","networkSecurityGroupPropagationDetails":{"id":"37804b21-0a00-4668-81cb-af9e1b07ad3e","detailedStatus":"Partial","status":"Synchronizing","details":"","unpropagatedInstanceIds":["37804b21-0a00-4668-81cb-af9e1b07ad3e"],"relatedInstanceIds":["37804b21-0a00-4668-81cb-af9e1b07ad3e"]},"networkSecurityGroupInherited":false,"labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"07cd865e-5512-4fe9-8063-8f4c8f442b1a","instanceId":"37804b21-0a00-4668-81cb-af9e1b07ad3e","vpcPrefixId":"915443b6-d164-48d4-89dd-041968e1f9d7","isPhysical":true,"virtualFunctionId":null,"macAddress":"2F-FC-34-AE-9C-2A","ipAddresses":["200.32.11.190"],"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"infinibandInterfaces":[{"id":"c518a0e8-3f49-4a1a-8935-a6d3dee6911e","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","partitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"dpuExtensionServiceDeployments":[{"id":"3951ec37-d78f-4ad7-92e1-3fdc76ccf246","dpuExtensionService":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"busybox","serviceType":"KubernetesPod","latestVersion":"V1-T1761856992374052","status":"Ready"},"version":"V1-T1761856992374052","status":"Running","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Ready","statusHistory":[{"status":"BootCompleted","message":"The Instance successfully completed boot up","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"attribute":"sshkeygroups","replacedBy":"sshKeyGroups","takeActionBy":"2025-09-04T00:00:00Z","notice":"'sshkeygroups' is being deprecated in favor of 'sshKeyGroups' and will be removed on September 9th, 2025. Please update your usage accordingly."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]},"example-3":{"value":[{"id":"bba44e11-facc-4d7f-a2b5-ffdca3935b8b","name":"spark-monitor-vpc-prefix-multi-dpu","description":"Node for monitoring Spark VPC prefix region with Multi DPU","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"9fda8e2b-9656-4f96-9d79-14d03951e2d2","vpcId":"745f757f-894b-45ef-be63-b1044e76a87d","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":"8d76c56e-4a1c-4862-bf1c-8c2b794f3315","ipxeScript":null,"alwaysBootWithCustomIpxe":false,"userData":null,"networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e","networkSecurityGroupPropagationDetails":{"id":"37804b21-0a00-4668-81cb-af9e1b07ad3e","detailedStatus":"Partial","status":"Synchronizing","details":"","unpropagatedInstanceIds":["37804b21-0a00-4668-81cb-af9e1b07ad3e"],"relatedInstanceIds":["37804b21-0a00-4668-81cb-af9e1b07ad3e"]},"networkSecurityGroupInherited":false,"labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"fa84f327-cad4-458b-94b7-c320cdf48d4d","instanceId":"bba44e11-facc-4d7f-a2b5-ffdca3935b8b","vpcPrefixId":"915443b6-d164-48d4-89dd-041968e1f9d7","isPhysical":true,"device":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceInstance":0,"virtualFunctionId":null,"macAddress":"A0:88:C2:0C:91:B8","ipAddresses":["10.217.98.143"],"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"fa84f327-cad4-458b-94b7-c320cdf48d4d","instanceId":"bba44e11-facc-4d7f-a2b5-ffdca3935b8b","vpcPrefixId":"56944877-3bc0-48c9-8290-21f9e0e31eca","isPhysical":true,"device":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceInstance":1,"virtualFunctionId":null,"macAddress":"A0:88:C2:0C:91:20","ipAddresses":["10.217.98.149"],"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"infinibandInterfaces":[],"dpuExtensionServiceDeployments":[],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Ready","statusHistory":[{"status":"BootCompleted","message":"The Instance successfully completed boot up","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"attribute":"sshkeygroups","replacedBy":"sshKeyGroups","takeActionBy":"2025-09-04T00:00:00Z","notice":"'sshkeygroups' is being deprecated in favor of 'sshKeyGroups' and will be removed on September 9th, 2025. Please update your usage accordingly."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-instance","description":"Get all Instances for Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","description":"Filter by Infrastructure Provider ID"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter by Site ID. Can be specified multiple times to filter on more than one site."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"vpcId","description":"Filter by VPC ID. Can be specified multiple times to filter on more than one VPC."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"instanceTypeId","description":"Filter by instance type ID. Can be specified multiple times to filter on more than one instance type."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"operatingSystemId","description":"Filter by operating system ID. Can be specified multiple times to filter on more than one operating system."},{"schema":{"type":"string"},"in":"query","name":"machineId","description":"Filter by machine ID. Can be specified multiple times to filter on more than one machine."},{"schema":{"type":"string"},"in":"query","name":"name","description":"Filter by Instance name"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Instances by Status. Can be specified multiple times to filter on more than one status."},{"schema":{"type":"string"},"in":"query","name":"ipAddress","description":"Filter by IP address. Can be specified multiple times to filter on more than one IP address."},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description, status, and labels fields"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site","InstanceType","Allocation","VPC","Machine","OperatingSystem","NetworkSecurityGroup"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC","MACHINE_ID_ASC","MACHINE_ID_DESC","TENANT_ORG_DISPLAY_NAME_ASC","TENANT_ORG_DISPLAY_NAME_DESC","INSTANCE_TYPE_NAME_ASC","INSTANCE_TYPE_NAME_DESC","HAS_INFINIBAND_ASC","HAS_INFINIBAND_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"},{"schema":{"type":"string"},"in":"query","name":"networkSecurityGroupId","description":"Filter by NetworkSecurityGroup ID.  Can be specified multiple times to filter on more than one Network Security Group."}]},"post":{"summary":"Create an Instance","operationId":"create-instance","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Instance"},"examples":{"With iPXE override and Ethernet/InfiniBand Interfaces":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-monitor-1","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":null,"ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\nshell","alwaysBootWithCustomIpxe":true,"userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports","labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"64d2028c-ae87-4069-a624-66089d957ef9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true,"virtualFunctionId":null,"macAddress":null,"ipAddresses":[],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"infinibandInterfaces":[{"id":"c518a0e8-3f49-4a1a-8935-a6d3dee6911e","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","partitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"nvLinkInterfaces":[{"id":"fc19ab3f-1e52-4846-91bd-98743ff2752c","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":0,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"dpuExtensionServiceDeployments":[],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"attribute":"sshkeygroups","replacedBy":"sshKeyGroups","takeActionBy":"2025-09-04T00:00:00Z","notice":"'sshkeygroups' is being deprecated in favor of 'sshKeyGroups'. Please take action prior to the specified date."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}},"With DPU Extension Service Deployments":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-monitor-1","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":null,"labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"64d2028c-ae87-4069-a624-66089d957ef9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true,"virtualFunctionId":null,"macAddress":null,"ipAddresses":[],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"dpuExtensionServiceDeployments":[{"id":"3951ec37-d78f-4ad7-92e1-3fdc76ccf246","dpuExtensionService":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"busybox","serviceType":"KubernetesPod","latestVersion":"V1-T1761856992374052","status":"Ready"},"version":"V1-T1761856992374052","status":"Running","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an Instance for Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstanceCreateRequest"},"examples":{"With Subnet/InfiniBand Interfaces & iPXE Override":{"value":{"name":"spark-monitor-1","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\nshell","alwaysBootWithCustomIpxe":true,"userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports","labels":{"region":"portland","env":"staging"},"interfaces":[{"subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true}],"infinibandInterfaces":[{"partitionId":"4f4decba-7d7f-46b9-9e5f-e5d71c2e0666","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null}],"nvLinkInterfaces":[{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":0},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":1},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":2},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":3}],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"]}},"With Machine ID & VPC Prefix Interface":{"value":{"name":"spark-monitor-3","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","machineId":"fm100htq4o8j3bere298as19mdgnbu6hg6guiqp32tghj7gogv05hlr7lgg","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","labels":{"region":"portland","env":"staging"},"interfaces":[{"vpcPrefixId":"000bc42b-f946-472e-83d4-ddf7e365e148","isPhysical":true}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]}},"With Multiple Ethernet Device Interfaces":{"value":{"name":"spark-monitor-3","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","machineId":"fm100htq4o8j3bere298as19mdgnbu6hg6guiqp32tghj7gogv05hlr7lgg","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","labels":{"region":"portland","env":"staging"},"interfaces":[{"vpcPrefixId":"8c7422d7-abf5-41ae-8b6d-9d62442a8b31","isPhysical":true,"device":"MT43244 BlueField-3 integrated ConnectX-7 network controller","deviceInstance":0},{"vpcPrefixId":"8988dbd3-f038-4338-b961-8e5cbf89a77e","isPhysical":true,"device":"MT43244 BlueField-3 integrated ConnectX-7 network controller","deviceInstance":1}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]}},"With DPU Extension Services":{"value":{"name":"llm-training-1","description":"Node for training LLMs","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","machineId":"fm100htq4o8j3bere298as19mdgnbu6hg6guiqp32tghj7gogv05hlr7lgg","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","labels":{"region":"portland","env":"staging"},"interfaces":[{"vpcPrefixId":"8c7422d7-abf5-41ae-8b6d-9d62442a8b31","isPhysical":true,"device":"MT43244 BlueField-3 integrated ConnectX-7 network controller","deviceInstance":0},{"vpcPrefixId":"8988dbd3-f038-4338-b961-8e5cbf89a77e","isPhysical":true,"device":"MT43244 BlueField-3 integrated ConnectX-7 network controller","deviceInstance":1}],"dpuExtensionServiceDeployments":[{"dpuExtensionServiceId":"3bddb7b4-0963-4278-b311-c212dc758357","version":"V1-T1761856992374052"},{"dpuExtensionServiceId":"cd4a8168-c206-430a-9a4b-bf7dbbac3b40","version":"V1-T1762294647497908"}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]}}}}}},"tags":["Instance"]}},"/v2/org/{org}/nico/instance/batch":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Batch Create Instances","operationId":"batch-create-instance","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Instance"}},"examples":{"Batch created Instances":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"worker-abc123","description":"Worker node for distributed training","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":null,"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"85c5e7b2-89f1-4e32-9d3a-8e1f5a2c7d90","name":"worker-def456","description":"Worker node for distributed training","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"gn200iu5w5ndf3rtukol9081ook4jf7fdfl5nuok38qfb5lsf6hub50kh1h","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":null,"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Batch create multiple Instances for Tenant with NVLink domain-aware machine allocation.\n\nThis endpoint creates multiple instances in a single atomic transaction. All instances share the same configuration (interfaces, OS, SSH keys, etc.) but are assigned different machines.\n\nWhen `topologyOptimized` is true (default), all instances must be allocated on machines within the same NVLink domain. If insufficient machines are available in a single NVLink domain, the request will fail.\n\nWhen `topologyOptimized` is false, instances can be spread across different NVLink domains.\n\nInstance names are automatically generated using the `namePrefix` with a random 6-character suffix (e.g., \"worker\" becomes \"worker-abc123\", \"worker-def456\").\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchInstanceCreateRequest"},"examples":{"Topology-optimized batch with InfiniBand":{"value":{"namePrefix":"gpu-worker","count":4,"description":"GPU worker nodes for distributed training","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","topologyOptimized":true,"interfaces":[{"subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true}],"infinibandInterfaces":[{"partitionId":"4f4decba-7d7f-46b9-9e5f-e5d71c2e0666","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true}],"nvLinkInterfaces":[{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":0},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":1}],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"]}},"Cross-domain batch with VPC Prefix":{"value":{"namePrefix":"inference-node","count":8,"description":"Inference nodes spread across NVLink domains","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","instanceTypeId":"83e71f8f-65d3-44ba-92ba-19daac2e497a","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","topologyOptimized":false,"labels":{"workload":"inference","tier":"production"},"interfaces":[{"vpcPrefixId":"000bc42b-f946-472e-83d4-ddf7e365e148","isPhysical":true}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]}}}}}},"tags":["Instance"]}},"/v2/org/{org}/nico/instance/{instanceId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"instanceId","in":"path","required":true,"description":"ID of the Instance"}],"get":{"summary":"Retrieve Instance","tags":["Instance"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Instance"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-monitor-1","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":null,"ipxeScript":null,"alwaysBootWithCustomIpxe":false,"userData":null,"networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e","networkSecurityGroupPropagationDetails":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","detailedStatus":"Partial","status":"Synchronizing","details":"","unpropagatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"relatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"]},"networkSecurityGroupInherited":false,"labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"64d2028c-ae87-4069-a624-66089d957ef9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true,"virtualFunctionId":null,"macAddress":"2F-FC-34-AE-9C-2A","ipAddresses":["200.32.11.190"],"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"infinibandInterfaces":[{"id":"c518a0e8-3f49-4a1a-8935-a6d3dee6911e","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","partitionId":"4f4decba-7d7f-46b9-9e5f-e5d71c2e0666","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"nvLinkInterfaces":[{"id":"fc19ab3f-1e52-4846-91bd-98743ff2752c","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":0,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"c0ae6ec4-9a77-4358-baad-ee8cc3332c91","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":1,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"aa44ff62-d86b-4db6-9fa4-90a19b05be01","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":2,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"a403d1ca-2c07-410a-9678-3eb44d570ad9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":3,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"dpuExtensionServiceDeployments":[{"id":"3951ec37-d78f-4ad7-92e1-3fdc76ccf246","dpuExtensionService":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"busybox","serviceType":"KubernetesPod","latestVersion":"V1-T1761856992374052","status":"Ready"},"version":"V1-T1761856992374052","status":"Running","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"tpmEkCertificate":"LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUMxVENDQWJ5Z0F3SUJBZ0lVTEE1ZHFPK1E5OXZQM3VYRTRKcjBncVRtOW93d0RRWUpLb1pJaHZjTkFRRUwKQlFBd0xqRUxNQWtHQTFVRUJoTUNWVk14RXpBUkJnTlZCQW9NQ2s1MmFXUnBZU0JEYjNKNw==","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"attribute":"sshkeygroups","replacedBy":"sshKeyGroups","takeActionBy":"2025-09-04T00:00:00Z","notice":"'sshkeygroups' is being deprecated in favor of 'sshKeyGroups'. Please take action prior to the specified date."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-instance","description":"Get an Instance by ID\n\nOrg must have a Tenant entity. Instance must belong to Tenant. User must have authorization role with `TENANT_ADMIN` suffix.\n","parameters":[{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant","Site","InstanceType","Allocation","VPC","OperatingSystem","NetworkSecurityGroup"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"delete":{"summary":"Delete Instance","operationId":"delete-instance","responses":{"202":{"description":"Accepted"}},"description":"Delete an Instance by ID\n\nOrg must have a Tenant entity. Instance must belong to Tenant. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["Instance"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstanceDeleteRequest"},"examples":{"Example 1":{"value":{"machineHealthIssue":{"category":"Network","summary":"Machine has DPU connectivity error","details":"Tenant observed repeated link flaps on the DPU uplink."},"isRepairTenant":false}}}}},"description":"Optional request data to report health issues with the underlying Machine"}},"patch":{"summary":"Update Instance","operationId":"update-instance","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Instance"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-monitor-2","description":"Spark Monitor Node 1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":"158fc2bc-f2fb-4e1f-a5a4-2211062d14df","ipxeScript":null,"alwaysBootWithCustomIpxe":false,"userData":null,"labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"64d2028c-ae87-4069-a624-66089d957ef9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true,"virtualFunctionId":null,"macAddress":"2F-FC-34-AE-9C-2A","ipAddresses":["200.32.11.190"],"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"infinibandInterfaces":[{"id":"c518a0e8-3f49-4a1a-8935-a6d3dee6911e","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","partitionId":"550e8400-e29b-41d4-a716-446655440000","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"3cc0206e-8ac9-4572-8f72-e1dd124c4351","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","partitionId":"6ba7b810-9dad-11d1-80b4-00c04fd430c8","device":"MT2910 Family [ConnectX-7]","deviceInstance":1,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"84a2cf1e-73fc-42f4-974e-33a4e9889eb9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","partitionId":"8b05d5c3-8de4-48c8-8d1c-399a8abc3ab8","device":"MT2910 Family [ConnectX-7]","deviceInstance":2,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"dpuExtensionServiceDeployments":[{"id":"3951ec37-d78f-4ad7-92e1-3fdc76ccf246","dpuExtensionService":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"busybox","serviceType":"KubernetesPod","latestVersion":"V1-T1761856992374052","status":"Ready"},"version":"V1-T1761856992374052","status":"Running","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"60d3ad40-62c6-44ca-b6b1-74bc6dd04f1c","dpuExtensionService":{"id":"cd4a8168-c206-430a-9a4b-bf7dbbac3b40","name":"openssh-server","serviceType":"KubernetesPod","latestVersion":"V1-T1762294647497908","status":"Ready"},"version":"V1-T1762294647497908","status":"Running","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"tpmEkCertificate":"LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUMxVENDQWJ5Z0F3SUJBZ0lVTEE1ZHFPK1E5OXZQM3VYRTRKcjBncVRtOW93d0RRWUpLb1pJaHZjTkFRRUwKQlFBd0xqRUxNQWtHQTFVRUJoTUNWVk14RXpBUkJnTlZCQW9NQ2s1MmFXUnBZU0JEYjNKNw==","status":"Rebooting","statusHistory":[{"status":"Rebooting","message":"Reboot request received, processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"status":"Provisioning","message":"Instance is being provisioned on Site","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"attribute":"sshkeygroups","replacedBy":"sshKeyGroups","takeActionBy":"2025-09-04T00:00:00Z","notice":"'sshkeygroups' is being deprecated in favor of 'sshKeyGroups'. Please take action prior to the specified date."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Update an Instance by ID\n\nOrg must have a Tenant entity. Instance must belong to Tenant. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstanceUpdateRequest"},"examples":{"example-1":{"value":{"name":"spark-monitor-1","description":"Spark Monitor Node 1","triggerReboot":true,"rebootWithCustomIpxe":true,"applyUpdatesOnReboot":true,"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"],"labels":{"region":"portland","env":"staging"},"interfaces":[{"vpcPrefixId":"1f492faa-2963-4f21-aab5-9f00b2e40119","device":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceInstance":0,"virtualFunctionId":null,"isPhysical":true},{"vpcPrefixId":"1f3677dd-5794-4e57-b9b0-aebaf49b84fe","device":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceInstance":0,"virtualFunctionId":1,"isPhysical":false},{"vpcPrefixId":"29e6f51b-145c-4f89-8c26-accaa8328398","device":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceInstance":0,"virtualFunctionId":2,"isPhysical":false}],"infinibandInterfaces":[{"partitionId":"550e8400-e29b-41d4-a716-446655440000","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true},{"partitionId":"6ba7b810-9dad-11d1-80b4-00c04fd430c8","device":"MT2910 Family [ConnectX-7]","deviceInstance":1,"isPhysical":false},{"partitionId":"8b05d5c3-8de4-48c8-8d1c-399a8abc3ab8","device":"MT2910 Family [ConnectX-7]","deviceInstance":2,"isPhysical":false}],"nvLinkInterfaces":[{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":0},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":1},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":2},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":3}],"dpuExtensionServiceDeployments":[{"dpuExtensionServiceId":"3bddb7b4-0963-4278-b311-c212dc758357","version":"V1-T1761856992374052"},{"dpuExtensionServiceId":"cd4a8168-c206-430a-9a4b-bf7dbbac3b40","version":"V1-T1762294647497908"}]}}}}},"description":""},"tags":["Instance"]}},"/v2/org/{org}/nico/instance/{instanceId}/status-history":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"instanceId","in":"path","required":true,"description":"ID of the Instance"}],"get":{"summary":"Retrieve Instance status history","tags":["Instance"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"examples":{"Example 1":{"value":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-instance-status-history","description":"Get Instance status history\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n","parameters":[{"schema":{"type":"integer"},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer"},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string"},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/instance/{instanceId}/interface":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"instanceId","in":"path","required":true,"description":"ID of the Instance"}],"get":{"summary":"Retrieve all Interfaces","tags":["Instance"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Interface"}},"examples":{"Example 1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true,"virtualFunctionId":null,"macAddress":"2F-FC-34-AE-9C-2A","ipAddresses":["200.32.11.190"],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"d57b373a-5a59-4fa4-b080-50e9a1095aeb","vpcPrefixId":"26be5f71-3d51-487b-a940-6513c7725cfd","isPhysical":true,"virtualFunctionId":null,"macAddress":"2F-FC-34-AE-9C-2A","ipAddresses":["200.32.11.190"],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-interface","description":"Get all Interfaces for an Instance\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Interfaces by Status"},{"schema":{"type":"string","enum":["Instance","Subnet"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/instance/{instanceId}/infiniband-interface":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"instanceId","in":"path","required":true,"description":"ID of the Instance"}],"get":{"summary":"Retrieve all Instance InfiniBand Interfaces","tags":["Instance"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InfiniBandInterface"}},"examples":{"Example 1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","partitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Provisioning","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"c518a0e8-3f49-4a1a-8935-a6d3dee6911e","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","partitionId":"6ba7b810-9dad-11d1-80b4-00c04fd430c8","device":"MT2910 Family [ConnectX-7]","deviceInstance":1,"isPhysical":false,"virtualFunctionId":1,"guid":"946dae0300339499","status":"Provisioning","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-instance-infiniband-interface","description":"Get all InfiniBand Interfaces for an Instance\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter InfiniBand Interfaces by Status"},{"schema":{"type":"string","enum":["Instance","InfiniBandPartition"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/instance/{instanceId}/nvlink-interface":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"instanceId","in":"path","required":true,"description":"ID of the Instance"}],"get":{"summary":"Retrieve all Instance NVLink Interfaces","tags":["Instance"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NVLinkInterface"}},"examples":{"Example 1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","nvLinkLogicalPartitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","nvLinkDomainId":"4b145552-0d8f-45ff-b652-eed105f93e50","deviceInstance":0,"gpuGuid":"5108732638879268442","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"8a7c3b21-1ffc-4c78-9a00-2a6f3859d099","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","nvLinkLogicalPartitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","nvLinkDomainId":"4b145552-0d8f-45ff-b652-eed105f93e50","deviceInstance":1,"gpuGuid":"5108732638879268443","status":"Provisioning","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-instance-nvlink-interface","description":"Get all NVLink Interfaces for an Instance\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter NVLink Interfaces by Status. Can be specified multiple times to filter on more than one status."},{"schema":{"type":"string","enum":["Instance","NVLinkLogicalPartition"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/infiniband-interface":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all InfiniBand Interfaces","tags":["InfiniBand Partition"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InfiniBandInterface"}},"examples":{"Example 1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","partitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-infiniband-interface","description":"Get all InfiniBand Interfaces\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"siteId","description":"Filter InfiniBand Interfaces by Site ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string"},"in":"query","name":"instanceId","description":"Filter InfiniBand Interfaces by Instance ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string"},"in":"query","name":"infinibandPartitionId","description":"Filter InfiniBand Interfaces by InfiniBand Partition ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter InfiniBand Interfaces by Status. Can be specified multiple times to filter on more than one status."},{"schema":{"type":"string","enum":["Instance","InfiniBandPartition","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/nvlink-interface":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the NGC Org"}],"get":{"summary":"Retrieve all NVLink Interfaces","tags":["NVLink Logical Partition"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NVLinkInterface"}},"examples":{"Example 1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","nvLinkLogicalPartitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","nvLinkDomainId":"4b145552-0d8f-45ff-b652-eed105f93e50","deviceInstance":0,"gpuGuid":"5108732638879268442","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-nvlink-interface","description":"Get all NVLink Interfaces\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter NVLink Interfaces by Status. Can be specified multiple times to filter on more than one status."},{"schema":{"type":"string"},"in":"query","name":"siteId","description":"Filter NVLink Interfaces by Site ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string"},"in":"query","name":"instanceId","description":"Filter NVLink Interfaces by Instance ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string"},"in":"query","name":"nvLinkLogicalPartitionId","description":"Filter NVLink Interfaces by NVLink Logical Partition ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string"},"in":"query","name":"nvLinkDomainId","description":"Filter NVLink Interfaces by NVLink Domain ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string","enum":["Instance","NVLinkLogicalPartition"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/operating-system":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Operating Systems","tags":["Operating System"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OperatingSystem"}},"examples":{"example-1":{"value":[{"id":"42b0f982-5c61-4d2f-a018-41ece61f4641","name":"debian-12-amd64","description":"Official Debian 12 for AMD/Intel","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","type":"Image","imageUrl":"https://saimei.ftp.acc.umu.se/images/cloud/bookworm/latest/debian-12-generic-amd64.qcow2","imageSha":"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae","imageAuthType":"Bearer","imageAuthToken":"acbd18db4cc2f85cedef654fccc4a4d8","imageDisk":"/dev/sda","rootFsId":"6c2ac315-3040-4728-94eb-b66d320206c1","ipxeScript":null,"userData":null,"isCloudInit":true,"phoneHomeEnabled":false,"allowOverride":false,"siteAssociations":[{"site":{"id":"4b36152c-f48d-4bcc-a722-0fd8e2ad209a","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"site":{"id":"219b7913-4494-4589-940e-e78ca879b302","name":"sc-west-4","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":false,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"isActive":true,"deactivationNote":null,"status":"Syncing","statusHistory":[{"status":"Syncing","message":"received Operating System creation request, syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]},"example-2":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"ubuntu-22.04","description":"Ubuntu 22.04","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","type":"iPXE","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports","isCloudInit":true,"phoneHomeEnabled":false,"allowOverride":false,"imageAuthToken":null,"imageAuthType":null,"imageDisk":null,"imageSha":null,"imageUrl":null,"rootFsId":null,"rootFsLabel":null,"isActive":true,"deactivationNote":null,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-operating-system","description":"Get an Operating System by ID\n\nIf the Operating System has `infrastructureProviderId` set, then org must have an Infrastructure Provider entity and its ID should match the Operating System Infrastructure Provider ID. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nIf the Operating System has `tenantId` set, then org must have a Tenant entity and its ID should match the Operating System Tenant ID. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"siteId","description":"Filter Operating Systems by Site ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"string","enum":["Image","iPXE"]},"in":"query","name":"type","description":"Filter Operating Systems by Type"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Operating Systems by Status.  Can be specified multiple times to filter on more than one status."},{"schema":{"type":"string"},"in":"query","name":"query","description":"Provide query to search for matches. Input will be matched against name, description and status fields"},{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create Operating System","operationId":"create-operating-system","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatingSystem"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"ubuntu-22.04","description":"Ubuntu 22.04","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","type":"iPXE","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports","isCloudInit":true,"phoneHomeEnabled":false,"allowOverride":false,"imageAuthToken":null,"imageAuthType":null,"imageDisk":null,"imageSha":null,"imageUrl":null,"rootFsId":null,"rootFsLabel":null,"siteAssociations":[],"isActive":true,"deactivationNote":null,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an Operating System for the org.\n\nEither `infrastructureProviderId` or `tenantId` must be provided in request data. Both cannot be provided at the same time.\n\nIf `infrastructureProviderId` is provided in request data, then org must have an Infrastructure Provider entity and its ID should match the query param value. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nIf `tenantId` is provided in request data, then org must have a Tenant entity and its ID should match the query param value. User must have authorization role with `TENANT_ADMIN` suffix.\n\nOnly Tenants are allowed to create Operating System for MVP.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatingSystemCreateRequest"},"examples":{"example-1":{"value":{"name":"ubuntu-official-22.04","description":"Official Ubuntu 22.04","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports","isCloudInit":true,"phoneHomeEnabled":true,"allowOverride":false}},"example-2":{"value":{"name":"debian-12-amd64","description":"Official Debian 12 for AMD/Intel","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","siteIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"imageUrl":"https://saimei.ftp.acc.umu.se/images/cloud/bookworm/latest/debian-12-generic-amd64.qcow2","imageSha":"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae","imageAuthType":"Bearer","imageAuthToken":"acbd18db4cc2f85cedef654fccc4a4d8","imageDisk":"/dev/sda","rootFsId":"6c2ac315-3040-4728-94eb-b66d320206c1","rootFsLabel":null,"userData":null,"isCloudInit":true,"phoneHomeEnabled":false,"allowOverride":false}}}}}},"tags":["Operating System"]}},"/v2/org/{org}/nico/operating-system/{operatingSystemId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"operatingSystemId","in":"path","required":true,"description":"ID of the Operating System"}],"get":{"summary":"Retrieve Operating System","tags":["Operating System"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatingSystem"},"examples":{"Image Based OS":{"value":{"id":"42b0f982-5c61-4d2f-a018-41ece61f4641","name":"debian-12-amd64","description":"Official Debian 12 for AMD/Intel","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","type":"Image","imageUrl":"https://saimei.ftp.acc.umu.se/images/cloud/bookworm/latest/debian-12-generic-amd64.qcow2","imageSha":"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae","imageAuthType":"Bearer","imageAuthToken":"acbd18db4cc2f85cedef654fccc4a4d8","imageDisk":"/dev/sda","rootFsId":"6c2ac315-3040-4728-94eb-b66d320206c1","rootFsLabel":null,"ipxeScript":null,"userData":null,"isCloudInit":true,"phoneHomeEnabled":false,"allowOverride":false,"siteAssociations":[{"site":{"id":"4b36152c-f48d-4bcc-a722-0fd8e2ad209a","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"site":{"id":"219b7913-4494-4589-940e-e78ca879b302","name":"sc-west-4","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":false,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"isActive":true,"deactivationNote":null,"status":"Syncing","statusHistory":[{"status":"Syncing","message":"received Operating System creation request, syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}},"iPXE OS":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"ubuntu-22.04","description":"Ubuntu 22.04","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","type":"iPXE","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports","isCloudInit":true,"phoneHomeEnabled":false,"allowOverride":false,"imageAuthToken":null,"imageAuthType":null,"imageDisk":null,"imageSha":null,"imageUrl":null,"rootFsId":null,"rootFsLabel":null,"siteAssociations":[],"isActive":true,"deactivationNote":null,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-operating-system","description":"Get an Operating System by ID\n\nIf the Operating System has `infrastructureProviderId` set, then org must have an Infrastructure Provider entity and its ID should match the Operating System Infrastructure Provider ID. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nIf the Operating System has `tenantId` set, then org must have a Tenant entity and its ID should match the Operating System Tenant ID. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","enum":["InfrastructureProvider","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}]},"delete":{"summary":"Delete Operating System","operationId":"delete-operating-system","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete an Operating System by ID\n\nIf the Operating System has `infrastructureProviderId` set, then org must have an Infrastructure Provider entity and its ID should match the Operating System Infrastructure Provider ID. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nIf the Operating System has `tenantId` set, then org must have a Tenant entity and its ID should match the Operating System Tenant ID. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["Operating System"]},"patch":{"summary":"Update Operating System","operationId":"update-operating-system","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatingSystem"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"ubuntu-22.04-lts","description":"Ubuntu 22.04 LTS","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","type":"iPXE","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports","isCloudInit":true,"allowOverride":true,"phoneHomeEnabled":true,"imageAuthToken":null,"imageAuthType":null,"imageDisk":null,"imageSha":null,"imageUrl":null,"rootFsId":null,"rootFsLabel":null,"siteAssociations":[],"isActive":true,"deactivationNote":null,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Update an Operating System by ID\n\nIf the Operating System has `infrastructureProviderId` set, then org must have an Infrastructure Provider entity and its ID should match the Operating System Infrastructure Provider ID. User must have authorization role with `PROVIDER_ADMIN` suffix. Provider must own the Operating System.\n\nIf the Operating System has `tenantId` set, then org must have a Tenant entity and its ID should match the Operating System Tenant ID. User must have authorization role with `TENANT_ADMIN` suffix. Tenant must own the Operating System.","tags":["Operating System"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatingSystemUpdateRequest"},"examples":{"example-1":{"value":{"name":"ubuntu-22.04-lts","description":"Ubuntu 22.04 LTS","allowOverride":true}}}}}}}},"/v2/org/{org}/nico/machine":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Machines","tags":["Machine"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Machine"}},"examples":{"example-1":{"value":[{"id":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":null,"instanceId":null,"tenantId":null,"controllerMachineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerMachineType":"x86_64","hwSkuDeviceType":"cpu","vendor":"Lenovo","productName":"ThinkSystem SR670 V2","serialNumber":"J1060ACR.D3KS2CS001G","machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4}],"machineInterfaces":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerInterfaceId":"ad3dac49-741d-4c1f-815c-c020127c532f","controllerSegmentId":"f2207a3c-1847-42e5-bf2c-cd015f87a2bc","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","hostname":"example.com","isPrimary":true,"macAddress":"00:00:5e:00:53:af","ipAddresses":["192.156.7.23","202.88.37.112"],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"maintenanceMessage":null,"health":{"source":"aggregate-host-health","observedAt":null,"successes":[{"id":"BgpDaemonEnabled","target":null},{"id":"BgpStats","target":null},{"id":"DhcpServer","target":null},{"id":"DpuDiskUtilizationCheck","target":null},{"id":"FanSpeed","target":"System Board Fan1A"},{"id":"PowerSupply","target":"PS1 Status"},{"id":"Temperature","target":"CPU1 Temp"},{"id":"Temperature","target":"System Board Exhaust Temp"},{"id":"Voltage","target":"CPU1 1P8 PG"}],"alerts":[]},"labels":{"RackIdentifier":"GVX11F01C02","ServerName":"SITE1-C03-Server-02"},"status":"Ready","isUsableByTenant":true,"statusHistory":[{"status":"Ready","message":"Machine is online and ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-machine","description":"Get all Machines for Infrastructure Provider.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n","parameters":[{"schema":{"type":"string"},"in":"query","name":"siteId","description":"Filter Machines by Site ID"},{"schema":{"type":"string"},"in":"query","name":"id","description":"Filter Machines by ID.  Can be specified multiple times to filter on more than one ID."},{"schema":{"type":"boolean"},"in":"query","name":"hasInstanceType","description":"Filter Machines that have been assigned an Instance Type."},{"schema":{"type":"string"},"in":"query","name":"instanceTypeId","description":"Filter Machines by Instance Type ID.  Can be specified multiple times to filter on more than one Instance Type ID."},{"schema":{"type":"string"},"in":"query","name":"tenantId","description":"Filter Machines by ID of tenant of assigned instance. Can be specified multiple times to filter on more than one Tenant ID."},{"schema":{"type":"boolean"},"in":"query","name":"hasInstance","description":"Filter Machines that are assigned to an Instance. siteId must be specified when using this param."},{"schema":{"type":"boolean"},"in":"query","name":"isMissingOnSite","description":"Filter Machines that are missing on Site."},{"schema":{"type":"boolean"},"in":"query","name":"includeMetadata","description":"Include Machine metadata e.g. BMC, DPU, GPU and Interface data. Can only be requested by Provider."},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Machines by Status.  Can be specified multiple times to filter on more than one Status."},{"schema":{"type":"string"},"in":"query","name":"capabilityType","description":"Filter Machines by Capability Type"},{"schema":{"type":"string"},"in":"query","name":"capabilityName","description":"Filter Machines by Capability Name.  Can be specified multiple times to filter on more than one Capability Name."},{"schema":{"type":"string"},"in":"query","name":"hwSkuDeviceType","description":"Filter Machines by hardware SKU Device Type. Example values: \"gpu\", \"cpu\", \"storage\", \"cache\""},{"schema":{"type":"string"},"in":"query","name":"query","description":"Provide query to search for matches. Input will be matched against Machine ID, vendor, product name, hostname and status"},{"schema":{"type":"string","enum":["InfrastructureProvider","Site","InstanceType"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC","ID_ASC","ID_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/machine/{machineId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"machineId","in":"path","required":true,"description":"ID of the Machine"}],"get":{"summary":"Retrieve a Machine","tags":["Machine"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Machine"},"examples":{"Without Metadata":{"value":{"id":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"2e016c02-2c67-48aa-b289-5d3ca6320c52","instanceId":"59bdaaff-3998-4fd9-a140-8749beeb605e","tenantId":"99819e6e-4017-4021-9edd-ea1bdf4dbd59","controllerMachineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerMachineType":"x86_64","hwSkuDeviceType":"cpu","vendor":"Lenovo","productName":"ThinkSystem SR670 V2","serialNumber":"J1060ACR.D3KS2CS001G","machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4},{"type":"Network","name":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","count":2,"deviceType":"DPU"},{"type":"Storage","name":"Dell Ent NVMe CM6 RI 1.92TB","capacity":"1.92TB","count":2},{"type":"GPU","name":"NVIDIA A100 PCIe","capacity":"80GB","count":2},{"type":"InfiniBand","name":"MT28908 Family [ConnectX-6]","vendor":"Mellanox Technologies","count":2}],"machineInterfaces":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerInterfaceId":"ad3dac49-741d-4c1f-815c-c020127c532f","controllerSegmentId":"f2207a3c-1847-42e5-bf2c-cd015f87a2bc","attachedDpuMachineID":"fm100dsg4ekcb4sdi6hkqn0iojhj18okrr8vct64luh8957lfe8e69vme20,","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","hostname":"example.com","isPrimary":true,"macAddress":"00:00:5e:00:53:af","ipAddresses":["192.156.7.23","202.88.37.112"],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"maintenanceMessage":null,"health":{"source":"aggregate-host-health","observedAt":null,"successes":[{"id":"BgpDaemonEnabled","target":null},{"id":"BgpStats","target":null},{"id":"DhcpServer","target":null},{"id":"DpuDiskUtilizationCheck","target":null},{"id":"FanSpeed","target":"System Board Fan1A"},{"id":"PowerSupply","target":"PS1 Status"},{"id":"Temperature","target":"CPU1 Temp"},{"id":"Temperature","target":"System Board Exhaust Temp"},{"id":"Voltage","target":"CPU1 1P8 PG"}],"alerts":[]},"labels":{"RackIdentifier":"GVX11F01C02","ServerName":"SITE1-C03-Server-02"},"status":"Ready","isUsableByTenant":true,"statusHistory":[{"status":"Ready","message":"Machine is online and ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}},"With Metadata":{"value":{"id":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"2e016c02-2c67-48aa-b289-5d3ca6320c52","instanceId":"59bdaaff-3998-4fd9-a140-8749beeb605e","tenantId":"99819e6e-4017-4021-9edd-ea1bdf4dbd59","controllerMachineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerMachineType":"x86_64","hwSkuDeviceType":"cpu","vendor":"Lenovo","productName":"ThinkSystem SR670 V2","serialNumber":"J1060ACR.D3KS2CS001G","machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4},{"type":"Network","name":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","count":2,"deviceType":"DPU"},{"type":"Storage","name":"Dell Ent NVMe CM6 RI 1.92TB","capacity":"1.92TB","count":2,"deviceType":"DPU"},{"type":"GPU","name":"NVIDIA A100 PCIe","capacity":"80GB","count":2},{"type":"InfiniBand","name":"MT28908 Family [ConnectX-6]","vendor":"Mellanox Technologies","count":2}],"machineInterfaces":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerInterfaceId":"ad3dac49-741d-4c1f-815c-c020127c532f","controllerSegmentId":"f2207a3c-1847-42e5-bf2c-cd015f87a2bc","attachedDpuMachineID":"fm100dsg4ekcb4sdi6hkqn0iojhj18okrr8vct64luh8957lfe8e69vme20,","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","hostname":"example.com","isPrimary":true,"macAddress":"00:00:5e:00:53:af","ipAddresses":["192.156.7.23","202.88.37.112"],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"maintenanceMessage":null,"labels":{"RackIdentifier":"GVX11F01C02","ServerName":"SITE1-C03-Server-02"},"health":{"source":"aggregate-host-health","observedAt":null,"successes":[{"id":"BgpDaemonEnabled","target":null},{"id":"BgpStats","target":null},{"id":"DhcpServer","target":null},{"id":"DpuDiskUtilizationCheck","target":null},{"id":"FanSpeed","target":"System Board Fan1A"},{"id":"PowerSupply","target":"PS1 Status"},{"id":"Temperature","target":"CPU1 Temp"},{"id":"Temperature","target":"System Board Exhaust Temp"},{"id":"Voltage","target":"CPU1 1P8 PG"}],"alerts":[]},"metadata":{"dmiData":{"boardName":"7Z23CTOLWB","boardSerial":".C1KS2CS002G.","boardVersion":"06","biosDate":"03/30/2023","biosVersion":"U8E122J-1.51","productSerial":"J1050ACR","chassisSerial":"J1050ACR"},"bmcInfo":{"ip":"10.217.133.5","mac":"C8:4B:D6:7A:C9:8A","version":"1","firmwareRevision":"6.00"},"gpus":[{"name":"NVIDIA H100 PCIe","serial":"1654422006434","driverVersion":"530.30.02s","vbiosVersion":"96.00.30.00.01","inforomVersion":"1010.0200.00.02","totalMemory":"81559 MiB","frequency":"1755 MHz","pciBusId":"00000000:17:00.0"}],"networkInterfaces":[{"macAddress":"c8:4b:d6:7b:ac:a8","vendor":"Broadcom Inc. and subsidiaries","device":"NetXtreme BCM5720 Gigabit Ethernet PCIe (PowerEdge Rx5xx LOM Board)","path":"/devices/pci0000:00/0000:00:1c.5/0000:04:00.0/net/eno8303","numaNode":0,"description":"NetXtreme BCM5720 Gigabit Ethernet PCIe (PowerEdge Rx5xx LOM Board)","slot":"0000:04:00.0"}],"infinibandInterfaces":[{"guid":"1070fd0300bd43ac","vendor":"Mellanox Technologies","device":"MT28908 Family [ConnectX-6]","path":"/devices/pci0000:c9/0000:c9:02.0/0000:ca:00.0/infiniband/ibp202s0f0","numaNode":1,"description":"MT28908 Family [ConnectX-6]","slot":"0000:ca:00.0"}]},"status":"Ready","isUsableByTenant":true,"statusHistory":[{"status":"Ready","message":"Machine is online and ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}},"With Machine Health Alerts":{"value":{"id":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"2e016c02-2c67-48aa-b289-5d3ca6320c52","instanceId":"59bdaaff-3998-4fd9-a140-8749beeb605e","tenantId":"99819e6e-4017-4021-9edd-ea1bdf4dbd59","controllerMachineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerMachineType":"x86_64","hwSkuDeviceType":"cpu","vendor":"Lenovo","productName":"ThinkSystem SR670 V2","serialNumber":"J1060ACR.D3KS2CS001G","machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4},{"type":"Network","name":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","count":2,"deviceType":"DPU"},{"type":"Storage","name":"Dell Ent NVMe CM6 RI 1.92TB","capacity":"1.92TB","count":2},{"type":"GPU","name":"NVIDIA A100 PCIe","capacity":"80GB","count":2},{"type":"InfiniBand","name":"MT28908 Family [ConnectX-6]","vendor":"Mellanox Technologies","count":2}],"machineInterfaces":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerInterfaceId":"ad3dac49-741d-4c1f-815c-c020127c532f","controllerSegmentId":"f2207a3c-1847-42e5-bf2c-cd015f87a2bc","attachedDpuMachineID":"fm100dsg4ekcb4sdi6hkqn0iojhj18okrr8vct64luh8957lfe8e69vme20,","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","hostname":"example.com","isPrimary":true,"macAddress":"00:00:5e:00:53:af","ipAddresses":["192.156.7.23","202.88.37.112"],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"maintenanceMessage":null,"labels":{"RackIdentifier":"GVX11F01C02","ServerName":"SITE1-C03-Server-02"},"health":{"source":"aggregate-host-health","observedAt":"2024-10-07T18:08:46.715956831Z","successes":[{"id":"BgpDaemonEnabled","target":null},{"id":"FanSpeed","target":"System Board Fan1A"},{"id":"FanSpeed","target":"System Board Fan2A"},{"id":"FanSpeed","target":"System Board Fan3A"},{"id":"FanSpeed","target":"System Board Fan4A"},{"id":"FanSpeed","target":"System Board Fan5A"},{"id":"FanSpeed","target":"System Board Fan6A"},{"id":"FileExists","target":"/var/lib/hbn/etc/frr/daemons"},{"id":"PowerSupply","target":"PS2 Status"},{"id":"Voltage","target":"System Board PS1 PG FAIL"},{"id":"Temperature","target":"GPU Temp 2"},{"id":"Temperature","target":"CPU1 Temp"}],"alerts":[{"id":"HeartbeatTimeout","target":"hardware-health","inAlertSince":"2024-10-07T18:08:46.715149530Z","message":"","tenantMessage":"nil","classifications":["PreventAllocations","PreventHostStateChanges"]},{"id":"HeartbeatTimeout","target":"nico-dpu-agent","inAlertSince":"2024-10-07T18:08:46.716147472Z","message":"","tenantMessage":"nil","classifications":["PreventAllocations","PreventHostStateChanges"]}]},"status":"Error","isUsableByTenant":false,"statusHistory":[{"status":"Error","message":"Machine has one or more health alerts that prevent allocation","created":"2019-08-28T14:15:22Z","updated":"2019-08-28T14:15:22Z"},{"status":"Ready","message":"Machine is online and ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-machine","description":"Org must have either an Infrastructure Provider entity or a Tenant entity.\n\nIf org has an Infrastructure Provider entity, then a user with `PROVIDER_ADMIN` role can request details for any Machine on any Site owned by the Provider.\n\nIf org has a Tenant entity, then a user with `TENANT_ADMIN` role can request details for any Machine associated with Tenant's active Instances.\n","parameters":[{"schema":{"type":"string","enum":["InfrastructureProvider","Site","InstanceType"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"boolean"},"in":"query","name":"includeMetadata","description":"Include Machine metadata e.g. BMC, DPU, GPU and Interface data. Can only be requested by Provider."}]},"patch":{"summary":"Update Machine","operationId":"update-machine","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Machine"},"examples":{"Example 1":{"value":{"id":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"2e016c02-2c67-48aa-b289-5d3ca6320c52","instanceId":"59bdaaff-3998-4fd9-a140-8749beeb605e","tenantId":"99819e6e-4017-4021-9edd-ea1bdf4dbd59","controllerMachineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerMachineType":"x86_64","hwSkuDeviceType":"cpu","vendor":"Lenovo","productName":"ThinkSystem SR670 V2","serialNumber":"J1060ACR.D3KS2CS001G","machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4}],"machineInterfaces":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerInterfaceId":"ad3dac49-741d-4c1f-815c-c020127c532f","controllerSegmentId":"f2207a3c-1847-42e5-bf2c-cd015f87a2bc","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","hostname":"example.com","isPrimary":true,"macAddress":"00:00:5e:00:53:af","ipAddresses":["192.156.7.23","202.88.37.112"],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"maintenanceMessage":null,"health":{"source":"aggregate-host-health","observedAt":null,"successes":[{"id":"BgpDaemonEnabled","target":null},{"id":"BgpStats","target":null},{"id":"DhcpServer","target":null},{"id":"DpuDiskUtilizationCheck","target":null},{"id":"FanSpeed","target":"System Board Fan1A"},{"id":"PowerSupply","target":"PS1 Status"},{"id":"Temperature","target":"CPU1 Temp"},{"id":"Temperature","target":"System Board Exhaust Temp"},{"id":"Voltage","target":"CPU1 1P8 PG"}],"alerts":[]},"labels":{"RackIdentifier":"GVX11F01C02","ServerName":"SITE1-C03-Server-02"},"status":"Ready","isUsableByTenant":true,"statusHistory":[{"status":"Ready","message":"Machine is online and ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}}},"tags":["Machine"],"description":"Update a Machine\n\nInstance Type attribute updates, maintenance attribute updates and labels updates must be specified in separate requests. They cannot be processed at the same time.\n\nSome attributes can only be updated by Provider, while others can be updated by Provider or a Privileged Tenant.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MachineUpdateRequest"},"examples":{"Update Instance Type":{"value":{"instanceTypeId":"2e016c02-2c67-48aa-b289-5d3ca6320c52"}},"Clear Instance Type":{"value":{"clearInstanceType":true}},"Set Maintenance Message":{"value":{"setMaintenanceMode":true,"maintenanceMessage":"Machine requires re-cabling to connect with revised underlay network. Estimated maintenance time is 2 days"}},"Remove Maintenance Message":{"value":{"setMaintenanceMode":false}},"Update Labels":{"value":{"labels":{"RackIdentifier":"GVX11F01C02","ServerName":"SITE1-C03-Server-02","RepairStatus":"InProgress"}}}}}}}},"delete":{"tags":["Machine"],"summary":"Delete a Machine from a Site","operationId":"delete-machine","responses":{"202":{"description":"Accepted"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"description":"Describes an error response for 404 Not Found","$ref":"#/components/responses/GenericHttpError"},"422":{"description":"Describes an error response for 422 Unprocessable Content","$ref":"#/components/responses/GenericHttpError"},"500":{"description":"Describes an error response for 500 Internal Server Error","$ref":"#/components/responses/GenericHttpError"}},"description":"Org must have an Infrastructure Provider entity. Machine must belong to the Provider. User must have authorization role with `PROVIDER_ADMIN` suffix. Machine must meet certain criteria to be eligible for deletion."}},"/v2/org/{org}/nico/machine/{machineId}/status-history":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"machineId","in":"path","required":true,"description":"ID of the Machine"}],"get":{"summary":"Retrieve Machine status history","tags":["Machine"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"examples":{"Example 1":{"value":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-machine-status-history","description":"Org must have either an Infrastructure Provider entity or a Tenant entity.\n\nIf org has an Infrastructure Provider entity, then a user with `PROVIDER_ADMIN` role can request details for any Machine on any Site owned by the Provider.\n\nIf org has a Tenant entity, then a user with `TENANT_ADMIN` role can request details for any Machine associated with Tenant's active Instances.\n","parameters":[{"schema":{"type":"integer"},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer"},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string"},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/machine/gpu/stats":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve GPU stats for machines at a site","tags":["Machine"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MachineGPUStats"}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-machine-gpu-stats","description":"Returns GPU summary stats grouped by GPU name for machines at the specified site.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix. The specified site must belong to the Provider.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","required":true,"description":"ID of the Site"}]}},"/v2/org/{org}/nico/machine/instance-type/stats/summary":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve machine instance type assignment summary for a site","tags":["Machine"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MachineInstanceTypeSummary"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-machine-instance-type-stats-summary","description":"Returns machine counts grouped by assigned (has instance type) vs unassigned, broken down by status.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix. The specified site must belong to the Provider.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","required":true,"description":"ID of the Site"}]}},"/v2/org/{org}/nico/machine/instance-type/stats":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve detailed per-instance-type machine stats for a site","tags":["Machine"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MachineInstanceTypeStats"}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-machine-instance-type-stats","description":"Returns machine stats for each instance type including allocation details and tenant breakdown.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix. The specified site must belong to the Provider.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","required":true,"description":"ID of the Site"}]}},"/v2/org/{org}/nico/tenant/instance-type/stats":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve per-tenant instance type allocation stats for a site","tags":["Tenant"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TenantInstanceTypeStats"}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-tenant-instance-type-stats","description":"Returns instance type allocation stats grouped by tenant for the specified site.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix. The specified site must belong to the Provider.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","required":true,"description":"ID of the Site"}]}},"/v2/org/{org}/nico/machine-capability":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Machine Capabilities","tags":["Machine"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MachineCapability"}},"examples":{"Example 1":{"value":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","cores":18,"threads":36,"count":2},{"name":"Intel(R) Xeon(R) Platinum 8362 CPU @ 2.80GHz","cores":32,"threads":64,"count":2},{"type":"Network","name":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","count":2},{"type":"Storage","name":"Dell Ent NVMe v2 AGN RI U.2 1.92TB","capacity":"1.92TB","count":2},{"type":"Storage","name":"Dell Ent NVMe CM6 RI 1.92TB","capacity":"1.92TB","count":2},{"type":"InfiniBand","name":"MT28908 Family [ConnectX-6]","vendor":"Mellanox Technologies","count":2}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-machine-capabilities","description":"Get all distinct Machine Capabilities across all Machines\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n","parameters":[{"schema":{"type":"string"},"in":"query","name":"siteId","description":"Filter Capabilities by Machines from a particular Site","required":true},{"schema":{"type":"boolean"},"in":"query","name":"hasInstanceType","description":"Filter Capabilities by Machines that have an Instance Type"},{"schema":{"type":"string"},"in":"query","name":"type","description":"Filter Capabilities by Type"},{"schema":{"type":"string"},"in":"query","name":"name","description":"Filter Capabilities by Name"},{"schema":{"type":"string"},"in":"query","name":"frequency","description":"Filter Capabilities by Frequency value"},{"schema":{"type":"string"},"in":"query","name":"capacity","description":"Filter Capabilities by Capacity value"},{"schema":{"type":"string"},"in":"query","name":"vendor","description":"Filter Capabilities by Vendor"},{"schema":{"type":"string"},"in":"query","name":"inactiveDevices","description":"Filter Capabilities by Inactive Devices value. Since the value is an array, multiple query params should be specified in correct order in order to filter. For example, to filter for [1, 3], specify inactiveDevices=1&inactiveDevices=3"},{"schema":{"type":"string"},"in":"query","name":"count","description":"Filter Capabilities by Count"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/rack":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Racks","operationId":"get-all-rack","description":"Get all Racks for the specified Site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site to retrieve Racks from"},{"schema":{"type":"boolean"},"in":"query","name":"includeComponents","description":"Include rack components in response"},{"schema":{"type":"string"},"in":"query","name":"name","description":"Filter by rack name"},{"schema":{"type":"string"},"in":"query","name":"manufacturer","description":"Filter by manufacturer"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","MANUFACTURER_ASC","MANUFACTURER_DESC","MODEL_ASC","MODEL_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Rack"}},"examples":{"example-1":{"value":[{"id":"550e8400-e29b-41d4-a716-446655440000","name":"Rack-01","manufacturer":"Dell","model":"PowerEdge R750","serialNumber":"SN-RACK-001","description":"Primary compute rack","location":{"region":"us-east-1","datacenter":"DC-01","room":"Room-A","position":"A1"},"components":[{"id":"660e8400-e29b-41d4-a716-446655440001","componentId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","type":"ComponentTypeCompute","name":"Server-01","serialNumber":"SN-SRV-001","manufacturer":"Dell","firmwareVersion":"2.1.0","slotId":1,"trayIdx":0,"hostId":0,"bmcs":[{"type":"BmcTypeHost","macAddress":"AA:BB:CC:DD:EE:01","ipAddress":"10.0.0.101"}],"powerState":"on"}]}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\":\"NAME_ASC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/{id}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Rack"}],"get":{"summary":"Retrieve a Rack","operationId":"get-rack","description":"Get a Rack by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site"},{"schema":{"type":"boolean"},"in":"query","name":"includeComponents","description":"Include rack components in response"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Rack"},"examples":{"example-1":{"value":{"id":"550e8400-e29b-41d4-a716-446655440000","name":"Rack-01","manufacturer":"Dell","model":"PowerEdge R750","serialNumber":"SN-RACK-001","description":"Primary compute rack","location":{"region":"us-east-1","datacenter":"DC-01","room":"Room-A","position":"A1"},"components":[{"id":"660e8400-e29b-41d4-a716-446655440001","componentId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","type":"ComponentTypeCompute","name":"Server-01","serialNumber":"SN-SRV-001","manufacturer":"Dell","firmwareVersion":"2.1.0","slotId":1,"trayIdx":0,"hostId":0,"bmcs":[{"type":"BmcTypeHost","macAddress":"AA:BB:CC:DD:EE:01","ipAddress":"10.0.0.101"}],"powerState":"on"}]}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/validation":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Validate Racks","operationId":"validate-racks","description":"Validate Rack components by comparing expected vs actual state.\n\nIf no filter is specified, validates all racks in the Site. Filters can narrow the scope to specific racks by name or manufacturer.\n\nCompares the expected component configuration against the actual state. Returns a detailed diff report showing missing, extra, and mismatched components.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site"},{"schema":{"type":"string"},"name":"name","in":"query","required":false,"description":"Filter racks by name"},{"schema":{"type":"string"},"name":"manufacturer","in":"query","required":false,"description":"Filter racks by manufacturer"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RackValidationResult"},"examples":{"example-no-diffs":{"value":{"diffs":[],"totalDiffs":0,"missingCount":0,"unexpectedCount":0,"mismatchCount":0,"matchCount":10}},"example-with-diffs":{"value":{"diffs":[{"type":"Missing","id":"660e8400-e29b-41d4-a716-446655440001","componentId":"comp-1","expected":{"id":"660e8400-e29b-41d4-a716-446655440001","componentId":"comp-1","type":"ComponentTypeCompute","name":"Server-01","serialNumber":"SN-SRV-001","manufacturer":"Dell","firmwareVersion":"2.1.0","slotId":1,"trayIdx":0,"hostId":0,"bmcs":[{"type":"BmcTypeHost","macAddress":"AA:BB:CC:DD:EE:01","ipAddress":"10.0.0.101"}],"powerState":"on"}},{"type":"Mismatch","id":"770e8400-e29b-41d4-a716-446655440002","componentId":"comp-2","fieldDiffs":[{"fieldName":"firmware_version","expectedValue":"1.0.0","actualValue":"2.0.0"}]}],"totalDiffs":2,"missingCount":1,"unexpectedCount":0,"mismatchCount":1,"matchCount":8}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/{id}/validation":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Rack"}],"get":{"summary":"Validate a Rack","operationId":"validate-rack","description":"Validate a Rack's components by comparing expected vs actual state.\n\nCompares the rack's expected component configuration against the actual state. Returns a detailed diff report showing missing, extra, and mismatched components.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RackValidationResult"},"examples":{"example-no-diffs":{"value":{"diffs":[],"totalDiffs":0,"missingCount":0,"unexpectedCount":0,"mismatchCount":0,"matchCount":5}},"example-with-diffs":{"value":{"diffs":[{"type":"Missing","id":"660e8400-e29b-41d4-a716-446655440001","componentId":"comp-1","expected":{"id":"660e8400-e29b-41d4-a716-446655440001","componentId":"comp-1","type":"ComponentTypeCompute","name":"Server-01","serialNumber":"SN-SRV-001","manufacturer":"Dell","firmwareVersion":"2.1.0","slotId":1,"trayIdx":0,"hostId":0,"bmcs":[{"type":"BmcTypeHost","macAddress":"AA:BB:CC:DD:EE:01","ipAddress":"10.0.0.101"}],"powerState":"on"}},{"type":"Mismatch","id":"770e8400-e29b-41d4-a716-446655440002","componentId":"comp-2","fieldDiffs":[{"fieldName":"firmware_version","expectedValue":"1.0.0","actualValue":"2.0.0"}]}],"totalDiffs":2,"missingCount":1,"unexpectedCount":0,"mismatchCount":1,"matchCount":3}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/power":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"patch":{"summary":"Power control Racks","operationId":"power-control-racks","description":"Power control Racks with optional filters. If no filter is specified, targets all racks in the Site.\n\nSupported power states: `on`, `off`, `cycle`, `forceoff`, `forcecycle`.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchUpdateRackPowerStateRequest"},"examples":{"power-off-all":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"off"}},"power-on-filtered":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","filter":{"names":["Rack-001","Rack-002"]},"state":"on"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePowerStateResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000","660e8400-e29b-41d4-a716-446655440001"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/{id}/power":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Rack"}],"patch":{"summary":"Power control a Rack","operationId":"power-control-rack","description":"Power control a Rack identified by Rack UUID.\n\nSupported power states: `on`, `off`, `cycle`, `forceoff`, `forcecycle`.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePowerStateRequest"},"examples":{"power-on":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"on"}},"power-cycle":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"cycle"}},"force-cycle":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"forcecycle"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePowerStateResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/firmware":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"patch":{"summary":"Firmware update Racks","operationId":"firmware-update-racks","description":"Update firmware on Racks with optional name filter. If no filter is specified, targets all racks in the Site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchRackFirmwareUpdateRequest"},"examples":{"all-racks-latest":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000"}},"filtered-with-version":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","filter":{"names":["Rack-001"]},"version":"24.11.0"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirmwareUpdateResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000","660e8400-e29b-41d4-a716-446655440001"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/{id}/firmware":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Rack"}],"patch":{"summary":"Firmware update a Rack","operationId":"firmware-update-rack","description":"Update firmware on a Rack identified by Rack UUID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirmwareUpdateRequest"},"examples":{"with-version":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","version":"24.11.0"}},"without-version":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirmwareUpdateResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/bringup":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Bring up Racks","operationId":"bringup-racks","description":"Bring up Racks with optional name filter. If no filter is specified, targets all racks in the Site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchBringUpRackRequest"},"examples":{"all-racks":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000"}},"filtered":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","filter":{"names":["Rack-001"]},"description":"Bring up Rack-001"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BringUpRackResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000","660e8400-e29b-41d4-a716-446655440001"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/{id}/bringup":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Rack"}],"post":{"summary":"Bring up a Rack","operationId":"bringup-rack","description":"Bring up a Rack identified by Rack UUID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BringUpRackRequest"},"examples":{"basic":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000"}},"with-description":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","description":"Initial bring up for production rack"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BringUpRackResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/task/{id}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"UUID of the Task"}],"get":{"summary":"Retrieve a Task","operationId":"get-rack-task","description":"Get a Task by UUID.\n\nTasks are site-scoped; `siteId` must be the Site where the task was created.\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site that owns the task (tasks are site-scoped)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RackTask"},"examples":{"example-1":{"value":{"id":"550e8400-e29b-41d4-a716-446655440000","status":"Running","description":"Power on rack components","message":"Processing 3 of 5 components"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/rack/task/{id}/cancel":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"UUID of the Task"}],"post":{"summary":"Cancel a Task","operationId":"cancel-rack-task","description":"Cancel a Task.\n\nCancellation is best-effort and idempotent: tasks in non-terminal\nstates (`Pending`, `Running`, `Waiting`) are marked `Terminated`\nand any underlying Temporal workflow is terminated. Cancelling an\nalready-`Terminated` task returns the same task without changes.\nTasks that have already finished (`Succeeded` or `Failed`) cannot\nbe cancelled.\n\nTasks are site-scoped; `siteId` must be the Site where the task was\ncreated. Org must have an Infrastructure Provider entity. User must\nhave `FORGE_PROVIDER_ADMIN` authorization role.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site that owns the task (tasks are site-scoped)."}}},"examples":{"example-1":{"value":{"siteId":"660e8400-e29b-41d4-a716-446655440000"}}}}}},"responses":{"202":{"description":"Accepted. The cancellation request was accepted and the task as\nlast reported by Flow is returned. Clients should `GET` the task\nto observe the final state, since cancellation is best-effort\nand the underlying workflow may still be terminating.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RackTask"},"examples":{"example-1":{"value":{"id":"550e8400-e29b-41d4-a716-446655440000","status":"Terminated","description":"Power on rack components","message":"Cancelled by user"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/tray":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Trays","operationId":"get-all-tray","description":"Get all Trays (components) for the specified Site.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\n**Filter constraints:**\n- `rackId` and `rackName` are mutually exclusive\n- `rackId`/`rackName` cannot be combined with `id`/`componentId` (rack-level vs component-level targeting)\n- `componentId` requires `type` to be specified","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site to retrieve Trays from"},{"schema":{"type":"string","format":"uuid"},"name":"rackId","in":"query","description":"Filter by Rack ID"},{"schema":{"type":"string"},"name":"rackName","in":"query","description":"Filter by Rack name"},{"schema":{"type":"string","enum":["compute","switch","powershelf"]},"name":"type","in":"query","description":"Filter by tray type"},{"schema":{"type":"string"},"name":"componentId","in":"query","description":"Filter by component ID. Can be specified multiple times to filter on more than one component ID. Requires 'type' parameter."},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"query","description":"Filter by tray UUID. Can be specified multiple times to filter on more than one tray ID."},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","MANUFACTURER_ASC","MANUFACTURER_DESC","MODEL_ASC","MODEL_DESC","TYPE_ASC","TYPE_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Tray"}},"examples":{"example-1":{"value":[{"id":"660e8400-e29b-41d4-a716-446655440001","componentId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","type":"compute","name":"compute-tray-1","manufacturer":"NVIDIA","model":"GB200","serialNumber":"TSN001","description":"Compute tray in slot 1","firmwareVersion":"2.1.0","powerState":"on","position":{"slotId":1,"trayIdx":0,"hostId":1},"rackId":"550e8400-e29b-41d4-a716-446655440000"}]}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\":\"NAME_ASC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/tray/{id}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Tray"}],"get":{"summary":"Retrieve a Tray","operationId":"get-tray","description":"Get a Tray by ID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tray"},"examples":{"example-1":{"value":{"id":"660e8400-e29b-41d4-a716-446655440001","componentId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","type":"compute","name":"compute-tray-1","manufacturer":"NVIDIA","model":"GB200","serialNumber":"TSN001","description":"Compute tray in slot 1","firmwareVersion":"2.1.0","powerState":"on","position":{"slotId":1,"trayIdx":0,"hostId":1},"rackId":"550e8400-e29b-41d4-a716-446655440000"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/tray/validation":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Validate Trays","operationId":"validate-trays","description":"Validate Tray components by comparing expected vs actual state.\n\nIf no filter is specified, validates all trays in the Site. Use rackId/rackName to scope to a specific rack, and name/manufacturer/type to filter by tray attributes.\n\nCompares the expected component configuration against the actual state. Returns a detailed diff report showing missing, extra, and mismatched components.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site"},{"schema":{"type":"string","format":"uuid"},"name":"rackId","in":"query","required":false,"description":"Scope to a specific Rack by ID (mutually exclusive with rackName)"},{"schema":{"type":"string"},"name":"rackName","in":"query","required":false,"description":"Scope to a specific Rack by name (mutually exclusive with rackId)"},{"schema":{"type":"string"},"name":"name","in":"query","required":false,"description":"Filter trays by name"},{"schema":{"type":"string"},"name":"manufacturer","in":"query","required":false,"description":"Filter trays by manufacturer"},{"schema":{"type":"string","enum":["compute","switch","powershelf"]},"name":"type","in":"query","required":false,"description":"Filter trays by type"},{"schema":{"type":"string"},"name":"componentId","in":"query","required":false,"description":"Filter by external component ID (requires type; mutually exclusive with rackId/rackName; use repeated params for multiple values)"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RackValidationResult"},"examples":{"example-no-diffs":{"value":{"diffs":[],"totalDiffs":0,"missingCount":0,"unexpectedCount":0,"mismatchCount":0,"matchCount":10}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/tray/{id}/validation":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Tray"}],"get":{"summary":"Validate a Tray","operationId":"validate-tray","description":"Validate a Tray by comparing expected vs actual state.\n\nCompares the expected component configuration against the actual state. Returns a detailed diff report showing missing, extra, and mismatched components.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RackValidationResult"},"examples":{"example-no-diffs":{"value":{"diffs":[],"totalDiffs":0,"missingCount":0,"unexpectedCount":0,"mismatchCount":0,"matchCount":5}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/tray/power":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"patch":{"summary":"Power control Trays","operationId":"power-control-trays","description":"Power control Trays with optional filters. If no filter is specified, targets all trays in the Site.\n\nSupported power states: `on`, `off`, `cycle`, `forceoff`, `forcecycle`.\n\n**Filter constraints:**\n- `rackId` and `rackName` are mutually exclusive\n- `rackId`/`rackName` cannot be combined with `ids`/`componentIds` (rack-level vs component-level targeting)\n- `componentIds` requires `type` to be specified\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchUpdateTrayPowerStateRequest"},"examples":{"power-on-all":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"on"}},"power-off-by-rack":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","filter":{"rackId":"660e8400-e29b-41d4-a716-446655440001"},"state":"off"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePowerStateResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/tray/{id}/power":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Tray"}],"patch":{"summary":"Power control a Tray","operationId":"power-control-tray","description":"Power control a Tray identified by Tray UUID.\n\nSupported power states: `on`, `off`, `cycle`, `forceoff`, `forcecycle`.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePowerStateRequest"},"examples":{"power-on":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"on"}},"power-off":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"off"}},"power-cycle":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"cycle"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePowerStateResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/tray/firmware":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"patch":{"summary":"Firmware update Trays","operationId":"firmware-update-trays","description":"Update firmware on Trays with optional filters. If no filter is specified, targets all trays in the Site.\n\n**Filter constraints:**\n- `rackId` and `rackName` are mutually exclusive\n- `rackId`/`rackName` cannot be combined with `ids`/`componentIds` (rack-level vs component-level targeting)\n- `componentIds` requires `type` to be specified\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchTrayFirmwareUpdateRequest"},"examples":{"all-trays-latest":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000"}},"filtered-with-version":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","filter":{"rackId":"660e8400-e29b-41d4-a716-446655440001"},"version":"24.11.0"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirmwareUpdateResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/tray/{id}/firmware":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"id","in":"path","required":true,"description":"ID of the Tray"}],"patch":{"summary":"Firmware update a Tray","operationId":"firmware-update-tray","description":"Update firmware on a Tray identified by Tray UUID.\n\nOrg must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirmwareUpdateRequest"},"examples":{"with-version":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000","version":"24.11.0"}},"without-version":{"value":{"siteId":"550e8400-e29b-41d4-a716-446655440000"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirmwareUpdateResponse"},"examples":{"example-1":{"value":{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/network-security-group":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Network Security Groups","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NetworkSecurityGroup"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"412":{"description":"Precondition Failed"},"500":{"description":"Describes an error response for 500 Internal Server Error","$ref":"#/components/responses/GenericHttpError"},"501":{"description":"Describes an error response for 501 Not Implemented","$ref":"#/components/responses/GenericHttpError"}},"operationId":"get-all-network-security-group","description":"Get all Network Security Groups for Tenant\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"siteId","description":"Filter By Site ID"},{"schema":{"type":"string"},"in":"query","name":"status","description":"Filter Network Security Groups by Status"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description and status fields"},{"schema":{"type":"string","enum":["Tenant","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"},{"schema":{"type":"boolean"},"in":"query","name":"includeAttachmentStats","description":"Include counts for the number objects that have attached the Network Security Group"}],"tags":["Network Security Group"]},"post":{"summary":"Create Network Security Group","operationId":"create-network-security-group","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkSecurityGroup"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"description":"Describes an error response for 404 Not Found","$ref":"#/components/responses/GenericHttpError"},"412":{"description":"Describes an error response for 412 Precondition Failed","$ref":"#/components/responses/GenericHttpError"},"500":{"description":"Describes an error response for 500 Internal Server Error","$ref":"#/components/responses/GenericHttpError"},"501":{"description":"Describes an error response for 501 Not Implemented","$ref":"#/components/responses/GenericHttpError"}},"description":"Create a Network Security Group for Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkSecurityGroupCreateRequest"}}}},"tags":["Network Security Group"]}},"/v2/org/{org}/nico/network-security-group/{networkSecurityGroupId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"networkSecurityGroupId","in":"path","required":true,"description":"ID of the Network Security Group"}],"get":{"summary":"Retrieve Network Security Group","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkSecurityGroup"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"description":"Describes an error response for 404 Not Found","$ref":"#/components/responses/NotFoundError"},"500":{"description":"Describes an error response for 500 Internal Server Error","$ref":"#/components/responses/GenericHttpError"},"501":{"description":"Describes an error response for 501 Not Implemented","$ref":"#/components/responses/GenericHttpError"}},"operationId":"get-network-security-group","description":"Get a Network Security Group by ID\n\nOrg must have a Tenant entity. Instance must belong to Tenant. User must have authorization role with `TENANT_ADMIN` suffix.\n","parameters":[{"schema":{"type":"string","enum":["Tenant","Site"]},"in":"query","name":"includeRelation","description":"Related entity to expand"}],"tags":["Network Security Group"]},"patch":{"summary":"Update Network Security Group","operationId":"update-network-security-group","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkSecurityGroup"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"description":"Describes an error response for 404 Not Found","$ref":"#/components/responses/GenericHttpError"},"500":{"description":"Describes an error response for 500 Internal Server Error","$ref":"#/components/responses/GenericHttpError"},"501":{"description":"Describes an error response for 501 Not Implemented","$ref":"#/components/responses/GenericHttpError"}},"description":"Update a Network Security Group by ID\n\nOrg must have a Tenant entity. Instance must belong to Tenant. User must have authorization role with `TENANT_ADMIN` suffix.\n\nAfter a group has been created, policy updates are absolute.  The complete desired policy set must be specified.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkSecurityGroupUpdateRequest"}}}},"tags":["Network Security Group"]},"delete":{"summary":"Delete Network Security Group","operationId":"delete-network-security-group","responses":{"202":{"description":"Accepted"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"description":"Describes an error response for 403 Forbidden","$ref":"#/components/responses/GenericHttpError"},"404":{"description":"Describes an error response for 404 Not Found","$ref":"#/components/responses/GenericHttpError"},"412":{"description":"Describes an error response for 412 Precondition Failed","$ref":"#/components/responses/GenericHttpError"},"500":{"description":"Describes an error response for 500 Internal Server Error","$ref":"#/components/responses/GenericHttpError"},"501":{"description":"Describes an error response for 501 Not Implemented","$ref":"#/components/responses/GenericHttpError"}},"description":"Delete a Network Security Group by ID\n\nOrg must have a Tenant entity. Instance must belong to Tenant. User must have authorization role with `TENANT_ADMIN` suffix.\n\nDeleting a Network Security Group will also delete all the associations and all policies.","tags":["Network Security Group"]}},"/v2/org/{org}/nico/dpu-extension-service":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all DPU Extension Services","responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DpuExtensionService"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\": \"CREATED_DESC\"}"},"description":"Pagination result in JSON format"}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-dpu-extension-service","description":"Retrieve all DPU Extension Services for the current Tenant\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"siteId","description":"Filter DPU Extension Services by Site ID"},{"schema":{"type":"string","enum":["Pending","Ready","Error","Deleting"]},"in":"query","name":"status","description":"Status filter for the DPU Extension Services"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name, description and status"},{"schema":{"type":"string","enum":["Site","Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"tags":["DPU Extension Service"]},"post":{"summary":"Create DPU Extension Service","operationId":"create-dpu-extension-service","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DpuExtensionService"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create a DPU Extension Service for the current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DpuExtensionServiceCreateRequest"}}}},"tags":["DPU Extension Service"]}},"/v2/org/{org}/nico/dpu-extension-service/{dpuExtensionServiceId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"dpuExtensionServiceId","in":"path","required":true,"description":"ID of the DPU Extension Service"}],"get":{"summary":"Retrieve DPU Extension Service","operationId":"get-dpu-extension-service","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DpuExtensionService"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Retrieve a DPU Extension Service for the current Tenant by ID\n\nDPU Extension Service must be owned by current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["DPU Extension Service"]},"delete":{"summary":"Delete DPU Extension Service","operationId":"delete-dpu-extension-service","responses":{"204":{"description":"No Content"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a specific DPU Extension Service by ID. All versions will be deleted.\n\nDPU Extension Service must be owned by current Tenant. No versions of the DPU Extension Service can have active deployments.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["DPU Extension Service"]},"patch":{"summary":"Update DPU Extension Service","operationId":"update-dpu-extension-service","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DpuExtensionService"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"description":"Update a specific DPU Extension Service.\n\nDPU Extension Service must be owned by current Tenant. A new version will be created if data or credentials are modified.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DpuExtensionServiceUpdateRequest"}}}},"tags":["DPU Extension Service"]}},"/v2/org/{org}/nico/dpu-extension-service/{dpuExtensionServiceId}/version/{version}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"dpuExtensionServiceId","in":"path","required":true,"description":"ID of the DPU Extension Service"},{"schema":{"type":"string"},"name":"version","in":"path","required":true,"description":"Version of the DPU Extension Service"}],"get":{"summary":"Retrieve DPU Extension Service Version","operationId":"get-dpu-extension-service-version","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DpuExtensionServiceVersionInfo"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"description":"Retrieve details for a specific version of a DPU Extension Service.\n\nDPU Extension Service must be owned by current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["DPU Extension Service"]},"delete":{"summary":"Delete DPU Extension Service Version","operationId":"delete-dpu-extension-service-version","responses":{"204":{"description":"No Content"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a specific version of a DPU Extension Service.\n\nDPU Extension Service must be owned by current Tenant. The version being deleted cannot have active deployments.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["DPU Extension Service"]}},"/v2/org/{org}/nico/sshkeygroup":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all SSH Key Groups","responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SshKeyGroup"}},"examples":{"Example 1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","siteAssociations":[{"site":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeys":[{"id":"ff06da79-707a-4069-8623-211d49ae96c8","name":"sre-ssh-reno","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Syncing","statusHistory":[{"status":"Syncing","message":"Group is being synced to Sites","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-ssh-key-group","description":"Retrieve all SSH Key Groups for the current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string"},"in":"query","name":"siteId","description":"Filter SSH Key Groups by Site ID"},{"schema":{"type":"string"},"in":"query","name":"instanceId","description":"Filter SSH Key Groups by Instance ID"},{"schema":{"type":"string","enum":["Syncing","Synced","Error","Deleting"]},"in":"query","name":"status","description":"Status filter for the SSH Key Groups"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name field"},{"schema":{"type":"string","enum":["Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}],"tags":["SSH Key Group"]},"post":{"summary":"Create SSH Key Group","operationId":"create-ssh-key-group","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKeyGroup"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","siteAssociations":[{"site":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":true,"networkSecurityGroup":true},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeys":[{"id":"ff06da79-707a-4069-8623-211d49ae96c8","name":"sre-ssh-reno","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Syncing","statusHistory":[{"status":"Syncing","message":"Group is being synced to Sites","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Create an SSH Key Group for the current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKeyGroupCreateRequest"},"examples":{"Example 1":{"value":{"name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","siteIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyIds":["ff06da79-707a-4069-8623-211d49ae96c8"]}}}}}},"tags":["SSH Key Group"]}},"/v2/org/{org}/nico/sshkeygroup/{sshKeyGroupId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"sshKeyGroupId","in":"path","required":true,"description":"ID of the SSH Key Group"}],"get":{"summary":"Retrieve an SSH Key Group","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKeyGroup"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","siteAssociations":[{"site":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":true,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeys":[{"id":"ff06da79-707a-4069-8623-211d49ae96c8","name":"sre-ssh-reno","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Syncing","statusHistory":[{"status":"Syncing","message":"Group is being synced to Sites","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-ssh-key-group","description":"Retrieve an SSH Key Group for the current Tenant by ID\n\nSSH Key Group must be owned by current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["SSH Key Group"]},"delete":{"summary":"Delete an SSH Key Group","operationId":"delete-ssh-key-group","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a specific SSH key Group.\n\nSSH Key Group must be owned by current Tenant. All Sites associated must be online to proceed.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["SSH Key Group"]},"patch":{"summary":"Update an SSH Key Group","operationId":"update-ssh-key-group","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKeyGroup"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-int-sre","description":"SRE access SSH keys for Reno Integration Site","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","siteAssociations":[{"site":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":true,"networkSecurityGroup":true},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"site":{"id":"05d6e108-9f06-44c9-be47-7ab4d62b20d0","name":"Reno Integration","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":true,"networkSecurityGroup":true},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeys":[{"id":"ff06da79-707a-4069-8623-211d49ae96c8","name":"sre-ssh-reno","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"30fc7238-133d-42f7-8d29-866658b0c019","name":"sre-ssh-reno-ext","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Syncing","statusHistory":[{"status":"Syncing","message":"Group is being synced to Sites","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Update a specific SSH Key Group.\n\nSSH Key Group must be owned by current Tenant. All Sites being added or removed must be online to proceed.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKeyGroupUpdateRequest"},"examples":{"Example 1":{"value":{"name":"reno-int-sre","description":"SRE access SSH keys for Reno Integration Site","siteIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08","05d6e108-9f06-44c9-be47-7ab4d62b20d0"],"sshKeyIds":["ff06da79-707a-4069-8623-211d49ae96c8","30fc7238-133d-42f7-8d29-866658b0c019"],"version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75"}}}}}},"tags":["SSH Key Group"]}},"/v2/org/{org}/nico/sshkey":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all SSH Keys","responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SshKey"}},"examples":{"Example 1":{"value":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"staging-sre-access","org":"xskkpgqpeakn","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-ssh-key","description":"Retrieve all SSH Keys for the current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["SSH Key"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"sshKeyGroupId","description":"ID of the SSH Key Group"},{"schema":{"type":"string"},"in":"query","name":"query","description":"Search for matches across all Sites. Input will be matched against name field"},{"schema":{"type":"string","enum":["Tenant"]},"in":"query","name":"includeRelation","description":"Related entity to expand"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["NAME_ASC","NAME_DESC","STATUS_ASC","STATUS_DESC","CREATED_ASC","CREATED_DESC","UPDATED_ASC","UPDATED_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]},"post":{"summary":"Create SSH Key","operationId":"create-ssh-key","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKey"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-sre-access","org":"xskkpgqpeakn","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"tags":["SSH Key"],"description":"Create an SSH Key for the current Tenant. If an SSH Key Group is specified, all Sites associated with the SSH Key Group must be online.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKeyCreateRequest"},"examples":{"Example 1":{"value":{"name":"reno-sre-access","publicKey":"ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAICip4hl6WjuVHs60PeikVUs0sWE/kPhk2D0rRHWsIuyL jdoe@test.com","sshKeyGroupId":"86ca8cab-b285-4c2d-9e00-25c88810dc2e"}}}}}}}},"/v2/org/{org}/nico/sshkey/{sshKeyId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"sshKeyId","in":"path","required":true,"description":"ID of the SSH Key"}],"get":{"summary":"Retrieve an SSH key","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKey"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"staging-sre-access","org":"xskkpgqpeakn","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-ssh-key","description":"Retrieve an SSH key for the current Tenant by ID\n\nSSH Key must be owned by current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["SSH Key"]},"delete":{"summary":"Delete an SSH Key","operationId":"delete-ssh-key","responses":{"202":{"description":"Accepted"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete an SSH key for the current Tenant by ID.\n\nSSH Key must be owned by current Tenant. All Site associated with the SSH Key Groups this SSH Key is part of must be online to proceed.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.","tags":["SSH Key"]},"patch":{"summary":"Update an SSH Key","operationId":"update-ssh-key","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKey"},"examples":{"Example 1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-sre-access-v2","org":"xskkpgqpeakn","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Update an SSH Key for the current Tenant by ID.\n\nSSH Key must be owned by current Tenant.\n\nOrg must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.\n\nTo add this SSH Key to various SSH Key Groups or remove it from an SSH Key Group, please use SSH Key Group update endpoint.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SshKeyUpdateRequest"},"examples":{"Example 1":{"value":{"name":"reno-sre-access-v2"}}}}}},"tags":["SSH Key"]}},"/v2/org/{org}/nico/user/current":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve Current User","tags":["User"],"responses":{"200":{"description":"User Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"},"examples":{"example-1":{"value":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","email":"janed@nvidia.com","firstName":"Jane","lastName":"Doe","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}}},"operationId":"get-user","description":"Retrieve details of the current user."}},"/v2/org/{org}/nico/metadata":{"get":{"summary":"Retrieve metadata about the API server","tags":["Metadata"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Metadata"},"examples":{"example-1":{"value":{"version":"0.1.24","buildTime":"2019-08-24T14:15:22Z"}}}}}}},"operationId":"get-metadata","description":"Retrieve system metadata providing information about the API server"},"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}]},"/v2/org/{org}/nico/audit":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Audit Log Entries","tags":["Audit"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AuditEntry"}},"examples":{"Example 1":{"value":[{"id":"e313b3ca-c47a-4ec1-a79b-a147fad51a50","endpoint":"/v2/org/test-org-1/nico/ep","queryParams":"{\"test\":[\"1234\"]}","method":"POST","body":"{\"key1\":\"value1\"}","statusCode":200,"clientIP":"12.123.43.112","userID":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","user":{"id":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","firstName":"John","lastName":"Doe","email":"jdoe@test.com"},"orgName":"test-org-1","timestamp":"2024-12-04T21:06:33.849293-08:00","durationMs":250,"apiVersion":"0.1.91"},{"id":"e313b3ca-c47a-4ec1-a79b-a147fad51a50","endpoint":"/v2/org/test-org-1/nico/ep","queryParams":"{\"test\":[\"1234\"]}","method":"POST","body":"{\"key1\":\"value1\"}","statusCode":403,"statusMessage":"User does not have permissions","clientIP":"12.123.43.112","userID":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","user":{"id":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","firstName":"John","lastName":"Doe","email":"jdoe@test.com"},"orgName":"test-org-1","timestamp":"2024-12-04T21:06:33.849293-08:00","durationMs":50,"apiVersion":"0.1.91"}]}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-all-audit-entry","description":"Get all Audit Log entries\n\nUser must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix.\n","parameters":[{"schema":{"type":"boolean"},"in":"query","name":"failedOnly","description":"Return only audit log entries that have failed status code (>= 400)"},{"schema":{"type":"integer","example":1,"default":1,"minimum":1},"in":"query","name":"pageNumber","description":"Page number for pagination query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"example":20},"in":"query","name":"pageSize","description":"Page size for pagination query"},{"schema":{"type":"string","enum":["TIMESTAMP_ASC","TIMESTAMP_DESC"]},"in":"query","name":"orderBy","description":"Ordering for pagination query"}]}},"/v2/org/{org}/nico/audit/{auditEntryId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"auditEntryId","in":"path","required":true,"description":"ID of the Audit Log Entry"}],"get":{"summary":"Retrieve Audit Log Entry","tags":["Audit"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditEntry"},"examples":{"example-1":{"value":{"id":"e313b3ca-c47a-4ec1-a79b-a147fad51a50","endpoint":"/v2/org/test-org-1/nico/ep","queryParams":"{\"test\":[\"1234\"]}","method":"POST","body":"{\"key1\":\"value1\"}","statusCode":200,"clientIP":"12.123.43.112","userID":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","user":{"id":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","firstName":"John","lastName":"Doe","email":"jdoe@test.com"},"orgName":"test-org-1","timestamp":"2024-12-04T21:06:33.849293-08:00","durationMs":250,"apiVersion":"0.1.91"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-audit-entry","description":"Retrieve a specific Audit Log Entry by ID\n\nUser must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix"}}},"components":{"schemas":{"InfrastructureProvider":{"description":"Infrastructure providers own and manage datacenters","type":"object","title":"InfrastructureProvider","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","org":"rf43bbtnb9c5","orgDisplayName":"Dell Corporation","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"org":{"type":"string"},"orgDisplayName":{"type":["string","null"]},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"InfrastructureProviderStats":{"title":"InfrastructureProviderStats","type":"object","description":"Provide operational stats for Infrastructure Provider","examples":[{"machine":{"total":27,"initializing":8,"assigned":12,"ready":5,"error":2,"decommissioned":0,"unknown":0},"ipBlock":{"total":4,"pending":1,"provisioning":1,"ready":2,"deleting":0,"error":0},"tenantAccount":{"total":8,"pending":0,"invited":3,"ready":5,"error":0}}],"properties":{"machine":{"$ref":"#/components/schemas/MachineCountByStatus"},"ipBlock":{"$ref":"#/components/schemas/IpBlockCountByStatus"},"tenantAccount":{"$ref":"#/components/schemas/TenantAccountCountByStatus"}}},"MachineCountByStatus":{"title":"MachineCountByStatus","type":"object","description":"Describes count of Machines in various statuses","examples":[{"total":27,"initializing":8,"assigned":12,"ready":5,"error":2,"decommissioned":0,"unknown":0}],"properties":{"total":{"type":"integer"},"initializing":{"type":"integer"},"reset":{"type":"integer"},"assigned":{"type":"integer"},"ready":{"type":"integer"},"error":{"type":"integer"},"decommissioned":{"type":"integer"},"unknown":{"type":"integer"}}},"IpBlockCountByStatus":{"title":"IpBlockCountByStatus","type":"object","description":"Describes counts of IP Blocks in various statuses","examples":[{"total":4,"pending":1,"provisioning":1,"ready":2,"deleting":0,"error":0}],"properties":{"total":{"type":"integer"},"pending":{"type":"integer"},"provisioning":{"type":"integer"},"ready":{"type":"integer"},"deleting":{"type":"integer"},"error":{"type":"integer"}}},"TenantAccountCountByStatus":{"title":"TenantAccountCountByStatus","type":"object","description":"Describes counts of Tenant Accounts in various statuses","examples":[{"total":8,"pending":0,"invited":3,"ready":5,"error":0}],"properties":{"total":{"type":"integer"},"pending":{"type":"integer"},"invited":{"type":"integer"},"ready":{"type":"integer"},"error":{"type":"integer"}}},"Tenant":{"title":"Tenant","type":"object","description":"Tenant is the consumer of resources that Infrastructure Providers serve","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","org":"qygdmg8oqik8","orgDisplayName":"Echo Corporation","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z","capabilities":{"targetedInstanceCreation":false}}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique ID of the Tenant","readOnly":true},"org":{"type":"string","description":"Name/external ID of Tenant's organization"},"orgDisplayName":{"type":["string","null"],"description":"Display name of Tenant's organization"},"created":{"type":"string","format":"date-time","description":"Date/time the Tenant was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"Date/time when Tenant was last updated"},"capabilities":{"$ref":"#/components/schemas/TenantCapabilities","description":"Features that are enabled/disabled for Tenant"}}},"TenantCapabilities":{"title":"TenantCapabilities","type":"object","description":"TenantCapabilities defines the set of features enabled for Tenant","examples":[{"targetedInstanceCreation":false}],"properties":{"targetedInstanceCreation":{"type":"boolean","format":"uuid","description":"Indicates whether Tenant can create Instances by specifying Machine ID","readOnly":true}}},"TenantStats":{"title":"TenantStats","type":"object","description":"Provide operational stats for Tenant","examples":[{"instance":{"total":12,"pending":2,"provisioning":1,"ready":8,"terminating":2,"error":1},"vpc":{"total":4,"pending":1,"provisioning":1,"ready":2,"deleting":0,"error":0},"subnet":{"total":4,"pending":1,"provisioning":1,"ready":2,"deleting":0,"error":0}}],"properties":{"instance":{"$ref":"#/components/schemas/InstanceCountByStatus"},"vpc":{"$ref":"#/components/schemas/VpcCountByStatus"},"subnet":{"$ref":"#/components/schemas/SubnetCountByStatus"}}},"InstanceCountByStatus":{"title":"InstanceCountByStatus","type":"object","description":"Describes count of Instances in various statuses","examples":[{"total":12,"pending":2,"provisioning":1,"ready":8,"terminating":2,"error":1}],"properties":{"total":{"type":"integer"},"pending":{"type":"integer"},"provisioning":{"type":"integer"},"ready":{"type":"integer"},"terminating":{"type":"integer"},"error":{"type":"integer"}}},"VpcCountByStatus":{"title":"VpcCountByStatus","type":"object","description":"Describes counts of VPCs in various statuses","examples":[{"total":4,"pending":1,"provisioning":1,"ready":2,"deleting":0,"error":0}],"properties":{"total":{"type":"integer"},"pending":{"type":"integer"},"provisioning":{"type":"integer"},"ready":{"type":"integer"},"deleting":{"type":"integer"},"error":{"type":"integer"}}},"SubnetCountByStatus":{"title":"SubnetCountByStatus","type":"object","description":"Describes counts of Subnets in various statuses","examples":[{"total":4,"pending":1,"provisioning":1,"ready":2,"deleting":0,"error":0}],"properties":{"total":{"type":"integer"},"pending":{"type":"integer"},"provisioning":{"type":"integer"},"ready":{"type":"integer"},"deleting":{"type":"integer"},"error":{"type":"integer"}}},"TenantAccount":{"title":"TenantAccount","type":"object","description":"Associates a Tenant with an Infrastructure Provider","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","infrastructureProviderOrg":"xskkpgqpeakn","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","tenantOrg":"rf43bbtnb9c5","tenantContact":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","email":"janed@nvidia.com","firstName":"Jane","lastName":"Doe","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},"allocationCount":0,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"infrastructureProviderId":{"type":"string","format":"uuid"},"infrastructureProviderOrg":{"type":"string"},"tenantId":{"type":["string","null"],"format":"uuid"},"tenantOrg":{"type":["string","null"]},"tenantContact":{"$ref":"#/components/schemas/User"},"allocationCount":{"type":"integer"},"status":{"$ref":"#/components/schemas/TenantAccountStatus"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"TenantAccountStatus":{"title":"TenantAccountStatus","type":"string","description":"Status values for Tenant Account objects","enum":["Pending","Invited","Ready","Error"]},"TenantAccountCreateRequest":{"title":"TenantAccountCreateRequest","type":"object","description":"Request data to create a TenantAccount","examples":[{"infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantOrg":"rf43bbtnb9c5"}],"properties":{"infrastructureProviderId":{"type":"string","format":"uuid"},"tenantOrg":{"type":"string","pattern":"^[A-Za-z0-9-_]+$","minLength":1,"description":"Must be a valid Org name"}},"required":["infrastructureProviderId","tenantOrg"]},"TenantAccountUpdateRequest":{"title":"TenantAccountUpdateRequest","type":"object","description":"Request data to update a TenantAccount.\n\nNo params needed, an empty request will suffice.","examples":[{}]},"Site":{"title":"Site","type":"object","description":"Site is a datacenter that is running NVIDIA Infra Controller (NICo) services","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"San Jose Central 4","description":"Datacenter serving the San Jose central region","org":"qygdmg8oqik8","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteControllerVersion":"0.1","siteAgentVersion":"0.1","registrationToken":"J7KO-89RR-Y7WQ-AD90","registrationTokenExpiration":"2019-08-25T12:00:00Z","serialConsoleHostname":"sjc.nico.acme.com","isSerialConsoleEnabled":true,"serialConsoleIdleTimeout":60,"serialConsoleMaxSessionLength":3600,"isSerialConsoleSSHKeysEnabled":true,"machineStats":{"total":15,"totalByStatus":{"Initializing":0,"Ready":7,"Reset":0,"Maintenance":0,"InUse":3,"Error":5,"Decommissioned":0,"Unknown":0},"totalByHealth":{"healthy":12,"unhealthy":3},"totalByStatusAndHealth":{"Initializing":{"healthy":0,"unhealthy":0},"Ready":{"healthy":5,"unhealthy":0},"Reset":{"healthy":0,"unhealthy":0},"Maintenance":{"healthy":5,"unhealthy":0},"InUse":{"healthy":3,"unhealthy":0},"Error":{"healthy":2,"unhealthy":3},"Decommissioned":{"healthy":0,"unhealthy":0},"Unknown":{"healthy":0,"unhealthy":0}},"totalByAllocation":{"allocatedInUse":3,"allocatedNotInUse":3,"unallocated":5}},"capabilities":{"nativeNetworking":true,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"isOnline":false,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z","location":{"city":"San Jose","state":"CA","country":"USA"},"contact":{"email":"johndoe@nvidia.com"}}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the Site"},"description":{"type":["string","null"],"description":"Optional description for the Site"},"org":{"type":"string"},"infrastructureProviderId":{"type":"string","format":"uuid"},"siteControllerVersion":{"type":["string","null"],"description":"Version of the Site Controller software"},"siteAgentVersion":{"type":["string","null"],"description":"Version of the Site Agent software"},"registrationToken":{"type":["string","null"],"description":"Token that can be used to register a Site. Value only exposed to Provider"},"registrationTokenExpiration":{"type":["string","null"],"format":"date-time","description":"Date/time when registration token expires. Value only exposed to Provider","readOnly":true},"serialConsoleHostname":{"type":["string","null"],"format":"hostname"},"isSerialConsoleEnabled":{"type":"boolean","description":"Indicates if Serial Console is enabled for the Site by the Provider"},"serialConsoleIdleTimeout":{"type":["integer","null"],"description":"Maximum idle time in seconds before Serial Console is disconnected"},"serialConsoleMaxSessionLength":{"type":["integer","null"],"description":"Maximum length of Serial Console session in seconds"},"isSerialConsoleSSHKeysEnabled":{"type":"boolean","description":"Only visible to Tenant retrieving the Site. Indicates if Serial Console access using SSH Keys is enabled by Tenant"},"isOnline":{"type":"boolean","description":"Indicates if the Site is currently reachable from Cloud"},"status":{"$ref":"#/components/schemas/SiteStatus","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"},"location":{"$ref":"#/components/schemas/SiteLocation"},"contact":{"$ref":"#/components/schemas/SiteContact"},"capabilities":{"$ref":"#/components/schemas/SiteCapabilities"},"machineStats":{"$ref":"#/components/schemas/SiteMachineStats"}}},"SiteSummary":{"title":"SiteSummary","type":"object","description":"SiteSummary contains a subset of data for Site object, used when nesting in other objects","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"San Jose Central 4","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":false,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Pending"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the Site"},"infrastructureProviderId":{"type":"string","format":"uuid"},"isSerialConsoleEnabled":{"type":"boolean","description":"Indicates if Serial Console is enabled for the Site by the Provider"},"isOnline":{"type":"boolean","description":"Indicates if the Site is currently reachable from Cloud"},"capabilities":{"$ref":"#/components/schemas/SiteCapabilities"},"status":{"$ref":"#/components/schemas/SiteStatus","readOnly":true}}},"SiteStatus":{"title":"SiteStatus","type":"string","description":"Status values for Site objects","enum":["Pending","Registered","Error"]},"SiteCapabilities":{"title":"SiteCapabilities","type":"object","description":"Boolean flags to indicate features supported by a Site","properties":{"nativeNetworking":{"type":"boolean"},"networkSecurityGroup":{"type":"boolean"},"nvLinkPartition":{"type":"boolean"},"flow":{"type":"boolean"},"imageBasedOperatingSystem":{"type":"boolean"}}},"SiteMachineStats":{"title":"SiteMachineStats","type":"object","description":"Machine stats for a Site","properties":{"total":{"type":"integer"},"totalByStatus":{"$ref":"#/components/schemas/SiteMachineStatsByStatus"},"totalByHealth":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"},"totalByStatusAndHealth":{"$ref":"#/components/schemas/SiteMachineStatsByStatusAndHealth"},"totalByAllocation":{"$ref":"#/components/schemas/SiteMachineStatsByAllocation"}}},"SiteMachineStatsByAllocation":{"title":"SiteMachineStatsByAllocation","type":"object","description":"Machine stats for a Site by allocation","properties":{"allocatedInUse":{"type":"integer"},"allocatedNotInUse":{"type":"integer"},"unallocated":{"type":"integer"}}},"SiteMachineStatsByHealth":{"title":"SiteMachineStatsByHealth","type":"object","description":"Machine stats for a Site by health","properties":{"healthy":{"type":"integer"},"unhealthy":{"type":"integer"}}},"SiteMachineStatsByStatus":{"title":"SiteMachineStatsByStatus","type":"object","description":"Machine stats for a Site by status","properties":{"Decommissioned":{"type":"integer"},"Error":{"type":"integer"},"Initializing":{"type":"integer"},"InUse":{"type":"integer"},"Maintenance":{"type":"integer"},"Ready":{"type":"integer"},"Reset":{"type":"integer"},"Unknown":{"type":"integer"}}},"SiteMachineStatsByStatusAndHealth":{"title":"SiteMachineStatsByStatusAndHealth","type":"object","description":"Machine stats for a Site by status and health","properties":{"Decommissioned":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"},"Error":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"},"Initializing":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"},"InUse":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"},"Maintenance":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"},"Ready":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"},"Reset":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"},"Unknown":{"$ref":"#/components/schemas/SiteMachineStatsByHealth"}}},"SiteCreateRequest":{"title":"SiteCreateRequest","type":"object","description":"Request data to create a Site","examples":[{"name":"sjc4","description":"Datacenter serving San Jose central region, zone 4","serialConsoleHostname":"nico.acme.com","location":{"city":"San Jose","state":"CA","country":"USA"},"contact":{"email":"johndoe@nvidia.com"}}],"properties":{"name":{"type":"string","description":"Name for the Site","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description for the Site"},"serialConsoleHostname":{"type":["string","null"],"description":"Hostname to reach Serial Console for the Site","format":"hostname"},"location":{"$ref":"#/components/schemas/SiteLocation"},"contact":{"$ref":"#/components/schemas/SiteContact"}},"required":["name"]},"SiteCapabilitiesUpdateRequest":{"title":"SiteCapabilitiesUpdateRequest","type":"object","description":"Request to modify Site's capabilities. Partial update allowed, only specify capabilities that should be updated.","properties":{"nativeNetworking":{"type":["boolean","null"],"description":"Enable or disable native networking for the Site"},"networkSecurityGroup":{"type":["boolean","null"],"description":"Enable or disable network security groups for the Site"},"nvLinkPartition":{"type":["boolean","null"],"description":"Enable or disable NVLink partition support for the Site"},"flow":{"type":["boolean","null"],"description":"Enable or disable NICo Flow for the Site"},"imageBasedOperatingSystem":{"type":["boolean","null"],"description":"Enable or disable image-based operating system support for the Site"}}},"SiteUpdateRequest":{"title":"SiteUpdateRequest","type":"object","description":"Request data to update a Site","examples":[{"name":"sjc04","description":"Datacenter 4 serving central San Jose","renewRegistrationToken":true,"serialConsoleHostname":"sol.nico.acme.com","location":{"city":"San Jose","state":"CA","country":"USA"},"contact":{"email":"johndoe@nvidia.com"}}],"properties":{"name":{"type":["string","null"],"description":"Update name of the Site. Can only be updated by Provider"},"description":{"type":["string","null"],"description":"Update description for the Site. Can only be updated by Provider"},"renewRegistrationToken":{"type":"boolean","description":"Set to true to issue a new registration token. Can only be updated by Provider"},"serialConsoleHostname":{"type":["string","null"],"description":"Hostname to reach Serial Console for the Site. Can only be updated by Provider","format":"hostname"},"isSerialConsoleEnabled":{"type":"boolean","description":"Enable/disable Serial Console. Can only be updated by Provider. Modifying this attribute has no actual effect on SOL. It will be removed in a future API version.","deprecated":true},"serialConsoleIdleTimeout":{"type":"integer","description":"Maximum idle time in seconds before Serial Console is disconnected. Can only be updated by Provider. Modifying this attribute has no actual effect on SOL. It will be removed in a future API version.","deprecated":true},"serialConsoleMaxSessionLength":{"type":"integer","description":"Maximum length of Serial Console session in seconds. Can only be updated by Provider. Modifying this attribute has no actual effect on SOL. It will be removed in a future API version.","deprecated":true},"isSerialConsoleSSHKeysEnabled":{"type":"boolean","description":"Enable/disable Serial Console access using SSH Keys. Previously updateable only by Tenants, modifying this value is no longer supported, update SSH Key Groups to remove Site instead.","deprecated":true},"location":{"$ref":"#/components/schemas/SiteLocation"},"contact":{"$ref":"#/components/schemas/SiteContact"},"capabilities":{"$ref":"#/components/schemas/SiteCapabilitiesUpdateRequest","description":"Modify Site capabilities. Can only be updated by Provider. Partial update allowed, only specify capabilities that should be updated."}}},"SiteLocation":{"title":"SiteLocation","type":"object","description":"Location of the Site","examples":[{"city":"San Jose","state":"CA","country":"USA"}],"properties":{"city":{"type":"string","description":"City where the site is located"},"state":{"type":"string","description":"State where the site is located"},"country":{"type":"string","description":"Country where the site is located"}}},"SiteContact":{"title":"SiteContact","type":"object","description":"Contact for the Site","examples":[{"email":"johndoe@nvidia.com"}],"properties":{"email":{"type":"string","description":"Email address of the Site contact"}}},"Allocation":{"title":"Allocation","type":"object","description":"Specifies a group of resources on a Site that has been allocated to a Tenant","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Echo Studios Allocations","description":"Echo Studios resource allocation in SJC4","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z","allocationConstraints":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]}],"properties":{"id":{"type":"string","description":"ID of the Allocation","format":"uuid","readOnly":true},"name":{"type":"string","description":"Concise and descriptive name of the Allocation","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Detailed description of the Allocation"},"infrastructureProviderId":{"type":"string","description":"ID of the Infrastructure Provider that created the Allocation","format":"uuid"},"tenantId":{"type":"string","description":"ID of the Tenant that received the Allocation","format":"uuid"},"siteId":{"type":"string","description":"ID of the Site where resources are allocated","format":"uuid"},"status":{"$ref":"#/components/schemas/AllocationStatus","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"readOnly":true},"allocationConstraints":{"type":"array","items":{"$ref":"#/components/schemas/AllocationConstraint"}},"created":{"type":"string","description":"Date/time when the Allocation was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Allocation was last updated","format":"date-time","readOnly":true}}},"AllocationStatus":{"title":"AllocationStatus","type":"string","description":"Status values for Allocation objects","enum":["Pending","Registered","Deleting","Error"]},"AllocationCreateRequest":{"title":"AllocationCreateRequest","type":"object","description":"Request data to create an Allocation","examples":[{"name":"Echo Studios","description":"Echo Studios resource allocation in SJC4","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","allocationConstraints":[{"resourceType":"InstanceType","resourceTypeId":"bd5a0240-eb62-4bff-91f7-335e6bb86459","constraintType":"Reserved","constraintValue":10}]}],"properties":{"name":{"type":"string","description":"Concise and descriptive name for the Allocation","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Detailed description for the Allocation"},"tenantId":{"type":"string","format":"uuid","description":"ID of the Tenant that should receive the Allocation"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site where resources should be allocated"},"allocationConstraints":{"type":"array","items":{"$ref":"#/components/schemas/AllocationConstraintCreateRequest"}}},"required":["name","tenantId","siteId"]},"AllocationUpdateRequest":{"title":"AllocationUpdateRequest","type":"object","description":"Request data to update an Allocation","examples":[{"name":"Echo Studios Compute","description":"Echo Studios resource allocation in SJC4"}],"properties":{"name":{"type":["string","null"],"description":"Update name of the Allocation","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Update description of the Allocation"}}},"AllocationConstraint":{"title":"AllocationConstraint","type":"object","description":"Constraints on an Allocation that specify limits for different resource types","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"InstanceType","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":10,"derivedResourceId":null,"instanceType":{"name":"x3.large","infrastructureProviderId":"63c29416-8833-4eaf-9e1c-7c0173cc3150","siteId":"c9f4f276-6f7a-4209-953c-2b9870ce7cc1","status":"Ready"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","allocationId":"9ec871ce-3363-4de2-8f79-062881067628","resourceType":"IPBlock","resourceTypeId":"a59ee688-b5e5-4606-9891-f4a605edacd3","constraintType":"Reserved","constraintValue":20,"derivedResourceId":"6b7d0abe-8403-4e9f-9300-a788d6377648","ipBlock":{"name":"Public Network Overlay for Site SJC4","routingType":"Public","prefix":"202.168.16.0","prefixLength":20,"status":"Ready"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","description":"ID of the Allocation Constraint","format":"uuid","readOnly":true},"allocationId":{"type":"string","format":"uuid","description":"ID of the Allocation that contains the Allocation Constraint"},"resourceType":{"type":"string","description":"Type of the Resource that the Allocation Constraint applies to","enum":["InstanceType","IPBlock"]},"resourceTypeId":{"type":"string","format":"uuid","description":"ID of the Resource Type that acts as the source of the Allocation. For resource type: `InstanceType`, this is the ID of the Instance Type whose associated Machines are allocated to the Tenant. For resource type `IPBlock`, this is the ID of the Site level IP Block from where a prefix is allocated to the Tenant."},"constraintType":{"type":"string","description":"Type of the Allocation Constraint. `Reserved` is the only constraint type supported by current implementation.","enum":["Reserved","OnDemand","Preemptible"]},"constraintValue":{"type":"integer","description":"Value of the Allocation Constraint. For resource type: `InstanceType`, this value represents number of Machines associated with the Instance Type that is allocated to the Tenant. For resource type `IPBlock`, this value represents the prefix length of the IP Block allocated to the Tenant."},"derivedResourceId":{"type":["string","null"],"description":"ID of the allocated Tenant IP Block when resource type is IPBlock"},"instanceType":{"$ref":"#/components/schemas/InstanceTypeSummary"},"ipBlock":{"$ref":"#/components/schemas/IpBlockSummary"},"created":{"type":"string","description":"Date/time when the Allocation Constraint was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Allocation Constraint was last updated","format":"date-time","readOnly":true}}},"AllocationConstraintCreateRequest":{"title":"AllocationConstraintCreateRequest","type":"object","description":"Request data to create an AllocationConstraint","examples":[{"resourceType":"InstanceType","resourceTypeId":"bd5a0240-eb62-4bff-91f7-335e6bb86459","constraintType":"Reserved","constraintValue":10},{"resourceType":"IPBlock","resourceTypeId":"67de813e-37ec-4ff3-ae38-c22351855de8","constraintType":"Reserved","constraintValue":24}],"properties":{"resourceType":{"type":"string","description":"Type of the Resource that the Allocation Constraint applies to","enum":["InstanceType","IPBlock"]},"resourceTypeId":{"type":"string","format":"uuid","description":"ID of the Resource Type that the Allocation Constraint applies to. For InstanceType, this is the ID of the Instance Type. For IPBlock, this is the ID of the IP Block."},"constraintType":{"type":"string","description":"Type of the Allocation Constraint. Please note that OnDemand and Preemptible are not supported by current implementation.","enum":["Reserved","OnDemand","Preemptible"]},"constraintValue":{"type":"integer","description":"Value of the Allocation Constraint. For InstanceType, this value represents number of Machines allocated for Tenant. For IPBlock, this value represents the prefix Length of the IP Block."}},"required":["resourceType","resourceTypeId","constraintType","constraintValue"]},"AllocationConstraintUpdateRequest":{"title":"AllocationConstraintUpdateRequest","type":"object","description":"Request data to update an AllocationConstraint","examples":[{"constraintValue":10}],"properties":{"constraintValue":{"type":"integer","description":"Value of the Allocation Constraint. For InstanceType, this value represents number of Machines allocated for Tenant. For IPBlock, this value represents the prefix Length of the IP Block."}},"required":["constraintValue"]},"VPC":{"title":"VPC","type":"object","description":"VPCs are grouping constructs that bind resources together","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-vpc","description":"Virtual network for machines executing Spark jobs","org":"xskkpgqpeakn","tenantId":"34f5c98e-f430-457b-a812-92637d0c6fd0","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","labels":{"region":"us-west-1","env":"dev"},"controllerVpcId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","networkVirtualizationType":"ETHERNET_VIRTUALIZER","requestedVni":12001,"vni":12001,"networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e","networkSecurityGroupPropagationDetails":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","detailedStatus":"Partial","status":"Synchronizing","details":"","unpropagatedInstanceIds":["b1a5a05e-303c-11f0-b618-7f2e7f9b64ed"],"relatedInstanceIds":["b1a5a05e-303c-11f0-b618-7f2e7f9b64ed"]},"nvLinkLogicalPartitionId":"dd887330-dbd3-45ce-b400-c42fc8e47315","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the VPC"},"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the VPC"},"description":{"type":["string","null"],"description":"Description of the VPC, can be empty"},"org":{"type":"string","readOnly":true,"description":"Organization the VPC belongs to"},"tenantId":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the Tenant the VPC belongs to"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site the VPC belongs to"},"controllerVpcId":{"type":["string","null"],"format":"uuid","description":"Legacy attribute, contains the same value as ID"},"networkVirtualizationType":{"type":["string","null"],"enum":["ETHERNET_VIRTUALIZER","FNN"],"description":"Network virtualization type of the VPC"},"routingProfile":{"type":["string","null"],"minLength":3,"maxLength":64,"description":"Routing profile type for the VPC. Populated when Site has Native Networking enabled and network virtualization type is `FNN`."},"requestedVni":{"type":["integer","null"],"minimum":1,"maximum":65535,"readOnly":true,"description":"Explicitly requested VNI for the VPC if one was requested at creation time"},"vni":{"type":["integer","null"],"minimum":1,"maximum":65535,"readOnly":true,"description":"Active VNI assigned to the VPC"},"networkSecurityGroupId":{"type":["string","null"],"description":"ID of the Network Security Group attached to the VPC"},"networkSecurityGroupPropagationDetails":{"$ref":"#/components/schemas/NetworkSecurityGroupPropagationDetails","description":"Propagation details for the attached Network Security Group"},"nvLinkLogicalPartitionId":{"type":["string","null"],"format":"uuid","description":"ID of the default NVLink Logical Partition that GPUs for all Instances in the VPC will attach to"},"labels":{"$ref":"#/components/schemas/Labels","description":"String key value pairs describing VPC labels"},"status":{"$ref":"#/components/schemas/VpcStatus","readOnly":true,"description":"Status of the VPC"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"readOnly":true,"description":"History of status changes for the VPC"},"created":{"type":"string","format":"date-time","readOnly":true,"description":"Date/time when VPC was created"},"updated":{"type":"string","format":"date-time","readOnly":true,"description":"Date/time when VPC was last updated"}}},"VpcStatus":{"title":"VpcStatus","type":"string","description":"Status values for VPC objects","enum":["Pending","Provisioning","Ready","Configuring","Deleting","Error"]},"VpcCreateRequest":{"title":"VpcCreateRequest","type":"object","description":"Request data to create a VPC","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-id-vpc","description":"Virtual network with user-specified VPC ID","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","networkVirtualizationType":"ETHERNET_VIRTUALIZER","vni":12001},{"name":"spark-ethernet-virtualization-vpc","description":"Virtual network for machines executing Spark jobs","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","networkVirtualizationType":"ETHERNET_VIRTUALIZER","vni":12001,"networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e"},{"name":"spark-fnn-vpc","description":"Virtual network for machines executing Spark jobs","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","networkVirtualizationType":"FNN","routingProfile":"internal","vni":12001,"nvLinkLogicalPartitionId":"dd887330-dbd3-45ce-b400-c42fc8e47315","labels":{"region":"us-west-1","env":"dev"}}],"properties":{"id":{"type":"string","format":"uuid","description":"Optional user-specified UUID for the VPC"},"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the VPC"},"description":{"type":["string","null"],"description":"Optional description for the VPC"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the VPC should be created"},"networkVirtualizationType":{"type":["string","null"],"enum":["ETHERNET_VIRTUALIZER","FNN"],"description":"Network virtualization type of the VPC. If no value is specified, then defaults to `FNN` if Site has native networking enabled, or ETHERNET_VIRTUALIZER if native networking is disabled"},"routingProfile":{"type":["string","null"],"minLength":3,"maxLength":64,"description":"Specify routing profile for the VPC. Only supported when `networkVirtualizationType` is set to `FNN`, or when `networkVirtualizationType` is omitted and Site has Native Networking enabled. Requires Tenant to have elevated privilege. Current accepted values are `privileged-internal`, `internal`, and `external`."},"networkSecurityGroupId":{"type":["string","null"],"description":"ID of the Network Security Group to attach to the VPC"},"vni":{"type":["integer","null"],"minimum":1,"maximum":65535,"description":"Explicitly requested VNI for the VPC"},"nvLinkLogicalPartitionId":{"type":["string","null"],"format":"uuid","description":"ID of the default NVLink Logical Partition that GPUs for all Instances in the VPC will attach to"},"labels":{"$ref":"#/components/schemas/Labels","description":"String key value pairs describing VPC labels. Up to 10 key value pairs can be specified"}},"required":["name","siteId"]},"VpcUpdateRequest":{"title":"VpcUpdateRequest","type":"object","description":"Request data to update a VPC","examples":[{"name":"spark-vpc-v1","description":"Virtual network for machines executing Spark jobs v1"}],"properties":{"name":{"type":["string","null"],"minLength":2,"maxLength":256,"description":"Updated name of the VPC"},"description":{"type":["string","null"],"description":"Updated description of the VPC"},"networkSecurityGroupId":{"type":["string","null"],"description":"ID of the Network Security Group to attach to the VPC"},"nvLinkLogicalPartitionId":{"type":["string","null"],"format":"uuid","description":"ID of the default NVLink Logical Partition that GPUs for all Instances in the VPC will attach to. Can only be updated if VPC currently has no active Instances"},"labels":{"$ref":"#/components/schemas/Labels","description":"Update labels of the VPC. Up to 10 key value pairs can be specified. The labels will be entirely replaced by those sent in the request. Any labels not included in the request will be removed. To retain existing labels, first fetch them and include them along with this request."}}},"VpcVirtualizationUpdateRequest":{"title":"VpcVirtualizationUpdateRequest","type":"object","description":"Request data to update network virtualization type for VPC. Requests are rejected if the VPC already has Subnets or Instances.","examples":[{"networkVirtualizationType":"FNN"}],"properties":{"networkVirtualizationType":{"type":"string","enum":["FNN"],"description":"Network virtualization type of the VPC. Can only be updated to `FNN`"}}},"VpcPeeringCreateRequest":{"title":"VpcPeeringCreateRequest","type":"object","description":"Request data to create a VPC peering between two VPCs, the ordering of VPCs is not important","required":["vpc1Id","vpc2Id","siteId"],"properties":{"vpc1Id":{"type":"string","format":"uuid","description":"ID of the first VPC in the peering"},"vpc2Id":{"type":"string","format":"uuid","description":"ID of the second VPC to peer with"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the peering exists"}}},"VpcPeering":{"title":"VpcPeering","type":"object","description":"VPC peering connection between two VPCs on the same site","properties":{"id":{"type":"string","format":"uuid","readOnly":true,"description":"Unique identifier of the VPC peering"},"vpc1Id":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the first VPC in the peering"},"vpc2Id":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the second VPC in the peering"},"siteId":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the Site where the peering exists"},"isMultiTenant":{"type":"boolean","readOnly":true,"description":"Indicates if this is a multi-tenant peering (VPCs from different tenants)"},"status":{"$ref":"#/components/schemas/VpcPeeringStatus","readOnly":true,"description":"Status of the VPC peering"},"created":{"type":"string","format":"date-time","readOnly":true,"description":"Date and time when the VPC peering was created"},"updated":{"type":"string","format":"date-time","readOnly":true,"description":"Date and time when the VPC peering was last updated"}}},"VpcPeeringStatus":{"title":"VpcPeeringStatus","type":"string","description":"Status values for VPC peering objects","enum":["Pending","Configuring","Requested","Ready","Deleting","Error"]},"VpcPrefix":{"title":"VpcPrefix","type":"object","description":"VPC Prefixes are network grouping constructs for baremetal machines.","examples":[{"id":"0c03ba01-d86b-4a57-a41e-cc359b380a6f","name":"east-vpc-traffic-net","siteId":"ea144def-d68f-44c3-9485-4b103fa2686f","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","prefix":"192.168.1.0/24","ipBlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","prefixLength":20,"status":"Ready","statusHistory":[{"status":"Ready","message":"Received VPC prefix creation request, ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the VPC Prefix"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site the VPC Prefix belongs to"},"vpcId":{"type":"string","format":"uuid","description":"ID of the VPC the VPC Prefix belongs to"},"tenantId":{"type":"string","format":"uuid","description":"ID of the Tenant the VPC Prefix belongs to"},"ipBlockId":{"type":["string","null"],"format":"uuid","description":"ID of the IP Block that contains the prefix of the VPC Prefix"},"prefix":{"type":["string","null"],"description":"The network prefix including prefix length in CIDR notation"},"prefixLength":{"type":"integer","minimum":8,"maximum":31,"example":24,"description":"Length of the prefix. Valid range is 8 to 31, and max usable value depends on prefix length of parent IP Block."},"status":{"$ref":"#/components/schemas/VpcPrefixStatus","readOnly":true,"description":"Status of the VPC Prefix"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"readOnly":true,"description":"Details of 20 most recent status changes"},"created":{"type":"string","format":"date-time","readOnly":true,"description":"Date and time when the VPC Prefix was created"},"updated":{"type":"string","format":"date-time","readOnly":true,"description":"Date and time when the VPC Prefix was updated"}}},"VpcPrefixStatus":{"title":"VpcPrefixStatus","type":"string","description":"Status values for VPC Prefix objects","enum":["Ready","Deleting","Error"]},"VpcPrefixCreateRequest":{"title":"VpcPrefixCreateRequest","type":"object","examples":[{"name":"east-vpc-traffic-net","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","ipBlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","prefixLength":20}],"description":"Request data for creating VPC Prefix","properties":{"name":{"type":"string","minLength":2,"maxLength":256,"description":"Human readable name for the VPC Prefix"},"vpcId":{"type":"string","format":"uuid","description":"ID of the VPC"},"ipBlockId":{"type":"string","format":"uuid","description":"ID of the IP Block to allocate the VPC Prefix from"},"prefixLength":{"type":"integer","minimum":8,"maximum":31,"description":"Prefix length for the VPC Prefix. Valid range is 8 to 31, and max usable value depends on prefix length of parent IP Block."}},"required":["name","vpcId","ipBlockId","prefixLength"]},"VpcPrefixUpdateRequest":{"title":"VpcPrefixUpdateRequest","type":"object","examples":[{"name":"east-vpc-traffic-net"}],"description":"Request data for updating a VPC Prefix","properties":{"name":{"type":"string","minLength":2,"maxLength":256}},"required":["name"]},"Subnet":{"title":"Subnet","type":"object","description":"Subnets are network grouping constructs for baremetal machines.","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-gpu-net","description":"Subnet for GPU nodes","siteId":"ea144def-d68f-44c3-9485-4b103fa2686f","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerNetworkSegmentId":"abe7b0e8-67db-4e89-903e-fc4f2bd7f034","ipv4Prefix":"204.168.0.250","ipv4BlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","ipv4Gateway":"204.168.0.1","ipv6Prefix":null,"ipv6BlockId":null,"ipv6Gateway":null,"prefixLength":20,"routingType":"Public","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"siteId":{"type":"string","format":"uuid"},"vpcId":{"type":"string","format":"uuid"},"tenantId":{"type":"string","format":"uuid"},"controllerNetworkSegmentId":{"type":["string","null"],"format":"uuid"},"ipv4Prefix":{"type":["string","null"],"format":"ipv4","description":"The prefix that gets assigned to the subnet if ipv4 block is chosen"},"ipv4BlockId":{"type":["string","null"],"format":"uuid"},"ipv4Gateway":{"type":["string","null"],"format":"ipv4"},"ipv6Prefix":{"type":["string","null"],"format":"ipv6"},"ipv6BlockId":{"type":["string","null"],"format":"uuid"},"ipv6Gateway":{"type":["string","null"],"format":"ipv6"},"mtu":{"type":"integer","description":"Maximum Transmission Unit size in bytes. This property is system-determined and read-only.","readOnly":true},"prefixLength":{"type":"integer","example":24,"description":"Max value depends on prefix length of parent IP Block"},"routingType":{"type":["string","null"],"enum":["Public","DatacenterOnly"]},"status":{"$ref":"#/components/schemas/SubnetStatus","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"readOnly":true},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"}}}},"SubnetStatus":{"title":"SubnetStatus","type":"string","description":"Status values for Subnet objects","enum":["Pending","Provisioning","Ready","Deleting","Error"]},"SubnetCreateRequest":{"title":"SubnetCreateRequest","type":"object","examples":[{"name":"spark-gpu-net","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","ipv4BlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","prefixLength":20}],"description":"Request data for creating Subnet","properties":{"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"vpcId":{"type":"string","format":"uuid"},"ipv4BlockId":{"type":["string","null"],"format":"uuid"},"ipv6BlockId":{"type":["string","null"],"format":"uuid"},"prefixLength":{"type":"integer"}},"required":["name","vpcId","prefixLength"]},"SubnetUpdateRequest":{"title":"SubnetUpdateRequest","type":"object","examples":[{"name":"spark-gpu-subnet","description":"Subnet for dedicated GPU nodes"}],"description":"Request data for updating a Subnet","properties":{"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]}},"required":["name"]},"InfiniBandPartition":{"title":"InfiniBandPartition","type":"object","description":"InfiniBand Partitions are network segments utilizing InfiniBand topology","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"turbo-net","description":"InfiniBand Partition for model training Instances","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","controllerIBPartitionId":"0e60d064-3d38-4812-84d9-c3353bd96eaf","partitionKey":"0x1","partitionName":"turbo-net","serviceLevel":5,"rateLimit":40,"mtu":4000,"enableSharp":true,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"siteId":{"type":"string","format":"uuid"},"tenantId":{"type":"string","format":"uuid"},"controllerIBPartitionId":{"type":["string","null"],"format":"uuid"},"partitionKey":{"type":["string","null"],"readOnly":true},"partitionName":{"type":["string","null"],"readOnly":true},"serviceLevel":{"type":["integer","null"],"minimum":0,"maximum":15,"readOnly":true},"rateLimit":{"type":["number","null"],"enum":[2,5,10,14,20,25,30,40,56,60,80,100,112,120,168,200,300],"readOnly":true},"mtu":{"type":["integer","null"],"enum":[4000,8000],"readOnly":true},"enableSharp":{"type":"boolean","readOnly":true},"labels":{"$ref":"#/components/schemas/Labels","description":"String key value pairs describing InfiniBand Partition labels. Up to 10 key value pairs can be specified"},"status":{"$ref":"#/components/schemas/InfiniBandPartitionStatus","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"readOnly":true},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"InfiniBandPartitionStatus":{"title":"InfiniBandPartitionStatus","type":"string","description":"Status values for InfiniBand Partition objects","enum":["Pending","Provisioning","Ready","Configuring","Deleting","Error"]},"InfiniBandPartitionCreateRequest":{"title":"InfiniBandPartitionCreateRequest","type":"object","examples":[{"name":"turbo-net","siteId":"8c43e859-d301-4ecf-9d0e-46bf374473c4"}],"description":"Request data to create an InfiniBand Partition","properties":{"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the Partition to create"},"description":{"type":["string","null"],"description":"Optional description of the Partition"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site the Partition should belong to"},"labels":{"$ref":"#/components/schemas/Labels","description":"String key value pairs describing Partition labels. Up to 10 key value pairs can be specified"}},"required":["name","siteId"]},"InfiniBandPartitionUpdateRequest":{"title":"InfiniBandPartitionUpdateRequest","type":"object","examples":[{"name":"turbo-net","description":"InfiniBand Partition for model training Instances"}],"description":"Request data to update an InfiniBand Partition","properties":{"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"labels":{"$ref":"#/components/schemas/Labels","description":"String key value pairs describing Partition labels. Up to 10 key value pairs can be specified"}},"required":["name"]},"NVLinkLogicalPartition":{"title":"NVLinkLogicalPartition","type":"object","description":"NVLink Logical Partitions are logical GPU fabric segments for high bandwidth communication among selective GPUs","examples":[{"id":"ded96bdf-905e-40dd-8a58-3472aab60042","name":"partition-east-gpu","description":"Partition for model training Instances","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true,"description":"Unique ID of the NVLink Logical Partition"},"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the NVLink Logical Partition"},"description":{"type":["string","null"],"description":"Optional description of the NVLink Logical Partition"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site the NVLink Logical Partition belongs to"},"tenantId":{"type":"string","format":"uuid","description":"ID of the Tenant the NVLink Logical Partition belongs to"},"status":{"$ref":"#/components/schemas/NVLinkLogicalPartitionStatus","readOnly":true,"description":"Status of the NVLink Logical Partition"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Details of status changes for the NVLink Logical Partition over time","readOnly":true},"created":{"type":"string","format":"date-time","readOnly":true,"description":"Date and time the NVLink Logical Partition was created"},"updated":{"type":"string","format":"date-time","readOnly":true,"description":"Date and time the NVLink Logical Partition was last updated"}}},"NVLinkLogicalPartitionStatus":{"title":"NVLinkLogicalPartitionStatus","type":"string","description":"Status values for NVLink Logical Partition objects","enum":["Pending","Provisioning","Configuring","Ready","Deleting","Error"]},"NVLinkLogicalPartitionCreateRequest":{"title":"NVLinkLogicalPartitionCreateRequest","type":"object","examples":[{"name":"partition-east-gpu","siteId":"69dae3c8-3554-4a1f-b391-858c6dc47fff"}],"description":"Request data to create an NVLink Logical Partition","properties":{"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the NVLink Logical Partition to create"},"description":{"type":["string","null"],"description":"Optional description of the NVLink Logical Partition"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site the NVLink Logical Partition should belong to"}},"required":["name","siteId"]},"NVLinkLogicalPartitionUpdateRequest":{"title":"NVLinkLogicalPartitionUpdateRequest","type":"object","examples":[{"name":"partition-east-gpu","description":"NVLink Logical Partition for model training Instances"}],"description":"Request data to update an NVLink Logical Partition","properties":{"name":{"type":["string","null"],"minLength":2,"maxLength":256,"description":"Updated name for the NVLink Logical Partition"},"description":{"type":["string","null"],"description":"Updated description for the NVLink Logical Partition"}}},"OperatingSystem":{"title":"OperatingSystem","type":"object","description":"Describes the attributes of the operating system/bootloader that can be used on instances","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"ubuntu-22.04","description":"Ubuntu 22.04","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports\nphone_home:\n  url: http://169.254.169.254:7777/latest/meta-data/phone_home\n  post: all","isCloudInit":true,"phoneHomeEnabled":true,"isActive":true,"deactivationNote":null,"allowOverride":false,"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"42b0f982-5c61-4d2f-a018-41ece61f4641","name":"debian-12-amd64","description":"Official Debian 12 for AMD/Intel","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","type":"Image","imageUrl":"https://saimei.ftp.acc.umu.se/images/cloud/bookworm/latest/debian-12-generic-amd64.qcow2","imageSha":"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae","imageAuthType":"Bearer","imageAuthToken":"acbd18db4cc2f85cedef654fccc4a4d8","imageDisk":"/dev/sda","rootFsId":"6c2ac315-3040-4728-94eb-b66d320206c1","rootFsLabel":null,"ipxeScript":null,"userData":null,"isCloudInit":true,"phoneHomeEnabled":false,"isActive":true,"deactivationNote":null,"allowOverride":false,"siteAssociations":[{"site":{"id":"4b36152c-f48d-4bcc-a722-0fd8e2ad209a","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"site":{"id":"219b7913-4494-4589-940e-e78ca879b302","name":"sc-west-4","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":false,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]},{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"ubuntu-22.04","description":"Ubuntu 22.04","infrastructureProviderId":null,"tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports\nphone_home:\n  url: http://169.254.169.254:7777/latest/meta-data/phone_home\n  post: all","isCloudInit":true,"phoneHomeEnabled":true,"isActive":false,"deactivationNote":"iPXE script is referencing a URL that is unreachable, needs to be researched","allowOverride":false,"status":"Deactivated","statusHistory":[{"status":"Deactivated","message":"Operating System has been deactivated","created":"2019-08-24T20:25:17Z","updated":"2019-08-24T20:25:17Z"},{"status":"Ready","message":"Operating System is now ready to use","created":"2019-08-24T14:17:34Z","updated":"2019-08-24T14:17:34Z"},{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","description":"ID of the Operating System","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the Operating System"},"description":{"type":["string","null"],"description":"Optional description of the Operating System"},"infrastructureProviderId":{"type":["string","null"],"format":"uuid","description":"Specified if a Provider owns the Operating System"},"tenantId":{"type":["string","null"],"format":"uuid","description":"Specified if a Tenant owns the Operating System"},"type":{"type":["string","null"],"description":"Type of the Operating System","enum":["iPXE","Image"]},"imageUrl":{"type":["string","null"],"format":"uri","description":"Original URL from where the Operating System image can be retrieved"},"imageSha":{"type":["string","null"],"description":"SHA hash of the image file, only present for image based OS"},"imageAuthType":{"type":["string","null"],"description":"Authentication type for image URL e.g. 'Basic' or 'Bearer'"},"imageAuthToken":{"type":["string","null"],"description":"Auth token to retrieve the image from image URL"},"imageDisk":{"type":["string","null"],"description":"Disk path where the image should be monuted"},"rootFsId":{"type":["string","null"],"description":"Root filesystem UUID, only applicable for image based Operating System"},"rootFsLabel":{"type":["string","null"],"description":"Root filesystem label, only applicable for image based Operating System"},"ipxeScript":{"type":["string","null"],"description":"iPXE script or URL, only applicable for iPXE based Operating System"},"userData":{"type":["string","null"],"description":"User data for the Operating System"},"isCloudInit":{"type":"boolean","description":"Specified when the Operating System is Cloud Init based"},"phoneHomeEnabled":{"type":"boolean","description":"Indicates whether the Phone Home service should be enabled or disabled for Operating System"},"isActive":{"type":"boolean","description":"Indicates if the Operating System is active"},"deactivationNote":{"type":["string","null"],"description":"Optional deactivation note if OS is inactive"},"allowOverride":{"type":"boolean","description":"Indicates if the user data can be overridden at Instance creation time"},"siteAssociations":{"type":"array","description":"Sites the Operating System is synced to","items":{"$ref":"#/components/schemas/OperatingSystemSiteAssociation"}},"status":{"$ref":"#/components/schemas/OperatingSystemStatus","description":"Status of the Operating System"},"statusHistory":{"type":"array","description":"History of status changes over time","items":{"$ref":"#/components/schemas/StatusDetail"}},"created":{"type":"string","format":"date-time","description":"Date/time when the Operating System was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"Date/time when the Operating System was updated","readOnly":true}}},"OperatingSystemStatus":{"title":"OperatingSystemStatus","type":"string","description":"Status values for Operating System objects","enum":["Pending","Provisioning","Syncing","Ready","Deleting","Error","Deactivated"]},"OperatingSystemSiteAssociation":{"title":"OperatingSystemSiteAssociation","type":"object","description":"Describes the relationship between Operating Systems and Sites","examples":[{"site":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"sjc-central4","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":false,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":false,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Pending"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"site":{"$ref":"#/components/schemas/SiteSummary"},"status":{"$ref":"#/components/schemas/SshKeyGroupStatus"},"version":{"type":["string","null"],"description":"Version of the Key Group on Site","example":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3"},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"OperatingSystemCreateRequest":{"title":"OperatingSystemCreateRequest","type":"object","examples":[{"name":"ubuntu-official-22.04","description":"Official Ubuntu 22.04","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports","phoneHomeEnabled":true,"isCloudInit":true,"allowOverride":false},{"name":"debian-12-amd64","description":"Official Debian 12 for AMD/Intel","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","siteIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"imageUrl":"https://saimei.ftp.acc.umu.se/images/cloud/bookworm/latest/debian-12-generic-amd64.qcow2","imageSha":"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae","imageAuthType":"Bearer","imageAuthToken":"acbd18db4cc2f85cedef654fccc4a4d8","imageDisk":"/dev/sda","rootFsId":"6c2ac315-3040-4728-94eb-b66d320206c1","isCloudInit":true,"allowOverride":false}],"description":"Request data to create an OperatingSystem","properties":{"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the Operating System"},"description":{"type":["string","null"],"description":"Optional description of the Operating System"},"infrastructureProviderId":{"type":["string","null"],"format":"uuid","description":"Deprecated: Infrastructure Provider is now inferred from org membership.","deprecated":true},"tenantId":{"type":["string","null"],"format":"uuid","description":"Deprecated: Tenant is now inferred from org membership.","deprecated":true},"siteIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Specified only one Site if an Operating System is Image based, more than one Site is not supported\""},"ipxeScript":{"type":["string","null"],"description":"iPXE script or URL, only applicable for iPXE based OS. Cannot be specified if imageUrl is specified"},"imageUrl":{"type":["string","null"],"format":"uri","description":"Original URL from where the Operating System image can be retreived from, required for image based OS. Cannot be specified if ipxeScript is specified"},"imageSha":{"type":["string","null"],"description":"SHA hash of the image file, required for image based OS"},"imageAuthType":{"type":["string","null"],"description":"Authentication type for image URL if needed e.g. basic/bearer/token, required is imageAuthToken is specified"},"imageAuthToken":{"type":["string","null"],"description":"Auth token to retrieve the image from image URL, required if imageAuthType is specified"},"imageDisk":{"type":["string","null"],"description":"Disk path where the image should be mounted, optional"},"rootFsId":{"type":["string","null"],"description":"Root filesystem UUID, this or `rootFsLabel` required for image based OS"},"rootFsLabel":{"type":["string","null"],"description":"Root filesystem label, this or `rootFsId` required for image based OS"},"phoneHomeEnabled":{"type":["boolean","null"],"description":"Indicates whether the Phone Home service should be enabled or disabled for Operating System"},"userData":{"type":["string","null"],"description":"User data for the Operating System"},"isCloudInit":{"type":"boolean","description":"Specified when the Operating System is Cloud Init based"},"allowOverride":{"type":"boolean","description":"Indicates if the user data can be overridden at Instance creation time"}},"required":["name"]},"OperatingSystemUpdateRequest":{"title":"OperatingSystemUpdateRequest","type":"object","examples":[{"name":"ubuntu-22.04","description":"Ubuntu 22.04","phoneHomeEnabled":true,"allowOverride":false},{"name":"debian-12-amd64","description":"Official Debian 12 for AMD/Intel","imageUrl":"https://saimei.ftp.acc.umu.se/images/cloud/bookworm/latest/debian-12-generic-amd64.qcow2","imageSha":"2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae","imageAuthType":"Bearer","imageAuthToken":"acbd18db4cc2f85cedef654fccc4a4d8","imageDisk":"/dev/sda","rootFsId":"6c2ac315-3040-4728-94eb-b66d320206c1","isCloudInit":true,"allowOverride":false},{"isActive":false,"deactivationNote":"iPXE script is referencing a URL that is unreachable, needs to be researched"}],"description":"Request data to update an OperatingSystem. Only image related attributes can be updated for image based OS and only iPXE attributes can be updated for iPXE based OS","properties":{"name":{"type":["string","null"],"minLength":2,"maxLength":256,"description":"Name of the Operating System"},"description":{"type":["string","null"],"description":"Optional description of the Operating System"},"ipxeScript":{"type":["string","null"],"description":"iPXE script or URL, only applicable for iPXE based OS. Cannot be specified if imageUrl is specified"},"imageUrl":{"type":["string","null"],"format":"uri","description":"Original URL from where the Operating System image can be retreived from, required for image based OS"},"imageSha":{"type":["string","null"],"description":"SHA hash of the image file, required for image based OS"},"imageAuthType":{"type":["string","null"],"description":"Authentication type for image URL if needed e.g. basic/bearer/token, required is imageAuthToken is specified"},"imageAuthToken":{"type":["string","null"],"description":"Auth token to retrieve the image from image URL, required if imageAuthType is specified"},"imageDisk":{"type":["string","null"],"description":"Disk path where the image should be mounted, optional"},"rootFsId":{"type":["string","null"],"description":"Root filesystem UUID, this or `rootFsLabel` required for image based OS"},"rootFsLabel":{"type":["string","null"],"description":"Root filesystem label, this or `rootFsId` required for image based OS"},"phoneHomeEnabled":{"type":["boolean","null"],"description":"Indicates whether the Phone Home service should be enabled or disabled for Operating System"},"userData":{"type":["string","null"],"description":"User data for the Operating System"},"isCloudInit":{"type":["boolean","null"],"description":"Specified when the Operating System is Cloud Init based"},"allowOverride":{"type":["boolean","null"],"description":"Indicates if the user data can be overridden at Instance creation time"},"isActive":{"type":["boolean","null"],"description":"Indicates if the Operating System is active"},"deactivationNote":{"type":["string","null"],"description":"Optional deactivation note if OS is inactive"}}},"InstanceType":{"title":"InstanceType","type":"object","description":"Instance types describe a set of machines that match a certain criteria","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"x3.large","description":"Part of X family, the X3 Large features increased compute power","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","labels":{"region":"portland","env":"staging"},"machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2}],"machineInstanceTypes":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"queryParam":"includeMachineAssociation","replacedBy":"includeMachineAssignment","takeActionBy":"2023-07-26T00:00:00Z","notice":"'includeMachineAssociation' has been deprecated in favor of 'includeMachineAssignment'. Please take action immediately."},{"attribute":"displayName","takeActionBy":"2024-10-30T00:00:00Z","notice":"'displayName' has been deprecated. Please take action immediately."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"controllerMachineType":{"type":["string","null"]},"infrastructureProviderId":{"type":"string","format":"uuid"},"siteId":{"type":"string","format":"uuid"},"labels":{"$ref":"#/components/schemas/Labels"},"machineCapabilities":{"type":"array","items":{"$ref":"#/components/schemas/MachineCapability"}},"machineInstanceTypes":{"type":"array","description":"Available only for Providers","items":{"$ref":"#/components/schemas/MachineInstanceType"}},"allocationStats":{"$ref":"#/components/schemas/InstanceTypeAllocationStats","description":"summary of machine counts by allocation status"},"status":{"$ref":"#/components/schemas/InstanceTypeStatus"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"}},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"InstanceTypeSummary":{"title":"InstanceTypeSummary","type":"object","description":"Describes a subset of core attributes of an Instance Type","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"x3.large","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","siteId":"72771e6a-6f5e-4de4-a5b9-1266c4197811","status":"Pending"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256},"infrastructureProviderId":{"type":"string","format":"uuid"},"siteId":{"type":"string","format":"uuid"},"status":{"$ref":"#/components/schemas/InstanceTypeStatus"}}},"InstanceTypeStatus":{"title":"InstanceTypeStatus","type":"string","description":"Status values for Instance Type objects","enum":["Pending","Registering","Ready","Deleting","Error"]},"InstanceTypeAllocationStats":{"title":"InstanceTypeAllocationStats","type":"object","examples":[{"assigned":30,"total":10,"used":3,"unused":7,"unusedUsable":7,"maxAllocatable":20}],"description":"Allocation statistics for Instance Type","properties":{"assigned":{"type":"integer","description":"Total number of Machines assigned to this Instance Type"},"total":{"type":"integer","description":"Total number of Machines allocated to different Tenants for this Instance Type"},"used":{"type":"integer","description":"Total number of allocated Machines of this Instance Type currently being used by Tenants"},"unused":{"type":"integer","description":"Total number of allocated Machines of this Instance Type that is currently not being used by Tenants"},"unusedUsable":{"type":"integer","description":"Total number of allocated Machines of this Instance Type that is currently not in use but in Ready state, therefore can be provisioned by Tenant"},"maxAllocatable":{"type":"integer","description":"Maximum number of Machines of this Instance Type that can be allocated to a Tenant"}}},"InstanceTypeCreateRequest":{"title":"InstanceTypeCreateRequest","type":"object","examples":[{"name":"x3.large","description":"Part of X family, the X3 Large features increased compute power","siteId":"8d97fa69-9199-49ff-bcf3-168c62d3874e","labels":{"region":"portland","env":"staging"},"machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4}]}],"description":"Request data to create an Instance Type","properties":{"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"siteId":{"type":"string","format":"uuid"},"labels":{"$ref":"#/components/schemas/Labels"},"controllerMachineType":{"type":["string","null"]},"machineCapabilities":{"type":"array","items":{"$ref":"#/components/schemas/InstanceTypeCapabilityCreateRequest"}}},"required":["name","siteId"]},"InstanceTypeUpdateRequest":{"title":"InstanceTypeUpdateRequest","type":"object","examples":[{"description":"Updated version of the X3 Large family of machines"}],"description":"Request data to update an Instance Type","properties":{"name":{"type":["string","null"],"minLength":2,"maxLength":256},"description":{"type":["string","null"]},"labels":{"$ref":"#/components/schemas/Labels"},"machineCapabilities":{"type":"array","items":{"$ref":"#/components/schemas/MachineCapability"}}}},"InstanceTypeCapabilityCreateRequest":{"title":"InstanceTypeCapabilityCreateRequest","type":"object","description":"Describes request attributes for Instance Type Capability","examples":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","count":2},{"type":"Memory","name":"DDR4","capacity":"131072GB","count":4},{"type":"Network","name":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceType":"DPU","count":2},{"type":"Storage","name":"Dell Ent NVMe CM6 RI 1.92TB","capacity":"1.92TB","count":2},{"type":"GPU","name":"NVIDIA A100 PCIe","capacity":"80GB","count":2},{"type":"InfiniBand","name":"MT2910 Family [ConnectX-7]","vendor":"Mellanox Technologies","inactiveDevices":[1,3],"count":4},{"type":"DPU","name":"DPU","count":2}],"properties":{"type":{"type":"string","enum":["CPU","Memory","Storage","Network","GPU","InfiniBand","DPU"],"description":"Type of the Capability"},"name":{"type":["string"],"description":"Name of the Capability component"},"frequency":{"type":["string","null"],"description":"Frequency of the Capability component, if available"},"capacity":{"type":["string","null"],"description":"Capacity of the Capability component, if applicable"},"vendor":{"type":["string","null"],"description":"Vendor of the Capability component, if available"},"count":{"type":["integer","null"],"description":"Count of the Capability component"},"inactiveDevices":{"type":"array","description":"Indices of those devices that are inactive, only valid for InfiniBand Capability type","items":{"type":"integer"}},"deviceType":{"type":["string","null"],"description":"Device Type of the Capability component, if available"}}},"Instance":{"title":"Instance","type":"object","description":"Instance is a baremetal Machine that has been provisioned for a Tenant","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"spark-monitor-1","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":null,"ipxeScript":null,"alwaysBootWithCustomIpxe":false,"networkSecurityGroupId":"c602eb90-3039-11f0-997a-b38d4fc8389e","networkSecurityGroupPropagationDetails":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","detailedStatus":"Partial","status":"Synchronizing","details":"","unpropagatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"relatedInstanceIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"]},"networkSecurityGroupInherited":false,"userData":null,"labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"64d2028c-ae87-4069-a624-66089d957ef9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true,"virtualFunctionId":null,"macAddress":null,"ipAddresses":[],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"infinibandInterfaces":[{"id":"c518a0e8-3f49-4a1a-8935-a6d3dee6911e","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","partitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"nvLinkInterfaces":[{"id":"fc19ab3f-1e52-4846-91bd-98743ff2752c","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":0,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"fc19ab3f-1e52-4846-91bd-98743ff2752c","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":1,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"fc19ab3f-1e52-4846-91bd-98743ff2752c","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":2,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"fc19ab3f-1e52-4846-91bd-98743ff2752c","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":3,"status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"dpuExtensionServiceDeployments":[],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"tpmEkCertificate":"LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUMxVENDQWJ5Z0F3SUJBZ0lVTEE1ZHFPK1E5OXZQM3VYRTRKcjBncVRtOW93d0RRWUpLb1pJaHZjTkFRRUwKQlFBd0xqRUxNQWtHQTFVRUJoTUNWVk14RXpBUkJnTlZCQW9NQ2s1MmFXUnBZU0JEYjNKNw==","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"attribute":"sshkeygroups","replacedBy":"sshKeyGroups","takeActionBy":"2025-09-04T00:00:00Z","notice":"'sshkeygroups' is being deprecated in favor of 'sshKeyGroups'. Please take action prior to the specified date."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"f61fbc1b-ba32-4476-aab5-5ac7c64c3f26","name":"spark-monitor-2","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","secondaryVpcIds":["5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3"],"machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","controllerInstanceId":null,"ipxeScript":null,"alwaysBootWithCustomIpxe":false,"userData":null,"labels":{"region":"portland","env":"staging"},"isUpdatePending":false,"serialConsoleUrl":"ssh://user@nico.acme.com","interfaces":[{"id":"64d2028c-ae87-4069-a624-66089d957ef9","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","vpcPrefixId":"000bc42b-f946-472e-83d4-ddf7e365e148","isPhysical":true,"virtualFunctionId":null,"macAddress":null,"ipAddresses":[],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"infinibandInterfaces":[{"id":"c518a0e8-3f49-4a1a-8935-a6d3dee6911e","instanceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","partitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"dpuExtensionServiceDeployments":[{"id":"3951ec37-d78f-4ad7-92e1-3fdc76ccf246","dpuExtensionService":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"busybox","serviceType":"KubernetesPod","latestVersion":"V1-T1761856992374052","status":"Ready"},"version":"V1-T1761856992374052","status":"Running","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeyGroupIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyGroups":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","status":"Syncing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"tpmEkCertificate":"LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUMxVENDQWJ5Z0F3SUJBZ0lVTEE1ZHFPK1E5OXZQM3VYRTRKcjBncVRtOW93d0RRWUpLb1pJaHZjTkFRRUwKQlFBd0xqRUxNQWtHQTFVRUJoTUNWVk14RXpBUkJnTlZCQW9NQ2s1MmFXUnBZU0JEYjNKNw==","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"deprecations":[{"attribute":"sshkeygroups","replacedBy":"sshKeyGroups","takeActionBy":"2025-09-04T00:00:00Z","notice":"'sshkeygroups' is being deprecated in favor of 'sshKeyGroups'. Please take action prior to the specified date."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the Instance","readOnly":true},"name":{"type":"string","description":"Name for the Instance","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description for the Instance"},"tenantId":{"type":"string","format":"uuid","description":"ID of the Tenant the Instance belongs to"},"infrastructureProviderId":{"type":"string","format":"uuid","description":"ID of the Infrastructure Provider that owns the Site where the Instance is located"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the Instance is located"},"instanceTypeId":{"type":["string","null"],"format":"uuid"},"vpcId":{"type":"string","format":"uuid"},"secondaryVpcIds":{"type":"array","description":"IDs of VPCs attached to the Instance through non-primary interfaces","items":{"type":"string","format":"uuid"}},"machineId":{"type":["string","null"]},"operatingSystemId":{"type":["string","null"],"format":"uuid"},"networkSecurityGroupId":{"type":["string","null"]},"networkSecurityGroupPropagationDetails":{"$ref":"#/components/schemas/NetworkSecurityGroupPropagationDetails","description":"Propagation details for the attached Network Security Group"},"networkSecurityGroupInherited":{"type":"boolean","description":"Indicates if the Network Security Group is inherited from VPC"},"controllerInstanceId":{"type":["string","null"],"format":"uuid"},"ipxeScript":{"type":["string","null"]},"alwaysBootWithCustomIpxe":{"type":"boolean","description":"Indicates whether the Instance should always execute custom iPXE script when rebooting"},"phoneHomeEnabled":{"type":"boolean","description":"Indicates whether the Phone Home service should be enabled or disabled for Instance"},"userData":{"type":["string","null"]},"labels":{"$ref":"#/components/schemas/Labels"},"isUpdatePending":{"type":"boolean","description":"Indicates whether an update is available for the Instance. Updates can be applied on reboot"},"serialConsoleUrl":{"type":["string","null"],"description":"Serial Console URL for the Instance. Format: ssh://<id>@siteSerialConsoleHostname"},"interfaces":{"type":"array","items":{"$ref":"#/components/schemas/Interface"}},"infinibandInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/InfiniBandInterface"}},"nvLinkInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/NVLinkInterface"}},"dpuExtensionServiceDeployments":{"type":"array","description":"DPU Extension Services deployed on DPUs of this Instance","items":{"$ref":"#/components/schemas/DpuExtensionServiceDeployment"}},"sshKeyGroupIds":{"type":"array","description":"IDs of SSH Key Groups associated with this Instance","items":{"type":"string","format":"uuid"}},"sshKeyGroups":{"type":"array","description":"IDs of SSH Key Groups associated with this Instance","items":{"$ref":"#/components/schemas/SshKeyGroup"}},"tpmEkCertificate":{"type":["string","null"],"description":"base64 encoded TPM EK Certificate associated with this Instance"},"status":{"$ref":"#/components/schemas/InstanceStatus","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"}},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"InstanceStatus":{"title":"InstanceStatus","type":"string","description":"Status values for Instance objects","enum":["Pending","Provisioning","Configuring","Ready","Updating","Repairing","Rebooting","Terminating","Error"]},"InstanceCreateRequest":{"title":"InstanceCreateRequest","type":"object","examples":[{"name":"spark-monitor-1","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","alwaysBootWithCustomIpxe":true,"phoneHomeEnabled":true,"userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports\nphone_home:\n  url: http://169.254.169.254:7777/latest/meta-data/phone_home\n  post: all","labels":{"region":"portland","env":"staging"},"interfaces":[{"subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":false},{"subnetId":"31074c90-3061-4d90-bc62-eaf479989b97","isPhysical":true}],"infinibandInterfaces":[{"partitionId":"4f4decba-7d7f-46b9-9e5f-e5d71c2e0666","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null}],"nvLinkInterfaces":[{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":0},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":1},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":2},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":3}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]},{"name":"spark-monitor-2","description":"Node for monitoring Spark","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","alwaysBootWithCustomIpxe":true,"phoneHomeEnabled":true,"userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports\nphone_home:\n  url: http://169.254.169.254:7777/latest/meta-data/phone_home\n  post: all","labels":{"region":"portland","env":"staging"},"interfaces":[{"vpcPrefixId":"000bc42b-f946-472e-83d4-ddf7e365e148","isPhysical":true},{"vpcPrefixId":"72bfbc86-34eb-4108-8509-2ffd7ca45e04","isPhysical":true}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]},{"name":"llm-training-1","description":"Node for LLM Training","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","instanceTypeId":"83e71f8f-65d3-44ba-92ba-19daac2e497a","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","labels":{"region":"portland","env":"staging"},"interfaces":[{"vpcPrefixId":"000bc42b-f946-472e-83d4-ddf7e365e148","isPhysical":true}],"dpuExtensionServiceDeployments":[{"dpuExtensionServiceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","version":"V1-T1761856992374052"}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]},{"name":"gitlab-runner-1","description":"Node for GitLab Runner","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","machineId":"fm100htq4o8j3bere298as19mdgnbu6hg6guiqp32tghj7gogv05hlr7lgg","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","labels":{"region":"portland","env":"staging"},"interfaces":[{"vpcPrefixId":"000bc42b-f946-472e-83d4-ddf7e365e148","isPhysical":true}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"],"allowUnhealthyMachine":true}],"description":"Request data to create Instance","properties":{"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the Instance"},"description":{"type":["string","null"],"description":"Description of the Instance, optional","maxLength":1024},"tenantId":{"type":"string","format":"uuid","description":"ID of the Tenant creating the Instance"},"instanceTypeId":{"type":["string","null"],"format":"uuid","description":"ID of the Instance Type to use for Instance"},"machineId":{"type":["string","null"],"description":"ID of of specific Machine to use for Instance. Requires Targeted Instance Creation capability enabled for Tenant"},"vpcId":{"type":"string","format":"uuid","description":"ID of the VPC the Instance should belong to"},"secondaryVpcIds":{"type":"array","uniqueItems":true,"description":"IDs of additional VPCs the Instance should attach to through non-primary interfaces. This field may only be specified when every entry in `interfaces` uses `vpcPrefixId`. IDs must be unique, must be valid UUIDs, and must not include the primary `vpcId`.","items":{"type":"string","format":"uuid"}},"userData":{"type":["string","null"],"description":"Can only be specified if allowOverride is set to true in Operating System"},"operatingSystemId":{"type":["string","null"],"format":"uuid","description":"Must be specified if iPXE Script field is empty"},"networkSecurityGroupId":{"type":["string","null"]},"ipxeScript":{"type":["string","null"],"description":"Override iPXE script specified in OS, must be specified if Operating System is not specified"},"alwaysBootWithCustomIpxe":{"type":"boolean","description":"When set to true, the iPXE script specified by OS or overridden here will always be run when rebooting the Instance. OS must be of iPXE type."},"phoneHomeEnabled":{"type":"boolean","description":"When set to true, the Instance will be enabled with the Phone Home service."},"labels":{"$ref":"#/components/schemas/Labels"},"interfaces":{"type":"array","description":"At least one interface must be specified. Either Subnet or VPC Prefix interfaces allowed. Only one of the Subnets or VPC Prefixes can be attached over Physical interface. If only one Subnet is specified, then it will be attached over physical interface regardless of the value of isPhysical. In case of VPC Prefix, isPhysical will always be true","items":{"$ref":"#/components/schemas/InterfaceCreateRequest"}},"infinibandInterfaces":{"type":"array","description":"Associate one or more Partitions with this Instance","items":{"$ref":"#/components/schemas/InfiniBandInterfaceCreateRequest"}},"dpuExtensionServiceDeployments":{"type":"array","description":"DPU Extension Services to deploy to the DPUs of this Instance","items":{"$ref":"#/components/schemas/DpuExtensionServiceDeploymentRequest"}},"nvLinkInterfaces":{"type":"array","description":"Define Interfaces to associate Instance GPUs with NVLink Logical Partitions. A subset of GPUs may be specified (it is not required to include all GPUs). Each item references one GPU index (`deviceInstance`) and one NVLink Logical Partition. Different interfaces may reference different NVLink Logical Partitions.","items":{"$ref":"#/components/schemas/NVLinkInterfaceCreateOrUpdateRequest"}},"sshKeyGroupIds":{"type":"array","description":"Specify list of SSH Key Group IDs that will provide Serial over LAN access","items":{"type":"string","format":"uuid"}},"allowUnhealthyMachine":{"type":"boolean","description":"Set to true in order to target Machines are in maintenance or have health alerts preventing regular provision flow. Requires Targeted Instance Creation capability enabled for Tenant"}},"required":["name","tenantId","vpcId","interfaces"]},"BatchInstanceCreateRequest":{"title":"BatchInstanceCreateRequest","type":"object","description":"Request data to batch create multiple Instances with topology-optimized machine allocation. Explicit interface `ipAddress` values are not supported in batch requests.","examples":[{"namePrefix":"gpu-worker","count":4,"description":"GPU worker nodes for distributed training","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","topologyOptimized":true,"labels":{"workload":"training","env":"production"},"interfaces":[{"subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true}],"infinibandInterfaces":[{"partitionId":"4f4decba-7d7f-46b9-9e5f-e5d71c2e0666","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true}],"nvLinkInterfaces":[{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":0},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":1}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]},{"namePrefix":"inference-node","count":8,"description":"Inference nodes spread across racks","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","instanceTypeId":"83e71f8f-65d3-44ba-92ba-19daac2e497a","vpcId":"ebcd2d2a-deca-4ac4-b079-d7a97fff8a6b","operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","topologyOptimized":false,"interfaces":[{"vpcPrefixId":"000bc42b-f946-472e-83d4-ddf7e365e148","isPhysical":true}],"dpuExtensionServiceDeployments":[{"dpuExtensionServiceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","version":"V1-T1761856992374052"}],"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"]}],"properties":{"namePrefix":{"type":"string","minLength":2,"maxLength":240,"description":"Prefix for instance names. Instances will be named with this prefix followed by a random 6-character suffix (e.g., \"worker\" becomes \"worker-abc123\")"},"count":{"type":"integer","minimum":2,"maximum":18,"description":"Number of instances to create in this batch. Minimum 2, maximum 18 (limited by topology domain size)"},"description":{"type":["string","null"],"description":"Description applied to all instances in the batch, optional","maxLength":1024},"tenantId":{"type":"string","format":"uuid","description":"ID of the Tenant creating the Instances"},"instanceTypeId":{"type":"string","format":"uuid","description":"ID of the Instance Type to use for all Instances in the batch"},"vpcId":{"type":"string","format":"uuid","description":"ID of the VPC the Instances should belong to"},"secondaryVpcIds":{"type":"array","uniqueItems":true,"description":"IDs of additional VPCs the Instances should attach to through non-primary interfaces. This field may only be specified when every entry in `interfaces` uses `vpcPrefixId`. IDs must be unique, must be valid UUIDs, and must not include the primary `vpcId`.","items":{"type":"string","format":"uuid"}},"userData":{"type":["string","null"],"description":"User data applied to all instances. Can only be specified if allowOverride is set to true in Operating System"},"operatingSystemId":{"type":["string","null"],"format":"uuid","description":"Must be specified if iPXE Script field is empty"},"networkSecurityGroupId":{"type":["string","null"],"format":"uuid","description":"ID of a Network Security Group to attach to all instances"},"ipxeScript":{"type":["string","null"],"description":"Override iPXE script specified in OS, must be specified if Operating System is not specified"},"alwaysBootWithCustomIpxe":{"type":"boolean","description":"When set to true, the iPXE script specified by OS or overridden here will always be run when rebooting the Instances. OS must be of iPXE type."},"phoneHomeEnabled":{"type":"boolean","description":"When set to true, the Instances will be enabled with the Phone Home service."},"labels":{"$ref":"#/components/schemas/Labels"},"interfaces":{"type":"array","description":"Interface configuration shared across all instances. At least one interface must be specified. Either Subnet or VPC Prefix interfaces allowed, only one of the Subnets or VPC Prefixes can be attached over Physical interface. Interface `ipAddress` is not supported for batch instance creation requests.","items":{"$ref":"#/components/schemas/InterfaceCreateRequest"}},"infinibandInterfaces":{"type":"array","description":"InfiniBand interface configuration shared across all instances","items":{"$ref":"#/components/schemas/InfiniBandInterfaceCreateRequest"}},"dpuExtensionServiceDeployments":{"type":"array","description":"DPU Extension Services to deploy to all instances in the batch","items":{"$ref":"#/components/schemas/DpuExtensionServiceDeploymentRequest"}},"nvLinkInterfaces":{"type":"array","description":"NVLink interface configuration shared across all instances. A subset of GPUs may be specified. Each item references one GPU index (`deviceInstance`) and one NVLink Logical Partition. Different interfaces may reference different NVLink Logical Partitions.","items":{"$ref":"#/components/schemas/NVLinkInterfaceCreateOrUpdateRequest"}},"sshKeyGroupIds":{"type":"array","description":"SSH Key Group IDs that will provide Serial over LAN access to all instances","items":{"type":"string","format":"uuid"}},"topologyOptimized":{"type":"boolean","default":true,"description":"When true (default), all instances must be allocated on machines within the same NVLink domain. When false, instances can be spread across different NVLink domains."}},"required":["namePrefix","count","tenantId","instanceTypeId","vpcId","interfaces"]},"InstanceUpdateRequest":{"title":"InstanceUpdateRequest","type":"object","examples":[{"name":"spark-monitor-1","description":"Spark Monitor Node 1","alwaysBootWithCustomIpxe":true,"sshKeyGroupIds":["a7bf2f9c-12f0-4673-be47-12be6d9e16c8"],"operatingSystemId":"eaeb86ee-c435-444e-9e01-8346f67f194b","ipxeScript":"#!ipxe\nkernel http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/linux initrd=initrd.gz\ninitrd http://archive.ubuntu.com/ubuntu/dists/xenial/main/installer-amd64/current/images/netboot/ubuntu-installer/amd64/initrd.gz\nboot || imgfree\n shell","userData":"#cloud-config\nautoinstall:\n  apt:\n    geoip: true\n    preserve_sources_list: false\n    primary:\n    - arches: [amd64, i386]\n      uri: http://archive.ubuntu.com/ubuntu\n    - arches: [default]\n      uri: http://ports.ubuntu.com/ubuntu-ports\nphone_home:\n  url: http://169.254.169.254:7777/latest/meta-data/phone_home\n  post: all","labels":{"region":"portland","env":"staging"},"interfaces":[{"subnetId":"1f492faa-2963-4f21-aab5-9f00b2e40119","isPhysical":true}],"infinibandInterfaces":[{"partitionId":"550e8400-e29b-41d4-a716-446655440000","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null},{"partitionId":"6ba7b810-9dad-11d1-80b4-00c04fd430c8","device":"MT2910 Family [ConnectX-7]","deviceInstance":1,"isPhysical":false,"virtualFunctionId":null},{"partitionId":"8b05d5c3-8de4-48c8-8d1c-399a8abc3ab8","device":"MT2910 Family [ConnectX-7]","deviceInstance":2,"isPhysical":false,"virtualFunctionId":null}],"dpuExtensionServiceDeployments":[{"dpuExtensionServiceId":"497f6eca-6276-4993-bfeb-53cbbbba6f08","version":"V1-T1761856992374052"}],"nvLinkInterfaces":[{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":0},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":1},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":2},{"nvLinkLogicalPartitionId":"2f8676fd-d228-4db5-ac76-1cfc74f48a23","deviceInstance":3}]},{"triggerReboot":true,"rebootWithCustomIpxe":true,"applyUpdatesOnReboot":true}],"description":"Request data to update Instance","properties":{"name":{"type":["string","null"],"minLength":2,"maxLength":256,"description":"Updated name for the Instance"},"description":{"type":["string","null"],"description":"Updated description of the Instance","maxLength":1024},"triggerReboot":{"type":["boolean","null"],"description":"Trigger power cycle for Instance"},"rebootWithCustomIpxe":{"type":["boolean","null"],"description":"When specified along with triggerReboot, the Instance will boot using the custom iPXE specified by OS. If Instance has alwaysBootWithCustomIpxe flag set then this value will be ignored."},"applyUpdatesOnReboot":{"type":["boolean","null"],"description":"When specified, any updates pending for the Instance e.g. DPU reprovisioning, will be applied on reboot"},"operatingSystemId":{"type":["string","null"],"description":"The UUID of the desired operating system."},"ipxeScript":{"type":["string","null"],"description":"The iPXE script content to be used for booting."},"sshKeyGroupIds":{"type":"array","description":"Specify a new list of SSH Key Group IDs that will provide Serial over LAN and SSH access.  This will overwrite an existing list.","items":{"type":"string","format":"uuid"}},"networkSecurityGroupId":{"type":["string","null"]},"userData":{"type":["string","null"],"description":"Any user-data to be sent to the booting OS.  For example, cloud-init data."},"alwaysBootWithCustomIpxe":{"type":["boolean","null"],"description":"Whether the custom iPXE data should be used for every boot."},"phoneHomeEnabled":{"type":["boolean","null"],"description":"Indicates whether the Phone Home service should be enabled or disabled for Instance"},"labels":{"$ref":"#/components/schemas/Labels","description":"Update labels of the Instance. The labels will be entirely replaced by those sent in the request. Any labels not included in the request will be removed. To retain existing labels, first fetch them and include them along with this request."},"secondaryVpcIds":{"type":"array","uniqueItems":true,"description":"IDs of additional VPCs the Instance should attach to through non-primary interfaces. This field may only be specified when every entry in `interfaces` uses `vpcPrefixId`. IDs must be unique, must be valid UUIDs, and must not include the primary `vpcId`.","items":{"type":"string","format":"uuid"}},"interfaces":{"type":"array","description":"Update Interfaces of the Instance","items":{"$ref":"#/components/schemas/InterfaceCreateRequest"}},"infinibandInterfaces":{"type":"array","description":"Update InfiniBand Interfaces of the Instance","items":{"$ref":"#/components/schemas/InfiniBandInterfaceCreateRequest"}},"nvLinkInterfaces":{"type":"array","description":"Update NVLink Interfaces of the Instance. A subset of GPUs may be specified. Each item references a GPU index (`deviceInstance`) and an NVLink Logical Partition. Different interfaces may reference different NVLink Logical Partitions. Partial updates are not allowed, specified interfaces will delete or replace existing Interfaces. Updating is not allowed if Instance's VPC has `nvLinkLogicalPartitionId` attribute set.","items":{"$ref":"#/components/schemas/NVLinkInterfaceCreateOrUpdateRequest"}},"dpuExtensionServiceDeployments":{"type":"array","description":"Updated set of DPU Extension Services to deploy to the DPUs of this Instance","items":{"$ref":"#/components/schemas/DpuExtensionServiceDeploymentRequest"}}}},"InstanceDeleteRequest":{"title":"InstanceDeleteRequest","type":"object","examples":[{"machineHealthIssue":{"category":"Network","summary":"Machine has DPU connectivity error","details":"Tenant observed repeated link flaps on the DPU uplink."},"isRepairTenant":false}],"description":"Request data to delete Instance","properties":{"machineHealthIssue":{"$ref":"#/components/schemas/MachineHealthIssue","description":"Information regarding issue with the underlying Machine experienced by Tenant"},"isRepairTenant":{"type":["boolean","null"],"description":"Should be set to true for Tenants who are performing investigation/repairing the Machine. Otherwise omit or set to false"}}},"Interface":{"title":"Interface","type":"object","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true,"virtualFunctionId":null,"macAddress":"2F-FC-34-AE-9C-2A","ipAddresses":["200.32.11.190"],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"94c4c8c0-c3c4-4a52-9518-3e165b1de036","instanceId":"371ddf80-a7ff-4ff6-9a37-0557cec8b9be","vpcPrefixId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","requestedIpAddress":"10.0.0.191","isPhysical":true,"device":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceInstance":0,"virtualFunctionId":null,"macAddress":"2F-FC-34-AE-9C-2B","ipAddresses":["200.32.11.191"],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"45d89d4f-2dde-4fc5-a20d-9f96faa4e9fa","instanceId":"371ddf80-a7ff-4ff6-9a37-0557cec8b9be","vpcPrefixId":"d89d8cc6-d66e-4bf2-bf62-40238837cc90","requestedIpAddress":"10.0.0.193","isPhysical":false,"device":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceInstance":0,"virtualFunctionId":1,"macAddress":"2F-FC-34-AM-9C-2C","ipAddresses":["200.32.11.193"],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"id":"236ee9d1-5f61-4aaa-abf3-0f72693e1189","instanceId":"371ddf80-a7ff-4ff6-9a37-0557cec8b9be","vpcPrefixId":"d5dd56e2-1b0b-4913-927e-b5896d7aca7b","requestedIpAddress":"10.0.0.195","isPhysical":true,"device":"MT42822 BlueField-2 integrated ConnectX-6 Dx network controller","deviceInstance":1,"virtualFunctionId":null,"macAddress":"2F-FC-34-AM-9C-2C","ipAddresses":["200.32.11.194"],"status":"Pending","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"description":"Associates an Instance with a Subnet","properties":{"id":{"type":"string","minLength":1,"format":"uuid"},"instanceId":{"type":"string","format":"uuid"},"subnetId":{"type":["string","null"],"format":"uuid"},"vpcPrefixId":{"type":["string","null"],"format":"uuid"},"isPhysical":{"type":"boolean"},"device":{"type":["string","null"],"description":"Name of the device to use"},"deviceInstance":{"type":["integer","null"],"description":"Index of the device, used to identify which interface card to attache the Partition to"},"virtualFunctionId":{"type":["integer","null"],"description":"Must be specified if isPhysical is false"},"macAddress":{"type":["string","null"]},"ipAddresses":{"type":"array","description":"A list of IPv4 or IPv6 addresses","items":{"type":"string"}},"requestedIpAddress":{"type":["string","null"],"description":"Explicitly requested IP address for the interface. This is only used for VPC Prefix based interfaces and is not valid for Subnet based interfaces. The least-significant host bit must be 1."},"status":{"$ref":"#/components/schemas/InterfaceStatus"},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"InterfaceStatus":{"title":"InterfaceStatus","type":"string","description":"Status values for Interface objects","enum":["Pending","Provisioning","Ready","Deleting","Error"]},"InterfaceCreateRequest":{"title":"InterfaceCreateRequest","type":"object","examples":[{"subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","isPhysical":true},{"vpcPrefixId":"000bc42b-f946-472e-83d4-ddf7e365e148","ipAddress":"10.0.0.11","isPhysical":true}],"description":"Request data to create an Interface for an Instance by associating it with a Subnet or VPC Prefix.\n\nIf VPC specified in request has FNN virtualization type, then all interfaces must specify VPC Prefix.\n\nIf the VPC has Ethernet network virtualization type then all interfaces must specify Subnet.","properties":{"subnetId":{"type":"string","format":"uuid"},"vpcPrefixId":{"type":"string","format":"uuid"},"ipAddress":{"type":["string","null"],"description":"Explicitly requested IP address for the interface. It cannot be specified for Subnet based interfaces. The least-significant host bit must be 1."},"isPhysical":{"type":"boolean","description":"Specifies whether this Subnet or VPC Prefix should be attached to the Instance over physical interface."},"device":{"type":"string","description":"Name of the device to use"},"deviceInstance":{"type":"integer","description":"Index of the device, used to identify which interface card to attache the Partition to"},"virtualFunctionId":{"type":["integer","null"],"description":"Index of the virtual function to use, must be specified if isPhysical is false","minimum":1,"maximum":16}}},"InfiniBandInterface":{"title":"InfiniBandInterface","type":"object","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","partitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null,"guid":"946dae0300339498","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"description":"Defines an interface created by associating an Instance with an InfiniBand Partition","properties":{"id":{"type":"string","minLength":1,"format":"uuid"},"instanceId":{"type":"string","format":"uuid"},"partitionId":{"type":"string","format":"uuid","description":"ID of the InfiniBand Partition associated with this interface"},"device":{"type":"string","description":"Name of the InfiniBand device associated with this interface"},"deviceInstance":{"type":"integer"},"isPhysical":{"type":"boolean","description":"Indicates whether this is a physical interface"},"virtualFunctionId":{"type":["integer","null"]},"guid":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/InfiniBandInterfaceStatus"},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"InfiniBandInterfaceStatus":{"title":"InfiniBandInterfaceStatus","type":"string","description":"Status values for InfiniBand Interface objects","enum":["Pending","Provisioning","Ready","Deleting","Error"]},"InfiniBandInterfaceCreateRequest":{"title":"InfiniBandInterfaceCreateRequest","type":"object","examples":[{"partitionId":"4f4decba-7d7f-46b9-9e5f-e5d71c2e0666","device":"MT2910 Family [ConnectX-7]","deviceInstance":0,"isPhysical":true,"virtualFunctionId":null},{"partitionId":"4f4decba-7d7f-46b9-9e5f-e5d71c2e0666","device":"MT2910 Family [ConnectX-7]","deviceInstance":3,"isPhysical":false,"virtualFunctionId":2}],"description":"Request data to create an InfiniBand Interface for an Instance by associating it with an InfiniBand Partition","properties":{"partitionId":{"type":"string","format":"uuid","description":"ID of the Partition the Interface should attach to"},"device":{"type":"string","description":"Name of the InfiniBand device to use"},"vendor":{"type":["string","null"],"description":"Name of the InfiniBand device vendor, optional"},"deviceInstance":{"type":"integer","description":"Index of the device, used to identify which interface card to attache the Partition to"},"isPhysical":{"type":"boolean","description":"Specifies whether this Partition should be attached to the Instance over physical interface"},"virtualFunctionId":{"type":["integer","null"],"description":"Must be specified if isPhysical is false"}}},"NVLinkInterface":{"title":"NVLinkInterface","type":"object","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","instanceId":"64d2028c-ae87-4069-a624-66089d957ef9","nvLinklogicalPartitionId":"05ef7e84-1d4e-4e4d-980d-38589479a0fe","nvLinkDomainId":"59202b81-65fb-45ec-b3b8-91ab0ad3f34a","deviceInstance":0,"gpuGuid":"4fe82bc6-1e30-4dfd-8839-996596209883","status":"Ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"description":"Defines an interface created by associating a GPU of an Instance with an NVLink Logical Partition","properties":{"id":{"type":"string","minLength":1,"format":"uuid"},"instanceId":{"type":"string","format":"uuid"},"nvLinkLogicalPartitionId":{"type":"string","format":"uuid","description":"ID of the NVLink Logical Partition associated with this interface"},"nvLinkDomainId":{"type":["string","null"],"format":"uuid","description":"ID of the NVLink Domain associated with this Interface"},"deviceInstance":{"type":"integer","description":"Index of the device, used to identify the GPU associated with this Interface"},"gpuGuid":{"type":["string","null"],"description":"Unique ID of the GPU"},"status":{"$ref":"#/components/schemas/NVLinkInterfaceStatus"},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"NVLinkInterfaceStatus":{"title":"NVLinkInterfaceStatus","type":"string","description":"Status values for NVLink Interface objects","enum":["Pending","Provisioning","Ready","Deleting","Error"]},"NVLinkInterfaceCreateOrUpdateRequest":{"title":"NVLinkInterfaceCreateOrUpdateRequest","type":"object","examples":[{"nvLinklogicalPartitionId":"505e07bc-86bf-489a-807d-92dc8b80e6ff","deviceInstance":0},{"nvLinklogicalPartitionId":"4f4decba-7d7f-46b9-9e5f-e5d71c2e0666","deviceInstance":1}],"description":"Request data to create an NVLink Interface for an Instance by associating a specific GPU index with an NVLink Logical Partition.","properties":{"nvLinklogicalPartitionId":{"type":"string","format":"uuid","description":"ID of the NVLink Logical Partition the Interface should attach to"},"deviceInstance":{"type":"integer","minimum":0,"description":"GPU index for this NVLink interface. Must be non-negative, unique within the request, and within the GPU count exposed by the selected Machine or Instance Type."}}},"MachineCapability":{"title":"MachineCapability","type":"object","description":"Describes capabilities of a Machine","examples":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2},{"type":"Memory","name":"DDR4","capacity":"131072GB","count":4},{"type":"Network","name":"MT43244 BlueField-3 integrated ConnectX-7 network controller","vendor":"Mellanox Technologies","deviceType":"DPU","count":2},{"type":"Storage","name":"Dell Ent NVMe CM6 RI 1.92TB","capacity":"1.92TB","count":2},{"type":"GPU","name":"NVIDIA A100 PCIe","capacity":"80GB","count":2},{"type":"InfiniBand","name":"MT28908 Family [ConnectX-6]","vendor":"Mellanox Technologies","count":2},{"type":"DPU","name":"DPU","count":2}],"properties":{"type":{"type":"string","enum":["CPU","Memory","Storage","Network","GPU","InfiniBand","DPU"],"description":"Type of the Capability"},"name":{"type":["string"],"description":"Name of the Capability component"},"frequency":{"type":["string","null"],"description":"Frequency of the Capability component, if available"},"cores":{"type":["integer","null"],"description":"Number of Cores in the Capability component, if applicable"},"threads":{"type":["integer","null"],"description":"Number of Threads in the Capability component, if applicable"},"capacity":{"type":["string","null"],"description":"Capacity of the Capability component, if applicable"},"vendor":{"type":["string","null"],"description":"Vendor of the Capability component, if available"},"inactiveDevices":{"type":"array","description":"A list of inactive devices","items":{"type":"integer"}},"count":{"type":["integer","null"],"description":"Count of the Capability component"},"deviceType":{"type":["string","null"],"description":"Device Type of the Capability component, if available"}}},"Rack":{"title":"Rack","type":"object","description":"Rack represents a physical rack in the datacenter","examples":[{"id":"550e8400-e29b-41d4-a716-446655440000","name":"Rack-01","manufacturer":"Dell","model":"PowerEdge R750","serialNumber":"SN-RACK-001","description":"Primary compute rack","location":{"region":"us-east-1","datacenter":"DC-01","room":"Room-A","position":"A1"},"components":[{"id":"660e8400-e29b-41d4-a716-446655440001","componentId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","type":"ComponentTypeCompute","name":"Server-01","serialNumber":"SN-SRV-001","manufacturer":"Dell","firmwareVersion":"2.1.0","slotId":1,"trayIdx":0,"hostId":0,"bmcs":[{"type":"BmcTypeHost","macAddress":"AA:BB:CC:DD:EE:01","ipAddress":"10.0.0.101"}],"powerState":"on"}]}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the Rack"},"name":{"type":"string","description":"Name of the Rack"},"manufacturer":{"type":"string","description":"Manufacturer of the Rack"},"model":{"type":"string","description":"Model of the Rack"},"serialNumber":{"type":"string","description":"Serial number of the Rack"},"description":{"type":"string","description":"Description of the Rack"},"location":{"$ref":"#/components/schemas/RackLocation"},"components":{"type":"array","description":"Components within the Rack. Only returned when includeComponents is true.","items":{"$ref":"#/components/schemas/RackComponent"}}}},"RackLocation":{"title":"RackLocation","type":"object","description":"Physical location of a Rack","properties":{"region":{"type":"string","description":"Region where the rack is located"},"datacenter":{"type":"string","description":"Datacenter where the rack is located"},"room":{"type":"string","description":"Room within the datacenter"},"position":{"type":"string","description":"Position of the rack within the room"}}},"RackValidationResult":{"title":"RackValidationResult","type":"object","description":"Result of validating a rack's components by comparing expected vs actual state","properties":{"diffs":{"type":"array","description":"List of component differences found during validation","items":{"$ref":"#/components/schemas/ComponentDiff"}},"totalDiffs":{"type":"integer","description":"Total number of component differences found"},"missingCount":{"type":"integer","description":"Number of components expected but missing from the source system"},"unexpectedCount":{"type":"integer","description":"Number of components found in the source system but not expected"},"mismatchCount":{"type":"integer","description":"Number of components present in both but with field differences"},"matchCount":{"type":"integer","description":"Number of components that match between expected and actual"}}},"ComponentDiff":{"title":"ComponentDiff","type":"object","description":"A single component difference found during rack validation","properties":{"type":{"type":"string","description":"Type of difference: Unknown, Missing, Unexpected, or Mismatch","enum":["Unknown","Missing","Unexpected","Mismatch"]},"id":{"type":"string","format":"uuid","description":"Flow internal component UUID"},"componentId":{"type":"string","description":"Component ID assigned by the component manager service"},"expected":{"$ref":"#/components/schemas/RackComponent"},"actual":{"$ref":"#/components/schemas/RackComponent"},"fieldDiffs":{"type":"array","description":"List of field differences (populated when type is Mismatch)","items":{"$ref":"#/components/schemas/FieldDiff"}}}},"FieldDiff":{"title":"FieldDiff","type":"object","description":"A single field difference between expected and actual component state","properties":{"fieldName":{"type":"string","description":"Name of the field that differs (e.g. firmware_version, position.slot_id)"},"expectedValue":{"type":"string","description":"Expected value of the field"},"actualValue":{"type":"string","description":"Actual value of the field"}}},"RackComponent":{"title":"RackComponent","type":"object","description":"A component within a Rack (e.g. compute node, switch, PDU)","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the component"},"componentId":{"type":"string","description":"ID of the component"},"rackId":{"type":"string","format":"uuid","description":"ID of the rack this component belongs to"},"type":{"type":"string","description":"Type of the component (e.g. ComponentTypeCompute, ComponentTypeNVSwitch)"},"name":{"type":"string","description":"Name of the component"},"serialNumber":{"type":"string","description":"Serial number of the component"},"manufacturer":{"type":"string","description":"Manufacturer of the component"},"model":{"type":"string","description":"Model of the component"},"description":{"type":"string","description":"Description of the component (JSON string)"},"firmwareVersion":{"type":"string","description":"Firmware version of the component"},"slotId":{"type":"integer","description":"Slot ID of the component within the rack"},"trayIdx":{"type":"integer","description":"Tray index of the component"},"hostId":{"type":"integer","description":"Host ID of the component"},"bmcs":{"type":"array","description":"BMC (Baseboard Management Controller) entries for the component","items":{"$ref":"#/components/schemas/BMCInfo"}},"powerState":{"type":"string","description":"Current power state of the component"}}},"BMCInfo":{"title":"BMCInfo","type":"object","description":"BMC (Baseboard Management Controller) information","properties":{"type":{"type":"string","description":"BMC type (e.g. BmcTypeHost, BmcTypeDpu)"},"macAddress":{"type":"string","description":"MAC address of the BMC"},"ipAddress":{"type":"string","description":"IP address of the BMC"}}},"Tray":{"title":"Tray","type":"object","description":"Tray represents a component within a rack (e.g. compute node, NVSwitch, power shelf)","examples":[{"id":"660e8400-e29b-41d4-a716-446655440001","componentId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","type":"compute","name":"compute-tray-1","manufacturer":"NVIDIA","model":"GB200","serialNumber":"TSN001","description":"Compute tray in slot 1","firmwareVersion":"2.1.0","powerState":"on","position":{"slotId":1,"trayIdx":0,"hostId":1},"bmcs":[{"type":"BmcTypeHost","macAddress":"00:11:22:33:44:55","ipAddress":"192.168.1.100"}],"rackId":"550e8400-e29b-41d4-a716-446655440000"}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the Tray"},"componentId":{"type":"string","description":"ID of the component"},"type":{"type":"string","enum":["compute","switch","powershelf"],"description":"Type of the tray"},"name":{"type":"string","description":"Name of the tray"},"manufacturer":{"type":"string","description":"Manufacturer of the tray"},"model":{"type":"string","description":"Model of the tray"},"serialNumber":{"type":"string","description":"Serial number of the tray"},"description":{"type":"string","description":"Description of the tray"},"firmwareVersion":{"type":"string","description":"Firmware version of the tray"},"powerState":{"type":"string","description":"Current power state of the tray"},"position":{"$ref":"#/components/schemas/TrayPosition"},"bmcs":{"type":"array","description":"BMC (Baseboard Management Controller) entries for the tray","items":{"$ref":"#/components/schemas/BMCInfo"}},"rackId":{"type":"string","format":"uuid","description":"ID of the rack this tray belongs to"}}},"TrayPosition":{"title":"TrayPosition","type":"object","description":"Position of a tray within a rack","properties":{"slotId":{"type":"integer","description":"Slot number of the tray in the rack"},"trayIdx":{"type":"integer","description":"Index of the tray within its slot"},"hostId":{"type":"integer","description":"Host ID associated with the tray"}}},"RackFilter":{"title":"RackFilter","type":"object","description":"Filter criteria for selecting racks in batch operations. If omitted or empty, all racks in the site are targeted.","properties":{"names":{"type":"array","items":{"type":"string"},"description":"Filter racks by name"}}},"TrayFilter":{"title":"TrayFilter","type":"object","description":"Filter criteria for selecting trays in batch operations. If omitted or empty, all trays in the site are targeted.\n\nConstraints: `rackId` and `rackName` are mutually exclusive. `rackId`/`rackName` cannot be combined with `ids`/`componentIds`. `componentIds` requires `type`.","properties":{"rackId":{"type":"string","format":"uuid","description":"Filter by Rack ID"},"rackName":{"type":"string","description":"Filter by Rack name"},"type":{"type":"string","enum":["compute","switch","powershelf"],"description":"Filter by tray type"},"componentIds":{"type":"array","items":{"type":"string"},"description":"Filter by component ID. Requires 'type'."},"ids":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Filter by tray UUID"}}},"BatchUpdateRackPowerStateRequest":{"title":"BatchUpdateRackPowerStateRequest","type":"object","description":"Request body for batch rack power control operations","required":["siteId","state"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site"},"filter":{"$ref":"#/components/schemas/RackFilter"},"state":{"type":"string","enum":["on","off","cycle","forceoff","forcecycle"],"description":"Target power state"}}},"BatchUpdateTrayPowerStateRequest":{"title":"BatchUpdateTrayPowerStateRequest","type":"object","description":"Request body for batch tray power control operations","required":["siteId","state"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site"},"filter":{"$ref":"#/components/schemas/TrayFilter"},"state":{"type":"string","enum":["on","off","cycle","forceoff","forcecycle"],"description":"Target power state"}}},"BatchRackFirmwareUpdateRequest":{"title":"BatchRackFirmwareUpdateRequest","type":"object","description":"Request body for batch rack firmware update operations","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site"},"filter":{"$ref":"#/components/schemas/RackFilter"},"version":{"type":["string","null"],"description":"Target firmware version."}}},"BringUpRackRequest":{"title":"BringUpRackRequest","type":"object","description":"Request body for single-rack bring up operations","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site"},"description":{"type":"string","description":"Optional description for the bring up operation"}},"examples":[{"siteId":"550e8400-e29b-41d4-a716-446655440000"},{"siteId":"550e8400-e29b-41d4-a716-446655440000","description":"Initial bring up for production rack"}]},"BatchBringUpRackRequest":{"title":"BatchBringUpRackRequest","type":"object","description":"Request body for batch rack bring up operations","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site"},"filter":{"$ref":"#/components/schemas/RackFilter"},"description":{"type":"string","description":"Optional description for the bring up operation"}}},"BringUpRackResponse":{"title":"BringUpRackResponse","type":"object","description":"Response for bring up operations containing task IDs for tracking","properties":{"taskIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"List of task IDs created for the bring up operation (one per rack)"}},"examples":[{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}]},"RackTask":{"title":"RackTask","type":"object","description":"A task representing an asynchronous operation on rack infrastructure.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the task."},"status":{"type":"string","enum":["Unknown","Pending","Waiting","Running","Succeeded","Failed","Terminated"],"description":"Current state of the task."},"description":{"type":"string","description":"Human-readable description provided when the task was created."},"message":{"type":"string","description":"Optional status or error message describing the current state or result."},"started":{"type":"string","format":"date-time","description":"Timestamp when the task started execution."},"finished":{"type":"string","format":"date-time","description":"Timestamp when the task finished (succeeded, failed or terminated)."},"created":{"type":"string","format":"date-time","description":"Timestamp when the task was created."},"updated":{"type":"string","format":"date-time","description":"Timestamp when the task was last updated."}},"examples":[{"id":"550e8400-e29b-41d4-a716-446655440000","status":"Running","description":"Power on rack components","message":"Processing 3 of 5 components"}]},"BatchTrayFirmwareUpdateRequest":{"title":"BatchTrayFirmwareUpdateRequest","type":"object","description":"Request body for batch tray firmware update operations","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site"},"filter":{"$ref":"#/components/schemas/TrayFilter"},"version":{"type":["string","null"],"description":"Target firmware version."},"targets":{"type":"array","items":{"type":"string","minLength":1,"enum":["bmc","cpld","bios","nvos","pmc","psu"]},"description":"Optional subset of firmware targets to update within each matched tray.\nNames are lowercase and select sub-parts of the tray\n(BMC, BIOS, etc.). The accepted set per tray type comes from\nthe Flow service's NICo proto bindings (which mirror Core's\nper-tray-type enums in `carbide-core/crates/rpc/proto/forge.proto`),\nso the supported values track Core as new sub-parts are added:\n  - switch trays (NvSwitchComponent): currently bmc, cpld, bios, nvos\n  - powershelf trays (PowerShelfComponent): currently pmc, psu\n  - compute trays (ComputeTrayComponent): currently bmc, bios\n    (currently NOT honored end-to-end: the NICo compute-firmware\n    path goes through SetFirmwareUpdateTimeWindow + auto-update,\n    which has no per-target selection; the request is logged\n    and the whole bundle is applied. Will be honored once\n    compute moves to UpdateComponentFirmware.)\nOmitted or empty means \"update everything in the bundle\"\n(the historical default). Unknown names are rejected.\nRequires `version` to be set."}},"examples":[{"siteId":"550e8400-e29b-41d4-a716-446655440000","filter":{"type":"switch"},"version":"24.11.0","targets":["bmc","nvos"]}]},"UpdatePowerStateRequest":{"title":"UpdatePowerStateRequest","type":"object","description":"Request body for single-resource power control operations","required":["siteId","state"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site"},"state":{"type":"string","enum":["on","off","cycle","forceoff","forcecycle"],"description":"Power control state to apply:\n- `on`: Power on the target(s)\n- `off`: Graceful power off\n- `cycle`: Graceful power cycle (restart)\n- `forceoff`: Forced power off (immediate)\n- `forcecycle`: Forced power cycle (immediate restart)"}},"examples":[{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"on"},{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"off"},{"siteId":"550e8400-e29b-41d4-a716-446655440000","state":"cycle"}]},"UpdatePowerStateResponse":{"title":"UpdatePowerStateResponse","type":"object","description":"Response for power control operations containing task IDs for tracking","properties":{"taskIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"List of task IDs created for the power control operation (one per rack)"}},"examples":[{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}]},"FirmwareUpdateRequest":{"title":"FirmwareUpdateRequest","type":"object","description":"Request body for firmware update operations.","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site"},"version":{"type":["string","null"],"description":"Target firmware version."},"targets":{"type":"array","items":{"type":"string","minLength":1,"enum":["bmc","cpld","bios","nvos","pmc","psu"]},"description":"Optional subset of firmware targets to update within the targeted tray.\nNames are lowercase and select sub-parts of the tray\n(BMC, BIOS, etc.). The accepted set per tray type comes from\nthe Flow service's NICo proto bindings (which mirror Core's\nper-tray-type enums in `carbide-core/crates/rpc/proto/forge.proto`),\nso the supported values track Core as new sub-parts are added:\n  - switch trays (NvSwitchComponent): currently bmc, cpld, bios, nvos\n  - powershelf trays (PowerShelfComponent): currently pmc, psu\n  - compute trays (ComputeTrayComponent): currently bmc, bios\n    (currently NOT honored end-to-end: the NICo compute-firmware\n    path goes through SetFirmwareUpdateTimeWindow + auto-update,\n    which has no per-target selection; the request is logged\n    and the whole bundle is applied. Will be honored once\n    compute moves to UpdateComponentFirmware.)\nOmitted or empty means \"update everything in the bundle\"\n(the historical default). Unknown names are rejected.\nRequires `version` to be set."}},"examples":[{"siteId":"550e8400-e29b-41d4-a716-446655440000","version":"24.11.0"},{"siteId":"550e8400-e29b-41d4-a716-446655440000","version":"24.11.0","targets":["bmc","nvos"]},{"siteId":"550e8400-e29b-41d4-a716-446655440000"}]},"FirmwareUpdateResponse":{"title":"FirmwareUpdateResponse","type":"object","description":"Response for firmware update operations containing task IDs for tracking","properties":{"taskIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"List of task IDs created for the firmware update operation"}},"examples":[{"taskIds":["550e8400-e29b-41d4-a716-446655440000"]}]},"Machine":{"title":"Machine","type":"object","description":"Machine is the baremetal server that sits in the datacenter","examples":[{"id":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","instanceTypeId":"2e016c02-2c67-48aa-b289-5d3ca6320c52","instanceId":"59bdaaff-3998-4fd9-a140-8749beeb605e","tenantId":"99819e6e-4017-4021-9edd-ea1bdf4dbd59","controllerMachineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerMachineType":"x86_64","hwSkuDeviceType":"cpu","vendor":"Lenovo","productName":"ThinkSystem SR670 V2","serialNumber":"J1060ACR.D3KS2CS001G","machineCapabilities":[{"type":"CPU","name":"Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz","frequency":"3.0GHz","cores":18,"threads":36,"count":2},{"type":"Memory","name":"Corsair Vengeance LPX","capacity":"32GB","count":4}],"machineInterfaces":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerInterfaceId":"ad3dac49-741d-4c1f-815c-c020127c532f","controllerSegmentId":"f2207a3c-1847-42e5-bf2c-cd015f87a2bc","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","hostname":"example.com","isPrimary":true,"macAddress":"00:00:5e:00:53:af","ipAddresses":["192.156.7.23","202.88.37.112"],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"maintenanceMessage":null,"health":{"source":"aggregate-host-health","observedAt":null,"successes":[{"id":"BgpDaemonEnabled","target":null},{"id":"BgpStats","target":null},{"id":"DhcpServer","target":null},{"id":"DpuDiskUtilizationCheck","target":null},{"id":"FanSpeed","target":"System Board Fan1A"},{"id":"PowerSupply","target":"PS1 Status"},{"id":"Temperature","target":"CPU1 Temp"},{"id":"Temperature","target":"System Board Exhaust Temp"},{"id":"Voltage","target":"CPU1 1P8 PG"}],"alerts":[{"id":"FailedValidationTest","target":"DcgmFullShort","inAlertSince":null,"message":"Failed validation test:\nName:DcgmFullShort\nCommand:dcgmi\nArgs:diag -r 2","tenantMessage":null,"classifications":["PreventAllocations"]}]},"labels":{"RackIdentifier":"GVX11F01C02","ServerName":"SITE1-C03-Server-02"},"status":"Ready","isUsableByTenant":true,"statusHistory":[{"status":"Ready","message":"Machine is online and ready","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","description":"Unique ID of Machine","readOnly":true},"infrastructureProviderId":{"type":"string","format":"uuid","description":"ID of the Provider that owns the Machine","readOnly":true},"siteId":{"type":"string","format":"uuid","description":"ID of the Site the Machine belongs to"},"instanceTypeId":{"type":["string","null"],"format":"uuid","description":"ID of the Instance Type, if assigned"},"instanceId":{"type":["string","null"],"format":"uuid","description":"ID of the Instance if this Machine is assigned to one"},"tenantId":{"type":["string","null"],"format":"uuid","description":"ID of the Tenant that owns the Instance if the Machine is assigned to one"},"controllerMachineId":{"type":"string","description":"ID of the Machine at Site, now same as the primary ID"},"controllerMachineType":{"type":["string","null"],"description":"Denotes architecture (x86 vs ARM) of the Machine"},"hwSkuDeviceType":{"type":["string","null"],"description":"SKU derived device type of the machine, e.g. cpu, gpu, cache, storage, etc."},"vendor":{"type":["string","null"],"description":"Name of the vendor of the Machine"},"productName":{"type":["string","null"],"description":"Product name of the Machine"},"serialNumber":{"type":["string","null"],"description":"Serial number of the Machine, only visible to Provider"},"machineCapabilities":{"type":"array","items":{"$ref":"#/components/schemas/MachineCapability"}},"machineInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/MachineInterface"}},"maintenanceMessage":{"type":["string","null"],"description":"If the Machine is in maintenance mode, this message will typically describe the reason and how long it is expected to be in maintenance"},"health":{"$ref":"#/components/schemas/MachineHealth"},"metadata":{"$ref":"#/components/schemas/MachineMetadata","description":"Only available to Providers. Returned if includeMetadata query param is specified. Otherwise attribute is omitted from response."},"labels":{"$ref":"#/components/schemas/Labels"},"status":{"$ref":"#/components/schemas/MachineStatus","readOnly":true},"isUsableByTenant":{"type":"boolean","description":"Indicates whether the machine is usable by or currently in use by a tenant.","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"MachineStatus":{"title":"MachineStatus","type":"string","description":"Status values for Machine objects","enum":["Initializing","Ready","Reset","Maintenance","InUse","Error","Decommissioned","Unknown"]},"MachineSummary":{"title":"MachineSummary","type":"object","description":"Describes a subset of core attributes for a Machine","examples":[{"id":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerMachineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerMachineType":"x86_64","hwSkuDeviceType":"cpu","vendor":"Lenovo","productName":"ThinkSystem SR670 V2","maintenanceMessage":null,"status":"Ready"}],"properties":{"id":{"type":"string","description":"Unique ID of Machine","readOnly":true},"controllerMachineId":{"type":"string","description":"ID of the Machine at Site, now same as the primary ID"},"controllerMachineType":{"type":["string","null"],"description":"Denotes architecture (x86 vs ARM) of the Machine"},"hwSkuDeviceType":{"type":["string","null"],"description":"SKU derived device type of the machine, e.g. cpu, gpu, cache, storage, etc."},"vendor":{"type":["string","null"],"description":"Name of the vendor of the Machine"},"productName":{"type":["string","null"],"description":"Product name of the Machine"},"maintenanceMessage":{"type":["string","null"],"description":"If the Machine is in maintenance mode, this message will typically describe the reason and how long it is expected to be in maintenance"},"status":{"$ref":"#/components/schemas/MachineStatus","readOnly":true}}},"MachineHealthIssue":{"title":"MachineHealthIssue","type":"object","required":["category","summary","details"],"properties":{"category":{"type":"string","enum":["Hardware","Network","Performance","Storage","Software","Other"],"description":"High-level category for the tenant-reported issue."},"summary":{"type":["string","null"],"maxLength":512,"description":"Brief description of the issue for operators."},"details":{"type":["string","null"],"maxLength":8192,"description":"Diagnostic information, logs, ticket numbers, etc."}}},"MachineOnlineRepairPolicy":{"title":"MachineOnlineRepairPolicy","type":"object","required":["allowAutoInstanceDeletionOnFailure"],"properties":{"allowAutoInstanceDeletionOnFailure":{"type":"boolean","description":"When true, escalation to offline breakfix (permanent delete / deallocate) is allowed if online repair cannot be completed."}}},"MachineOnlineRepairAcknowledgments":{"title":"MachineOnlineRepairAcknowledgments","type":"object","required":["acceptDataCorruptionRisk","acceptRepairTeamAccess","acceptInstanceDeletionRisk"],"properties":{"acceptDataCorruptionRisk":{"type":"boolean","enum":[true],"description":"Tenant confirms data may be corrupted during repair."},"acceptRepairTeamAccess":{"type":"boolean","enum":[true],"description":"Tenant confirms the dedicated repair team will have access to the instance."},"acceptInstanceDeletionRisk":{"type":"boolean","enum":[true],"description":"Tenant confirms risk of instance deletion if escalation to offline breakfix occurs."}}},"MachineOnlineRepair":{"title":"MachineOnlineRepair","type":"object","required":["enabled"],"description":"Enable or disable online repair of a Machine. Online repair facilitates repairing a Machine without the Tenant having to release the Machine by deleting the Instance. When `enabled` is true, `policy` and `acknowledgments` are required inside this object,\nand `healthIssue` is required at the top level of the MachineUpdateRequest. When `enabled` is false, none of those fields may be set.","properties":{"enabled":{"type":"boolean","description":"When true, initiates the online repair process: applies the tenant-reported OnlineRepair health override on the Machine and sets the associated Instance status to Repairing.\nWhen false, exits online repair: clears the health override and returns the Instance to Ready. Cannot be combined with instance type, maintenance, or label updates in the same request."},"policy":{"$ref":"#/components/schemas/MachineOnlineRepairPolicy"},"acknowledgments":{"$ref":"#/components/schemas/MachineOnlineRepairAcknowledgments"}}},"MachineUpdateRequest":{"title":"MachineUpdateRequest","type":"object","examples":[{"instanceTypeId":"2e016c02-2c67-48aa-b289-5d3ca6320c52"},{"clearInstanceType":true},{"setMaintenanceMode":true,"maintenanceMessage":"Machine requires re-cabling to connect with revised underlay network. Estimated maintenance time is 2 days"},{"setMaintenanceMode":false},{"labels":{"RackIdentifier":"GVX11F01C02","ServerName":"SITE1-C03-Server-02","RepairStatus":"InProgress"}},{"onlineRepair":{"enabled":true,"policy":{"allowAutoInstanceDeletionOnFailure":false},"acknowledgments":{"acceptDataCorruptionRisk":true,"acceptRepairTeamAccess":true,"acceptInstanceDeletionRisk":true}}},{"healthIssue":{"category":"Storage","summary":"Disk errors on OSD","details":"Ticket FORGE-12345; smartctl logs attached"}}],"description":"Request data to update Machine. Instance Type attribute updates, maintenance attribute updates, labels updates, and in-pool online repair (enter or exit) must be specified in separate requests. They cannot be processed at the same time.","properties":{"instanceTypeId":{"type":["string","null"],"minLength":2,"maxLength":256,"format":"uuid","description":"Update the Instance Type of the Machine. Cannot be specified when clearing Instance Type. Can only be updated by Provider."},"clearInstanceType":{"type":["boolean","null"],"description":"Set to true to clear the existing Instance Type. Cannot be specified if Instance Type ID is specified. Can only be set by Provider."},"setMaintenanceMode":{"type":["boolean","null"],"description":"Set to `true` to enable maintenance mode and to `false` to disable maintenance mode. Can be set by Provider or Privileged Tenant."},"maintenanceMessage":{"type":["string","null"],"description":"Optional message describing the reason for moving Machine into maintenance mode. Can be updated by Provider or Privileged Tenant.","minLength":5,"maxLength":256},"labels":{"description":"Machine labels will be overwritten, include existing labels to preserve them. Can be updated by Provider or Privileged Tenant.","$ref":"#/components/schemas/Labels"},"onlineRepair":{"$ref":"#/components/schemas/MachineOnlineRepair"},"healthIssue":{"description":"Required when `onlineRepair.enabled` is true. Must not be set when exiting online repair (`onlineRepair.enabled` false).","$ref":"#/components/schemas/MachineHealthIssue"}}},"MachineInterface":{"title":"MachineInterface","type":"object","description":"Describes an interface attached to a machine","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","controllerInterfaceId":"ad3dac49-741d-4c1f-815c-c020127c532f","controllerSegmentId":"f2207a3c-1847-42e5-bf2c-cd015f87a2bc","attachedDpuMachineID":"fm100dsg4ekcb4sdi6hkqn0iojhj18okrr8vct64luh8957lfe8e69vme20","subnetId":"1f232bf0-7b90-456e-b9b0-38d9fea4171a","hostname":"example.com","isPrimary":true,"macAddress":"00:00:5e:00:53:af","ipAddresses":["192.156.7.23","202.88.37.112"],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid"},"machineId":{"type":"string"},"controllerInterfaceId":{"type":["string","null"],"format":"uuid"},"controllerSegmentId":{"type":["string","null"],"format":"uuid"},"attachedDpuMachineID":{"type":["string","null"]},"subnetId":{"type":["string","null"],"format":"uuid"},"hostname":{"type":["string","null"],"format":"hostname"},"isPrimary":{"type":"boolean"},"macAddress":{"type":["string","null"]},"ipAddresses":{"type":"array","description":"Array of IP addresses","items":{"type":"string"}},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"MachineMetadata":{"title":"MachineMetadata","type":"object","description":"Describes metadata for various Machine components","examples":[{"dmiData":{"boardName":"7Z23CTOLWB","boardSerial":".C1KS2CS002G.","boardVersion":"06","biosDate":"03/30/2023","biosVersion":"U8E122J-1.51","productSerial":"J1050ACR","chassisSerial":"J1050ACR"},"bmcInfo":{"ip":"10.217.133.5","mac":"C8:4B:D6:7A:C9:8A","version":"1","firmwareRevision":"6.00"},"gpus":[{"name":"NVIDIA H100 PCIe","serial":"1654422006434","driverVersion":"530.30.02","vbiosVersion":"96.00.30.00.01","inforomVersion":"1010.0200.00.02","totalMemory":"81559 MiB","frequency":"1755 MHz","pciBusId":"00000000:17:00.0"}],"networkInterfaces":[{"macAddress":"c8:4b:d6:7b:ac:a8","vendor":"Broadcom Inc. and subsidiaries","device":"NetXtreme BCM5720 Gigabit Ethernet PCIe (PowerEdge Rx5xx LOM Board)","path":"/devices/pci0000:00/0000:00:1c.5/0000:04:00.0/net/eno8303","numaNode":0,"description":"NetXtreme BCM5720 Gigabit Ethernet PCIe (PowerEdge Rx5xx LOM Board)","slot":"0000:04:00.0"}],"infinibandInterfaces":[{"guid":"1070fd0300bd43ac","vendor":"Mellanox Technologies","device":"MT28908 Family [ConnectX-6]","path":"/devices/pci0000:c9/0000:c9:02.0/0000:ca:00.0/infiniband/ibp202s0f0","numaNode":1,"description":"MT28908 Family [ConnectX-6]","slot":"0000:ca:00.0"}]}],"properties":{"dmiData":{"$ref":"#/components/schemas/MachineDMIData"},"bmcInfo":{"$ref":"#/components/schemas/MachineBMCInfo"},"gpus":{"type":"array","items":{"$ref":"#/components/schemas/MachineGPUInfo"}},"networkInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/MachineNetworkInterface"}},"infinibandInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/MachineInfiniBandInterface"}}}},"MachineBMCInfo":{"title":"MachineBMCInfo","type":"object","description":"Describes BMC information of a Machine","examples":[{"ip":"10.217.133.5","mac":"C8:4B:D6:7A:C9:8A","version":"1","firmwareRevision":"6.00"}],"properties":{"ip":{"type":["string","null"],"format":"ipv4"},"mac":{"type":["string","null"]},"version":{"type":["string","null"]},"firmwareRevision":{"type":["string","null"]}}},"MachineDMIData":{"title":"MachineDMIData","type":"object","description":"Describes DMI data of a Machine","examples":[{"boardName":"7Z23CTOLWB","boardSerial":".C1KS2CS002G.","boardVersion":"06","biosDate":"03/30/2023","biosVersion":"U8E122J-1.51","productSerial":"J1050ACR","chassisSerial":"J1050ACR"}],"properties":{"boardName":{"type":["string","null"]},"boardSerial":{"type":["string","null"]},"boardVersion":{"type":["string","null"]},"biosDate":{"type":["string","null"]},"biosVersion":{"type":["string","null"]},"productSerial":{"type":["string","null"]},"chassisSerial":{"type":["string","null"]}}},"MachineGPUInfo":{"title":"MachineGPUInfo","type":"object","description":"Describes information about GPU of a Machine","examples":[{"name":"NVIDIA H100 PCIe","serial":"1654422006434","driverVersion":"530.30.02","vbiosVersion":"96.00.30.00.01","inforomVersion":"1010.0200.00.02","totalMemory":"81559 MiB","frequency":"1755 MHz","pciBusId":"00000000:17:00.0"}],"properties":{"name":{"type":["string","null"]},"serial":{"type":["string","null"]},"driverVersion":{"type":["string","null"]},"vbiosVersion":{"type":["string","null"]},"inforomVersion":{"type":["string","null"]},"totalMemory":{"type":["string","null"]},"frequency":{"type":["string","null"]},"pciBusId":{"type":["string","null"]}}},"MachineHealth":{"title":"MachineHealth","type":"object","description":"Describes results of various Machine health probes and alerts","examples":[{"source":"aggregate-host-health","observedAt":null,"successes":[{"id":"BgpDaemonEnabled","target":null},{"id":"BgpStats","target":null},{"id":"DhcpServer","target":null},{"id":"DpuDiskUtilizationCheck","target":null},{"id":"FanSpeed","target":"System Board Fan1A"},{"id":"PowerSupply","target":"PS1 Status"},{"id":"Temperature","target":"CPU1 Temp"},{"id":"Temperature","target":"System Board Exhaust Temp"},{"id":"Voltage","target":"CPU1 1P8 PG"}],"alerts":[{"id":"FailedValidationTest","target":"DcgmFullShort","inAlertSince":null,"message":"Failed validation test:\nName:DcgmFullShort\nCommand:dcgmi\nArgs:diag -r 2","tenantMessage":null,"classifications":["PreventAllocations"]}]}],"properties":{"source":{"type":"string","description":"Describes how the health report was generated"},"observedAt":{"type":["string","null"],"description":"Date/time when health report was generated"},"successes":{"type":"array","items":{"$ref":"#/components/schemas/MachineHealthProbeSuccess"},"description":"Results from successful health probes for the Machine"},"alerts":{"type":"array","items":{"$ref":"#/components/schemas/MachineHealthProbeAlert"},"description":"Results from failed health probes for the Machine"}}},"MachineHealthProbeSuccess":{"title":"MachineHealthProbeSuccess","type":"object","description":"Describes results of successful Machine health probe","examples":[{"id":"FanSpeed","target":"System Board Fan1A"}],"properties":{"id":{"type":"string","description":"Health probe identifier"},"target":{"type":["string","null"],"description":"Specific component targeted by health probe"}}},"MachineHealthProbeAlert":{"title":"MachineHealthProbeAlert","type":"object","description":"Describes results of a failed Machine health probe","examples":[{"id":"FailedValidationTest","target":"DcgmFullShort","inAlertSince":null,"message":"Failed validation test:\nName:DcgmFullShort\nCommand:dcgmi\nArgs:diag -r 2","tenantMessage":null,"classifications":["PreventAllocations"]}],"properties":{"id":{"type":"string","description":"Health probe identifier"},"target":{"type":["string","null"],"description":"Specific component targeted by health probe"},"inAlertSince":{"type":["string","null"],"description":"Date/time since the alert has been in effect"},"message":{"type":"string","description":"Details of the failed health probe result"},"tenantMessage":{"type":["string","null"],"description":"Information provided by Tenant, if any"},"classifications":{"type":"array","items":{"type":"string"},"description":"Classifications for this alert, category or impact"}}},"MachineNetworkInterface":{"title":"MachineNetworkInterface","type":"object","description":"Describes information about an Ethernet Interface of a Machine","examples":[{"macAddress":"c8:4b:d6:7b:ac:a8","vendor":"Broadcom Inc. and subsidiaries","device":"NetXtreme BCM5720 Gigabit Ethernet PCIe (PowerEdge Rx5xx LOM Board)","path":"/devices/pci0000:00/0000:00:1c.5/0000:04:00.0/net/eno8303","numaNode":0,"description":"NetXtreme BCM5720 Gigabit Ethernet PCIe (PowerEdge Rx5xx LOM Board)","slot":"0000:04:00.0"}],"properties":{"macAddress":{"type":["string","null"]},"vendor":{"type":["string","null"]},"device":{"type":["string","null"]},"path":{"type":["string","null"]},"numaNode":{"type":"integer"},"description":{"type":["string","null"]},"slot":{"type":["string","null"]}}},"MachineInfiniBandInterface":{"title":"MachineInfiniBandInterface","description":"Describes information about an Infiniband Interface of a Machine","type":"object","examples":[{"guid":"1070fd0300bd43ac","vendor":"Mellanox Technologies","device":"MT28908 Family [ConnectX-6]","path":"/devices/pci0000:c9/0000:c9:02.0/0000:ca:00.0/infiniband/ibp202s0f0","numaNode":1,"description":"MT28908 Family [ConnectX-6]","slot":"0000:ca:00.0"}],"properties":{"guid":{"type":["string","null"]},"vendor":{"type":["string","null"]},"device":{"type":["string","null"]},"path":{"type":["string","null"]},"numaNode":{"type":"integer"},"description":{"type":["string","null"]},"slot":{"type":["string","null"]}}},"MachineInstanceType":{"title":"MachineInstanceType","type":"object","description":"Associates a machine with an Instance Type","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","instanceTypeId":"41e36058-8403-4086-a9b8-39cb5bc9cb98","deprecations":[{"attribute":"id","replacedBy":"machineId","takeActionBy":"2026-07-09T00:00:00Z","notice":"'id' is being deprecated in favor of 'machineId'. Please take action prior to the specified date."}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true,"description":"Deprecated: Use `machineId` when identifying a Machine/Instance Type association. This field will be removed on July 9th, 2026 0:00 UTC.","deprecated":true},"machineId":{"type":"string"},"instanceTypeId":{"type":"string","format":"uuid"},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"}},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time"}}},"MachineInstanceTypeCreateRequest":{"title":"MachineInstanceTypeCreateRequest","type":"object","description":"Associates one or more Machines with an Instance Type.\n\nThe Machine's capabilities must be a superset of the Instance Type's required capabilities for the association to succeed.","examples":[{"machineIds":["fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","fm100htrh18t1lrjg2pqagkh3sfigr9m65dejvkq168ako07sc0uibpp5q0","fm100ht68sf2m52idrpslcjkpdj5r3tb3j5o0bkfubhoglbq47u18nknfog"]}],"properties":{"machineIds":{"type":"array","minItems":1,"items":{"type":"string"}}},"required":["machineIds"]},"ExpectedMachine":{"title":"ExpectedMachine","type":"object","description":"An Expected Machine represents a physical machine that is expected to be discovered at a site, with hardware identifiers and metadata.\n\nNote: BMC credentials (username/password) are only accepted during creation and updates but are not returned in responses.","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","bmcIpAddress":"192.168.1.100","chassisSerialNumber":"CHASSIS-12345","fallbackDPUSerialNumbers":["DPU-001","DPU-002"],"skuId":"lenovo.sr650v2.cpu.1","machineId":"fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g","rackId":"rack-01","manufacturer":"Lenovo","labels":{"environment":"production","rack":"A1"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the Expected Machine","readOnly":true},"siteId":{"type":"string","format":"uuid","description":"ID of the site the Expected Machine belongs to","readOnly":true},"bmcMacAddress":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Machine's BMC (Baseboard Management Controller)"},"chassisSerialNumber":{"type":"string","description":"Serial number of the Expected Machine's chassis"},"fallbackDPUSerialNumbers":{"type":"array","description":"Serial numbers of the Expected Machine's fallback DPUs (Data Processing Units)","items":{"type":"string"}},"skuId":{"type":["string","null"],"description":"Optional ID of the SKU associated with this Expected Machine"},"sku":{"$ref":"#/components/schemas/Sku","description":"SKU information for this Expected Machine (populated when includeRelation=Sku is specified)"},"machineId":{"type":["string","null"],"description":"Optional ID of the Machine associated with this Expected Machine"},"machine":{"$ref":"#/components/schemas/MachineSummary","description":"Machine information for this Expected Machine (populated when includeRelation=Machine is specified)"},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Machines"},"created":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the Expected Machine was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the Expected Machine was last updated","readOnly":true}}},"ExpectedMachineCreateRequest":{"title":"ExpectedMachineCreateRequest","type":"object","description":"Request data to create a new ExpectedMachine.\n\nNote: BMC credentials (username/password) are only accepted during creation and updates but are not returned in responses.","examples":[{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","bmcIpAddress":"192.168.1.100","defaultBmcUsername":"admin","defaultBmcPassword":"password123","chassisSerialNumber":"CHASSIS-12345","fallbackDPUSerialNumbers":["DPU-001","DPU-002"],"skuId":"lenovo.sr650v2.cpu.1","rackId":"rack-01","manufacturer":"Lenovo","labels":{"environment":"production","rack":"A1"}}],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the site the Expected Machine belongs to"},"bmcMacAddress":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Machine's BMC (Baseboard Management Controller)"},"defaultBmcUsername":{"type":["string","null"],"maxLength":20,"description":"Username for accessing the Expected Machine's BMC"},"defaultBmcPassword":{"type":["string","null"],"maxLength":50,"description":"Password for accessing the Expected Machine's BMC"},"chassisSerialNumber":{"type":"string","minLength":1,"maxLength":100,"description":"Serial number of the Expected Machine's chassis"},"fallbackDPUSerialNumbers":{"type":["array","null"],"description":"Serial numbers of the Expected Machine's fallback DPUs (Data Processing Units)","items":{"type":"string"}},"skuId":{"type":["string","null"],"description":"Optional ID of the SKU to associate with this Expected Machine"},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Machines"}},"required":["siteId","bmcMacAddress","chassisSerialNumber"]},"ExpectedMachineUpdateRequest":{"title":"ExpectedMachineUpdateRequest","type":"object","description":"Request data to update an existing Expected Machine.\n\nNote: BMC credentials (username/password) are only accepted during creation and updates but are not returned in responses.\n\nFor single updates (PATCH /expected-machine/{id}), the id field is optional in body and will be ignored if provided (the ID from the URL path is used).\n\nFor batch updates (PATCH /expected-machine/batch), the id field is required to identify which Expected Machine to update.","examples":[{"defaultBmcUsername":"newadmin","defaultBmcPassword":"newpassword123","chassisSerialNumber":"CHASSIS-54321","skuId":"sku-xyz789","rackId":"rack-02","manufacturer":"Lenovo","labels":{"environment":"staging","rack":"B2"}}],"properties":{"id":{"type":["string","null"],"format":"uuid","description":"ID of the Expected Machine to update.\n\nOptional for individual Expected Machine update (ignored if provided, ID from URL path is used).\n\nRequired for batch update operations."},"bmcMacAddress":{"type":["string","null"],"pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Machine's BMC (Baseboard Management Controller)"},"defaultBmcUsername":{"type":["string","null"],"maxLength":20,"description":"Username for accessing the Expected Machine's BMC"},"defaultBmcPassword":{"type":["string","null"],"maxLength":50,"description":"Password for accessing the Expected Machine's BMC"},"chassisSerialNumber":{"type":["string","null"],"minLength":1,"maxLength":100,"description":"Serial number of the Expected Machine's chassis"},"fallbackDPUSerialNumbers":{"type":["array","null"],"description":"Serial numbers of the Expected Machine's fallback DPUs (Data Processing Units)","items":{"type":"string"}},"skuId":{"type":["string","null"],"description":"Optional ID of the SKU to associate with this Expected Machine"},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Machines"}}},"ExpectedPowerShelf":{"title":"ExpectedPowerShelf","type":"object","description":"An Expected Power Shelf represents a power shelf that is expected to be discovered at a site, with hardware identifiers and metadata.\n\nNote: BMC credentials (username/password) are only accepted during creation and updates but are not returned in responses.","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","shelfSerialNumber":"SHELF-12345","bmcIpAddress":"192.168.1.100","rackId":"rack-01","manufacturer":"Delta","labels":{"environment":"production","rack":"A1"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the Expected Power Shelf","readOnly":true},"siteId":{"type":"string","format":"uuid","description":"ID of the site the Expected Power Shelf belongs to","readOnly":true},"bmcMacAddress":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Power Shelf's BMC (Baseboard Management Controller)"},"shelfSerialNumber":{"type":"string","description":"Serial number of the Expected Power Shelf"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Power Shelves"},"created":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the Expected Power Shelf was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the Expected Power Shelf was last updated","readOnly":true}}},"ExpectedPowerShelfCreateRequest":{"title":"ExpectedPowerShelfCreateRequest","type":"object","description":"Request data to create a new Expected Power Shelf.\n\nNote: BMC credentials (username/password) are only accepted during creation and updates but are not returned in responses.","examples":[{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","defaultBmcUsername":"admin","defaultBmcPassword":"password123","shelfSerialNumber":"SHELF-12345","bmcIpAddress":"192.168.1.100","rackId":"rack-01","manufacturer":"Delta","labels":{"environment":"production","rack":"A1"}}],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the site the Expected Power Shelf belongs to"},"bmcMacAddress":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Power Shelf's BMC (Baseboard Management Controller)"},"defaultBmcUsername":{"type":["string","null"],"maxLength":16,"description":"Username for accessing the Expected Power Shelf's BMC"},"defaultBmcPassword":{"type":["string","null"],"maxLength":20,"description":"Password for accessing the Expected Power Shelf's BMC"},"shelfSerialNumber":{"type":"string","minLength":1,"maxLength":32,"description":"Serial number of the Expected Power Shelf"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Power Shelves"}},"required":["siteId","bmcMacAddress","shelfSerialNumber"]},"ExpectedPowerShelfUpdateRequest":{"title":"ExpectedPowerShelfUpdateRequest","type":"object","description":"Request data to update an existing Expected Power Shelf.\n\nNote: BMC credentials (username/password) are only accepted during creation and updates but are not returned in responses.","examples":[{"defaultBmcUsername":"newadmin","defaultBmcPassword":"newpassword123","shelfSerialNumber":"SHELF-54321","bmcIpAddress":"192.168.1.200","rackId":"rack-02","manufacturer":"Delta","labels":{"environment":"staging","rack":"B2"}}],"properties":{"id":{"type":["string","null"],"format":"uuid","description":"ID of the Expected Power Shelf to update (ignored for single update, used for identification in batch operations)."},"bmcMacAddress":{"type":["string","null"],"pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Power Shelf's BMC (Baseboard Management Controller)"},"defaultBmcUsername":{"type":["string","null"],"maxLength":16,"description":"Username for accessing the Expected Power Shelf's BMC"},"defaultBmcPassword":{"type":["string","null"],"maxLength":20,"description":"Password for accessing the Expected Power Shelf's BMC"},"shelfSerialNumber":{"type":["string","null"],"minLength":1,"maxLength":32,"description":"Serial number of the Expected Power Shelf"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Power Shelves"}}},"ExpectedRack":{"title":"ExpectedRack","type":"object","description":"An Expected Rack represents a rack that is expected to be discovered at a Site. The `rackId` is an operator-supplied string identifier (not a UUID) that uniquely identifies the rack within the Site. Each Expected Rack references a Rack Profile that describes the rack's expected layout and capabilities.\n\nChassis identity and physical location information are conveyed via well-known label keys in `labels`:\n- `chassis.manufacturer`, `chassis.serial-number`, `chassis.model`\n- `location.region`, `location.datacenter`, `location.room`, `location.position`","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","rackId":"rack-01","siteId":"f97df110-f4de-492e-8849-4a6af68026b0","rackProfileId":"rp-standard-42u","name":"Rack 01","description":"Production rack in row A","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001001","chassis.model":"GB200-NVL72","location.region":"us-west-2","location.datacenter":"phx-dc01","location.room":"room-1","location.position":"A1"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier (UUID) for the Expected Rack","readOnly":true},"rackId":{"type":"string","description":"Operator-supplied identifier for the rack (string, not UUID). Unique within a Site.","readOnly":true},"siteId":{"type":"string","format":"uuid","description":"ID of the Site the Expected Rack belongs to","readOnly":true},"rackProfileId":{"type":"string","description":"Identifier of the Rack Profile this rack conforms to"},"name":{"type":"string","description":"Human-readable name of the Expected Rack"},"description":{"type":"string","description":"Human-readable description of the Expected Rack"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Racks. Well-known keys (`chassis.*`, `location.*`) are used to convey chassis identity and physical location."},"created":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the Expected Rack was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the Expected Rack was last updated","readOnly":true}}},"ExpectedRackCreateRequest":{"title":"ExpectedRackCreateRequest","type":"object","description":"Request data to create a new Expected Rack.\n\nThe `rackId` is an operator-supplied string identifier (not a UUID) that must be unique within the Site. Chassis identity and physical location information are conveyed via well-known label keys in `labels`:\n- `chassis.manufacturer`, `chassis.serial-number`, `chassis.model`\n- `location.region`, `location.datacenter`, `location.room`, `location.position`","examples":[{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","rackId":"rack-01","rackProfileId":"rp-standard-42u","name":"Rack 01","description":"Production rack in row A","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001001","chassis.model":"GB200-NVL72","location.region":"us-west-2","location.datacenter":"phx-dc01","location.room":"room-1","location.position":"A1"}}],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site the Expected Rack belongs to"},"rackId":{"type":"string","minLength":1,"description":"Operator-supplied identifier for the rack (string, not UUID). Must be non-empty and unique within the Site."},"rackProfileId":{"type":"string","minLength":1,"description":"Identifier of the Rack Profile this rack conforms to. Must be non-empty."},"name":{"type":["string","null"],"minLength":1,"description":"Human-readable name of the Expected Rack"},"description":{"type":["string","null"],"minLength":1,"description":"Human-readable description of the Expected Rack"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Racks. Well-known keys (`chassis.*`, `location.*`) are used to convey chassis identity and physical location."}},"required":["siteId","rackId","rackProfileId"]},"ExpectedRackList":{"title":"ExpectedRackList","type":"object","description":"Replace-all request body for Expected Racks. The `expectedRacks` array contains the full desired set of Expected Racks for the Site identified by `siteId`. All entries must reference the same `siteId` as the top-level field, and `rackId` values must be unique within the request. The array may be empty to clear all Expected Racks for the Site.","examples":[{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","expectedRacks":[{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","rackId":"rack-01","rackProfileId":"rp-standard-42u","name":"Rack 01","description":"Production rack in row A","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001001","chassis.model":"GB200-NVL72","location.datacenter":"phx-dc01","location.position":"A1"}},{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","rackId":"rack-02","rackProfileId":"rp-standard-42u","name":"Rack 02","description":"Production rack in row A","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001002","chassis.model":"GB200-NVL72","location.datacenter":"phx-dc01","location.position":"A2"}}]}],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site whose Expected Racks should be replaced"},"expectedRacks":{"type":"array","description":"The full desired set of Expected Racks for the Site. Every entry must reference the same `siteId` as the top-level field, and `rackId` values must be unique within the request. May be empty to clear all Expected Racks for the Site.","items":{"$ref":"#/components/schemas/ExpectedRackCreateRequest"}}},"required":["siteId","expectedRacks"]},"ExpectedRackUpdateRequest":{"title":"ExpectedRackUpdateRequest","type":"object","description":"Request data to update an existing Expected Rack.\n\nFor single updates (PATCH /expected-rack/{id}), the `id` field is optional in the body and will be ignored if provided (the `id` from the URL path is used).\n\nChassis identity and physical location information are conveyed via well-known label keys in `labels`:\n- `chassis.manufacturer`, `chassis.serial-number`, `chassis.model`\n- `location.region`, `location.datacenter`, `location.room`, `location.position`","examples":[{"rackProfileId":"rp-standard-48u","name":"Rack 01 (updated)","description":"Production rack in row A, upgraded chassis","labels":{"chassis.manufacturer":"NVIDIA","chassis.serial-number":"NVRK0001001","chassis.model":"GB200-NVL72","location.datacenter":"phx-dc01","location.position":"A1"}}],"properties":{"id":{"type":["string","null"],"format":"uuid","description":"Unique identifier (UUID) of the Expected Rack to update. Optional for single Expected Rack update (must be empty or match the id from the URL path)."},"rackId":{"type":["string","null"],"minLength":1,"description":"Optional new operator-supplied rack identifier. If provided, must be non-empty and unique within the Site."},"rackProfileId":{"type":["string","null"],"minLength":1,"description":"Optional new Rack Profile identifier. If provided, must be non-empty."},"name":{"type":["string","null"],"minLength":1,"description":"Human-readable name of the Expected Rack"},"description":{"type":["string","null"],"minLength":1,"description":"Human-readable description of the Expected Rack"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Racks. Well-known keys (`chassis.*`, `location.*`) are used to convey chassis identity and physical location."}}},"ExpectedSwitch":{"title":"ExpectedSwitch","type":"object","description":"An Expected Switch represents a network switch that is expected to be discovered at a site, with hardware identifiers and metadata.\n\nNote: BMC and NvOS credentials (username/password) are only accepted during creation and updates but are not returned in responses.","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","bmcIpAddress":"192.168.1.100","switchSerialNumber":"SWITCH-12345","rackId":"rack-01","manufacturer":"NVIDIA","labels":{"environment":"production","rack":"A1"},"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the Expected Switch","readOnly":true},"siteId":{"type":"string","format":"uuid","description":"ID of the site the Expected Switch belongs to","readOnly":true},"bmcMacAddress":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Switch's BMC (Baseboard Management Controller)"},"switchSerialNumber":{"type":"string","description":"Serial number of the Expected Switch"},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Switches"},"created":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the Expected Switch was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the Expected Switch was last updated","readOnly":true}}},"ExpectedSwitchCreateRequest":{"title":"ExpectedSwitchCreateRequest","type":"object","description":"Request data to create a new Expected Switch.\n\nNote: BMC and NvOS credentials (username/password) are only accepted during creation and updates but are not returned in responses.","examples":[{"siteId":"f97df110-f4de-492e-8849-4a6af68026b0","bmcMacAddress":"00:1A:2B:3C:4D:5E","bmcIpAddress":"192.168.1.100","defaultBmcUsername":"admin","defaultBmcPassword":"password123","switchSerialNumber":"SWITCH-12345","nvOsUsername":"nvadmin","nvOsPassword":"nvpassword123","rackId":"rack-01","manufacturer":"NVIDIA","labels":{"environment":"production","rack":"A1"}}],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the site the Expected Switch belongs to"},"bmcMacAddress":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Switch's BMC (Baseboard Management Controller)"},"defaultBmcUsername":{"type":["string","null"],"maxLength":16,"description":"Username for accessing the Expected Switch's BMC"},"defaultBmcPassword":{"type":["string","null"],"maxLength":20,"description":"Password for accessing the Expected Switch's BMC"},"switchSerialNumber":{"type":"string","minLength":1,"maxLength":32,"description":"Serial number of the Expected Switch"},"nvOsUsername":{"type":["string","null"],"description":"NvOS username for the Expected Switch"},"nvOsPassword":{"type":["string","null"],"description":"NvOS password for the Expected Switch"},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Switches"}},"required":["siteId","bmcMacAddress","switchSerialNumber"]},"ExpectedSwitchUpdateRequest":{"title":"ExpectedSwitchUpdateRequest","type":"object","description":"Request data to update an existing Expected Switch.\n\nNote: BMC and NvOS credentials (username/password) are only accepted during creation and updates but are not returned in responses.","examples":[{"defaultBmcUsername":"newadmin","defaultBmcPassword":"newpassword123","switchSerialNumber":"SWITCH-54321","nvOsUsername":"newnvadmin","nvOsPassword":"newnvpassword123","rackId":"rack-02","manufacturer":"NVIDIA","labels":{"environment":"staging","rack":"B2"}}],"properties":{"id":{"type":["string","null"],"format":"uuid","description":"ID of the Expected Switch to update (ignored for single update, used for identification in batch operations)."},"bmcMacAddress":{"type":["string","null"],"pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$","description":"MAC address of the Expected Switch's BMC (Baseboard Management Controller)"},"defaultBmcUsername":{"type":["string","null"],"maxLength":16,"description":"Username for accessing the Expected Switch's BMC"},"defaultBmcPassword":{"type":["string","null"],"maxLength":20,"description":"Password for accessing the Expected Switch's BMC"},"switchSerialNumber":{"type":["string","null"],"minLength":1,"maxLength":32,"description":"Serial number of the Expected Switch"},"nvOsUsername":{"type":["string","null"],"description":"NvOS username for the Expected Switch"},"nvOsPassword":{"type":["string","null"],"description":"NvOS password for the Expected Switch"},"rackId":{"type":["string","null"],"description":"Optional rack identifier for this component"},"bmcIpAddress":{"type":["string","null"],"description":"Optional BMC IP address (IPv4 or IPv6). When set, pre-allocates a reserved IP for the BMC."},"name":{"type":["string","null"],"description":"Display name for this component"},"manufacturer":{"type":["string","null"],"description":"Manufacturer of this component"},"model":{"type":["string","null"],"description":"Model of this component"},"description":{"type":["string","null"],"description":"Description of this component"},"firmwareVersion":{"type":["string","null"],"description":"Firmware version of this component"},"slotId":{"type":["integer","null"],"format":"int32","description":"Slot ID within the rack"},"trayIdx":{"type":["integer","null"],"format":"int32","description":"Tray index within the rack"},"hostId":{"type":["integer","null"],"format":"int32","description":"Host ID within the tray"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Switches"}}},"Sku":{"title":"Sku","type":"object","description":"A SKU (Stock Keeping Unit) represents a unique hardware configuration discovered at a site.\nSKUs are automatically derived from machine hardware characteristics and used to group similar machines.","examples":[{"id":"lenovo.sr650v2.cpu.1","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","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"}],"properties":{"id":{"type":"string","description":"Unique identifier for the SKU","readOnly":true},"siteId":{"type":"string","format":"uuid","description":"ID of the Site this SKU belongs to","readOnly":true},"deviceType":{"type":["string","null"],"description":"Optional device type identifier (e.g. \"gpu\", \"cpu\", \"storage\")","readOnly":true},"associatedMachineIds":{"type":"array","description":"List of machine IDs associated with this SKU","items":{"type":"string"},"readOnly":true},"components":{"$ref":"#/components/schemas/SkuComponents","description":"Hardware components of this SKU"},"created":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the SKU was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"ISO 8601 datetime when the SKU was last updated","readOnly":true}}},"SkuComponents":{"title":"SkuComponents","type":"object","description":"Hardware components that make up a SKU","properties":{"cpus":{"type":"array","description":"CPU components","items":{"$ref":"#/components/schemas/SkuCpu"}},"gpus":{"type":"array","description":"GPU components","items":{"$ref":"#/components/schemas/SkuGpu"}},"memory":{"type":"array","description":"Memory components","items":{"$ref":"#/components/schemas/SkuMemory"}},"storage":{"type":"array","description":"Storage components","items":{"$ref":"#/components/schemas/SkuStorage"}},"chassis":{"$ref":"#/components/schemas/SkuChassis","description":"Chassis component"},"ethernetDevices":{"type":"array","description":"Ethernet device components","items":{"$ref":"#/components/schemas/SkuEthernetDevice"}},"infinibandDevices":{"type":"array","description":"Infiniband device components","items":{"$ref":"#/components/schemas/SkuInfinibandDevice"}},"tpm":{"type":"array","description":"TPM components","items":{"$ref":"#/components/schemas/SkuTpm"}}}},"SkuCpu":{"title":"SkuCpu","type":"object","description":"CPU component in a SKU","properties":{"vendor":{"type":"string","description":"Vendor of the CPU"},"model":{"type":"string","description":"Model of the CPU"},"threadCount":{"type":"integer","format":"uint32","description":"Number of threads for the CPU"},"count":{"type":"integer","format":"uint32","description":"Number of CPUs present"}}},"SkuGpu":{"title":"SkuGpu","type":"object","description":"GPU component in a SKU","properties":{"vendor":{"type":"string","description":"Vendor of the GPU"},"model":{"type":"string","description":"Model of the GPU"},"totalMemory":{"type":"string","description":"Total memory of the GPU (e.g. \"80GB HBM3\")"},"count":{"type":"integer","format":"uint32","description":"Number of GPUs present"}}},"SkuMemory":{"title":"SkuMemory","type":"object","description":"Memory component in a SKU","properties":{"capacityMb":{"type":"integer","format":"uint32","description":"Capacity in megabytes"},"memoryType":{"type":"string","description":"Type of memory (e.g. \"DDR4\", \"DDR5\")"},"count":{"type":"integer","format":"uint32","description":"Number of memory modules present"}}},"SkuStorage":{"title":"SkuStorage","type":"object","description":"Storage component in a SKU","properties":{"vendor":{"type":"string","description":"Vendor of the storage device"},"model":{"type":"string","description":"Model of the storage device"},"capacityMb":{"type":"integer","format":"uint32","description":"Capacity in megabytes"},"count":{"type":"integer","format":"uint32","description":"Number of storage devices present"}}},"SkuChassis":{"title":"SkuChassis","type":"object","description":"Chassis component in a SKU","properties":{"vendor":{"type":"string","description":"Vendor of the chassis"},"model":{"type":"string","description":"Model of the chassis"}}},"SkuEthernetDevice":{"title":"SkuEthernetDevice","type":"object","description":"Ethernet device component in a SKU","properties":{"vendor":{"type":"string","description":"Vendor of the ethernet device"},"model":{"type":"string","description":"Model of the ethernet device"},"count":{"type":"integer","format":"uint32","description":"Number of ethernet devices present"}}},"SkuInfinibandDevice":{"title":"SkuInfinibandDevice","type":"object","description":"Infiniband device component in a SKU","properties":{"vendor":{"type":"string","description":"Vendor of the infiniband device"},"model":{"type":"string","description":"Model of the infiniband device"},"count":{"type":"integer","format":"uint32","description":"Number of infiniband devices present"}}},"SkuTpm":{"title":"SkuTpm","type":"object","description":"TPM component in a SKU","properties":{"vendor":{"type":"string","description":"Vendor of the TPM"},"model":{"type":"string","description":"Model of the TPM"},"count":{"type":"integer","format":"uint32","description":"Number of TPMs present"}}},"IpBlock":{"title":"IpBlock","type":"object","description":"IP block contains information about an IPv4 address pool owned by the Infrastructure Provider and assigned as an overlay network for a particular Site. It is equivalent to Network Resource in product terminology.","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Public Network Overlay for Site SJC4","description":"This is the primary IP overlay for SJC4. All IPs are publicly routable","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantId":null,"routingType":"Public","prefix":"202.168.16.0","prefixLength":20,"protocolVersion":"IPv4","status":"Pending","statusHistory":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"siteId":{"type":"string","format":"uuid"},"infrastructureProviderId":{"type":"string","format":"uuid"},"tenantId":{"type":["string","null"],"format":"uuid"},"routingType":{"type":"string","enum":["Public","DatacenterOnly"]},"prefix":{"type":"string","description":"Either IPv4 or IPv6 address"},"prefixLength":{"type":"integer","example":24,"description":"Min: 1, Max: 32 for ipv4, 128 for ipv6"},"protocolVersion":{"type":"string","enum":["IPv4","IPv6"]},"usageStats":{"$ref":"#/components/schemas/IpBlockUsageStats"},"status":{"$ref":"#/components/schemas/IpBlockStatus"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"}},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"IpBlockSummary":{"title":"IpBlockSummary","type":"object","description":"Describes a subset of core attributes of an IP block","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"Public Network Overlay for Site SJC4","routingType":"Public","prefix":"202.168.16.0","prefixLength":20,"status":"Pending"}],"properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256},"routingType":{"type":"string","enum":["Public","DatacenterOnly"]},"prefix":{"type":"string","description":"Either IPv4 or IPv6 address"},"prefixLength":{"type":"integer","example":24,"description":"Min: 1, Max: 32 for ipv4, 128 for ipv6"},"status":{"$ref":"#/components/schemas/IpBlockStatus"}}},"IpBlockStatus":{"title":"IpBlockStatus","type":"string","description":"Status values for IP Block objects","enum":["Pending","Provisioning","Ready","Deleting","Error"]},"IpBlockUsageStats":{"title":"IpBlockUsageStats","type":"object","examples":[{"availableIPs":256,"acquiredIPs":2,"availablePrefixes":["192.168.201.0/24"],"availableSmallestPrefixes":64,"acquiredPrefixes":0}],"properties":{"availableIPs":{"type":"integer","format":"int64","description":"Number of IP addresses available in the block","readOnly":true},"acquiredIPs":{"type":"integer","format":"int64","description":"Number of individual IP addresses acquired from the block","readOnly":true},"availablePrefixes":{"type":"array","format":"uuid","description":"Example prefixes available to acquire","items":{"type":"string","readOnly":true}},"availableSmallestPrefixes":{"type":"integer","description":"Number of smallest prefixes available to acquire","format":"int64","readOnly":true},"acquiredPrefixes":{"type":"integer","format":"int64","description":"Number of prefixes acquired from this block"}},"description":"Usa statistics for an IP Block"},"IpBlockCreateRequest":{"title":"IpBlockCreateRequest","type":"object","description":"Request data for creating IP block","examples":[{"name":"Public Network Overlay for Site SJC4","description":"This is the primary IP overlay for SJC4. All IPs are publicly routable","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","routingType":"Public","prefix":"202.168.1.0","prefixLength":24,"protocolVersion":"IPv4"}],"properties":{"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"siteId":{"type":"string","format":"uuid"},"routingType":{"type":"string","enum":["Public","DatacenterOnly"]},"prefix":{"type":"string","description":"Either IPv4 or IPv6 address"},"prefixLength":{"type":"integer","description":"Min: 1, Max: 32 for IPv4, 128 for IPv6"},"protocolVersion":{"type":"string","enum":["IPv4","IPv6"]}},"required":["name","siteId","routingType","prefix","prefixLength","protocolVersion"]},"IpBlockUpdateRequest":{"title":"IpBlockUpdateRequest","type":"object","description":"Request data for editing IP block","examples":[{"name":"Public Network Overlay for Site SJC4","description":"This is the primary IP overlay for SJC4. All IPs are publicly routable"}],"properties":{"name":{"type":["string","null"],"minLength":2,"maxLength":256},"description":{"type":["string","null"]}}},"NetworkSecurityGroup":{"type":"object","examples":[{"id":"2a21cf79-ea5e-4d28-b585-2e78948fcefb","name":"Spark VPC Firewall","description":"Security policies for machines in Spark VPC","siteId":"56f1a3ed-3653-454f-b861-9136207be660","tenantId":"79595ebe-934f-4f19-bc74-c16aefd0c57a","status":"Pending","statusHistory":[{"status":"Ready","message":"processed network security group creation request","created":"2025-02-26T18:17:44.862879-05:00","updated":"2025-02-26T18:17:44.862879-05:00"}],"rules":[{"name":"allow-http-from-public","direction":"INGRESS","sourcePortRange":"80-81","destinationPortRange":"180-181","protocol":"TCP","action":"PERMIT","priority":55,"sourcePrefix":"0.0.0.0/0","destinationPrefix":"1.1.1.1/0"}],"labels":{"flavor":"coconut"},"created":"2025-02-26T18:17:44.861317-05:00","updated":"2025-02-26T18:17:44.861317-05:00"}],"description":"Network Security Group is an aggregate of security policies","properties":{"id":{"type":"string"},"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"siteId":{"type":"string","format":"uuid"},"tenantId":{"type":"string","format":"uuid"},"status":{"$ref":"#/components/schemas/NetworkSecurityGroupStatus"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"}},"statefulEgress":{"type":"boolean"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/NetworkSecurityGroupRule"}},"labels":{"$ref":"#/components/schemas/Labels"},"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"}}},"NetworkSecurityGroupStatus":{"title":"NetworkSecurityGroupStatus","type":"string","description":"Status values for Network Security Group objects","enum":["Pending","Provisioning","Ready","Deleting","Error"]},"NetworkSecurityGroupCreateRequest":{"type":"object","examples":[{"name":"Spark VPC Firewall","description":"Security policies for machines in Spark VPC","siteId":"188a8f32-0001-45cf-b243-f62720a22cc4","rules":[{"name":"allow-http-from-public","direction":"INGRESS","sourcePortRange":"80-81","destinationPortRange":"180-181","protocol":"TCP","action":"PERMIT","priority":55,"sourcePrefix":"0.0.0.0/0","destinationPrefix":"1.1.1.1/0"}],"labels":{"flavor":"coconut"}}],"description":"Request data to create a Network Security Group","properties":{"name":{"type":"string","minLength":2,"maxLength":256},"description":{"type":["string","null"]},"siteId":{"type":"string","format":"uuid"},"statefulEgress":{"type":"boolean","description":"Egress rules with protocol and destination ports defined but without source ports defined should automatically be made stateful."},"rules":{"type":"array","items":{"$ref":"#/components/schemas/NetworkSecurityGroupRule"}},"labels":{"$ref":"#/components/schemas/Labels"}},"required":["name","siteId"]},"NetworkSecurityGroupUpdateRequest":{"type":"object","examples":[{"name":"Spark VPC Firewall","description":"Security policies for machines in Spark VPC","rules":[{"name":"allow-http-from-public","direction":"INGRESS","sourcePortRange":"80-81","destinationPortRange":"180-181","protocol":"TCP","action":"PERMIT","priority":55,"sourcePrefix":"0.0.0.0/0","destinationPrefix":"1.1.1.1/0"}],"labels":{"flavor":"coconut"}}],"description":"Request data to update a Network Security Group","properties":{"name":{"type":["string","null"],"minLength":2,"maxLength":256},"description":{"type":["string","null"]},"statefulEgress":{"type":"boolean","description":"Egress rules with protocol and destination ports defined but without source ports defined should automatically be made stateful."},"rules":{"type":"array","description":"Update rules of the NetworkSecurityGroup. The rules will be entirely replaced by those sent in the request. Any rules not included in the request will be removed. To retain existing rules, first fetch them and include them. ","items":{"$ref":"#/components/schemas/NetworkSecurityGroupRule"}},"labels":{"$ref":"#/components/schemas/Labels"}}},"NetworkSecurityGroupRule":{"title":"NetworkSecurityGroupRule","type":"object","description":"Aggregation of Network Security Group rules","properties":{"name":{"type":["string","null"]},"direction":{"type":"string","enum":["INGRESS","EGRESS"],"example":"INGRESS"},"sourcePortRange":{"type":["string","null"],"example":"80-81"},"destinationPortRange":{"type":["string","null"],"example":"80-81"},"protocol":{"type":"string","enum":["TCP","UDP","ICMP","ANY"],"example":"TCP"},"action":{"type":"string","enum":["PERMIT","DENY"],"example":"PERMIT"},"priority":{"type":"integer"},"sourcePrefix":{"type":"string","example":"10.5.44.0/24"},"destinationPrefix":{"type":"string","example":"10.5.44.0/24"}},"required":["direction","protocol","action","sourcePrefix","destinationPrefix"]},"NetworkSecurityGroupPropagationDetails":{"title":"NetworkSecurityGroupPropagationDetails","type":"object","description":"The Network Security Group propagation details for a VPC or Instance","properties":{"id":{"type":"string","format":"uuid","description":"The VPC or Instance ID"},"detailedStatus":{"type":"string","enum":["None","Partial","Full","Unknown","Error"]},"status":{"$ref":"#/components/schemas/NetworkSecurityGroupPropagationStatus"},"details":{"type":["string","null"]},"unpropagatedInstanceIds":{"type":"array","items":{"type":"string","format":"uuid"}},"relatedInstanceIds":{"type":"array","items":{"type":"string","format":"uuid"}}}},"NetworkSecurityGroupPropagationStatus":{"title":"NetworkSecurityGroupPropagationStatus","type":"string","description":"Status values for Network Security Group propagation","enum":["Synchronizing","Synchronized","Error"]},"StatusDetail":{"title":"StatusDetail","type":"object","description":"Describes the details of a status transition for a resource","properties":{"status":{"type":"string"},"message":{"type":["string","null"]},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}},"examples":[{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}]},"SshKeyGroup":{"title":"SshKeyGroup","type":"object","description":"Describes the model that groups SSH Keys","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","version":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75","siteAssociations":[{"site":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":true,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Registered"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"sshKeys":[{"id":"ff06da79-707a-4069-8623-211d49ae96c8","name":"sre-ssh-reno","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"status":"Syncing","statusHistory":[{"status":"Syncing","message":"Group is being synced to Sites","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","description":"Unique identifier for the SSH Key Group","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the SSH Key Group"},"description":{"type":["string","null"],"description":"Description for the SSH Key Group, optional"},"org":{"type":"string","description":"Organization this SSH Key Group belongs to"},"tenantId":{"type":"string","format":"uuid","description":"ID of the Tenane the SSH Key Group belongs to"},"version":{"type":["string","null"],"description":"Version of the SSH Key Group","example":"fbc692b61ffef6fbfc38a3833f6b7e7ae508da75"},"sshKeys":{"type":"array","description":"SSH Keys associated with this SSH Key Group","items":{"$ref":"#/components/schemas/SshKey"}},"siteAssociations":{"type":"array","description":"Sites the SSH Key Group is synced to","items":{"$ref":"#/components/schemas/SshKeyGroupSiteAssociation"}},"status":{"$ref":"#/components/schemas/SshKeyGroupStatus","description":"Status of the SSH Key Group"},"statusHistory":{"type":"array","description":"History of the SSH Key Group states","items":{"$ref":"#/components/schemas/StatusDetail"}},"created":{"type":"string","format":"date-time","description":"Date/time when the SSH key was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"Date/time when the SSH key was last updated","readOnly":true}}},"SshKeyGroupStatus":{"title":"SshKeyGroupStatus","type":"string","description":"Status values for SSH Key Group objects","enum":["Syncing","Synced","Error","Deleting"]},"SshKeyGroupSiteAssociation":{"title":"SshKeyGroupSiteAssociation","type":"object","description":"Describes the relationship between an SSH Key Group and a Site","examples":[{"site":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"sjc-central-1","infrastructureProviderId":"5f2cc306-76e9-4fca-9186-950c9ef9a74e","isSerialConsoleEnabled":true,"isOnline":false,"capabilities":{"nativeNetworking":false,"networkSecurityGroup":true,"nvLinkPartition":false,"flow":false,"imageBasedOperatingSystem":false},"status":"Pending"},"status":"Syncing","version":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"site":{"$ref":"#/components/schemas/SiteSummary"},"status":{"$ref":"#/components/schemas/SshKeyGroupSiteAssociationStatus"},"version":{"type":["string","null"],"description":"Version of the Key Group on Site","example":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3"},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"SshKeyGroupSiteAssociationStatus":{"title":"SshKeyGroupSiteAssociationStatus","type":"string","description":"Status values for SSH Key Group Site Association objects","enum":["Syncing","Synced","Pending","Error","Deleting"]},"SshKeyGroupCreateRequest":{"title":"SshKeyGroupCreateRequest","type":"object","description":"Request data to create an SSH Key Group","examples":[{"name":"reno-integration-sre","description":"SRE access SSH keys for Reno Integration","siteIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"sshKeyIds":["ff06da79-707a-4069-8623-211d49ae96c8"]}],"properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"siteIds":{"type":"array","items":{"type":"string","format":"uuid"}},"sshKeyIds":{"type":"array","items":{"type":"string","format":"uuid"}}},"required":["name"]},"SshKeyGroupUpdateRequest":{"title":"SshKeyGroupUpdateRequest","type":"object","description":"Request data to update an SSH Key Group","examples":[{"name":"reno-int-sre","description":"SRE access SSH keys for Reno Integration Site","siteIds":["497f6eca-6276-4993-bfeb-53cbbbba6f08","05d6e108-9f06-44c9-be47-7ab4d62b20d0"],"sshKeyIds":["ff06da79-707a-4069-8623-211d49ae96c8","30fc7238-133d-42f7-8d29-866658b0c019"],"version":"098f6bcd4621d373cade4e832627b4f6"}],"properties":{"name":{"type":["string","null"]},"description":{"type":["string","null"]},"siteIds":{"type":"array","description":"When specified, replaces existing Site associations","items":{"type":"string","format":"uuid"}},"sshKeyIds":{"type":"array","description":"When specified, replaces existing SSH Key associations","items":{"type":"string","format":"uuid"}},"version":{"type":"string","description":"Version of the SSH Key Group being modified must be provided"}},"required":["version"]},"SshKey":{"title":"SshKey","type":"object","description":"Details of SSH public key","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"sre-ssh-reno","org":"wdksahew1rqf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","fingerprint":"CaK2yoj5fDOhf1swM2kFyjQrd3bwZfDYlWnVjBHgveQ","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","description":"Unique identifier for the key","format":"uuid","readOnly":true},"name":{"type":"string"},"org":{"type":"string"},"tenantId":{"type":"string","format":"uuid"},"fingerprint":{"type":"string","description":"SHA256 fingerprint of the public key"},"created":{"type":"string","format":"date-time","description":"Date/time when the SSH key was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"Date/time when the SSH key was last updated","readOnly":true}}},"SshKeyCreateRequest":{"title":"SshKeyCreateRequest","type":"object","description":"Request data to create an SSH key","examples":[{"name":"sre-ssh-reno","publicKey":"ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAICip4hl6WjuVHs60PeikVUs0sWE/kPhk2D0rRHWsIuyL jdoe@test.com","sshKeyGroupId":"0b5be54a-65ee-4a85-9928-90e6bca22dac"}],"properties":{"name":{"type":"string","description":"Name cannot match that name an existing SSH Key"},"publicKey":{"type":"string","description":"Must be an SSH key of type: RSA, ECDSA or ED25519","pattern":"^ssh-(rsa|ecdsa|ed25519) AAAA[0-9A-Za-z+/]+[=]{0,3}(\\s+.+)?$"},"sshKeyGroupId":{"type":["string","null"],"format":"uuid","description":"ID of the SSH Key Group this key should be attached to"}},"required":["name","publicKey"]},"SshKeyUpdateRequest":{"title":"SshKeyUpdateRequest","type":"object","description":"Request data to update an SSH key","examples":[{"name":"sre-ssh-reno-integration"}],"properties":{"name":{"type":["string","null"]}}},"DpuExtensionService":{"title":"DpuExtensionService","type":"object","description":"DPU Extension Service allows user defined services to run on DPUs of their Instances","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"busybox","description":"Single, multi-call executable that contains stripped-down versions of common Unix utilities","serviceType":"KubernetesPod","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0","version":"V1-T1761856992374052","versionInfo":{"version":"V1-T1761856992374052","data":"apiVersion: apps/v1\\nkind: Deployment\\nmetadata:\\n  name: busybox-deployment\\n  labels:\\n    app: busybox\\nspec:\\n  replicas: 1 # You can adjust the number of desired replicas here\\n  selector:\\n    matchLabels:\\n      app: busybox\\n  template:\\n    metadata:\\n      labels:\\n        app: busybox\\n    spec:\\n      containers:\\n      - name: busybox-container\\n        image: busybox:latest # You can specify a different BusyBox image tag\\n        command: [\"sh\", \"-c\", \"echo \\'BusyBox container running\\' && sleep 3600\"]","hasCredentials":true,"created":"2019-08-24T14:15:22Z","observability":{"configs":[{"name":"busybox-metrics","prometheus":{"scrapeIntervalSeconds":30,"endpoint":"busybox:9090"}}]}},"activeVersions":["V1-T1761857134382532","V1-T1761856992374052"],"status":"Ready","statusHistory":[{"status":"Pending","message":"DPU Service Extension is ready for use","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"},{"status":"Pending","message":"Request received, pending processing","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","description":"Unique identifier for the DPU Extension Service","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name for the DPU Extension Service. Must be unique for a given Tenant"},"description":{"type":["string","null"],"description":"Optional description for the DPU Extension Service"},"serviceType":{"type":"string","description":"Type of the DPU Extension Service","enum":["KubernetesPod"]},"siteId":{"type":"string","format":"uuid","description":"ID for the Site the DPU Extension Service belongs to"},"tenantId":{"type":"string","format":"uuid","description":"ID for the Tenant the DPU Extension Service belongs to"},"version":{"type":["string","null"],"description":"Latest version of the DPU Extension Service"},"versionInfo":{"$ref":"#/components/schemas/DpuExtensionServiceVersionInfo","description":"Details for the latest version of the DPU Extension Service"},"activeVersions":{"type":"array","description":"Latest and past versions of this DPU Extension Service that have not been deleted and are available for deployment","items":{"type":"string"}},"status":{"$ref":"#/components/schemas/DpuExtensionServiceStatus","description":"Status of the DPU Extension Service"},"statusHistory":{"type":"array","description":"History of the DPU Extension Service statuses","items":{"$ref":"#/components/schemas/StatusDetail"}},"created":{"type":"string","format":"date-time","description":"Date/time when the DPU Extension Service was created","readOnly":true},"updated":{"type":"string","format":"date-time","description":"Date/time when the DPU Extension Service was last updated","readOnly":true}}},"DpuExtensionServiceStatus":{"title":"DpuExtensionServiceStatus","type":"string","description":"Status values for DPU Extension Service objects","enum":["Pending","Ready","Error","Deleting"]},"DpuExtensionServiceSummary":{"title":"DpuExtensionServiceSummary","type":"object","description":"DPU Extension Service allows user defined services to run on DPUs of their Instances","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"busybox","serviceType":"KubernetesPod","latestVersion":"V1-T1761856992374052","status":"Ready"}],"properties":{"id":{"type":"string","description":"Unique identifier for the DPU Extension Service","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name for the DPU Extension Service. Must be unique for a given Tenant"},"serviceType":{"type":"string","description":"Type of the DPU Extension Service","enum":["KubernetesPod"]},"latestVersion":{"type":["string","null"],"description":"Latest version of the DPU Extension Service"},"status":{"$ref":"#/components/schemas/DpuExtensionServiceStatus","description":"Status of the DPU Extension Service"}}},"DpuExtensionServiceVersionInfo":{"title":"DpuExtensionServiceVersionInfo","type":"object","description":"Information about a specific version of DPU Extension Service","examples":[{"version":"V1-T1761856992374052","data":"apiVersion: apps/v1\\nkind: Deployment\\nmetadata:\\n  name: busybox-deployment\\n  labels:\\n    app: busybox\\nspec:\\n  replicas: 1 # You can adjust the number of desired replicas here\\n  selector:\\n    matchLabels:\\n      app: busybox\\n  template:\\n    metadata:\\n      labels:\\n        app: busybox\\n    spec:\\n      containers:\\n      - name: busybox-container\\n        image: busybox:latest # You can specify a different BusyBox image tag\\n        command: [\"sh\", \"-c\", \"echo \\'BusyBox container running\\' && sleep 3600\"]","hasCredentials":true,"created":"2019-08-24T14:15:22Z","observability":{"configs":[{"name":"busybox-metrics","prometheus":{"scrapeIntervalSeconds":30,"endpoint":"busybox:9090"}}]}}],"properties":{"version":{"type":["string","null"],"description":"Current version of the DPU Extension Service"},"data":{"type":"string","description":"Deployment spec for the DPU Extension Service"},"hasCredentials":{"type":"boolean","description":"Indicates whether this version was created with credentials"},"created":{"type":"string","format":"date-time","description":"Date/time when this version of the DPU Extension Service was created","readOnly":true},"observability":{"$ref":"#/components/schemas/DpuExtensionServiceObservability","description":"Observability configuration for this DPU Extension Service version"}}},"DpuExtensionServiceCreateRequest":{"title":"DpuExtensionServiceCreateRequest","type":"object","description":"Request data to create a new DPU Extension Service","examples":[{"name":"busybox","description":"Single, multi-call executable that contains stripped-down versions of common Unix utilities","serviceType":"KubernetesPod","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","data":"apiVersion: apps/v1\\nkind: Deployment\\nmetadata:\\n  name: busybox-deployment\\n  labels:\\n    app: busybox\\nspec:\\n  replicas: 1 # You can adjust the number of desired replicas here\\n  selector:\\n    matchLabels:\\n      app: busybox\\n  template:\\n    metadata:\\n      labels:\\n        app: busybox\\n    spec:\\n      containers:\\n      - name: busybox-container\\n        image: busybox:latest # You can specify a different BusyBox image tag\\n        command: [\"sh\", \"-c\", \"echo \\'BusyBox container running\\' && sleep 3600\"]","credentials":{"registryUrl":"https://registry.hub.docker.com","username":"johndoe","password":"password123"},"observability":{"configs":[{"name":"busybox-metrics","prometheus":{"scrapeIntervalSeconds":30,"endpoint":"busybox:9090"}}]}}],"properties":{"name":{"type":"string","description":"Name for the DPU Extension Service. Must be unique for a given Tenant"},"description":{"type":["string","null"],"description":"Optional description for the DPU Extension Service"},"serviceType":{"type":"string","description":"Type of the DPU Extension Service","enum":["KubernetesPod"]},"siteId":{"type":"string","format":"uuid","description":"ID for the Site the DPU Extension Service belongs to"},"data":{"type":"string","description":"Deployment spec for the DPU Extension Service"},"credentials":{"$ref":"#/components/schemas/DpuExtensionServiceCredentials","description":"Credentials to download resources specified in DPU Extension Service data"},"observability":{"$ref":"#/components/schemas/DpuExtensionServiceObservability","description":"Observability configuration for the DPU Extension Service version"}},"required":["name","serviceType","siteId","data"]},"DpuExtensionServiceUpdateRequest":{"title":"DpuExtensionServiceUpdateRequest","type":"object","description":"Request data to update an existing DPU Extension Service","examples":[{"name":"busybox-ha","data":"apiVersion: apps/v1\\nkind: Deployment\\nmetadata:\\n  name: busybox-deployment\\n  labels:\\n    app: busybox\\nspec:\\n  replicas: 3 # You can adjust the number of desired replicas here\\n  selector:\\n    matchLabels:\\n      app: busybox\\n  template:\\n    metadata:\\n      labels:\\n        app: busybox\\n    spec:\\n      containers:\\n      - name: busybox-container\\n        image: busybox:latest # You can specify a different BusyBox image tag\\n        command: [\"sh\", \"-c\", \"echo \\'BusyBox container running\\' && sleep 3600\"]","credentials":{"registryUrl":"https://registry.hub.docker.com","username":"johndoe","password":"password123"},"observability":{"configs":[{"name":"busybox-logs","logging":{"path":"/var/log/busybox.log"}}]}}],"properties":{"name":{"type":["string","null"],"description":"Name for the DPU Extension Service. Must be unique for a given Tenant"},"description":{"type":["string","null"],"description":"Optional description for the DPU Extension Service"},"data":{"type":["string","null"],"description":"Deployment spec for the DPU Extension Service"},"credentials":{"$ref":"#/components/schemas/DpuExtensionServiceCredentials","description":"Credentials to download resources specified in DPU Extension Service data"},"observability":{"$ref":"#/components/schemas/DpuExtensionServiceObservability","description":"Observability configuration for the DPU Extension Service version"}}},"DpuExtensionServiceCredentials":{"title":"DpuExtensionServiceCredentials","type":"object","description":"Credentials for retreiving resources specified in DPU Extension Service data","examples":[{"registryUrl":"https://registry.hub.docker.com","username":"johndoe","password":"password123"}],"properties":{"registryUrl":{"type":"string","description":"URL for the registry the credential should be used for"},"username":{"type":["string","null"],"description":"Username for the registry. Must be specified if registry URL is specified"},"password":{"type":["string","null"],"description":"Password for the registry. Must be specified if registry URL is specified"}}},"DpuExtensionServiceObservability":{"title":"DpuExtensionServiceObservability","type":"object","description":"Observability configuration for a DPU Extension Service version","examples":[{"configs":[{"name":"busybox-metrics","prometheus":{"scrapeIntervalSeconds":30,"endpoint":"busybox:9090"}},{"name":"busybox-logs","logging":{"path":"/var/log/busybox.log"}}]}],"properties":{"configs":{"type":"array","maxItems":20,"description":"Observability configurations to apply to the service version","items":{"$ref":"#/components/schemas/DpuExtensionServiceObservabilityConfig"}}}},"DpuExtensionServiceObservabilityConfig":{"title":"DpuExtensionServiceObservabilityConfig","type":"object","description":"A single observability configuration for a DPU Extension Service version","properties":{"name":{"type":["string","null"],"description":"Optional name of the service or component being monitored"},"prometheus":{"$ref":"#/components/schemas/DpuExtensionServiceObservabilityPrometheus"},"logging":{"$ref":"#/components/schemas/DpuExtensionServiceObservabilityLogging"}},"oneOf":[{"required":["prometheus"]},{"required":["logging"]}]},"DpuExtensionServiceObservabilityPrometheus":{"title":"DpuExtensionServiceObservabilityPrometheus","type":"object","description":"Prometheus scrape configuration for a DPU Extension Service version","properties":{"scrapeIntervalSeconds":{"type":"integer","format":"uint32","minimum":0,"maximum":4294967295,"description":"How often Prometheus should scrape the endpoint"},"endpoint":{"type":"string","description":"Prometheus scrape endpoint"}},"required":["scrapeIntervalSeconds","endpoint"]},"DpuExtensionServiceObservabilityLogging":{"title":"DpuExtensionServiceObservabilityLogging","type":"object","description":"Logging configuration for a DPU Extension Service version","properties":{"path":{"type":"string","description":"Path to the log file to collect"}},"required":["path"]},"DpuExtensionServiceDeployment":{"title":"DpuExtensionServiceDeployment","type":"object","description":"Describes a deployment of a DPU Extension Service on DPUs of an Instance","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","dpuExtensionService":{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","name":"busybox","serviceType":"KubernetesPod","latestVersion":"V1-T1761856992374052","status":"Ready"},"version":"V1-T1761856992374052","status":"Running","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the DPU Extension Service Deployment","readOnly":true},"dpuExtensionService":{"$ref":"#/components/schemas/DpuExtensionServiceSummary","description":"Summary of the DPU Extension Service. Deployed version may be different"},"version":{"type":"string","description":"Deployed version of the DPU Extension Service"},"status":{"$ref":"#/components/schemas/DpuExtensionServiceDeploymentStatus","description":"Status of the DPU Extension Service Deployment"},"created":{"type":"string","format":"date-time","description":"Date/time when this version of the DPU Extension Service Deployment was created"},"updated":{"type":"string","format":"date-time","description":"Date/time when this version of the DPU Extension Service Deployment was updated"}}},"DpuExtensionServiceDeploymentStatus":{"title":"DpuExtensionServiceDeploymentStatus","type":"string","description":"Status values for DPU Extension Service Deployment objects","enum":["Pending","Running","Error","Failed","Terminating"]},"DpuExtensionServiceDeploymentRequest":{"title":"DpuExtensionServiceDeploymentRequest","type":"object","description":"Request data to deploy of a specific version of a DPU Extension Service on DPUs of an Instance","examples":[{"dpuExtensionServiceId":"3bddb7b4-0963-4278-b311-c212dc758357","version":"V1-T1761856992374052"}],"properties":{"dpuExtensionServiceId":{"type":"string","description":"ID of the DPU Extension Service to deploy","format":"uuid"},"version":{"type":"string","description":"Version of the DPU Extension Service to deploy"}}},"User":{"title":"User","type":"object","description":"Details of the user collected from authentication tokens","examples":[{"id":"497f6eca-6276-4993-bfeb-53cbbbba6f08","email":"janed@nvidia.com","firstName":"Jane","lastName":"Doe","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","description":"Unique identifier for the given user.","format":"uuid","readOnly":true},"email":{"type":["string","null"],"format":"email"},"firstName":{"type":["string","null"]},"lastName":{"type":["string","null"]},"created":{"type":"string","format":"date-time","description":"The date that the user was created.","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"AuditEntry":{"title":"AuditEntry","type":"object","description":"Describes Audit Log Entry","examples":[{"id":"e313b3ca-c47a-4ec1-a79b-a147fad51a50","endpoint":"/v2/org/test-org-1/nico/ep","queryParams":"{\"test\":[\"1234\"]}","method":"POST","body":"{\"key1\":\"value1\"}","statusCode":200,"clientIP":"12.123.43.112","userID":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","user":{"id":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","firstName":"John","lastName":"Doe","email":"jdoe@test.com"},"orgName":"test-org-1","timestamp":"2024-12-04T21:06:33.849293-08:00","durationMs":250,"apiVersion":"0.1.91"},{"id":"e313b3ca-c47a-4ec1-a79b-a147fad51a50","endpoint":"/v2/org/test-org-1/nico/ep","queryParams":"{\"test\":[\"1234\"]}","method":"POST","body":"{\"key1\":\"value1\"}","statusCode":403,"statusMessage":"User does not have permissions","clientIP":"12.123.43.112","userID":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","user":{"id":"5d9fe319-14d4-40e3-8e5a-7d79e680d55b","firstName":"John","lastName":"Doe","email":"jdoe@test.com"},"orgName":"test-org-1","timestamp":"2024-12-04T21:06:33.849293-08:00","durationMs":50,"apiVersion":"0.1.91"}],"properties":{"id":{"type":"string","description":"Unique identifier","format":"uuid","readOnly":true},"endpoint":{"type":"string","description":"API endpoint"},"queryParams":{"type":"string","description":"Query parameters"},"method":{"type":"string","description":"HTTP method"},"body":{"type":"string","description":"HTTP body in JSON format"},"statusCode":{"type":"integer","description":"HTTP response status code"},"statusMessage":{"type":"string","description":"HTTP response status message"},"clientIP":{"type":"string","description":"Client IP address"},"userID":{"type":["string","null"],"format":"uuid","description":"User ID that executed the API call"},"user":{"$ref":"#/components/schemas/User","description":"User that executed the API call"},"orgName":{"type":"string","description":"Organization name"},"extraData":{"type":"object","description":"Extra data in JSON format"},"timestamp":{"type":"string","format":"date-time","description":"API execution time"},"durationMs":{"type":"integer","description":"API execution duration in milliseconds"},"apiVersion":{"type":"string","description":"API version"}}},"Metadata":{"title":"Metadata","type":"object","description":"Metadata about the API server","examples":[{"version":"0.1.24","buildTime":"2019-08-24T14:15:22Z"}],"properties":{"version":{"type":"string","description":"Current version of the API","readOnly":true},"buildTime":{"type":"string","description":"Date/time when the API was built","readOnly":true}}},"Deprecation":{"title":"Deprecation","type":"object","description":"Details of a particular deprecation in NVIDIA Infra Controller (NICo) API","examples":[{"attribute":"blockSize","replacedBy":"prefixLength","takeActionBy":"2023-04-15T00:00:00Z","notice":"blockSize' has been deprecated in favor of 'prefixLength'. Please take action as soon as possible"}],"properties":{"attribute":{"type":["string","null"]},"queryParam":{"type":["string","null"]},"endpoint":{"type":["string","null"]},"replacedBy":{"type":["string","null"]},"takeActionBy":{"type":"string","format":"date-time"},"notice":{"type":"string"}}},"NICoAPIError":{"title":"NICoAPIError","type":"object","description":"Describes the error response from NVIDIA Infra Controller REST API","properties":{"source":{"type":"string","description":"Source of the error.","enum":["nico"]},"message":{"type":"string","description":"Message describing the error"},"data":{"type":["object","null"],"description":"Additional data about the error"}}},"ServiceAccount":{"title":"ServiceAccount","type":"object","description":"Describes Service Account status and related entities","properties":{"enabled":{"type":"boolean","description":"Indicates whether Service Account is enabled"},"infrastructureProviderId":{"type":["string","null"],"format":"uuid","description":"ID of the Infrastructure Provider associated with Service Account"},"tenantId":{"type":["string","null"],"format":"uuid","description":"ID of the Tenant associated with Service Account"}},"examples":[{"enabled":true,"infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","tenantId":"f97df110-f4de-492e-8849-4a6af68026b0"}]},"Labels":{"title":"Labels","type":"object","maxProperties":10,"additionalProperties":{"type":"string"}},"MachineGPUStats":{"title":"MachineGPUStats","description":"GPU summary stats for a single GPU type across machines at a site","type":"object","properties":{"name":{"type":"string","description":"GPU name from the MachineCapability record"},"gpus":{"type":"integer","description":"Total number of GPUs (summation of all Machine GPU capability counts)"},"machines":{"type":"integer","description":"Number of machines that have this GPU capability"}}},"MachineStatusBreakdown":{"title":"MachineStatusBreakdown","description":"Machine counts broken down by status","type":"object","properties":{"total":{"type":"integer"},"initializing":{"type":"integer"},"ready":{"type":"integer"},"inUse":{"type":"integer"},"error":{"type":"integer"},"maintenance":{"type":"integer"},"unknown":{"type":"integer"}}},"MachineInstanceTypeSummary":{"title":"MachineInstanceTypeSummary","description":"Summary of machines grouped by assigned vs unassigned instance type","type":"object","properties":{"assigned":{"description":"Machines that have been assigned to an instance type","$ref":"#/components/schemas/MachineStatusBreakdown"},"unassigned":{"description":"Machines that have not been assigned to any instance type","$ref":"#/components/schemas/MachineStatusBreakdown"}}},"MachineInstanceTypeStats":{"title":"MachineInstanceTypeStats","description":"Detailed stats for machines of a specific instance type","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the InstanceType"},"name":{"type":"string","description":"Name of the InstanceType"},"assignedMachineStats":{"$ref":"#/components/schemas/MachineStatusBreakdown"},"allocated":{"type":"integer","description":"Number of Machines of this Instance Type allocated to Tenants"},"maxAllocatable":{"type":"integer","description":"Number of Ready Machines of this Instance Type available for additional allocation to Tenants"},"usedMachineStats":{"$ref":"#/components/schemas/MachineStatusBreakdown"},"tenants":{"type":"array","items":{"$ref":"#/components/schemas/InstanceTypeStats"}}}},"InstanceTypeStats":{"title":"InstanceTypeStats","description":"Stats for an instance type including allocation details","type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"allocated":{"type":"integer"},"usedMachineStats":{"$ref":"#/components/schemas/MachineStatusBreakdown"},"maxAllocatable":{"type":"integer"},"allocations":{"type":"array","items":{"$ref":"#/components/schemas/AllocationStats"}}}},"AllocationStats":{"title":"AllocationStats","description":"Stats for a single allocation within an instance type","type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"total":{"type":"integer"}}},"TenantInstanceTypeStats":{"title":"TenantInstanceTypeStats","description":"Per-tenant instance type allocation stats","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the Tenant"},"org":{"type":"string","description":"Organization name for the Tenant"},"orgDisplayName":{"type":"string","description":"Display name for the Tenant's organization"},"instanceTypes":{"type":"array","items":{"$ref":"#/components/schemas/InstanceTypeStats"}}}}},"securitySchemes":{"JWTBearerToken":{"type":"http","scheme":"Bearer","description":"```\nexport JWT_BEARER_TOKEN=\"<jwt-bearer-token>\"\n\n# Example org name: \"acme-inc\nexport ORG_NAME=<org-name>\n\n# Use the JWT bearer token in your API request auth header:\ncurl -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\n```"}},"responses":{"GenericHttpError":{"description":"Response when the API handler encounters an unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"},"examples":{"Example 1":{"value":{"source":"nico","message":"Error handling API request","data":null}}}}}},"NotFoundError":{"description":"Error response when requested object is not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"},"examples":{"example-1":{"value":{"source":"nico","message":"Could not find resource with specified ID","data":null}}}}}},"ForbiddenError":{"description":"Error response when user is not authorized to call an endpoint or retrieve/modify objects","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"},"examples":{"example-1":{"value":{"source":"nico","message":"User is not allowed to perform this action","data":null}}}}}},"ValidationError":{"description":"Error response when request data cannot be validated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"},"examples":{"example-1":{"value":{"source":"nico","message":"Error validating request data","data":{"name":"A value is required"}}}}}}}},"parameters":{},"requestBodies":{}},"security":[{"JWTBearerToken":[]}]}},"searchIndex":{"store":["tag/Getting-Started","tag/Service-Account","tag/Service-Account/operation/get-current-service-account","tag/Infrastructure-Provider","tag/Infrastructure-Provider/operation/get-current-infrastructure-provider","tag/Infrastructure-Provider/operation/get-current-infrastructure-provider-stats","tag/Tenant","tag/Tenant/operation/get-current-tenant","tag/Tenant/operation/get-current-tenant-stats","tag/Tenant/operation/get-tenant-instance-type-stats","tag/Tenant-Account","tag/Tenant-Account/operation/get-all-tenant-account","tag/Tenant-Account/operation/create-tenant-account","tag/Tenant-Account/operation/get-tenant-account","tag/Tenant-Account/operation/update-tenant-account","tag/Tenant-Account/operation/delete-tenant-account","tag/Site","tag/Site/operation/get-all-site","tag/Site/operation/create-site","tag/Site/operation/get-site","tag/Site/operation/update-site","tag/Site/operation/delete-site","tag/Site/operation/get-site-status-history","tag/Allocation","tag/Allocation/operation/get-all-allocation","tag/Allocation/operation/create-allocation","tag/Allocation/operation/get-allocation","tag/Allocation/operation/delete-allocation","tag/Allocation/operation/update-allocation","tag/Allocation/operation/get-all-allocation-constraint","tag/Allocation/operation/create-allocation-constraint","tag/Allocation/operation/get-allocation-constraint","tag/Allocation/operation/update-allocation-constraint","tag/Allocation/operation/delete-allocation-constraint","tag/VPC","tag/VPC/operation/get-all-vpc","tag/VPC/operation/create-vpc","tag/VPC/operation/get-vpc","tag/VPC/operation/delete-vpc","tag/VPC/operation/update-vpc","tag/VPC/operation/update-vpc-virtualization","tag/VPC-Peering","tag/VPC-Peering/operation/get-all-vpc-peering","tag/VPC-Peering/operation/create-vpc-peering","tag/VPC-Peering/operation/get-vpc-peering","tag/VPC-Peering/operation/delete-vpc-peering","tag/VPC-Prefix","tag/VPC-Prefix/operation/get-all-vpc-prefix","tag/VPC-Prefix/operation/create-vpc-prefix","tag/VPC-Prefix/operation/get-vpc-prefix","tag/VPC-Prefix/operation/delete-vpc-prefix","tag/VPC-Prefix/operation/update-vpc-prefix","tag/Subnet","tag/Subnet/operation/get-all-subnet","tag/Subnet/operation/create-subnet","tag/Subnet/operation/get-subnet","tag/Subnet/operation/delete-subnet","tag/Subnet/operation/update-subnet","tag/Expected-Machine","tag/Expected-Machine/operation/create-expected-machine","tag/Expected-Machine/operation/get-all-expected-machine","tag/Expected-Machine/operation/get-expected-machine","tag/Expected-Machine/operation/update-expected-machine","tag/Expected-Machine/operation/delete-expected-machine","tag/Expected-Machine/operation/batch-create-expected-machines","tag/Expected-Machine/operation/batch-update-expected-machines","tag/Expected-Power-Shelf","tag/Expected-Power-Shelf/operation/create-expected-power-shelf","tag/Expected-Power-Shelf/operation/get-all-expected-power-shelf","tag/Expected-Power-Shelf/operation/get-expected-power-shelf","tag/Expected-Power-Shelf/operation/update-expected-power-shelf","tag/Expected-Power-Shelf/operation/delete-expected-power-shelf","tag/Expected-Rack","tag/Expected-Rack/operation/create-expected-rack","tag/Expected-Rack/operation/get-all-expected-rack","tag/Expected-Rack/operation/replace-all-expected-rack","tag/Expected-Rack/operation/delete-all-expected-rack","tag/Expected-Rack/operation/get-expected-rack","tag/Expected-Rack/operation/update-expected-rack","tag/Expected-Rack/operation/delete-expected-rack","tag/Expected-Switch","tag/Expected-Switch/operation/create-expected-switch","tag/Expected-Switch/operation/get-all-expected-switch","tag/Expected-Switch/operation/get-expected-switch","tag/Expected-Switch/operation/update-expected-switch","tag/Expected-Switch/operation/delete-expected-switch","tag/SKU","tag/SKU/operation/get-all-sku","tag/SKU/operation/get-sku","tag/InfiniBand-Partition","tag/InfiniBand-Partition/operation/get-all-infiniband-partition","tag/InfiniBand-Partition/operation/create-infiniband-partition","tag/InfiniBand-Partition/operation/get-infiniband-partition","tag/InfiniBand-Partition/operation/delete-infiniband-partition","tag/InfiniBand-Partition/operation/update-infiniband-partition","tag/InfiniBand-Partition/operation/get-all-infiniband-interface","tag/NVLink-Logical-Partition","tag/NVLink-Logical-Partition/operation/get-all-nvlink-logical-partition","tag/NVLink-Logical-Partition/operation/create-nvlink-logical-partition","tag/NVLink-Logical-Partition/operation/get-nvlink-logical-partition","tag/NVLink-Logical-Partition/operation/update-nvlink-logical-partition","tag/NVLink-Logical-Partition/operation/delete-nvlink-logical-partition","tag/NVLink-Logical-Partition/operation/get-all-nvlink-interface","tag/Operating-System","tag/Operating-System/operation/get-all-operating-system","tag/Operating-System/operation/create-operating-system","tag/Operating-System/operation/get-operating-system","tag/Operating-System/operation/delete-operating-system","tag/Operating-System/operation/update-operating-system","tag/Instance-Type","tag/Instance-Type/operation/get-all-instance-type","tag/Instance-Type/operation/create-instance-type","tag/Instance-Type/operation/get-instance-type","tag/Instance-Type/operation/delete-instance-type","tag/Instance-Type/operation/update-instance-type","tag/Instance-Type/operation/get-instance-type-machine-association","tag/Instance-Type/operation/create-instance-type-machine-association","tag/Instance-Type/operation/delete-instance-type-machine-association","tag/Instance","tag/Instance/operation/get-all-instance","tag/Instance/operation/create-instance","tag/Instance/operation/batch-create-instance","tag/Instance/operation/get-instance","tag/Instance/operation/delete-instance","tag/Instance/operation/update-instance","tag/Instance/operation/get-instance-status-history","tag/Instance/operation/get-all-interface","tag/Instance/operation/get-all-instance-infiniband-interface","tag/Instance/operation/get-all-instance-nvlink-interface","tag/Machine","tag/Machine/operation/get-all-machine","tag/Machine/operation/get-machine","tag/Machine/operation/update-machine","tag/Machine/operation/delete-machine","tag/Machine/operation/get-machine-status-history","tag/Machine/operation/get-machine-gpu-stats","tag/Machine/operation/get-machine-instance-type-stats-summary","tag/Machine/operation/get-machine-instance-type-stats","tag/Machine/operation/get-all-machine-capabilities","tag/Machine-Capability","tag/Rack","tag/Rack/operation/get-all-rack","tag/Rack/operation/get-rack","tag/Rack/operation/validate-racks","tag/Rack/operation/validate-rack","tag/Rack/operation/power-control-racks","tag/Rack/operation/power-control-rack","tag/Rack/operation/firmware-update-racks","tag/Rack/operation/firmware-update-rack","tag/Rack/operation/bringup-racks","tag/Rack/operation/bringup-rack","tag/Rack/operation/get-rack-task","tag/Rack/operation/cancel-rack-task","tag/Tray","tag/Tray/operation/get-all-tray","tag/Tray/operation/get-tray","tag/Tray/operation/validate-trays","tag/Tray/operation/validate-tray","tag/Tray/operation/power-control-trays","tag/Tray/operation/power-control-tray","tag/Tray/operation/firmware-update-trays","tag/Tray/operation/firmware-update-tray","tag/Network-Security-Group","tag/Network-Security-Group/operation/get-all-network-security-group","tag/Network-Security-Group/operation/create-network-security-group","tag/Network-Security-Group/operation/get-network-security-group","tag/Network-Security-Group/operation/update-network-security-group","tag/Network-Security-Group/operation/delete-network-security-group","tag/IP-Block","tag/IP-Block/operation/get-all-ipblock","tag/IP-Block/operation/create-ipblock","tag/IP-Block/operation/get-ipblock","tag/IP-Block/operation/delete-ipblock","tag/IP-Block/operation/update-ipblock","tag/IP-Block/operation/get-all-derived-ipblock","tag/DPU-Extension-Service","tag/DPU-Extension-Service/operation/get-all-dpu-extension-service","tag/DPU-Extension-Service/operation/create-dpu-extension-service","tag/DPU-Extension-Service/operation/get-dpu-extension-service","tag/DPU-Extension-Service/operation/delete-dpu-extension-service","tag/DPU-Extension-Service/operation/update-dpu-extension-service","tag/DPU-Extension-Service/operation/get-dpu-extension-service-version","tag/DPU-Extension-Service/operation/delete-dpu-extension-service-version","tag/SSH-Key-Group","tag/SSH-Key-Group/operation/get-all-ssh-key-group","tag/SSH-Key-Group/operation/create-ssh-key-group","tag/SSH-Key-Group/operation/get-ssh-key-group","tag/SSH-Key-Group/operation/delete-ssh-key-group","tag/SSH-Key-Group/operation/update-ssh-key-group","tag/SSH-Key","tag/SSH-Key/operation/get-all-ssh-key","tag/SSH-Key/operation/create-ssh-key","tag/SSH-Key/operation/get-ssh-key","tag/SSH-Key/operation/delete-ssh-key","tag/SSH-Key/operation/update-ssh-key","tag/User","tag/User/operation/get-user","tag/Audit","tag/Audit/operation/get-all-audit-entry","tag/Audit/operation/get-audit-entry","tag/Metadata","tag/Metadata/operation/get-metadata","tag/Deprecations"],"index":{"version":"2.3.9","fields":["title","description"],"fieldVectors":[["title/0",[0,5.631,1,4.66]],["description/0",[1,0.433,2,0.998,3,0.533,4,0.523,5,0.523,6,2.474,7,3.737,8,1.827,9,0.998,10,0.998,11,2.764,12,0.523,13,0.523,14,0.523,15,1.111,16,0.523,17,0.022,18,0.998,19,1.246,20,0.268,21,0.316,22,0.523,23,3.015,24,1.637,25,0.998,26,0.523,27,0.523,28,1.103,29,0.523,30,0.523,31,0.433,32,0.516,33,3.878,34,0.385,35,0.523,36,0.469,37,0.469,38,0.469,39,0.469,40,0.469,41,0.469,42,0.433,43,0.469,44,0.603,45,0.469,46,0.199,47,0.523,48,0.469,49,0.523,50,1.403,51,1.295,52,1.964,53,0.1,54,0.469,55,0.646,56,0.455,57,0.469,58,0.316,59,1.282,60,2.191,61,0.523,62,0.128,63,1.282,64,0.367,65,0.21,66,0.183,67,0.352,68,0.148,69,0.523,70,0.523,71,1.773,72,1.716,73,0.406,74,0.998,75,0.523,76,0.367,77,1.251,78,0.469,79,2.059,80,1.977,81,0.433,82,0.523,83,1.282,84,1.201,85,0.469,86,0.367,87,1.827,88,0.523,89,0.523,90,0.523,91,0.523,92,0.523,93,0.523,94,0.523,95,0.523,96,1.964,97,1.419,98,0.433,99,2.587,100,1.431,101,1.431,102,0.523,103,0.523,104,0.406,105,0.523,106,0.406,107,1.46,108,1.431,109,0.469,110,1.697,111,0.433,112,1.646,113,0.998,114,1.6,115,1.827,116,0.603,117,0.826,118,0.826,119,0.998,120,0.998,121,0.998,122,1.326,123,1.235,124,0.998,125,0.719,126,0.894,127,0.894,128,0.775,129,0.784,130,0.998,131,1.014,132,0.523,133,0.523,134,0.027,135,0.316,136,0.826,137,1.34,138,0.523,139,0.34,140,0.433,141,0.523,142,0.406,143,0.406,144,0.523,145,0.268,146,0.523,147,1.052,148,0.523,149,0.791,150,0.523,151,0.998,152,0.523]],["title/1",[50,2.527,51,1.695]],["description/1",[3,0.617,6,4.355,19,3.076,50,3.64,51,2.171,52,4.849,53,0.16,54,4.849,55,3.501,56,0.558,62,0.38,63,4.849,64,3.796,65,2.168,66,1.896,67,3.639]],["title/2",[32,0.317,46,1.301,50,1.536,51,1.03,134,0.176,153,2.067]],["description/2",[6,4.498,19,3.23,32,0.526,46,2.161,50,3.729,51,2.242,67,3.821,104,4.412,134,0.292,153,3.432,154,3.986,155,4.412,156,5.682,157,3.986,158,5.682]],["title/3",[3,0.642,68,0.835]],["description/3",[3,0.787,7,3.231,11,1.401,15,2.57,20,1.695,21,1.999,32,0.306,44,4.167,53,0.098,62,0.232,68,0.913,71,2.323,72,0.745,73,2.57,76,3.556,77,0.726,134,0.17,135,1.999,139,0.787,159,1.456,160,2.226,161,1.882,162,2.142,163,3.719,164,5.097,165,5.097,166,4.141,167,3.984,168,3.845,169,2.74,170,2.142,171,2.74,172,2.966,173,2.226,174,1.259,175,2.57,176,2.966,177,2.74,178,2.142]],["title/4",[3,0.433,32,0.351,46,1.443,68,0.562,134,0.195]],["description/4",[3,0.734,17,0.266,32,0.595,46,2.446,53,0.19,62,0.452,68,0.953,134,0.33,179,0.407,180,1.008,181,0.416,182,6.432]],["title/5",[3,0.433,32,0.351,46,1.443,68,0.562,183,2.291]],["description/5",[3,0.748,17,0.271,32,0.606,46,2.493,53,0.193,68,0.972,179,0.415,180,1.027,181,0.424,183,3.959,184,6.556]],["title/6",[56,0.462]],["description/6",[7,3.413,11,1.97,15,2.302,20,1.518,21,2.81,32,0.274,44,4.269,53,0.087,56,0.448,62,0.208,71,2.08,72,0.668,73,2.302,76,3.265,77,1.02,84,1.255,134,0.152,135,1.791,139,0.704,147,2.181,161,1.686,162,3.716,163,3.929,164,5.384,165,5.384,166,4.375,167,3.716,168,3.586,169,2.454,170,3.011,171,2.454,173,1.994,174,1.128,175,2.302,177,2.454,178,1.918,185,2.965,186,2.657,187,2.657,188,2.657,189,2.657]],["title/7",[32,0.394,46,1.619,56,0.293,134,0.219]],["description/7",[17,0.271,32,0.606,46,2.493,53,0.193,56,0.451,62,0.46,134,0.337,179,0.415,181,0.424,190,1.07,191,6.556]],["title/8",[32,0.394,46,1.619,56,0.293,183,2.571]],["description/8",[17,0.276,32,0.618,46,2.542,53,0.197,56,0.46,179,0.423,181,0.432,183,4.037,190,1.091,192,6.684]],["title/9",[32,0.288,77,0.683,107,1.058,131,0.771,137,1.146,183,1.882,193,3.117]],["description/9",[3,0.648,17,0.235,53,0.167,56,0.391,77,1.633,107,1.929,125,2.932,131,1.406,137,2.09,149,3.141,179,0.36,180,0.89,181,0.367,183,3.432,194,1.99,195,2.55,196,5.682]],["title/10",[51,1.695,56,0.387]],["description/10",[3,0.762,51,2.012,56,0.568,68,0.991,178,4.324,197,5.532,198,6.684,199,6.684,200,6.684]],["title/11",[32,0.449,51,1.459,56,0.334]],["description/11",[3,0.788,17,0.242,32,0.371,51,1.207,53,0.172,56,0.403,62,0.411,68,0.595,125,1.579,134,0.301,179,0.37,180,0.628,181,0.378,190,0.655,201,3.653,202,3.534,203,4.589,204,5.938,205,1.448,206,3.534,207,4.304,208,3.594]],["title/12",[51,1.459,56,0.334,72,1.092]],["description/12",[3,0.782,17,0.164,51,2.526,53,0.117,56,0.553,62,0.278,68,1.017,72,1.306,125,1.561,128,3.078,134,0.298,135,2.394,139,0.942,153,2.394,178,2.565,179,0.251,180,0.621,181,0.256,205,1.435,206,2.394,208,3.553,209,1.937,210,4.504,211,2.565,212,2.666,213,3.553,214,3.965,215,3.965]],["title/13",[32,0.449,51,1.459,56,0.334]],["description/13",[3,0.782,17,0.24,32,0.367,51,1.193,53,0.171,56,0.399,62,0.407,68,0.588,125,1.561,134,0.298,179,0.367,180,0.621,181,0.375,190,0.647,201,3.622,202,3.504,203,4.567,204,5.91,205,1.698,206,3.504,207,4.267,216,3.281]],["title/14",[51,1.459,56,0.334,139,1.152]],["description/14",[3,0.555,11,2.062,17,0.201,51,2.021,53,0.144,56,0.529,62,0.342,68,0.722,134,0.25,136,4.031,139,1.595,153,2.941,179,0.308,181,0.315,190,0.795,202,2.941,205,1.205,206,2.941,213,6.017,216,4.031,217,4.871,218,4.871,219,4.364,220,4.871]],["title/15",[51,1.459,56,0.334,221,1.321]],["description/15",[3,0.822,17,0.224,51,2.442,53,0.16,56,0.595,62,0.38,68,0.802,72,1.218,125,2.13,134,0.278,180,0.848,205,1.339,209,2.644,216,4.478,221,1.965]],["title/16",[77,1.472]],["description/16",[3,0.427,7,2.919,11,2.356,21,3.361,44,4.009,56,0.258,66,1.313,71,3.904,72,0.844,73,2.909,77,1.22,84,1.586,97,4.32,161,2.13,162,2.424,163,3.361,167,3.6,168,3.474,170,3.6,203,2.13,219,3.358,222,3.747,223,3.101,224,2.756,225,2.629,226,3.747,227,3.747,228,3.358,229,3.904,230,4.986,231,4.605,232,3.358,233,2.424,234,4.986]],["title/17",[32,0.521,77,1.234]],["description/17",[6,3.49,17,0.239,28,3.49,32,0.535,53,0.17,77,1.267,134,0.297,179,0.366,180,0.905,181,0.374,190,0.943,201,3.607,202,3.49,203,3.285,204,4.25,235,3.285,236,5.178,237,5.178]],["title/18",[72,1.268,77,1.234]],["description/18",[3,0.682,17,0.247,53,0.176,56,0.411,62,0.42,68,0.886,72,1.734,77,1.688,134,0.396,179,0.378,180,0.937,181,0.387,237,5.359]],["title/19",[32,0.521,77,1.234]],["description/19",[3,0.751,7,3.972,17,0.196,32,0.438,51,1.425,53,0.14,56,0.453,64,3.322,68,0.702,77,1.66,107,1.607,154,3.322,159,2.083,179,0.3,180,0.742,181,0.306,190,0.773,205,1.172,238,1.864,239,4.243,240,5.569,241,1.897,242,3.919]],["title/20",[77,1.234,139,1.338]],["description/20",[3,0.627,17,0.227,19,3.126,53,0.162,56,0.378,68,0.815,77,1.908,139,1.732,179,0.348,180,0.861,181,0.355,238,2.869,242,4.551,243,5.499,244,5.499,245,4.551]],["title/21",[77,1.234,221,1.534]],["description/21",[3,0.67,17,0.243,53,0.173,62,0.413,68,0.871,77,1.669,107,1.995,134,0.302,179,0.372,180,0.921,181,0.38,221,2.301,238,2.314,242,4.864]],["title/22",[32,0.394,77,0.933,153,2.571,161,2.42]],["description/22",[3,0.744,7,3.943,17,0.193,32,0.432,51,1.406,53,0.138,56,0.449,64,3.277,68,0.692,77,1.647,107,1.585,153,2.821,154,3.277,159,2.055,161,2.655,179,0.296,180,0.732,181,0.302,190,0.762,238,1.839,239,4.185,240,5.528,241,1.871,246,4.671]],["title/23",[107,2.279]],["description/23",[3,0.793,56,0.479,71,4.881,84,2.945,107,2.361,147,5.117,247,6.957,248,6.234]],["title/24",[32,0.521,107,1.911]],["description/24",[3,0.797,17,0.328,32,0.478,53,0.152,55,4.522,56,0.481,107,1.753,134,0.359,149,2.855,179,0.327,180,0.809,181,0.334,190,0.843,240,3.8,249,4.275,250,4.275,251,4.275,252,4.629,253,4.629]],["title/25",[72,1.268,107,1.911]],["description/25",[3,0.492,17,0.178,53,0.127,62,0.303,68,0.64,72,1.389,79,1.977,80,1.899,84,1.827,99,3.572,107,2.443,110,2.158,111,3.572,129,1.192,131,1.068,134,0.317,137,1.587,145,2.209,147,3.175,179,0.273,180,0.676,181,0.279,207,4.537,253,3.867,254,4.316,255,4.316,256,4.316,257,4.316,258,3.32,259,4.316,260,4.316,261,4.316]],["title/26",[32,0.521,107,1.911]],["description/26",[3,0.822,17,0.298,32,0.501,53,0.16,56,0.496,107,2.448,134,0.278,145,2.77,179,0.342,180,0.848,181,0.35,190,0.883,195,2.429,205,1.339,240,3.981,249,4.478,250,4.478,262,4.478]],["title/27",[107,1.911,221,1.534]],["description/27",[3,0.831,17,0.227,53,0.162,56,0.378,62,0.386,68,0.815,72,1.238,107,2.775,116,3.321,125,2.165,134,0.282,160,3.698,180,0.861,205,1.361,209,2.687,221,1.498,262,4.551,263,4.551]],["title/28",[107,1.911,139,1.338]],["description/28",[3,0.84,17,0.231,53,0.165,56,0.384,62,0.392,68,0.828,107,2.798,116,3.375,134,0.287,139,1.328,160,3.758,179,0.354,180,0.875,181,0.361,262,4.625,263,4.625,264,2.794]],["title/29",[32,0.449,107,1.646,258,2.61]],["description/29",[3,0.851,17,0.267,32,0.426,53,0.19,56,0.444,62,0.524,68,0.958,72,1.037,107,2.745,125,2.543,134,0.332,180,0.722,190,0.752,195,2.068,205,1.14,209,3.157,258,2.48,265,3.577,266,4.129]],["title/30",[72,1.092,107,1.646,258,2.61]],["description/30",[3,0.84,17,0.231,53,0.165,62,0.392,68,0.828,72,1.659,107,2.798,125,2.2,134,0.287,179,0.354,180,0.875,181,0.361,205,1.383,258,3.008,265,4.339,266,5.008]],["title/31",[32,0.449,107,1.646,258,2.61]],["description/31",[3,0.851,17,0.267,32,0.426,53,0.19,56,0.444,62,0.524,68,0.958,72,1.037,107,2.745,125,2.543,134,0.332,180,0.722,190,0.752,195,2.068,205,1.14,209,3.157,258,2.48,265,3.577,267,3.813]],["title/32",[107,1.646,139,1.152,258,2.61]],["description/32",[1,3.243,3,0.656,11,1.659,17,0.162,53,0.116,56,0.469,59,5.154,68,0.581,71,5.61,72,0.882,79,1.795,80,1.724,81,3.243,107,2.549,125,1.543,134,0.201,139,0.931,180,0.614,205,0.97,209,1.915,235,2.228,245,4.76,258,2.109,264,1.959,267,3.243,268,3.919,269,3.919,270,5.753,271,3.919,272,3.919,273,3.919,274,3.919,275,3.919]],["title/33",[107,1.646,221,1.321,258,2.61]],["description/33",[3,0.868,17,0.243,53,0.173,68,0.871,72,1.323,107,2.585,125,2.314,134,0.302,180,0.921,205,1.454,209,2.872,221,1.601,258,3.164,264,2.939,267,4.864]],["title/34",[112,2.279]],["description/34",[84,3.006,86,4.982,112,2.411,131,1.757,210,5.514,276,6.364,277,7.102]],["title/35",[32,0.521,112,1.911]],["description/35",[17,0.266,32,0.595,53,0.19,56,0.442,62,0.452,112,2.183,134,0.414,179,0.407,181,0.416,190,1.05,278,5.764]],["title/36",[72,1.268,112,1.911]],["description/36",[17,0.266,53,0.19,56,0.442,62,0.452,72,1.448,112,2.183,134,0.414,179,0.407,181,0.416,190,1.05,278,5.764]],["title/37",[32,0.521,112,1.911]],["description/37",[17,0.261,32,0.584,53,0.186,56,0.434,62,0.443,112,2.143,134,0.324,179,0.399,181,0.408,190,1.03,205,1.562,238,2.485,279,5.224]],["title/38",[112,1.911,221,1.534]],["description/38",[17,0.261,53,0.186,56,0.434,62,0.443,112,2.143,134,0.324,179,0.399,181,0.408,190,1.03,205,1.562,221,1.72,238,2.485,279,5.224]],["title/39",[112,1.911,139,1.338]],["description/39",[17,0.266,53,0.19,56,0.442,62,0.452,112,2.183,134,0.33,139,1.528,179,0.407,181,0.416,190,1.05,264,3.216,279,5.323]],["title/40",[112,1.646,139,1.152,280,4.345]],["description/40",[17,0.224,53,0.16,56,0.496,62,0.38,84,2.291,112,2.753,114,2.77,131,1.339,134,0.278,137,1.99,139,1.286,179,0.342,181,0.35,190,0.883,209,2.644,280,4.849,281,5.412,282,4.849,283,5.412]],["title/41",[112,1.911,284,3.401]],["description/41",[58,3.884,77,1.41,112,2.99,131,1.995,284,3.884,285,4.731,286,4.731,287,5.764,288,6.432]],["title/42",[32,0.449,112,1.646,284,2.928]],["description/42",[3,0.637,17,0.231,53,0.165,56,0.507,77,1.225,112,2.501,159,2.459,174,2.802,179,0.354,180,0.875,181,0.361,190,0.912,284,4.978,286,4.111,289,5.008]],["title/43",[72,1.092,112,1.646,284,2.928]],["description/43",[3,0.533,17,0.193,53,0.138,55,3.022,56,0.517,58,2.821,72,1.692,77,1.024,112,2.761,174,2.48,179,0.296,180,0.732,181,0.302,190,0.762,195,2.096,284,4.539,289,4.185,290,3.435,291,4.671,292,4.671,293,4.185,294,4.185]],["title/44",[32,0.449,112,1.646,284,2.928]],["description/44",[3,0.805,17,0.217,20,2.685,53,0.155,56,0.486,77,1.15,112,2.397,134,0.269,174,2.686,179,0.332,180,0.822,181,0.339,190,0.856,195,2.354,205,1.298,284,4.822,286,3.858,295,4.7]],["title/45",[112,1.646,221,1.321,284,2.928]],["description/45",[3,0.789,17,0.21,53,0.15,55,3.292,56,0.476,77,1.115,112,2.349,174,2.631,179,0.322,180,0.797,181,0.329,190,0.831,195,2.284,205,1.259,221,2.142,284,4.748,293,4.56,295,4.56]],["title/46",[110,2.815,112,1.911]],["description/46",[11,2.122,56,0.471,67,3.371,77,1.099,79,2.297,80,2.206,84,3.303,107,1.702,110,4.192,112,2.648,116,3.028,117,4.149,118,4.149,131,1.241,160,3.371,195,2.25,197,4.149,290,3.688,296,5.014]],["title/47",[32,0.449,110,2.424,112,1.646]],["description/47",[17,0.261,32,0.584,53,0.186,56,0.434,62,0.443,110,3.156,112,2.143,134,0.409,179,0.399,181,0.408,190,1.03,297,5.657]],["title/48",[72,1.092,110,2.424,112,1.646]],["description/48",[17,0.261,53,0.186,56,0.434,62,0.443,72,1.421,110,3.156,112,2.143,134,0.409,179,0.399,181,0.408,190,1.03,297,5.657]],["title/49",[32,0.449,110,2.424,112,1.646]],["description/49",[17,0.261,32,0.584,53,0.186,56,0.434,62,0.443,110,3.156,112,2.143,134,0.324,179,0.399,181,0.408,190,1.03,238,2.485,298,5.224]],["title/50",[110,2.424,112,1.646,221,1.321]],["description/50",[17,0.256,53,0.183,56,0.426,62,0.435,110,3.099,112,2.104,134,0.318,179,0.392,181,0.401,190,1.012,205,1.534,221,1.689,238,2.44,298,5.129]],["title/51",[110,2.424,112,1.646,139,1.152]],["description/51",[17,0.261,53,0.186,56,0.434,62,0.443,110,3.156,112,2.143,134,0.324,139,1.5,179,0.399,181,0.408,190,1.03,264,3.156,298,5.224]],["title/52",[114,3.437]],["description/52",[7,2.208,11,3.005,21,2.542,44,3.659,56,0.417,67,2.83,77,0.923,79,1.928,80,1.852,84,3.005,107,1.429,110,2.104,114,3.634,116,2.542,117,3.484,118,3.484,131,1.042,161,2.393,163,2.542,166,2.83,167,2.723,168,2.628,170,2.723,195,1.889,197,3.484,229,2.953,290,3.096,299,3.772,300,5.014,301,3.268,302,3.484]],["title/53",[32,0.521,114,2.883]],["description/53",[17,0.266,32,0.595,53,0.19,56,0.442,62,0.452,114,3.293,134,0.414,179,0.407,181,0.416,190,1.05,303,5.764]],["title/54",[72,1.268,114,2.883]],["description/54",[17,0.227,53,0.162,56,0.378,62,0.386,72,1.238,79,3.339,80,3.207,114,2.815,125,2.165,134,0.374,179,0.348,181,0.355,190,0.897,303,4.927,304,7.289,305,5.499,306,5.499]],["title/55",[32,0.521,114,2.883]],["description/55",[17,0.266,32,0.595,53,0.19,56,0.442,62,0.452,114,3.293,134,0.33,179,0.407,181,0.416,190,1.05,238,2.532,307,5.323]],["title/56",[114,2.883,221,1.534]],["description/56",[17,0.261,53,0.186,56,0.434,62,0.443,114,3.232,134,0.324,179,0.399,181,0.408,190,1.03,205,1.562,221,1.72,238,2.485,307,5.224]],["title/57",[114,2.883,139,1.338]],["description/57",[17,0.266,53,0.19,56,0.442,62,0.452,114,3.293,134,0.33,139,1.528,179,0.407,181,0.416,190,1.05,264,3.216,307,5.323]],["title/58",[129,1.556,308,1.393]],["description/58",[3,0.627,11,2.328,68,0.815,77,1.205,129,2.406,308,2.023,309,3.04,310,3.321,311,3.557,312,4.551,313,4.269,314,4.045,315,4.269,316,4.269,317,4.269,318,4.269]],["title/59",[72,1.092,129,1.34,308,1.2]],["description/59",[3,0.758,17,0.199,51,1.445,53,0.142,56,0.33,62,0.337,65,1.924,66,1.682,68,0.986,72,1.497,77,1.053,129,2.108,134,0.247,174,1.826,179,0.304,180,0.752,181,0.31,241,1.924,308,1.887,310,2.9,311,3.107,319,2.072,320,4.303]],["title/60",[32,0.449,129,1.34,308,1.2]],["description/60",[3,0.751,17,0.196,32,0.609,51,1.425,53,0.14,56,0.453,62,0.332,65,1.897,66,1.659,68,0.976,129,1.82,134,0.243,174,1.801,179,0.3,180,0.742,181,0.306,203,2.692,233,3.064,235,2.692,241,1.897,308,1.629,319,2.043,320,4.243,321,3.064,322,3.064]],["title/61",[32,0.449,129,1.34,308,1.2]],["description/61",[3,0.773,17,0.204,32,0.627,51,1.487,53,0.146,56,0.34,62,0.347,65,1.98,66,1.731,68,1.005,129,1.874,134,0.254,174,1.879,179,0.313,180,0.774,181,0.319,205,1.223,238,1.945,241,1.98,308,1.678,319,2.132,321,3.197,323,4.089]],["title/62",[129,1.34,139,1.152,308,1.2]],["description/62",[3,0.863,17,0.196,51,1.425,53,0.14,56,0.326,62,0.332,65,1.897,66,1.659,68,1.122,129,2.092,134,0.243,139,1.565,174,1.801,179,0.3,180,0.742,181,0.306,205,1.172,241,1.897,264,2.367,308,1.873,319,2.043,323,3.919]],["title/63",[129,1.34,221,1.321,308,1.2]],["description/63",[3,0.863,17,0.196,51,1.425,53,0.14,56,0.326,62,0.332,65,1.897,66,1.659,68,1.122,129,2.092,134,0.243,174,1.801,179,0.3,180,0.742,181,0.306,205,1.172,221,1.794,241,1.897,264,2.367,308,1.873,319,2.043,323,3.919]],["title/64",[72,0.958,129,1.176,308,1.053,324,2.987]],["description/64",[3,0.691,17,0.174,51,1.267,53,0.124,56,0.29,58,2.542,62,0.295,65,1.687,66,1.475,68,0.898,72,1.364,77,0.923,106,3.268,129,2.145,134,0.216,143,3.268,174,1.601,179,0.266,180,0.659,181,0.272,195,1.889,209,2.961,241,1.687,308,1.756,319,1.816,324,2.953,325,3.772,326,3.772,327,3.772,328,3.772,329,3.772]],["title/65",[129,1.176,139,1.011,308,1.053,324,2.987]],["description/65",[3,0.788,17,0.166,51,1.207,53,0.118,56,0.276,58,2.423,62,0.282,65,1.607,66,1.405,68,1.024,77,0.879,106,3.114,129,2.23,134,0.206,139,1.39,143,3.114,174,1.525,179,0.254,180,0.628,181,0.259,195,1.8,209,2.859,241,1.607,308,1.878,319,1.731,324,2.814,325,3.594,326,3.594,327,3.594,328,3.594,329,3.594]],["title/66",[308,1.2,330,2.268,331,2.928]],["description/66",[3,0.589,11,2.187,68,0.766,77,1.132,308,1.96,309,2.855,310,3.12,311,3.342,312,4.275,313,4.011,314,3.8,315,4.011,316,4.011,317,4.011,318,4.011,330,3.971,331,4.785,332,3.474]],["title/67",[72,0.958,308,1.053,330,1.991,331,2.571]],["description/67",[3,0.737,17,0.191,51,1.387,53,0.136,56,0.317,62,0.323,65,1.846,66,1.614,68,0.958,72,1.455,77,1.01,134,0.237,174,1.752,179,0.292,180,0.722,181,0.298,241,1.846,308,1.846,310,2.783,311,2.981,319,1.988,330,3.49,331,2.783,332,4.344,333,4.129]],["title/68",[32,0.394,308,1.053,330,1.991,332,2.863]],["description/68",[3,0.737,17,0.191,32,0.598,51,1.387,53,0.136,56,0.444,62,0.323,65,1.846,66,1.614,68,0.958,134,0.237,174,1.752,179,0.292,180,0.722,181,0.298,203,2.619,233,2.981,235,2.619,241,1.846,308,1.599,319,1.988,321,2.981,322,2.981,330,3.022,332,4.344,333,4.129]],["title/69",[32,0.394,308,1.053,330,1.991,331,2.571]],["description/69",[3,0.758,17,0.199,32,0.615,51,1.445,53,0.142,56,0.33,62,0.337,65,1.924,66,1.682,68,0.986,134,0.247,174,1.826,179,0.304,180,0.752,181,0.31,205,1.188,238,1.89,241,1.924,308,1.645,319,2.072,321,3.107,330,3.11,331,2.9,332,3.229,334,3.974]],["title/70",[139,1.011,308,1.053,330,1.991,331,2.571]],["description/70",[3,0.845,17,0.188,51,1.368,53,0.134,56,0.313,62,0.319,65,1.821,66,1.592,68,1.098,134,0.234,139,1.52,174,1.729,179,0.288,180,0.712,181,0.294,205,1.125,241,1.821,264,2.273,308,1.833,319,1.961,330,3.464,331,3.865,332,3.057,334,3.762]],["title/71",[221,1.16,308,1.053,330,1.991,331,2.571]],["description/71",[3,0.845,17,0.188,51,1.368,53,0.134,56,0.313,62,0.319,65,1.821,66,1.592,68,1.098,134,0.234,174,1.729,179,0.288,180,0.712,181,0.294,205,1.125,221,1.744,241,1.821,264,2.273,308,1.833,319,1.961,330,3.464,331,3.865,332,3.057,334,3.762]],["title/72",[308,1.393,335,1.882]],["description/72",[3,0.486,68,0.632,77,0.934,157,2.99,178,2.757,224,3.135,308,1.769,309,3.379,310,2.574,311,2.757,316,3.309,317,3.309,318,3.309,335,2.876,336,3.819,337,4.262,338,3.819,339,3.819,340,3.819,341,3.819,342,3.819,343,3.819,344,3.527,345,1.739,346,3.819,347,3.819,348,3.819,349,3.819,350,3.819,351,3.819,352,3.819]],["title/73",[72,1.092,308,1.2,335,1.62]],["description/73",[3,0.596,7,2.741,17,0.142,51,1.037,53,0.102,56,0.237,62,0.242,65,1.38,66,1.207,68,0.774,72,1.176,77,1.145,134,0.177,157,2.416,174,1.31,178,2.228,211,2.228,224,2.533,241,1.38,308,1.561,309,2.888,310,2.08,311,2.228,319,1.486,335,2.354,336,3.086,339,3.086,340,3.086,341,3.086,342,3.086,343,3.086,344,4.323,345,1.405,346,3.086,347,3.086,348,3.086,349,3.086,350,3.086,351,3.086,352,3.086,353,2.533,354,3.444,355,2.674,356,2.674,357,2.228,358,2.85]],["title/74",[32,0.449,308,1.2,335,1.62]],["description/74",[3,0.766,17,0.201,32,0.621,51,1.466,53,0.144,56,0.462,62,0.342,65,1.951,66,1.706,68,0.995,134,0.25,174,1.852,203,2.769,233,3.151,235,2.769,241,1.951,308,1.661,319,2.101,322,3.151,335,2.244,357,3.151,358,4.031,359,4.364]],["title/75",[308,1.2,335,1.62,360,4.345]],["description/75",[3,0.686,17,0.132,48,2.856,51,0.959,53,0.094,56,0.219,58,1.925,62,0.224,65,1.277,66,1.116,68,0.73,72,0.717,77,1.318,109,2.856,134,0.164,139,0.757,174,1.212,206,1.925,207,3.621,209,2.939,212,2.143,221,0.868,241,1.277,264,2.461,308,1.912,319,1.375,322,3.184,335,2.583,338,2.856,353,3.621,355,2.474,356,2.474,357,2.062,358,2.637,360,4.411,361,3.187,362,2.856,363,2.344,364,4.922,365,3.187,366,3.187,367,3.187,368,3.187]],["title/76",[221,1.321,308,1.2,335,1.62]],["description/76",[3,0.883,17,0.204,51,1.487,53,0.146,56,0.34,62,0.347,65,1.98,66,1.731,68,1.148,77,1.083,134,0.254,174,1.879,221,1.848,241,1.98,308,1.916,319,2.132,335,2.588,357,3.197,369,4.941]],["title/77",[32,0.449,308,1.2,335,1.62]],["description/77",[3,0.789,17,0.21,32,0.64,51,1.532,53,0.15,56,0.35,62,0.357,65,2.039,66,1.783,68,1.025,134,0.261,174,1.935,205,1.259,238,2.003,241,2.039,308,1.712,319,2.195,335,2.313,357,3.292,359,4.56,370,4.211]],["title/78",[139,1.152,308,1.2,335,1.62]],["description/78",[3,0.87,17,0.199,51,1.445,53,0.142,56,0.33,62,0.337,65,1.924,66,1.682,68,1.13,134,0.247,139,1.58,174,1.826,205,1.188,241,1.924,264,2.401,308,1.887,309,2.654,319,2.072,335,2.549,357,3.107,370,3.974]],["title/79",[221,1.321,308,1.2,335,1.62]],["description/79",[3,0.87,17,0.199,51,1.445,53,0.142,56,0.33,62,0.337,65,1.924,66,1.682,68,1.13,134,0.247,174,1.826,205,1.188,221,1.812,241,1.924,264,2.401,308,1.887,309,2.654,319,2.072,335,2.549,357,3.107,370,3.974]],["title/80",[308,1.393,371,3.201]],["description/80",[3,0.617,11,2.291,68,0.802,77,1.186,308,2.007,309,2.991,310,3.268,311,3.501,312,4.478,313,4.202,314,3.981,315,4.202,316,4.202,317,4.202,318,4.202,371,4.917,372,5.412]],["title/81",[72,1.092,308,1.2,371,2.756]],["description/81",[3,0.751,17,0.196,51,1.425,53,0.14,56,0.326,62,0.332,65,1.897,66,1.659,68,0.976,72,1.483,77,1.038,84,2.004,134,0.243,174,1.801,179,0.3,180,0.742,181,0.306,241,1.897,308,1.873,310,2.86,311,3.064,319,2.043,371,4.304,373,4.243]],["title/82",[32,0.449,308,1.2,371,2.756]],["description/82",[3,0.751,17,0.196,32,0.609,51,1.425,53,0.14,56,0.453,62,0.332,65,1.897,66,1.659,68,0.976,134,0.243,174,1.801,179,0.3,180,0.742,181,0.306,203,2.692,233,3.064,235,2.692,241,1.897,308,1.629,319,2.043,321,3.064,322,3.064,371,3.743,373,4.243]],["title/83",[32,0.449,308,1.2,371,2.756]],["description/83",[3,0.773,17,0.204,32,0.627,51,1.487,53,0.146,56,0.34,62,0.347,65,1.98,66,1.731,68,1.005,134,0.254,174,1.879,179,0.313,180,0.774,181,0.319,205,1.223,238,1.945,241,1.98,308,1.678,319,2.132,321,3.197,371,3.855,374,4.089]],["title/84",[139,1.152,308,1.2,371,2.756]],["description/84",[3,0.863,17,0.196,51,1.425,53,0.14,56,0.326,62,0.332,65,1.897,66,1.659,68,1.122,134,0.243,139,1.565,174,1.801,179,0.3,180,0.742,181,0.306,205,1.172,241,1.897,264,2.367,308,1.873,319,2.043,371,4.304,374,3.919]],["title/85",[221,1.321,308,1.2,371,2.756]],["description/85",[3,0.863,17,0.196,51,1.425,53,0.14,56,0.326,62,0.332,65,1.897,66,1.659,68,1.122,134,0.243,174,1.801,179,0.3,180,0.742,181,0.306,205,1.172,221,1.794,241,1.897,264,2.367,308,1.873,319,2.043,371,4.304,374,3.919]],["title/86",[375,4.71]],["description/86",[11,2.122,19,2.85,86,3.517,123,2.45,129,2.156,160,3.371,173,3.371,194,1.756,225,4.805,286,3.688,375,5.474,376,4.149,377,4.149,378,4.149,379,4.493,380,5.014,381,5.014,382,5.014,383,3.893,384,4.149,385,5.014,386,5.014]],["title/87",[32,0.521,375,3.95]],["description/87",[3,0.82,17,0.223,19,2.04,32,0.332,51,1.08,53,0.159,56,0.495,62,0.252,64,2.518,65,1.438,66,1.257,67,2.413,68,1.066,77,0.787,129,0.992,134,0.277,173,2.413,179,0.341,180,0.562,181,0.348,190,0.586,203,2.04,209,1.754,225,2.518,233,2.322,235,2.04,241,1.438,310,2.168,321,2.322,322,2.322,355,2.787,375,3.781,376,2.97,377,2.97,378,2.97,383,2.787,384,2.97,387,2.97,388,3.589]],["title/88",[32,0.521,375,3.95]],["description/88",[3,0.767,17,0.234,19,2.178,32,0.354,51,1.153,53,0.167,56,0.463,62,0.269,65,1.535,66,1.342,67,2.576,68,0.997,77,0.84,129,1.059,134,0.291,173,2.576,179,0.358,180,0.6,181,0.366,190,0.625,205,0.948,225,2.688,238,1.508,241,1.535,310,2.314,321,2.479,355,2.975,375,3.969,376,3.171,377,3.171,378,3.171,383,2.975,384,3.171,387,3.171,389,3.831,390,3.831]],["title/89",[391,2.883,392,2.429]],["description/89",[11,1.899,81,3.713,84,2.684,123,2.192,129,1.24,147,3.3,154,3.147,194,1.572,276,4.02,391,3.246,392,2.736,393,4.486,394,6.341,395,4.02,396,4.486,397,4.486,398,4.486,399,3.483,400,4.02,401,4.486,402,4.486,403,4.486,404,4.486,405,4.02,406,3.713,407,4.486,408,4.02,409,4.486,410,2.415,411,4.486,412,4.486]],["title/90",[32,0.449,391,2.482,392,2.092]],["description/90",[17,0.261,32,0.584,53,0.186,56,0.434,62,0.443,134,0.409,179,0.399,181,0.408,190,1.03,391,3.232,392,2.724,413,5.657]],["title/91",[72,1.092,391,2.482,392,2.092]],["description/91",[17,0.261,53,0.186,56,0.434,62,0.443,72,1.421,134,0.409,179,0.399,181,0.408,190,1.03,391,3.232,392,2.724,413,5.657]],["title/92",[32,0.449,391,2.482,392,2.092]],["description/92",[17,0.252,32,0.563,53,0.179,56,0.536,62,0.427,134,0.313,179,0.385,181,0.394,190,0.994,238,2.396,391,3.116,392,3.36,414,5.038]],["title/93",[221,1.321,391,2.482,392,2.092]],["description/93",[17,0.247,53,0.176,56,0.53,62,0.42,134,0.307,179,0.378,181,0.387,190,0.976,205,1.48,221,1.63,238,2.354,391,3.062,392,3.322,414,4.95]],["title/94",[139,1.152,391,2.482,392,2.092]],["description/94",[17,0.252,53,0.179,56,0.536,62,0.427,134,0.313,139,1.446,179,0.385,181,0.394,190,0.994,264,3.043,391,3.116,392,3.36,414,5.038]],["title/95",[32,0.449,391,2.482,415,2.68]],["description/95",[17,0.271,53,0.193,56,0.451,62,0.46,134,0.337,179,0.415,181,0.424,190,1.07,391,3.356,415,3.624,416,6.556]],["title/96",[392,2.092,410,2.61,417,2.424]],["description/96",[11,2.577,194,2.132,287,5.455,290,4.478,392,3.36,395,5.455,405,5.455,406,5.038,410,4.192,417,3.043,418,6.047,419,5.455]],["title/97",[32,0.394,392,1.837,410,2.291,417,2.128]],["description/97",[17,0.256,32,0.573,53,0.183,56,0.426,62,0.435,134,0.405,179,0.392,181,0.401,190,1.012,392,2.674,410,3.336,417,3.099,420,5.554]],["title/98",[72,0.958,392,1.837,410,2.291,417,2.128]],["description/98",[17,0.256,53,0.183,56,0.426,62,0.435,72,1.395,134,0.405,179,0.392,181,0.401,190,1.012,392,2.674,410,3.336,417,3.099,420,5.554]],["title/99",[32,0.394,392,1.837,410,2.291,417,2.128]],["description/99",[17,0.252,32,0.563,53,0.179,56,0.419,62,0.427,134,0.313,179,0.385,181,0.394,190,0.994,205,1.506,238,2.396,392,2.626,410,3.277,417,3.043,421,5.038]],["title/100",[139,1.011,392,1.837,410,2.291,417,2.128]],["description/100",[17,0.256,53,0.183,56,0.426,62,0.435,134,0.318,139,1.473,179,0.392,181,0.401,190,1.012,238,2.44,392,2.674,410,3.336,417,3.099,421,5.129]],["title/101",[221,1.16,392,1.837,410,2.291,417,2.128]],["description/101",[17,0.256,53,0.183,56,0.426,62,0.435,134,0.318,179,0.392,181,0.401,190,1.012,205,1.534,221,1.689,392,2.674,410,3.336,417,3.099,421,5.129]],["title/102",[32,0.449,415,2.68,417,2.424]],["description/102",[17,0.271,53,0.193,56,0.451,62,0.46,134,0.337,179,0.415,181,0.424,190,1.07,415,3.624,417,3.277,422,6.556]],["title/103",[122,2.954,123,2.751]],["description/103",[11,2.886,23,5.642,96,6.109,122,3.577,123,3.331,126,6.109,127,6.109,129,1.884,423,6.818]],["title/104",[32,0.449,122,2.544,123,2.369]],["description/104",[3,0.679,17,0.246,53,0.175,56,0.41,62,0.418,68,0.882,122,4.276,123,3.982,134,0.306,179,0.377,180,0.644,181,0.385,190,0.67,201,2.565,202,2.481,205,2.016,206,3.595,212,4.003,424,3.681]],["title/105",[72,1.092,122,2.544,123,2.369]],["description/105",[3,0.875,17,0.221,53,0.158,55,2.298,56,0.368,58,2.145,62,0.375,68,0.526,72,1.204,122,2.805,123,2.612,128,4.992,134,0.33,155,2.758,179,0.338,180,0.556,181,0.346,190,0.58,201,3.338,202,3.229,203,3.039,204,3.933,205,1.323,206,3.229,207,3.933,209,3.142,263,2.939,285,2.613,424,3.183]],["title/106",[32,0.449,122,2.544,123,2.369]],["description/106",[3,0.679,17,0.246,53,0.175,56,0.41,62,0.418,68,0.882,122,4.276,123,3.982,134,0.306,179,0.377,180,0.644,181,0.385,190,0.67,201,2.565,202,2.481,205,2.016,206,3.595,212,4.003,425,3.4]],["title/107",[122,2.544,123,2.369,221,1.321]],["description/107",[3,0.673,17,0.244,53,0.174,56,0.406,62,0.414,68,0.875,122,4.255,123,3.963,134,0.303,179,0.373,180,0.636,181,0.381,190,0.663,201,2.534,202,2.451,205,2.007,206,3.564,212,3.968,221,1.106,425,3.359]],["title/108",[122,2.544,123,2.369,139,1.152]],["description/108",[3,0.762,17,0.232,53,0.165,56,0.46,62,0.394,68,0.832,122,4.483,123,4.176,134,0.288,139,0.9,179,0.355,180,0.593,181,0.363,190,0.618,201,2.365,202,2.288,205,1.951,206,3.388,212,3.773,425,3.135]],["title/109",[131,1.393,137,2.071]],["description/109",[3,0.447,7,3.018,11,1.659,21,3.474,44,4.116,56,0.27,66,1.373,86,2.75,107,1.33,129,1.083,131,1.423,137,2.115,139,0.931,161,2.228,162,2.535,163,3.474,166,2.635,167,3.721,168,3.591,170,2.535,194,1.373,229,2.75,285,2.883,426,5.753,427,3.512,428,3.512,429,5.154,430,3.243,431,3.512,432,3.512,433,3.512,434,3.512,435,3.512,436,3.512,437,3.512]],["title/110",[32,0.449,131,1.2,137,1.783]],["description/110",[3,0.797,17,0.328,53,0.152,55,4.522,56,0.481,131,1.278,134,0.359,137,1.9,149,2.855,179,0.327,180,0.809,181,0.334,190,0.843,240,3.8,249,4.275,250,4.275,251,4.275,252,4.629,438,4.629]],["title/111",[72,1.092,131,1.2,137,1.783]],["description/111",[3,0.888,17,0.252,53,0.179,62,0.427,68,1.154,72,1.371,131,1.506,134,0.313,137,2.239,179,0.385,180,0.954,181,0.394,438,5.455]],["title/112",[32,0.449,131,1.2,137,1.783]],["description/112",[3,0.703,17,0.255,20,3.158,51,1.299,53,0.182,56,0.424,62,0.433,68,0.914,131,2.056,134,0.317,137,3.055,149,3.41,159,1.899,179,0.39,180,0.676,181,0.399,190,0.704,205,1.068,439,3.572]],["title/113",[131,1.2,137,1.783,221,1.321]],["description/113",[3,0.67,17,0.243,53,0.173,62,0.413,68,0.871,131,1.884,134,0.302,137,2.8,159,2.586,179,0.372,180,0.921,181,0.38,205,1.454,221,1.601,439,4.864]],["title/114",[131,1.2,137,1.783,139,1.152]],["description/114",[3,0.67,17,0.243,53,0.173,62,0.413,68,0.871,131,1.884,134,0.302,137,2.8,139,1.396,159,2.586,179,0.372,180,0.921,181,0.38,205,1.454,439,4.864]],["title/115",[32,0.394,137,1.566,145,2.179,440,4.257]],["description/115",[3,0.659,17,0.239,53,0.17,62,0.406,68,0.856,129,2.081,131,1.863,134,0.297,137,2.769,159,2.542,179,0.366,180,0.905,181,0.374,265,4.486,441,5.178]],["title/116",[72,0.958,137,1.566,145,2.179,442,3.523]],["description/116",[3,0.572,17,0.207,53,0.148,62,0.352,66,2.399,68,0.743,129,1.893,131,1.93,134,0.258,137,2.519,140,4.149,145,3.507,159,2.206,179,0.317,180,0.785,181,0.324,235,2.85,441,4.493,443,5.014,444,5.014,445,5.014]],["title/117",[137,1.566,145,2.179,221,1.16,442,3.523]],["description/117",[3,0.447,17,0.162,53,0.116,55,2.535,62,0.275,68,0.581,129,1.589,131,1.423,134,0.201,136,4.76,137,2.761,140,3.243,145,2.006,155,3.043,159,1.724,168,2.447,179,0.248,180,0.614,181,0.253,205,1.686,221,1.068,231,3.243,233,3.721,430,3.243,442,4.76,446,3.919,447,5.753,448,3.919,449,3.919,450,3.919,451,3.919,452,3.919,453,3.919,454,3.919,455,3.919]],["title/118",[131,1.661]],["description/118",[7,3.311,11,2.671,21,3.811,44,4.254,56,0.237,110,1.722,112,1.169,114,1.763,122,1.807,123,1.683,129,0.952,131,0.852,161,1.958,163,3.811,166,3.513,167,4.083,168,3.94,170,4.083,229,4.427,286,2.533,301,2.674,379,3.086,415,2.888,456,3.444,457,3.444,458,3.086,459,4.681,460,3.086,461,3.086,462,3.086,463,5.655,464,3.086,465,3.086,466,3.086]],["title/119",[32,0.521,131,1.393]],["description/119",[17,0.271,53,0.193,56,0.561,62,0.46,131,1.622,134,0.337,179,0.415,181,0.424,190,1.07,467,5.874]],["title/120",[72,1.268,131,1.393]],["description/120",[17,0.266,53,0.19,56,0.555,62,0.452,72,1.448,131,1.591,134,0.33,179,0.407,181,0.416,190,1.05,467,5.764]],["title/121",[72,1.092,131,1.2,324,3.402]],["description/121",[11,1.234,17,0.121,19,1.657,36,2.612,53,0.086,56,0.316,58,2.773,62,0.205,72,1.034,76,2.045,99,2.412,106,3.564,107,1.558,129,1.781,131,1.842,134,0.15,135,1.76,142,2.263,143,3.564,173,1.96,179,0.184,181,0.297,190,0.476,209,1.424,294,4.114,324,2.045,345,1.189,356,2.263,415,1.611,417,3.222,419,2.612,468,2.915,469,2.915,470,2.915,471,2.915,472,1.234,473,2.915,474,4.591,475,2.915,476,2.915,477,5.68,478,2.915,479,2.612,480,2.915,481,2.915,482,2.915,483,2.915,484,2.915,485,2.915,486,2.915,487,2.915,488,2.915,489,2.915,490,2.915]],["title/122",[32,0.521,131,1.393]],["description/122",[17,0.256,53,0.183,56,0.542,62,0.435,131,1.949,134,0.318,179,0.392,181,0.401,190,1.012,195,2.782,205,1.534,491,5.129]],["title/123",[131,1.393,221,1.534]],["description/123",[17,0.252,53,0.179,56,0.536,62,0.427,131,1.927,134,0.313,179,0.385,181,0.394,190,0.994,195,2.732,205,1.506,221,1.659,491,5.038]],["title/124",[131,1.393,139,1.338]],["description/124",[17,0.252,53,0.179,56,0.536,62,0.427,131,1.927,134,0.313,139,1.446,179,0.385,181,0.394,190,0.994,195,2.732,205,1.506,491,5.038]],["title/125",[32,0.394,131,1.053,153,2.571,161,2.42]],["description/125",[17,0.266,53,0.19,56,0.442,62,0.452,131,1.591,134,0.33,153,3.884,161,3.656,179,0.407,181,0.416,190,1.05,492,6.432]],["title/126",[32,0.521,415,3.113]],["description/126",[17,0.271,53,0.193,56,0.451,62,0.46,131,1.622,134,0.337,179,0.415,181,0.424,190,1.07,415,3.624,493,6.556]],["title/127",[32,0.394,131,1.053,391,2.179,415,2.353]],["description/127",[17,0.266,53,0.19,56,0.442,62,0.452,131,1.591,134,0.33,179,0.407,181,0.416,190,1.05,391,3.293,415,3.555,494,6.432]],["title/128",[32,0.394,131,1.053,415,2.353,417,2.128]],["description/128",[17,0.266,53,0.19,56,0.442,62,0.452,131,1.591,134,0.33,179,0.407,181,0.416,190,1.05,415,3.555,417,3.216,495,6.432]],["title/129",[129,1.855]],["description/129",[77,1.334,80,2.678,84,2.577,129,2.152,223,5.038,224,5.729,225,4.271,399,4.727,400,5.455,406,5.038,408,5.455,418,4.727,496,5.455]],["title/130",[32,0.521,129,1.556]],["description/130",[3,0.909,17,0.261,53,0.186,62,0.443,68,1.181,129,1.744,134,0.324,179,0.399,180,0.989,181,0.408,497,6.313]],["title/131",[32,0.521,129,1.556]],["description/131",[3,0.851,17,0.267,20,3.307,53,0.19,56,0.444,62,0.568,68,0.958,77,1.01,129,1.785,131,1.14,134,0.383,145,2.359,159,2.027,180,0.722,190,0.752,209,3.157,210,3.577,498,3.577,499,3.813]],["title/132",[129,1.556,139,1.338]],["description/132",[3,0.789,56,0.35,58,3.073,64,3.57,125,2.003,129,1.406,131,1.259,137,1.871,139,2.163,155,3.951,162,5.086,209,2.486,344,4.211,499,4.211,500,5.089,501,5.089,502,5.089,503,5.089]],["title/133",[77,1.063,129,1.34,221,1.321]],["description/133",[3,0.849,17,0.235,53,0.167,62,0.399,68,0.842,129,2.058,134,0.292,179,0.36,180,0.89,181,0.367,195,2.55,221,1.548,499,4.702,504,5.682,505,5.682,506,5.682,507,5.682]],["title/134",[32,0.394,129,1.176,153,2.571,161,2.42]],["description/134",[3,0.851,17,0.267,20,3.307,53,0.19,56,0.444,62,0.568,68,0.958,77,1.01,129,1.785,131,1.14,134,0.383,145,2.359,159,2.027,180,0.722,190,0.752,209,3.157,210,3.577,498,3.577,508,4.608]],["title/135",[32,0.351,77,0.832,129,1.048,183,2.291,418,2.946]],["description/135",[3,0.637,17,0.231,53,0.165,77,1.615,125,2.9,129,1.544,135,3.375,149,3.089,179,0.354,180,0.875,181,0.361,183,3.375,194,1.958,195,2.508,418,5.72,509,5.008,510,5.589]],["title/136",[32,0.288,77,0.683,129,0.861,131,0.771,137,1.146,142,2.42,509,2.793]],["description/136",[3,0.617,17,0.224,53,0.16,77,1.186,125,2.13,129,1.495,131,1.339,137,1.99,142,4.202,149,2.991,153,3.268,179,0.342,180,0.848,181,0.35,194,1.896,195,2.429,511,5.412,512,3.501,513,5.412,514,5.412,515,5.412,516,5.412]],["title/137",[20,1.752,32,0.317,77,0.75,129,0.946,183,2.067,517,3.422]],["description/137",[3,0.627,17,0.227,20,2.815,53,0.162,56,0.378,77,1.205,83,4.927,107,1.866,125,2.165,129,1.519,131,1.361,137,2.022,149,3.04,179,0.348,180,0.861,181,0.355,183,3.321,195,2.468,518,5.499,519,5.499,520,5.499]],["title/138",[32,0.449,66,1.698,129,1.34]],["description/138",[3,0.707,17,0.256,53,0.183,62,0.435,66,2.171,68,0.919,129,2.177,134,0.318,179,0.392,180,0.971,181,0.401,521,6.199,522,6.199]],["title/139",[66,1.972,129,1.556]],["description/139",[11,2.672,66,3.06,86,4.429,129,2.535,131,1.562,137,2.322,194,2.211,225,4.429]],["title/140",[335,2.244]],["description/140",[77,1.437,80,2.884,129,1.811,223,5.425,224,6.003,315,5.09,335,2.728,496,5.874,523,6.556]],["title/141",[32,0.521,335,1.882]],["description/141",[3,0.72,17,0.261,53,0.186,62,0.443,68,0.936,77,1.384,125,2.485,134,0.324,179,0.399,180,0.989,181,0.408,335,2.11,524,6.313]],["title/142",[32,0.521,335,1.882]],["description/142",[3,0.734,17,0.266,53,0.19,62,0.452,68,0.953,134,0.33,179,0.407,180,1.008,181,0.416,205,1.591,335,2.15,525,6.432]],["title/143",[335,1.882,526,3.643]],["description/143",[3,0.447,17,0.162,19,2.228,20,2.006,53,0.116,62,0.275,68,0.581,77,0.859,125,1.543,134,0.201,135,2.367,149,2.166,179,0.248,180,0.614,181,0.253,238,1.543,308,1.423,335,2.278,512,2.535,526,3.721,527,4.781,528,4.466,529,4.466,530,3.591,531,3.721,532,3.919,533,3.512,534,3.919,535,3.043,536,3.043,537,3.043,538,3.043,539,3.043,540,3.043,541,3.043,542,3.919]],["title/144",[335,1.882,526,3.643]],["description/144",[3,0.512,17,0.186,19,2.55,20,2.297,53,0.132,62,0.315,68,0.665,134,0.23,149,2.48,179,0.284,180,0.703,181,0.29,308,1.569,512,2.902,526,2.902,527,5.159,528,4.923,529,4.923,530,3.958,535,3.483,536,3.483,537,3.483,538,3.483,539,3.483,540,3.483,541,3.483,543,6.341,544,4.486]],["title/145",[330,2.268,335,1.62,545,3.027]],["description/145",[3,0.58,17,0.21,53,0.15,62,0.357,68,0.754,77,1.115,116,3.073,125,2.003,134,0.261,179,0.322,180,0.797,181,0.329,330,3.236,335,2.313,530,3.177,531,4.476,545,3.177,546,3.743,547,3.57,548,3.951,549,3.951,550,3.951,551,5.089]],["title/146",[330,2.268,335,1.62,545,3.027]],["description/146",[3,0.617,17,0.224,53,0.16,62,0.38,68,0.802,116,3.268,134,0.278,179,0.342,180,0.848,181,0.35,211,3.501,309,2.991,330,3.373,335,2.41,530,3.378,545,3.378,548,4.202,549,4.202,550,4.202,552,5.412]],["title/147",[139,1.152,335,1.62,553,3.137]],["description/147",[3,0.627,17,0.227,53,0.162,62,0.386,68,0.815,77,1.205,125,2.165,134,0.282,135,3.321,139,1.306,179,0.348,180,0.861,181,0.355,335,2.436,531,4.716,546,4.045,547,3.858,553,3.557,554,5.499]],["title/148",[139,1.152,335,1.62,553,3.137]],["description/148",[3,0.682,17,0.247,53,0.176,62,0.42,68,0.886,134,0.307,139,1.421,179,0.378,180,0.937,181,0.387,211,3.869,309,3.306,335,2.574,553,3.869,555,5.981]],["title/149",[335,1.62,556,3.764,557,3.764]],["description/149",[3,0.627,17,0.227,53,0.162,62,0.386,68,0.815,77,1.205,125,2.165,134,0.282,135,3.321,179,0.348,180,0.861,181,0.355,335,2.436,531,4.716,546,4.045,547,3.858,556,4.269,557,4.269,558,5.499]],["title/150",[335,1.62,556,3.764,557,3.764]],["description/150",[3,0.682,17,0.247,53,0.176,62,0.42,68,0.886,134,0.307,179,0.378,180,0.937,181,0.387,211,3.869,309,3.306,335,2.574,556,4.644,557,4.644,559,5.981]],["title/151",[32,0.521,560,4.372]],["description/151",[3,0.659,17,0.239,53,0.17,62,0.406,68,0.856,72,1.301,77,1.267,134,0.297,179,0.366,180,0.905,181,0.374,211,3.738,322,3.738,560,6.504,561,5.178,562,5.779]],["title/152",[560,4.372,563,5.046]],["description/152",[3,0.447,17,0.162,42,3.243,53,0.116,58,2.367,62,0.275,68,0.581,72,0.882,77,0.859,134,0.201,149,2.166,179,0.248,282,3.512,322,2.535,357,2.535,479,3.512,530,2.447,560,6.707,561,3.512,563,6.728,564,3.919,565,3.919,566,3.919,567,3.919,568,3.512,569,3.919,570,3.919,571,5.753,572,3.919,573,3.919,574,3.919,575,3.919,576,3.919,577,3.919,578,3.919,579,3.919]],["title/153",[580,3.281]],["description/153",[335,2.477,356,5.753,387,6.132,527,5.199,580,3.621]],["title/154",[32,0.521,580,2.751]],["description/154",[3,0.518,7,3.886,17,0.188,53,0.134,62,0.319,68,0.674,77,0.996,125,2.519,134,0.234,137,1.672,179,0.288,180,0.712,181,0.294,235,2.584,258,2.447,353,3.344,512,2.941,527,3.189,531,2.941,547,3.189,580,2.221,581,3.762,582,3.762,583,3.762,584,3.762,585,3.762,586,4.546,587,3.762,588,3.762,589,3.762,590,4.546]],["title/155",[32,0.521,580,2.751]],["description/155",[3,0.734,17,0.266,53,0.19,62,0.452,68,0.953,134,0.33,179,0.407,180,1.008,181,0.416,205,1.591,580,3.143,591,6.432]],["title/156",[526,3.643,580,2.751]],["description/156",[3,0.437,11,1.622,17,0.158,19,2.178,20,1.961,53,0.113,62,0.269,68,0.568,77,0.84,125,1.508,134,0.197,149,2.118,162,2.479,179,0.242,180,0.6,181,0.248,238,1.508,308,1.4,335,1.28,512,2.479,526,3.66,527,4.718,528,4.392,529,4.392,530,3.532,531,3.66,533,3.433,535,2.975,536,2.975,537,2.975,538,2.975,539,2.975,540,2.975,541,2.975,580,3.286,592,3.831,593,3.831,594,3.831]],["title/157",[526,3.643,580,2.751]],["description/157",[3,0.525,17,0.191,19,2.619,20,2.359,53,0.136,62,0.323,68,0.683,134,0.237,149,2.547,179,0.292,180,0.722,181,0.298,308,1.599,512,2.981,526,2.981,527,4.532,528,5.016,529,5.016,530,4.033,535,3.577,536,3.577,537,3.577,538,3.577,539,3.577,540,3.577,541,3.577,580,2.251,595,4.608]],["title/158",[330,2.268,545,3.027,580,2.369]],["description/158",[3,0.447,7,3.575,17,0.162,53,0.116,62,0.275,68,0.581,77,0.859,116,2.367,125,2.264,134,0.201,137,1.441,179,0.248,180,0.614,181,0.253,235,2.228,258,2.109,330,2.691,353,2.883,512,2.535,530,2.447,531,4.409,545,2.447,546,2.883,547,4.036,548,3.043,549,3.043,550,3.043,580,2.811,581,3.243,582,3.243,583,3.243,584,3.243,585,3.243,587,3.243,588,3.243,589,3.243,596,3.512,597,3.919]],["title/159",[330,2.268,545,3.027,580,2.369]],["description/159",[3,0.617,17,0.224,53,0.16,62,0.38,68,0.802,116,3.268,134,0.278,179,0.342,180,0.848,181,0.35,211,3.501,309,2.991,330,3.373,530,3.378,545,3.378,548,4.202,549,4.202,550,4.202,580,3.524,598,5.412]],["title/160",[139,1.152,553,3.137,580,2.369]],["description/160",[3,0.48,7,3.724,17,0.174,53,0.124,62,0.295,68,0.624,77,0.923,125,2.385,134,0.216,137,1.548,139,1,179,0.266,180,0.659,181,0.272,235,2.393,258,2.266,353,3.096,512,2.723,531,4.592,546,3.096,547,4.251,553,2.723,580,2.961,581,3.484,582,3.484,583,3.484,584,3.484,585,3.484,587,3.484,588,3.484,589,3.484,596,3.772,599,4.21]],["title/161",[139,1.152,553,3.137,580,2.369]],["description/161",[3,0.682,17,0.247,53,0.176,62,0.42,68,0.886,134,0.307,139,1.421,179,0.378,180,0.937,181,0.387,211,3.869,309,3.306,553,3.869,580,3.763,600,5.981]],["title/162",[84,2.052,194,1.698,601,2.756]],["description/162",[84,2.829,97,5.19,131,1.654,194,2.341,290,4.917,545,4.173,601,4.695,602,5.532,603,6.684]],["title/163",[32,0.394,84,1.802,194,1.491,601,2.42]],["description/163",[17,0.261,53,0.186,56,0.548,62,0.443,84,2.672,134,0.324,179,0.399,181,0.408,190,1.03,194,2.211,601,3.589,604,5.657]],["title/164",[72,0.958,84,1.802,194,1.491,601,2.42]],["description/164",[17,0.256,53,0.183,56,0.542,62,0.435,72,1.395,84,2.624,134,0.318,179,0.392,181,0.401,190,1.012,194,2.171,601,3.523,604,5.554]],["title/165",[32,0.394,84,1.802,194,1.491,601,2.42]],["description/165",[17,0.247,53,0.176,56,0.53,62,0.42,84,2.532,131,1.48,134,0.307,179,0.378,181,0.387,190,0.976,194,2.095,195,2.684,205,1.48,601,3.4,605,4.95]],["title/166",[84,1.802,139,1.011,194,1.491,601,2.42]],["description/166",[17,0.207,53,0.148,56,0.471,62,0.352,72,1.129,84,2.122,125,1.974,131,1.241,134,0.258,139,1.627,179,0.317,181,0.324,190,0.818,194,2.399,195,2.25,205,1.241,212,3.371,601,2.85,602,5.669,605,4.149,606,5.014,607,5.014,608,5.014]],["title/167",[84,1.802,194,1.491,221,1.16,601,2.42]],["description/167",[17,0.217,53,0.155,56,0.486,62,0.368,84,2.99,131,1.298,134,0.269,145,2.685,179,0.332,181,0.339,190,0.856,194,2.474,195,2.354,205,1.298,221,2.176,601,4.015,602,4.341,605,4.341]],["title/168",[79,2.579,80,2.477]],["description/168",[3,0.679,7,2.155,11,2.964,21,2.481,44,3.595,56,0.283,77,0.9,79,3.207,80,3.08,84,1.739,85,3.681,86,2.882,107,1.394,110,2.976,111,3.4,161,2.335,163,2.481,166,2.762,167,2.658,168,2.565,170,2.658,229,2.882,248,3.681,300,4.927,301,3.189,302,3.4,427,3.681,609,4.108,610,4.108,611,3.681,612,4.108,613,3.681]],["title/169",[32,0.449,79,2.221,80,2.133]],["description/169",[6,3.432,17,0.235,28,3.432,32,0.526,53,0.167,79,2.603,80,2.5,134,0.292,179,0.36,180,0.89,181,0.367,190,0.927,201,3.547,202,3.432,203,3.23,204,4.179,235,3.23,236,5.091,614,5.091]],["title/170",[72,1.092,79,2.221,80,2.133]],["description/170",[3,0.617,17,0.224,53,0.16,56,0.372,68,0.802,72,1.826,79,3.715,80,3.568,107,1.837,134,0.278,157,3.796,179,0.342,180,0.848,181,0.35,614,4.849,615,4.478]],["title/171",[32,0.449,79,2.221,80,2.133]],["description/171",[17,0.271,32,0.606,53,0.193,79,3.003,80,2.884,179,0.415,180,1.027,181,0.424,190,1.07,205,1.622,616,5.425]],["title/172",[79,2.221,80,2.133,221,1.321]],["description/172",[3,0.589,17,0.214,53,0.152,56,0.355,62,0.363,68,0.766,79,3.629,80,3.486,107,2.373,134,0.265,145,2.644,157,3.624,160,3.474,179,0.327,180,0.809,181,0.334,221,1.905,615,4.275,616,4.275]],["title/173",[79,2.221,80,2.133,139,1.152]],["description/173",[3,0.781,17,0.207,53,0.148,56,0.345,68,0.743,72,1.129,79,3.841,80,3.689,107,1.702,125,1.974,134,0.258,139,1.191,157,3.517,160,3.371,175,3.893,180,0.785,209,2.45,264,2.507,615,4.149,616,4.149]],["title/174",[32,0.394,79,1.95,80,1.873,383,3.305]],["description/174",[3,0.723,17,0.186,32,0.415,53,0.132,56,0.436,68,0.665,72,1.428,79,3.661,80,3.709,107,2.152,134,0.23,145,2.297,179,0.284,180,0.703,181,0.29,195,2.013,238,1.766,251,3.713,617,4.486,618,6.341,619,4.02,620,4.486,621,4.486]],["title/175",[50,2.176,622,2.482,623,2.482]],["description/175",[46,2.274,50,3.822,53,0.176,116,3.612,131,1.48,137,2.2,285,4.399,568,5.359,622,3.942,623,3.062,624,5.981,625,5.981,626,5.981]],["title/176",[32,0.394,50,1.911,622,2.179,623,2.179]],["description/176",[17,0.252,32,0.563,46,2.315,50,2.732,53,0.179,56,0.536,62,0.427,134,0.313,179,0.385,181,0.394,190,0.994,622,3.116,623,3.116,627,5.455]],["title/177",[50,1.911,72,0.958,622,2.179,623,2.179]],["description/177",[17,0.252,46,2.315,50,2.732,53,0.179,56,0.536,62,0.427,72,1.371,134,0.313,179,0.385,181,0.394,190,0.994,622,3.116,623,3.116,627,5.455]],["title/178",[32,0.394,50,1.911,622,2.179,623,2.179]],["description/178",[17,0.224,32,0.501,46,2.743,50,3.237,53,0.16,56,0.558,62,0.38,134,0.278,159,2.381,179,0.342,181,0.35,190,0.883,205,1.339,622,3.692,623,3.692,628,4.478]],["title/179",[50,1.911,221,1.16,622,2.179,623,2.179]],["description/179",[17,0.201,28,4.055,46,1.852,50,3.449,53,0.144,56,0.462,62,0.342,104,3.782,134,0.25,159,2.143,179,0.308,181,0.315,190,0.795,205,1.205,221,1.83,238,1.917,498,3.782,622,3.934,623,3.934,628,4.031]],["title/180",[50,1.911,139,1.011,622,2.179,623,2.179]],["description/180",[17,0.21,28,3.073,46,1.935,50,3.105,53,0.15,56,0.476,62,0.357,72,1.146,128,3.951,134,0.261,139,1.209,159,2.239,179,0.322,181,0.329,190,0.831,238,2.003,245,4.211,313,3.951,362,4.56,622,3.542,623,3.542,628,4.211]],["title/181",[28,2.291,32,0.351,50,1.703,622,1.942,623,1.942]],["description/181",[17,0.224,20,2.77,28,3.268,32,0.501,46,2.058,50,3.237,53,0.16,56,0.496,62,0.38,134,0.278,159,2.381,179,0.342,181,0.35,190,0.883,238,2.13,622,3.692,623,3.692,629,4.849]],["title/182",[28,2.291,50,1.703,221,1.034,622,1.942,623,1.942]],["description/182",[17,0.21,28,4.179,31,4.211,46,1.935,50,3.105,53,0.15,56,0.476,62,0.357,104,3.951,134,0.261,159,2.239,179,0.322,181,0.329,190,0.831,221,1.885,238,2.003,498,3.951,622,3.542,623,3.542,629,4.56]],["title/183",[194,1.698,345,1.978,472,2.052]],["description/183",[11,2.532,77,1.311,131,1.48,154,4.196,194,2.697,285,4.399,314,4.399,345,3.141,472,3.26,630,5.981,631,5.981,632,5.981,633,5.359]],["title/184",[32,0.394,194,1.491,345,1.737,472,1.802]],["description/184",[17,0.252,32,0.563,46,2.315,53,0.179,56,0.536,62,0.427,134,0.313,179,0.385,181,0.394,190,0.994,194,2.132,345,2.483,472,2.577,634,5.455]],["title/185",[72,0.958,194,1.491,345,1.737,472,1.802]],["description/185",[17,0.252,46,2.315,53,0.179,56,0.536,62,0.427,72,1.371,134,0.313,179,0.385,181,0.394,190,0.994,194,2.132,345,2.483,472,2.577,634,5.455]],["title/186",[32,0.394,194,1.491,345,1.737,472,1.802]],["description/186",[17,0.224,32,0.501,46,2.743,53,0.16,56,0.558,62,0.38,134,0.278,159,2.381,179,0.342,181,0.35,190,0.883,194,2.526,205,1.339,345,2.942,472,3.053,635,4.478]],["title/187",[194,1.491,221,1.16,345,1.737,472,1.802]],["description/187",[17,0.217,46,1.995,53,0.155,56,0.486,62,0.368,77,1.15,134,0.269,145,2.685,159,2.307,179,0.332,181,0.339,190,0.856,194,2.474,221,1.429,238,2.065,345,2.881,472,2.99,635,4.341,636,4.072,637,4.341]],["title/188",[139,1.011,194,1.491,345,1.737,472,1.802]],["description/188",[17,0.21,31,4.211,46,1.935,53,0.15,56,0.476,62,0.357,77,1.115,134,0.261,139,1.209,159,2.239,163,3.073,179,0.322,181,0.329,190,0.831,194,2.424,238,2.003,345,2.823,472,2.929,635,4.211,636,3.951,637,4.211,638,5.089]],["title/189",[345,2.297,472,2.384]],["description/189",[11,2.886,131,1.687,154,4.783,314,5.015,345,3.411,472,2.886,633,6.109,639,6.818]],["title/190",[32,0.449,345,1.978,472,2.052]],["description/190",[17,0.256,32,0.573,46,2.357,53,0.183,56,0.542,62,0.435,134,0.318,179,0.392,181,0.401,190,1.012,345,2.528,472,2.624,640,5.554]],["title/191",[72,1.092,345,1.978,472,2.052]],["description/191",[17,0.217,46,1.995,53,0.155,56,0.486,62,0.368,72,1.181,77,1.15,125,2.065,134,0.269,145,2.685,179,0.332,181,0.339,190,0.856,194,2.474,345,3.257,472,3.38,636,4.072,640,4.7]],["title/192",[32,0.449,345,1.978,472,2.052]],["description/192",[17,0.231,32,0.517,46,2.802,53,0.165,56,0.567,62,0.392,134,0.287,159,2.459,179,0.354,181,0.361,190,0.912,205,1.383,345,3.006,472,3.119,641,4.625]],["title/193",[221,1.321,345,1.978,472,2.052]],["description/193",[17,0.199,46,2.529,53,0.142,56,0.525,57,4.303,62,0.337,77,1.053,134,0.247,145,2.458,159,2.113,179,0.304,181,0.31,190,0.784,194,1.682,205,1.188,221,1.308,345,3.359,472,3.485,636,3.728,637,3.974,641,3.974]],["title/194",[139,1.152,345,1.978,472,2.052]],["description/194",[11,1.827,17,0.178,21,2.607,46,2.346,53,0.127,56,0.495,62,0.303,76,3.028,98,3.572,134,0.222,139,1.465,159,1.899,163,2.607,179,0.273,181,0.279,190,0.704,194,2.522,205,1.068,345,3.525,472,3.658,641,3.572,642,4.316]],["title/195",[53,0.198]],["description/195",[15,5.401,53,0.205,62,0.488,122,3.65,309,3.846,410,3.744,619,6.234,643,6.957]],["title/196",[32,0.449,46,1.844,53,0.143]],["description/196",[20,3.793,32,0.686,46,2.818,53,0.218,644,7.411]],["title/197",[645,4.71]],["description/197",[6,4.38,53,0.214,645,5.088,646,7.253,647,7.253,648,7.253]],["title/198",[32,0.394,363,3.131,645,2.987,649,3.305]],["description/198",[17,0.276,53,0.197,179,0.423,180,1.047,181,0.432,190,1.091,363,4.917,645,4.689,649,5.19,650,6.684]],["title/199",[32,0.394,363,3.131,645,2.987,649,3.305]],["description/199",[17,0.261,32,0.584,53,0.186,179,0.399,180,0.989,181,0.408,190,1.03,205,1.562,238,2.485,363,4.644,645,4.429,649,4.901,651,6.313]],["title/200",[34,4.939]],["description/200",[6,4.201,34,5.117,50,3.122,78,6.234,98,5.757,123,3.399,162,4.501,611,6.234]],["title/201",[6,2.571,32,0.394,34,3.131,399,3.305]],["description/201",[3,0.793,6,4.201,32,0.644,34,5.117,123,3.399,178,4.501,399,5.401,652,6.957]],["title/202",[44,4.055]],["description/202",[3,0.372,6,0.636,7,3.59,11,2.581,20,0.982,21,3.683,23,0.871,24,0.943,28,0.636,32,0.177,37,0.943,38,0.943,39,0.943,40,0.943,41,0.943,42,0.871,43,0.943,44,4.387,45,0.943,53,0.057,56,0.224,66,0.369,68,0.392,72,0.432,76,2.657,77,0.421,79,0.482,80,0.463,97,1.489,114,0.539,131,0.475,134,0.099,135,1.159,137,0.387,139,0.628,162,2.748,163,4.133,164,3.849,165,3.849,166,4.1,167,4.322,168,4.17,169,1.588,170,3.795,171,1.588,172,0.943,173,1.29,174,0.73,175,1.489,176,0.943,177,1.588,178,1.241,186,0.943,187,0.943,188,0.943,189,0.943,194,0.369,203,0.598,228,0.943,229,3.513,230,1.719,231,1.588,232,0.943,233,0.681,234,1.719,299,0.943,300,2.697,301,2.052,302,1.588,415,1.06,428,0.943,429,1.719,430,0.871,431,0.943,432,0.943,433,0.943,434,0.943,435,0.943,436,0.943,437,0.943,458,0.943,459,1.719,460,0.943,461,0.943,462,0.943,463,2.368,464,0.943,465,0.943,466,0.943,613,0.943,653,1.053,654,1.053,655,1.918,656,1.053,657,1.053]]],"invertedIndex":[["",{"_index":7,"title":{},"description":{"0":{},"3":{},"6":{},"16":{},"19":{},"22":{},"52":{},"73":{},"109":{},"118":{},"154":{},"158":{},"160":{},"168":{},"202":{}}}],["00:00",{"_index":453,"title":{},"description":{"117":{}}}],["0:00",{"_index":167,"title":{},"description":{"3":{},"6":{},"16":{},"52":{},"109":{},"118":{},"168":{},"202":{}}}],["1",{"_index":304,"title":{},"description":{"54":{}}}],["100",{"_index":327,"title":{},"description":{"64":{},"65":{}}}],["10th",{"_index":462,"title":{},"description":{"118":{},"202":{}}}],["13th",{"_index":230,"title":{},"description":{"16":{},"202":{}}}],["15th",{"_index":302,"title":{},"description":{"52":{},"168":{},"202":{}}}],["17th",{"_index":165,"title":{},"description":{"3":{},"6":{},"202":{}}}],["2023",{"_index":166,"title":{},"description":{"3":{},"6":{},"52":{},"109":{},"118":{},"168":{},"202":{}}}],["2024",{"_index":435,"title":{},"description":{"109":{},"202":{}}}],["2025",{"_index":466,"title":{},"description":{"118":{},"202":{}}}],["2026",{"_index":231,"title":{},"description":{"16":{},"117":{},"202":{}}}],["25th",{"_index":460,"title":{},"description":{"118":{},"202":{}}}],["26th",{"_index":431,"title":{},"description":{"109":{},"202":{}}}],["30",{"_index":434,"title":{},"description":{"109":{},"202":{}}}],["4th",{"_index":465,"title":{},"description":{"118":{},"202":{}}}],["6-charact",{"_index":484,"title":{},"description":{"121":{}}}],["9th",{"_index":452,"title":{},"description":{"117":{}}}],["_disconnected_",{"_index":102,"title":{},"description":{"0":{}}}],["absolut",{"_index":606,"title":{},"description":{"166":{}}}],["accept",{"_index":136,"title":{},"description":{"0":{},"14":{},"117":{}}}],["access",{"_index":154,"title":{},"description":{"2":{},"19":{},"22":{},"89":{},"183":{},"189":{}}}],["accordingli",{"_index":437,"title":{},"description":{"109":{},"202":{}}}],["account",{"_index":51,"title":{"1":{},"2":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{}},"description":{"0":{},"1":{},"2":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"19":{},"22":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"112":{}}}],["act",{"_index":54,"title":{},"description":{"0":{},"1":{}}}],["action",{"_index":647,"title":{},"description":{"197":{}}}],["activ",{"_index":498,"title":{},"description":{"131":{},"134":{},"179":{},"182":{}}}],["actual",{"_index":529,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["ad",{"_index":638,"title":{},"description":{"188":{}}}],["add",{"_index":642,"title":{},"description":{"194":{}}}],["address",{"_index":610,"title":{},"description":{"168":{}}}],["admin",{"_index":174,"title":{},"description":{"3":{},"6":{},"42":{},"43":{},"44":{},"45":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"202":{}}}],["against",{"_index":535,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["ai",{"_index":402,"title":{},"description":{"89":{}}}],["alloc",{"_index":107,"title":{"9":{},"23":{},"24":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{}},"description":{"0":{},"9":{},"19":{},"21":{},"22":{},"23":{},"24":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"46":{},"52":{},"109":{},"121":{},"137":{},"168":{},"170":{},"172":{},"173":{},"174":{}}}],["allow",{"_index":285,"title":{},"description":{"41":{},"105":{},"109":{},"175":{},"183":{}}}],["alongsid",{"_index":105,"title":{},"description":{"0":{}}}],["alreadi",{"_index":282,"title":{},"description":{"40":{},"152":{}}}],["already-`termin",{"_index":575,"title":{},"description":{"152":{}}}],["altern",{"_index":319,"title":{},"description":{"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{}}}],["anchor",{"_index":73,"title":{},"description":{"0":{},"3":{},"6":{},"16":{}}}],["announc",{"_index":43,"title":{},"description":{"0":{},"202":{}}}],["anoth",{"_index":288,"title":{},"description":{"41":{}}}],["anytim",{"_index":272,"title":{},"description":{"32":{}}}],["api",{"_index":6,"title":{"201":{}},"description":{"0":{},"1":{},"2":{},"17":{},"169":{},"197":{},"200":{},"201":{},"202":{}}}],["appropri",{"_index":75,"title":{},"description":{"0":{}}}],["april",{"_index":301,"title":{},"description":{"52":{},"118":{},"168":{},"202":{}}}],["array",{"_index":366,"title":{},"description":{"75":{}}}],["assign",{"_index":142,"title":{"136":{}},"description":{"0":{},"121":{},"136":{}}}],["associ",{"_index":145,"title":{"115":{},"116":{},"117":{}},"description":{"0":{},"25":{},"26":{},"116":{},"117":{},"131":{},"134":{},"167":{},"172":{},"174":{},"187":{},"191":{},"193":{}}}],["atom",{"_index":469,"title":{},"description":{"121":{}}}],["attach",{"_index":457,"title":{},"description":{"118":{}}}],["attribut",{"_index":162,"title":{},"description":{"3":{},"6":{},"16":{},"109":{},"132":{},"156":{},"200":{},"202":{}}}],["audit",{"_index":645,"title":{"197":{},"198":{},"199":{}},"description":{"197":{},"198":{},"199":{}}}],["august",{"_index":164,"title":{},"description":{"3":{},"6":{},"202":{}}}],["auth",{"_index":25,"title":{},"description":{"0":{}}}],["authent",{"_index":8,"title":{},"description":{"0":{}}}],["author",{"_index":179,"title":{},"description":{"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"25":{},"26":{},"28":{},"30":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"47":{},"48":{},"49":{},"50":{},"51":{},"53":{},"54":{},"55":{},"56":{},"57":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"104":{},"105":{},"106":{},"107":{},"108":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"130":{},"133":{},"135":{},"136":{},"137":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"152":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"163":{},"164":{},"165":{},"166":{},"167":{},"169":{},"170":{},"171":{},"172":{},"174":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"198":{},"199":{}}}],["automat",{"_index":173,"title":{},"description":{"3":{},"6":{},"86":{},"87":{},"88":{},"121":{},"202":{}}}],["avail",{"_index":99,"title":{},"description":{"0":{},"25":{},"121":{}}}],["awar",{"_index":30,"title":{},"description":{"0":{}}}],["backward",{"_index":38,"title":{},"description":{"0":{},"202":{}}}],["batch",{"_index":324,"title":{"64":{},"65":{},"121":{}},"description":{"64":{},"65":{},"121":{}}}],["be",{"_index":31,"title":{},"description":{"0":{},"182":{},"188":{}}}],["bearer",{"_index":13,"title":{},"description":{"0":{}}}],["becom",{"_index":487,"title":{},"description":{"121":{}}}],["behalf",{"_index":643,"title":{},"description":{"195":{}}}],["belong",{"_index":195,"title":{},"description":{"9":{},"26":{},"29":{},"31":{},"43":{},"44":{},"45":{},"46":{},"52":{},"64":{},"65":{},"122":{},"123":{},"124":{},"133":{},"135":{},"136":{},"137":{},"165":{},"166":{},"167":{},"174":{}}}],["best-effort",{"_index":564,"title":{},"description":{"152":{}}}],["between",{"_index":290,"title":{},"description":{"43":{},"46":{},"52":{},"96":{},"162":{}}}],["bill",{"_index":380,"title":{},"description":{"86":{}}}],["block",{"_index":80,"title":{"168":{},"169":{},"170":{},"171":{},"172":{},"173":{},"174":{}},"description":{"0":{},"25":{},"32":{},"46":{},"52":{},"54":{},"129":{},"140":{},"168":{},"169":{},"170":{},"171":{},"172":{},"173":{},"174":{},"202":{}}}],["blocksiz",{"_index":613,"title":{},"description":{"168":{},"202":{}}}],["bmc",{"_index":312,"title":{},"description":{"58":{},"66":{},"80":{}}}],["bodi",{"_index":361,"title":{},"description":{"75":{}}}],["bom",{"_index":382,"title":{},"description":{"86":{}}}],["boot",{"_index":423,"title":{},"description":{"103":{}}}],["both",{"_index":55,"title":{},"description":{"0":{},"1":{},"24":{},"43":{},"45":{},"105":{},"110":{},"117":{}}}],["boundari",{"_index":277,"title":{},"description":{"34":{}}}],["break",{"_index":41,"title":{},"description":{"0":{},"202":{}}}],["breakdown",{"_index":519,"title":{},"description":{"137":{}}}],["brief",{"_index":94,"title":{},"description":{"0":{}}}],["bring",{"_index":556,"title":{"149":{},"150":{}},"description":{"149":{},"150":{}}}],["broken",{"_index":514,"title":{},"description":{"136":{}}}],["build",{"_index":496,"title":{},"description":{"129":{},"140":{}}}],["call",{"_index":33,"title":{},"description":{"0":{}}}],["cancel",{"_index":563,"title":{"152":{}},"description":{"152":{}}}],["capabl",{"_index":66,"title":{"138":{},"139":{}},"description":{"0":{},"1":{},"16":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"109":{},"116":{},"138":{},"139":{},"202":{}}}],["case",{"_index":59,"title":{},"description":{"0":{},"32":{}}}],["certain",{"_index":505,"title":{},"description":{"133":{}}}],["chang",{"_index":42,"title":{},"description":{"0":{},"152":{},"202":{}}}],["characterist",{"_index":384,"title":{},"description":{"86":{},"87":{},"88":{}}}],["chassi",{"_index":339,"title":{},"description":{"72":{},"73":{}}}],["chassis.manufactur",{"_index":346,"title":{},"description":{"72":{},"73":{}}}],["chassis.model",{"_index":348,"title":{},"description":{"72":{},"73":{}}}],["chassis.serial-numb",{"_index":347,"title":{},"description":{"72":{},"73":{}}}],["child",{"_index":617,"title":{},"description":{"174":{}}}],["choos",{"_index":101,"title":{},"description":{"0":{}}}],["clear",{"_index":368,"title":{},"description":{"75":{}}}],["combin",{"_index":585,"title":{},"description":{"154":{},"158":{},"160":{}}}],["commun",{"_index":287,"title":{},"description":{"41":{},"96":{}}}],["compar",{"_index":528,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["compat",{"_index":39,"title":{},"description":{"0":{},"202":{}}}],["complet",{"_index":607,"title":{},"description":{"166":{}}}],["compon",{"_index":527,"title":{},"description":{"143":{},"144":{},"153":{},"154":{},"156":{},"157":{}}}],["component-level",{"_index":588,"title":{},"description":{"154":{},"158":{},"160":{}}}],["componentid",{"_index":589,"title":{},"description":{"154":{},"158":{},"160":{}}}],["comput",{"_index":147,"title":{},"description":{"0":{},"6":{},"23":{},"25":{},"89":{}}}],["configur",{"_index":19,"title":{},"description":{"0":{},"1":{},"2":{},"20":{},"86":{},"87":{},"88":{},"121":{},"143":{},"144":{},"156":{},"157":{}}}],["confirm/accept",{"_index":215,"title":{},"description":{"12":{}}}],["connect",{"_index":197,"title":{},"description":{"10":{},"46":{},"52":{}}}],["consol",{"_index":633,"title":{},"description":{"183":{},"189":{}}}],["constraint",{"_index":258,"title":{"29":{},"30":{},"31":{},"32":{},"33":{}},"description":{"25":{},"29":{},"30":{},"31":{},"32":{},"33":{},"154":{},"158":{},"160":{}}}],["constraintvalu",{"_index":270,"title":{},"description":{"32":{}}}],["consult",{"_index":22,"title":{},"description":{"0":{}}}],["consum",{"_index":185,"title":{},"description":{"6":{}}}],["contain",{"_index":223,"title":{},"description":{"16":{},"129":{},"140":{}}}],["contigu",{"_index":609,"title":{},"description":{"168":{}}}],["continu",{"_index":450,"title":{},"description":{"117":{}}}],["control",{"_index":545,"title":{"145":{},"146":{},"158":{},"159":{}},"description":{"145":{},"146":{},"158":{},"159":{},"162":{}}}],["convey",{"_index":342,"title":{},"description":{"72":{},"73":{}}}],["core",{"_index":87,"title":{},"description":{"0":{}}}],["count",{"_index":511,"title":{},"description":{"136":{}}}],["cpu",{"_index":408,"title":{},"description":{"89":{},"129":{}}}],["creat",{"_index":72,"title":{"12":{},"18":{},"25":{},"30":{},"36":{},"43":{},"48":{},"54":{},"59":{},"64":{},"67":{},"73":{},"81":{},"91":{},"98":{},"105":{},"111":{},"116":{},"120":{},"121":{},"164":{},"170":{},"177":{},"185":{},"191":{}},"description":{"0":{},"3":{},"6":{},"12":{},"15":{},"16":{},"18":{},"25":{},"27":{},"29":{},"30":{},"31":{},"32":{},"33":{},"36":{},"43":{},"48":{},"54":{},"59":{},"64":{},"67":{},"73":{},"75":{},"81":{},"91":{},"98":{},"105":{},"111":{},"120":{},"121":{},"151":{},"152":{},"164":{},"166":{},"170":{},"173":{},"174":{},"177":{},"180":{},"185":{},"191":{},"202":{}}}],["credenti",{"_index":313,"title":{},"description":{"58":{},"66":{},"80":{},"180":{}}}],["criteria",{"_index":506,"title":{},"description":{"133":{}}}],["current",{"_index":46,"title":{"2":{},"4":{},"5":{},"7":{},"8":{},"196":{}},"description":{"0":{},"2":{},"4":{},"5":{},"7":{},"8":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"196":{}}}],["custom",{"_index":624,"title":{},"description":{"175":{}}}],["cycl",{"_index":548,"title":{},"description":{"145":{},"146":{},"158":{},"159":{}}}],["data",{"_index":128,"title":{},"description":{"0":{},"12":{},"105":{},"180":{}}}],["datacent",{"_index":222,"title":{},"description":{"16":{}}}],["decommiss",{"_index":274,"title":{},"description":{"32":{}}}],["decrement",{"_index":273,"title":{},"description":{"32":{}}}],["default",{"_index":476,"title":{},"description":{"121":{}}}],["defin",{"_index":86,"title":{},"description":{"0":{},"34":{},"86":{},"109":{},"139":{},"168":{}}}],["deleg",{"_index":248,"title":{},"description":{"23":{},"168":{}}}],["delet",{"_index":221,"title":{"15":{},"21":{},"27":{},"33":{},"38":{},"45":{},"50":{},"56":{},"63":{},"71":{},"76":{},"79":{},"85":{},"93":{},"101":{},"107":{},"113":{},"117":{},"123":{},"133":{},"167":{},"172":{},"179":{},"182":{},"187":{},"193":{}},"description":{"15":{},"21":{},"27":{},"33":{},"38":{},"45":{},"50":{},"56":{},"63":{},"71":{},"75":{},"76":{},"79":{},"85":{},"93":{},"101":{},"107":{},"113":{},"117":{},"123":{},"133":{},"167":{},"172":{},"179":{},"182":{},"187":{},"193":{}}}],["depend",{"_index":18,"title":{},"description":{"0":{}}}],["deploy",{"_index":104,"title":{},"description":{"0":{},"2":{},"179":{},"182":{}}}],["deprec",{"_index":44,"title":{"202":{}},"description":{"0":{},"3":{},"6":{},"16":{},"52":{},"109":{},"118":{},"168":{},"202":{}}}],["deprecations](#tag/deprec",{"_index":49,"title":{},"description":{"0":{}}}],["deriv",{"_index":383,"title":{"174":{}},"description":{"86":{},"87":{},"88":{}}}],["describ",{"_index":611,"title":{},"description":{"168":{},"200":{}}}],["design",{"_index":397,"title":{},"description":{"89":{}}}],["desir",{"_index":608,"title":{},"description":{"166":{}}}],["detail",{"_index":20,"title":{"137":{}},"description":{"0":{},"3":{},"6":{},"44":{},"112":{},"131":{},"134":{},"137":{},"143":{},"144":{},"156":{},"157":{},"181":{},"196":{},"202":{}}}],["diff",{"_index":536,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["differ",{"_index":294,"title":{},"description":{"43":{},"121":{}}}],["direct",{"_index":405,"title":{},"description":{"89":{},"96":{}}}],["directli",{"_index":226,"title":{},"description":{"16":{}}}],["disabl",{"_index":156,"title":{},"description":{"2":{}}}],["discov",{"_index":310,"title":{},"description":{"58":{},"59":{},"66":{},"67":{},"72":{},"73":{},"80":{},"81":{},"87":{},"88":{}}}],["discoveri",{"_index":317,"title":{},"description":{"58":{},"66":{},"72":{},"80":{}}}],["displaynam",{"_index":432,"title":{},"description":{"109":{},"202":{}}}],["distinct",{"_index":521,"title":{},"description":{"138":{}}}],["distribut",{"_index":412,"title":{},"description":{"89":{}}}],["domain",{"_index":477,"title":{},"description":{"121":{}}}],["domain-awar",{"_index":468,"title":{},"description":{"121":{}}}],["down",{"_index":515,"title":{},"description":{"136":{}}}],["dpu",{"_index":622,"title":{"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{}},"description":{"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{}}}],["e.g",{"_index":485,"title":{},"description":{"121":{}}}],["each",{"_index":83,"title":{},"description":{"0":{},"137":{}}}],["effect",{"_index":655,"title":{},"description":{"202":{}}}],["elig",{"_index":507,"title":{},"description":{"133":{}}}],["empti",{"_index":367,"title":{},"description":{"75":{}}}],["enabl",{"_index":67,"title":{},"description":{"0":{},"1":{},"2":{},"46":{},"52":{},"87":{},"88":{}}}],["enablesshaccess",{"_index":186,"title":{},"description":{"6":{},"202":{}}}],["enclosur",{"_index":523,"title":{},"description":{"140":{}}}],["endpoint",{"_index":76,"title":{},"description":{"0":{},"3":{},"6":{},"121":{},"194":{},"202":{}}}],["endpoint](#tag/allocation/operation/create-alloc",{"_index":108,"title":{},"description":{"0":{}}}],["endpoint](#tag/infrastructure-provider/operation/get-current-infrastructure-provid",{"_index":69,"title":{},"description":{"0":{}}}],["endpoint](#tag/instance-type/operation/create-instance-typ",{"_index":138,"title":{},"description":{"0":{}}}],["endpoint](#tag/instance-type/operation/create-instance-type-machine-associ",{"_index":146,"title":{},"description":{"0":{}}}],["endpoint](#tag/instance-type/operation/get-all-instance-typ",{"_index":152,"title":{},"description":{"0":{}}}],["endpoint](#tag/ip-block/operation/create-ipblock",{"_index":90,"title":{},"description":{"0":{}}}],["endpoint](#tag/ip-block/operation/get-all-ipblock",{"_index":150,"title":{},"description":{"0":{}}}],["endpoint](#tag/machine/operation/get-all-machin",{"_index":130,"title":{},"description":{"0":{}}}],["endpoint](#tag/machine/operation/update-machin",{"_index":141,"title":{},"description":{"0":{}}}],["endpoint](#tag/metadata/operation/get-metadata",{"_index":35,"title":{},"description":{"0":{}}}],["endpoint](#tag/operating-system/operation/create-operating-system",{"_index":124,"title":{},"description":{"0":{}}}],["endpoint](#tag/service-account/operation/get-current-service-account",{"_index":61,"title":{},"description":{"0":{}}}],["endpoint](#tag/site/operation/get-all-sit",{"_index":100,"title":{},"description":{"0":{}}}],["endpoint](#tag/subnet/operation/create-subnet",{"_index":121,"title":{},"description":{"0":{}}}],["endpoint](#tag/tenant-account/operation/create-tenant-account",{"_index":132,"title":{},"description":{"0":{}}}],["endpoint](#tag/tenant-account/operation/update-tenant-account",{"_index":148,"title":{},"description":{"0":{}}}],["endpoint](#tag/tenant/operation/get-current-ten",{"_index":70,"title":{},"description":{"0":{}}}],["endpoint](#tag/vpc-prefix/operation/create-vpc-prefix",{"_index":119,"title":{},"description":{"0":{}}}],["endpoint](#tag/vpc/operation/create-vpc",{"_index":113,"title":{},"description":{"0":{}}}],["enough",{"_index":255,"title":{},"description":{"25":{}}}],["entiti",{"_index":62,"title":{},"description":{"0":{},"1":{},"3":{},"4":{},"6":{},"7":{},"11":{},"12":{},"13":{},"14":{},"15":{},"18":{},"21":{},"25":{},"27":{},"28":{},"29":{},"30":{},"31":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"47":{},"48":{},"49":{},"50":{},"51":{},"53":{},"54":{},"55":{},"56":{},"57":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"104":{},"105":{},"106":{},"107":{},"108":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"130":{},"131":{},"133":{},"134":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"152":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"163":{},"164":{},"165":{},"166":{},"167":{},"172":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{}}}],["entri",{"_index":363,"title":{"198":{},"199":{}},"description":{"75":{},"198":{},"199":{}}}],["equal",{"_index":261,"title":{},"description":{"25":{}}}],["etc",{"_index":473,"title":{},"description":{"121":{}}}],["exclus",{"_index":583,"title":{},"description":{"154":{},"158":{},"160":{}}}],["exist",{"_index":264,"title":{},"description":{"28":{},"32":{},"33":{},"39":{},"51":{},"57":{},"62":{},"63":{},"70":{},"71":{},"75":{},"78":{},"79":{},"84":{},"85":{},"94":{},"173":{}}}],["expect",{"_index":308,"title":{"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"66":{},"67":{},"68":{},"69":{},"70":{},"71":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"84":{},"85":{}},"description":{"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"66":{},"67":{},"68":{},"69":{},"70":{},"71":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"143":{},"144":{},"156":{},"157":{}}}],["expectedrack",{"_index":364,"title":{},"description":{"75":{}}}],["extens",{"_index":623,"title":{"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{}},"description":{"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{}}}],["extra",{"_index":540,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["fail",{"_index":479,"title":{},"description":{"121":{},"152":{}}}],["fals",{"_index":480,"title":{},"description":{"121":{}}}],["favor",{"_index":229,"title":{},"description":{"16":{},"52":{},"109":{},"118":{},"168":{},"202":{}}}],["file](https://github.com/nvidia/infra-controller-core/blob/v0.5.8/deploy/files/nico-api/nico-api-site-config.toml#l30",{"_index":89,"title":{},"description":{"0":{}}}],["filter",{"_index":531,"title":{},"description":{"143":{},"145":{},"147":{},"149":{},"154":{},"156":{},"158":{},"160":{}}}],["finish",{"_index":577,"title":{},"description":{"152":{}}}],["firmwar",{"_index":553,"title":{"147":{},"148":{},"160":{},"161":{}},"description":{"147":{},"148":{},"160":{},"161":{}}}],["first",{"_index":9,"title":{},"description":{"0":{}}}],["flow",{"_index":97,"title":{},"description":{"0":{},"16":{},"162":{},"202":{}}}],["fnn",{"_index":118,"title":{},"description":{"0":{},"46":{},"52":{}}}],["follow",{"_index":654,"title":{},"description":{"202":{}}}],["forcecycl",{"_index":550,"title":{},"description":{"145":{},"146":{},"158":{},"159":{}}}],["forceoff",{"_index":549,"title":{},"description":{"145":{},"146":{},"158":{},"159":{}}}],["forge_provider_admin",{"_index":357,"title":{},"description":{"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"152":{}}}],["forge_provider_view",{"_index":359,"title":{},"description":{"74":{},"77":{}}}],["full",{"_index":109,"title":{},"description":{"0":{},"75":{}}}],["futur",{"_index":657,"title":{},"description":{"202":{}}}],["gener",{"_index":36,"title":{},"description":{"0":{},"121":{}}}],["get",{"_index":0,"title":{"0":{}},"description":{}}],["given",{"_index":265,"title":{},"description":{"29":{},"30":{},"31":{},"115":{}}}],["gpu",{"_index":418,"title":{"135":{}},"description":{"96":{},"129":{},"135":{}}}],["grant",{"_index":239,"title":{},"description":{"19":{},"22":{}}}],["group",{"_index":194,"title":{"162":{},"163":{},"164":{},"165":{},"166":{},"167":{},"183":{},"184":{},"185":{},"186":{},"187":{},"188":{}},"description":{"9":{},"86":{},"89":{},"96":{},"109":{},"135":{},"136":{},"139":{},"162":{},"163":{},"164":{},"165":{},"166":{},"167":{},"183":{},"184":{},"185":{},"186":{},"187":{},"188":{},"191":{},"193":{},"194":{},"202":{}}}],["hardwar",{"_index":225,"title":{},"description":{"16":{},"86":{},"87":{},"88":{},"129":{},"139":{}}}],["help",{"_index":316,"title":{},"description":{"58":{},"66":{},"72":{},"80":{}}}],["here",{"_index":653,"title":{},"description":{"202":{}}}],["high-perform",{"_index":394,"title":{},"description":{"89":{}}}],["histori",{"_index":161,"title":{"22":{},"125":{},"134":{}},"description":{"3":{},"6":{},"16":{},"22":{},"52":{},"109":{},"118":{},"125":{},"168":{}}}],["holder",{"_index":82,"title":{},"description":{"0":{}}}],["hpc",{"_index":401,"title":{},"description":{"89":{}}}],["ib",{"_index":393,"title":{},"description":{"89":{}}}],["id",{"_index":205,"title":{},"description":{"11":{},"12":{},"13":{},"14":{},"15":{},"19":{},"26":{},"27":{},"29":{},"30":{},"31":{},"32":{},"33":{},"37":{},"38":{},"44":{},"45":{},"50":{},"56":{},"61":{},"62":{},"63":{},"69":{},"70":{},"71":{},"77":{},"78":{},"79":{},"83":{},"84":{},"85":{},"88":{},"93":{},"99":{},"101":{},"104":{},"105":{},"106":{},"107":{},"108":{},"112":{},"113":{},"114":{},"117":{},"122":{},"123":{},"124":{},"142":{},"155":{},"165":{},"166":{},"167":{},"171":{},"178":{},"179":{},"186":{},"192":{},"193":{},"194":{},"199":{}}}],["id`/`componentid",{"_index":586,"title":{},"description":{"154":{}}}],["idempot",{"_index":565,"title":{},"description":{"152":{}}}],["ident",{"_index":340,"title":{},"description":{"72":{},"73":{}}}],["identifi",{"_index":309,"title":{},"description":{"58":{},"66":{},"72":{},"73":{},"78":{},"79":{},"80":{},"146":{},"148":{},"150":{},"159":{},"161":{},"195":{}}}],["ids`/`componentid",{"_index":596,"title":{},"description":{"158":{},"160":{}}}],["includ",{"_index":518,"title":{},"description":{"137":{}}}],["includemachineassign",{"_index":429,"title":{},"description":{"109":{},"202":{}}}],["includemachineassoci",{"_index":428,"title":{},"description":{"109":{},"202":{}}}],["increment",{"_index":271,"title":{},"description":{"32":{}}}],["indirectli",{"_index":227,"title":{},"description":{"16":{}}}],["individu",{"_index":619,"title":{},"description":{"174":{},"195":{}}}],["infer",{"_index":249,"title":{},"description":{"24":{},"26":{},"110":{}}}],["infiniband",{"_index":391,"title":{"89":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"127":{}},"description":{"89":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"127":{}}}],["inform",{"_index":178,"title":{},"description":{"3":{},"6":{},"10":{},"12":{},"72":{},"73":{},"201":{},"202":{}}}],["infrastructur",{"_index":68,"title":{"3":{},"4":{},"5":{}},"description":{"0":{},"3":{},"4":{},"5":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"18":{},"19":{},"20":{},"21":{},"22":{},"25":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"66":{},"67":{},"68":{},"69":{},"70":{},"71":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"104":{},"105":{},"106":{},"107":{},"108":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"130":{},"131":{},"133":{},"134":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"152":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"170":{},"172":{},"173":{},"174":{},"202":{}}}],["infrastructureproviderid",{"_index":201,"title":{},"description":{"11":{},"13":{},"17":{},"104":{},"105":{},"106":{},"107":{},"108":{},"169":{}}}],["ingest",{"_index":318,"title":{},"description":{"58":{},"66":{},"72":{},"80":{}}}],["initi",{"_index":63,"title":{},"description":{"0":{},"1":{}}}],["instal",{"_index":103,"title":{},"description":{"0":{}}}],["instanc",{"_index":131,"title":{"9":{},"109":{},"110":{},"111":{},"112":{},"113":{},"114":{},"118":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"127":{},"128":{},"136":{}},"description":{"0":{},"9":{},"25":{},"34":{},"40":{},"41":{},"46":{},"52":{},"109":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"131":{},"132":{},"134":{},"136":{},"137":{},"139":{},"162":{},"165":{},"166":{},"167":{},"175":{},"183":{},"189":{},"202":{}}}],["instancesubnet",{"_index":461,"title":{},"description":{"118":{},"202":{}}}],["instancetyp",{"_index":269,"title":{},"description":{"32":{}}}],["instead",{"_index":170,"title":{},"description":{"3":{},"6":{},"16":{},"52":{},"109":{},"118":{},"168":{},"202":{}}}],["insuffici",{"_index":478,"title":{},"description":{"121":{}}}],["interconnect",{"_index":398,"title":{},"description":{"89":{}}}],["interfac",{"_index":415,"title":{"95":{},"102":{},"126":{},"127":{},"128":{}},"description":{"95":{},"102":{},"118":{},"121":{},"126":{},"127":{},"128":{},"202":{}}}],["invit",{"_index":213,"title":{},"description":{"12":{},"14":{}}}],["ip",{"_index":79,"title":{"168":{},"169":{},"170":{},"171":{},"172":{},"173":{},"174":{}},"description":{"0":{},"25":{},"32":{},"46":{},"52":{},"54":{},"168":{},"169":{},"170":{},"171":{},"172":{},"173":{},"174":{},"202":{}}}],["ipblock",{"_index":275,"title":{},"description":{"32":{}}}],["ipblocks",{"_index":299,"title":{},"description":{"52":{},"202":{}}}],["ipv4",{"_index":305,"title":{},"description":{"54":{}}}],["ipv6",{"_index":306,"title":{},"description":{"54":{}}}],["ipx",{"_index":126,"title":{},"description":{"0":{},"103":{}}}],["isflowen",{"_index":234,"title":{},"description":{"16":{},"202":{}}}],["isol",{"_index":276,"title":{},"description":{"34":{},"89":{}}}],["israckleveladministrationen",{"_index":232,"title":{},"description":{"16":{},"202":{}}}],["isserialconsolesshkeysen",{"_index":187,"title":{},"description":{"6":{},"202":{}}}],["juli",{"_index":430,"title":{},"description":{"109":{},"117":{},"202":{}}}],["jwt",{"_index":12,"title":{},"description":{"0":{}}}],["k8",{"_index":625,"title":{},"description":{"175":{}}}],["keep",{"_index":377,"title":{},"description":{"86":{},"87":{},"88":{}}}],["key",{"_index":345,"title":{"183":{},"184":{},"185":{},"186":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{}},"description":{"72":{},"73":{},"121":{},"183":{},"184":{},"185":{},"186":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{}}}],["know",{"_index":133,"title":{},"description":{"0":{}}}],["label",{"_index":344,"title":{},"description":{"72":{},"73":{},"132":{}}}],["length",{"_index":111,"title":{},"description":{"0":{},"25":{},"168":{}}}],["level",{"_index":78,"title":{},"description":{"0":{},"200":{}}}],["list",{"_index":48,"title":{},"description":{"0":{},"75":{}}}],["load",{"_index":411,"title":{},"description":{"89":{}}}],["locat",{"_index":341,"title":{},"description":{"72":{},"73":{}}}],["location.datacent",{"_index":350,"title":{},"description":{"72":{},"73":{}}}],["location.posit",{"_index":352,"title":{},"description":{"72":{},"73":{}}}],["location.region",{"_index":349,"title":{},"description":{"72":{},"73":{}}}],["location.room",{"_index":351,"title":{},"description":{"72":{},"73":{}}}],["log",{"_index":649,"title":{"198":{},"199":{}},"description":{"198":{},"199":{}}}],["logic",{"_index":410,"title":{"96":{},"97":{},"98":{},"99":{},"100":{},"101":{}},"description":{"89":{},"96":{},"97":{},"98":{},"99":{},"100":{},"101":{},"195":{}}}],["longer",{"_index":454,"title":{},"description":{"117":{}}}],["low-lat",{"_index":395,"title":{},"description":{"89":{},"96":{}}}],["machin",{"_index":129,"title":{"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"129":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"138":{},"139":{}},"description":{"0":{},"25":{},"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"86":{},"87":{},"88":{},"89":{},"103":{},"109":{},"115":{},"116":{},"117":{},"118":{},"121":{},"129":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"138":{},"139":{},"140":{}}}],["machine'",{"_index":140,"title":{},"description":{"0":{},"116":{},"117":{}}}],["machine/inst",{"_index":442,"title":{"116":{},"117":{}},"description":{"117":{}}}],["machineassociationid",{"_index":446,"title":{},"description":{"117":{}}}],["machineid",{"_index":449,"title":{},"description":{"117":{}}}],["machines/inst",{"_index":440,"title":{"115":{}},"description":{}}],["maintain",{"_index":37,"title":{},"description":{"0":{},"202":{}}}],["mainten",{"_index":500,"title":{},"description":{"132":{}}}],["make",{"_index":60,"title":{},"description":{"0":{}}}],["manag",{"_index":160,"title":{},"description":{"3":{},"27":{},"28":{},"46":{},"86":{},"172":{},"173":{}}}],["manufactur",{"_index":534,"title":{},"description":{"143":{}}}],["mark",{"_index":570,"title":{},"description":{"152":{}}}],["match",{"_index":206,"title":{},"description":{"11":{},"12":{},"13":{},"14":{},"75":{},"104":{},"105":{},"106":{},"107":{},"108":{}}}],["materi",{"_index":381,"title":{},"description":{"86":{}}}],["maximum",{"_index":325,"title":{},"description":{"64":{},"65":{}}}],["mechan",{"_index":247,"title":{},"description":{"23":{}}}],["meet",{"_index":504,"title":{},"description":{"133":{}}}],["membership",{"_index":250,"title":{},"description":{"24":{},"26":{},"110":{}}}],["memori",{"_index":406,"title":{},"description":{"89":{},"96":{},"129":{}}}],["metadata",{"_index":34,"title":{"200":{},"201":{}},"description":{"0":{},"200":{},"201":{}}}],["mismatch",{"_index":541,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["miss",{"_index":539,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["mode",{"_index":52,"title":{},"description":{"0":{},"1":{}}}],["modifi",{"_index":245,"title":{},"description":{"20":{},"32":{},"180":{}}}],["modul",{"_index":26,"title":{},"description":{"0":{}}}],["more",{"_index":379,"title":{},"description":{"86":{},"118":{}}}],["multi-ten",{"_index":293,"title":{},"description":{"43":{},"45":{}}}],["multipl",{"_index":143,"title":{},"description":{"0":{},"64":{},"65":{},"121":{}}}],["mutual",{"_index":582,"title":{},"description":{"154":{},"158":{},"160":{}}}],["mvp",{"_index":263,"title":{},"description":{"27":{},"28":{},"105":{}}}],["name",{"_index":135,"title":{},"description":{"0":{},"3":{},"6":{},"12":{},"121":{},"135":{},"143":{},"147":{},"149":{},"202":{}}}],["name/manufacturer/typ",{"_index":593,"title":{},"description":{"156":{}}}],["nameprefix",{"_index":482,"title":{},"description":{"121":{}}}],["narrow",{"_index":532,"title":{},"description":{"143":{}}}],["nativ",{"_index":117,"title":{},"description":{"0":{},"46":{},"52":{}}}],["network",{"_index":84,"title":{"162":{},"163":{},"164":{},"165":{},"166":{},"167":{}},"description":{"0":{},"6":{},"16":{},"23":{},"25":{},"34":{},"40":{},"46":{},"52":{},"81":{},"89":{},"129":{},"162":{},"163":{},"164":{},"165":{},"166":{},"167":{},"168":{}}}],["new",{"_index":362,"title":{},"description":{"75":{},"180":{}}}],["next",{"_index":29,"title":{},"description":{"0":{}}}],["nico",{"_index":23,"title":{},"description":{"0":{},"103":{},"202":{}}}],["non-termin",{"_index":566,"title":{},"description":{"152":{}}}],["note",{"_index":91,"title":{},"description":{"0":{}}}],["notic",{"_index":45,"title":{},"description":{"0":{},"202":{}}}],["number",{"_index":315,"title":{},"description":{"58":{},"66":{},"80":{},"140":{}}}],["nvlink",{"_index":417,"title":{"96":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"128":{}},"description":{"96":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"121":{},"128":{}}}],["nvo",{"_index":372,"title":{},"description":{"80":{}}}],["object",{"_index":219,"title":{},"description":{"14":{},"16":{}}}],["octob",{"_index":433,"title":{},"description":{"109":{},"202":{}}}],["offer",{"_index":296,"title":{},"description":{"46":{}}}],["older",{"_index":236,"title":{},"description":{"17":{},"169":{}}}],["on",{"_index":286,"title":{},"description":{"41":{},"42":{},"44":{},"86":{},"118":{}}}],["onc",{"_index":74,"title":{},"description":{"0":{}}}],["onlin",{"_index":636,"title":{},"description":{"187":{},"188":{},"191":{},"193":{}}}],["onward",{"_index":93,"title":{},"description":{"0":{}}}],["oper",{"_index":122,"title":{"103":{},"104":{},"105":{},"106":{},"107":{},"108":{}},"description":{"0":{},"103":{},"104":{},"105":{},"106":{},"107":{},"108":{},"118":{},"195":{}}}],["operator-suppli",{"_index":336,"title":{},"description":{"72":{},"73":{}}}],["option",{"_index":546,"title":{},"description":{"145":{},"147":{},"149":{},"158":{},"160":{}}}],["org",{"_index":134,"title":{"2":{},"4":{},"7":{}},"description":{"0":{},"2":{},"3":{},"4":{},"6":{},"7":{},"11":{},"12":{},"13":{},"14":{},"15":{},"17":{},"18":{},"21":{},"24":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"44":{},"47":{},"48":{},"49":{},"50":{},"51":{},"53":{},"54":{},"55":{},"56":{},"57":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"104":{},"105":{},"106":{},"107":{},"108":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"130":{},"131":{},"133":{},"134":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"152":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"163":{},"164":{},"165":{},"166":{},"167":{},"169":{},"170":{},"172":{},"173":{},"174":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"202":{}}}],["org'",{"_index":240,"title":{},"description":{"19":{},"22":{},"24":{},"26":{},"110":{}}}],["org/:orgname/nico/infrastructure-provid",{"_index":172,"title":{},"description":{"3":{},"202":{}}}],["org/:orgname/nico/infrastructure-provider/curr",{"_index":176,"title":{},"description":{"3":{},"202":{}}}],["org/:orgname/nico/ten",{"_index":188,"title":{},"description":{"6":{},"202":{}}}],["org/:orgname/nico/tenant/curr",{"_index":189,"title":{},"description":{"6":{},"202":{}}}],["organ",{"_index":15,"title":{},"description":{"0":{},"3":{},"6":{},"195":{}}}],["orgdisplaynam",{"_index":169,"title":{},"description":{"3":{},"6":{},"202":{}}}],["os",{"_index":471,"title":{},"description":{"121":{}}}],["other",{"_index":503,"title":{},"description":{"132":{}}}],["otherwis",{"_index":120,"title":{},"description":{"0":{}}}],["outlin",{"_index":95,"title":{},"description":{"0":{}}}],["overhead",{"_index":409,"title":{},"description":{"89":{}}}],["overlay",{"_index":85,"title":{},"description":{"0":{},"168":{}}}],["overview",{"_index":5,"title":{},"description":{"0":{}}}],["own",{"_index":159,"title":{},"description":{"3":{},"19":{},"22":{},"42":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"131":{},"134":{},"178":{},"179":{},"180":{},"181":{},"182":{},"186":{},"187":{},"188":{},"192":{},"193":{},"194":{}}}],["owner",{"_index":243,"title":{},"description":{"20":{}}}],["param",{"_index":204,"title":{},"description":{"11":{},"13":{},"17":{},"105":{},"169":{}}}],["paramet",{"_index":233,"title":{},"description":{"16":{},"60":{},"68":{},"74":{},"82":{},"87":{},"117":{},"202":{}}}],["part",{"_index":57,"title":{},"description":{"0":{},"193":{}}}],["particular",{"_index":612,"title":{},"description":{"168":{}}}],["partit",{"_index":392,"title":{"89":{},"90":{},"91":{},"92":{},"93":{},"94":{},"96":{},"97":{},"98":{},"99":{},"100":{},"101":{}},"description":{"89":{},"90":{},"91":{},"92":{},"93":{},"94":{},"96":{},"97":{},"98":{},"99":{},"100":{},"101":{}}}],["past",{"_index":47,"title":{},"description":{"0":{}}}],["patch",{"_index":175,"title":{},"description":{"3":{},"6":{},"173":{},"202":{}}}],["path",{"_index":447,"title":{},"description":{"117":{}}}],["peer",{"_index":284,"title":{"41":{},"42":{},"43":{},"44":{},"45":{}},"description":{"41":{},"42":{},"43":{},"44":{},"45":{}}}],["pend",{"_index":567,"title":{},"description":{"152":{}}}],["per",{"_index":328,"title":{},"description":{"64":{},"65":{}}}],["per-instance-typ",{"_index":517,"title":{"137":{}},"description":{}}],["per-ten",{"_index":193,"title":{"9":{}},"description":{}}],["perspect",{"_index":252,"title":{},"description":{"24":{},"110":{}}}],["pertain",{"_index":199,"title":{},"description":{"10":{}}}],["physic",{"_index":224,"title":{},"description":{"16":{},"72":{},"73":{},"129":{},"140":{}}}],["pleas",{"_index":21,"title":{},"description":{"0":{},"3":{},"6":{},"16":{},"52":{},"109":{},"118":{},"168":{},"194":{},"202":{}}}],["pod",{"_index":626,"title":{},"description":{"175":{}}}],["point",{"_index":92,"title":{},"description":{"0":{}}}],["polici",{"_index":602,"title":{},"description":{"162":{},"166":{},"167":{}}}],["pool",{"_index":426,"title":{},"description":{"109":{}}}],["popul",{"_index":177,"title":{},"description":{"3":{},"6":{},"202":{}}}],["portion",{"_index":427,"title":{},"description":{"109":{},"168":{}}}],["possibl",{"_index":268,"title":{},"description":{"32":{}}}],["post",{"_index":171,"title":{},"description":{"3":{},"6":{},"202":{}}}],["power",{"_index":330,"title":{"66":{},"67":{},"68":{},"69":{},"70":{},"71":{},"145":{},"146":{},"158":{},"159":{}},"description":{"66":{},"67":{},"68":{},"69":{},"70":{},"71":{},"145":{},"146":{},"158":{},"159":{}}}],["pre-regist",{"_index":311,"title":{},"description":{"58":{},"59":{},"66":{},"67":{},"72":{},"73":{},"80":{},"81":{}}}],["prefix",{"_index":110,"title":{"46":{},"47":{},"48":{},"49":{},"50":{},"51":{}},"description":{"0":{},"25":{},"46":{},"47":{},"48":{},"49":{},"50":{},"51":{},"52":{},"118":{},"168":{}}}],["prefixlength",{"_index":300,"title":{},"description":{"52":{},"168":{},"202":{}}}],["present",{"_index":244,"title":{},"description":{"20":{}}}],["previou",{"_index":40,"title":{},"description":{"0":{},"202":{}}}],["privileg",{"_index":64,"title":{},"description":{"0":{},"1":{},"19":{},"22":{},"87":{},"132":{}}}],["proce",{"_index":637,"title":{},"description":{"187":{},"188":{},"193":{}}}],["process",{"_index":502,"title":{},"description":{"132":{}}}],["profil",{"_index":337,"title":{},"description":{"72":{}}}],["provid",{"_index":3,"title":{"3":{},"4":{},"5":{}},"description":{"0":{},"1":{},"3":{},"4":{},"5":{},"9":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"18":{},"19":{},"20":{},"21":{},"22":{},"23":{},"24":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"42":{},"43":{},"44":{},"45":{},"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"66":{},"67":{},"68":{},"69":{},"70":{},"71":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"104":{},"105":{},"106":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"152":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"168":{},"170":{},"172":{},"173":{},"174":{},"201":{},"202":{}}}],["provider_admin",{"_index":180,"title":{},"description":{"4":{},"5":{},"9":{},"11":{},"12":{},"13":{},"15":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"42":{},"43":{},"44":{},"45":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"104":{},"105":{},"106":{},"107":{},"108":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"130":{},"131":{},"133":{},"134":{},"135":{},"136":{},"137":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"169":{},"170":{},"171":{},"172":{},"173":{},"174":{},"198":{},"199":{}}}],["provider_view",{"_index":321,"title":{},"description":{"60":{},"61":{},"68":{},"69":{},"82":{},"83":{},"87":{},"88":{}}}],["provis",{"_index":456,"title":{},"description":{"118":{}}}],["public",{"_index":639,"title":{},"description":{"189":{}}}],["queri",{"_index":203,"title":{},"description":{"11":{},"13":{},"16":{},"17":{},"60":{},"68":{},"74":{},"82":{},"87":{},"105":{},"169":{},"202":{}}}],["quick",{"_index":4,"title":{},"description":{"0":{}}}],["rack",{"_index":335,"title":{"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{}},"description":{"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"140":{},"141":{},"142":{},"143":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"153":{},"156":{}}}],["rack'",{"_index":543,"title":{},"description":{"144":{}}}],["rack-level",{"_index":587,"title":{},"description":{"154":{},"158":{},"160":{}}}],["rackid",{"_index":353,"title":{},"description":{"73":{},"75":{},"154":{},"158":{},"160":{}}}],["rackid/racknam",{"_index":592,"title":{},"description":{"156":{}}}],["rackid`/`racknam",{"_index":584,"title":{},"description":{"154":{},"158":{},"160":{}}}],["rackleveladministr",{"_index":228,"title":{},"description":{"16":{},"202":{}}}],["racknam",{"_index":581,"title":{},"description":{"154":{},"158":{},"160":{}}}],["random",{"_index":483,"title":{},"description":{"121":{}}}],["rdma",{"_index":403,"title":{},"description":{"89":{}}}],["read-onli",{"_index":386,"title":{},"description":{"86":{}}}],["readme](https://github.com/nvidia/infra-controller-rest/tree/main/auth",{"_index":27,"title":{},"description":{"0":{}}}],["receiv",{"_index":151,"title":{},"description":{"0":{}}}],["record",{"_index":646,"title":{},"description":{"197":{}}}],["reduc",{"_index":407,"title":{},"description":{"89":{}}}],["refer",{"_index":338,"title":{},"description":{"72":{},"75":{}}}],["referenc",{"_index":115,"title":{},"description":{"0":{}}}],["reject",{"_index":281,"title":{},"description":{"40":{}}}],["relationship",{"_index":200,"title":{},"description":{"10":{}}}],["remot",{"_index":404,"title":{},"description":{"89":{}}}],["remov",{"_index":163,"title":{},"description":{"3":{},"6":{},"16":{},"52":{},"109":{},"118":{},"168":{},"188":{},"194":{},"202":{}}}],["renam",{"_index":448,"title":{},"description":{"117":{}}}],["replac",{"_index":360,"title":{"75":{}},"description":{"75":{}}}],["report",{"_index":537,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["repres",{"_index":387,"title":{},"description":{"87":{},"88":{},"153":{}}}],["represents/contain",{"_index":198,"title":{},"description":{"10":{}}}],["request",{"_index":209,"title":{},"description":{"12":{},"15":{},"27":{},"29":{},"31":{},"32":{},"33":{},"40":{},"64":{},"65":{},"75":{},"87":{},"105":{},"121":{},"131":{},"132":{},"134":{},"173":{}}}],["requir",{"_index":235,"title":{},"description":{"17":{},"32":{},"60":{},"68":{},"74":{},"82":{},"87":{},"116":{},"154":{},"158":{},"160":{},"169":{}}}],["resourc",{"_index":71,"title":{},"description":{"0":{},"3":{},"6":{},"16":{},"23":{},"32":{}}}],["rest",{"_index":24,"title":{},"description":{"0":{},"202":{}}}],["result",{"_index":251,"title":{},"description":{"24":{},"110":{},"174":{}}}],["retriev",{"_index":32,"title":{"2":{},"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"13":{},"17":{},"19":{},"22":{},"24":{},"26":{},"29":{},"31":{},"35":{},"37":{},"42":{},"44":{},"47":{},"49":{},"53":{},"55":{},"60":{},"61":{},"68":{},"69":{},"74":{},"77":{},"82":{},"83":{},"87":{},"88":{},"90":{},"92":{},"95":{},"97":{},"99":{},"102":{},"104":{},"106":{},"110":{},"112":{},"115":{},"119":{},"122":{},"125":{},"126":{},"127":{},"128":{},"130":{},"131":{},"134":{},"135":{},"136":{},"137":{},"138":{},"141":{},"142":{},"151":{},"154":{},"155":{},"163":{},"165":{},"169":{},"171":{},"174":{},"176":{},"178":{},"181":{},"184":{},"186":{},"190":{},"192":{},"196":{},"198":{},"199":{},"201":{}},"description":{"0":{},"2":{},"3":{},"4":{},"5":{},"6":{},"7":{},"8":{},"11":{},"13":{},"17":{},"19":{},"22":{},"24":{},"26":{},"29":{},"31":{},"35":{},"37":{},"47":{},"49":{},"53":{},"55":{},"60":{},"61":{},"68":{},"69":{},"74":{},"77":{},"82":{},"83":{},"87":{},"88":{},"90":{},"92":{},"97":{},"99":{},"169":{},"171":{},"174":{},"176":{},"178":{},"181":{},"184":{},"186":{},"190":{},"192":{},"196":{},"199":{},"201":{},"202":{}}}],["return",{"_index":149,"title":{},"description":{"0":{},"9":{},"24":{},"110":{},"112":{},"135":{},"136":{},"137":{},"143":{},"144":{},"152":{},"156":{},"157":{}}}],["role",{"_index":17,"title":{},"description":{"0":{},"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"47":{},"48":{},"49":{},"50":{},"51":{},"53":{},"54":{},"55":{},"56":{},"57":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"104":{},"105":{},"106":{},"107":{},"108":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"130":{},"131":{},"133":{},"134":{},"135":{},"136":{},"137":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"152":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"163":{},"164":{},"165":{},"166":{},"167":{},"169":{},"170":{},"171":{},"172":{},"173":{},"174":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"198":{},"199":{}}}],["root",{"_index":615,"title":{},"description":{"170":{},"172":{},"173":{}}}],["run",{"_index":568,"title":{},"description":{"152":{},"175":{}}}],["same",{"_index":58,"title":{},"description":{"0":{},"41":{},"43":{},"64":{},"65":{},"75":{},"105":{},"121":{},"132":{},"152":{}}}],["satisfi",{"_index":257,"title":{},"description":{"25":{}}}],["scope",{"_index":533,"title":{},"description":{"143":{},"156":{}}}],["script",{"_index":127,"title":{},"description":{"0":{},"103":{}}}],["section",{"_index":2,"title":{},"description":{"0":{}}}],["secur",{"_index":601,"title":{"162":{},"163":{},"164":{},"165":{},"166":{},"167":{}},"description":{"162":{},"163":{},"164":{},"165":{},"166":{},"167":{}}}],["sent",{"_index":217,"title":{},"description":{"14":{}}}],["separ",{"_index":501,"title":{},"description":{"132":{}}}],["septemb",{"_index":464,"title":{},"description":{"118":{},"202":{}}}],["serial",{"_index":314,"title":{},"description":{"58":{},"66":{},"80":{},"183":{},"189":{}}}],["serialconsoleurl",{"_index":459,"title":{},"description":{"118":{},"202":{}}}],["server",{"_index":399,"title":{"201":{}},"description":{"89":{},"129":{},"201":{}}}],["servic",{"_index":50,"title":{"1":{},"2":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{}},"description":{"0":{},"1":{},"2":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"200":{}}}],["set",{"_index":212,"title":{},"description":{"12":{},"75":{},"104":{},"106":{},"107":{},"108":{},"166":{}}}],["sever",{"_index":630,"title":{},"description":{"183":{}}}],["share",{"_index":419,"title":{},"description":{"96":{},"121":{}}}],["shelf",{"_index":331,"title":{"66":{},"67":{},"69":{},"70":{},"71":{}},"description":{"66":{},"67":{},"69":{},"70":{},"71":{}}}],["shelv",{"_index":332,"title":{"68":{}},"description":{"66":{},"67":{},"68":{},"69":{},"70":{},"71":{}}}],["show",{"_index":538,"title":{},"description":{"143":{},"144":{},"156":{},"157":{}}}],["similar",{"_index":385,"title":{},"description":{"86":{}}}],["singl",{"_index":106,"title":{},"description":{"0":{},"64":{},"65":{},"121":{}}}],["single-ten",{"_index":292,"title":{},"description":{"43":{}}}],["site",{"_index":77,"title":{"9":{},"16":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"133":{},"135":{},"136":{},"137":{}},"description":{"0":{},"3":{},"6":{},"9":{},"16":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"41":{},"42":{},"43":{},"44":{},"45":{},"46":{},"52":{},"58":{},"59":{},"64":{},"65":{},"66":{},"67":{},"72":{},"73":{},"75":{},"76":{},"80":{},"81":{},"87":{},"88":{},"129":{},"131":{},"134":{},"135":{},"136":{},"137":{},"140":{},"141":{},"143":{},"145":{},"147":{},"149":{},"151":{},"152":{},"154":{},"156":{},"158":{},"160":{},"168":{},"183":{},"187":{},"188":{},"191":{},"193":{},"202":{}}}],["site'",{"_index":241,"title":{},"description":{"19":{},"22":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{}}}],["site-level",{"_index":260,"title":{},"description":{"25":{}}}],["site-scop",{"_index":561,"title":{},"description":{"151":{},"152":{}}}],["siteid",{"_index":322,"title":{},"description":{"60":{},"68":{},"74":{},"75":{},"82":{},"87":{},"151":{},"152":{}}}],["size",{"_index":326,"title":{},"description":{"64":{},"65":{}}}],["sku",{"_index":375,"title":{"86":{},"87":{},"88":{}},"description":{"86":{},"87":{},"88":{}}}],["sku'",{"_index":389,"title":{},"description":{"88":{}}}],["slate",{"_index":656,"title":{},"description":{"202":{}}}],["sourc",{"_index":259,"title":{},"description":{"25":{}}}],["specif",{"_index":238,"title":{},"description":{"19":{},"20":{},"21":{},"22":{},"37":{},"38":{},"49":{},"50":{},"55":{},"56":{},"61":{},"69":{},"77":{},"83":{},"88":{},"92":{},"93":{},"99":{},"100":{},"143":{},"156":{},"174":{},"179":{},"180":{},"181":{},"182":{},"187":{},"188":{},"199":{}}}],["specifi",{"_index":125,"title":{},"description":{"0":{},"9":{},"11":{},"12":{},"13":{},"15":{},"27":{},"29":{},"30":{},"31":{},"32":{},"33":{},"54":{},"132":{},"135":{},"136":{},"137":{},"141":{},"143":{},"145":{},"147":{},"149":{},"154":{},"156":{},"158":{},"160":{},"166":{},"173":{},"191":{}}}],["spread",{"_index":481,"title":{},"description":{"121":{}}}],["ssh",{"_index":472,"title":{"183":{},"184":{},"185":{},"186":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{}},"description":{"121":{},"183":{},"184":{},"185":{},"186":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{}}}],["sshkeygroup",{"_index":463,"title":{},"description":{"118":{},"202":{}}}],["sshurl",{"_index":458,"title":{},"description":{"118":{},"202":{}}}],["standard",{"_index":396,"title":{},"description":{"89":{}}}],["start",{"_index":1,"title":{"0":{}},"description":{"0":{},"32":{}}}],["stat",{"_index":183,"title":{"5":{},"8":{},"9":{},"135":{},"137":{}},"description":{"5":{},"8":{},"9":{},"135":{},"137":{}}}],["state",{"_index":530,"title":{},"description":{"143":{},"144":{},"145":{},"146":{},"152":{},"156":{},"157":{},"158":{},"159":{}}}],["statu",{"_index":153,"title":{"2":{},"22":{},"125":{},"134":{}},"description":{"2":{},"12":{},"14":{},"22":{},"125":{},"136":{}}}],["step",{"_index":10,"title":{},"description":{"0":{}}}],["stock",{"_index":376,"title":{},"description":{"86":{},"87":{},"88":{}}}],["storag",{"_index":400,"title":{},"description":{"89":{},"129":{}}}],["string",{"_index":354,"title":{},"description":{"73":{}}}],["structur",{"_index":16,"title":{},"description":{"0":{}}}],["subnet",{"_index":114,"title":{"52":{},"53":{},"54":{},"55":{},"56":{},"57":{}},"description":{"0":{},"40":{},"52":{},"53":{},"54":{},"55":{},"56":{},"57":{},"118":{},"202":{}}}],["succe",{"_index":445,"title":{},"description":{"116":{}}}],["succeed",{"_index":578,"title":{},"description":{"152":{}}}],["successfulli",{"_index":254,"title":{},"description":{"25":{}}}],["suffix",{"_index":181,"title":{},"description":{"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"25":{},"26":{},"28":{},"30":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"47":{},"48":{},"49":{},"50":{},"51":{},"53":{},"54":{},"55":{},"56":{},"57":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"104":{},"105":{},"106":{},"107":{},"108":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"130":{},"133":{},"135":{},"136":{},"137":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"163":{},"164":{},"165":{},"166":{},"167":{},"169":{},"170":{},"171":{},"172":{},"174":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"198":{},"199":{}}}],["summari",{"_index":509,"title":{"136":{}},"description":{"135":{}}}],["super",{"_index":618,"title":{},"description":{"174":{}}}],["superset",{"_index":443,"title":{},"description":{"116":{}}}],["support",{"_index":116,"title":{},"description":{"0":{},"27":{},"28":{},"46":{},"52":{},"145":{},"146":{},"158":{},"159":{},"175":{}}}],["switch",{"_index":371,"title":{"80":{},"81":{},"82":{},"83":{},"84":{},"85":{}},"description":{"80":{},"81":{},"82":{},"83":{},"84":{},"85":{}}}],["sync",{"_index":632,"title":{},"description":{"183":{}}}],["system",{"_index":123,"title":{"103":{},"104":{},"105":{},"106":{},"107":{},"108":{}},"description":{"0":{},"86":{},"89":{},"103":{},"104":{},"105":{},"106":{},"107":{},"108":{},"118":{},"200":{},"201":{}}}],["taken",{"_index":648,"title":{},"description":{"197":{}}}],["target",{"_index":547,"title":{},"description":{"145":{},"147":{},"149":{},"154":{},"158":{},"160":{}}}],["targetedinstancecr",{"_index":65,"title":{},"description":{"0":{},"1":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{}}}],["task",{"_index":560,"title":{"151":{},"152":{}},"description":{"151":{},"152":{}}}],["tempor",{"_index":573,"title":{},"description":{"152":{}}}],["tenant",{"_index":56,"title":{"6":{},"7":{},"8":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{}},"description":{"0":{},"1":{},"6":{},"7":{},"8":{},"9":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"18":{},"19":{},"20":{},"22":{},"23":{},"24":{},"26":{},"27":{},"28":{},"29":{},"31":{},"32":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"48":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"55":{},"56":{},"57":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"104":{},"105":{},"106":{},"107":{},"108":{},"109":{},"110":{},"112":{},"118":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"131":{},"132":{},"134":{},"137":{},"163":{},"164":{},"165":{},"166":{},"167":{},"168":{},"170":{},"172":{},"173":{},"174":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"202":{}}}],["tenant'",{"_index":210,"title":{},"description":{"12":{},"34":{},"131":{},"134":{}}}],["tenant_admin",{"_index":190,"title":{},"description":{"7":{},"8":{},"11":{},"13":{},"14":{},"17":{},"19":{},"22":{},"24":{},"26":{},"29":{},"31":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"47":{},"48":{},"49":{},"50":{},"51":{},"53":{},"54":{},"55":{},"56":{},"57":{},"87":{},"88":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"104":{},"105":{},"106":{},"107":{},"108":{},"110":{},"112":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"131":{},"134":{},"163":{},"164":{},"165":{},"166":{},"167":{},"169":{},"171":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"198":{},"199":{}}}],["tenantaccount",{"_index":220,"title":{},"description":{"14":{}}}],["tenantid",{"_index":202,"title":{},"description":{"11":{},"13":{},"14":{},"17":{},"104":{},"105":{},"106":{},"107":{},"108":{},"169":{}}}],["termin",{"_index":571,"title":{},"description":{"152":{}}}],["time",{"_index":155,"title":{},"description":{"2":{},"105":{},"117":{},"132":{}}}],["togeth",{"_index":631,"title":{},"description":{"183":{}}}],["token",{"_index":14,"title":{},"description":{"0":{}}}],["toml",{"_index":88,"title":{},"description":{"0":{}}}],["top-level",{"_index":365,"title":{},"description":{"75":{}}}],["topologyoptim",{"_index":474,"title":{},"description":{"121":{}}}],["traffic",{"_index":603,"title":{},"description":{"162":{}}}],["transact",{"_index":470,"title":{},"description":{"121":{}}}],["tray",{"_index":580,"title":{"153":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{}},"description":{"153":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{}}}],["true",{"_index":475,"title":{},"description":{"121":{}}}],["two",{"_index":291,"title":{},"description":{"43":{}}}],["type",{"_index":137,"title":{"9":{},"109":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"136":{}},"description":{"0":{},"9":{},"25":{},"40":{},"109":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"132":{},"136":{},"137":{},"139":{},"154":{},"158":{},"160":{},"175":{},"202":{}}}],["type'",{"_index":444,"title":{},"description":{"116":{}}}],["type/machin",{"_index":144,"title":{},"description":{"0":{}}}],["typic",{"_index":96,"title":{},"description":{"0":{},"103":{}}}],["unalloc",{"_index":256,"title":{},"description":{"25":{}}}],["unassign",{"_index":513,"title":{},"description":{"136":{}}}],["underli",{"_index":572,"title":{},"description":{"152":{}}}],["uniqu",{"_index":355,"title":{},"description":{"73":{},"75":{},"87":{},"88":{}}}],["unit",{"_index":378,"title":{},"description":{"86":{},"87":{},"88":{}}}],["until",{"_index":451,"title":{},"description":{"117":{}}}],["up",{"_index":557,"title":{"149":{},"150":{}},"description":{"149":{},"150":{}}}],["updat",{"_index":139,"title":{"14":{},"20":{},"28":{},"32":{},"39":{},"40":{},"51":{},"57":{},"62":{},"65":{},"70":{},"78":{},"84":{},"94":{},"100":{},"108":{},"114":{},"124":{},"132":{},"147":{},"148":{},"160":{},"161":{},"166":{},"173":{},"180":{},"188":{},"194":{}},"description":{"0":{},"3":{},"6":{},"12":{},"14":{},"20":{},"28":{},"32":{},"39":{},"40":{},"51":{},"57":{},"62":{},"65":{},"70":{},"75":{},"78":{},"84":{},"94":{},"100":{},"108":{},"109":{},"114":{},"124":{},"132":{},"147":{},"148":{},"160":{},"161":{},"166":{},"173":{},"180":{},"188":{},"194":{},"202":{}}}],["url",{"_index":620,"title":{},"description":{"174":{}}}],["us",{"_index":11,"title":{},"description":{"0":{},"3":{},"6":{},"14":{},"16":{},"32":{},"46":{},"52":{},"58":{},"66":{},"80":{},"86":{},"89":{},"96":{},"103":{},"109":{},"118":{},"121":{},"139":{},"156":{},"168":{},"183":{},"189":{},"194":{},"202":{}}}],["usag",{"_index":436,"title":{},"description":{"109":{},"202":{}}}],["user",{"_index":53,"title":{"195":{},"196":{}},"description":{"0":{},"1":{},"3":{},"4":{},"5":{},"6":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"47":{},"48":{},"49":{},"50":{},"51":{},"53":{},"54":{},"55":{},"56":{},"57":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"104":{},"105":{},"106":{},"107":{},"108":{},"110":{},"111":{},"112":{},"113":{},"114":{},"115":{},"116":{},"117":{},"119":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"130":{},"131":{},"133":{},"134":{},"135":{},"136":{},"137":{},"138":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"149":{},"150":{},"151":{},"152":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"163":{},"164":{},"165":{},"166":{},"167":{},"169":{},"170":{},"171":{},"172":{},"173":{},"174":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"184":{},"185":{},"186":{},"187":{},"188":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"196":{},"197":{},"198":{},"199":{},"202":{}}}],["utc",{"_index":168,"title":{},"description":{"3":{},"6":{},"16":{},"52":{},"109":{},"117":{},"118":{},"168":{},"202":{}}}],["util",{"_index":81,"title":{},"description":{"0":{},"32":{},"89":{}}}],["uuid",{"_index":211,"title":{},"description":{"12":{},"73":{},"146":{},"148":{},"150":{},"151":{},"159":{},"161":{}}}],["v2/org/{org}/nico/alloc",{"_index":253,"title":{},"description":{"24":{},"25":{}}}],["v2/org/{org}/nico/allocation/{allocationid",{"_index":262,"title":{},"description":{"26":{},"27":{},"28":{}}}],["v2/org/{org}/nico/allocation/{allocationid}/constraint",{"_index":266,"title":{},"description":{"29":{},"30":{}}}],["v2/org/{org}/nico/allocation/{allocationid}/constraint/{allocationconstraintid",{"_index":267,"title":{},"description":{"31":{},"32":{},"33":{}}}],["v2/org/{org}/nico/audit",{"_index":650,"title":{},"description":{"198":{}}}],["v2/org/{org}/nico/audit/{auditentryid",{"_index":651,"title":{},"description":{"199":{}}}],["v2/org/{org}/nico/dpu-extension-servic",{"_index":627,"title":{},"description":{"176":{},"177":{}}}],["v2/org/{org}/nico/dpu-extension-service/{dpuextensionserviceid",{"_index":628,"title":{},"description":{"178":{},"179":{},"180":{}}}],["v2/org/{org}/nico/dpu-extension-service/{dpuextensionserviceid}/version/{vers",{"_index":629,"title":{},"description":{"181":{},"182":{}}}],["v2/org/{org}/nico/expected-machin",{"_index":320,"title":{},"description":{"59":{},"60":{}}}],["v2/org/{org}/nico/expected-machine/batch",{"_index":329,"title":{},"description":{"64":{},"65":{}}}],["v2/org/{org}/nico/expected-machine/{expectedmachineid",{"_index":323,"title":{},"description":{"61":{},"62":{},"63":{}}}],["v2/org/{org}/nico/expected-power-shelf",{"_index":333,"title":{},"description":{"67":{},"68":{}}}],["v2/org/{org}/nico/expected-power-shelf/{expectedpowershelfid",{"_index":334,"title":{},"description":{"69":{},"70":{},"71":{}}}],["v2/org/{org}/nico/expected-rack",{"_index":358,"title":{},"description":{"73":{},"74":{},"75":{}}}],["v2/org/{org}/nico/expected-rack/al",{"_index":369,"title":{},"description":{"76":{}}}],["v2/org/{org}/nico/expected-rack/{id",{"_index":370,"title":{},"description":{"77":{},"78":{},"79":{}}}],["v2/org/{org}/nico/expected-switch",{"_index":373,"title":{},"description":{"81":{},"82":{}}}],["v2/org/{org}/nico/expected-switch/{expectedswitchid",{"_index":374,"title":{},"description":{"83":{},"84":{},"85":{}}}],["v2/org/{org}/nico/infiniband-interfac",{"_index":416,"title":{},"description":{"95":{}}}],["v2/org/{org}/nico/infiniband-partit",{"_index":413,"title":{},"description":{"90":{},"91":{}}}],["v2/org/{org}/nico/infiniband-partition/{infinibandpartitionid",{"_index":414,"title":{},"description":{"92":{},"93":{},"94":{}}}],["v2/org/{org}/nico/infrastructure-provider/curr",{"_index":182,"title":{},"description":{"4":{}}}],["v2/org/{org}/nico/infrastructure-provider/current/stat",{"_index":184,"title":{},"description":{"5":{}}}],["v2/org/{org}/nico/inst",{"_index":467,"title":{},"description":{"119":{},"120":{}}}],["v2/org/{org}/nico/instance/batch",{"_index":490,"title":{},"description":{"121":{}}}],["v2/org/{org}/nico/instance/typ",{"_index":438,"title":{},"description":{"110":{},"111":{}}}],["v2/org/{org}/nico/instance/type/{instancetypeid",{"_index":439,"title":{},"description":{"112":{},"113":{},"114":{}}}],["v2/org/{org}/nico/instance/type/{instancetypeid}/machin",{"_index":441,"title":{},"description":{"115":{},"116":{}}}],["v2/org/{org}/nico/instance/type/{instancetypeid}/machine/{machineassociationid",{"_index":455,"title":{},"description":{"117":{}}}],["v2/org/{org}/nico/instance/{instanceid",{"_index":491,"title":{},"description":{"122":{},"123":{},"124":{}}}],["v2/org/{org}/nico/instance/{instanceid}/infiniband-interfac",{"_index":494,"title":{},"description":{"127":{}}}],["v2/org/{org}/nico/instance/{instanceid}/interfac",{"_index":493,"title":{},"description":{"126":{}}}],["v2/org/{org}/nico/instance/{instanceid}/nvlink-interfac",{"_index":495,"title":{},"description":{"128":{}}}],["v2/org/{org}/nico/instance/{instanceid}/status-histori",{"_index":492,"title":{},"description":{"125":{}}}],["v2/org/{org}/nico/ipblock",{"_index":614,"title":{},"description":{"169":{},"170":{}}}],["v2/org/{org}/nico/ipblock/{ipblockid",{"_index":616,"title":{},"description":{"171":{},"172":{},"173":{}}}],["v2/org/{org}/nico/ipblock/{ipblockid}/deriv",{"_index":621,"title":{},"description":{"174":{}}}],["v2/org/{org}/nico/machin",{"_index":497,"title":{},"description":{"130":{}}}],["v2/org/{org}/nico/machine-cap",{"_index":522,"title":{},"description":{"138":{}}}],["v2/org/{org}/nico/machine/gpu/stat",{"_index":510,"title":{},"description":{"135":{}}}],["v2/org/{org}/nico/machine/instance-type/stat",{"_index":520,"title":{},"description":{"137":{}}}],["v2/org/{org}/nico/machine/instance-type/stats/summari",{"_index":516,"title":{},"description":{"136":{}}}],["v2/org/{org}/nico/machine/{machineid",{"_index":499,"title":{},"description":{"131":{},"132":{},"133":{}}}],["v2/org/{org}/nico/machine/{machineid}/status-histori",{"_index":508,"title":{},"description":{"134":{}}}],["v2/org/{org}/nico/metadata",{"_index":652,"title":{},"description":{"201":{}}}],["v2/org/{org}/nico/network-security-group",{"_index":604,"title":{},"description":{"163":{},"164":{}}}],["v2/org/{org}/nico/network-security-group/{networksecuritygroupid",{"_index":605,"title":{},"description":{"165":{},"166":{},"167":{}}}],["v2/org/{org}/nico/nvlink-interfac",{"_index":422,"title":{},"description":{"102":{}}}],["v2/org/{org}/nico/nvlink-logical-partit",{"_index":420,"title":{},"description":{"97":{},"98":{}}}],["v2/org/{org}/nico/nvlink-logical-partition/{nvlinklogicalpartitionid",{"_index":421,"title":{},"description":{"99":{},"100":{},"101":{}}}],["v2/org/{org}/nico/operating-system",{"_index":424,"title":{},"description":{"104":{},"105":{}}}],["v2/org/{org}/nico/operating-system/{operatingsystemid",{"_index":425,"title":{},"description":{"106":{},"107":{},"108":{}}}],["v2/org/{org}/nico/rack",{"_index":524,"title":{},"description":{"141":{}}}],["v2/org/{org}/nico/rack/bringup",{"_index":558,"title":{},"description":{"149":{}}}],["v2/org/{org}/nico/rack/firmwar",{"_index":554,"title":{},"description":{"147":{}}}],["v2/org/{org}/nico/rack/pow",{"_index":551,"title":{},"description":{"145":{}}}],["v2/org/{org}/nico/rack/task/{id",{"_index":562,"title":{},"description":{"151":{}}}],["v2/org/{org}/nico/rack/task/{id}/cancel",{"_index":579,"title":{},"description":{"152":{}}}],["v2/org/{org}/nico/rack/valid",{"_index":542,"title":{},"description":{"143":{}}}],["v2/org/{org}/nico/rack/{id",{"_index":525,"title":{},"description":{"142":{}}}],["v2/org/{org}/nico/rack/{id}/bringup",{"_index":559,"title":{},"description":{"150":{}}}],["v2/org/{org}/nico/rack/{id}/firmwar",{"_index":555,"title":{},"description":{"148":{}}}],["v2/org/{org}/nico/rack/{id}/pow",{"_index":552,"title":{},"description":{"146":{}}}],["v2/org/{org}/nico/rack/{id}/valid",{"_index":544,"title":{},"description":{"144":{}}}],["v2/org/{org}/nico/service-account/curr",{"_index":158,"title":{},"description":{"2":{}}}],["v2/org/{org}/nico/sit",{"_index":237,"title":{},"description":{"17":{},"18":{}}}],["v2/org/{org}/nico/site/{siteid",{"_index":242,"title":{},"description":{"19":{},"20":{},"21":{}}}],["v2/org/{org}/nico/site/{siteid}/status-histori",{"_index":246,"title":{},"description":{"22":{}}}],["v2/org/{org}/nico/sku",{"_index":388,"title":{},"description":{"87":{}}}],["v2/org/{org}/nico/sku/{skuid",{"_index":390,"title":{},"description":{"88":{}}}],["v2/org/{org}/nico/sshkey",{"_index":640,"title":{},"description":{"190":{},"191":{}}}],["v2/org/{org}/nico/sshkey/{sshkeyid",{"_index":641,"title":{},"description":{"192":{},"193":{},"194":{}}}],["v2/org/{org}/nico/sshkeygroup",{"_index":634,"title":{},"description":{"184":{},"185":{}}}],["v2/org/{org}/nico/sshkeygroup/{sshkeygroupid",{"_index":635,"title":{},"description":{"186":{},"187":{},"188":{}}}],["v2/org/{org}/nico/subnet",{"_index":303,"title":{},"description":{"53":{},"54":{}}}],["v2/org/{org}/nico/subnet/{subnetid",{"_index":307,"title":{},"description":{"55":{},"56":{},"57":{}}}],["v2/org/{org}/nico/tenant/account",{"_index":208,"title":{},"description":{"11":{},"12":{}}}],["v2/org/{org}/nico/tenant/account/{accountid",{"_index":216,"title":{},"description":{"13":{},"14":{},"15":{}}}],["v2/org/{org}/nico/tenant/curr",{"_index":191,"title":{},"description":{"7":{}}}],["v2/org/{org}/nico/tenant/current/stat",{"_index":192,"title":{},"description":{"8":{}}}],["v2/org/{org}/nico/tenant/instance-type/stat",{"_index":196,"title":{},"description":{"9":{}}}],["v2/org/{org}/nico/tray",{"_index":590,"title":{},"description":{"154":{}}}],["v2/org/{org}/nico/tray/firmwar",{"_index":599,"title":{},"description":{"160":{}}}],["v2/org/{org}/nico/tray/pow",{"_index":597,"title":{},"description":{"158":{}}}],["v2/org/{org}/nico/tray/valid",{"_index":594,"title":{},"description":{"156":{}}}],["v2/org/{org}/nico/tray/{id",{"_index":591,"title":{},"description":{"155":{}}}],["v2/org/{org}/nico/tray/{id}/firmwar",{"_index":600,"title":{},"description":{"161":{}}}],["v2/org/{org}/nico/tray/{id}/pow",{"_index":598,"title":{},"description":{"159":{}}}],["v2/org/{org}/nico/tray/{id}/valid",{"_index":595,"title":{},"description":{"157":{}}}],["v2/org/{org}/nico/user/curr",{"_index":644,"title":{},"description":{"196":{}}}],["v2/org/{org}/nico/vpc",{"_index":278,"title":{},"description":{"35":{},"36":{}}}],["v2/org/{org}/nico/vpc-p",{"_index":289,"title":{},"description":{"42":{},"43":{}}}],["v2/org/{org}/nico/vpc-peering/{id",{"_index":295,"title":{},"description":{"44":{},"45":{}}}],["v2/org/{org}/nico/vpc-prefix",{"_index":297,"title":{},"description":{"47":{},"48":{}}}],["v2/org/{org}/nico/vpc-prefix/{vpcprefixid",{"_index":298,"title":{},"description":{"49":{},"50":{},"51":{}}}],["v2/org/{org}/nico/vpc/{vpcid",{"_index":279,"title":{},"description":{"37":{},"38":{},"39":{}}}],["v2/org/{org}/nico/vpc/{vpcid}/virtu",{"_index":283,"title":{},"description":{"40":{}}}],["valid",{"_index":526,"title":{"143":{},"144":{},"156":{},"157":{}},"description":{"143":{},"144":{},"156":{},"157":{}}}],["valu",{"_index":207,"title":{},"description":{"11":{},"13":{},"25":{},"75":{},"105":{}}}],["variou",{"_index":98,"title":{},"description":{"0":{},"194":{},"200":{}}}],["version",{"_index":28,"title":{"181":{},"182":{}},"description":{"0":{},"17":{},"169":{},"179":{},"180":{},"181":{},"182":{},"202":{}}}],["via",{"_index":157,"title":{},"description":{"2":{},"72":{},"73":{},"170":{},"172":{},"173":{}}}],["view",{"_index":214,"title":{},"description":{"12":{}}}],["virtual",{"_index":280,"title":{"40":{}},"description":{"40":{}}}],["vpc",{"_index":112,"title":{"34":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"41":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"48":{},"49":{},"50":{},"51":{}},"description":{"0":{},"34":{},"35":{},"36":{},"37":{},"38":{},"39":{},"40":{},"41":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"48":{},"49":{},"50":{},"51":{},"118":{}}}],["vs",{"_index":512,"title":{},"description":{"136":{},"143":{},"144":{},"154":{},"156":{},"157":{},"158":{},"160":{}}}],["wait",{"_index":569,"title":{},"description":{"152":{}}}],["well-known",{"_index":343,"title":{},"description":{"72":{},"73":{}}}],["whose",{"_index":218,"title":{},"description":{"14":{}}}],["within",{"_index":356,"title":{},"description":{"73":{},"75":{},"121":{},"153":{}}}],["without",{"_index":576,"title":{},"description":{"152":{}}}],["worker",{"_index":486,"title":{},"description":{"121":{}}}],["worker-abc123",{"_index":488,"title":{},"description":{"121":{}}}],["worker-def456",{"_index":489,"title":{},"description":{"121":{}}}],["workflow",{"_index":574,"title":{},"description":{"152":{}}}]],"pipeline":[]}},"options":{"expandResponses":"200,201","schemasExpansionLevel":2}};
 
       var container = document.getElementById('redoc');
       Redoc.hydrate(__redoc_state, container);
diff --git a/flow/internal/converter/protobuf/converter.go b/flow/internal/converter/protobuf/converter.go
index 9b79322b1..d34f67d30 100644
--- a/flow/internal/converter/protobuf/converter.go
+++ b/flow/internal/converter/protobuf/converter.go
@@ -1239,6 +1239,7 @@ func ScheduledOperationFrom(
 		info := &operations.FirmwareControlTaskInfo{
 			Operation:     operations.FirmwareOperationUpgrade,
 			TargetVersion: r.UpgradeFirmware.GetTargetVersion(),
+			SubTargets:    r.UpgradeFirmware.GetSubTargets(),
 		}
 
 		if r.UpgradeFirmware.GetStartTime() != nil {
diff --git a/flow/internal/service/server_impl.go b/flow/internal/service/server_impl.go
index bfd815279..bbe15e072 100644
--- a/flow/internal/service/server_impl.go
+++ b/flow/internal/service/server_impl.go
@@ -1242,6 +1242,7 @@ func (rs *FlowServerImpl) UpgradeFirmware(
 		Operation:     operations.FirmwareOperationUpgrade,
 		TargetVersion: req.GetTargetVersion(),
 		RuleID:        protobuf.UUIDStringFrom(req.GetRuleId()),
+		SubTargets:    req.GetSubTargets(),
 	}
 
 	// Parse optional time parameters for scheduled upgrade
diff --git a/flow/internal/task/componentmanager/compute/nico/nico.go b/flow/internal/task/componentmanager/compute/nico/nico.go
index bfdf82c04..e023c4d55 100644
--- a/flow/internal/task/componentmanager/compute/nico/nico.go
+++ b/flow/internal/task/componentmanager/compute/nico/nico.go
@@ -324,6 +324,7 @@ func (m *Manager) FirmwareControl(ctx context.Context, target common.Target, inf
 	log.Debug().
 		Str("components", target.String()).
 		Str("target_version", info.TargetVersion).
+		Strs("sub_targets", info.SubTargets).
 		Msg("Scheduling firmware update for compute via NICo")
 
 	if m.nicoClient == nil {
@@ -334,6 +335,19 @@ func (m *Manager) FirmwareControl(ctx context.Context, target common.Target, inf
 		return fmt.Errorf("target is invalid: %w", err)
 	}
 
+	if len(info.SubTargets) > 0 {
+		// SetFirmwareUpdateTimeWindow + SetMachineAutoUpdate (the path used
+		// here for compute trays) do not expose per-sub-target selection;
+		// auto-update will install whatever is in the desired bundle. Log
+		// the requested subset so the limitation is visible until we can
+		// route this through UpdateComponentFirmware (planned alongside the
+		// version → FW Object identifier migration).
+		log.Warn().
+			Str("components", target.String()).
+			Strs("sub_targets", info.SubTargets).
+			Msg("compute firmware sub-target selection is not yet honored; whole bundle will be applied")
+	}
+
 	desiredEntries, err := m.nicoClient.GetDesiredFirmwareVersions(ctx)
 	if err != nil {
 		return fmt.Errorf("failed to query desired firmware versions: %w", err)
diff --git a/flow/internal/task/componentmanager/compute/nico/nico_test.go b/flow/internal/task/componentmanager/compute/nico/nico_test.go
index 795ecc97e..3326a1014 100644
--- a/flow/internal/task/componentmanager/compute/nico/nico_test.go
+++ b/flow/internal/task/componentmanager/compute/nico/nico_test.go
@@ -102,6 +102,39 @@ func mustMarshal(t *testing.T, v any) json.RawMessage {
 	return data
 }
 
+// TestFirmwareControl_SubTargetsAccepted verifies that the compute/nico
+// FirmwareControl path tolerates info.SubTargets without erroring. This
+// path goes through SetMachineAutoUpdate + SetFirmwareUpdateTimeWindow,
+// which has no per-sub-target selection in NICo, so the manager only logs
+// a warning and proceeds; we exercise that branch here. The actual
+// per-sub-target dispatch will be added when compute moves to NICo's
+// UpdateComponentFirmware (see comment in nico.go).
+func TestFirmwareControl_SubTargetsAccepted(t *testing.T) {
+	tests := map[string]struct {
+		subTargets []string
+	}{
+		"nil sub_targets (legacy path)":     {subTargets: nil},
+		"empty sub_targets (legacy path)":   {subTargets: []string{}},
+		"non-empty sub_targets (warn path)": {subTargets: []string{"bmc", "bios"}},
+	}
+
+	for name, tc := range tests {
+		t.Run(name, func(t *testing.T) {
+			m := New(nicoapi.NewMockClient(), 0)
+			target := common.Target{
+				Type:         devicetypes.ComponentTypeCompute,
+				ComponentIDs: []string{"machine-1"},
+			}
+
+			err := m.FirmwareControl(context.Background(), target, operations.FirmwareControlTaskInfo{
+				Operation:  operations.FirmwareOperationUpgrade,
+				SubTargets: tc.subTargets,
+			})
+			require.NoError(t, err)
+		})
+	}
+}
+
 // --- Tests for firmware version helper functions ---
 
 func desiredEntry(versions map[string]string) *pb.DesiredFirmwareVersionEntry {
diff --git a/flow/internal/task/componentmanager/nvswitch/nico/nico.go b/flow/internal/task/componentmanager/nvswitch/nico/nico.go
index 500247727..4ab52f6bc 100644
--- a/flow/internal/task/componentmanager/nvswitch/nico/nico.go
+++ b/flow/internal/task/componentmanager/nvswitch/nico/nico.go
@@ -34,6 +34,7 @@ import (
 	"github.com/NVIDIA/infra-controller-rest/flow/internal/task/executor/temporalworkflow/common"
 	"github.com/NVIDIA/infra-controller-rest/flow/internal/task/operations"
 	"github.com/NVIDIA/infra-controller-rest/flow/pkg/common/devicetypes"
+	"github.com/NVIDIA/infra-controller-rest/flow/pkg/common/firmwarecomponents"
 )
 
 const (
@@ -250,12 +251,18 @@ func (m *Manager) FirmwareControl(ctx context.Context, target common.Target, inf
 	log.Debug().
 		Str("components", target.String()).
 		Str("target_version", info.TargetVersion).
+		Strs("sub_targets", info.SubTargets).
 		Msg("Starting firmware update for NVSwitch via NICo")
 
 	if err := target.Validate(); err != nil {
 		return fmt.Errorf("target is invalid: %w", err)
 	}
 
+	subComponents, err := firmwarecomponents.ParseNICoNVSwitch(info.SubTargets)
+	if err != nil {
+		return err
+	}
+
 	if info.TargetVersion == "" {
 		upToDate, err := m.checkFirmwareUpToDate(ctx, target)
 		if err != nil {
@@ -271,7 +278,8 @@ func (m *Manager) FirmwareControl(ctx context.Context, target common.Target, inf
 	req := &pb.UpdateComponentFirmwareRequest{
 		Target: &pb.UpdateComponentFirmwareRequest_Switches{
 			Switches: &pb.UpdateSwitchFirmwareTarget{
-				SwitchIds: switchIDsProto(target.ComponentIDs),
+				SwitchIds:  switchIDsProto(target.ComponentIDs),
+				Components: subComponents,
 			},
 		},
 		TargetVersion: info.TargetVersion,
diff --git a/flow/internal/task/componentmanager/nvswitch/nvswitchmanager/nvswitchmanager.go b/flow/internal/task/componentmanager/nvswitch/nvswitchmanager/nvswitchmanager.go
index 702815d9c..0b8d7f5d7 100644
--- a/flow/internal/task/componentmanager/nvswitch/nvswitchmanager/nvswitchmanager.go
+++ b/flow/internal/task/componentmanager/nvswitch/nvswitchmanager/nvswitchmanager.go
@@ -31,6 +31,7 @@ import (
 	"github.com/NVIDIA/infra-controller-rest/flow/internal/task/executor/temporalworkflow/common"
 	"github.com/NVIDIA/infra-controller-rest/flow/internal/task/operations"
 	"github.com/NVIDIA/infra-controller-rest/flow/pkg/common/devicetypes"
+	"github.com/NVIDIA/infra-controller-rest/flow/pkg/common/firmwarecomponents"
 )
 
 const (
@@ -171,11 +172,16 @@ func mapPowerOperation(op operations.PowerOperation) (nsmapi.PowerAction, error)
 
 // FirmwareControl initiates firmware update without waiting for completion.
 // Returns immediately after the update request is accepted.
+//
+// info.SubTargets, when non-empty, restricts the update to the selected
+// firmware sub-parts (e.g. ["bmc", "nvos"]). Empty means "all components
+// in the bundle" (NSM's historical default).
 func (m *Manager) FirmwareControl(ctx context.Context, target common.Target, info operations.FirmwareControlTaskInfo) error {
 	log.Debug().
 		Str("components", target.String()).
 		Str("operation", fmt.Sprintf("%v", info.Operation)).
 		Str("target_version", info.TargetVersion).
+		Strs("sub_targets", info.SubTargets).
 		Msg("Starting firmware update")
 
 	if m.nsmClient == nil {
@@ -186,7 +192,12 @@ func (m *Manager) FirmwareControl(ctx context.Context, target common.Target, inf
 		return fmt.Errorf("target is invalid: %w", err)
 	}
 
-	updates, err := m.nsmClient.QueueUpdates(ctx, target.ComponentIDs, info.TargetVersion, nil)
+	subComponents, err := firmwarecomponents.ParseNSMNVSwitch(info.SubTargets)
+	if err != nil {
+		return err
+	}
+
+	updates, err := m.nsmClient.QueueUpdates(ctx, target.ComponentIDs, info.TargetVersion, subComponents)
 	if err != nil {
 		return fmt.Errorf("firmware update request failed: %w", err)
 	}
diff --git a/flow/internal/task/componentmanager/powershelf/nico/nico.go b/flow/internal/task/componentmanager/powershelf/nico/nico.go
index 5dc36faf8..81783349e 100644
--- a/flow/internal/task/componentmanager/powershelf/nico/nico.go
+++ b/flow/internal/task/componentmanager/powershelf/nico/nico.go
@@ -33,6 +33,7 @@ import (
 	"github.com/NVIDIA/infra-controller-rest/flow/internal/task/executor/temporalworkflow/common"
 	"github.com/NVIDIA/infra-controller-rest/flow/internal/task/operations"
 	"github.com/NVIDIA/infra-controller-rest/flow/pkg/common/devicetypes"
+	"github.com/NVIDIA/infra-controller-rest/flow/pkg/common/firmwarecomponents"
 )
 
 const (
@@ -218,19 +219,29 @@ func (m *Manager) FirmwareControl(
 	log.Debug().
 		Str("components", target.String()).
 		Str("target_version", info.TargetVersion).
+		Strs("sub_targets", info.SubTargets).
 		Msg("Starting firmware update for PowerShelf via NICo")
 
 	if err := target.Validate(); err != nil {
 		return fmt.Errorf("target is invalid: %w", err)
 	}
 
+	subComponents, err := firmwarecomponents.ParseNICoPowerShelf(info.SubTargets)
+	if err != nil {
+		return err
+	}
+	if len(subComponents) == 0 {
+		// Preserve historical behavior: when the caller does not specify a
+		// subset, only PMC is updated. Once the component manager supports
+		// "update everything in the bundle" semantics we can drop this.
+		subComponents = []pb.PowerShelfComponent{pb.PowerShelfComponent_POWER_SHELF_COMPONENT_PMC}
+	}
+
 	req := &pb.UpdateComponentFirmwareRequest{
 		Target: &pb.UpdateComponentFirmwareRequest_PowerShelves{
 			PowerShelves: &pb.UpdatePowerShelfFirmwareTarget{
 				PowerShelfIds: powerShelfIDsProto(target.ComponentIDs),
-				Components: []pb.PowerShelfComponent{
-					pb.PowerShelfComponent_POWER_SHELF_COMPONENT_PMC,
-				},
+				Components:    subComponents,
 			},
 		},
 		TargetVersion: info.TargetVersion,
diff --git a/flow/internal/task/componentmanager/powershelf/psm/psm.go b/flow/internal/task/componentmanager/powershelf/psm/psm.go
index a52929ba4..10780470b 100644
--- a/flow/internal/task/componentmanager/powershelf/psm/psm.go
+++ b/flow/internal/task/componentmanager/powershelf/psm/psm.go
@@ -32,6 +32,7 @@ import (
 	"github.com/NVIDIA/infra-controller-rest/flow/internal/task/executor/temporalworkflow/common"
 	"github.com/NVIDIA/infra-controller-rest/flow/internal/task/operations"
 	"github.com/NVIDIA/infra-controller-rest/flow/pkg/common/devicetypes"
+	"github.com/NVIDIA/infra-controller-rest/flow/pkg/common/firmwarecomponents"
 )
 
 const (
@@ -294,11 +295,16 @@ func (m *Manager) ListAvailableFirmware(ctx context.Context, pmcMacs []string) (
 
 // FirmwareControl initiates firmware update without waiting for completion.
 // Returns immediately after the update request is accepted.
+//
+// info.SubTargets, when non-empty, restricts the update to the selected
+// firmware sub-parts (e.g. ["pmc", "psu"]). Empty defaults to ["pmc"],
+// which preserves the historical PSM behavior.
 func (m *Manager) FirmwareControl(ctx context.Context, target common.Target, info operations.FirmwareControlTaskInfo) error {
 	log.Debug().
 		Str("components", target.String()).
 		Str("operation", fmt.Sprintf("%v", info.Operation)).
 		Str("target_version", info.TargetVersion).
+		Strs("sub_targets", info.SubTargets).
 		Msg("Starting firmware update")
 
 	if m.psmClient == nil {
@@ -309,21 +315,31 @@ func (m *Manager) FirmwareControl(ctx context.Context, target common.Target, inf
 		return fmt.Errorf("target is invalid: %w", err)
 	}
 
+	subComponents, err := firmwarecomponents.ParsePSMPowerShelf(info.SubTargets)
+	if err != nil {
+		return err
+	}
+	if len(subComponents) == 0 {
+		subComponents = []psmapi.PowershelfComponent{psmapi.PowershelfComponentPMC}
+	}
+
 	pmcMacs := target.ComponentIDs
 
-	// Create firmware update request for PMC component
+	componentReqs := make([]psmapi.UpdateComponentFirmwareRequest, 0, len(subComponents))
+	for _, c := range subComponents {
+		componentReqs = append(componentReqs, psmapi.UpdateComponentFirmwareRequest{
+			Component: c,
+			UpgradeTo: psmapi.FirmwareVersion{Version: info.TargetVersion},
+		})
+	}
+
 	updateReqs := make([]psmapi.UpdatePowershelfFirmwareRequest, 0, len(pmcMacs))
 	for _, componentID := range pmcMacs {
 		updateReqs = append(
 			updateReqs,
 			psmapi.UpdatePowershelfFirmwareRequest{
 				PMCMACAddress: componentID,
-				Components: []psmapi.UpdateComponentFirmwareRequest{
-					{
-						Component: psmapi.PowershelfComponentPMC,
-						UpgradeTo: psmapi.FirmwareVersion{Version: info.TargetVersion},
-					},
-				},
+				Components:    componentReqs,
 			},
 		)
 	}
diff --git a/flow/internal/task/operations/operations.go b/flow/internal/task/operations/operations.go
index e8db4594a..570b935cb 100644
--- a/flow/internal/task/operations/operations.go
+++ b/flow/internal/task/operations/operations.go
@@ -215,6 +215,18 @@ type FirmwareControlTaskInfo struct {
 	StartTime     int64             `json:"start_time,omitempty"` // Unix timestamp
 	EndTime       int64             `json:"end_time,omitempty"`   // Unix timestamp
 	RuleID        string            `json:"rule_id,omitempty"`
+	// SubTargets, when non-empty, restricts the upgrade to a subset of
+	// firmware sub-parts within each targeted tray (e.g. ["bmc", "nvos"]
+	// for switch trays, ["bmc", "bios"] for compute trays, ["psu"] for
+	// powershelf trays). Named "SubTargets" (not "Components") to avoid
+	// colliding with the carbide tray-level Component vocabulary used for
+	// OperationTargetSpec / ExecutionInfo.Components, which select tray
+	// INSTANCES rather than sub-parts of a tray.
+	// Names are lowercase and case-sensitive. Empty or nil means "update
+	// everything in the bundle" (the historical default). Mapping from
+	// these strings to component-manager-specific enums is done in each
+	// FirmwareControl implementation (see pkg/common/firmwarecomponents).
+	SubTargets []string `json:"sub_targets,omitempty"`
 }
 
 func (t *FirmwareControlTaskInfo) Validate() error {
diff --git a/flow/pkg/common/firmwarecomponents/firmwarecomponents.go b/flow/pkg/common/firmwarecomponents/firmwarecomponents.go
new file mode 100644
index 000000000..189dc9ecf
--- /dev/null
+++ b/flow/pkg/common/firmwarecomponents/firmwarecomponents.go
@@ -0,0 +1,171 @@
+/*
+ * SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// Package firmwarecomponents converts the lowercase component-name strings
+// accepted by the REST/Flow firmware-update API into the per-tray-type
+// enum values used by each downstream component manager.
+//
+// The mappings are written explicitly so that:
+//
+//   - Renaming or removing a proto enum constant in Core fails the build
+//     here at compile time, instead of silently turning into an empty
+//     accepted set.
+//   - The lowercase REST name for each enum value is reviewable in a PR
+//     rather than derived from a prefix-stripping heuristic.
+//   - Editors can jump from "bmc" straight to the proto enum const.
+//
+// Completeness against Core's proto is enforced by the unit tests in this
+// package: for each NICo enum, the tests iterate the protoc-generated
+// `*_name` reverse map and require every non-UNKNOWN value to appear in
+// our mapping. When Core adds a new value, regen + test failure tells the
+// developer to pick a lowercase name and add an entry here, on purpose.
+package firmwarecomponents
+
+import (
+	"fmt"
+	"sort"
+	"strings"
+
+	nicopb "github.com/NVIDIA/infra-controller-rest/flow/internal/nicoapi/gen"
+	"github.com/NVIDIA/infra-controller-rest/flow/internal/nsmapi"
+	"github.com/NVIDIA/infra-controller-rest/flow/internal/psmapi"
+)
+
+// === NICo (Core) per-tray enums. ==========================================
+
+var (
+	nicoNVSwitchByName = map[string]nicopb.NvSwitchComponent{
+		"bmc":  nicopb.NvSwitchComponent_NV_SWITCH_COMPONENT_BMC,
+		"cpld": nicopb.NvSwitchComponent_NV_SWITCH_COMPONENT_CPLD,
+		"bios": nicopb.NvSwitchComponent_NV_SWITCH_COMPONENT_BIOS,
+		"nvos": nicopb.NvSwitchComponent_NV_SWITCH_COMPONENT_NVOS,
+	}
+	nicoNVSwitchNames = sortedKeys(nicoNVSwitchByName)
+
+	nicoPowerShelfByName = map[string]nicopb.PowerShelfComponent{
+		"pmc": nicopb.PowerShelfComponent_POWER_SHELF_COMPONENT_PMC,
+		"psu": nicopb.PowerShelfComponent_POWER_SHELF_COMPONENT_PSU,
+	}
+	nicoPowerShelfNames = sortedKeys(nicoPowerShelfByName)
+
+	nicoComputeTrayByName = map[string]nicopb.ComputeTrayComponent{
+		"bmc":  nicopb.ComputeTrayComponent_COMPUTE_TRAY_COMPONENT_BMC,
+		"bios": nicopb.ComputeTrayComponent_COMPUTE_TRAY_COMPONENT_BIOS,
+	}
+	nicoComputeTrayNames = sortedKeys(nicoComputeTrayByName)
+)
+
+// ParseNICoNVSwitch maps lowercase names to NICo NvSwitchComponent values.
+// Returns nil for an empty input (callers may interpret as "all components").
+func ParseNICoNVSwitch(names []string) ([]nicopb.NvSwitchComponent, error) {
+	return lookup(names, nicoNVSwitchByName, nicoNVSwitchNames, "nvswitch")
+}
+
+// ParseNICoPowerShelf maps lowercase names to NICo PowerShelfComponent values.
+func ParseNICoPowerShelf(names []string) ([]nicopb.PowerShelfComponent, error) {
+	return lookup(names, nicoPowerShelfByName, nicoPowerShelfNames, "powershelf")
+}
+
+// ParseNICoComputeTray maps lowercase names to NICo ComputeTrayComponent values.
+func ParseNICoComputeTray(names []string) ([]nicopb.ComputeTrayComponent, error) {
+	return lookup(names, nicoComputeTrayByName, nicoComputeTrayNames, "compute")
+}
+
+// SupportedNICoNVSwitchNames returns the lowercase names accepted by
+// ParseNICoNVSwitch in deterministic order. Useful for surfacing the set
+// in API documentation or operator tooling.
+func SupportedNICoNVSwitchNames() []string { return append([]string(nil), nicoNVSwitchNames...) }
+
+// SupportedNICoPowerShelfNames returns the lowercase names accepted by
+// ParseNICoPowerShelf in deterministic order.
+func SupportedNICoPowerShelfNames() []string {
+	return append([]string(nil), nicoPowerShelfNames...)
+}
+
+// SupportedNICoComputeTrayNames returns the lowercase names accepted by
+// ParseNICoComputeTray in deterministic order.
+func SupportedNICoComputeTrayNames() []string {
+	return append([]string(nil), nicoComputeTrayNames...)
+}
+
+// === Legacy NSM-direct path. nsmapi.NVSwitchComponent is a hand-rolled Go
+//     enum (not a proto enum), so we keep an explicit map here. ===
+
+var (
+	nsmNVSwitchByName = map[string]nsmapi.NVSwitchComponent{
+		"bmc":  nsmapi.NVSwitchComponentBMC,
+		"cpld": nsmapi.NVSwitchComponentCPLD,
+		"bios": nsmapi.NVSwitchComponentBIOS,
+		"nvos": nsmapi.NVSwitchComponentNVOS,
+	}
+	nsmNVSwitchNames = sortedKeys(nsmNVSwitchByName)
+)
+
+// ParseNSMNVSwitch maps lowercase names to nsmapi.NVSwitchComponent values.
+func ParseNSMNVSwitch(names []string) ([]nsmapi.NVSwitchComponent, error) {
+	return lookup(names, nsmNVSwitchByName, nsmNVSwitchNames, "nvswitch")
+}
+
+// === Legacy PSM-direct path. Same story as NSM. ===
+
+var (
+	psmPowerShelfByName = map[string]psmapi.PowershelfComponent{
+		"pmc": psmapi.PowershelfComponentPMC,
+		"psu": psmapi.PowershelfComponentPSU,
+	}
+	psmPowerShelfNames = sortedKeys(psmPowerShelfByName)
+)
+
+// ParsePSMPowerShelf maps lowercase names to psmapi.PowershelfComponent values.
+func ParsePSMPowerShelf(names []string) ([]psmapi.PowershelfComponent, error) {
+	return lookup(names, psmPowerShelfByName, psmPowerShelfNames, "powershelf")
+}
+
+// === internal helpers ====================================================
+
+// sortedKeys returns the keys of m in lexicographic order. Used to produce
+// deterministic "expected one of: ..." error messages.
+func sortedKeys[V any](m map[string]V) []string {
+	out := make([]string, 0, len(m))
+	for k := range m {
+		out = append(out, k)
+	}
+	sort.Strings(out)
+	return out
+}
+
+// lookup is the shared per-name resolution loop. An empty/nil input yields
+// (nil, nil); callers decide whether nil means "all components" or "default
+// to one specific component". Surrounding whitespace is tolerated; case
+// is normalized to lowercase before lookup.
+func lookup[E any](names []string, table map[string]E, sortedNames []string, kind string) ([]E, error) {
+	if len(names) == 0 {
+		return nil, nil
+	}
+	out := make([]E, 0, len(names))
+	for _, n := range names {
+		v, ok := table[strings.ToLower(strings.TrimSpace(n))]
+		if !ok {
+			return nil, fmt.Errorf(
+				"unknown %s component %q (expected one of: %s)",
+				kind, n, strings.Join(sortedNames, ", "),
+			)
+		}
+		out = append(out, v)
+	}
+	return out, nil
+}
diff --git a/flow/pkg/common/firmwarecomponents/firmwarecomponents_test.go b/flow/pkg/common/firmwarecomponents/firmwarecomponents_test.go
new file mode 100644
index 000000000..6ec3548c4
--- /dev/null
+++ b/flow/pkg/common/firmwarecomponents/firmwarecomponents_test.go
@@ -0,0 +1,177 @@
+/*
+ * SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package firmwarecomponents
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
+	nicopb "github.com/NVIDIA/infra-controller-rest/flow/internal/nicoapi/gen"
+	"github.com/NVIDIA/infra-controller-rest/flow/internal/nsmapi"
+	"github.com/NVIDIA/infra-controller-rest/flow/internal/psmapi"
+)
+
+func TestParseNICoNVSwitch(t *testing.T) {
+	t.Run("nil input returns nil (caller decides)", func(t *testing.T) {
+		got, err := ParseNICoNVSwitch(nil)
+		require.NoError(t, err)
+		assert.Nil(t, got)
+	})
+
+	t.Run("known names map to proto enums", func(t *testing.T) {
+		got, err := ParseNICoNVSwitch([]string{"bmc", "cpld", "bios", "nvos"})
+		require.NoError(t, err)
+		assert.Equal(t, []nicopb.NvSwitchComponent{
+			nicopb.NvSwitchComponent_NV_SWITCH_COMPONENT_BMC,
+			nicopb.NvSwitchComponent_NV_SWITCH_COMPONENT_CPLD,
+			nicopb.NvSwitchComponent_NV_SWITCH_COMPONENT_BIOS,
+			nicopb.NvSwitchComponent_NV_SWITCH_COMPONENT_NVOS,
+		}, got)
+	})
+
+	t.Run("uppercase and surrounding whitespace are tolerated", func(t *testing.T) {
+		got, err := ParseNICoNVSwitch([]string{" BMC ", "NVOS"})
+		require.NoError(t, err)
+		assert.Equal(t, []nicopb.NvSwitchComponent{
+			nicopb.NvSwitchComponent_NV_SWITCH_COMPONENT_BMC,
+			nicopb.NvSwitchComponent_NV_SWITCH_COMPONENT_NVOS,
+		}, got)
+	})
+
+	t.Run("unknown name is rejected with sorted suggestions", func(t *testing.T) {
+		_, err := ParseNICoNVSwitch([]string{"pmc"})
+		require.Error(t, err)
+		assert.Contains(t, err.Error(), `"pmc"`)
+		assert.Contains(t, err.Error(), "bios, bmc, cpld, nvos")
+	})
+}
+
+func TestParseNICoPowerShelf(t *testing.T) {
+	got, err := ParseNICoPowerShelf([]string{"pmc", "psu"})
+	require.NoError(t, err)
+	assert.Equal(t, []nicopb.PowerShelfComponent{
+		nicopb.PowerShelfComponent_POWER_SHELF_COMPONENT_PMC,
+		nicopb.PowerShelfComponent_POWER_SHELF_COMPONENT_PSU,
+	}, got)
+
+	_, err = ParseNICoPowerShelf([]string{"bmc"})
+	require.Error(t, err)
+	assert.Contains(t, err.Error(), "pmc, psu")
+}
+
+func TestParseNICoComputeTray(t *testing.T) {
+	got, err := ParseNICoComputeTray([]string{"bmc", "bios"})
+	require.NoError(t, err)
+	assert.Equal(t, []nicopb.ComputeTrayComponent{
+		nicopb.ComputeTrayComponent_COMPUTE_TRAY_COMPONENT_BMC,
+		nicopb.ComputeTrayComponent_COMPUTE_TRAY_COMPONENT_BIOS,
+	}, got)
+
+	_, err = ParseNICoComputeTray([]string{"nvos"})
+	require.Error(t, err)
+}
+
+func TestParseNSMNVSwitch(t *testing.T) {
+	got, err := ParseNSMNVSwitch([]string{"bmc", "cpld", "bios", "nvos"})
+	require.NoError(t, err)
+	assert.Equal(t, []nsmapi.NVSwitchComponent{
+		nsmapi.NVSwitchComponentBMC,
+		nsmapi.NVSwitchComponentCPLD,
+		nsmapi.NVSwitchComponentBIOS,
+		nsmapi.NVSwitchComponentNVOS,
+	}, got)
+
+	_, err = ParseNSMNVSwitch([]string{"psu"})
+	require.Error(t, err)
+}
+
+func TestParsePSMPowerShelf(t *testing.T) {
+	got, err := ParsePSMPowerShelf([]string{"pmc", "psu"})
+	require.NoError(t, err)
+	assert.Equal(t, []psmapi.PowershelfComponent{
+		psmapi.PowershelfComponentPMC,
+		psmapi.PowershelfComponentPSU,
+	}, got)
+
+	_, err = ParsePSMPowerShelf([]string{"bmc"})
+	require.Error(t, err)
+}
+
+func TestSupportedNamesAreSortedAndImmutable(t *testing.T) {
+	names := SupportedNICoNVSwitchNames()
+	require.Equal(t, []string{"bios", "bmc", "cpld", "nvos"}, names)
+
+	names[0] = "mutated"
+	again := SupportedNICoNVSwitchNames()
+	require.Equal(t, []string{"bios", "bmc", "cpld", "nvos"}, again)
+}
+
+// === Completeness guards =================================================
+//
+// These tests fail when Core's proto adds a new value to one of the NICo
+// per-tray-type enums and the developer has not added a matching lowercase
+// entry to firmwarecomponents.go. The intent is to force the choice of a
+// public REST name to happen in PR review, on purpose, rather than being
+// silently derived (or silently dropped) by a generic helper.
+
+// completenessFor checks that every non-UNKNOWN value in the protoc-
+// generated _name reverse map is represented in our hand-written mapping.
+// enumLabel is used purely for the error message.
+func completenessFor[E ~int32](
+	t *testing.T,
+	enumLabel string,
+	protoNames map[int32]string,
+	mapping map[string]E,
+) {
+	t.Helper()
+
+	present := make(map[int32]struct{}, len(mapping))
+	for _, v := range mapping {
+		present[int32(v)] = struct{}{}
+	}
+
+	for v, name := range protoNames {
+		// Skip the proto-conventional sentinel; we deliberately never
+		// expose it on the REST surface.
+		if v == 0 || strings.HasSuffix(name, "_UNKNOWN") || strings.HasSuffix(name, "_UNSPECIFIED") {
+			continue
+		}
+		if _, ok := present[v]; !ok {
+			t.Fatalf(
+				"firmwarecomponents: %s proto value %s (=%d) has no lowercase REST name. "+
+					"Add an entry to the corresponding map in firmwarecomponents.go.",
+				enumLabel, name, v,
+			)
+		}
+	}
+}
+
+func TestNICoNVSwitchMapIsComplete(t *testing.T) {
+	completenessFor(t, "NvSwitchComponent", nicopb.NvSwitchComponent_name, nicoNVSwitchByName)
+}
+
+func TestNICoPowerShelfMapIsComplete(t *testing.T) {
+	completenessFor(t, "PowerShelfComponent", nicopb.PowerShelfComponent_name, nicoPowerShelfByName)
+}
+
+func TestNICoComputeTrayMapIsComplete(t *testing.T) {
+	completenessFor(t, "ComputeTrayComponent", nicopb.ComputeTrayComponent_name, nicoComputeTrayByName)
+}
diff --git a/flow/pkg/proto/v1/flow.pb.go b/flow/pkg/proto/v1/flow.pb.go
index 177fec712..96f05cfa9 100644
--- a/flow/pkg/proto/v1/flow.pb.go
+++ b/flow/pkg/proto/v1/flow.pb.go
@@ -3319,6 +3319,15 @@ type UpgradeFirmwareRequest struct {
 	Description   string                 `protobuf:"bytes,5,opt,name=description,proto3" json:"description,omitempty"`                                // optional: task description
 	QueueOptions  *QueueOptions          `protobuf:"bytes,6,opt,name=queue_options,json=queueOptions,proto3,oneof" json:"queue_options,omitempty"`
 	RuleId        *UUID                  `protobuf:"bytes,7,opt,name=rule_id,json=ruleId,proto3,oneof" json:"rule_id,omitempty"` // optional: override rule resolution with a specific rule
+	// Optional subset of firmware sub-parts to update within each tray
+	// selected by target_spec, e.g. ["bmc", "nvos"] for switch trays or
+	// ["psu"] for powershelf trays. Named "sub_targets" (not "components")
+	// to avoid colliding with OperationTargetSpec.components, which selects
+	// tray INSTANCES rather than sub-parts of a tray.
+	// Names are lowercase. Empty or omitted means update everything in the
+	// bundle (current default behavior). Unknown names are rejected by the
+	// downstream component manager.
+	SubTargets    []string `protobuf:"bytes,8,rep,name=sub_targets,json=subTargets,proto3" json:"sub_targets,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
 }
@@ -3402,6 +3411,13 @@ func (x *UpgradeFirmwareRequest) GetRuleId() *UUID {
 	return nil
 }
 
+func (x *UpgradeFirmwareRequest) GetSubTargets() []string {
+	if x != nil {
+		return x.SubTargets
+	}
+	return nil
+}
+
 // GetComponents - retrieves components from local database
 type GetComponentsRequest struct {
 	state         protoimpl.MessageState `protogen:"open.v1"`
@@ -7854,7 +7870,7 @@ const file_flow_proto_rawDesc = "" +
 	"\x1bGetRacksForNVLDomainRequest\x12B\n" +
 	"\x15nvl_domain_identifier\x18\x01 \x01(\v2\x0e.v1.IdentifierR\x13nvlDomainIdentifier\">\n" +
 	"\x1cGetRacksForNVLDomainResponse\x12\x1e\n" +
-	"\x05racks\x18\x01 \x03(\v2\b.v1.RackR\x05racks\"\xcd\x03\n" +
+	"\x05racks\x18\x01 \x03(\v2\b.v1.RackR\x05racks\"\xee\x03\n" +
 	"\x16UpgradeFirmwareRequest\x128\n" +
 	"\vtarget_spec\x18\x01 \x01(\v2\x17.v1.OperationTargetSpecR\n" +
 	"targetSpec\x12*\n" +
@@ -7864,7 +7880,9 @@ const file_flow_proto_rawDesc = "" +
 	"\bend_time\x18\x04 \x01(\v2\x1a.google.protobuf.TimestampH\x02R\aendTime\x88\x01\x01\x12 \n" +
 	"\vdescription\x18\x05 \x01(\tR\vdescription\x12:\n" +
 	"\rqueue_options\x18\x06 \x01(\v2\x10.v1.QueueOptionsH\x03R\fqueueOptions\x88\x01\x01\x12&\n" +
-	"\arule_id\x18\a \x01(\v2\b.v1.UUIDH\x04R\x06ruleId\x88\x01\x01B\x11\n" +
+	"\arule_id\x18\a \x01(\v2\b.v1.UUIDH\x04R\x06ruleId\x88\x01\x01\x12\x1f\n" +
+	"\vsub_targets\x18\b \x03(\tR\n" +
+	"subTargetsB\x11\n" +
 	"\x0f_target_versionB\r\n" +
 	"\v_start_timeB\v\n" +
 	"\t_end_timeB\x10\n" +
diff --git a/flow/proto/v1/flow.proto b/flow/proto/v1/flow.proto
index 169549403..48cc821f3 100644
--- a/flow/proto/v1/flow.proto
+++ b/flow/proto/v1/flow.proto
@@ -444,6 +444,15 @@ message UpgradeFirmwareRequest {
     string description = 5;                             // optional: task description
     optional QueueOptions queue_options = 6;
     optional UUID rule_id = 7;                          // optional: override rule resolution with a specific rule
+    // Optional subset of firmware sub-parts to update within each tray
+    // selected by target_spec, e.g. ["bmc", "nvos"] for switch trays or
+    // ["psu"] for powershelf trays. Named "sub_targets" (not "components")
+    // to avoid colliding with OperationTargetSpec.components, which selects
+    // tray INSTANCES rather than sub-parts of a tray.
+    // Names are lowercase. Empty or omitted means update everything in the
+    // bundle (current default behavior). Unknown names are rejected by the
+    // downstream component manager.
+    repeated string sub_targets = 8;
 }
 
 // GetComponents - retrieves components from local database
diff --git a/openapi/spec.yaml b/openapi/spec.yaml
index 462b29e10..adc6d5ef2 100644
--- a/openapi/spec.yaml
+++ b/openapi/spec.yaml
@@ -17128,6 +17128,42 @@ components:
             - string
             - 'null'
           description: Target firmware version.
+        targets:
+          type: array
+          items:
+            type: string
+            minLength: 1
+            enum:
+              - bmc
+              - cpld
+              - bios
+              - nvos
+              - pmc
+              - psu
+          description: |-
+            Optional subset of firmware targets to update within each matched tray.
+            Names are lowercase and select sub-parts of the tray
+            (BMC, BIOS, etc.). The accepted set per tray type comes from
+            the Flow service's NICo proto bindings (which mirror Core's
+            per-tray-type enums in `carbide-core/crates/rpc/proto/forge.proto`),
+            so the supported values track Core as new sub-parts are added:
+              - switch trays (NvSwitchComponent): currently bmc, cpld, bios, nvos
+              - powershelf trays (PowerShelfComponent): currently pmc, psu
+              - compute trays (ComputeTrayComponent): currently bmc, bios
+                (currently NOT honored end-to-end: the NICo compute-firmware
+                path goes through SetFirmwareUpdateTimeWindow + auto-update,
+                which has no per-target selection; the request is logged
+                and the whole bundle is applied. Will be honored once
+                compute moves to UpdateComponentFirmware.)
+            Omitted or empty means "update everything in the bundle"
+            (the historical default). Unknown names are rejected.
+            Requires `version` to be set.
+      examples:
+        - siteId: 550e8400-e29b-41d4-a716-446655440000
+          filter:
+            type: switch
+          version: '24.11.0'
+          targets: [bmc, nvos]
     UpdatePowerStateRequest:
       title: UpdatePowerStateRequest
       type: object
@@ -17192,10 +17228,43 @@ components:
             - string
             - 'null'
           description: Target firmware version.
+        targets:
+          type: array
+          items:
+            type: string
+            minLength: 1
+            enum:
+              - bmc
+              - cpld
+              - bios
+              - nvos
+              - pmc
+              - psu
+          description: |-
+            Optional subset of firmware targets to update within the targeted tray.
+            Names are lowercase and select sub-parts of the tray
+            (BMC, BIOS, etc.). The accepted set per tray type comes from
+            the Flow service's NICo proto bindings (which mirror Core's
+            per-tray-type enums in `carbide-core/crates/rpc/proto/forge.proto`),
+            so the supported values track Core as new sub-parts are added:
+              - switch trays (NvSwitchComponent): currently bmc, cpld, bios, nvos
+              - powershelf trays (PowerShelfComponent): currently pmc, psu
+              - compute trays (ComputeTrayComponent): currently bmc, bios
+                (currently NOT honored end-to-end: the NICo compute-firmware
+                path goes through SetFirmwareUpdateTimeWindow + auto-update,
+                which has no per-target selection; the request is logged
+                and the whole bundle is applied. Will be honored once
+                compute moves to UpdateComponentFirmware.)
+            Omitted or empty means "update everything in the bundle"
+            (the historical default). Unknown names are rejected.
+            Requires `version` to be set.
       examples:
         - siteId: 550e8400-e29b-41d4-a716-446655440000
           version: '24.11.0'
         - siteId: 550e8400-e29b-41d4-a716-446655440000
+          version: '24.11.0'
+          targets: [bmc, nvos]
+        - siteId: 550e8400-e29b-41d4-a716-446655440000
     FirmwareUpdateResponse:
       title: FirmwareUpdateResponse
       type: object
diff --git a/sdk/standard/client.go b/sdk/standard/client.go
index 708344534..3fcdaf8c8 100644
--- a/sdk/standard/client.go
+++ b/sdk/standard/client.go
@@ -598,10 +598,7 @@ func addFile(w *multipart.Writer, fieldName, path string) error {
 	if err != nil {
 		return err
 	}
-	err = file.Close()
-	if err != nil {
-		return err
-	}
+	defer file.Close()
 
 	part, err := w.CreateFormFile(fieldName, filepath.Base(path))
 	if err != nil {
diff --git a/sdk/standard/model_batch_tray_firmware_update_request.go b/sdk/standard/model_batch_tray_firmware_update_request.go
index 41eca5e9e..9fa274263 100644
--- a/sdk/standard/model_batch_tray_firmware_update_request.go
+++ b/sdk/standard/model_batch_tray_firmware_update_request.go
@@ -43,6 +43,8 @@ type BatchTrayFirmwareUpdateRequest struct {
 	Filter *TrayFilter `json:"filter,omitempty"`
 	// Target firmware version.
 	Version NullableString `json:"version,omitempty"`
+	// Optional subset of firmware targets to update within each matched tray. Names are lowercase and select sub-parts of the tray (BMC, BIOS, etc.). The accepted set per tray type comes from the Flow service's NICo proto bindings (which mirror Core's per-tray-type enums in `carbide-core/crates/rpc/proto/forge.proto`), so the supported values track Core as new sub-parts are added:   - switch trays (NvSwitchComponent): currently bmc, cpld, bios, nvos   - powershelf trays (PowerShelfComponent): currently pmc, psu   - compute trays (ComputeTrayComponent): currently bmc, bios     (currently NOT honored end-to-end: the NICo compute-firmware     path goes through SetFirmwareUpdateTimeWindow + auto-update,     which has no per-target selection; the request is logged     and the whole bundle is applied. Will be honored once     compute moves to UpdateComponentFirmware.) Omitted or empty means \"update everything in the bundle\" (the historical default). Unknown names are rejected. Requires `version` to be set.
+	Targets []string `json:"targets,omitempty"`
 }
 
 type _BatchTrayFirmwareUpdateRequest BatchTrayFirmwareUpdateRequest
@@ -164,6 +166,38 @@ func (o *BatchTrayFirmwareUpdateRequest) UnsetVersion() {
 	o.Version.Unset()
 }
 
+// GetTargets returns the Targets field value if set, zero value otherwise.
+func (o *BatchTrayFirmwareUpdateRequest) GetTargets() []string {
+	if o == nil || IsNil(o.Targets) {
+		var ret []string
+		return ret
+	}
+	return o.Targets
+}
+
+// GetTargetsOk returns a tuple with the Targets field value if set, nil otherwise
+// and a boolean to check if the value has been set.
+func (o *BatchTrayFirmwareUpdateRequest) GetTargetsOk() ([]string, bool) {
+	if o == nil || IsNil(o.Targets) {
+		return nil, false
+	}
+	return o.Targets, true
+}
+
+// HasTargets returns a boolean if a field has been set.
+func (o *BatchTrayFirmwareUpdateRequest) HasTargets() bool {
+	if o != nil && !IsNil(o.Targets) {
+		return true
+	}
+
+	return false
+}
+
+// SetTargets gets a reference to the given []string and assigns it to the Targets field.
+func (o *BatchTrayFirmwareUpdateRequest) SetTargets(v []string) {
+	o.Targets = v
+}
+
 func (o BatchTrayFirmwareUpdateRequest) MarshalJSON() ([]byte, error) {
 	toSerialize, err := o.ToMap()
 	if err != nil {
@@ -181,6 +215,9 @@ func (o BatchTrayFirmwareUpdateRequest) ToMap() (map[string]interface{}, error)
 	if o.Version.IsSet() {
 		toSerialize["version"] = o.Version.Get()
 	}
+	if !IsNil(o.Targets) {
+		toSerialize["targets"] = o.Targets
+	}
 	return toSerialize, nil
 }
 
diff --git a/sdk/standard/model_expected_machine.go b/sdk/standard/model_expected_machine.go
index 2ddbc2e98..2af4bee56 100644
--- a/sdk/standard/model_expected_machine.go
+++ b/sdk/standard/model_expected_machine.go
@@ -74,7 +74,8 @@ type ExpectedMachine struct {
 	// Tray index within the rack
 	TrayIdx NullableInt32 `json:"trayIdx,omitempty"`
 	// Host ID within the tray
-	HostId NullableInt32     `json:"hostId,omitempty"`
+	HostId NullableInt32 `json:"hostId,omitempty"`
+	// User-defined key-value pairs for organizing and categorizing Expected Machines
 	Labels map[string]string `json:"labels,omitempty"`
 	// ISO 8601 datetime when the Expected Machine was created
 	Created *time.Time `json:"created,omitempty"`
diff --git a/sdk/standard/model_expected_machine_create_request.go b/sdk/standard/model_expected_machine_create_request.go
index 068441c11..359c34243 100644
--- a/sdk/standard/model_expected_machine_create_request.go
+++ b/sdk/standard/model_expected_machine_create_request.go
@@ -71,7 +71,8 @@ type ExpectedMachineCreateRequest struct {
 	// Tray index within the rack
 	TrayIdx NullableInt32 `json:"trayIdx,omitempty"`
 	// Host ID within the tray
-	HostId NullableInt32     `json:"hostId,omitempty"`
+	HostId NullableInt32 `json:"hostId,omitempty"`
+	// User-defined key-value pairs for organizing and categorizing Expected Machines
 	Labels map[string]string `json:"labels,omitempty"`
 }
 
diff --git a/sdk/standard/model_expected_machine_update_request.go b/sdk/standard/model_expected_machine_update_request.go
index a0d186b67..7591865dc 100644
--- a/sdk/standard/model_expected_machine_update_request.go
+++ b/sdk/standard/model_expected_machine_update_request.go
@@ -69,7 +69,8 @@ type ExpectedMachineUpdateRequest struct {
 	// Tray index within the rack
 	TrayIdx NullableInt32 `json:"trayIdx,omitempty"`
 	// Host ID within the tray
-	HostId NullableInt32     `json:"hostId,omitempty"`
+	HostId NullableInt32 `json:"hostId,omitempty"`
+	// User-defined key-value pairs for organizing and categorizing Expected Machines
 	Labels map[string]string `json:"labels,omitempty"`
 }
 
diff --git a/sdk/standard/model_expected_power_shelf.go b/sdk/standard/model_expected_power_shelf.go
index c68335895..8a6b89cd7 100644
--- a/sdk/standard/model_expected_power_shelf.go
+++ b/sdk/standard/model_expected_power_shelf.go
@@ -64,7 +64,8 @@ type ExpectedPowerShelf struct {
 	// Tray index within the rack
 	TrayIdx NullableInt32 `json:"trayIdx,omitempty"`
 	// Host ID within the tray
-	HostId NullableInt32     `json:"hostId,omitempty"`
+	HostId NullableInt32 `json:"hostId,omitempty"`
+	// User-defined key-value pairs for organizing and categorizing Expected Power Shelves
 	Labels map[string]string `json:"labels,omitempty"`
 	// ISO 8601 datetime when the Expected Power Shelf was created
 	Created *time.Time `json:"created,omitempty"`
diff --git a/sdk/standard/model_expected_power_shelf_create_request.go b/sdk/standard/model_expected_power_shelf_create_request.go
index 89aca24e9..7acc8eefc 100644
--- a/sdk/standard/model_expected_power_shelf_create_request.go
+++ b/sdk/standard/model_expected_power_shelf_create_request.go
@@ -67,7 +67,8 @@ type ExpectedPowerShelfCreateRequest struct {
 	// Tray index within the rack
 	TrayIdx NullableInt32 `json:"trayIdx,omitempty"`
 	// Host ID within the tray
-	HostId NullableInt32     `json:"hostId,omitempty"`
+	HostId NullableInt32 `json:"hostId,omitempty"`
+	// User-defined key-value pairs for organizing and categorizing Expected Power Shelves
 	Labels map[string]string `json:"labels,omitempty"`
 }
 
diff --git a/sdk/standard/model_expected_power_shelf_update_request.go b/sdk/standard/model_expected_power_shelf_update_request.go
index 1e485d174..802018f5a 100644
--- a/sdk/standard/model_expected_power_shelf_update_request.go
+++ b/sdk/standard/model_expected_power_shelf_update_request.go
@@ -65,7 +65,8 @@ type ExpectedPowerShelfUpdateRequest struct {
 	// Tray index within the rack
 	TrayIdx NullableInt32 `json:"trayIdx,omitempty"`
 	// Host ID within the tray
-	HostId NullableInt32     `json:"hostId,omitempty"`
+	HostId NullableInt32 `json:"hostId,omitempty"`
+	// User-defined key-value pairs for organizing and categorizing Expected Power Shelves
 	Labels map[string]string `json:"labels,omitempty"`
 }
 
diff --git a/sdk/standard/model_expected_rack.go b/sdk/standard/model_expected_rack.go
index 25e1c9a69..a58443376 100644
--- a/sdk/standard/model_expected_rack.go
+++ b/sdk/standard/model_expected_rack.go
@@ -48,8 +48,9 @@ type ExpectedRack struct {
 	// Human-readable name of the Expected Rack
 	Name *string `json:"name,omitempty"`
 	// Human-readable description of the Expected Rack
-	Description *string           `json:"description,omitempty"`
-	Labels      map[string]string `json:"labels,omitempty"`
+	Description *string `json:"description,omitempty"`
+	// User-defined key-value pairs for organizing and categorizing Expected Racks. Well-known keys (`chassis.*`, `location.*`) are used to convey chassis identity and physical location.
+	Labels map[string]string `json:"labels,omitempty"`
 	// ISO 8601 datetime when the Expected Rack was created
 	Created *time.Time `json:"created,omitempty"`
 	// ISO 8601 datetime when the Expected Rack was last updated
diff --git a/sdk/standard/model_expected_rack_create_request.go b/sdk/standard/model_expected_rack_create_request.go
index 78896d952..b0fc1c5c5 100644
--- a/sdk/standard/model_expected_rack_create_request.go
+++ b/sdk/standard/model_expected_rack_create_request.go
@@ -47,8 +47,9 @@ type ExpectedRackCreateRequest struct {
 	// Human-readable name of the Expected Rack
 	Name NullableString `json:"name,omitempty"`
 	// Human-readable description of the Expected Rack
-	Description NullableString    `json:"description,omitempty"`
-	Labels      map[string]string `json:"labels,omitempty"`
+	Description NullableString `json:"description,omitempty"`
+	// User-defined key-value pairs for organizing and categorizing Expected Racks. Well-known keys (`chassis.*`, `location.*`) are used to convey chassis identity and physical location.
+	Labels map[string]string `json:"labels,omitempty"`
 }
 
 type _ExpectedRackCreateRequest ExpectedRackCreateRequest
diff --git a/sdk/standard/model_expected_rack_update_request.go b/sdk/standard/model_expected_rack_update_request.go
index c3d1a4bea..1293d2b37 100644
--- a/sdk/standard/model_expected_rack_update_request.go
+++ b/sdk/standard/model_expected_rack_update_request.go
@@ -45,8 +45,9 @@ type ExpectedRackUpdateRequest struct {
 	// Human-readable name of the Expected Rack
 	Name NullableString `json:"name,omitempty"`
 	// Human-readable description of the Expected Rack
-	Description NullableString    `json:"description,omitempty"`
-	Labels      map[string]string `json:"labels,omitempty"`
+	Description NullableString `json:"description,omitempty"`
+	// User-defined key-value pairs for organizing and categorizing Expected Racks. Well-known keys (`chassis.*`, `location.*`) are used to convey chassis identity and physical location.
+	Labels map[string]string `json:"labels,omitempty"`
 }
 
 // NewExpectedRackUpdateRequest instantiates a new ExpectedRackUpdateRequest object
diff --git a/sdk/standard/model_expected_switch.go b/sdk/standard/model_expected_switch.go
index 082c27aeb..190b770f0 100644
--- a/sdk/standard/model_expected_switch.go
+++ b/sdk/standard/model_expected_switch.go
@@ -64,7 +64,8 @@ type ExpectedSwitch struct {
 	// Tray index within the rack
 	TrayIdx NullableInt32 `json:"trayIdx,omitempty"`
 	// Host ID within the tray
-	HostId NullableInt32     `json:"hostId,omitempty"`
+	HostId NullableInt32 `json:"hostId,omitempty"`
+	// User-defined key-value pairs for organizing and categorizing Expected Switches
 	Labels map[string]string `json:"labels,omitempty"`
 	// ISO 8601 datetime when the Expected Switch was created
 	Created *time.Time `json:"created,omitempty"`
diff --git a/sdk/standard/model_expected_switch_create_request.go b/sdk/standard/model_expected_switch_create_request.go
index 01d27e29a..60e2feb47 100644
--- a/sdk/standard/model_expected_switch_create_request.go
+++ b/sdk/standard/model_expected_switch_create_request.go
@@ -71,7 +71,8 @@ type ExpectedSwitchCreateRequest struct {
 	// Tray index within the rack
 	TrayIdx NullableInt32 `json:"trayIdx,omitempty"`
 	// Host ID within the tray
-	HostId NullableInt32     `json:"hostId,omitempty"`
+	HostId NullableInt32 `json:"hostId,omitempty"`
+	// User-defined key-value pairs for organizing and categorizing Expected Switches
 	Labels map[string]string `json:"labels,omitempty"`
 }
 
diff --git a/sdk/standard/model_expected_switch_update_request.go b/sdk/standard/model_expected_switch_update_request.go
index 3f21f9daa..ddc8d12b3 100644
--- a/sdk/standard/model_expected_switch_update_request.go
+++ b/sdk/standard/model_expected_switch_update_request.go
@@ -69,7 +69,8 @@ type ExpectedSwitchUpdateRequest struct {
 	// Tray index within the rack
 	TrayIdx NullableInt32 `json:"trayIdx,omitempty"`
 	// Host ID within the tray
-	HostId NullableInt32     `json:"hostId,omitempty"`
+	HostId NullableInt32 `json:"hostId,omitempty"`
+	// User-defined key-value pairs for organizing and categorizing Expected Switches
 	Labels map[string]string `json:"labels,omitempty"`
 }
 
diff --git a/sdk/standard/model_firmware_update_request.go b/sdk/standard/model_firmware_update_request.go
index e729d5adb..c8e2fa54b 100644
--- a/sdk/standard/model_firmware_update_request.go
+++ b/sdk/standard/model_firmware_update_request.go
@@ -42,6 +42,8 @@ type FirmwareUpdateRequest struct {
 	SiteId string `json:"siteId"`
 	// Target firmware version.
 	Version NullableString `json:"version,omitempty"`
+	// Optional subset of firmware targets to update within the targeted tray. Names are lowercase and select sub-parts of the tray (BMC, BIOS, etc.). The accepted set per tray type comes from the Flow service's NICo proto bindings (which mirror Core's per-tray-type enums in `carbide-core/crates/rpc/proto/forge.proto`), so the supported values track Core as new sub-parts are added:   - switch trays (NvSwitchComponent): currently bmc, cpld, bios, nvos   - powershelf trays (PowerShelfComponent): currently pmc, psu   - compute trays (ComputeTrayComponent): currently bmc, bios     (currently NOT honored end-to-end: the NICo compute-firmware     path goes through SetFirmwareUpdateTimeWindow + auto-update,     which has no per-target selection; the request is logged     and the whole bundle is applied. Will be honored once     compute moves to UpdateComponentFirmware.) Omitted or empty means \"update everything in the bundle\" (the historical default). Unknown names are rejected. Requires `version` to be set.
+	Targets []string `json:"targets,omitempty"`
 }
 
 type _FirmwareUpdateRequest FirmwareUpdateRequest
@@ -131,6 +133,38 @@ func (o *FirmwareUpdateRequest) UnsetVersion() {
 	o.Version.Unset()
 }
 
+// GetTargets returns the Targets field value if set, zero value otherwise.
+func (o *FirmwareUpdateRequest) GetTargets() []string {
+	if o == nil || IsNil(o.Targets) {
+		var ret []string
+		return ret
+	}
+	return o.Targets
+}
+
+// GetTargetsOk returns a tuple with the Targets field value if set, nil otherwise
+// and a boolean to check if the value has been set.
+func (o *FirmwareUpdateRequest) GetTargetsOk() ([]string, bool) {
+	if o == nil || IsNil(o.Targets) {
+		return nil, false
+	}
+	return o.Targets, true
+}
+
+// HasTargets returns a boolean if a field has been set.
+func (o *FirmwareUpdateRequest) HasTargets() bool {
+	if o != nil && !IsNil(o.Targets) {
+		return true
+	}
+
+	return false
+}
+
+// SetTargets gets a reference to the given []string and assigns it to the Targets field.
+func (o *FirmwareUpdateRequest) SetTargets(v []string) {
+	o.Targets = v
+}
+
 func (o FirmwareUpdateRequest) MarshalJSON() ([]byte, error) {
 	toSerialize, err := o.ToMap()
 	if err != nil {
@@ -145,6 +179,9 @@ func (o FirmwareUpdateRequest) ToMap() (map[string]interface{}, error) {
 	if o.Version.IsSet() {
 		toSerialize["version"] = o.Version.Get()
 	}
+	if !IsNil(o.Targets) {
+		toSerialize["targets"] = o.Targets
+	}
 	return toSerialize, nil
 }
 
diff --git a/sdk/standard/model_infini_band_partition.go b/sdk/standard/model_infini_band_partition.go
index 3394697a5..59f0f25d4 100644
--- a/sdk/standard/model_infini_band_partition.go
+++ b/sdk/standard/model_infini_band_partition.go
@@ -37,23 +37,24 @@ var _ MappedNullable = &InfiniBandPartition{}
 
 // InfiniBandPartition InfiniBand Partitions are network segments utilizing InfiniBand topology
 type InfiniBandPartition struct {
-	Id                      *string                    `json:"id,omitempty"`
-	Name                    *string                    `json:"name,omitempty"`
-	Description             NullableString             `json:"description,omitempty"`
-	SiteId                  *string                    `json:"siteId,omitempty"`
-	TenantId                *string                    `json:"tenantId,omitempty"`
-	ControllerIBPartitionId NullableString             `json:"controllerIBPartitionId,omitempty"`
-	PartitionKey            NullableString             `json:"partitionKey,omitempty"`
-	PartitionName           NullableString             `json:"partitionName,omitempty"`
-	ServiceLevel            NullableInt32              `json:"serviceLevel,omitempty"`
-	RateLimit               NullableFloat32            `json:"rateLimit,omitempty"`
-	Mtu                     NullableInt32              `json:"mtu,omitempty"`
-	EnableSharp             *bool                      `json:"enableSharp,omitempty"`
-	Labels                  map[string]string          `json:"labels,omitempty"`
-	Status                  *InfiniBandPartitionStatus `json:"status,omitempty"`
-	StatusHistory           []StatusDetail             `json:"statusHistory,omitempty"`
-	Created                 *time.Time                 `json:"created,omitempty"`
-	Updated                 *time.Time                 `json:"updated,omitempty"`
+	Id                      *string         `json:"id,omitempty"`
+	Name                    *string         `json:"name,omitempty"`
+	Description             NullableString  `json:"description,omitempty"`
+	SiteId                  *string         `json:"siteId,omitempty"`
+	TenantId                *string         `json:"tenantId,omitempty"`
+	ControllerIBPartitionId NullableString  `json:"controllerIBPartitionId,omitempty"`
+	PartitionKey            NullableString  `json:"partitionKey,omitempty"`
+	PartitionName           NullableString  `json:"partitionName,omitempty"`
+	ServiceLevel            NullableInt32   `json:"serviceLevel,omitempty"`
+	RateLimit               NullableFloat32 `json:"rateLimit,omitempty"`
+	Mtu                     NullableInt32   `json:"mtu,omitempty"`
+	EnableSharp             *bool           `json:"enableSharp,omitempty"`
+	// String key value pairs describing InfiniBand Partition labels. Up to 10 key value pairs can be specified
+	Labels        map[string]string          `json:"labels,omitempty"`
+	Status        *InfiniBandPartitionStatus `json:"status,omitempty"`
+	StatusHistory []StatusDetail             `json:"statusHistory,omitempty"`
+	Created       *time.Time                 `json:"created,omitempty"`
+	Updated       *time.Time                 `json:"updated,omitempty"`
 }
 
 // NewInfiniBandPartition instantiates a new InfiniBandPartition object
diff --git a/sdk/standard/model_infini_band_partition_create_request.go b/sdk/standard/model_infini_band_partition_create_request.go
index abd7bc9bf..12726f4bf 100644
--- a/sdk/standard/model_infini_band_partition_create_request.go
+++ b/sdk/standard/model_infini_band_partition_create_request.go
@@ -43,7 +43,8 @@ type InfiniBandPartitionCreateRequest struct {
 	// Optional description of the Partition
 	Description NullableString `json:"description,omitempty"`
 	// ID of the Site the Partition should belong to
-	SiteId string            `json:"siteId"`
+	SiteId string `json:"siteId"`
+	// String key value pairs describing Partition labels. Up to 10 key value pairs can be specified
 	Labels map[string]string `json:"labels,omitempty"`
 }
 
diff --git a/sdk/standard/model_infini_band_partition_update_request.go b/sdk/standard/model_infini_band_partition_update_request.go
index f0d777bd8..1709f742a 100644
--- a/sdk/standard/model_infini_band_partition_update_request.go
+++ b/sdk/standard/model_infini_band_partition_update_request.go
@@ -38,9 +38,10 @@ var _ MappedNullable = &InfiniBandPartitionUpdateRequest{}
 
 // InfiniBandPartitionUpdateRequest Request data to update an InfiniBand Partition
 type InfiniBandPartitionUpdateRequest struct {
-	Name        string            `json:"name"`
-	Description NullableString    `json:"description,omitempty"`
-	Labels      map[string]string `json:"labels,omitempty"`
+	Name        string         `json:"name"`
+	Description NullableString `json:"description,omitempty"`
+	// String key value pairs describing Partition labels. Up to 10 key value pairs can be specified
+	Labels map[string]string `json:"labels,omitempty"`
 }
 
 type _InfiniBandPartitionUpdateRequest InfiniBandPartitionUpdateRequest
diff --git a/sdk/standard/model_instance_update_request.go b/sdk/standard/model_instance_update_request.go
index 04d2dc2a3..b981ea59a 100644
--- a/sdk/standard/model_instance_update_request.go
+++ b/sdk/standard/model_instance_update_request.go
@@ -58,8 +58,9 @@ type InstanceUpdateRequest struct {
 	// Whether the custom iPXE data should be used for every boot.
 	AlwaysBootWithCustomIpxe NullableBool `json:"alwaysBootWithCustomIpxe,omitempty"`
 	// Indicates whether the Phone Home service should be enabled or disabled for Instance
-	PhoneHomeEnabled NullableBool      `json:"phoneHomeEnabled,omitempty"`
-	Labels           map[string]string `json:"labels,omitempty"`
+	PhoneHomeEnabled NullableBool `json:"phoneHomeEnabled,omitempty"`
+	// Update labels of the Instance. The labels will be entirely replaced by those sent in the request. Any labels not included in the request will be removed. To retain existing labels, first fetch them and include them along with this request.
+	Labels map[string]string `json:"labels,omitempty"`
 	// IDs of additional VPCs the Instance should attach to through non-primary interfaces. This field may only be specified when every entry in `interfaces` uses `vpcPrefixId`. IDs must be unique, must be valid UUIDs, and must not include the primary `vpcId`.
 	SecondaryVpcIds []string `json:"secondaryVpcIds,omitempty"`
 	// Update Interfaces of the Instance
diff --git a/sdk/standard/model_machine_update_request.go b/sdk/standard/model_machine_update_request.go
index b567f4dd3..fb4e5d509 100644
--- a/sdk/standard/model_machine_update_request.go
+++ b/sdk/standard/model_machine_update_request.go
@@ -43,9 +43,10 @@ type MachineUpdateRequest struct {
 	// Set to `true` to enable maintenance mode and to `false` to disable maintenance mode. Can be set by Provider or Privileged Tenant.
 	SetMaintenanceMode NullableBool `json:"setMaintenanceMode,omitempty"`
 	// Optional message describing the reason for moving Machine into maintenance mode. Can be updated by Provider or Privileged Tenant.
-	MaintenanceMessage NullableString       `json:"maintenanceMessage,omitempty"`
-	Labels             map[string]string    `json:"labels,omitempty"`
-	OnlineRepair       *MachineOnlineRepair `json:"onlineRepair,omitempty"`
+	MaintenanceMessage NullableString `json:"maintenanceMessage,omitempty"`
+	// Machine labels will be overwritten, include existing labels to preserve them. Can be updated by Provider or Privileged Tenant.
+	Labels       map[string]string    `json:"labels,omitempty"`
+	OnlineRepair *MachineOnlineRepair `json:"onlineRepair,omitempty"`
 	// Required when `onlineRepair.enabled` is true. Must not be set when exiting online repair (`onlineRepair.enabled` false).
 	HealthIssue *MachineHealthIssue `json:"healthIssue,omitempty"`
 }
diff --git a/sdk/standard/model_vpc.go b/sdk/standard/model_vpc.go
index fe11c2f4d..18f9a483b 100644
--- a/sdk/standard/model_vpc.go
+++ b/sdk/standard/model_vpc.go
@@ -64,8 +64,9 @@ type VPC struct {
 	// Propagation details for the attached Network Security Group
 	NetworkSecurityGroupPropagationDetails *NetworkSecurityGroupPropagationDetails `json:"networkSecurityGroupPropagationDetails,omitempty"`
 	// ID of the default NVLink Logical Partition that GPUs for all Instances in the VPC will attach to
-	NvLinkLogicalPartitionId NullableString    `json:"nvLinkLogicalPartitionId,omitempty"`
-	Labels                   map[string]string `json:"labels,omitempty"`
+	NvLinkLogicalPartitionId NullableString `json:"nvLinkLogicalPartitionId,omitempty"`
+	// String key value pairs describing VPC labels
+	Labels map[string]string `json:"labels,omitempty"`
 	// Status of the VPC
 	Status *VpcStatus `json:"status,omitempty"`
 	// History of status changes for the VPC
diff --git a/sdk/standard/model_vpc_create_request.go b/sdk/standard/model_vpc_create_request.go
index 5b8953c32..50d56dc1a 100644
--- a/sdk/standard/model_vpc_create_request.go
+++ b/sdk/standard/model_vpc_create_request.go
@@ -55,8 +55,9 @@ type VpcCreateRequest struct {
 	// Explicitly requested VNI for the VPC
 	Vni NullableInt32 `json:"vni,omitempty"`
 	// ID of the default NVLink Logical Partition that GPUs for all Instances in the VPC will attach to
-	NvLinkLogicalPartitionId NullableString    `json:"nvLinkLogicalPartitionId,omitempty"`
-	Labels                   map[string]string `json:"labels,omitempty"`
+	NvLinkLogicalPartitionId NullableString `json:"nvLinkLogicalPartitionId,omitempty"`
+	// String key value pairs describing VPC labels. Up to 10 key value pairs can be specified
+	Labels map[string]string `json:"labels,omitempty"`
 }
 
 type _VpcCreateRequest VpcCreateRequest
diff --git a/sdk/standard/model_vpc_update_request.go b/sdk/standard/model_vpc_update_request.go
index ba1dce467..fe28c398d 100644
--- a/sdk/standard/model_vpc_update_request.go
+++ b/sdk/standard/model_vpc_update_request.go
@@ -43,8 +43,9 @@ type VpcUpdateRequest struct {
 	// ID of the Network Security Group to attach to the VPC
 	NetworkSecurityGroupId NullableString `json:"networkSecurityGroupId,omitempty"`
 	// ID of the default NVLink Logical Partition that GPUs for all Instances in the VPC will attach to. Can only be updated if VPC currently has no active Instances
-	NvLinkLogicalPartitionId NullableString    `json:"nvLinkLogicalPartitionId,omitempty"`
-	Labels                   map[string]string `json:"labels,omitempty"`
+	NvLinkLogicalPartitionId NullableString `json:"nvLinkLogicalPartitionId,omitempty"`
+	// Update labels of the VPC. Up to 10 key value pairs can be specified. The labels will be entirely replaced by those sent in the request. Any labels not included in the request will be removed. To retain existing labels, first fetch them and include them along with this request.
+	Labels map[string]string `json:"labels,omitempty"`
 }
 
 // NewVpcUpdateRequest instantiates a new VpcUpdateRequest object
diff --git a/workflow-schema/flow/proto/v1/flow.proto b/workflow-schema/flow/proto/v1/flow.proto
index 2a7542d49..17942dd5c 100644
--- a/workflow-schema/flow/proto/v1/flow.proto
+++ b/workflow-schema/flow/proto/v1/flow.proto
@@ -18,13 +18,12 @@
 syntax = "proto3";
 
 package v1;
+option go_package = "github.com/NVIDIA/infra-controller-rest/workflow-schema/flow";
 
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
 
-option go_package = "github.com/NVIDIA/infra-controller-rest/workflow-schema/flow";
-
 service Flow {
     // Version
     rpc Version(VersionRequest) returns (BuildInfo);
@@ -445,6 +444,15 @@ message UpgradeFirmwareRequest {
     string description = 5;                             // optional: task description
     optional QueueOptions queue_options = 6;
     optional UUID rule_id = 7;                          // optional: override rule resolution with a specific rule
+    // Optional subset of firmware sub-parts to update within each tray
+    // selected by target_spec, e.g. ["bmc", "nvos"] for switch trays or
+    // ["psu"] for powershelf trays. Named "sub_targets" (not "components")
+    // to avoid colliding with OperationTargetSpec.components, which selects
+    // tray INSTANCES rather than sub-parts of a tray.
+    // Names are lowercase. Empty or omitted means update everything in the
+    // bundle (current default behavior). Unknown names are rejected by the
+    // downstream component manager.
+    repeated string sub_targets = 8;
 }
 
 // GetComponents - retrieves components from local database
diff --git a/workflow-schema/flow/protobuf/v1/flow.pb.go b/workflow-schema/flow/protobuf/v1/flow.pb.go
index d7060e7d7..f0297fa55 100644
--- a/workflow-schema/flow/protobuf/v1/flow.pb.go
+++ b/workflow-schema/flow/protobuf/v1/flow.pb.go
@@ -3319,6 +3319,15 @@ type UpgradeFirmwareRequest struct {
 	Description   string                 `protobuf:"bytes,5,opt,name=description,proto3" json:"description,omitempty"`                                // optional: task description
 	QueueOptions  *QueueOptions          `protobuf:"bytes,6,opt,name=queue_options,json=queueOptions,proto3,oneof" json:"queue_options,omitempty"`
 	RuleId        *UUID                  `protobuf:"bytes,7,opt,name=rule_id,json=ruleId,proto3,oneof" json:"rule_id,omitempty"` // optional: override rule resolution with a specific rule
+	// Optional subset of firmware sub-parts to update within each tray
+	// selected by target_spec, e.g. ["bmc", "nvos"] for switch trays or
+	// ["psu"] for powershelf trays. Named "sub_targets" (not "components")
+	// to avoid colliding with OperationTargetSpec.components, which selects
+	// tray INSTANCES rather than sub-parts of a tray.
+	// Names are lowercase. Empty or omitted means update everything in the
+	// bundle (current default behavior). Unknown names are rejected by the
+	// downstream component manager.
+	SubTargets    []string `protobuf:"bytes,8,rep,name=sub_targets,json=subTargets,proto3" json:"sub_targets,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
 }
@@ -3402,6 +3411,13 @@ func (x *UpgradeFirmwareRequest) GetRuleId() *UUID {
 	return nil
 }
 
+func (x *UpgradeFirmwareRequest) GetSubTargets() []string {
+	if x != nil {
+		return x.SubTargets
+	}
+	return nil
+}
+
 // GetComponents - retrieves components from local database
 type GetComponentsRequest struct {
 	state         protoimpl.MessageState `protogen:"open.v1"`
@@ -7837,7 +7853,7 @@ const file_flow_proto_rawDesc = "" +
 	"\x1bGetRacksForNVLDomainRequest\x12B\n" +
 	"\x15nvl_domain_identifier\x18\x01 \x01(\v2\x0e.v1.IdentifierR\x13nvlDomainIdentifier\">\n" +
 	"\x1cGetRacksForNVLDomainResponse\x12\x1e\n" +
-	"\x05racks\x18\x01 \x03(\v2\b.v1.RackR\x05racks\"\xcd\x03\n" +
+	"\x05racks\x18\x01 \x03(\v2\b.v1.RackR\x05racks\"\xee\x03\n" +
 	"\x16UpgradeFirmwareRequest\x128\n" +
 	"\vtarget_spec\x18\x01 \x01(\v2\x17.v1.OperationTargetSpecR\n" +
 	"targetSpec\x12*\n" +
@@ -7847,7 +7863,9 @@ const file_flow_proto_rawDesc = "" +
 	"\bend_time\x18\x04 \x01(\v2\x1a.google.protobuf.TimestampH\x02R\aendTime\x88\x01\x01\x12 \n" +
 	"\vdescription\x18\x05 \x01(\tR\vdescription\x12:\n" +
 	"\rqueue_options\x18\x06 \x01(\v2\x10.v1.QueueOptionsH\x03R\fqueueOptions\x88\x01\x01\x12&\n" +
-	"\arule_id\x18\a \x01(\v2\b.v1.UUIDH\x04R\x06ruleId\x88\x01\x01B\x11\n" +
+	"\arule_id\x18\a \x01(\v2\b.v1.UUIDH\x04R\x06ruleId\x88\x01\x01\x12\x1f\n" +
+	"\vsub_targets\x18\b \x03(\tR\n" +
+	"subTargetsB\x11\n" +
 	"\x0f_target_versionB\r\n" +
 	"\v_start_timeB\v\n" +
 	"\t_end_timeB\x10\n" +
diff --git a/workflow-schema/flow/protobuf/v1/flow_grpc.pb.go b/workflow-schema/flow/protobuf/v1/flow_grpc.pb.go
index 0075afdb0..ccd3dc2e4 100644
--- a/workflow-schema/flow/protobuf/v1/flow_grpc.pb.go
+++ b/workflow-schema/flow/protobuf/v1/flow_grpc.pb.go
@@ -16,7 +16,7 @@
 
 // Code generated by protoc-gen-go-grpc. DO NOT EDIT.
 // versions:
-// - protoc-gen-go-grpc v1.6.2
+// - protoc-gen-go-grpc v1.6.1
 // - protoc             (unknown)
 // source: flow.proto