diff --git a/rest-api/docs/index.html b/rest-api/docs/index.html
index 192338f661..71865fee1a 100644
--- a/rest-api/docs/index.html
+++ b/rest-api/docs/index.html
@@ -14434,10 +14434,16 @@ <h3 id="typical-api-call-flow-for-tenant">Typical API Call Flow for Tenant</h3>
 " class="sc-iJSMbW sc-cBEgGa fiNpIH bAoMjv"><p>Divides the selected targets into phases. Set at most one of <code>equal</code>,
 <code>percentage</code>, or <code>count</code>; omit the whole policy for a single phase
 covering all targets.</p>
-</div></div></div></td></tr><tr><td colSpan="2" class="sc-hCcPtG sc-folSZX jFNAwF hGnrOS"><div class="sc-dILkzW edSHQU"><table class="sc-hHopjF bsjUmE"><tbody><tr class=""><td class="sc-hCcPtG sc-fFCZOx sc-jgzHYo jFNAwF lcdEEX QbYuY" kind="field" title="equal"><span class="sc-ieCSdj kkMuqc"></span><button aria-label="expand equal"><span class="property-name">equal</span><svg class="sc-dYjPD kecbEr" 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></button></td><td class="sc-bjLslk gLpZiQ"><div><div><span class="sc-gSILEF sc-lbpDNm jMRTsl NncTE"></span><span class="sc-gSILEF sc-iNyHtD jMRTsl kUjPnZ">object</span><span class="sc-gSILEF sc-jePOid jMRTsl ehlihR"> (<!-- -->TaskRunEqualPhases<!-- -->) </span></div> <div><div html="&lt;p&gt;Splits targets into &lt;code&gt;phaseCount&lt;/code&gt; roughly equal phases.&lt;/p&gt;
-" class="sc-iJSMbW sc-cBEgGa fiNpIH bAoMjv"><p>Splits targets into <code>phaseCount</code> roughly equal phases.</p>
-</div></div></div></td></tr><tr class=""><td class="sc-hCcPtG sc-fFCZOx sc-jgzHYo jFNAwF lcdEEX QbYuY" kind="field" title="percentage"><span class="sc-ieCSdj kkMuqc"></span><button aria-label="expand percentage"><span class="property-name">percentage</span><svg class="sc-dYjPD kecbEr" 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></button></td><td class="sc-bjLslk gLpZiQ"><div><div><span class="sc-gSILEF sc-lbpDNm jMRTsl NncTE"></span><span class="sc-gSILEF sc-iNyHtD jMRTsl kUjPnZ">object</span><span class="sc-gSILEF sc-jePOid jMRTsl ehlihR"> (<!-- -->TaskRunPercentagePhases<!-- -->) </span></div> <div><div html="&lt;p&gt;Splits targets by percentage. Values must sum to 100.&lt;/p&gt;
-" class="sc-iJSMbW sc-cBEgGa fiNpIH bAoMjv"><p>Splits targets by percentage. Values must sum to 100.</p>
+</div></div></div></td></tr><tr><td colSpan="2" class="sc-hCcPtG sc-folSZX jFNAwF hGnrOS"><div class="sc-dILkzW edSHQU"><table class="sc-hHopjF bsjUmE"><tbody><tr class=""><td class="sc-hCcPtG sc-fFCZOx sc-jgzHYo jFNAwF lcdEEX QbYuY" kind="field" title="equal"><span class="sc-ieCSdj kkMuqc"></span><button aria-label="expand equal"><span class="property-name">equal</span><svg class="sc-dYjPD kecbEr" 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></button></td><td class="sc-bjLslk gLpZiQ"><div><div><span class="sc-gSILEF sc-lbpDNm jMRTsl NncTE"></span><span class="sc-gSILEF sc-iNyHtD jMRTsl kUjPnZ">object</span><span class="sc-gSILEF sc-jePOid jMRTsl ehlihR"> (<!-- -->TaskRunEqualPhases<!-- -->) </span></div> <div><div html="&lt;p&gt;Splits targets into up to &lt;code&gt;phaseCount&lt;/code&gt; roughly equal phases. Phases that
+would contain no selected targets are omitted.&lt;/p&gt;
+" class="sc-iJSMbW sc-cBEgGa fiNpIH bAoMjv"><p>Splits targets into up to <code>phaseCount</code> roughly equal phases. Phases that
+would contain no selected targets are omitted.</p>
+</div></div></div></td></tr><tr class=""><td class="sc-hCcPtG sc-fFCZOx sc-jgzHYo jFNAwF lcdEEX QbYuY" kind="field" title="percentage"><span class="sc-ieCSdj kkMuqc"></span><button aria-label="expand percentage"><span class="property-name">percentage</span><svg class="sc-dYjPD kecbEr" 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></button></td><td class="sc-bjLslk gLpZiQ"><div><div><span class="sc-gSILEF sc-lbpDNm jMRTsl NncTE"></span><span class="sc-gSILEF sc-iNyHtD jMRTsl kUjPnZ">object</span><span class="sc-gSILEF sc-jePOid jMRTsl ehlihR"> (<!-- -->TaskRunPercentagePhases<!-- -->) </span></div> <div><div html="&lt;p&gt;Splits targets by percentage. Values must sum to 100. A configured
+phase is omitted when its percentage rounds down to zero selected
+targets.&lt;/p&gt;
+" class="sc-iJSMbW sc-cBEgGa fiNpIH bAoMjv"><p>Splits targets by percentage. Values must sum to 100. A configured
+phase is omitted when its percentage rounds down to zero selected
+targets.</p>
 </div></div></div></td></tr><tr class=""><td class="sc-hCcPtG sc-fFCZOx sc-jgzHYo jFNAwF lcdEEX QbYuY" kind="field" title="count"><span class="sc-ieCSdj kkMuqc"></span><button aria-label="expand count"><span class="property-name">count</span><svg class="sc-dYjPD kecbEr" 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></button></td><td class="sc-bjLslk gLpZiQ"><div><div><span class="sc-gSILEF sc-lbpDNm jMRTsl NncTE"></span><span class="sc-gSILEF sc-iNyHtD jMRTsl kUjPnZ">object</span><span class="sc-gSILEF sc-jePOid jMRTsl ehlihR"> (<!-- -->TaskRunCountPhases<!-- -->) </span></div> <div><div html="&lt;p&gt;Splits targets by explicit counts. A generated final phase covers any remaining targets.&lt;/p&gt;
 " class="sc-iJSMbW sc-cBEgGa fiNpIH bAoMjv"><p>Splits targets by explicit counts. A generated final phase covers any remaining targets.</p>
 </div></div></div></td></tr><tr class="last "><td kind="field" title="autoAdvance" class="sc-hCcPtG sc-fFCZOx jFNAwF lcdEEX"><span class="sc-ieCSdj kkMuqc"></span><span class="property-name">autoAdvance</span></td><td class="sc-bjLslk gLpZiQ"><div><div><span class="sc-gSILEF sc-lbpDNm jMRTsl NncTE"></span><span class="sc-gSILEF sc-iNyHtD jMRTsl kUjPnZ">boolean</span></div><div><span class="sc-gSILEF jMRTsl"> <!-- -->Default:<!-- --> </span> <span class="sc-gSILEF sc-lbFCLI jMRTsl OXDYs">false</span></div> <div><div html="&lt;p&gt;When true, phases advance automatically as long as safety gates are
@@ -17690,7 +17696,7 @@ <h3 id="typical-api-call-flow-for-tenant">Typical API Call Flow for Tenant</h3>
 </ul>
 </div></div></div></div><div class="sc-ekVkVN bjzTxL"></div></div></div>
       <script>
-      const __redoc_state = {"menu":{"activeItemIdx":-1},"spec":{"data":{"openapi":"3.1.0","info":{"title":"NVIDIA Infra Controller REST API","version":"2.0.0","summary":"NVIDIA Infra Controller REST API is the RESTful gateway for accessing the NVIDIA Infra Controller service","description":"NVIDIA Infra Controller REST API allows users to create and manage resources, e.g., VPCs, Subnets, and 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/tree/main/rest-api/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 when a Ready Tenant Account has `siteCapabilities` with `targetedInstanceCreation` 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 use a NICo Site, the Provider or Service Account holder must create IP Blocks for each network overlay defined in the Site configuration TOML file.\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 with the full prefix length using the [Create Allocation endpoint](#tag/Allocation/operation/create-allocation).\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).\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 Machines on the 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 the 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  - If the 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 the API service is configured in Service Account mode, API users can act as both Provider and Tenant. Privileged Tenant behavior (for example, creating Instances by Machine ID) is determined by `siteCapabilities` on a Ready Tenant Account, not by tenant-level configuration."},{"name":"Infrastructure Provider","description":"Infrastructure Provider is the anchor entity for an organization that owns and manages Site resources."},{"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- `capabilities.targetedInstanceCreation` was deprecated in favor of `tenantAccount.siteCapabilities` and will be removed on October 1st, 2026 0:00 UTC. The value returned on GET `/tenant/current` is computed from Ready Tenant Account configuration; embedded `TenantSummary.capabilities` in nested resources always reports `false`."},{"name":"Tenant Account","description":"Tenant Account connects a Tenant with an Infrastructure Provider. It represents/contains any information pertaining to their relationship.\n\nProvider Admins configure TargetedInstanceCreation for a Tenant using the `siteCapabilities` attribute. An entry with empty or omitted `siteIds` configures the Tenant Account default; entries with `siteIds` configure Tenant Site overrides.\n\nDeprecation history:\n\n- `accountNumber`, `subscriptionId`, and `subscriptionTier` attributes were deprecated and will be removed on September 10th, 2026 0:00 UTC. Please update your usage accordingly."},{"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\nRecent deprecations:\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":"BMC Credential","x-displayName":"BMC Credential","description":"BMC Credential endpoints allow creating and updating BMC credentials across all Machines of a Site"},{"name":"UEFI Credential","x-displayName":"UEFI Credential","description":"UEFI Credential endpoints allow creating site-default host and DPU UEFI credentials for a Site"},{"name":"Measured Boot Trusted Machine","description":"Measured Boot Trusted Machine endpoints manage automatic measurement promotion approvals for Machines at a Site"},{"name":"Measured Boot Trusted Profile","description":"Measured Boot Trusted Profile endpoints manage automatic measurement promotion approvals for system profiles at a Site"},{"name":"Credential Rotation","description":"Credential Rotation endpoints stage a site-wide credential rotation and report per-Site or per-device convergence"},{"name":"Site Explorer","description":"Site Explorer discovers BMC endpoints on a Site and tracks their exploration state."},{"name":"Allocation","description":"Allocations are the mechanism by which Provider can delegate Network and Compute resources to Tenant.\n\nDeprecation history:\n\n- `ResourceTypeID` attribute on Allocation Constraint was deprecated in favor of `resourceTypeId` and will be removed on July 9th, 2026 0:00 UTC. Please use `resourceTypeId` instead."},{"name":"VPC","x-displayName":"VPC","description":"VPC defines the networking isolation boundary for Tenant's Instances."},{"name":"VPC Peering","x-displayName":"VPC Peering","description":"VPC Peering allows Instances in one VPC to communicate with Instances in another VPC on the same Site."},{"name":"VPC Prefix","x-displayName":"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)."},{"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 an NVLink 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 NVLink Switch discovery and ingestion."},{"name":"SKU","x-displayName":"SKU","description":"SKU (Stock Keeping Unit) defines one or more hardware configurations or Machine Bill of Materials (BOM).\n\nSKUs group similar machines by their hardware characteristics. Most SKUs are managed by the system, but Provider Admins can create, update, and delete SKUs for a Site."},{"name":"InfiniBand Partition","x-displayName":"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","x-displayName":"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.\n\nDeprecation history:\n\n- `nvLinklogicalPartitionId` attribute on NVLink Interface was deprecated in favor of `nvLinkLogicalPartitionId` and will be removed on July 9th, 2026 0:00 UTC. Please use `nvLinkLogicalPartitionId` instead."},{"name":"Operating System","description":"Operating Systems in NICo are typically iPXE scripts that are used to boot Machines.\n\nDeprecation history:\n\n- `isCloudInit` on create and update requests is deprecated and ignored; the response field is derived from whether `userData` is non-empty."},{"name":"iPXE Template","x-displayName":"iPXE Template","description":"iPXE Templates are read-only definitions propagated from nico-core into the REST API. Each template has a stable core UUID and a globally unique name; per-site availability is tracked in IpxeTemplateSiteAssociation records rather than on the template row itself. List and retrieve operations return templates reported at sites the caller is authorized for (optionally filtered by `siteId`). Templated iPXE Operating Systems reference a template by `ipxeTemplateId`."},{"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."},{"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."},{"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 Validation","description":"Machine Validation is the mechanism through which a series of validation tests are executed against a Machine verify its integrity. The tests are run for each Machine on ingestion, they can also be run on-demand."},{"name":"BMC Reset","x-displayName":"BMC Reset","description":"BMC Reset allows resetting a Machine's BMC"},{"name":"DPU Reprovision","x-displayName":"DPU Reprovision","description":"DPU Reprovision allows re-provisioning Machine's DPUs"},{"name":"Health Report","description":"Machine Health Report contains information about the health of a Machine including user enforced overrides"},{"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":"Task","description":"Task represents an asynchronous, site-scoped operation (for example firmware update, power state change, or rack bring-up). Tasks are created when operations run against Racks, Trays, or other components. Endpoints in this tag retrieve or cancel a Task by ID; list Tasks for a Rack or Tray under the Rack and Tray tags."},{"name":"Rule","description":"Operation Rule defines, per Site, how a particular operation (for example `PowerControl` / `power_on` or `FirmwareControl` / `upgrade`) should be executed against a set of components: ordered execution stages, per-component-type concurrency, pre / main / post actions, timeouts, and retry policy. Rules are reusable templates owned by Flow; this tag exposes CRUD (`POST`, `GET`, `PATCH`, `DELETE`) over them."},{"name":"Task Run","description":"A Task Run is a phased, policy-gated execution of one operation (currently firmware) across many Racks. A Task Run narrows a candidate set of Racks with an optional selector, divides the selected Racks into phases, and drives one execution target per Rack; each target in turn drives at most one Task. Safety gates pause the Task Run when failures exceed a threshold, and phase gates hold each phase until an operator advances it. This tag exposes creation, retrieval, target listing, and the pause / resume / advance / cancel lifecycle actions; drill into per-Rack execution detail via the Task tag using each target's `taskId`."},{"name":"Network Security Group","description":"Network Security Group is a security policy that controls the traffic flowing between Instances.\n\nDeprecation history:\n\n- `object_id` attribute on Network Security Group propagation details was deprecated in favor of `objectId` and will be removed on July 9th, 2026 0:00 UTC. Please use `objectId` instead."},{"name":"IP Block","x-displayName":"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."},{"name":"DPU Extension Service","x-displayName":"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","x-displayName":"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","x-displayName":"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":"Host Firmware Config","description":"Host firmware configuration defines known firmware versions, artifact\nlocations, update ordering, and per-component defaults for a given\nhardware vendor and model on a Site.\n\nProvider Admins use PUT to create or merge host firmware config entries\nin Core via `UpsertHostFirmwareConfig`. Configurations are keyed by\n`(vendor, model)`; repeated PUTs merge firmware versions for\ncomponents already present and add new component types when supplied\ntogether with an updated `ordering`. Returns `201 Created` on first\ncreate and `200 OK` on subsequent updates.\n\nProvider Admins use DELETE to remove a host firmware config entry from\nCore via `DeleteHostFirmwareConfig`, keyed by `(vendor, model)`.\nReturns `204 No Content` on success.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix in the\nURL `{org}`, and the Site must belong to the org's Infrastructure\nProvider."},{"name":"Tenant Identity","description":"Tenant identity (JWT-SVID issuance) and RFC 8693 token delegation.\n\nTenant Admins use these endpoints to enable JWT-SVID issuance for an\norg on a specific site, rotate the signing key, configure a token\nexchange callback, and serve the public JWKS / OIDC discovery\ndocuments that verifiers (OpenBao, tenant APIs, etc.) consume.\n\nThe six management endpoints (PUT / GET / DELETE on `tenant-identity/config`\nand `tenant-identity/token-delegation`) require an authorization role with\n`TENANT_ADMIN` suffix in the URL `{org}`. The three `.well-known/*`\nendpoints are public; external verifiers can fetch public keys\nwithout credentials.\n\nPUT is a full-replace upsert: every call must include all required\nfields, and omitted optional fields are cleared. To pause issuance\nwithout destroying signing keys, PUT with `enabled: false`; to\ndestroy the signing keypair, use DELETE. Signing keys survive\n`enabled: false` and survive non-rotation upserts, so JWKS consumers\nand in-flight JWTs continue to verify across pauses and attribute\nchanges.\n\nJWKS verifiers should treat every key in the returned set as valid\nand match candidates by `kid` — during a key-rotation overlap\nwindow two keys are present until the previous key expires. The\nOIDC discovery endpoint's `id_token_signing_alg_values_supported`\nis intentionally empty because NICo issues bearer access JWTs,\nnot OIDC `id_token`s. The three public endpoints return\n`404 Not Found` when identity material cannot be served for this\norg/site (unknown site, org is not a tenant, no tenant allocation\non the site, or no identity configuration); the two JWKS routes\nadditionally return `502 Bad Gateway` when the Core gRPC API\nresponds with a body that is not a parseable JWK Set."},{"name":"Deprecations","description":"NICo REST API maintains backward compatibility with the previous versions. Any breaking changes are announced using deprecation notices.\n\nActive Deprecations:\n\nInstance:\n- `infrastructureProviderId` query parameter on the list Instances endpoint was deprecated and will be removed on October 10th, 2026 0:00 UTC. Instances will no longer be filtered by Infrastructure Provider; results are scoped to the org's Tenant. Use the `siteId` parameter to scope results to a specific Infrastructure Provider's Sites.\n\nTenant:\n- `capabilities.targetedInstanceCreation` attribute was deprecated in favor of `tenantAccount.siteCapabilities` and will be removed on October 1st, 2026 0:00 UTC. Please use `tenantAccount.siteCapabilities` instead.\n\nRecent Deprecations:\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":true},"deprecations":[{"attribute":"capabilities.targetedInstanceCreation","replacedBy":"tenantAccount.siteCapabilities","takeActionBy":"2026-10-01T00:00:00Z","notice":"'capabilities.targetedInstanceCreation' is being deprecated in favor of 'tenantAccount.siteCapabilities'. Please take action prior to the specified date"}]}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-current-tenant","description":"Retrieve Tenant entity for current Org.\n\n`capabilities.targetedInstanceCreation` is a deprecated read-only aggregate: it is `true` when all Ready Tenant Account for this Tenant has TargetedInstanceCreation enabled in its configuration to preserve backwards compatibility. Configure the capability per Provider/per Site via PATCH `/tenant/account/{accountId}` using `siteCapabilities`. Disallowing at Provider or Site level would result in no value returned here.\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 for the org.\n\nThe Infrastructure Provider and Tenant are inferred from the org's membership. User must have authorization role with `PROVIDER_ADMIN`, `PROVIDER_VIEWER`, or `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","deprecated":true,"description":"Filter Tenant Accounts by Infrastructure Provider ID. Deprecated: Infrastructure Provider is now inferred from the org's membership."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","description":"Filter Tenant Accounts 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. User must have authorization role with `PROVIDER_ADMIN` suffix. The Infrastructure Provider is inferred from the caller's org; the deprecated `infrastructureProviderId` request body field is optional and, when provided, must match the org's Infrastructure Provider.\n\nInfrastructure Provider can create a Tenant Account by specifying the Tenant's UUID or Tenant's org name. This sets the Tenant Account status to \"Invited\". The Tenant can then view the account information and 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"}],"siteCapabilities":[{"targetedInstanceCreation":true}],"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\nThe Infrastructure Provider and Tenant are inferred from the org's membership. User must have authorization role with `PROVIDER_ADMIN`, `PROVIDER_VIEWER`, or `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","deprecated":true,"description":"Filter Tenant Accounts by Infrastructure Provider ID. Deprecated: Infrastructure Provider is now inferred from the org's membership."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","deprecated":true,"description":"Filter Tenant Accounts by Tenant ID. Deprecated: Tenant is now inferred from the org's membership."},{"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"}],"siteCapabilities":[{"targetedInstanceCreation":true}],"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\nTenant Admins may accept an invitation sent by an Infrastructure Provider by supplying `tenantContactId`.\n\nProvider Admins may replace `siteCapabilities` to configure the Tenant Account default and overrides for specific Sites. When `siteCapabilities` is sent, it must be non-empty, include exactly one entry with empty or omitted `siteIds`, and must not repeat any `siteId` across entries. Requests containing both `tenantContactId` and `siteCapabilities` are rejected with 400.\n\nOrg must have a Tenant entity whose ID matches the `tenantId` of the Tenant Account object when accepting an invite. User must have authorization role with `TENANT_ADMIN` suffix to accept; `PROVIDER_ADMIN` suffix to update `siteCapabilities`. Tenant Admins can only update a Tenant Account that has `Invited` status.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantAccountUpdateRequest"},"examples":{"accept-invite":{"value":{}},"update-site-capabilities":{"value":{"siteCapabilities":[{"siteIds":[],"targetedInstanceCreation":true}]}}}}},"description":"Tenant invite acceptance or Provider Admin site capability update."}},"delete":{"summary":"Delete Tenant Account","operationId":"delete-tenant-account","responses":{"202":{"description":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was accepted"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a Tenant Account by ID.\n\nOrg must have an Infrastructure Provider entity, and the specified Tenant Account must have been created by that 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 parameter may be required for older API versions.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","deprecated":true,"description":"Filter Sites by Infrastructure Provider ID. Deprecated: Infrastructure Provider is now inferred from the org's membership."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","deprecated":true,"description":"Filter Sites by Tenant ID. Deprecated: Tenant is now inferred from the org's membership."},{"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 lifecycle status and health. Requires Provider Admin role."},{"schema":{"type":"boolean"},"in":"query","name":"includeGpuStats","description":"Include a per-Site breakdown of GPU counts grouped by GPU type. 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"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"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","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was accepted"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"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/credential/bmc":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"put":{"summary":"Create Or Update BMC Credential","tags":["BMC Credential"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BMCCredentialRequest"}}}},"responses":{"200":{"description":"BMC credential was created or updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BMCCredential"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"create-or-update-bmc-credential","description":"Create or update a site-wide or per-BMC root credential. Equivalent\nto `nico-admin-cli credential add-bmc`.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix."}},"/v2/org/{org}/nico/credential/uefi":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create UEFI Credential","tags":["UEFI Credential"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UEFICredentialRequest"}}}},"responses":{"201":{"description":"UEFI credential was created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UEFICredential"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"409":{"description":"The selected site-default UEFI credential already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"}}}}},"operationId":"create-uefi-credential","description":"Create a site-default host or DPU UEFI credential. The request fails\nif the selected site-default credential already exists.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix."}},"/v2/org/{org}/nico/measured-boot/trusted-machine":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create Measured Boot Trusted Machine Approval","tags":["Measured Boot Trusted Machine"],"operationId":"create-measured-boot-trusted-machine","description":"Approve a Machine, or all Machines using `*`, for automatic promotion of its next measured-boot report.\n\nOrg must have an Infrastructure Provider entity that owns the Site. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeasuredBootTrustedMachineCreateRequest"}}}},"responses":{"201":{"description":"Measured Boot trusted Machine approval was created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeasuredBootTrustedMachine"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}}},"get":{"summary":"Retrieve All Measured Boot Trusted Machine Approvals","tags":["Measured Boot Trusted Machine"],"operationId":"get-all-measured-boot-trusted-machine","description":"Retrieve all measured-boot trusted Machine approvals for a Site.\n\nOrg must have an Infrastructure Provider entity that owns the Site. 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":"Measured Boot trusted Machine approvals","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MeasuredBootTrustedMachine"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}}}},"/v2/org/{org}/nico/measured-boot/trusted-machine/{id}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"id","in":"path","required":true,"description":"Approval ID or Machine ID, as selected by the selector query parameter"}],"delete":{"summary":"Delete Measured Boot Trusted Machine Approval","tags":["Measured Boot Trusted Machine"],"operationId":"delete-measured-boot-trusted-machine","description":"Delete a measured-boot trusted Machine approval by approval ID or Machine ID.\n\nOrg must have an Infrastructure Provider entity that owns the Site. 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","enum":["ApprovalId","MachineId"]},"name":"selector","in":"query","required":true,"description":"Whether id identifies the approval or the Machine"}],"responses":{"200":{"description":"Deleted measured-boot trusted Machine approval","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeasuredBootTrustedMachine"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}}}},"/v2/org/{org}/nico/measured-boot/trusted-profile":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create Measured Boot Trusted Profile Approval","tags":["Measured Boot Trusted Profile"],"operationId":"create-measured-boot-trusted-profile","description":"Approve a measured-boot system profile for automatic promotion of reports from matching Machines.\n\nOrg must have an Infrastructure Provider entity that owns the Site. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeasuredBootTrustedProfileCreateRequest"}}}},"responses":{"201":{"description":"Measured Boot trusted Profile approval was created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeasuredBootTrustedProfile"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}}},"get":{"summary":"Retrieve All Measured Boot Trusted Profile Approvals","tags":["Measured Boot Trusted Profile"],"operationId":"get-all-measured-boot-trusted-profile","description":"Retrieve all measured-boot trusted Profile approvals for a Site.\n\nOrg must have an Infrastructure Provider entity that owns the Site. 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":"Measured Boot trusted Profile approvals","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MeasuredBootTrustedProfile"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}}}},"/v2/org/{org}/nico/measured-boot/trusted-profile/{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":"Approval ID or Profile ID, as selected by the selector query parameter"}],"delete":{"summary":"Delete Measured Boot Trusted Profile Approval","tags":["Measured Boot Trusted Profile"],"operationId":"delete-measured-boot-trusted-profile","description":"Delete a measured-boot trusted Profile approval by approval ID or Profile ID.\n\nOrg must have an Infrastructure Provider entity that owns the Site. 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","enum":["ApprovalId","ProfileId"]},"name":"selector","in":"query","required":true,"description":"Whether id identifies the approval or the system profile"}],"responses":{"200":{"description":"Deleted measured-boot trusted Profile approval","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeasuredBootTrustedProfile"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}}}},"/v2/org/{org}/nico/credential/rotation":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Rotate Credential","tags":["Credential Rotation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialRotationRequest"}}}},"responses":{"200":{"description":"Credential rotation was staged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialRotationResult"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"rotate-credential","description":"Stage a site-wide credential rotation: publish a new rotate-to secret\nand bump the site-wide target version. Devices converge to the new\nversion asynchronously; poll the status endpoint to observe\nconvergence. Equivalent to `nico-admin-cli credential rotate`.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix."},"get":{"summary":"Get Credential Rotation Status","tags":["Credential Rotation"],"parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site to query."},{"schema":{"type":"string","enum":["BMC","HostUEFI","DPUUEFI","NVOS","LockdownIKM"]},"name":"credentialType","in":"query","required":true,"description":"Credential family to report."},{"schema":{"type":"string"},"name":"deviceMac","in":"query","required":false,"description":"Report only this device's convergence, matched by MAC."}],"responses":{"200":{"description":"Credential rotation status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialRotationStatus"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"description":"No rotation record exists for the requested device","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"}}}}},"operationId":"get-credential-rotation-status","description":"Report convergence of an in-flight or completed site-wide credential\nrotation. When `deviceMac` is set, the counts describe just that device\nand a per-device detail block is returned. Equivalent to\n`nico-admin-cli credential rotation-status`.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix."}},"/v2/org/{org}/nico/site-explorer/endpoint":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Explored Endpoints","tags":["Site Explorer"],"parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site"},{"schema":{"type":"integer"},"name":"pageNumber","in":"query","required":false,"description":"Page number of results returned"},{"schema":{"type":"integer"},"name":"pageSize","in":"query","required":false,"description":"Number of results per page"},{"schema":{"type":"string","enum":["ID_ASC","ID_DESC"],"default":"ID_ASC"},"name":"orderBy","in":"query","required":false,"description":"Order results by endpoint ID"}],"responses":{"200":{"description":"Explored endpoints for the Site","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExploredEndpoint"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\":\"ID_ASC\"}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/GenericHttpError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/GenericHttpError"},"412":{"$ref":"#/components/responses/GenericHttpError"},"500":{"$ref":"#/components/responses/GenericHttpError"},"504":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"get-all-site-explorer-endpoint","description":"Retrieve explored endpoints discovered by Site Explorer for a Site. Use `ID_ASC` or `ID_DESC` to order by endpoint ID; the default is `ID_ASC`.\n\nThe response is paged over Core `FindExploredEndpointIds` followed by\n`FindExploredEndpointsByIds`. Pagination metadata is returned in the\n`X-Pagination` response header.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix."}},"/v2/org/{org}/nico/site-explorer/endpoint/action":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Trigger Site Explorer Endpoint Action","tags":["Site Explorer"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteExplorerEndpointActionRequest"}}}},"responses":{"200":{"description":"The action completed for every selected endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteExplorerEndpointAction"}}}},"400":{"$ref":"#/components/responses/GenericHttpError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/GenericHttpError"},"412":{"$ref":"#/components/responses/GenericHttpError"},"500":{"$ref":"#/components/responses/GenericHttpError"},"504":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"create-site-explorer-endpoint-action","description":"Clear the last exploration error or queue re-exploration for all\nexplored endpoints at a Site or an explicit BMC IP address list.\n\nThe operation calls Core once per endpoint. If a call fails, processing\nstops and endpoints earlier in the list may already have completed.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix."}},"/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\nThe Infrastructure Provider and Tenant 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 Allocations. 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 the 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\nThe Infrastructure Provider and Tenant 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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was accepted"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete an Allocation by ID.\n\nOrg must have an Infrastructure Provider entity, and the specified Allocation must have been created by that 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"}]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"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/{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"}],"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"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"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\nFor an InstanceType resource, `constraintValue` can be incremented at any time, but not decremented if doing so requires decommissioning Tenant resources.\n\nFor an IPBlock resource, `constraintValue` cannot be modified if Tenant resources, e.g., Subnets or VPC Prefixes, reference the block.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllocationConstraintUpdateRequest"},"examples":{"example-1":{"value":{"constraintValue":20}}}}}},"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 parameter may be required for older API versions.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","deprecated":true,"description":"Filter IP Blocks by Infrastructure Provider ID. Deprecated: Infrastructure Provider is now inferred from the org's membership."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","deprecated":true,"description":"Filter IP Blocks by Tenant ID. Deprecated: Tenant is now inferred from the org's membership."},{"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 IP Blocks. 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":"192.168.20.0","prefixLength":24,"protocolVersion":"IPv4","usageStats":{"availableIPs":256,"acquiredIPs":2,"availablePrefixes":["192.168.20.32/27","192.168.20.64/26","192.168.20.128/25"],"availableSmallestPrefixes":56,"acquiredPrefixes":1},"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","deprecated":true,"description":"Filter IP Blocks by Infrastructure Provider ID. Deprecated: Infrastructure Provider is now inferred from the org's membership."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","deprecated":true,"description":"Filter IP Blocks by Tenant ID. Deprecated: Tenant is now inferred from the org's membership."},{"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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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 them.\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"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"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 derived IP Blocks. 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":{"objectId":"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":{"objectId":"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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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":["Pending","Configuring","Requested","Ready","Deleting","Error"]},"in":"query","name":"status","required":false,"description":"Optional filter by peering status. Repeat the parameter to match multiple statuses."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"vpcId","required":false,"description":"Optional filter by VPC ID involved in the peering as either vpc1 or vpc2. Repeat the parameter to match multiple VPCs."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"peerTenantId","required":false,"description":"Optional filter by tenant ID of a VPC involved in the peering. Repeat the parameter to match multiple tenants."},{"schema":{"type":"string","enum":["Vpc1","Vpc2","Site","Tenant"]},"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","Tenant"]},"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 the vpcId query parameter 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 VPC Prefixes. 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":"boolean"},"in":"query","name":"includeUsageStats","description":"When true, each VPC Prefix object includes usage statistics using the same structure as IP Block usage. Prefix and IP usage data is derived by evaluating associated Ethernet interfaces. Each Interface associated with a VPC Prefix consumes a `/31` prefix."},{"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"},{"schema":{"type":"boolean"},"in":"query","name":"includeUsageStats","description":"When true, each VPC Prefix object includes usage statistics using the same structure as IP Block usage.\nPrefix and IP usage data is derived by evaluating associated Ethernet interfaces. Each Interface associated with a VPC Prefix consumes a `/31` prefix."}]},"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","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 the vpcId query parameter 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 Subnets. 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":"boolean"},"in":"query","name":"includeUsageStats","description":"When true, each Subnet object includes usage statistics using the same structure as IP Block usage.\nPrefix and IP usage data is derived by evaluating associated Ethernet interfaces. Each Interface associated with a Subnet consumes a single IP. In addition, one gateway and one broadcast IP address are reserved per Subnet."},{"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","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 one IPv4 IP block or one 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","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"},{"schema":{"type":"boolean"},"in":"query","name":"includeUsageStats","description":"When true, each Subnet object includes usage statistics using the same structure as IP Block usage.\nPrefix and IP usage data is derived by evaluating associated Ethernet interfaces. Each Interface associated with a Subnet consumes a single IP. In addition, one gateway and one broadcast IP address are reserved per Subnet."}]},"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","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 may retrieve Expected Machines across Sites where `TargetedInstanceCreation` is effective. The siteId query parameter is optional and, when provided, further restricts results to that Site.","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":"Expected Machine 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\nAll items in a batch update must provide the same set of fields, except that `bmcIpAddress` may be omitted or set to `null` to preserve that machine's current BMC IP address.\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 authorization role with `PROVIDER_ADMIN` suffix.\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 authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\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 authorization role with `PROVIDER_ADMIN` suffix.\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 authorization role with `PROVIDER_ADMIN` suffix.\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 authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\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 authorization role with `PROVIDER_ADMIN` suffix.\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.\n\n`rackId` is immutable: an update that changes it is rejected with `400` before any database mutation.","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 authorization role with `PROVIDER_ADMIN` suffix.\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","nvosMacAddresses":["00:1A:2B:3C:4D:60","00:1A:2B:3C:4D:61"],"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","nvosMacAddresses":["00:1A:2B:3C:4D:62","00:1A:2B:3C:4D:63"],"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 a Site.\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 and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled and Tenant Account with Machine's Provider. User must have authorization role with `TENANT_ADMIN` suffix.","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":"","model":"SAMSUNG MZ1L21T9HCLS-00A07","capacityMb":0,"minSizeMiB":7680000,"maxSizeMiB":7680000,"pciPatterns":["^/devices/pci.*nvme0$"],"count":4}],"chassis":{"vendor":"Supermicro","model":"SYS-420GP-TNR"}},"created":"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"]},"post":{"summary":"Create SKU","operationId":"create-sku","description":"Create a SKU.\n\nThe Org must have an Infrastructure Provider that owns the Site. The user must have an authorization role with the `PROVIDER_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkuCreateRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sku"}}}},"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":"","model":"SAMSUNG MZ1L21T9HCLS-00A07","capacityMb":0,"minSizeMiB":7680000,"maxSizeMiB":7680000,"pciPatterns":["^/devices/pci.*nvme0$"],"count":4}],"chassis":{"vendor":"Supermicro","model":"SYS-420GP-TNR"}},"created":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["SKU"]},"delete":{"summary":"Delete SKU","operationId":"delete-sku","description":"Delete an unused SKU. The Site is determined from the saved SKU record.\n\nThe Org must have an Infrastructure Provider that owns the SKU's Site. The user must have an authorization role with the `PROVIDER_ADMIN` suffix.","responses":{"204":{"description":"No Content"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["SKU"]},"patch":{"summary":"Update SKU","operationId":"update-sku","description":"Update selected mutable fields on a SKU. The Site is determined from the saved SKU record.\n\nFields omitted from the request retain their current values. If a user updates the components field,\nthe schema version will be updated to the current version (5).\n\nThe Org must have an Infrastructure Provider that owns the SKU's Site. The user must have an authorization role with the `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkuUpdateRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sku"}}}},"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 InfiniBand Partitions. 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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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 NVLink Logical Partitions. 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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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"}],"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"}],"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"}],"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\nThe Infrastructure Provider and Tenant 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 Instance Types. 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 Instance Type 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"}],"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"}],"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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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"}],"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 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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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":{"objectId":"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","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":"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":{"objectId":"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","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-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":{"objectId":"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","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-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","deprecated":true,"description":"Filter by Infrastructure Provider ID. Deprecated: Instances will no longer be filtered by Infrastructure Provider; results are scoped to the org's Tenant. Use the siteId parameter to scope results to a specific Infrastructure Provider's Sites."},{"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 Instances. 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 Network Security Group 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"}],"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"},"429":{"$ref":"#/components/responses/ResourceExhaustedError"}},"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"},"429":{"$ref":"#/components/responses/ResourceExhaustedError"}},"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":{"objectId":"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"}],"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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was accepted"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"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","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"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"429":{"$ref":"#/components/responses/ResourceExhaustedError"}},"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":false,"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":"List Operating Systems visible to the caller.\n\nUser must have an authorization role with either the `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix for the org.\n\n- Provider admin: returns only Operating Systems owned by the org's Infrastructure Provider.\n- Tenant admin: returns Operating Systems owned by the caller's Tenant, plus Provider-owned Operating Systems that are associated with at least one Site the Tenant can access.\n- Dual-role (both Provider and Tenant): returns the union of the Tenant's and the Provider's Operating Systems.","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","TemplatedIpxe"]},"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\nOwnership is derived from the caller's role:\n\n- Tenant admin (`TENANT_ADMIN`): creates a Tenant-owned Operating System of any type (Image, iPXE, or Templated iPXE).\n- Provider admin (`PROVIDER_ADMIN`): may only create Provider-owned Operating Systems of type `Templated iPXE`.\n\nThe `tenantId` field in the request body is deprecated; if provided, it must match the org's Tenant.","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":false,"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":false,"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.\n\nA Tenant admin may also read a Provider-owned Operating System when it is associated with at least one Site the Tenant can access.","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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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 visible to the caller.\n\nInfrastructure Provider callers receive Machines owned by their Provider. Tenant Admin callers receive Machines only from Sites where `TargetedInstanceCreation` is effective. The siteId query parameter is optional and further restricts either result set.\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"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"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\nFor Infrastructure Providers: Org must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled and Tenant Account with Machine's Provider. User must have authorization role with `TENANT_ADMIN` suffix.\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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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}/bmc/reset":{"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"}],"patch":{"summary":"Reset Machine BMC","tags":["BMC Reset"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BMCResetRequest"}}}},"responses":{"202":{"description":"Machine BMC reset request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Machine BMC reset request was accepted"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"reset-machine-bmc","description":"Reset the BMC of a specific Machine. When an Instance is attached to the\nMachine, `acknowledgeAttachedInstance` must be `true`.\n\nIf `useIpmiTool` is `true`, the BMC reset request may be silently\nignored while the BMC is in lockdown mode.\n\nFor Infrastructure Providers: Org must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled and Tenant Account with Machine's Provider. User must have authorization role with `TENANT_ADMIN` suffix."}},"/v2/org/{org}/nico/machine/{machineId}/dpu/reprovision":{"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"}],"patch":{"summary":"Reprovision Machine DPUs","tags":["DPU Reprovision"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DpuReprovisionRequest"}}}},"responses":{"202":{"description":"DPU reprovisioning request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"DPU reprovisioning request was accepted"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"reprovision-machine-dpu","description":"Trigger DPU reprovisioning for a Machine. Before calling this operation,\ncreate a Machine health report containing an alert whose ID is\n`HostUpdateInProgress` and whose classifications include\n`PreventAllocations`. When an Instance is attached to the Machine,\n`acknowledgeAttachedInstance` must be `true`.\n\nFor Infrastructure Providers: Org must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled and Tenant Account with Machine's Provider. User must have authorization role with `TENANT_ADMIN` suffix."}},"/v2/org/{org}/nico/machine/{machineId}/health-report":{"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 all Machine health reports","tags":["Health Report"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MachineHealthReportEntry"}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"get-all-machine-health-report","description":"Get all health reports for a specific Machine.\n\nFor Infrastructure Providers: Org must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled and Tenant Account with Machine's Provider. User must have authorization role with `TENANT_ADMIN` suffix."},"put":{"summary":"Create or update Machine health report","tags":["Health Report"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MachineHealthReportEntryRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MachineHealthReportEntry"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"create-or-update-machine-health-report","description":"Add or update health report override for a specific Machine.\n\nFor Infrastructure Providers: Org must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled and Tenant Account with Machine's Provider. User must have authorization role with `TENANT_ADMIN` suffix."}},"/v2/org/{org}/nico/machine/{machineId}/health-report/{source}":{"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"},{"schema":{"type":"string"},"name":"source","in":"path","required":true,"description":"Health report source"}],"delete":{"summary":"Delete Machine health report","tags":["Health Report"],"responses":{"204":{"description":"Machine health report was successfully removed"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"delete-machine-health-report","description":"Remove a health report override for a specific Machine.\n\nFor Infrastructure Providers: Org must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled and Tenant Account with Machine's Provider. User must have authorization role with `TENANT_ADMIN` suffix."}},"/v2/org/{org}/nico/machine/{machineId}/power":{"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"}],"patch":{"summary":"Machine power control","tags":["Machine"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MachinePowerControlRequest"},"examples":{"turn-on":{"value":{"action":"On"}},"force-restart":{"value":{"action":"ForceRestart"}}}}}},"responses":{"202":{"description":"Machine power control request was accepted. The message is empty unless Core returns a power-manager warning.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":""}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"machine-power-control-machine","description":"Execute power control actions for a specific Machine. When an Instance is\nattached to the Machine, `acknowledgeAttachedInstance` must be `true`.\n\nOrg must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix."}},"/v2/org/{org}/nico/machine/{machineId}/validation/run":{"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 validation runs","tags":["Machine Validation"],"responses":{"200":{"description":"Machine validation runs","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MachineValidationRun"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"get-all-machine-validation-runs","description":"Retrieve validation runs for a specific Machine.\n\nOrg must have an Infrastructure Provider entity that owns the Machine. User must have authorization role with `PROVIDER_ADMIN` suffix."},"post":{"summary":"Create an on-demand Machine validation run","tags":["Machine Validation"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MachineValidationRunCreateRequest"}}}},"responses":{"202":{"description":"On-demand Machine validation request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MachineValidationRun"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"start-machine-validation","description":"Create an on-demand Machine validation run. The Machine must be in a state accepted by NICo Core.\n\nOrg must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix."}},"/v2/org/{org}/nico/machine/{machineId}/validation/result":{"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 validation results","tags":["Machine Validation"],"responses":{"200":{"description":"Machine validation results","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MachineValidationResult"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"get-all-machine-validation-results","description":"Retrieve validation results for a specific Machine.\n\nOrg must have an Infrastructure Provider entity that owns the Machine. User must have authorization role with `PROVIDER_ADMIN` suffix."}},"/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/{machineId}/dpu":{"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 host Machine"}],"get":{"summary":"Retrieve DPU Machines attached to a host Machine","description":"Retrieve DPU Machines attached to the host Machine, including network configuration fields exposed by the REST API. Internal-only and sensitive fields from the Core configuration are omitted.\n\nThe response is built by scheduling a synchronous Temporal `GetDpuMachines` workflow against the Machine's Site for the DPU Machine IDs referenced by the host Machine's interfaces.\n\n**Authorization:**\n\nAccess is restricted to users associated with the Machine's Site. Either of the following grants access:\n\n* The caller's org has an Infrastructure Provider entity that owns the Machine's Site, and the user has authorization role with `PROVIDER_ADMIN` suffix on that org.\n* The caller's org has a Tenant entity with `TargetedInstanceCreation` enabled and an active Tenant Account on the Machine's Site's Infrastructure Provider, and the user has authorization role with `TENANT_ADMIN` suffix on that org.\n","tags":["Machine"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DpuMachine"}},"examples":{"Example 1":{"value":[{"id":"fm100dsg4ekcb4sdi6hkqn0iojhj18okrr8vct64luh8957lfe8e69vme20","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","hostMachineId":"fm200hkq8xncf7tgm9plurt4smono52pqvv2gxt97pyk2398qjk2a73qjf64","dpuAgentVersion":"1.0.0","state":"Ready","labels":{"env":"prod"},"dpuNetworkConfig":{"asn":65001,"vniDevice":"pf0hpf","managedHostConfigVersion":"v1.2.3","useAdminNetwork":true,"instanceNetworkConfigVersion":"v2.0.1","remoteId":"host-machine-123","vpcIsolationBehavior":"VPC_ISOLATION_MUTUAL","statefulAclsEnabled":true,"enableDhcp":false,"isPrimaryDpu":true,"datacenterAsn":65000,"dhcpServers":["192.168.1.1"],"routeServers":["192.168.2.1"],"managedHostConfig":{"loopbackIp":"10.0.0.1"},"tenantInterfaces":[{"functionType":"VIRTUAL_FUNCTION","vlanId":100,"vni":5000,"gateway":"192.168.10.1","ip":"192.168.10.10","interfacePrefix":"eth0","prefix":"192.168.10.0/24","fqdn":"tenant-vm.example.com","vpcVni":6000,"isL2Segment":false}]}}]}}}}},"400":{"$ref":"#/components/responses/GenericHttpError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/GenericHttpError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"get-dpu-machines"}},"/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 parameters should be specified in the correct order. 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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/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-task","description":"Get a Task by UUID.\n\nThe same handler is also mounted at `/v2/org/{org}/nico/rack/task/{id}` for\nbackward compatibility; prefer this path for new clients.\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/Task"},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task"]}},"/v2/org/{org}/nico/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-task","description":"Cancel a Task.\n\nThe same handler is also mounted at `/v2/org/{org}/nico/rack/task/{id}/cancel`\nfor backward compatibility; prefer this path for new clients.\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 authorization role with `PROVIDER_ADMIN` suffix.","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's\nlast known state is returned. Clients should `GET` the task to\nobserve the final state, since cancellation is best-effort and\nthe operation may still be terminating.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Task"},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task"]}},"/v2/org/{org}/nico/task/rule":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create an Operation Rule","operationId":"create-rule","description":"Create a new Operation Rule on the target Site. The rule definition is validated\nserver-side by Flow; on validation failure no state changes (the request acts\nas a dry-run by way of its own validation step).\n\nRules are site-scoped and per (operationType, operationCode) tuple. The response\nechoes the submitted body with the assigned `id`.\n\nOrg must have an Infrastructure Provider entity. User must have authorization\nrole with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRuleRequest"}}}},"responses":{"201":{"description":"Rule was created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationRule"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Rule"]},"get":{"summary":"List Operation Rules","operationId":"list-rules","description":"List Operation Rules on a Site. Filters compose with AND; results are paginated\nand the `X-Pagination` response header reports the total count over the\npost-filter set.\n\nOrg must have an Infrastructure Provider entity. User must have authorization\nrole with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site that owns the rules (rules are site-scoped)."},{"schema":{"type":"string","enum":["PowerControl","FirmwareControl"]},"name":"operationType","in":"query","required":false,"description":"Filter by operation type."},{"schema":{"type":"integer","minimum":1},"name":"pageNumber","in":"query","required":false,"description":"Page number of results returned (1-indexed)."},{"schema":{"type":"integer","minimum":1},"name":"pageSize","in":"query","required":false,"description":"Number of results per page."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OperationRule"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Rule"]}},"/v2/org/{org}/nico/task/rule/{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 Rule"}],"get":{"summary":"Retrieve an Operation Rule","operationId":"get-rule","description":"Get an Operation Rule by UUID.\n\nRules are site-scoped; `siteId` must be the Site that owns the rule. Org must\nhave an Infrastructure Provider entity. User must have authorization role with\n`PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site that owns the rule (rules are site-scoped)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationRule"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Rule"]},"patch":{"summary":"Update an Operation Rule","operationId":"update-rule","description":"Patch the mutable fields of an Operation Rule: `name`, `description`, and\n`ruleDefinition`. Unset fields are left unchanged. The rule definition is\nre-validated server-side; validation failure leaves the rule untouched.\n\n`operationType` and `operationCode` are immutable after creation — create a\nnew rule and delete the old one to change them.\n\nOrg must have an Infrastructure Provider entity. User must have authorization\nrole with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRuleRequest"}}}},"responses":{"204":{"description":"Rule was updated."},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Rule"]},"delete":{"summary":"Delete an Operation Rule","operationId":"delete-rule","description":"Delete an Operation Rule by UUID. Flow rejects deletion of rules that are\nstill associated with a Rack or that are the active default for their\n(operationType, operationCode) tuple; dissociate / un-default first.\n\nRules are site-scoped; `siteId` must be the Site that owns the rule. Org must\nhave an Infrastructure Provider entity. User must have authorization role with\n`PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site that owns the rule (rules are site-scoped)."}],"responses":{"204":{"description":"Rule was deleted."},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Rule"]}},"/v2/org/{org}/nico/task/run":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create a Task Run","operationId":"create-task-run","description":"Create a Task Run: a phased, policy-gated execution of one operation across\nmany Racks. The configuration is validated server-side by Flow; on\nvalidation failure no state changes.\n\nA Task Run executes exactly one operation (currently firmware) over a\ncandidate set of Racks, narrowed by an optional `selector` and divided\ninto phases by an optional `options.phasePolicy`. The response echoes the\nassigned `id`; the Task Run always starts in the `Pending` state. Poll\n`GET /task/run/{id}` for progress.\n\nOrg must have an Infrastructure Provider entity. User must have\nauthorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTaskRunRequest"}}}},"responses":{"201":{"description":"Task Run was created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskRun"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task Run"]},"get":{"summary":"Retrieve all Task Runs","operationId":"get-all-task-run","description":"List Task Runs on a Site. Filters compose with AND; results are paginated\nand the `X-Pagination` response header reports the total count over the\npost-filter set.\n\nOrg must have an Infrastructure Provider entity. User must have\nauthorization 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 Runs (Task Runs are site-scoped)."},{"schema":{"type":"string","enum":["Pending","Running","Paused","Completed","Cancelled","Failed","CompletedWithFailures"]},"name":"status","in":"query","required":false,"description":"Filter by Task Run status."},{"schema":{"type":"string","enum":["PowerControl","FirmwareControl"]},"name":"operationType","in":"query","required":false,"description":"Filter by operation type."},{"schema":{"type":"integer","minimum":1},"name":"pageNumber","in":"query","required":false,"description":"Page number of results returned (1-indexed)."},{"schema":{"type":"integer","minimum":1},"name":"pageSize","in":"query","required":false,"description":"Number of results per page."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TaskRun"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":2}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task Run"]}},"/v2/org/{org}/nico/task/run/{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 Run"}],"get":{"summary":"Retrieve a Task Run","operationId":"get-task-run","description":"Get a Task Run by UUID. Set `includeStats=true` for derived per-phase\noutcome counts (current phase and cumulative run).\n\nTask Runs are site-scoped; `siteId` must be the Site that owns the\nTask Run. Org must have an Infrastructure Provider entity. User must have\nauthorization 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 Run (Task Runs are site-scoped)."},{"schema":{"type":"boolean","default":false},"name":"includeStats","in":"query","required":false,"description":"Include derived per-phase outcome stats on the response."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskRun"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task Run"]}},"/v2/org/{org}/nico/task/run/{id}/target":{"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 Run"}],"get":{"summary":"Retrieve all Task Run Targets","operationId":"get-all-task-run-target","description":"List a Task Run's materialized per-Rack execution targets. Each target\nreferences the Task the Task Run submitted for that Rack via `taskId`\n(null until the target is submitted); drill into execution detail via\n`GET /task/{taskId}`.\n\nFilters compose with AND. Results are paginated; the `X-Pagination`\nresponse header reports the total count over the post-filter set.\n\nTask Runs are site-scoped; `siteId` must be the Site that owns the\nTask Run. Org must have an Infrastructure Provider entity. User must have\nauthorization 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 Run."},{"schema":{"type":"string","enum":["Pending","Blocked","Submitted","Completed","Failed","Terminated","Skipped","Claimed"]},"name":"status","in":"query","required":false,"description":"Filter by target status."},{"schema":{"type":"string","enum":["currentPhase","completedPhases","currentAndCompletedPhases"],"default":"currentPhase"},"name":"phaseScope","in":"query","required":false,"description":"Restrict targets to the current phase, completed phases, or both."},{"schema":{"type":"integer","minimum":1},"name":"pageNumber","in":"query","required":false,"description":"Page number of results returned (1-indexed)."},{"schema":{"type":"integer","minimum":1},"name":"pageSize","in":"query","required":false,"description":"Number of results per page."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TaskRunTarget"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":6}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task Run"]}},"/v2/org/{org}/nico/task/run/{id}/pause":{"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 Run"}],"post":{"summary":"Pause a Task Run","operationId":"pause-task-run","description":"Pause a running Task Run. In-flight target Tasks continue to completion;\nno new targets are claimed until the Task Run is resumed. Pausing an\nalready-paused Task Run is idempotent.\n\nTask Runs are site-scoped; `siteId` must be the Site that owns the\nTask Run. Org must have an Infrastructure Provider entity. User must have\nauthorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskRunSiteRequest"}}}},"responses":{"202":{"description":"Accepted. The pause request was accepted and the Task Run's last\nknown state is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskRun"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task Run"]}},"/v2/org/{org}/nico/task/run/{id}/resume":{"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 Run"}],"post":{"summary":"Resume a Task Run","operationId":"resume-task-run","description":"Resume an operator-paused Task Run. A Task Run paused at a phase gate\n(rather than by an operator) must be advanced with the advance endpoint\ninstead; resume applies only to operator pauses.\n\nTask Runs are site-scoped; `siteId` must be the Site that owns the\nTask Run. Org must have an Infrastructure Provider entity. User must have\nauthorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskRunSiteRequest"}}}},"responses":{"202":{"description":"Accepted. The resume request was accepted and the Task Run's last\nknown state is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskRun"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task Run"]}},"/v2/org/{org}/nico/task/run/{id}/advance":{"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 Run"}],"post":{"summary":"Advance a Task Run to its next phase","operationId":"advance-task-run","description":"Open the next phase of a Task Run that is paused at a phase gate.\nOptionally guard the transition with `expectedPhaseIndex`: when set, the\nphase that would be opened must match, otherwise Flow rejects the advance\nso a stale client cannot open the wrong phase.\n\nTask Runs are site-scoped; `siteId` must be the Site that owns the\nTask Run. Org must have an Infrastructure Provider entity. User must have\nauthorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvanceTaskRunRequest"}}}},"responses":{"202":{"description":"Accepted. The advance request was accepted and the Task Run's last\nknown state is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskRun"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task Run"]}},"/v2/org/{org}/nico/task/run/{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 Run"}],"post":{"summary":"Cancel a Task Run","operationId":"cancel-task-run","description":"Cancel a Task Run. Best-effort cancellation cascades to the current\nphase's in-flight target Tasks; targets not yet claimed are not started.\nCancelling an already-terminal Task Run returns its last known state.\n\nTask Runs are site-scoped; `siteId` must be the Site that owns the\nTask Run. Org must have an Infrastructure Provider entity. User must have\nauthorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelTaskRunRequest"}}}},"responses":{"202":{"description":"Accepted. The cancellation request was accepted and the Task Run's\nlast known state is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskRun"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task Run"]}},"/v2/org/{org}/nico/rack/{id}/task":{"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 Rack"}],"get":{"summary":"Retrieve all Tasks for a Rack","operationId":"get-rack-tasks","description":"List Tasks targeting the specified Rack.\n\nTasks are site-scoped; `siteId` must be the Site that owns the Rack. Org must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nFilters compose with AND: setting `activeOnly=true` restricts the result to tasks that are still in a non-terminal state (`Pending`, `Running`, `Waiting`). Results are paginated; the `X-Pagination` response header reports the total count over the post-filter set.\n\nBy default the `report` field is omitted from each task in the response. Set `includeReport=true` to include it; this is opt-in because report bodies can be several KB and pulling them across the list path persists the full payload in each caller-side workflow record. Single-task `GET /rack/task/{id}` and `POST /rack/task/{id}/cancel` always include the report.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site that owns the Rack."},{"schema":{"type":"boolean","default":false},"name":"activeOnly","in":"query","description":"Restrict results to non-terminal Tasks."},{"schema":{"type":"boolean","default":false},"name":"includeReport","in":"query","description":"Include the per-task execution report on each returned task."},{"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"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Task"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":2}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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\n- `slotId` restricts to trays at that rack slot, requires `rackId` or `rackName`, and composes with the rest of the query via AND","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","format":"int32","minimum":0},"name":"slotId","in":"query","description":"Restrict to trays at this rack slot (matches `position.slotId`). Requires `rackId` or `rackName`. Composes with the rest of the filter via AND."},{"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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)"},{"schema":{"type":"integer","format":"int32","minimum":0},"name":"slotId","in":"query","required":false,"description":"Restrict validation to trays at this rack slot (matches `position.slotId`). Requires `rackId` or `rackName`. Composes with the rest of the filter via AND."}],"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/tray/{id}/task":{"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 Tray"}],"get":{"summary":"Retrieve all Tasks for a Tray","operationId":"get-tray-tasks","description":"List Tasks targeting the specified Tray.\n\nTasks are site-scoped; `siteId` must be the Site that owns the Tray. Org must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nFilters compose with AND: setting `activeOnly=true` restricts the result to tasks that are still in a non-terminal state (`Pending`, `Running`, `Waiting`). Results are paginated; the `X-Pagination` response header reports the total count over the post-filter set.\n\nBy default the `report` field is omitted from each task in the response. Set `includeReport=true` to include it; this is opt-in because report bodies can be several KB and pulling them across the list path persists the full payload in each caller-side workflow record. Single-task `GET /rack/task/{id}` and `POST /rack/task/{id}/cancel` always include the report.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site that owns the Tray."},{"schema":{"type":"boolean","default":false},"name":"activeOnly","in":"query","description":"Restrict results to non-terminal Tasks."},{"schema":{"type":"boolean","default":false},"name":"includeReport","in":"query","description":"Include the per-task execution report on each returned task."},{"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"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Task"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":2}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/ipxe-template":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Get all iPXE templates","description":"Get all iPXE templates propagated from nico-core. Optionally restrict to one or more sites with the siteId query parameter.\n\nThe Infrastructure Provider and Tenant are inferred from the org's membership. User must have authorization role with `PROVIDER_ADMIN`, `PROVIDER_VIEWER`, or `TENANT_ADMIN` suffix.","operationId":"get-all-ipxe-template","tags":["iPXE Template"],"parameters":[{"schema":{"type":"array","items":{"type":"string","format":"uuid"}},"name":"siteId","in":"query","required":false,"description":"Optional site ID(s); may be repeated to restrict results to templates available at any of the sites"},{"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","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/IpxeTemplate"}}}},"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"}}}},"/v2/org/{org}/nico/ipxe-template/{ipxeTemplateId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"ipxeTemplateId","in":"path","required":true,"description":"Stable template ID (UUID from core)"}],"get":{"summary":"Retrieve an iPXE template","description":"Retrieve an iPXE template by its stable core ID. The caller must be authorized for at least one Site at which the template is available.\n\nThe Infrastructure Provider and Tenant are inferred from the org's membership. User must have authorization role with `PROVIDER_ADMIN`, `PROVIDER_VIEWER`, or `TENANT_ADMIN` suffix.","operationId":"get-ipxe-template","tags":["iPXE Template"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IpxeTemplate"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}}}},"/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 Network Security Groups. 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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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 DPU Extension Services. Input will be matched against name, description, and status fields"},{"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 SSH Key Groups. Input will be matched against the 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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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 SSH Keys. Input will be matched against the 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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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"}}}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"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"}}}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"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"}},"/v2/org/{org}/nico/firmware-config/host":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"put":{"summary":"Create or Update Host Firmware Config","tags":["Host Firmware Config"],"operationId":"create-or-update-host-firmware-config","description":"Create or update host firmware config for the org/site. The target Site\nis specified by `siteId` in the request body.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix in the URL `{org}`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostFirmwareConfigCreateOrUpdateRequest"}}}},"responses":{"200":{"description":"Host firmware config replaced/updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostFirmwareConfig"}}}},"201":{"description":"Host firmware config created on first call","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostFirmwareConfig"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while loading the Provider or Site, contacting the Core gRPC API, starting the Host Firmware Config create or update workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"$ref":"#/components/responses/HostFirmwareConfigCoreUnavailable"}}},"delete":{"summary":"Delete Host Firmware Config","tags":["Host Firmware Config"],"operationId":"delete-host-firmware-config","description":"Delete host firmware config for the org/site. The target Site is\nspecified by `siteId` in the request body; the configuration is\nkeyed by `(vendor, model)`.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix in the URL `{org}`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostFirmwareConfigDeleteRequest"}}}},"responses":{"204":{"description":"Host firmware config deleted"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while loading the Provider or Site, contacting the Core gRPC API, starting the Host Firmware Config delete workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"$ref":"#/components/responses/HostFirmwareConfigCoreUnavailable"}}}},"/v2/org/{org}/nico/site/{siteID}/tenant-identity/config":{"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"}],"put":{"summary":"Create or Update Tenant Identity Configuration","tags":["Tenant Identity"],"operationId":"create-or-update-tenant-identity-config","description":"Create or update tenant identity (JWT-SVID) configuration for the org/site.\n\nUser must have authorization role with `TENANT_ADMIN` suffix in the URL `{org}`.\n\nOn first call the Core gRPC API generates a new ES256 signing\nkeypair; on subsequent calls the existing keypair is reused unless\n`rotateKey: true` is supplied. Returns `201 Created` on first\ncall, `200 OK` on subsequent updates. See the Tenant Identity tag\ndescription for upsert semantics and the `enabled` vs DELETE\ndistinction.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityConfigCreateOrUpdateRequest"}}}},"responses":{"200":{"description":"Tenant identity configuration replaced/updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityConfig"}}}},"201":{"description":"Tenant identity configuration created on first call","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityConfig"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while loading the Tenant or Site, contacting the Core gRPC API, starting the configuration workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"$ref":"#/components/responses/TenantIdentityCoreUnavailable"}}},"get":{"summary":"Retrieve Tenant Identity Configuration for current Org","tags":["Tenant Identity"],"operationId":"get-tenant-identity-config","description":"Retrieve the tenant identity configuration and signing key metadata.\n\nUser must have authorization role with `TENANT_ADMIN` suffix in the URL `{org}`.\n\nThe response reflects the stored configuration. Fields you\nomitted on PUT may be filled in by Core: `allowedAudiences`\ndefaults to `[defaultAudience]`, and `subjectPrefix` defaults\nto the issuer's trust domain. `signingKeys` lists one entry\nnormally, or two during a key-rotation overlap.","responses":{"200":{"description":"Tenant identity configuration retrieved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityConfig"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while loading the Tenant or Site, contacting the Core gRPC API, starting the get workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"$ref":"#/components/responses/TenantIdentityCoreUnavailable"}}},"delete":{"summary":"Delete Tenant Identity Configuration","tags":["Tenant Identity"],"operationId":"delete-tenant-identity-config","description":"Delete the tenant identity configuration and destroy the per-org signing keypair.\n\nUser must have authorization role with `TENANT_ADMIN` suffix in the URL `{org}`.\n\nAfter DELETE, JWKS and OIDC discovery for this org begin returning\n`404`; previously-issued JWT-SVIDs become unverifiable once\nconsumers refresh their JWKS cache. To pause issuance without\ndestroying signing keys, PUT with `enabled: false` instead.","responses":{"204":{"description":"Tenant identity configuration deleted"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while loading the Tenant or Site, contacting the Core gRPC API, starting the delete workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"$ref":"#/components/responses/TenantIdentityCoreUnavailable"}}}},"/v2/org/{org}/nico/site/{siteID}/tenant-identity/token-delegation":{"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"}],"put":{"summary":"Create or Update Token Delegation","tags":["Tenant Identity"],"operationId":"create-or-update-tenant-identity-token-delegation","description":"Register an RFC 8693 token exchange callback for the tenant. When\nconfigured, the Core gRPC API issues a short-lived intermediate\nJWT-SVID to the tenant's exchange server instead of signing\nworkload tokens directly.\n\nUser must have authorization role with `TENANT_ADMIN` suffix in the URL `{org}`.\n\nRequires a pre-existing `/tenant-identity/config` on this org/site\n(returns `404` otherwise). Because PUT is full-replace, omitting\n`clientSecretBasic` on an update clears any stored credentials\nand switches the org back to no-auth; re-supply `clientId` /\n`clientSecret` on every PUT to keep basic auth (the raw secret\nis never returned by GET). Returns `201 Created` on first call,\n`200 OK` on subsequent updates.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityTokenDelegationCreateOrUpdateRequest"}}}},"responses":{"200":{"description":"Token delegation replaced/updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityTokenDelegation"}}}},"201":{"description":"Token delegation created on first call","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityTokenDelegation"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"description":"Returned when the org has no tenant identity configuration on\nthis site yet; create it via PUT `/tenant-identity/config` before\nregistering a token-delegation callback.","$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while loading the Tenant or Site, contacting the Core gRPC API, starting the token-delegation update workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"$ref":"#/components/responses/TenantIdentityCoreUnavailable"}}},"get":{"summary":"Retrieve Token Delegation for current Org","tags":["Tenant Identity"],"operationId":"get-tenant-identity-token-delegation","description":"Retrieve the registered token exchange callback for the tenant.\n\nUser must have authorization role with `TENANT_ADMIN` suffix in the URL `{org}`.\n\nThe raw `clientSecret` is never returned; only its SHA-256 hash.","responses":{"200":{"description":"Token delegation retrieved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityTokenDelegation"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while loading the Tenant or Site, contacting the Core gRPC API, starting the token-delegation get workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"$ref":"#/components/responses/TenantIdentityCoreUnavailable"}}},"delete":{"summary":"Delete Token Delegation","tags":["Tenant Identity"],"operationId":"delete-tenant-identity-token-delegation","description":"Delete the RFC 8693 token exchange callback for the tenant.\n\nUser must have authorization role with `TENANT_ADMIN` suffix in the URL `{org}`.\n\nSubsequent Instance Metadata Service requests for the tenant revert to direct (non-delegated) signing by the Core gRPC API.","responses":{"204":{"description":"Token delegation deleted"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while loading the Tenant or Site, contacting the Core gRPC API, starting the token-delegation delete workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"$ref":"#/components/responses/TenantIdentityCoreUnavailable"}}}},"/v2/org/{org}/nico/site/{siteID}/.well-known/jwks.json":{"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 OIDC JWKS for current Org","tags":["Tenant Identity"],"operationId":"get-jwks","description":"Public RFC 7517 JSON Web Key Set for JWT-SVID signature verification (`use: sig`). No authentication required.\n\nNICo currently issues `ES256` signatures over `P-256` keys.\nReturns `404 Not Found` when no identity configuration exists\nfor this org/site, and `502 Bad Gateway` when the Core gRPC API\nreturns a malformed body. See the Tenant Identity tag\ndescription for consumer guidance during key rotation.","security":[],"responses":{"200":{"description":"JWKS document.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityJWKS"}}}},"404":{"description":"No identity configuration exists for this org/site.","$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while resolving the Site or Tenant, retrieving the Temporal client, starting the JWKS workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"502":{"description":"Core gRPC API returned a malformed JWKS body that could not be parsed as a keyset.","$ref":"#/components/responses/GenericHttpError"},"503":{"description":"Core gRPC API is unavailable.","$ref":"#/components/responses/GenericHttpError"}}}},"/v2/org/{org}/nico/site/{siteID}/.well-known/openid-configuration":{"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 OpenID Configuration for current Org","tags":["Tenant Identity"],"operationId":"get-openid-configuration","description":"Public OIDC discovery document pointing at the JWKS URIs. No authentication required.\n\n`id_token_signing_alg_values_supported` is intentionally empty\nbecause NICo issues bearer access JWTs, not OIDC `id_token`s;\nstrict OIDC client libraries that require a non-empty algorithm\nlist will reject this document. Use the JWKS endpoint directly\nfor signature verification. Returns `404` when no identity\nmaterial exists for this org/site.","security":[],"responses":{"200":{"description":"OpenID discovery document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenIDConfiguration"}}}},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while resolving the Site or Tenant, retrieving the Temporal client, starting the OpenID Configuration workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"description":"Core gRPC API is unavailable.","$ref":"#/components/responses/GenericHttpError"}}}},"/v2/org/{org}/nico/site/{siteID}/.well-known/spiffe/jwks.json":{"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 SPIFFE JWKS for current Org","tags":["Tenant Identity"],"operationId":"get-spiffe-jwks","description":"SPIFFE trust-domain JWKS — same key material as the OIDC JWKS but with `use: jwt-svid` for SPIFFE-native verifiers. No authentication required.\n\nNot-configured and malformed-body behavior matches the OIDC JWKS endpoint.","security":[],"responses":{"200":{"description":"SPIFFE JWKS document.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityJWKS"}}}},"404":{"description":"No identity configuration exists for this org/site.","$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while resolving the Site or Tenant, retrieving the Temporal client, starting the SPIFFE JWKS workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"502":{"description":"Core gRPC API returned a malformed SPIFFE JWKS body that could not be parsed as a keyset.","$ref":"#/components/responses/GenericHttpError"},"503":{"description":"Core gRPC API is unavailable.","$ref":"#/components/responses/GenericHttpError"}}}}},"components":{"schemas":{"MeasuredBootTrustedMachineCreateRequest":{"type":"object","title":"MeasuredBootTrustedMachineCreateRequest","description":"Request to approve a Machine for automatic promotion of measured-boot reports.","required":["siteId","machineId","approvalType"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the approval applies."},"machineId":{"type":"string","description":"Machine UUID, or `*` to approve all Machines at the Site."},"approvalType":{"type":"string","enum":["Oneshot","Persist"],"description":"Whether the approval is consumed once or persists for future reports."},"pcrRegisters":{"type":"string","description":"Optional comma-separated PCR register selector. All registers are used when omitted."},"comments":{"type":"string","description":"Optional operator comments about the approval."}}},"MeasuredBootTrustedMachine":{"type":"object","title":"MeasuredBootTrustedMachine","description":"A measured-boot trusted Machine approval.","required":["approvalId","machineId","approvalType","pcrRegisters","comments","created"],"properties":{"approvalId":{"type":"string","format":"uuid","description":"Unique approval ID."},"machineId":{"type":"string","description":"Machine UUID, or `*` when the approval applies to all Machines."},"approvalType":{"type":"string","enum":["Oneshot","Persist"],"description":"Whether the approval is consumed once or persists for future reports."},"pcrRegisters":{"type":"string","description":"Optional comma-separated PCR register selector."},"comments":{"type":"string","description":"Optional operator comments about the approval."},"created":{"type":["string","null"],"format":"date-time","description":"Time when the approval was created, or null when Core did not return a timestamp."}}},"MeasuredBootTrustedProfileCreateRequest":{"type":"object","title":"MeasuredBootTrustedProfileCreateRequest","description":"Request to approve a system profile for automatic promotion of measured-boot reports.","required":["siteId","profileId","approvalType"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the approval applies."},"profileId":{"type":"string","format":"uuid","description":"ID of the measured-boot system profile."},"approvalType":{"type":"string","enum":["Oneshot","Persist"],"description":"Whether the approval is consumed once or persists for future reports."},"pcrRegisters":{"type":"string","description":"Optional comma-separated PCR register selector. All registers are used when omitted."},"comments":{"type":"string","description":"Optional operator comments about the approval."}}},"MeasuredBootTrustedProfile":{"type":"object","title":"MeasuredBootTrustedProfile","description":"A measured-boot trusted system profile approval.","required":["approvalId","profileId","approvalType","pcrRegisters","comments","created"],"properties":{"approvalId":{"type":"string","format":"uuid","description":"Unique approval ID."},"profileId":{"type":"string","format":"uuid","description":"ID of the measured-boot system profile."},"approvalType":{"type":"string","enum":["Oneshot","Persist"],"description":"Whether the approval is consumed once or persists for future reports."},"pcrRegisters":{"type":"string","description":"Optional comma-separated PCR register selector."},"comments":{"type":"string","description":"Optional operator comments about the approval."},"created":{"type":["string","null"],"format":"date-time","description":"Time when the approval was created, or null when Core did not return a timestamp."}}},"BMCCredentialRequest":{"type":"object","title":"BMCCredentialRequest","description":"Request to create or update a BMC credential.","required":["siteId","kind","password"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the credential is stored."},"kind":{"type":"string","description":"Which BMC credential to store.","enum":["SiteWideRoot","BMCRoot"]},"password":{"type":"string","minLength":1,"description":"Credential password."},"username":{"type":"string","description":"Optional username; Core defaults to \"root\" for BMCRoot when omitted."},"macAddress":{"type":"string","description":"BMC MAC address. Required for kind BMCRoot, ignored for SiteWideRoot."}}},"BMCCredential":{"type":"object","title":"BMCCredential","description":"BMC credential metadata returned after create or update. Password is never returned.","required":["siteId","kind"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the credential is stored."},"kind":{"type":"string","description":"Which BMC credential was stored.","enum":["SiteWideRoot","BMCRoot"]},"username":{"type":"string","description":"Optional username; Core defaults to \"root\" for BMCRoot when omitted."},"macAddress":{"type":"string","description":"BMC MAC address. Required for kind BMCRoot, ignored for SiteWideRoot."}}},"UEFICredentialRequest":{"type":"object","title":"UEFICredentialRequest","description":"Request to create a site-default UEFI credential.","required":["siteId","kind","password"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the credential is stored."},"kind":{"type":"string","description":"Which site-default UEFI credential to create.","enum":["Host","DPU"]},"password":{"type":"string","minLength":1,"description":"Credential password."}}},"UEFICredential":{"type":"object","title":"UEFICredential","description":"UEFI credential metadata returned after creation. The password is never returned.","required":["siteId","kind"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the credential is stored."},"kind":{"type":"string","description":"Which site-default UEFI credential was created.","enum":["Host","DPU"]}}},"CredentialRotationRequest":{"type":"object","title":"CredentialRotationRequest","description":"Request to stage a site-wide credential rotation.","required":["siteId","credentialType"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site whose credential family is rotated."},"credentialType":{"type":"string","description":"Credential family to rotate.","enum":["BMC","HostUEFI","DPUUEFI","NVOS","LockdownIKM"]},"password":{"type":"string","minLength":1,"description":"Explicit rotate-to password. When omitted, a strong password is auto-generated. Never returned."},"reason":{"type":"string","description":"Free-form operator note recorded with the rotation. Must not contain secrets."}}},"CredentialRotationResult":{"type":"object","title":"CredentialRotationResult","description":"Result returned when a credential rotation is staged. The password is never returned.","required":["credentialType","targetVersion"],"properties":{"credentialType":{"type":"string","description":"Credential family that was rotated.","enum":["BMC","HostUEFI","DPUUEFI","NVOS","LockdownIKM"]},"targetVersion":{"type":"integer","format":"int64","description":"Newly published site-wide target version that devices converge to."},"started":{"type":["string","null"],"format":"date-time","description":"When the rotation was staged."}}},"CredentialRotationStatus":{"type":"object","title":"CredentialRotationStatus","description":"Convergence status of an in-flight or completed site-wide credential rotation.","required":["targetVersion","converged","pending","quarantined","complete"],"properties":{"targetVersion":{"type":"integer","format":"int64","description":"Current site-wide target version for this family."},"converged":{"type":"integer","format":"int64","description":"Number of devices at or beyond the target version."},"pending":{"type":"integer","format":"int64","description":"Number of devices not yet converged and eligible to rotate."},"quarantined":{"type":"integer","format":"int64","description":"Number of devices currently in a rotation backoff window."},"quarantinedDeviceMacs":{"type":["array","null"],"items":{"type":"string"},"description":"MAC addresses of the quarantined devices."},"started":{"type":["string","null"],"format":"date-time","description":"When the current target version was staged."},"complete":{"type":"boolean","description":"True only when every device in the queried set has reached the target with none pending and none quarantined."},"device":{"$ref":"#/components/schemas/DeviceCredentialRotationStatus"}}},"DeviceCredentialRotationStatus":{"type":"object","title":"DeviceCredentialRotationStatus","description":"Per-device convergence detail, returned only for a MAC-targeted status query.","required":["deviceMac","converged","quarantined","rotateAttempts"],"properties":{"deviceMac":{"type":"string","description":"The device this status describes."},"currentVersion":{"type":["integer","null"],"format":"int64","description":"Credential version live on the hardware. Null when not yet established."},"rotatingToVersion":{"type":["integer","null"],"format":"int64","description":"Set while a rotation is mid-flight on this device."},"converged":{"type":"boolean","description":"True once the current version reaches the site-wide target."},"quarantined":{"type":"boolean","description":"True while the device is in a rotation backoff window."},"quarantinedUntil":{"type":["string","null"],"format":"date-time","description":"When the current backoff window expires; set only while quarantined."},"rotateAttempts":{"type":"integer","format":"int64","description":"Number of rotation attempts recorded for this device."},"lastAttempted":{"type":["string","null"],"format":"date-time","description":"When the last rotation attempt ran; null if none."},"lastError":{"type":["string","null"],"description":"Redacted last-error string for observability; never a secret."}}},"SiteExplorerEndpointActionRequest":{"type":"object","title":"SiteExplorerEndpointActionRequest","description":"Request to trigger a Site Explorer action for explored endpoints.","required":["siteId","action","target"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site whose explored endpoints are targeted."},"action":{"type":"string","description":"Site Explorer endpoint action to trigger.","enum":["ClearError","ReExplore"]},"target":{"type":"string","description":"Endpoint set to target.","enum":["All","EndpointIds"]},"endpointIds":{"type":"array","description":"BMC IP addresses to target when target is EndpointIds.","items":{"type":"string"}}}},"SiteExplorerEndpointAction":{"type":"object","title":"SiteExplorerEndpointAction","description":"Completed Site Explorer endpoint action.","required":["siteId","action","target","endpointIds"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site whose explored endpoints were targeted."},"action":{"type":"string","description":"Site Explorer endpoint action that completed.","enum":["ClearError","ReExplore"]},"target":{"type":"string","description":"Endpoint set that was selected.","enum":["All","EndpointIds"]},"endpointIds":{"type":"array","description":"BMC IP addresses for which the action completed.","items":{"type":"string"}}}},"ExploredEndpoint":{"type":"object","title":"ExploredEndpoint","description":"An endpoint discovered and tracked by Site Explorer.","required":["address","reportVersion","explorationRequested","preingestionState","lastRedfishBmcReset","lastIpmitoolBmcReset","lastRedfishReboot","lastRedfishPowercycle","pauseRemediation"],"properties":{"address":{"type":"string","description":"BMC IP address used as the explored endpoint ID."},"report":{"$ref":"#/components/schemas/EndpointExplorationReport"},"reportVersion":{"type":"string","description":"Version of the exploration report; increases when the report is updated."},"explorationRequested":{"type":"boolean","description":"Whether the endpoint will be explored in the next Site Explorer run."},"preingestionState":{"type":"string","description":"Current preingestion state for the endpoint."},"lastRedfishBmcReset":{"type":"string","description":"Last BMC Redfish reset time."},"lastIpmitoolBmcReset":{"type":"string","description":"Last BMC IPMI tool reset time."},"lastRedfishReboot":{"type":"string","description":"Last BMC Redfish reboot time."},"lastRedfishPowercycle":{"type":"string","description":"Last BMC Redfish power-cycle time."},"pauseRemediation":{"type":"boolean","description":"When true, Site Explorer will not take remediation actions for Redfish errors."}}},"EndpointExplorationReport":{"type":"object","title":"EndpointExplorationReport","description":"Data gathered about an endpoint during site exploration.","required":["endpointType"],"properties":{"endpointType":{"type":"string","description":"Type of the explored endpoint."},"lastExplorationError":{"type":["string","null"],"description":"Last exploration error serialized as JSON, when present."},"machineId":{"type":["string","null"],"format":"uuid","description":"Machine ID derived for the endpoint when available."},"lastExplorationLatency":{"type":["string","null"],"description":"Go duration string for the last exploration latency (for example `1.5s`)."},"vendor":{"type":["string","null"],"description":"Vendor reported by Redfish."},"managers":{"type":"array","items":{"$ref":"#/components/schemas/ExploredManager"}},"systems":{"type":"array","items":{"$ref":"#/components/schemas/ExploredComputerSystem"}},"chassis":{"type":"array","items":{"$ref":"#/components/schemas/ExploredChassis"}},"service":{"type":"array","items":{"$ref":"#/components/schemas/ExploredService"}},"machineSetupStatus":{"$ref":"#/components/schemas/ExploredMachineSetupStatus"},"secureBootStatus":{"$ref":"#/components/schemas/ExploredSecureBootStatus"},"lockdownStatus":{"$ref":"#/components/schemas/ExploredLockdownStatus"},"firmwareVersions":{"type":"object","additionalProperties":{"type":"string"},"description":"Parsed firmware component versions keyed by component name."},"lastExplorationErrorSchema":{"$ref":"#/components/schemas/OperatorErrorSchema"}}},"OperatorErrorSchema":{"type":"object","title":"OperatorErrorSchema","description":"Structured exploration error for operator tooling.","required":["errorCode","text"],"properties":{"errorCode":{"type":"string","description":"Stable identifier for alerting and log filtering."},"mitigation":{"type":["string","null"],"description":"Suggested operator action when known."},"text":{"type":"string","description":"Human-readable problem description."}}},"ExploredManager":{"type":"object","title":"ExploredManager","description":"Redfish Manager reported during exploration.","required":["id"],"properties":{"id":{"type":"string"},"ethernetInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/ExploredEthernetInterface"}}}},"ExploredComputerSystem":{"type":"object","title":"ExploredComputerSystem","description":"Redfish ComputerSystem reported during exploration.","required":["id","powerState"],"properties":{"id":{"type":"string"},"manufacturer":{"type":["string","null"]},"model":{"type":["string","null"]},"serialNumber":{"type":["string","null"]},"attributes":{"$ref":"#/components/schemas/ExploredComputerSystemAttributes"},"ethernetInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/ExploredEthernetInterface"}},"pcieDevices":{"type":"array","items":{"$ref":"#/components/schemas/ExploredPCIeDevice"}},"powerState":{"type":"string","enum":["On","Off","PoweringOff","PoweringOn","Paused","Unknown","Hibernating","Sleeping"]},"bootOrder":{"$ref":"#/components/schemas/ExploredBootOrder"}}},"ExploredComputerSystemAttributes":{"type":"object","title":"ExploredComputerSystemAttributes","description":"ComputerSystem attributes from Redfish.","properties":{"nicMode":{"type":["string","null"],"enum":["Dpu","Nic","Unknown",null]}}},"ExploredEthernetInterface":{"type":"object","title":"ExploredEthernetInterface","description":"Redfish EthernetInterface reported during exploration.","properties":{"id":{"type":["string","null"]},"description":{"type":["string","null"]},"interfaceEnabled":{"type":["boolean","null"]},"macAddress":{"type":["string","null"]},"linkStatus":{"type":["string","null"]}}},"ExploredChassis":{"type":"object","title":"ExploredChassis","description":"Redfish Chassis reported during exploration.","required":["id"],"properties":{"id":{"type":"string"},"networkAdapters":{"type":"array","items":{"$ref":"#/components/schemas/ExploredNetworkAdapter"}},"manufacturer":{"type":["string","null"]},"model":{"type":["string","null"]},"partNumber":{"type":["string","null"]},"serialNumber":{"type":["string","null"]}}},"ExploredNetworkAdapter":{"type":"object","title":"ExploredNetworkAdapter","description":"Redfish NetworkAdapter reported during exploration.","required":["id"],"properties":{"id":{"type":"string"},"manufacturer":{"type":["string","null"]},"model":{"type":["string","null"]},"partNumber":{"type":["string","null"]},"serialNumber":{"type":["string","null"]}}},"ExploredService":{"type":"object","title":"ExploredService","description":"Redfish UpdateService reported during exploration.","required":["id"],"properties":{"id":{"type":"string"},"inventories":{"type":"array","items":{"$ref":"#/components/schemas/ExploredInventory"}}}},"ExploredInventory":{"type":"object","title":"ExploredInventory","description":"Firmware inventory entry from a Redfish UpdateService.","required":["id"],"properties":{"id":{"type":"string"},"description":{"type":["string","null"]},"version":{"type":["string","null"]},"releaseDate":{"type":["string","null"]}}},"ExploredMachineSetupStatus":{"type":"object","title":"ExploredMachineSetupStatus","description":"Result of a Redfish machine-setup check.","required":["isDone"],"properties":{"isDone":{"type":"boolean"},"diffs":{"type":"array","items":{"$ref":"#/components/schemas/ExploredMachineSetupDiff"}},"evaluatedBootInterface":{"$ref":"#/components/schemas/ExploredMachineBootInterfaceTarget"}}},"ExploredMachineBootInterfaceTarget":{"type":"object","title":"ExploredMachineBootInterfaceTarget","description":"Boot-interface target assessed during exploration.","properties":{"pair":{"$ref":"#/components/schemas/ExploredMachineBootInterfacePair"},"macOnly":{"type":["string","null"]}}},"ExploredMachineBootInterfacePair":{"type":"object","title":"ExploredMachineBootInterfacePair","description":"MAC and Redfish EthernetInterface.Id pair.","required":["macAddress","interfaceId"],"properties":{"macAddress":{"type":"string"},"interfaceId":{"type":"string"}}},"ExploredMachineSetupDiff":{"type":"object","title":"ExploredMachineSetupDiff","description":"One expected-vs-actual machine-setup difference.","required":["key","expected","actual"],"properties":{"key":{"type":"string"},"expected":{"type":"string"},"actual":{"type":"string"}}},"ExploredPCIeDevice":{"type":"object","title":"ExploredPCIeDevice","description":"Redfish PCIe device reported during exploration.","properties":{"description":{"type":["string","null"]},"firmwareVersion":{"type":["string","null"]},"gpuVendor":{"type":["string","null"]},"id":{"type":["string","null"]},"manufacturer":{"type":["string","null"]},"name":{"type":["string","null"]},"partNumber":{"type":["string","null"]},"serialNumber":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/ExploredSystemStatus"}}},"ExploredSystemStatus":{"type":"object","title":"ExploredSystemStatus","description":"Redfish health and state status.","required":["state"],"properties":{"health":{"type":["string","null"]},"healthRollup":{"type":["string","null"]},"state":{"type":"string"}}},"ExploredBootOrder":{"type":"object","title":"ExploredBootOrder","description":"Redfish boot order list.","properties":{"bootOrder":{"type":"array","items":{"$ref":"#/components/schemas/ExploredBootOption"}}}},"ExploredBootOption":{"type":"object","title":"ExploredBootOption","description":"One Redfish boot option.","required":["displayName","id"],"properties":{"displayName":{"type":"string"},"id":{"type":"string"},"bootOptionEnabled":{"type":["boolean","null"]},"uefiDevicePath":{"type":["string","null"]}}},"ExploredSecureBootStatus":{"type":"object","title":"ExploredSecureBootStatus","description":"Redfish secure-boot status.","required":["isEnabled"],"properties":{"isEnabled":{"type":"boolean"}}},"ExploredLockdownStatus":{"type":"object","title":"ExploredLockdownStatus","description":"Redfish lockdown status.","required":["status","message"],"properties":{"status":{"type":"string","enum":["Enabled","Partial","Disabled","Unknown"]},"message":{"type":"string"}}},"BMCResetRequest":{"type":"object","title":"BMCResetRequest","description":"Request to reset a Machine BMC","properties":{"useIpmiTool":{"type":"boolean","default":false,"description":"Reset the BMC via ipmitool instead of Redfish. The request may be silently ignored while the BMC is in lockdown mode."},"acknowledgeAttachedInstance":{"type":"boolean","description":"Acknowledges that an Instance is currently attached to the Machine and this action may disrupt Tenant workload on the Instance."}},"examples":[{"useIpmiTool":true}]},"DpuReprovisionRequest":{"type":"object","title":"DpuReprovisionRequest","description":"Request to trigger DPU reprovisioning for a Machine","required":["mode"],"properties":{"mode":{"type":"string","description":"Use `Set` to start reprovisioning, `Clear` to remove a pending request, or `Restart` to restart DPUs that already have a request. Restart accepts a host Machine ID only.","enum":["Set","Clear","Restart"]},"updateFirmware":{"type":"boolean","default":false,"deprecated":true,"description":"Deprecated compatibility field. Firmware is always verified and updated during reprovisioning."},"acknowledgeAttachedInstance":{"type":"boolean","description":"Acknowledges that an Instance is currently attached to the Machine and this action may disrupt Tenant workload on the Instance."}},"examples":[{"mode":"Set","updateFirmware":false}]},"MachineHealthReportEntry":{"type":"object","title":"MachineHealthReportEntry","description":"Machine health report entry","required":["source","mode"],"properties":{"source":{"type":"string","description":"Health report source."},"triggeredBy":{"type":"string","description":"Person or system that triggered this health report."},"observedAt":{"type":"string","format":"date-time","description":"Date/time when the health report was observed."},"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."},"mode":{"type":"string","description":"How this health report was updated","enum":["Merge","Replace"]}},"examples":[{"source":"maintenance.dpu-reprovision","triggeredBy":"operator","observedAt":"2026-06-24T12:00:00Z","mode":"Merge","alerts":[{"id":"HostUpdateInProgress","message":"DPU reprovisioning in progress","classifications":["PreventAllocations"]}]}]},"MachineHealthReportEntryRequest":{"type":"object","title":"MachineHealthReportEntryRequest","description":"Request to add or update a Machine health report override.","required":["source","mode"],"properties":{"source":{"type":"string","description":"Health report source."},"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."},"mode":{"type":"string","description":"How updates to this health report should be handled","enum":["Merge","Replace"]}},"examples":[{"source":"maintenance.dpu-reprovision","mode":"Merge","alerts":[{"id":"HostUpdateInProgress","message":"DPU reprovisioning in progress","classifications":["PreventAllocations"]}]}]},"HostFirmwareArtifact":{"type":"object","title":"HostFirmwareArtifact","description":"Location of a firmware artifact used during host firmware updates.","required":["url"],"properties":{"url":{"type":"string","minLength":1,"description":"URL from which the firmware artifact can be downloaded."},"sha256":{"type":"string","description":"Optional SHA-256 digest of the artifact, in lowercase hex."}},"example":{"url":"https://firmware.example.invalid/28.47.2682/fw.bin","sha256":"a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"}},"HostFirmwareVersionConfig":{"type":"object","title":"HostFirmwareVersionConfig","description":"One known firmware version for a host firmware component.","required":["version","artifacts"],"properties":{"version":{"type":"string","minLength":1,"description":"Firmware version string reported by inventory and stored in Core."},"default":{"type":"boolean","default":false,"description":"When `true`, marks this version as the default target for the component."},"artifacts":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/HostFirmwareArtifact"},"description":"Artifact locations used to install this firmware version."},"installOnlySpecified":{"type":"boolean","default":false,"description":"When `true`, install only the artifacts explicitly listed for this version."},"powerDrainsNeeded":{"type":"integer","minimum":0,"description":"Optional number of power drains required after installing this version."},"preUpdateResets":{"type":"boolean","default":false,"description":"When `true`, perform pre-update resets before installing this version."},"preingestionExclusiveConfig":{"type":"boolean","description":"Optional. When `true`, this firmware version applies only during BMC\npre-ingestion. Omitted on update preserves the stored value; set to\n`false` to clear a previously stored value."}},"example":{"version":"28.47.2682","default":true,"artifacts":[{"url":"https://firmware.example.invalid/28.47.2682/fw.bin","sha256":"a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"}],"installOnlySpecified":false,"preUpdateResets":false,"preingestionExclusiveConfig":false}},"HostFirmwareComponentConfig":{"type":"object","title":"HostFirmwareComponentConfig","description":"One component entry in a host firmware config upsert request.","required":["type","firmware"],"properties":{"type":{"$ref":"#/components/schemas/HostFirmwareComponentType"},"firmware":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/HostFirmwareVersionConfig"},"description":"Known firmware versions for this component. Versions are merged by version string on update."},"preingestUpgradeWhenBelow":{"type":"string","minLength":1,"description":"Optional minimum firmware version required before BMC pre-ingestion can\ncomplete. Omitted on update preserves the stored value."}}},"HostFirmwareComponent":{"type":"object","title":"HostFirmwareComponent","description":"One component entry in a stored host firmware config response.","required":["type","firmware"],"properties":{"type":{"$ref":"#/components/schemas/HostFirmwareComponentType"},"currentVersionDetectionRegEx":{"type":"string","readOnly":true,"description":"Inventory regex Core uses to match reported versions for this component."},"preingestUpgradeWhenBelow":{"type":"string","readOnly":true,"description":"Minimum firmware version required before BMC pre-ingestion can complete."},"firmware":{"type":"array","items":{"$ref":"#/components/schemas/HostFirmwareVersionConfig"},"description":"Known firmware versions currently stored for this component."}}},"HostFirmwareConfigCreateOrUpdateRequest":{"type":"object","title":"HostFirmwareConfigCreateOrUpdateRequest","description":"Host firmware configuration upsert payload. Configurations are keyed by\n`(vendor, model)` on the Site's Core instance. On first create,\n`ordering` must list every component being configured. On update,\nnewly added components must also appear in `ordering`.","required":["siteId","vendor","model","components"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the host firmware config is stored."},"vendor":{"type":"string","minLength":1,"description":"Hardware vendor for the configuration (for example `Nvidia`, `Dell`)."},"model":{"type":"string","minLength":1,"description":"Hardware model for the configuration (for example `DGXH100`)."},"components":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/HostFirmwareComponentConfig"},"description":"Component firmware entries to create or merge."},"explicitStartNeeded":{"type":"boolean","description":"Optional. When `true`, host firmware updates for this vendor/model\nrequire an explicit start. Omitted on update leaves the stored\nvalue unchanged."},"ordering":{"type":"array","items":{"$ref":"#/components/schemas/HostFirmwareComponentType"},"description":"Update order for configured components. Required on first create.\nMust include every configured component and must be updated when\nadding a new component on subsequent PUTs."}},"examples":[{"siteId":"00000000-0000-0000-0000-000000000001","vendor":"Nvidia","model":"DGXH100","explicitStartNeeded":true,"ordering":["Cx7","BMC"],"components":[{"type":"Cx7","firmware":[{"version":"28.47.2682","default":true,"installOnlySpecified":true,"powerDrainsNeeded":1,"preUpdateResets":true,"artifacts":[{"url":"https://firmware.example.invalid/28.47.2682/fw.bin","sha256":"a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"}]}]}]}]},"HostFirmwareConfigDeleteRequest":{"type":"object","title":"HostFirmwareConfigDeleteRequest","description":"Host firmware configuration delete payload.","required":["siteId","vendor","model"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the host firmware config is stored."},"vendor":{"type":"string","minLength":1,"description":"Hardware vendor for the configuration (for example `Nvidia`, `Dell`)."},"model":{"type":"string","minLength":1,"description":"Hardware model for the configuration (for example `DGXH100`)."}},"examples":[{"siteId":"00000000-0000-0000-0000-000000000001","vendor":"Nvidia","model":"DGXH100"}]},"HostFirmwareConfig":{"type":"object","title":"HostFirmwareConfig","description":"Stored host firmware configuration returned after create or update.","required":["vendor","model","components","explicitStartNeeded","ordering","created","updated"],"properties":{"vendor":{"type":"string","readOnly":true,"description":"Hardware vendor for the configuration."},"model":{"type":"string","readOnly":true,"description":"Hardware model for the configuration."},"components":{"type":"array","items":{"$ref":"#/components/schemas/HostFirmwareComponent"},"description":"Stored component firmware entries."},"explicitStartNeeded":{"type":"boolean","readOnly":true,"description":"Whether host firmware updates require an explicit start."},"ordering":{"type":"array","items":{"$ref":"#/components/schemas/HostFirmwareComponentType"},"readOnly":true,"description":"Stored update order for configured components."},"created":{"type":"string","format":"date-time","readOnly":true,"description":"When this vendor/model configuration was first created."},"updated":{"type":"string","format":"date-time","readOnly":true,"description":"When this vendor/model configuration was last updated."}},"examples":[{"vendor":"Nvidia","model":"DGXH100","explicitStartNeeded":true,"ordering":["Cx7","BMC"],"components":[{"type":"BMC","firmware":[{"version":"2.3.7","default":true,"installOnlySpecified":false,"powerDrainsNeeded":0,"preUpdateResets":false,"artifacts":[{"url":"https://firmware.example.invalid/2.3.7/fw.bin","sha256":"a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"}]}]},{"type":"Cx7","firmware":[{"version":"28.47.2682","default":true,"installOnlySpecified":true,"powerDrainsNeeded":1,"preUpdateResets":true,"artifacts":[{"url":"https://firmware.example.invalid/28.47.2682/fw.bin","sha256":"a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"}]}]}],"created":"2025-08-24T14:15:22Z","updated":"2025-08-24T14:15:22Z"}]},"HostFirmwareComponentType":{"type":"string","title":"HostFirmwareComponentType","description":"Host firmware component type exposed by the REST API.","enum":["BMC","CEC","UEFI","NIC","CpldMb","CpldPdb","HgxBmc","CombinedBmcUefi","GPU","Cx7"]},"MachinePowerControlRequest":{"type":"object","title":"MachinePowerControlRequest","description":"Request to power control a Machine","required":["action"],"properties":{"action":{"type":"string","description":"Redfish power control action to apply to the Machine. ACPowercycle is not supported on Viking systems.","enum":["On","GracefulShutdown","ForceOff","GracefulRestart","ForceRestart","ACPowercycle"]},"acknowledgeAttachedInstance":{"type":"boolean","description":"Acknowledges that an Instance is currently attached to the Machine and this action may disrupt Tenant workload on the Instance."}},"examples":[{"action":"ForceRestart","acknowledgeAttachedInstance":true}]},"MachineValidationRunCreateRequest":{"type":"object","title":"MachineValidationRunCreateRequest","description":"Optional filters for an on-demand Machine validation run","examples":[{"tags":["dgxcloud"],"allowedTests":["forge_DcgmFullLong"],"runUnverifiedTests":false,"contexts":["OnDemand"]}],"properties":{"tags":{"type":"array","description":"Tags used to select validation tests.","items":{"type":"string","minLength":1}},"allowedTests":{"type":"array","description":"Validation test names allowed for this run.","items":{"type":"string","minLength":1}},"runUnverifiedTests":{"type":"boolean","description":"Whether unverified validation tests may run.","default":false},"contexts":{"type":"array","description":"Contexts used to select validation tests.","items":{"type":"string","minLength":1}}}},"MachineValidationRun":{"type":"object","title":"MachineValidationRun","description":"Machine validation run","examples":[{"validationID":"20000000-0000-0000-0000-000000000001","machineID":"fm100htes3rn1npvbtm5qd57dkilaag7ljugl1llmm7rfuq1ov50i0rpl30","startTime":"2026-08-03T20:00:00Z","endTime":null,"name":"Test_fm100htes3rn1npvbtm5qd57dkilaag7ljugl1llmm7rfuq1ov50i0rpl30","context":"OnDemand","status":{"state":"InProgress","total":1,"completed":0},"durationToCompleteSecs":7200}],"required":["validationID","machineID","startTime","endTime","name","context","status","durationToCompleteSecs"],"properties":{"validationID":{"type":"string","description":"ID of the Machine validation run."},"machineID":{"type":"string","description":"ID of the validated Machine."},"startTime":{"type":"string","format":"date-time","description":"Time the validation run started."},"endTime":{"type":["string","null"],"format":"date-time","description":"Time the validation run completed, or null while it is active."},"name":{"type":"string","description":"Name of the validation run."},"context":{"type":"string","description":"Context in which the validation run was created."},"status":{"$ref":"#/components/schemas/MachineValidationStatus"},"durationToCompleteSecs":{"type":"integer","description":"Estimated maximum duration of the validation run in seconds. A value of zero can mean the estimate has not yet been calculated."}}},"MachineValidationStatus":{"type":"object","title":"MachineValidationStatus","description":"Progress and outcome of a Machine validation run","examples":[{"state":"InProgress","total":1,"completed":0}],"required":["state","total","completed"],"properties":{"state":{"type":"string","description":"Current state or completed outcome of the validation run.","enum":["Started","InProgress","Success","Failed","Skipped"]},"total":{"type":"integer","description":"Total number of validation tests in the run."},"completed":{"type":"integer","description":"Number of validation tests that have completed."}}},"MachineValidationResult":{"type":"object","title":"MachineValidationResult","description":"Result of one test in a Machine validation run","examples":[{"name":"DcgmFullLong","description":"Full DCGM diag test for 5 min","command":"dcgmi ","args":" diag -r 3","stdOut":"Diagnostic completed successfully","stdErr":"","context":"OnDemand","exitCode":0,"startTime":"2026-08-03T20:00:05Z","endTime":"2026-08-03T20:05:05Z","validationID":"20000000-0000-0000-0000-000000000001","testID":"forge_DcgmFullLong"}],"required":["name","description","command","args","stdOut","stdErr","context","exitCode","startTime","endTime","validationID","testID"],"properties":{"name":{"type":"string","description":"Name of the validation test."},"description":{"type":"string","description":"Description of the validation test."},"command":{"type":"string","description":"Command executed by the validation test."},"args":{"type":"string","description":"Arguments supplied to the validation command."},"stdOut":{"type":"string","description":"Standard output from the validation command."},"stdErr":{"type":"string","description":"Standard error from the validation command."},"context":{"type":"string","description":"Context in which the validation test ran."},"exitCode":{"type":"integer","description":"Exit code returned by the validation command."},"startTime":{"type":"string","format":"date-time","description":"Time the validation test started."},"endTime":{"type":"string","format":"date-time","description":"Time the validation test completed."},"validationID":{"type":"string","description":"ID of the Machine validation run."},"testID":{"type":"string","description":"ID of the validation test."}}},"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","description":"Unique UUID v4 identifier for the Infrastructure Provider","format":"uuid","readOnly":true},"org":{"type":"string","description":"Name of the org this Infrastructure Provider belongs to"},"orgDisplayName":{"type":["string","null"],"description":"Display name of the org this Infrastructure Provider belongs to"},"created":{"type":"string","description":"Date/time when the Infrastructure Provider was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Infrastructure Provider was last updated","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","description":"Machine status counts for the Infrastructure Provider"},"ipBlock":{"$ref":"#/components/schemas/IpBlockCountByStatus","description":"IP Block status counts for the Infrastructure Provider"},"tenantAccount":{"$ref":"#/components/schemas/TenantAccountCountByStatus","description":"Tenant Account status counts for the Infrastructure Provider"}}},"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","description":"Total number of Machines"},"initializing":{"type":"integer","description":"Number of Machines in Initializing status"},"reset":{"type":"integer","description":"Number of Machines in Reset status"},"assigned":{"type":"integer","description":"Number of Machines in Assigned status"},"ready":{"type":"integer","description":"Number of Machines in Ready status"},"error":{"type":"integer","description":"Number of Machines in Error status"},"decommissioned":{"type":"integer","description":"Number of Machines in Decommissioned status"},"unknown":{"type":"integer","description":"Number of Machines in Unknown status"}}},"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","description":"Total number of IP Blocks"},"pending":{"type":"integer","description":"Number of IP Blocks in Pending status"},"provisioning":{"type":"integer","description":"Number of IP Blocks in Provisioning status"},"ready":{"type":"integer","description":"Number of IP Blocks in Ready status"},"deleting":{"type":"integer","description":"Number of IP Blocks in Deleting status"},"error":{"type":"integer","description":"Number of IP Blocks in Error status"}}},"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","description":"Total number of Tenant Accounts"},"pending":{"type":"integer","description":"Number of Tenant Accounts in Pending status"},"invited":{"type":"integer","description":"Number of Tenant Accounts in Invited status"},"ready":{"type":"integer","description":"Number of Tenant Accounts in Ready status"},"error":{"type":"integer","description":"Number of Tenant Accounts in Error status"}}},"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":true},"deprecations":[{"attribute":"capabilities.targetedInstanceCreation","replacedBy":"tenantAccount.siteCapabilities","takeActionBy":"2026-10-01T00:00:00Z","notice":"'capabilities.targetedInstanceCreation' is being deprecated in favor of 'tenantAccount.siteCapabilities'. Please take action prior to the specified date"}]}],"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":"Deprecated read-only aggregate of tenant-wide feature flags. Source of truth is Tenant Account `siteCapabilities`."},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"},"description":"Deprecation notices for Tenant fields"}}},"TenantCapabilities":{"title":"TenantCapabilities","type":"object","description":"Deprecated tenant-wide capability summary. TargetedInstanceCreation is no longer stored on the Tenant entity; it is configured on Tenant Account `siteCapabilities` (and may be overridden per Site via Tenant Site configuration).\n\nOn GET `/tenant/current`, `targetedInstanceCreation` is present and `true` only when the Tenant has at least one Ready Tenant Account, every Ready Tenant Account has the capability enabled by default, and no Tenant Site explicitly disables it. Otherwise the property is omitted. Embedded `TenantSummary.capabilities` objects in nested resources also omit the property.","examples":[{"targetedInstanceCreation":true}],"properties":{"targetedInstanceCreation":{"type":"boolean","deprecated":true,"readOnly":true,"description":"Deprecated in favor of TenantAccount.siteCapabilities. On GET `/tenant/current`, the property is present and true only when every Ready Tenant Account enables TargetedInstanceCreation and no Tenant Site explicitly disables it; otherwise it is omitted. It is also omitted from embedded TenantSummary objects."}}},"TenantStats":{"title":"TenantStats","type":"object","description":"Provide operational stats for Tenant","examples":[{"instance":{"total":18,"pending":2,"provisioning":1,"configuring":2,"ready":8,"rebooting":1,"repairing":1,"terminating":2,"error":1,"updating":0,"unknown":0},"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},"tenantAccount":{"total":8,"pending":0,"invited":3,"ready":5,"error":0}}],"properties":{"instance":{"$ref":"#/components/schemas/InstanceCountByStatus","description":"Instance status counts for the Tenant"},"vpc":{"$ref":"#/components/schemas/VpcCountByStatus","description":"VPC status counts for the Tenant"},"subnet":{"$ref":"#/components/schemas/SubnetCountByStatus","description":"Subnet status counts for the Tenant"},"tenantAccount":{"$ref":"#/components/schemas/TenantAccountCountByStatus","description":"Tenant Account status counts for the Tenant"}}},"InstanceCountByStatus":{"title":"InstanceCountByStatus","type":"object","description":"Describes count of Instances in various statuses","examples":[{"total":18,"pending":2,"provisioning":1,"configuring":2,"ready":8,"rebooting":1,"repairing":1,"terminating":2,"error":1,"updating":0,"unknown":0}],"properties":{"total":{"type":"integer","description":"Total number of Instances"},"pending":{"type":"integer","description":"Number of Instances in Pending status"},"provisioning":{"type":"integer","description":"Number of Instances in Provisioning status"},"configuring":{"type":"integer","description":"Number of Instances in Configuring status"},"ready":{"type":"integer","description":"Number of Instances in Ready status"},"rebooting":{"type":"integer","description":"Number of Instances in Rebooting status"},"repairing":{"type":"integer","description":"Number of Instances in Repairing status"},"terminating":{"type":"integer","description":"Number of Instances in Terminating status"},"error":{"type":"integer","description":"Number of Instances in Error status"},"updating":{"type":"integer","description":"Number of Instances in Updating status"},"unknown":{"type":"integer","description":"Number of Instances in Unknown status"}}},"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","description":"Total number of VPCs"},"pending":{"type":"integer","description":"Number of VPCs in Pending status"},"provisioning":{"type":"integer","description":"Number of VPCs in Provisioning status"},"ready":{"type":"integer","description":"Number of VPCs in Ready status"},"deleting":{"type":"integer","description":"Number of VPCs in Deleting status"},"error":{"type":"integer","description":"Number of VPCs in Error status"}}},"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","description":"Total number of Subnets"},"pending":{"type":"integer","description":"Number of Subnets in Pending status"},"provisioning":{"type":"integer","description":"Number of Subnets in Provisioning status"},"ready":{"type":"integer","description":"Number of Subnets in Ready status"},"deleting":{"type":"integer","description":"Number of Subnets in Deleting status"},"error":{"type":"integer","description":"Number of Subnets in Error status"}}},"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":"Ready","statusHistory":[{"status":"Ready","message":"Account ready, Tenant accepted invite","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"siteCapabilities":[{"targetedInstanceCreation":true}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","description":"Unique UUID v4 identifier for the Tenant Account","format":"uuid","readOnly":true},"infrastructureProviderId":{"type":"string","description":"ID of the Infrastructure Provider","format":"uuid"},"infrastructureProviderOrg":{"type":"string","description":"Organization name of the Infrastructure Provider"},"tenantId":{"type":["string","null"],"description":"ID of the Tenant","format":"uuid"},"tenantOrg":{"type":["string","null"],"description":"Org of the Tenant"},"tenantContact":{"$ref":"#/components/schemas/User","description":"Contact user for the Tenant"},"allocationCount":{"type":"integer","description":"Number of Allocations for the Tenant Account"},"status":{"$ref":"#/components/schemas/TenantAccountStatus","description":"Status of the Tenant Account"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the Tenant Account"},"deprecations":{"type":"array","description":"Deprecations active for this resource. Returned only if there are active deprecations.","items":{"$ref":"#/components/schemas/Deprecation"}},"created":{"type":"string","description":"Date/time when the Tenant Account was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Tenant Account was last updated","format":"date-time","readOnly":true},"siteCapabilities":{"type":"array","description":"Provider-scoped TargetedInstanceCreation settings for this Tenant Account. Replaces the deprecated tenant-level capabilities.targetedInstanceCreation attribute.\n\nWhen present on a Tenant Account response, the array always includes one entry with omitted `siteIds` derived from TenantAccount.config, followed by zero or more entries with `siteIds` for per-site overrides that differ from the account default.","minItems":1,"items":{"$ref":"#/components/schemas/TenantAccountSiteCapability"}}}},"TenantAccountSiteCapability":{"title":"TenantAccountSiteCapability","type":"object","description":"TargetedInstanceCreation capability for the Tenant Account default or an explicit Site list.\n\nUpdate payloads must satisfy all of the following when siteCapabilities is sent on PATCH:\n- the siteCapabilities array must contain at least one entry\n- exactly one entry must omit siteIds or provide an empty siteIds array\n- each siteId may appear at most once across all entries\n- every provided siteId must be a valid Site UUID\n- every provided siteId must identify a Site associated with the Tenant and owned by the Tenant Account's Infrastructure Provider; otherwise the server rejects the request with 400\n\nPATCH uses replace semantics: previously configured per-site overrides whose siteId is omitted from the new payload are cleared.","required":["targetedInstanceCreation"],"properties":{"siteIds":{"type":"array","description":"Sites to configure. An omitted or empty array identifies the Tenant Account default entry. Each value must be a valid Site UUID, may appear only once across all siteCapabilities entries in the same request, must be associated with the Tenant, and must be owned by the Tenant Account's Infrastructure Provider; otherwise the server rejects the request with 400.","items":{"type":"string","format":"uuid"}},"targetedInstanceCreation":{"type":"boolean","description":"Whether TargetedInstanceCreation is enabled for the Tenant Account default or listed Sites. When true, Tenant Admins with a Ready Tenant Account on the Site's Infrastructure Provider may create Instances by Machine ID and perform related privileged actions on that Site."}}},"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","deprecated":true,"description":"Deprecated; inferred from the caller's org Infrastructure Provider\nwhen omitted. When provided, the value must match the org's\nInfrastructure Provider — mismatched values are rejected with 400."},"tenantOrg":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","minLength":1,"description":"Must be a valid Org name"}},"required":["tenantOrg"]},"TenantAccountUpdateRequest":{"title":"TenantAccountUpdateRequest","type":"object","description":"Request data to update a TenantAccount.\n\nProvider Admins may replace `siteCapabilities` only.\nTenant Admins may accept an invite via `tenantContactId` only.\nRequests containing both fields are rejected with 400.\n\nWhen `siteCapabilities` is included, the replace payload must contain at least one entry, include exactly one entry with empty or omitted `siteIds`, and must not repeat any `siteId` across entries. Every provided `siteId` must be a valid UUID for a Site associated with the Tenant and owned by the Tenant Account's Infrastructure Provider; otherwise the server rejects the request with 400. Previously configured per-site overrides whose `siteId` is omitted from the replacement payload are cleared.","examples":[{"tenantContactId":"497f6eca-6276-4993-bfeb-53cbbbba6f08"},{"siteCapabilities":[{"siteIds":[],"targetedInstanceCreation":true},{"siteIds":["3fa85f64-5717-4562-b3fc-2c963f66afa6"],"targetedInstanceCreation":false}]}],"properties":{"tenantContactId":{"type":"string","format":"uuid","description":"Tenant Admin invite acceptance; must match the requesting user"},"siteCapabilities":{"type":"array","minItems":1,"description":"Provider Admin replace payload for TargetedInstanceCreation configuration. Required to be non-empty when sent.\n\nPATCH uses replace semantics: previously configured per-site overrides whose siteId is omitted from the new payload are cleared.\n\nServer validation rules:\n- must contain at least one entry\n- must contain exactly one entry with omitted or empty siteIds\n- must not repeat any siteId across entries\n- every provided siteId must be a valid Site UUID\n- every provided siteId must identify a Site associated with the Tenant and owned by the Tenant Account's Infrastructure Provider; otherwise the server rejects the request with 400","items":{"$ref":"#/components/schemas/TenantAccountSiteCapability"}}}},"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}},"gpuStats":[{"name":"NVIDIA GB200","gpus":64,"machines":16}],"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","description":"Unique UUID v4 identifier for the Site in NICo Cloud","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","description":"NGC organization ID of the Infrastructure Provider that owns the Site"},"infrastructureProviderId":{"type":"string","description":"ID of the Infrastructure Provider that owns the Site","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"],"description":"Serial console hostname of the site controller","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","description":"Status of the Site","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the Site"},"created":{"type":"string","description":"Date/time when the Site was created","format":"date-time"},"updated":{"type":"string","description":"Date/time when the Site was last updated","format":"date-time"},"location":{"$ref":"#/components/schemas/SiteLocation","description":"Site location information"},"contact":{"$ref":"#/components/schemas/SiteContact","description":"Site contact information"},"capabilities":{"$ref":"#/components/schemas/SiteCapabilities","description":"Site capabilities used for feature availability and configuration"},"machineStats":{"$ref":"#/components/schemas/SiteMachineStats","description":"Machine counts by status for the Site"},"gpuStats":{"type":"array","items":{"$ref":"#/components/schemas/MachineGPUStats"},"description":"GPU counts grouped by GPU type for the Site. Populated when includeGpuStats is set"}}},"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","description":"Unique UUID v4 identifier for the Site","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the Site"},"infrastructureProviderId":{"type":"string","description":"ID of the Infrastructure Provider that owns the Site","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","description":"Site capabilities used for feature availability and configuration"},"status":{"$ref":"#/components/schemas/SiteStatus","description":"Status of the Site","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","description":"Whether the Site supports native networking"},"networkSecurityGroup":{"type":"boolean","description":"Whether the Site supports Network Security Groups"},"nvLinkPartition":{"type":"boolean","description":"Whether the Site supports NVLink partitioning"},"flow":{"type":"boolean","description":"Whether the Site supports Flow-based operations"},"imageBasedOperatingSystem":{"type":"boolean","description":"Whether the Site supports image-based operating system provisioning"}}},"SiteMachineStats":{"title":"SiteMachineStats","type":"object","description":"Machine stats for a Site","properties":{"total":{"type":"integer","description":"Total number of Machines at the Site"},"totalByStatus":{"$ref":"#/components/schemas/SiteMachineStatsByStatus","description":"Machine counts grouped by Machine status"},"totalByHealth":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Machine counts grouped by health state"},"totalByStatusAndHealth":{"$ref":"#/components/schemas/SiteMachineStatsByStatusAndHealth","description":"Machine health counts grouped by Machine status"},"totalByAllocation":{"$ref":"#/components/schemas/SiteMachineStatsByAllocation","description":"Machine counts grouped by allocation and usage state"}}},"SiteMachineStatsByAllocation":{"title":"SiteMachineStatsByAllocation","type":"object","description":"Machine stats for a Site by allocation","properties":{"allocatedInUse":{"type":"integer","description":"Number of allocated Machines currently in use"},"allocatedNotInUse":{"type":"integer","description":"Number of allocated Machines not currently in use"},"unallocated":{"type":"integer","description":"Number of Machines not currently allocated"}}},"SiteMachineStatsByHealth":{"title":"SiteMachineStatsByHealth","type":"object","description":"Machine stats for a Site by health","properties":{"healthy":{"type":"integer","description":"Number of healthy Machines"},"unhealthy":{"type":"integer","description":"Number of unhealthy Machines"}}},"SiteMachineStatsByStatus":{"title":"SiteMachineStatsByStatus","type":"object","description":"Machine stats for a Site by status","properties":{"Decommissioned":{"type":"integer","description":"Number of Machines in Decommissioned status"},"Error":{"type":"integer","description":"Number of Machines in Error status"},"Initializing":{"type":"integer","description":"Number of Machines in Initializing status"},"InUse":{"type":"integer","description":"Number of Machines in InUse status"},"Maintenance":{"type":"integer","description":"Number of Machines in Maintenance status"},"Ready":{"type":"integer","description":"Number of Machines in Ready status"},"Reset":{"type":"integer","description":"Number of Machines in Reset status"},"Unknown":{"type":"integer","description":"Number of Machines in Unknown status"}}},"SiteMachineStatsByStatusAndHealth":{"title":"SiteMachineStatsByStatusAndHealth","type":"object","description":"Machine stats for a Site by status and health","properties":{"Decommissioned":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Health breakdown for Machines in Decommissioned status"},"Error":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Health breakdown for Machines in Error status"},"Initializing":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Health breakdown for Machines in Initializing status"},"InUse":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Health breakdown for Machines in InUse status"},"Maintenance":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Health breakdown for Machines in Maintenance status"},"Ready":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Health breakdown for Machines in Ready status"},"Reset":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Health breakdown for Machines in Reset status"},"Unknown":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Health breakdown for Machines in Unknown status"}}},"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","description":"Site location information"},"contact":{"$ref":"#/components/schemas/SiteContact","description":"Site contact information"}},"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","description":"Updated Site location information"},"contact":{"$ref":"#/components/schemas/SiteContact","description":"Updated Site contact information"},"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","description":"Status of the Allocation","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the Allocation","readOnly":true},"allocationConstraints":{"type":"array","items":{"$ref":"#/components/schemas/AllocationConstraint"},"description":"List of Allocation Constraints for the Allocation"},"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"},"description":"List of Allocation Constraint objects"}},"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 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 which 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","description":"Summary of the Instance Type"},"ipBlock":{"$ref":"#/components/schemas/IpBlockSummary","description":"Summary of the IP Block"},"deprecations":{"type":"array","description":"Deprecations active for this resource. Returned only if there are active deprecations.","items":{"$ref":"#/components/schemas/Deprecation"}},"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":{"objectId":"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","FLAT"],"description":"Network virtualization type of the VPC. Flat VPCs hold instances on zero-DPU hosts (or hosts with their DPU in NIC mode); their interfaces are bound to underlay (HostInband) network segments and NICo does not drive their data plane."},"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`."},"routingProfileOverrides":{"oneOf":[{"$ref":"#/components/schemas/VpcRoutingProfileOverrides"},{"type":"null"}],"description":"Routing-profile properties set directly on the VPC. Unset properties inherit from the named routing profile."},"effectiveRoutingProfile":{"$ref":"#/components/schemas/VpcEffectiveRoutingProfile","readOnly":true,"description":"Fully resolved routing profile last reported by Core for the VPC. This property is included only when the requesting Tenant has effective TargetedInstanceCreation permission for the VPC's Site."},"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"}}},"VpcRouteTarget":{"title":"VpcRouteTarget","type":"object","description":"BGP route target represented by an autonomous system number and VNI.","properties":{"asn":{"type":"integer","format":"int64","minimum":0,"maximum":4294967295,"description":"Autonomous system number."},"vni":{"type":"integer","format":"int64","minimum":0,"maximum":4294967295,"description":"Route-target VNI."}}},"VpcRoutingProfileOverrides":{"title":"VpcRoutingProfileOverrides","type":"object","description":"Presence-aware routing-profile properties set directly on a VPC. Each present property replaces the corresponding named-profile value; omitted properties inherit from that profile.","properties":{"routeTargetImports":{"type":["array","null"],"items":{"$ref":"#/components/schemas/VpcRouteTarget"},"description":"Route targets imported into the VPC. An empty array overrides the named profile with no imports."},"routeTargetsOnExports":{"type":["array","null"],"items":{"$ref":"#/components/schemas/VpcRouteTarget"},"description":"Route targets attached to VPC exports. An empty array overrides the named profile with no export targets."},"leakDefaultRouteFromUnderlay":{"type":["boolean","null"],"description":"Whether the underlay default route is leaked into the VPC."},"leakTenantHostRoutesToUnderlay":{"type":["boolean","null"],"description":"Whether tenant host routes are leaked into the underlay."},"tenantLeakCommunitiesAccepted":{"type":["boolean","null"],"description":"Whether tenant-supplied route-leak communities are honored."},"acceptedLeaksFromUnderlay":{"type":["array","null"],"items":{"type":"string","example":"192.0.2.0/24"},"description":"IPv4 or IPv6 CIDR prefixes allowed to leak from the underlay. An empty array disables explicitly accepted leaks."},"allowedAnycastPrefixes":{"type":["array","null"],"items":{"type":"string","example":"2001:db8::/64"},"description":"IPv4 or IPv6 CIDR prefixes tenant hosts may announce as anycast routes. An empty array disables anycast announcements."}}},"VpcEffectiveRoutingProfile":{"title":"VpcEffectiveRoutingProfile","type":"object","description":"Fully resolved routing profile computed by Core from the named profile and the VPC overrides.","properties":{"routeTargetImports":{"type":"array","items":{"$ref":"#/components/schemas/VpcRouteTarget"}},"routeTargetsOnExports":{"type":"array","items":{"$ref":"#/components/schemas/VpcRouteTarget"}},"leakDefaultRouteFromUnderlay":{"type":"boolean"},"leakTenantHostRoutesToUnderlay":{"type":"boolean"},"tenantLeakCommunitiesAccepted":{"type":"boolean"},"acceptedLeaksFromUnderlay":{"type":"array","items":{"type":"string"}},"allowedAnycastPrefixes":{"type":"array","items":{"type":"string"}},"internal":{"type":"boolean","description":"Operator-controlled internal-routing classification inherited from the named profile."},"accessTier":{"type":"integer","format":"int64","minimum":0,"maximum":4294967295,"description":"Operator-controlled access tier inherited from the named profile."}},"required":["routeTargetImports","routeTargetsOnExports","leakDefaultRouteFromUnderlay","leakTenantHostRoutesToUnderlay","tenantLeakCommunitiesAccepted","acceptedLeaksFromUnderlay","allowedAnycastPrefixes","internal","accessTier"]},"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","FLAT"],"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. Flat VPCs hold instances on zero-DPU hosts (or hosts with their DPU in NIC mode) and are never auto-selected -- `FLAT` must be specified explicitly."},"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`."},"routingProfileOverrides":{"oneOf":[{"$ref":"#/components/schemas/VpcRoutingProfileOverrides"},{"type":"null"}],"description":"Routing-profile properties to overlay on the resolved named profile. Only supported for FNN VPCs and requires `TargetedInstanceCreation` to be effective for the Tenant at the VPC's Site. `routingProfile` may be omitted when the Site and Tenant configuration select a named profile."},"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"},"routingProfileOverrides":{"oneOf":[{"$ref":"#/components/schemas/VpcRoutingProfileOverrides"},{"type":"null"}],"description":"Replaces the current inline routing-profile definition when present. Requires `TargetedInstanceCreation` to be effective for the Tenant at the VPC's Site. Omission or `null` preserves the current definition. An empty object restores inheritance for every property; a partial object replaces the previous definition and inherits its omitted properties from the named profile."},"labels":{"$ref":"#/components/schemas/Labels","description":"Update labels of the VPC. Up to 10 key-value pairs can be specified. The labels will be replaced with the labels sent in the request. Any labels not included in the request will be removed. To retain existing labels, fetch them first and include them in 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"}}},"VpcPeeringTenantSummary":{"title":"VpcPeeringTenantSummary","type":"object","description":"Summarizes a Tenant in context of a VPC Peering","properties":{"id":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the Tenant"},"org":{"type":"string","readOnly":true,"description":"Name of the org this tenant belongs to"},"orgDisplayName":{"type":["string","null"],"readOnly":true,"description":"Display name of the org the Tenant belongs to"}}},"VpcPeeringVpcSummary":{"title":"VpcPeeringVpcSummary","type":"object","description":"Summarizes a VPC in context of a VPC Peering","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"},"tenantId":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the tenant"},"tenant":{"$ref":"#/components/schemas/VpcPeeringTenantSummary","readOnly":true,"description":"Summary of the tenant"},"networkVirtualizationType":{"type":["string","null"],"enum":["ETHERNET_VIRTUALIZER","FNN","FLAT"],"description":"Network virtualization type of the VPC"},"status":{"$ref":"#/components/schemas/VpcStatus","readOnly":true,"description":"Status of the VPC"}}},"TenantSummary":{"title":"TenantSummary","type":"object","description":"Summarizes a Tenant","properties":{"org":{"type":"string","readOnly":true,"description":"Name of the org this tenant belongs to"},"orgDisplayName":{"type":["string","null"],"readOnly":true,"description":"Display name of the org the Tenant belongs to"},"capabilities":{"$ref":"#/components/schemas/TenantCapabilities","readOnly":true,"description":"Deprecated compatibility object. The targetedInstanceCreation property is omitted; use Tenant Account siteCapabilities for the authoritative configuration."},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"},"readOnly":true,"description":"Deprecation notices for Tenant fields"}}},"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"},"vpc1":{"$ref":"#/components/schemas/VpcPeeringVpcSummary","readOnly":true,"description":"Summary of the first VPC in the peering."},"vpc2Id":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the second VPC in the peering"},"vpc2":{"$ref":"#/components/schemas/VpcPeeringVpcSummary","readOnly":true,"description":"Summary of the second VPC in the peering."},"siteId":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the Site where the peering exists"},"site":{"$ref":"#/components/schemas/SiteSummary","readOnly":true,"description":"Summary of the Site where the peering exists."},"tenantId":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the tenant that created the VPC peering."},"tenant":{"$ref":"#/components/schemas/TenantSummary","readOnly":true,"description":"Summary of the tenant that created the VPC peering."},"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","prefix":"192.168.1.0/24","ipBlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","prefixLength":24,"status":"Ready","usageStats":{"availableIPs":256,"acquiredIPs":2,"availablePrefixes":["192.168.1.0/28","192.168.1.16/30","192.168.1.24/29","192.168.1.32/27","192.168.1.64/26","192.168.1.128/25"],"availableSmallestPrefixes":63,"acquiredPrefixes":1},"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"},{"id":"42624127-ec6a-4829-b9ca-2f6ffb5d4215","name":"northern-vpc-traffic-net","siteId":"ea144def-d68f-44c3-9485-4b103fa2686f","vpcId":"4ea05fc4-2be8-4823-b574-e633b5ad3c4c","prefix":"10.217.98.100/30","ipBlockId":"65e14c37-5a8f-4c41-9b1c-f2e162bee11c","prefixLength":30,"status":"Ready","usageStats":{"availableIPs":4,"acquiredIPs":0,"availablePrefixes":["10.217.98.100/30"],"availableSmallestPrefixes":1,"acquiredPrefixes":0},"statusHistory":[{"status":"Ready","message":"Received VPC prefix creation request, ready","created":"2025-05-28T14:15:22Z","updated":"2025-05-28T14:15:22Z"}],"created":"2025-05-28T14:15:22Z","updated":"2025-05-28T14:15:22Z"}],"properties":{"id":{"type":"string","description":"Unique UUID v4 identifier for the VPCPrefix","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"},"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"},"usageStats":{"$ref":"#/components/schemas/IpBlockUsageStats","readOnly":true,"description":"Present when query parameter `includeUsageStats=true`. Prefix and IP usage data is derived by evaluating associated Ethernet interfaces. Each Interface associated with a VPC Prefix consumes a `/31` 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":["Provisioning","Ready","Deleting","Deleted","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","description":"Name of the VPCPrefix","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","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"},{"id":"82e4c3a7-5b4d-4c8e-a2f1-1c09d06e9120","name":"inference-training-net","description":"Provisioned subnet with IPv4 usage (includeUsageStats=true)","siteId":"ea144def-d68f-44c3-9485-4b103fa2686f","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","controllerNetworkSegmentId":"abe7b0e8-67db-4e89-903e-fc4f2bd7f034","ipv4Prefix":"10.217.98.64","ipv4BlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","ipv4Gateway":"10.217.98.65","ipv6Prefix":null,"ipv6BlockId":null,"ipv6Gateway":null,"prefixLength":28,"routingType":"Public","status":"Ready","usageStats":{"availableIPs":16,"acquiredIPs":6,"availablePrefixes":["10.217.98.64/28"],"availableSmallestPrefixes":4,"acquiredPrefixes":0},"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-24T16:02:38Z"}],"properties":{"id":{"type":"string","description":"Unique UUID v4 identifier for the Subnet","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the Subnet","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Subnet"},"siteId":{"type":"string","description":"ID of the Site containing the Subnet","format":"uuid"},"vpcId":{"type":"string","description":"ID of the VPC containing the Subnet","format":"uuid"},"controllerNetworkSegmentId":{"type":["string","null"],"description":"ID of the Site Controller network segment corresponding to the Subnet","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"],"description":"ID of the derived Tenant IPv4 Block from an Allocation","format":"uuid"},"ipv4Gateway":{"type":["string","null"],"description":"Address of the IPv4 gateway in the Subnet","format":"ipv4"},"ipv6Prefix":{"type":["string","null"],"description":"Prefix of the network in CIDR notation","format":"ipv6"},"ipv6BlockId":{"type":["string","null"],"description":"ID of the derived Tenant IPv6 Block from an Allocation","format":"uuid"},"ipv6Gateway":{"type":["string","null"],"description":"Address of the IPv6 gateway in the Subnet","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"],"description":"Routing type of the Subnet","enum":["Public","DatacenterOnly"]},"status":{"$ref":"#/components/schemas/SubnetStatus","description":"Status of the Subnet","readOnly":true},"usageStats":{"$ref":"#/components/schemas/IpBlockUsageStats","readOnly":true,"description":"Present when query parameter `includeUsageStats=true`. Prefix and IP usage data is derived by evaluating associated Ethernet interfaces. Each Interface associated with a Subnet consumes a single IP. In addition, one gateway and one broadcast IP address are reserved per Subnet."},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the Subnet","readOnly":true},"created":{"type":"string","description":"Date/time when the Subnet was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Subnet was last updated","format":"date-time","readOnly":true}}},"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","description":"Name of the Subnet","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Subnet"},"vpcId":{"type":"string","description":"ID of the VPC containing the Subnet","format":"uuid"},"ipv4BlockId":{"type":["string","null"],"description":"ID of the derived Tenant IPv4 Block from an Allocation","format":"uuid"},"ipv6BlockId":{"type":["string","null"],"description":"ID of the derived Tenant IPv6 Block from an Allocation","format":"uuid"},"prefixLength":{"type":"integer","description":"Length of the prefix"}},"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","description":"Name of the Subnet","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Subnet"}},"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","description":"Unique UUID v4 identifier for the InfiniBand Partition","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the InfiniBand Partition","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the InfiniBand Partition"},"siteId":{"type":"string","description":"ID of the Site","format":"uuid"},"tenantId":{"type":"string","description":"ID of the Tenant","format":"uuid"},"controllerIBPartitionId":{"type":["string","null"],"description":"ID of the Site Controller InfiniBand partition corresponding to this InfiniBand Partition","format":"uuid"},"partitionKey":{"type":["string","null"],"description":"Partition key assigned to the InfiniBand Partition","readOnly":true},"partitionName":{"type":["string","null"],"description":"Partition name assigned to the InfiniBand Partition","readOnly":true},"serviceLevel":{"type":["integer","null"],"description":"Service level configured for the InfiniBand Partition","minimum":0,"maximum":15,"readOnly":true},"rateLimit":{"type":["number","null"],"description":"Rate limit configured for the InfiniBand Partition","enum":[2,5,10,14,20,25,30,40,56,60,80,100,112,120,168,200,300],"readOnly":true},"mtu":{"type":["integer","null"],"description":"MTU configured for the InfiniBand Partition","enum":[4000,8000],"readOnly":true},"enableSharp":{"type":"boolean","description":"Whether SHARP is enabled for the InfiniBand Partition","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","description":"Status of the InfiniBand Partition","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the InfiniBand Partition","readOnly":true},"created":{"type":"string","description":"Date/time when the InfiniBand Partition was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the InfiniBand Partition was last updated","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","description":"Name of the InfiniBand Partition","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the InfiniBand Partition"},"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},"nvLinkLogicalPartitionStats":{"$ref":"#/components/schemas/NVLinkLogicalPartitionStats","description":"GPU and Instance usage counts for the NVLink Logical Partition. Returned if the `includeStats` query parameter is set to true in retrieval endpoints"},"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"}}},"NVLinkLogicalPartitionStats":{"title":"NVLinkLogicalPartitionStats","type":"object","description":"GPU and Instance counts for an NVLink Logical Partition","properties":{"totalGpus":{"type":"integer","description":"Total number of GPUs associated with the NVLink Logical Partition"},"totalDistinctInstances":{"type":"integer","description":"Total number of distinct Instances associated with the NVLink Logical Partition"}}},"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":false,"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","TemplatedIpxe"]},"imageUrl":{"type":["string","null"],"format":"uri","description":"Original URL from which 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 mounted"},"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"},"ipxeTemplateId":{"type":["string","null"],"description":"ID of the iPXE template used, only present for Templated iPXE Operating System"},"ipxeTemplateParameters":{"type":"array","items":{"$ref":"#/components/schemas/OperatingSystemIpxeParameter"},"description":"Parameters passed to the iPXE template (Templated iPXE only)"},"ipxeTemplateArtifacts":{"type":"array","items":{"$ref":"#/components/schemas/OperatingSystemIpxeArtifact"},"description":"Artifacts for the iPXE OS definition (Templated iPXE only). authToken is redacted."},"userData":{"type":["string","null"],"description":"User data for the Operating System"},"isCloudInit":{"type":"boolean","description":"Whether the Operating System is cloud-init based; true if there is non-empty `userData`, false otherwise."},"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"]},"OperatingSystemIpxeParameter":{"title":"OperatingSystemIpxeParameter","type":"object","description":"A name/value parameter passed to an iPXE template","required":["name","value"],"properties":{"name":{"type":"string","description":"Parameter name (used as a variable in the template)"},"value":{"type":"string","description":"Parameter value"}}},"OperatingSystemIpxeArtifact":{"title":"OperatingSystemIpxeArtifact","type":"object","description":"An artifact (kernel, initrd, ISO, ...) referenced by an iPXE OS definition","required":["name","url"],"properties":{"name":{"type":"string","description":"Artifact name"},"url":{"type":"string","description":"Original URL for the artifact"},"sha":{"type":["string","null"],"description":"Optional SHA256 checksum"},"authType":{"type":["string","null"],"description":"Optional auth type: Basic or Bearer"},"authToken":{"type":["string","null"],"description":"Optional auth token. Redacted in API responses."},"cacheStrategy":{"type":"string","enum":["CacheAsNeeded","LocalOnly","CachedOnly","RemoteOnly"],"description":"How to handle caching for this artifact"}}},"IpxeTemplate":{"title":"IpxeTemplate","type":"object","description":"An iPXE script template propagated (read-only) from nico-core","required":["id","name","template","requiredParams","reservedParams","requiredArtifacts","visibility"],"examples":[{"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","name":"ubuntu-autoinstall","template":"#!ipxe\nkernel ${kernel_url} initrd=initrd autoinstall\ninitrd ${initrd_url}\nboot\n","requiredParams":["kernel_url","initrd_url"],"reservedParams":["mac"],"requiredArtifacts":["kernel","initrd"],"visibility":"Public","created":"2026-07-14T14:15:22Z","updated":"2026-07-14T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","description":"Stable template UUID assigned by core"},"name":{"type":"string","description":"Globally unique template name"},"template":{"type":"string","description":"Raw iPXE script content"},"requiredParams":{"type":"array","items":{"type":"string"},"description":"Parameters that must be provided to render the template"},"reservedParams":{"type":"array","items":{"type":"string"},"description":"Parameters reserved by the template and not user-supplied"},"requiredArtifacts":{"type":"array","items":{"type":"string"},"description":"Artifact names required for the template"},"visibility":{"type":"string","description":"Template visibility: Internal or Public"},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"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","description":"Summary of the Site"},"status":{"$ref":"#/components/schemas/SshKeyGroupStatus","description":"Status of the Operating SystemSiteAssociation"},"version":{"type":["string","null"],"description":"Version of the Key Group on Site","example":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3"},"created":{"type":"string","description":"Date/time when the Site was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Site was last updated","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":false,"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","minItems":1,"maxItems":1,"items":{"type":"string","format":"uuid"},"description":"Target Site for the Operating System. For image-based and Templated iPXE Operating Systems exactly one Site is required, even though this field is an array. The list is fixed at creation and cannot be changed on update. Not applicable to raw iPXE OS."},"ipxeScript":{"type":["string","null"],"deprecated":true,"description":"Deprecated: raw iPXE Operating Systems are superseded by Templated iPXE (ipxeTemplateId). 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 which the Operating System image can be retrieved; 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 if 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` is required for image-based OS"},"rootFsLabel":{"type":["string","null"],"description":"Root filesystem label; this or `rootFsId` is 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","deprecated":true,"description":"Deprecated and ignored: whether the Operating System is cloud-init based. Value now derived from `userData`."},"allowOverride":{"type":"boolean","description":"Indicates if the user data can be overridden at Instance creation time"},"ipxeTemplateId":{"type":["string","null"],"description":"ID of the iPXE template to use; identifies a Templated iPXE Operating System. Mutually exclusive with ipxeScript and imageUrl."},"ipxeTemplateParameters":{"type":"array","items":{"$ref":"#/components/schemas/OperatingSystemIpxeParameter"},"description":"Parameters passed to the iPXE template (Templated iPXE only)."},"ipxeTemplateArtifacts":{"type":"array","items":{"$ref":"#/components/schemas/OperatingSystemIpxeArtifact"},"description":"Artifacts (kernel, initrd, ISO, ...) for the iPXE OS definition (Templated iPXE only)."}},"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","imageAuthType":"Bearer","imageAuthToken":"acbd18db4cc2f85cedef654fccc4a4d8","imageDisk":"/dev/sda","rootFsId":"6c2ac315-3040-4728-94eb-b66d320206c1","isCloudInit":false,"allowOverride":false},{"isActive":false,"deactivationNote":"iPXE script is referencing a URL that is unreachable, needs to be researched"}],"description":"Request data to update an Operating System. For image-based OS, mutable image attributes (image authentication, root filesystem, image disk) can be updated; imageUrl and imageSha identify the underlying image and are immutable after creation. Only iPXE attributes can be updated for iPXE-based OS. A Templated iPXE Operating System can only be updated when it is associated with exactly one Site.","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 which the Operating System image can be retrieved. Immutable after creation: it may be re-sent unchanged, but changing it is rejected. Create a new Operating System to use a different image."},"imageSha":{"type":["string","null"],"description":"SHA hash of the image file. Immutable after creation: it may be re-sent unchanged, but changing it is rejected."},"imageAuthType":{"type":["string","null"],"description":"Authentication type for image URL, if needed, e.g., basic/bearer/token; required if imageAuthToken is specified. Can be updated independently without re-sending imageUrl/imageSha."},"imageAuthToken":{"type":["string","null"],"description":"Auth token to retrieve the image from image URL, required if imageAuthType is specified. Can be updated independently without re-sending imageUrl/imageSha."},"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` is required for image-based OS"},"rootFsLabel":{"type":["string","null"],"description":"Root filesystem label; this or `rootFsId` is 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"],"deprecated":true,"description":"Deprecated and ignored: whether the Operating System is cloud-init based. Value now derived from `userData`."},"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"},"ipxeTemplateId":{"type":["string","null"],"description":"ID of the iPXE template to use (Templated iPXE only). Mutually exclusive with ipxeScript and imageUrl."},"ipxeTemplateParameters":{"type":"array","items":{"$ref":"#/components/schemas/OperatingSystemIpxeParameter"},"description":"Parameters passed to the iPXE template (Templated iPXE only)."},"ipxeTemplateArtifacts":{"type":"array","items":{"$ref":"#/components/schemas/OperatingSystemIpxeArtifact"},"description":"Artifacts (kernel, initrd, ISO, ...) for the iPXE OS definition (Templated iPXE only)."}}},"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"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","description":"Unique UUID v4 identifier for the Instance Type","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the Instance Type","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Instance Type"},"controllerMachineType":{"type":["string","null"],"description":"Machine type assigned by Site Controller"},"infrastructureProviderId":{"type":"string","description":"ID of the Infrastructure Provider that owns the Instance Type","format":"uuid"},"siteId":{"type":"string","description":"ID of the Site that owns the Instance Type","format":"uuid"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value labels for the Instance Type"},"machineCapabilities":{"type":"array","items":{"$ref":"#/components/schemas/MachineCapability"},"description":"List of capabilities that are supported by the Machine's of this Instance Type"},"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","description":"Status of the Instance Type"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the Instance Type"},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"},"description":"Deprecations active for this resource. Returned only if there are active deprecations."},"created":{"type":"string","description":"Date/time when the InstanceType was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the InstanceType was last updated","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","description":"ID of the Instance Type","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the Instance Type, only lowercase characters, digits, hyphens and cannot begin/end with hyphen","minLength":2,"maxLength":256},"infrastructureProviderId":{"type":"string","description":"ID of the Infrastructure Provider that owns the Instance Type","format":"uuid"},"siteId":{"type":"string","description":"ID of the Site that owns the Instance Type","format":"uuid"},"status":{"$ref":"#/components/schemas/InstanceTypeStatus","description":"Status of the Instance Type"}}},"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","description":"Name of the Instance Type","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Instance Type"},"siteId":{"type":"string","description":"ID of the site","format":"uuid"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value labels for the Instance Type"},"controllerMachineType":{"type":["string","null"],"description":"Site Controller assigned Machine type"},"machineCapabilities":{"type":"array","items":{"$ref":"#/components/schemas/InstanceTypeCapabilityCreateRequest"},"description":"List of Machine Capabilities to match"}},"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"],"description":"Name of the Instance Type","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Instance Type"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value labels for the Instance Type"},"machineCapabilities":{"type":"array","items":{"$ref":"#/components/schemas/MachineCapability"},"description":"List of Machine Capabilities to match"}}},"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":{"objectId":"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"}],"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"}],"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"],"description":"ID of the Instance Type","format":"uuid"},"vpcId":{"type":"string","description":"ID of the VPC","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"],"description":"ID of the Machine"},"operatingSystemId":{"type":["string","null"],"description":"ID of the Operating System","format":"uuid"},"networkSecurityGroupId":{"type":["string","null"],"description":"ID of the attached Network Security Group, if any"},"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"],"description":"ID of the Instance in Site Controller","format":"uuid"},"ipxeScript":{"type":["string","null"],"description":"Attribute which is inherited from Operating System"},"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 the Instance"},"userData":{"type":["string","null"],"description":"UserData is inherited from Operating System or specified by user if allowed"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-specified Instance 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"},"autoNetwork":{"type":"boolean","description":"True when this Instance uses NICo auto-resolved networking from the host's underlay (HostInband) network segments. When true, the caller's request `interfaces` list was empty, this `interfaces` field remains empty on readback, and the resolved per-interface details surface under `status.network.interfaces`."},"interfaces":{"type":"array","items":{"$ref":"#/components/schemas/Interface"},"description":"Interfaces are list of the subnet associated with the Instance"},"infinibandInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/InfiniBandInterface"},"description":"InfiniBandInterfaces are list of the InfiniBandInterface associated with the Instance"},"nvLinkInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/NVLinkInterface"},"description":"NVLinkInterfaces are list of the NVLinkInterface associated with the Instance"},"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","description":"Status of the Instance","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the Instance"},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"},"description":"Deprecations active for this resource. Returned only if there are active deprecations."},"created":{"type":"string","description":"Date/time when the Instance was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Instance was last updated","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` or `vpcId`. 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"],"description":"ID of the desired Network Security Group to attach to the Instance"},"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","description":"User-defined key-value labels"},"interfaces":{"type":"array","description":"At least one interface must be specified unless `autoNetwork` is true. Interfaces must all be Subnet-backed or all be VPC-backed; VPC-backed interfaces may use an explicit `vpcPrefixId` or ask the Controller to select a prefix using `vpcId` and `ipFamilies`. Only one network can be attached over a physical interface. If only one Subnet is specified, it will be attached over a physical interface regardless of `isPhysical`. Mutually exclusive with `autoNetwork`: when `autoNetwork` is true this list MUST be empty.","items":{"$ref":"#/components/schemas/InterfaceCreateRequest"}},"autoNetwork":{"type":"boolean","description":"When true, asks NICo to auto-resolve the Instance's network interfaces from the host's underlay (HostInband) network segments. Intended for instances on zero-DPU hosts (or hosts with their DPU in NIC mode). When true: (1) the target VPC's `networkVirtualizationType` MUST be `FLAT`, (2) `interfaces` MUST be empty or omitted, and (3) `secondaryVpcIds` MUST be empty or omitted. Resolved interfaces surface on the Instance's read response."},"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"]},"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` or `vpcId`. 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","description":"Key-value objects to be applied to all instances (shared across all instances)"},"interfaces":{"type":"array","description":"Interface configuration shared across all instances. At least one interface must be specified unless `autoNetwork` is true. Interfaces must all be Subnet-backed or all be VPC-backed; VPC-backed interfaces may use an explicit `vpcPrefixId` or ask the Controller to select a prefix using `vpcId` and `ipFamilies`. Each batch member is resolved independently and may use a different prefix. Only one network can be attached over a physical interface. Interface `ipAddress` is not supported for batch instance creation requests. Mutually exclusive with `autoNetwork`: when `autoNetwork` is true this list MUST be empty.","items":{"$ref":"#/components/schemas/InterfaceCreateRequest"}},"autoNetwork":{"type":"boolean","description":"When true, asks NICo to auto-resolve each Instance's network interfaces from the host's underlay (HostInband) network segments. Intended for instances on zero-DPU hosts (or hosts with their DPU in NIC mode). When true: (1) the target VPC's `networkVirtualizationType` MUST be `FLAT`, (2) `interfaces` MUST be empty or omitted, and (3) `secondaryVpcIds` MUST be empty or omitted."},"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"]},"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, pending Instance updates such as DPU reprovisioning are 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"],"description":"ID of the Network Security Group to attach to the Instance"},"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 the Instance"},"labels":{"$ref":"#/components/schemas/Labels","description":"Update labels of the Instance. The labels will be replaced with the labels sent in the request. Any labels not included in the request will be removed. To retain existing labels, fetch them first and include them in 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` or `vpcId`. IDs must be unique, must be valid UUIDs, and must not include the primary `vpcId`.","items":{"type":"string","format":"uuid"}},"interfaces":{"type":"array","description":"Complete updated Interface configuration for the Instance. Interfaces must all be Subnet-backed or all be VPC-backed; VPC-backed interfaces may use an explicit `vpcPrefixId` or ask the Controller to select a prefix using `vpcId` and `ipFamilies`. Mutually exclusive with `autoNetwork`: when `autoNetwork` is true this list MUST be empty.","items":{"$ref":"#/components/schemas/InterfaceCreateRequest"}},"autoNetwork":{"type":["boolean","null"],"description":"When set, asks NICo to auto-resolve the Instance's network interfaces from the host's underlay (HostInband) segments. `null` leaves the value unchanged; `true` (re-)resolves; `false` returns to explicit interface configuration. When `true`, the Instance's VPC MUST already have `networkVirtualizationType: FLAT`, `interfaces` MUST be empty or omitted, and `secondaryVpcIds` MUST be empty or omitted."},"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 the Instance's VPC has the `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":"4c53d2f4-2a51-4ac5-90c9-87ad215c5091","instanceId":"371ddf80-a7ff-4ff6-9a37-0557cec8b9be","vpcId":"bdd3d1af-b4a8-4675-a59c-56548716ef45","ipFamilies":["IPv4"],"isPhysical":true,"macAddress":"2F-FC-34-AE-9C-2D","ipAddresses":["200.32.11.196"],"status":"Ready","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 or VPC-backed network","properties":{"id":{"type":"string","description":"Unique UUID v4 identifier for the Interface","minLength":1,"format":"uuid"},"instanceId":{"type":"string","description":"ID of the associated Instance","format":"uuid"},"subnetId":{"type":["string","null"],"description":"ID of the associated Subnet","format":"uuid"},"vpcPrefixId":{"type":["string","null"],"description":"ID of the VPC Prefix explicitly selected by the caller","format":"uuid"},"vpcId":{"type":"string","description":"ID of the VPC from which the Controller selects a prefix","format":"uuid"},"ipFamilies":{"type":"array","description":"Address families requested for Controller prefix selection","items":{"$ref":"#/components/schemas/IPFamily"}},"isPhysical":{"type":"boolean","description":"Indicates whether the network is bound on a physical Interface"},"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"],"description":"MAC address of the Interface"},"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 with an explicit `vpcPrefixId` and is not valid with `subnetId` or VPC-selected interfaces. The least-significant host bit must be 1."},"inlineRoutingProfile":{"oneOf":[{"$ref":"#/components/schemas/InterfaceInlineRoutingProfile"},{"type":"null"}],"description":"Inline interface-local routing profile options. Only valid for VPC-backed interfaces."},"status":{"$ref":"#/components/schemas/InterfaceStatus","description":"Status of the Interface"},"created":{"type":"string","description":"Date/time when the Interface was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Interface was last updated","format":"date-time","readOnly":true}}},"InterfaceStatus":{"title":"InterfaceStatus","type":"string","description":"Status values for Interface objects","enum":["Pending","Provisioning","Ready","Deleting","Error"]},"IPFamily":{"title":"IPFamily","type":"string","description":"Address family requested for a VPC-selected Interface","enum":["IPv4","IPv6"]},"InterfaceInlineRoutingProfile":{"title":"InterfaceInlineRoutingProfile","type":"object","description":"Interface-local routing profile options that narrow the owning VPC's routing profile.","properties":{"allowedAnycastPrefixes":{"type":"array","description":"CIDR prefixes this interface is allowed to announce as anycast routes.","default":[],"items":{"type":"string","example":"192.0.2.0/24"}}}},"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},{"vpcId":"bdd3d1af-b4a8-4675-a59c-56548716ef45","ipFamilies":["IPv4"],"isPhysical":true}],"description":"Request data to create an Interface for an Instance by associating it with a Subnet, an explicit VPC Prefix, or a VPC from which the Controller selects a prefix. Exactly one of `subnetId`, `vpcPrefixId`, or `vpcId` must be specified.\n\nIf the VPC specified in the request has FNN virtualization type, all interfaces must specify either `vpcPrefixId` or `vpcId`.\n\nIf the VPC has Ethernet network virtualization type then all interfaces must specify Subnet.","properties":{"subnetId":{"type":"string","description":"ID of the Subnet to attach to the Interface","format":"uuid"},"vpcPrefixId":{"type":"string","description":"ID of the VPC Prefix to attach to the Interface","format":"uuid"},"vpcId":{"type":"string","description":"ID of the VPC from which the Controller should select a prefix. `ipFamilies` must also be specified, and `ipAddress` cannot be specified.","format":"uuid"},"ipFamilies":{"type":"array","minItems":1,"description":"Address families requested for Controller prefix selection. Required with `vpcId` and prohibited otherwise. Only `IPv4` is currently accepted.","items":{"type":"string","enum":["IPv4"]}},"ipAddress":{"type":["string","null"],"description":"Explicitly requested IP address for the interface. It can only be specified with an explicit `vpcPrefixId`. The least-significant host bit must be 1."},"inlineRoutingProfile":{"oneOf":[{"$ref":"#/components/schemas/InterfaceInlineRoutingProfile"},{"type":"null"}],"description":"Inline interface-local routing profile options. It cannot be specified for Subnet-based interfaces."},"isPhysical":{"type":"boolean","description":"Specifies whether this network should be attached to the Instance over a 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":0,"maximum":15}},"oneOf":[{"required":["subnetId"]},{"required":["vpcPrefixId"]},{"required":["vpcId"]}],"dependentRequired":{"vpcId":["ipFamilies"],"ipFamilies":["vpcId"]},"dependentSchemas":{"subnetId":{"properties":{"ipAddress":{"type":"null"},"inlineRoutingProfile":{"type":"null"}}},"vpcId":{"properties":{"ipAddress":{"type":"null"}}}}},"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","description":"Unique UUID v4 identifier for the InfiniBandInterface","minLength":1,"format":"uuid"},"instanceId":{"type":"string","description":"ID of the associated Instance","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"},"vendor":{"type":["string","null"],"description":"Name of the InfiniBand device vendor associated with this interface"},"deviceInstance":{"type":"integer","description":"Index of the device where partition attach to"},"isPhysical":{"type":"boolean","description":"Indicates whether this is a physical interface"},"virtualFunctionId":{"type":["integer","null"],"description":"Must be specified if isPhysical is false"},"guid":{"type":["string","null"],"description":"Must be specified if isPhysical is false"},"status":{"$ref":"#/components/schemas/InfiniBandInterfaceStatus","description":"Status of the InfiniBandInterface"},"created":{"type":"string","description":"Date/time when the InfiniBandInterface was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the InfiniBandInterface was last updated","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","description":"Unique UUID v4 identifier for the NVLinkInterface","minLength":1,"format":"uuid"},"instanceId":{"type":"string","description":"ID of the associated Instance","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","description":"Status of the NVLinkInterface"},"created":{"type":"string","description":"Date/time when the NVLinkInterface was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the NVLinkInterface was last updated","format":"date-time","readOnly":true},"deprecations":{"type":"array","description":"Deprecations active for this resource. Returned only if there are active deprecations.","items":{"$ref":"#/components/schemas/Deprecation"}}}},"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"},"hardwareRevision":{"type":["string","null"],"description":"Hardware revision 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","description":"Physical or logical location of the Rack"},"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","description":"Expected component value"},"actual":{"$ref":"#/components/schemas/RackComponent","description":"Actual component value reported by the system"},"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"},"operationStatus":{"type":"string","enum":["Unknown","Initializing","Ready","InUse","Error","Deleting"],"description":"Flow-derived operability phase of the component"},"leakStatus":{"type":"string","enum":["Unknown","NoLeak","Leaking"],"description":"Whether the component is considered leaking coolant"}}},"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"},"operationStatus":{"type":"string","enum":["Unknown","Initializing","Ready","InUse","Error","Deleting"],"description":"Flow-derived operability phase of the tray"},"leakStatus":{"type":"string","enum":["Unknown","NoLeak","Leaking"],"description":"Whether the tray is considered leaking coolant"},"position":{"$ref":"#/components/schemas/TrayPosition","description":"Position of the Tray within the Rack"},"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`. `slotId` requires `rackId` or `rackName`, must be >= 0, and composes with the rest of the filter via AND.","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"},"slotId":{"type":"integer","format":"int32","minimum":0,"description":"Restrict to trays at this rack slot (matches `position.slotId`). Requires `rackId` or `rackName`. Composes with the rest of the filter via AND."}}},"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","description":"Filter that selects Racks whose power state should be updated"},"state":{"type":"string","enum":["on","off","cycle","forceoff","forcecycle"],"description":"Target power state"},"ruleId":{"type":"string","format":"uuid","description":"Optional Operation Rule UUID. When set, pins every task spawned by\nthis batch to the named rule and overrides Flow's default rule\nresolution."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"When true, proceed even if one or more target components (or hosts\non the owning rack for rack-scoped components) are reported as not\nready by their persisted status. Intended for operator-supervised\nmaintenance."}}},"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","description":"Filter that selects Trays whose power state should be updated"},"state":{"type":"string","enum":["on","off","cycle","forceoff","forcecycle"],"description":"Target power state"},"ruleId":{"type":"string","format":"uuid","description":"Optional Operation Rule UUID. When set, pins every task spawned by\nthis batch to the named rule and overrides Flow's default rule\nresolution."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"When true, proceed even if one or more target components (or hosts\non the owning rack for rack-scoped components) are reported as not\nready by their persisted status. Intended for operator-supervised\nmaintenance."}}},"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","description":"Filter that selects Racks targeted for firmware update"},"version":{"type":["string","null"],"description":"Target firmware version."},"ruleId":{"type":"string","format":"uuid","description":"Optional Operation Rule UUID. When set, pins every task spawned by\nthis batch to the named rule and overrides Flow's default rule\nresolution."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"When true, proceed even if one or more target components (or hosts\non the owning rack for rack-scoped components) are reported as not\nready by their persisted status. Intended for operator-supervised\nmaintenance."}}},"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"},"ruleId":{"type":"string","format":"uuid","description":"Optional Operation Rule UUID. When set, pins this bring-up to the\nnamed rule and overrides Flow's default rule resolution."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"When true, proceed even if one or more target components (or hosts\non the owning rack) are reported as not ready by their persisted\nstatus. Intended for operator-supervised maintenance."}},"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":"Filter that selects Racks targeted for bring-up"},"description":{"type":"string","description":"Optional description for the bring up operation"},"ruleId":{"type":"string","format":"uuid","description":"Optional Operation Rule UUID. When set, pins every bring-up task\nspawned by this batch to the named rule and overrides Flow's default\nrule resolution."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"When true, proceed even if one or more target components (or hosts\non the owning rack) are reported as not ready by their persisted\nstatus. Intended for operator-supervised maintenance."}}},"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"]}]},"Task":{"title":"Task","type":"object","description":"A task representing an asynchronous, site-scoped operation against rack, tray, or other site 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."},"ruleId":{"type":["string","null"],"format":"uuid","description":"Operation Rule that Flow resolved for this task — either because\nthe caller pinned one via `ruleId` on the originating request or\nbecause Flow's default rule resolution picked it. Null if Flow\nhas not yet recorded a resolution."},"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."},"report":{"allOf":[{"$ref":"#/components/schemas/TaskReportV1"}],"description":"Structured v1 execution report for the task. Populated on single-task `GET` and `cancel` responses, and on list responses only when `includeReport=true` is set. Omitted when the task has not yet produced a report (e.g. still queued) or when the caller did not opt in on list endpoints.\n\nA future schema revision will be exposed as a new `TaskReportV2` schema referenced from a parallel response field; v1 consumers are not disturbed by that bump.\n"}},"examples":[{"id":"550e8400-e29b-41d4-a716-446655440000","status":"Running","description":"Power on rack components","message":"Processing 3 of 5 components","ruleId":"7c9e6679-7425-40de-944b-e07fc1f90ae7","report":{"version":1,"stages":[{"number":1,"status":"completed","startedAt":"2026-06-08T18:00:00Z","finishedAt":"2026-06-08T18:00:42Z","steps":[{"componentType":"Compute","status":"completed","totalComponents":4,"startedAt":"2026-06-08T18:00:00Z","finishedAt":"2026-06-08T18:00:42Z"}]},{"number":2,"status":"running","startedAt":"2026-06-08T18:00:42Z","steps":[{"componentType":"NVLSwitch","status":"running","totalComponents":2,"startedAt":"2026-06-08T18:00:42Z"},{"componentType":"PowerShelf","status":"skipped","totalComponents":0}]}]}}]},"OperationRule":{"title":"OperationRule","type":"object","description":"An Operation Rule template for a single (operationType, operationCode) tuple.\nThe `ruleDefinition` carries the executable schedule (stages, per-component\nconcurrency, actions, retry) Flow runs when this rule is selected for an\noperation.","required":["id","name","operationType","operationCode","ruleDefinition","isDefault","created","updated"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the rule."},"name":{"type":"string","description":"Human-readable name of the rule. Required and non-empty."},"description":{"type":"string","description":"Optional free-form description."},"operationType":{"type":"string","enum":["PowerControl","FirmwareControl"],"description":"Type of operation this rule applies to. Immutable after creation."},"operationCode":{"type":"string","description":"Operation code within the operation type (e.g. `power_on`, `power_off`,\n`upgrade`). Server-side validated against Flow's allow-list for the type.\nImmutable after creation."},"ruleDefinition":{"$ref":"#/components/schemas/RuleDefinition"},"isDefault":{"type":"boolean","description":"Whether this rule is currently the default for its `(operationType,\noperationCode)` tuple."},"created":{"type":"string","format":"date-time","description":"Timestamp when the rule was created."},"updated":{"type":"string","format":"date-time","description":"Timestamp when the rule was last updated."}}},"RuleDefinition":{"title":"RuleDefinition","type":"object","description":"Executable definition of a rule. Mirrors Flow's wire schema 1:1 so existing\nYAML rule files can be converted to JSON without any key renaming\n(nested fields use `snake_case`).","required":["version"],"properties":{"version":{"type":"string","description":"Schema version. Currently always `v1`.","enum":["v1"]},"steps":{"type":"array","description":"Ordered execution steps. Steps with the same `stage` run in parallel,\nstages run sequentially in ascending numerical order. May be empty for\noperations whose sequencing is hardcoded in Flow (e.g. bring-up,\nfirmware update).","items":{"$ref":"#/components/schemas/SequenceStep"}}}},"SequenceStep":{"title":"SequenceStep","type":"object","description":"A single execution step inside a `RuleDefinition`.","required":["componentType","stage","mainOperation"],"properties":{"componentType":{"type":"string","description":"Component type this step targets (e.g. `Compute`, `NVLSwitch`,\n`PowerShelf`). Validated against Flow's component-type set."},"stage":{"type":"integer","minimum":1,"description":"Stage number; steps with the same stage run in parallel, lower stages run\nfirst. Component types must be unique within a stage."},"maxParallel":{"type":"integer","minimum":0,"description":"Maximum number of components of this type processed concurrently. `0`\nmeans unlimited, `1` means strictly sequential."},"timeout":{"type":"string","description":"Optional child-workflow timeout for this step, as a Go duration string\n(e.g. `30s`, `2m`). Applies to pre + main + post combined."},"retry":{"$ref":"#/components/schemas/RetryPolicy"},"preOperation":{"type":"array","description":"Actions to run before the main operation.","items":{"$ref":"#/components/schemas/ActionConfig"}},"mainOperation":{"$ref":"#/components/schemas/ActionConfig"},"postOperation":{"type":"array","description":"Actions to run after the main operation.","items":{"$ref":"#/components/schemas/ActionConfig"}},"delayAfter":{"type":"string","description":"Deprecated legacy field — sleep duration after this step, as a Go\nduration string. Prefer encoding the wait as an explicit `Sleep`\npost-operation action."}}},"ActionConfig":{"title":"ActionConfig","type":"object","description":"Configuration for a single action within a step.","required":["name"],"properties":{"name":{"type":"string","enum":["Sleep","PowerControl","VerifyPowerStatus","VerifyReachability","GetPowerStatus","FirmwareControl","VerifyFirmwareVersion","VerifyFirmwareConsistency","BringUpControl","WaitBringUp","InjectExpectation"],"description":"Executor-agnostic action name. Server-side validated; unknown names\nfail the rule definition."},"timeout":{"type":"string","description":"Optional per-action timeout override as a Go duration string\n(e.g. `30s`, `2m`)."},"pollInterval":{"type":"string","description":"Poll interval for actions that loop (e.g. `FirmwareControl`,\n`VerifyPowerStatus`) as a Go duration string."},"parameters":{"type":"object","additionalProperties":true,"description":"Action-specific parameters. Validated server-side against the action's\nschema. Examples:\n  - `Sleep`: `{ duration: \"30s\" }`\n  - `PowerControl`: `{ operation: \"on\" }`\n  - `VerifyPowerStatus`: `{ expected_status: \"on\" }`\n  - `VerifyReachability`: `{ component_types: [\"Compute\"], require_all: true }`\n  - `FirmwareControl`: `{ poll_interval: \"10s\", poll_timeout: \"30m\" }`"}}},"RetryPolicy":{"title":"RetryPolicy","type":"object","description":"Retry behavior for a step's child workflow.","required":["maxAttempts","initialInterval","backoffCoefficient"],"properties":{"maxAttempts":{"type":"integer","minimum":1,"description":"Maximum number of attempts including the first."},"initialInterval":{"type":"string","description":"Initial retry interval, as a Go duration string (e.g. `1s`)."},"backoffCoefficient":{"type":"number","minimum":1,"description":"Exponential backoff multiplier; must be `>= 1.0`."},"maxInterval":{"type":"string","description":"Optional cap on retry interval, as a Go duration string."}}},"CreateRuleRequest":{"title":"CreateRuleRequest","type":"object","description":"Request body for creating an Operation Rule.","required":["siteId","name","operationType","operationCode","ruleDefinition"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site to create the rule on."},"name":{"type":"string","description":"Human-readable name of the rule."},"description":{"type":"string","description":"Optional free-form description."},"operationType":{"type":"string","enum":["PowerControl","FirmwareControl"],"description":"Operation type the rule applies to."},"operationCode":{"type":"string","description":"Operation code within the operation type (e.g. `power_on`)."},"ruleDefinition":{"$ref":"#/components/schemas/RuleDefinition"}}},"UpdateRuleRequest":{"title":"UpdateRuleRequest","type":"object","description":"Request body for patching an Operation Rule. All mutable fields are optional;\nunset fields are left unchanged. At least one of `name`, `description`,\n`ruleDefinition` must be provided.","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site that owns the rule."},"name":{"type":"string","description":"New rule name. Must be non-empty when provided."},"description":{"type":"string","description":"New free-form description."},"ruleDefinition":{"$ref":"#/components/schemas/RuleDefinition"}}},"TaskRun":{"title":"TaskRun","type":"object","description":"A Task Run is a phased, policy-gated execution of one operation across\nmany Racks. List responses populate the summary fields; the\nsingle-Task-Run `GET` additionally populates `stats` when\n`includeStats=true`.","required":["id","name","operationType","status","statusReason","totalPhases","created","updated"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the Task Run."},"name":{"type":"string","description":"Human-readable name of the Task Run."},"description":{"type":"string","description":"Optional free-form description."},"operationType":{"type":"string","enum":["PowerControl","FirmwareControl"],"description":"Type of operation this Task Run executes. Currently always `FirmwareControl`."},"operationCode":{"type":"string","description":"Operation code within the operation type (e.g. `upgrade`)."},"status":{"type":"string","enum":["Unknown","Pending","Running","Paused","Completed","Cancelled","Failed","CompletedWithFailures"],"description":"Current lifecycle state of the Task Run."},"statusReason":{"type":"string","enum":["Unknown","None","OperatorPaused","PhaseGate","SafetyGate","ConflictRetryTimeout"],"description":"Why the Task Run is paused or terminal (e.g. `PhaseGate`, `SafetyGate`).\n`None` when there is no qualifying reason."},"statusMessage":{"type":"string","description":"Optional human-readable detail for the current status."},"totalPhases":{"type":"integer","description":"Total number of phases the selected targets were divided into."},"created":{"type":"string","format":"date-time","description":"Timestamp when the Task Run was created."},"updated":{"type":"string","format":"date-time","description":"Timestamp when the Task Run was last updated."},"started":{"type":["string","null"],"format":"date-time","description":"Timestamp when the Task Run started execution. Null before it starts."},"finished":{"type":["string","null"],"format":"date-time","description":"Timestamp when the Task Run reached a terminal state. Null while active."},"stats":{"allOf":[{"$ref":"#/components/schemas/TaskRunStats"}],"description":"Derived per-phase outcome stats. Present only on the single-Task-Run\n`GET` when `includeStats=true`; omitted otherwise."}}},"TaskRunStats":{"title":"TaskRunStats","type":"object","description":"Summarizes target outcomes for the active phase and cumulatively across all phases processed so far.","required":["currentPhase","cumulativePhase"],"properties":{"currentPhase":{"$ref":"#/components/schemas/TaskRunPhaseStats"},"cumulativePhase":{"$ref":"#/components/schemas/TaskRunPhaseStats"}}},"TaskRunPhaseStats":{"title":"TaskRunPhaseStats","type":"object","description":"Summarizes target outcomes for one phase scope.","required":["phaseIndex","selectedTargets","outcomeCounts"],"properties":{"phaseIndex":{"type":"integer","description":"Zero-based index of the phase this scope refers to."},"selectedTargets":{"type":"integer","description":"Number of targets selected within the scope."},"outcomeCounts":{"$ref":"#/components/schemas/TaskRunOutcomeCounts"}}},"TaskRunOutcomeCounts":{"title":"TaskRunOutcomeCounts","type":"object","description":"Counts terminal target outcomes within a phase scope.","required":["completed","failed","terminated","skipped"],"properties":{"completed":{"type":"integer","description":"Targets that completed successfully."},"failed":{"type":"integer","description":"Targets that failed."},"terminated":{"type":"integer","description":"Targets that were terminated (e.g. by cancellation)."},"skipped":{"type":"integer","description":"Targets that were skipped."}}},"TaskRunTarget":{"title":"TaskRunTarget","type":"object","description":"One materialized per-Rack execution target of a Task Run. Each target\ndrives at most one Task; `taskId` references it (null until the target is\nsubmitted).","required":["id","runId","rackId","sequenceIndex","phaseIndex","status","created","updated"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the target."},"runId":{"type":"string","format":"uuid","description":"ID of the Task Run that owns this target."},"rackId":{"type":"string","format":"uuid","description":"ID of the Rack this target operates on."},"sequenceIndex":{"type":"integer","description":"Position of this target in the Task Run's overall processing order."},"phaseIndex":{"type":"integer","description":"Zero-based index of the phase this target belongs to."},"taskId":{"type":["string","null"],"format":"uuid","description":"ID of the Task this target submitted. Null until the target is\nsubmitted; drill into execution detail via `GET /task/{taskId}`."},"status":{"type":"string","enum":["Unknown","Pending","Blocked","Submitted","Completed","Failed","Terminated","Skipped","Claimed"],"description":"Current execution state of the target."},"message":{"type":"string","description":"Optional human-readable detail for the current target status."},"created":{"type":"string","format":"date-time","description":"Timestamp when the target was created."},"updated":{"type":"string","format":"date-time","description":"Timestamp when the target was last updated."}}},"TaskRunSiteRequest":{"title":"TaskRunSiteRequest","type":"object","description":"Shared request body for the pause and resume lifecycle actions.","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site that owns the Task Run (Task Runs are site-scoped)."}}},"AdvanceTaskRunRequest":{"title":"AdvanceTaskRunRequest","type":"object","description":"Request body for advancing a Task Run to its next phase.","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site that owns the Task Run."},"expectedPhaseIndex":{"type":"integer","description":"Optional guard: when set, the phase that would be opened must match\nthis zero-based index, otherwise the advance is rejected."}}},"CancelTaskRunRequest":{"title":"CancelTaskRunRequest","type":"object","description":"Request body for cancelling a Task Run.","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site that owns the Task Run."},"reason":{"type":"string","description":"Optional free-form reason recorded with the cancellation."}}},"CreateTaskRunRequest":{"title":"CreateTaskRunRequest","type":"object","description":"Request body for creating a Task Run. `operationType` is inferred from the\noperation and is not accepted here. Flow performs semantic validation\n(selector ranges, phase math, operation code membership) server-side.","required":["siteId","name","options","operation"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site to create the Task Run on."},"name":{"type":"string","description":"Human-readable name of the Task Run."},"description":{"type":"string","description":"Optional free-form description."},"selector":{"allOf":[{"$ref":"#/components/schemas/TaskRunSelector"}],"description":"Narrows the candidate Racks. Omit to target the full candidate scope\n(100%)."},"options":{"$ref":"#/components/schemas/TaskRunOptions"},"operation":{"$ref":"#/components/schemas/TaskRunOperation"}}},"TaskRunSelector":{"title":"TaskRunSelector","type":"object","description":"Selects a subset of candidate Racks. Percentage is the only supported selector today.","properties":{"percentage":{"$ref":"#/components/schemas/TaskRunPercentageSelector"}}},"TaskRunPercentageSelector":{"title":"TaskRunPercentageSelector","type":"object","description":"Selects a percentage of the candidate Racks. `seed` is optional; when\nomitted Flow generates and stores one so the cohort is deterministic and\nauditable.","required":["percent"],"properties":{"percent":{"type":"integer","minimum":0,"maximum":100,"description":"Percentage of candidate Racks to select."},"seed":{"type":"string","description":"Optional seed for the deterministic selection."}}},"TaskRunOptions":{"title":"TaskRunOptions","type":"object","description":"Execution policy for the Task Run.","required":["maxConcurrentTargets"],"properties":{"maxConcurrentTargets":{"type":"integer","minimum":1,"description":"Caps how many targets may have active child Tasks at once. Must be\ngreater than zero."},"safetyPolicy":{"$ref":"#/components/schemas/TaskRunSafetyPolicy"},"conflictPolicy":{"$ref":"#/components/schemas/TaskRunConflictPolicy"},"orderingPolicy":{"$ref":"#/components/schemas/TaskRunOrderingPolicy"},"phasePolicy":{"$ref":"#/components/schemas/TaskRunPhasePolicy"}}},"TaskRunSafetyPolicy":{"title":"TaskRunSafetyPolicy","type":"object","description":"A set of gates that pause the Task Run when any one of them trips (OR composition).","properties":{"gates":{"type":"array","description":"Safety gates evaluated after each target outcome.","items":{"$ref":"#/components/schemas/TaskRunSafetyGate"}}}},"TaskRunSafetyGate":{"title":"TaskRunSafetyGate","type":"object","description":"Exactly one of `failureRate` or `failureCount` must be set.","properties":{"failureRate":{"$ref":"#/components/schemas/TaskRunFailureRateGate"},"failureCount":{"$ref":"#/components/schemas/TaskRunFailureCountGate"}}},"TaskRunFailureRateGate":{"title":"TaskRunFailureRateGate","type":"object","description":"Pauses when the failed/planned ratio reaches `thresholdPercent` for the scope.","required":["thresholdPercent"],"properties":{"scope":{"type":"string","enum":["currentPhase","cumulativeRun"],"default":"currentPhase","description":"Whether the ratio is evaluated over the current phase or the cumulative run."},"thresholdPercent":{"type":"integer","minimum":0,"maximum":100,"description":"Failure-rate percentage at which the gate trips."}}},"TaskRunFailureCountGate":{"title":"TaskRunFailureCountGate","type":"object","description":"Pauses when the number of failed targets reaches `thresholdCount` for the scope.","required":["thresholdCount"],"properties":{"scope":{"type":"string","enum":["currentPhase","cumulativeRun"],"default":"currentPhase","description":"Whether the count is evaluated over the current phase or the cumulative run."},"thresholdCount":{"type":"integer","minimum":0,"description":"Number of failed targets at which the gate trips."}}},"TaskRunConflictPolicy":{"title":"TaskRunConflictPolicy","type":"object","description":"Configures how blocked targets are retried. Retry is the only supported strategy today.","properties":{"retry":{"$ref":"#/components/schemas/TaskRunConflictRetry"}}},"TaskRunConflictRetry":{"title":"TaskRunConflictRetry","type":"object","description":"Retry backoff for blocked targets. Durations are Go duration strings\n(e.g. `30m`, `10s`); an empty value means \"use the operation default\".","properties":{"retryTimeout":{"type":"string","description":"Total time to keep retrying a blocked target before giving up."},"initialRetryDelay":{"type":"string","description":"Delay before the first retry."},"maxRetryDelay":{"type":"string","description":"Cap on the exponentially growing retry delay."}}},"TaskRunOrderingPolicy":{"title":"TaskRunOrderingPolicy","type":"object","description":"Controls the order in which targets are processed. Random is the only supported ordering today.","properties":{"random":{"$ref":"#/components/schemas/TaskRunRandomOrdering"}}},"TaskRunRandomOrdering":{"title":"TaskRunRandomOrdering","type":"object","description":"Orders targets randomly. `seed` is optional; Flow generates and stores one when omitted.","properties":{"seed":{"type":"string","description":"Optional seed for the deterministic random ordering."}}},"TaskRunPhasePolicy":{"title":"TaskRunPhasePolicy","type":"object","description":"Divides the selected targets into phases. Set at most one of `equal`,\n`percentage`, or `count`; omit the whole policy for a single phase\ncovering all targets.","properties":{"equal":{"$ref":"#/components/schemas/TaskRunEqualPhases"},"percentage":{"$ref":"#/components/schemas/TaskRunPercentagePhases"},"count":{"$ref":"#/components/schemas/TaskRunCountPhases"},"autoAdvance":{"type":"boolean","default":false,"description":"When true, phases advance automatically as long as safety gates are\nnot tripped. When false (default) each completed phase pauses at a\nphase gate until advanced explicitly."}}},"TaskRunEqualPhases":{"title":"TaskRunEqualPhases","type":"object","description":"Splits targets into `phaseCount` roughly equal phases.","required":["phaseCount"],"properties":{"phaseCount":{"type":"integer","minimum":1,"description":"Number of equally sized phases."}}},"TaskRunPercentagePhases":{"title":"TaskRunPercentagePhases","type":"object","description":"Splits targets by percentage. Values must sum to 100.","required":["phases"],"properties":{"phases":{"type":"array","description":"Per-phase percentages, in phase order; must sum to 100.","items":{"type":"integer","minimum":0,"maximum":100}}}},"TaskRunCountPhases":{"title":"TaskRunCountPhases","type":"object","description":"Splits targets by explicit counts. A generated final phase covers any remaining targets.","required":["phases"],"properties":{"phases":{"type":"array","description":"Per-phase target counts, in phase order.","items":{"type":"integer","minimum":0}}}},"TaskRunOperation":{"title":"TaskRunOperation","type":"object","description":"The operation the Task Run executes. Firmware is the only supported operation today.","required":["firmware"],"properties":{"firmware":{"$ref":"#/components/schemas/TaskRunFirmwareOperation"},"excludeRunIds":{"type":"array","description":"Excludes Racks materialized by prior Task Runs from this Task Run's\ncandidate scope.","items":{"type":"string","format":"uuid"}}}},"TaskRunFirmwareOperation":{"title":"TaskRunFirmwareOperation","type":"object","description":"Configures a firmware rollout.","required":["version"],"properties":{"version":{"type":"string","description":"Target firmware version to roll out."},"ruleId":{"type":["string","null"],"format":"uuid","description":"Operation Rule to pin for each target's firmware Task. Null to let\nFlow's default rule resolution pick one."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"Skip the pre-flight readiness check when true."},"subTargets":{"type":"array","description":"Optional subset of firmware sub-targets to update.","items":{"type":"string"}}}},"TaskReportV1":{"title":"TaskReportV1","type":"object","description":"Structured execution report (version 1) for a Flow-scheduled task.\nThe document mirrors the structure of the operation rule that drives the workflow: each `Stage` corresponds to one rule stage and each `Step` within a stage corresponds to one rule sequence step at the same index.\n\nClients pick the decoder by the `version` field; future report schemas will be exposed as `TaskReportV2` etc. and conveyed via a parallel response field, leaving v1 consumers untouched.\n","required":["version","stages"],"properties":{"version":{"type":"integer","enum":[1],"description":"Schema version of this report. Always `1` for `TaskReportV1`."},"stages":{"type":"array","items":{"$ref":"#/components/schemas/TaskReportV1Stage"}},"error":{"type":"string","description":"Top-level failure summary: the message from the first stage that fails in this report. Not overwritten by subsequent failures, so it remains the canonical task-level error. Truncated to 512 bytes by the producer.\n"}}},"TaskReportV1Stage":{"title":"TaskReportV1Stage","type":"object","description":"Execution state of one rule stage. `number` is the canonical key for joining a stage record back to its rule entry.\n","required":["number","status","steps"],"properties":{"number":{"type":"integer","minimum":1,"description":"1-based rule stage number."},"status":{"$ref":"#/components/schemas/TaskReportV1Status"},"steps":{"type":"array","items":{"$ref":"#/components/schemas/TaskReportV1Step"}},"startedAt":{"type":"string","format":"date-time","description":"Set when the stage leaves `pending`."},"finishedAt":{"type":"string","format":"date-time","description":"Set when the stage reaches a terminal state."},"error":{"type":"string","description":"Failure summary when `status == failed`. Truncated to 512 bytes."}}},"TaskReportV1Step":{"title":"TaskReportV1Step","type":"object","description":"Execution state of one rule sequence step. Pairs 1:1 with the rule's ordered steps within the containing stage and shares its index.\n","required":["componentType","status"],"properties":{"componentType":{"type":"string","description":"Component class this step targets, e.g. `Compute`, `NVLSwitch`, `PowerShelf`."},"status":{"$ref":"#/components/schemas/TaskReportV1Status"},"totalComponents":{"type":"integer","description":"Count of components of `componentType` this step targets. Surfaced here because the task representation does not include the per-type component map.\n"},"completedComponents":{"type":"integer","description":"Reserved for a future best-effort activity contract that reports per-component outcomes. Not written under the current fail-fast contract and omitted by the producer.\n"},"failedComponents":{"type":"integer","description":"Reserved (see `completedComponents`)."},"startedAt":{"type":"string","format":"date-time","description":"Set when the step leaves `pending`. `skipped` steps carry no timestamp."},"finishedAt":{"type":"string","format":"date-time","description":"Set when the step reaches a terminal state."},"error":{"type":"string","description":"Failure summary when `status == failed`. Truncated to 512 bytes."}}},"TaskReportV1Status":{"title":"TaskReportV1Status","type":"string","description":"Per-stage and per-step execution status.\n\n- `pending`   — workflow has not yet reached this stage/step.\n- `running`   — execution is in progress.\n- `completed` — execution finished successfully.\n- `failed`    — execution finished with an error; see `error`.\n- `skipped`   — the rule lists this component type but the task targets no components of that type, so the workflow will not invoke it.\n","enum":["pending","running","completed","failed","skipped"]},"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","description":"Filter that selects Trays targeted for firmware update"},"version":{"type":["string","null"],"description":"Target firmware version."},"targets":{"type":"array","items":{"type":"string","minLength":1,"enum":["bmc","cpld","bios","nvos","pmc","psu","dpu"]},"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 `NICo-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) for compute-tray-internal targets.\nUnknown names are rejected. Requires `version` to be set.\nThe special target `dpu`, valid only on compute trays,\nrequests DPU reprovisioning on each matched host. Unlike\nthe other targets, `dpu` is NOT covered by the\n\"omitted/empty means everything\" default — it must be\nlisted explicitly. `version` is ignored on the `dpu`\nbranch; the target firmware version comes from site\nconfiguration."},"ruleId":{"type":"string","format":"uuid","description":"Optional Operation Rule UUID. When set, pins every task spawned by\nthis batch to the named rule and overrides Flow's default rule\nresolution."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"When true, proceed even if one or more target components (or hosts\non the owning rack for rack-scoped components) are reported as not\nready by their persisted status. Intended for operator-supervised\nmaintenance."}},"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)"},"ruleId":{"type":"string","format":"uuid","description":"Optional Operation Rule UUID. When set, pins this operation to the\nnamed rule and overrides Flow's default rule resolution."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"When true, proceed even if one or more target components (or hosts\non the owning rack for rack-scoped components) are reported as not\nready by their persisted status. Intended for operator-supervised\nmaintenance."}},"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","dpu"]},"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 `NICo-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) for compute-tray-internal targets.\nUnknown names are rejected. Requires `version` to be set.\nThe special target `dpu`, valid only on compute trays,\nrequests DPU reprovisioning on the matched host. Unlike\nthe other targets, `dpu` is NOT covered by the\n\"omitted/empty means everything\" default — it must be\nlisted explicitly. `version` is ignored on the `dpu`\nbranch; the target firmware version comes from site\nconfiguration."},"ruleId":{"type":"string","format":"uuid","description":"Optional Operation Rule UUID. When set, pins this firmware update to\nthe named rule and overrides Flow's default rule resolution."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"When true, proceed even if one or more target components (or hosts\non the owning rack for rack-scoped components) are reported as not\nready by their persisted status. Intended for operator-supervised\nmaintenance."}},"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,"scoutVersion":"2.6.1","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"},"description":"List of capabilities of the machine"},"machineInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/MachineInterface"},"description":"List of admin interfaces of the machine"},"associatedDpuMachineIds":{"type":"array","items":{"type":"string"},"description":"IDs of the DPU Machines attached to this host Machine","readOnly":true},"placementInRack":{"$ref":"#/components/schemas/PlacementInRack","description":"Physical placement of the Machine within its Rack, when known"},"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"},"scoutVersion":{"type":["string","null"],"description":"Scout version reported by the Machine, if known","readOnly":true},"health":{"$ref":"#/components/schemas/MachineHealth","description":"Health information about the machine"},"metadata":{"$ref":"#/components/schemas/MachineMetadata","description":"Only available to Providers. Returned if the `includeMetadata` query parameter is specified. Otherwise attribute is omitted from response."},"labels":{"$ref":"#/components/schemas/Labels","description":"User-specified Machine labels"},"status":{"$ref":"#/components/schemas/MachineStatus","description":"Status represents the status of the machine","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"},"description":"Chronological status history for the Machine"},"created":{"type":"string","description":"Date/time when the Machine was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Machine was last updated","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","description":"Status represents the status of the machine","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 by sending a merge-mode health override with source: `request-online-repair` and sets the associated Instance status to Repairing.\nWhen false, exits online repair by clearing the merge-mode health override and returns the Instance to Ready status. Cannot be combined with instance type, maintenance, or label updates in the same request."},"policy":{"$ref":"#/components/schemas/MachineOnlineRepairPolicy","description":"Online repair policy to apply to the Machine"},"acknowledgments":{"$ref":"#/components/schemas/MachineOnlineRepairAcknowledgments","description":"Acknowledgments required before online repair can proceed"}}},"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","description":"Request to enter/exit online repair"},"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","description":"Unique UUID v4 identifier for the Machine Interface","format":"uuid"},"machineId":{"type":"string","description":"ID of the Machine"},"controllerInterfaceId":{"type":["string","null"],"description":"ID of the interface in Site Controller","format":"uuid"},"controllerSegmentId":{"type":["string","null"],"description":"ID of the network segment in Site Controller","format":"uuid"},"attachedDpuMachineID":{"type":["string","null"],"description":"ID of the DPU attached to this interface in the Site Controller"},"subnetId":{"type":["string","null"],"description":"ID of the Subnet","format":"uuid"},"hostname":{"type":["string","null"],"description":"Hostname of the Machine Interface","format":"hostname"},"isPrimary":{"type":"boolean","description":"Boolean which indicates if the Machine Interface is primary"},"macAddress":{"type":["string","null"],"description":"Mac address of the Machine Interface"},"ipAddresses":{"type":"array","description":"Array of IP addresses","items":{"type":"string"}},"created":{"type":"string","description":"Date/time when the Machine Interface was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Machine Interface was last updated","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"}],"lifecycleState":{"value":"Ready","isAboveSLA":false,"updated":"2026-01-15T12:00:00Z","slaSeconds":300}}],"properties":{"dmiData":{"$ref":"#/components/schemas/MachineDMIData","description":"DMI data of the machine"},"bmcInfo":{"$ref":"#/components/schemas/MachineBMCInfo","description":"BMC Info of the machine"},"gpus":{"type":"array","items":{"$ref":"#/components/schemas/MachineGPUInfo"},"description":"GPU inventory reported for the Machine"},"networkInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/MachineNetworkInterface"},"description":"List of Ethernet interfaces of the machine"},"infinibandInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/MachineInfiniBandInterface"},"description":"List of InfiniBand interfaces of the machine"},"lifecycleState":{"oneOf":[{"$ref":"#/components/schemas/MachineLifecycleState"},{"type":"null"}],"description":"Lifecycle state details for the Machine"}}},"MachineLifecycleState":{"title":"MachineLifecycleState","type":"object","description":"Describes the current Machine lifecycle state and its SLA status","required":["value","isAboveSLA","slaSeconds"],"examples":[{"value":"Ready","isAboveSLA":false,"updated":"2026-01-15T12:00:00Z","slaSeconds":300}],"properties":{"value":{"type":"string","description":"Current lifecycle state value of the Machine"},"isAboveSLA":{"type":"boolean","description":"Whether the Machine has been in the current state longer than the defined SLA"},"updated":{"type":["string","null"],"description":"Date/time when the lifecycle state was updated to the current value","format":"date-time"},"slaSeconds":{"type":"integer","format":"int64","description":"Defined SLA for the current lifecycle state in seconds"}}},"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"],"description":"IP address of the Machine BMC","format":"ipv4"},"mac":{"type":["string","null"],"description":"MAC address of the Machine BMC"},"version":{"type":["string","null"],"description":"Version reported by the Machine BMC"},"firmwareRevision":{"type":["string","null"],"description":"Firmware revision reported by the Machine BMC"}}},"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"],"description":"DMI board name reported by the Machine"},"boardSerial":{"type":["string","null"],"description":"DMI board serial number reported by the Machine"},"boardVersion":{"type":["string","null"],"description":"DMI board version reported by the Machine"},"biosDate":{"type":["string","null"],"description":"DMI BIOS release date reported by the Machine"},"biosVersion":{"type":["string","null"],"description":"DMI BIOS version reported by the Machine"},"productName":{"type":["string","null"],"description":"DMI product name reported by the Machine"},"productSerial":{"type":["string","null"],"description":"DMI product serial number reported by the Machine"},"chassisSerial":{"type":["string","null"],"description":"DMI chassis serial number reported by the Machine"},"sysVendor":{"type":["string","null"],"description":"DMI system vendor reported by the Machine"}}},"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"],"description":"Name of the Machine's GPU"},"serial":{"type":["string","null"],"description":"Serial number of the Machine's GPU"},"driverVersion":{"type":["string","null"],"description":"Version of the Machine's GPU driver"},"vbiosVersion":{"type":["string","null"],"description":"Bios version of the Machine's GPU"},"inforomVersion":{"type":["string","null"],"description":"Info rom version of the Machine's GPU"},"totalMemory":{"type":["string","null"],"description":"Total memory of the Machine's GPU"},"frequency":{"type":["string","null"],"description":"Frequency of the Machine's GPU"},"pciBusId":{"type":["string","null"],"description":"PCI BusId of the Machine's GPU"}}},"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","required":["id"],"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","required":["id","message"],"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"],"format":"date-time","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"}}},"PlacementInRack":{"title":"PlacementInRack","type":"object","description":"Physical placement of a Machine within its Rack","examples":[{"slotNumber":1,"trayIndex":0}],"properties":{"slotNumber":{"type":["integer","null"],"format":"int32","description":"Rack slot the Machine occupies"},"trayIndex":{"type":["integer","null"],"format":"int32","description":"Index of the Machine's tray within its slot"}}},"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"],"description":"Name of the Machine's NetworkInterface"},"vendor":{"type":["string","null"],"description":"Serial number of the Machine's NetworkInterface"},"device":{"type":["string","null"],"description":"Device number of the Machine's NetworkInterface"},"path":{"type":["string","null"],"description":"Bios path of the Machine's NetworkInterface"},"numaNode":{"type":"integer","description":"Info of numa node Machine's NetworkInterface"},"description":{"type":["string","null"],"description":"Description the Machine's NetworkInterface"},"slot":{"type":["string","null"],"description":"Slot number of the Machine's NetworkInterface"}}},"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"],"description":"Guid of the Machine's InfiniBandInterface"},"vendor":{"type":["string","null"],"description":"Serial number of the Machine's InfiniBandInterface"},"device":{"type":["string","null"],"description":"Device number of the Machine's InfiniBandInterface"},"path":{"type":["string","null"],"description":"Bios path of the Machine's InfiniBandInterface"},"numaNode":{"type":"integer","description":"Info of numa node Machine's InfiniBandInterface"},"description":{"type":["string","null"],"description":"Description the Machine's InfiniBandInterface"},"slot":{"type":["string","null"],"description":"Slot number of the Machine's InfiniBandInterface"}}},"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","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","description":"ID of the associated Machine"},"instanceTypeId":{"type":"string","description":"ID of the associated Instance Type","format":"uuid"},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"},"description":"Deprecations active for this resource. Returned only if there are active deprecations."},"created":{"type":"string","description":"Date and time the Machine Instance Type was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date and time the Machine Instance Type was last updated","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","description":"ID of the Machine","minItems":1,"items":{"type":"string"}}},"required":["machineIds"]},"HostLifecycleProfile":{"title":"HostLifecycleProfile","type":"object","description":"Per-host lifecycle settings that affect how NICo progresses a host through its state machine.","properties":{"disableLockdown":{"type":["boolean","null"],"description":"When true, the server is not locked down during host lifecycle management. When omitted, the existing value is preserved."}}},"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","isDpfEnabled":true,"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"},"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"},"isDpfEnabled":{"type":"boolean","description":"When true, this host is eligible for DPF-based provisioning."},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Machines"},"hostLifecycleProfile":{"$ref":"#/components/schemas/HostLifecycleProfile","description":"Optional per-host lifecycle profile"},"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","isDpfEnabled":true,"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":16,"description":"Username for accessing the Expected Machine's BMC"},"defaultBmcPassword":{"type":["string","null"],"maxLength":20,"description":"Password for accessing the Expected Machine's BMC"},"chassisSerialNumber":{"type":"string","minLength":1,"maxLength":32,"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"},"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"},"isDpfEnabled":{"type":["boolean","null"],"description":"When true, this host is eligible for DPF-based provisioning."},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Machines"},"hostLifecycleProfile":{"$ref":"#/components/schemas/HostLifecycleProfile","description":"Optional per-host lifecycle profile"}},"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","isDpfEnabled":false,"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})$","deprecated":true,"description":"The Expected Machine's BMC MAC address is immutable after creation. Omit this field, or provide another case/separator spelling of the current MAC as a compatibility no-op."},"defaultBmcUsername":{"type":["string","null"],"maxLength":16,"description":"Username for accessing the Expected Machine's BMC"},"defaultBmcPassword":{"type":["string","null"],"maxLength":20,"description":"Password for accessing the Expected Machine's BMC"},"chassisSerialNumber":{"type":["string","null"],"minLength":1,"maxLength":32,"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). A non-empty address sets the value and pre-allocates a reserved IP for the BMC. An empty string clears the value. Omission or null preserves the current value."},"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"},"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"},"isDpfEnabled":{"type":["boolean","null"],"description":"When true, this host is eligible for DPF-based provisioning."},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Machines"},"hostLifecycleProfile":{"$ref":"#/components/schemas/HostLifecycleProfile","description":"Optional per-host lifecycle profile"}}},"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"},"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"},"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})$","deprecated":true,"description":"Immutable MAC address of the Expected Power Shelf's BMC (Baseboard Management Controller).\nOmit this field when updating. A formatting-equivalent value is accepted for compatibility\nand preserves the originally stored spelling, but changing the physical MAC address is rejected\nwith HTTP 400."},"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"},"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\nThe `rackId` field is immutable on update — omit it or provide the existing value.\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,"deprecated":true,"description":"Operator-supplied rack identifier. Immutable on update: omit this field, send `null`, or provide the existing value as a compatibility no-op. A changed value is rejected because Core and Flow use rackId as the identity key for expected racks."},"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","nvosMacAddresses":["00:1A:2B:3C:4D:60","00:1A:2B:3C:4D:61"],"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"},"nvosMacAddresses":{"type":"array","uniqueItems":true,"description":"MAC addresses of the Expected Switch's NvOS management interfaces","items":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$"}},"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"},"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","nvosMacAddresses":["00:1A:2B:3C:4D:60","00:1A:2B:3C:4D:61"],"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"},"nvosMacAddresses":{"type":"array","uniqueItems":true,"description":"MAC addresses of the Expected Switch's NvOS management interfaces","items":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$"}},"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"},"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","nvosMacAddresses":["00:1A:2B:3C:4D:62","00:1A:2B:3C:4D:63"],"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})$","deprecated":true,"description":"Immutable MAC address of the Expected Switch's BMC (Baseboard Management Controller).\nOmit this field when updating. A formatting-equivalent value is accepted for compatibility\nand preserves the originally stored spelling, but changing the physical MAC address is rejected\nwith HTTP 400."},"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"},"nvosMacAddresses":{"type":"array","uniqueItems":true,"description":"MAC addresses of the Expected Switch's NvOS management interfaces","items":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$"}},"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"},"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","description":"Lenovo SR650 V2 compute node","schemaVersion":5,"deviceType":"gpu","associatedMachineIds":["fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g"],"components":{"cpus":[{"vendor":"Intel","model":"Xeon Platinum 8480+","threadCount":112,"count":2}],"gpus":[{"vendor":"NVIDIA","model":"H100 SXM5","totalMemory":"80GB HBM3","count":8}],"memory":[{"capacityMb":65536,"memoryType":"DDR5","count":16}],"storage":[{"vendor":"Samsung","model":"PM9A3","capacityMb":7680000,"count":4}],"chassis":{"vendor":"Supermicro","model":"SYS-420GP-TNR"}},"created":"2019-08-24T14:15:22Z"}],"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},"description":{"type":"string","description":"Human-readable SKU description","readOnly":true},"schemaVersion":{"type":"integer","format":"uint32","description":"Core SKU schema version when available","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, using the Site-reported timestamp when available","readOnly":true}}},"SkuCreateRequest":{"title":"SkuCreateRequest","type":"object","description":"Request data to create a SKU on a Site's NICo Core service.","examples":[{"siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","id":"dgx-h100","description":"DGX H100 compute node","deviceType":"gpu-server","components":{"chassis":{"vendor":"NVIDIA","model":"DGX H100","architecture":"x86_64"}}}],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the SKU will be created"},"id":{"type":"string","minLength":1,"description":"Unique SKU identifier"},"description":{"type":"string","description":"Human-readable SKU description"},"deviceType":{"type":["string","null"],"description":"Optional device type identifier"},"components":{"$ref":"#/components/schemas/SkuComponents"}},"required":["siteId","id","components"]},"SkuUpdateRequest":{"title":"SkuUpdateRequest","type":"object","description":"Request data to update a SKU.\nAt least one of description, deviceType, or components must be provided.\nThe service preserves the schema version for metadata-only updates.\nComponent updates replace the SKU using the current schema version,\nmigrating legacy SKU schemas to the current format.","examples":[{"description":"DGX H100 compute node with InfiniBand","components":{"infinibandDevices":[{"vendor":"Mellanox Technologies","model":"MT2910 Family [ConnectX-7]","count":4,"inactiveDevices":[]}]}}],"properties":{"description":{"type":"string","description":"Replacement SKU description"},"deviceType":{"type":"string","description":"Replacement device type identifier"},"components":{"$ref":"#/components/schemas/SkuComponents"}}},"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","readOnly":true,"description":"Read-only Ethernet device components reported by Core. Omit this property from REST mutation requests; null and an empty array are accepted for compatibility, while a non-empty array is rejected with HTTP 400.","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","examples":[{"vendor":"ARM","model":"Neoverse-V2","threadCount":72,"count":2}],"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","examples":[{"vendor":"NVIDIA","model":"NVIDIA GB200","totalMemory":"189471 MiB","count":4}],"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","examples":[{"capacityMb":491520,"memoryType":"LPDDR5","count":2}],"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","examples":[{"vendor":"","model":"SAMSUNG MZ1L21T9HCLS-00A07","capacityMb":0,"count":1,"minSizeMiB":1831420,"maxSizeMiB":1831420,"pciPatterns":["^/devices/pci.*nvme0$"]},{"vendor":"","model":"SAMSUNG MZTL63T8HFLT-00AW7","capacityMb":0,"count":8,"minSizeMiB":3662840,"maxSizeMiB":3662840,"pciPatterns":["^/devices/pci.*nvme[1-8]$"]}],"properties":{"vendor":{"type":"string","readOnly":true,"description":"Storage vendor used for schema version 4 matching. Read-only in REST mutation requests and preserved in responses for legacy SKUs. Schema version 5 does not use this field."},"model":{"type":"string","description":"Informational storage model. Starting with the 2.1 release, NICo does not use this field for storage matching or validation."},"capacityMb":{"type":"integer","format":"uint32","readOnly":true,"description":"Storage capacity in megabytes used for schema version 4 matching. Read-only in REST mutation requests and preserved in responses for legacy SKUs. Schema version 5 uses minSizeMiB and maxSizeMiB instead."},"count":{"type":"integer","format":"uint32","description":"Number of storage devices present"},"minSizeMiB":{"type":["integer","null"],"format":"uint32","description":"Inclusive minimum size in MiB for each storage device. Null or omission means no lower bound. Used for SKU schema version 5 and later."},"maxSizeMiB":{"type":["integer","null"],"format":"uint32","description":"Inclusive maximum size in MiB for each storage device. Null or omission means no upper bound. Used for SKU schema version 5 and later."},"pciPatterns":{"type":"array","description":"Regular expressions matched against storage sysfs PCI paths. An empty or omitted list disables PCI location matching. Used for SKU schema version 5 and later.","items":{"type":"string"}}}},"SkuChassis":{"title":"SkuChassis","type":"object","description":"Chassis component in a SKU","examples":[{"vendor":"NVIDIA","model":"GB200 NVL","architecture":"aarch64"}],"properties":{"vendor":{"type":"string","description":"Vendor of the chassis"},"model":{"type":"string","description":"Model of the chassis"},"architecture":{"type":"string","description":"Architecture 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"},"isConnected":{"type":"boolean","description":"Whether the ethernet device is connected"}}},"SkuInfinibandDevice":{"title":"SkuInfinibandDevice","type":"object","description":"Infiniband device component in a SKU","examples":[{"vendor":"Mellanox Technologies","model":"MT2910 Family [ConnectX-7]","count":4,"inactiveDevices":[]}],"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"},"inactiveDevices":{"type":"array","description":"Zero-based indexes of inactive devices","items":{"type":"integer","format":"uint32"}}}},"SkuTpm":{"title":"SkuTpm","type":"object","description":"TPM component in a SKU","properties":{"vendor":{"type":"string","description":"Vendor of the TPM"},"version":{"type":"string","description":"Version of the TPM"}}},"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","description":"Unique UUID v4 identifier for the IP Block","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the IP Block","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the IP Block"},"siteId":{"type":"string","description":"ID of the Site","format":"uuid"},"infrastructureProviderId":{"type":"string","description":"ID of the Infrastructure Provider","format":"uuid"},"tenantId":{"type":["string","null"],"description":"ID of the Tenant","format":"uuid"},"routingType":{"type":"string","description":"RoutingType of the IP Block","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","description":"Version of the ip network IPv4 or IPv6","enum":["IPv4","IPv6"]},"usageStats":{"$ref":"#/components/schemas/IpBlockUsageStats","description":"Usage summary from IPAM for the IP Block"},"status":{"$ref":"#/components/schemas/IpBlockStatus","description":"Status of the IP Block"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the IP Block"},"created":{"type":"string","description":"Date/time when the Ip Block was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Ip Block was last updated","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","description":"ID of the IP Block","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the IP Block, only lowercase characters, digits, hyphens and cannot begin/end with hyphen","minLength":2,"maxLength":256},"routingType":{"type":"string","description":"RoutingType of the IP Block","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","description":"Status of the IP Block"}}},"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":"Total number of IP addresses in the block (acquired and unused)","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\n","items":{"type":"string","readOnly":true}},"availableSmallestPrefixes":{"type":"integer","description":"Total number of /30 prefixes that can still be acquired from this block (only reduced if prefixes are acquired, not reduced by acquired IPs)\n","format":"int64","readOnly":true},"acquiredPrefixes":{"type":"integer","format":"int64","description":"Total number of prefixes (of any size) acquired from this block"}},"description":"Usage statistics for an IP Block, VPC Prefix or Subnet"},"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","description":"Name of the IP Block","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the IP Block"},"siteId":{"type":"string","description":"ID of the site","format":"uuid"},"routingType":{"type":"string","description":"Routing type of the IP Block","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","description":"Version of the ip network ipv4 or ipv6","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"],"description":"Name of the IP Block","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the IP Block"}}},"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","description":"Unique UUID v4 identifier for the Network Security Group"},"name":{"type":"string","description":"Name of the Network Security Group","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Network Security Group"},"siteId":{"type":"string","description":"ID of the Site","format":"uuid"},"tenantId":{"type":"string","description":"ID of the Tenant","format":"uuid"},"status":{"$ref":"#/components/schemas/NetworkSecurityGroupStatus","description":"Status of the Network Security Group"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the Network Security Group"},"statefulEgress":{"type":"boolean","description":"StatefulEgress defines whether a Network Security Group's egress rules will be automatically stateful"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/NetworkSecurityGroupRule"},"description":"Rules that belong to the Network Security Group"},"ruleCount":{"type":"integer","description":"Number of rules in the Network Security Group"},"attachmentStats":{"$ref":"#/components/schemas/NetworkSecurityGroupStats","description":"Attachment statistics for the Network Security Group. Returned when the `includeAttachmentStats` query parameter is set to true in retrieval endpoints."},"labels":{"$ref":"#/components/schemas/Labels","description":"Set of labels/tags for the Network Security Group"},"created":{"type":"string","description":"Date/time when the Network Security Group was created","format":"date-time"},"updated":{"type":"string","description":"Date/time when the Network Security Group was last updated","format":"date-time"}}},"NetworkSecurityGroupStats":{"title":"NetworkSecurityGroupStats","type":"object","description":"Detailed attachment statistics for a Network Security Group","properties":{"inUse":{"type":"boolean","description":"Whether the Network Security Group is directly attached to at least one object"},"directVpcAttachmentCount":{"type":"integer","description":"Number of VPCs that directly attach this Network Security Group"},"directInstanceAttachmentCount":{"type":"integer","description":"Number of Instances that directly attach this Network Security Group"},"totalDirectAttachmentCount":{"type":"integer","description":"Total number of objects that directly attach this Network Security Group"}}},"NetworkSecurityGroupStatus":{"title":"NetworkSecurityGroupStatus","type":"string","description":"Status values for Network Security Group objects","enum":["Pending","Provisioning","Ready","Deleting","Error"]},"NetworkSecurityGroupCreateRequest":{"type":"object","examples":[{"id":"2a21cf79-ea5e-4d28-b585-2e78948fcefb","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":{"id":{"type":"string","format":"uuid","description":"Optional user-specified UUID for the Network Security Group"},"name":{"type":"string","description":"Name of the Network Security Group","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Network Security Group"},"siteId":{"type":"string","description":"ID of the Site","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"},"description":"Rules that belong to the Network Security Group"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value labels for the Network Security Group"}},"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"],"description":"Name of the Network Security Group","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Network Security Group"},"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 Network Security Group. The rules will be replaced with the rules sent in the request. Any rules not included in the request will be removed. To retain existing rules, fetch them first and include them.","items":{"$ref":"#/components/schemas/NetworkSecurityGroupRule"}},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value labels for the Network Security Group"}}},"NetworkSecurityGroupRule":{"title":"NetworkSecurityGroupRule","type":"object","description":"Aggregation of Network Security Group rules","properties":{"name":{"type":["string","null"],"description":"Name of the Network Security Group rule"},"direction":{"type":"string","description":"Traffic direction the rule applies to","enum":["INGRESS","EGRESS"],"example":"INGRESS"},"sourcePortRange":{"type":["string","null"],"description":"Source port or port range matched by the rule","example":"80-81"},"destinationPortRange":{"type":["string","null"],"description":"Destination port or port range matched by the rule","example":"80-81"},"protocol":{"type":"string","description":"Network protocol matched by the rule","enum":["TCP","UDP","ICMP","ICMP6","ANY"],"example":"TCP"},"action":{"type":"string","description":"Action applied when traffic matches the rule","enum":["PERMIT","DENY"],"example":"PERMIT"},"priority":{"type":"integer","description":"Rule priority used to order evaluation"},"sourcePrefix":{"type":"string","description":"Source CIDR prefix matched by the rule","example":"10.5.44.0/24"},"destinationPrefix":{"type":"string","description":"Destination CIDR prefix matched by the rule","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":{"objectId":{"type":"string","format":"uuid","description":"The ID of the object (VPC/Instance etc.)"},"detailedStatus":{"type":"string","description":"The detailed propagation status that was actually returned from NICo","enum":["None","Partial","Full","Unknown","Error"]},"status":{"$ref":"#/components/schemas/NetworkSecurityGroupPropagationStatus","description":"The simplified propagation status that reduces the actual status to just a few values"},"details":{"type":["string","null"],"description":"Additional details for the status"},"unpropagatedInstanceIds":{"type":"array","description":"IDs of Instances associated with the object that have not yet updated their Network Security Group rules","items":{"type":"string","format":"uuid"}},"relatedInstanceIds":{"type":"array","description":"IDs of the instances involved in determining the propagation status","items":{"type":"string","format":"uuid"}},"deprecations":{"type":"array","description":"Deprecations active for this resource. Returned only if there are active deprecations.","items":{"$ref":"#/components/schemas/Deprecation"}}}},"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","description":"State of the associated entity at a particular time"},"message":{"type":["string","null"],"description":"Description of the state and cause/remedy in case of error"},"created":{"type":"string","description":"Date/time when the associated entity assumed the status","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the associated entity was last observed with this status","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","description":"Summary of the Site"},"status":{"$ref":"#/components/schemas/SshKeyGroupSiteAssociationStatus","description":"Status of the SSHKeyGroupSiteAssociation"},"version":{"type":["string","null"],"description":"Version of the Key Group on Site","example":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3"},"created":{"type":"string","description":"Date/time when the Site was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Site was last updated","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":"Name of the SSHKeyGroup"},"description":{"type":["string","null"],"description":"Description of the SSHKeyGroup"},"siteIds":{"type":"array","description":"List of Site objects","items":{"type":"string","format":"uuid"}},"sshKeyIds":{"type":"array","description":"List of SSHKeyID objects","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":"Name of the SSHKeyGroup"},"description":{"type":["string","null"],"description":"Description of the SSHKeyGroup"},"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","description":"Name of the SSHKey"},"org":{"type":"string","description":"Organization the SSHKey belongs to"},"tenantId":{"type":"string","description":"ID of the Tenant","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"],"description":"Name of the SSHKey"}}},"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 retrieving 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","description":"Prometheus scrape configuration"},"logging":{"$ref":"#/components/schemas/DpuExtensionServiceObservabilityLogging","description":"Logging configuration"}},"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"],"description":"Email used by the user to register with NGC","format":"email"},"firstName":{"type":["string","null"],"description":"First name of the user"},"lastName":{"type":["string","null"],"description":"Surname of the user"},"created":{"type":"string","format":"date-time","description":"The date that the user was created.","readOnly":true},"updated":{"type":"string","description":"Date/time when the user was last updated in NICo","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","properties":{"attribute":{"type":["string","null"],"description":"Name of the attribute that is deprecated. Omitted if queryParam or endpoint is being deprecated."},"queryParam":{"type":["string","null"],"description":"Query parameter that is deprecated. Omitted if attribute or endpoint is being deprecated."},"endpoint":{"type":["string","null"],"description":"API endpoint that is deprecated. Omitted if attribute or queryParam is being deprecated."},"replacedBy":{"type":["string","null"],"description":"Name of the attribute, query parameter, or endpoint that replaces the deprecated item. Omitted if no replacement is available."},"takeActionBy":{"type":"string","description":"Date/time by which clients should migrate away from the deprecated API surface","format":"date-time"},"notice":{"type":"string","description":"Message describing the deprecation"}}},"MessageResponse":{"title":"MessageResponse","type":"object","description":"Structured response with a human-readable message","required":["message"],"properties":{"message":{"type":"string","description":"Human-readable outcome of the request"}},"example":{"message":"Deletion request was accepted"}},"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 the calling token is authenticated as a Service Account.\nThis is determined per request from how the token's issuer is configured\nat deployment time (the issuer config in the `nico-rest-api-config`\nConfigMap); it cannot be toggled via the API. Rules by issuer origin:\n  - `keycloak`: true for a client-credentials (service-to-service) token —\n    i.e. the token carries a client ID — when the issuer is deployed with\n    `keycloak.serviceAccount: true`.\n  - `custom`: true when the `claimMapping` matched for this org sets\n    `isServiceAccount: true`. Only permitted when the API runs in\n    disconnected mode.\n  - `kas-ssa` / `kas-legacy`: always false; service accounts are not\n    supported for these origins.\n\nFor details on issuer origins and configuration, see the NICo REST `auth`\nmodule [README](https://github.com/NVIDIA/infra-controller/tree/main/rest-api/auth)."},"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"}},"examples":[{"name":"NVIDIA GB200","gpus":64,"machines":16},{"name":"NVIDIA H100","gpus":8,"machines":1}]},"MachineStatusBreakdown":{"title":"MachineStatusBreakdown","description":"Machine counts broken down by status","type":"object","properties":{"total":{"type":"integer","description":"Total number of machines in this group"},"initializing":{"type":"integer","description":"Number of machines being initialized"},"ready":{"type":"integer","description":"Number of machines in ready state"},"inUse":{"type":"integer","description":"Number of machines currently in use"},"error":{"type":"integer","description":"Number of machines in error state"},"maintenance":{"type":"integer","description":"Number of machines in maintenance state"},"unknown":{"type":"integer","description":"Number of machines in unknown state"}}},"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","description":"AssignedMachineStats captures the status of all Machines assigned to this Instance Type"},"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","description":"UsedMachineStats captures the usage status of machines assigned to this instance type that are currently associated with Tenant Instances"},"tenants":{"type":"array","items":{"$ref":"#/components/schemas/InstanceTypeStats"},"description":"Per-tenant breakdown for this instance type"}}},"InstanceTypeStats":{"title":"InstanceTypeStats","description":"Stats for an instance type including allocation details","type":"object","properties":{"id":{"type":"string","description":"Unique UUID v4 identifier for the Instance Type","format":"uuid"},"name":{"type":"string","description":"Name of the Instance Type"},"allocated":{"type":"integer","description":"Number of Machines allocated for this Instance Type"},"usedMachineStats":{"$ref":"#/components/schemas/MachineStatusBreakdown","description":"Usage statistics for Machines allocated to this Instance Type"},"maxAllocatable":{"type":"integer","description":"Maximum number of Machines of this Instance Type that can be allocated"},"allocations":{"type":"array","items":{"$ref":"#/components/schemas/TenantInstanceTypeAllocationStats"},"description":"Allocation statistics for this Instance Type"}}},"TenantInstanceTypeAllocationStats":{"title":"TenantInstanceTypeAllocationStats","description":"Stats for a single allocation within an instance type","type":"object","properties":{"id":{"type":"string","description":"Unique UUID v4 identifier for the Allocation","format":"uuid"},"name":{"type":"string","description":"Name of the Allocation"},"total":{"type":"integer","description":"Total number of Machines allocated to different Tenants for this Instance Type"}}},"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"},"description":"Instance Type statistics for this Tenant"}}},"TenantIdentityConfigCreateOrUpdateRequest":{"title":"TenantIdentityConfigCreateOrUpdateRequest","description":"Tenant identity configuration payload. `issuer`,\n`defaultAudience`, and `tokenTtlSeconds` are required. `enabled` is\noptional and defaults to `true` when omitted. The `org` identifier\nis taken from the URL path segment `{org}`.\n\nTwo request shapes are supported, distinguished by whether the\nPUT also forces a signing-key rotation:\n\n  1. **Without key rotation** -- `rotateKey` is omitted or `false`;\n     `signingKeyOverlapSeconds` must be omitted.\n  2. **With key rotation** -- `rotateKey: true` and\n     `signingKeyOverlapSeconds` are both required; the Core gRPC\n     API generates a fresh ES256 keypair into the other key slot,\n     swaps the active signer, and arms a JWKS overlap window for\n     the previous key.","oneOf":[{"$ref":"#/components/schemas/TenantIdentityConfigCreateOrUpdateRequestWithoutKeyRotation"},{"$ref":"#/components/schemas/TenantIdentityConfigCreateOrUpdateRequestWithKeyRotation"}]},"TenantIdentityConfigCreateOrUpdateRequestWithoutKeyRotation":{"title":"Without key rotation","description":"Standard create-or-update of the tenant identity config. Use\nthis shape when **not** rotating the signing key.\n`signingKeyOverlapSeconds` is not used here -- it is only\nmeaningful together with `rotateKey: true` and is rejected by\nthe REST API in that combination. Switch to the \"With key\nrotation\" variant when you need to set it.","type":"object","required":["issuer","defaultAudience","tokenTtlSeconds"],"properties":{"enabled":{"type":"boolean","default":true,"description":"Optional. Set to `true` to enable JWT-SVID issuance for\nthis org or `false` to keep the config but pause issuance.\nDefaults to `true` when omitted."},"issuer":{"type":"string","description":"JWT `iss` claim / OIDC issuer. Required in the REST\nrequest body. The Core gRPC API (`Issuer::parse`) is\nauthoritative for scheme and host rules and accepts\n`https://`, `http://`, or `spiffe://` URLs with a DNS\nhost; malformed values are rejected with\n`400 Bad Request`."},"defaultAudience":{"type":"string","description":"Default audience applied when a workload does not specify one. Required."},"allowedAudiences":{"type":"array","default":[],"description":"Allowlist of audience strings that may appear in issued\nJWT-SVIDs. When **empty or omitted**, the Core gRPC API\npersists `[defaultAudience]` as the stored allowlist, so\nonly the default audience can be issued -- empty is\n**not** \"allow any\". To accept additional audiences,\nprovide a non-empty list; non-empty lists must include\n`defaultAudience`. A subsequent GET returns the\npersisted allowlist, which may differ from an empty list\nthat was sent on PUT.","items":{"type":"string"}},"tokenTtlSeconds":{"type":"integer","minimum":1,"description":"Issued-token TTL in seconds. Required in the REST request\nbody and must be > 0. The Core gRPC API enforces its\nconfigured `[machine_identity].token_ttl_min_sec` /\n`token_ttl_max_sec` window and rejects values outside the\nwindow with `400 Bad Request`. The window is per-site, so\nREST does not advertise a fixed maximum here."},"subjectPrefix":{"type":"string","description":"Optional SPIFFE ID URI prefix for JWT `sub` (RFC-shaped\n`spiffe://…`). When omitted, the Core gRPC API derives a\nprefix from the issuer's trust domain."},"rotateKey":{"type":"boolean","enum":[false],"default":false,"description":"Must be omitted or `false` for this variant. Switch to the\n\"With key rotation\" variant to force a fresh ES256 signing\nkeypair and arm a JWKS overlap window."}}},"TenantIdentityConfigCreateOrUpdateRequestWithKeyRotation":{"title":"With key rotation","description":"Create-or-update of the tenant identity config that also\nforces a signing-key rotation. Both `rotateKey: true` and\n`signingKeyOverlapSeconds` are required.","type":"object","required":["issuer","defaultAudience","tokenTtlSeconds","rotateKey","signingKeyOverlapSeconds"],"properties":{"enabled":{"type":"boolean","default":true,"description":"Optional. Set to `true` to enable JWT-SVID issuance for\nthis org or `false` to keep the config but pause issuance.\nDefaults to `true` when omitted."},"issuer":{"type":"string","description":"JWT `iss` claim / OIDC issuer. Required in the REST\nrequest body. The Core gRPC API (`Issuer::parse`) is\nauthoritative for scheme and host rules and accepts\n`https://`, `http://`, or `spiffe://` URLs with a DNS\nhost; malformed values are rejected with\n`400 Bad Request`."},"defaultAudience":{"type":"string","description":"Default audience applied when a workload does not specify one. Required."},"allowedAudiences":{"type":"array","default":[],"description":"Allowlist of audience strings that may appear in issued\nJWT-SVIDs. When **empty or omitted**, the Core gRPC API\npersists `[defaultAudience]` as the stored allowlist, so\nonly the default audience can be issued -- empty is\n**not** \"allow any\". To accept additional audiences,\nprovide a non-empty list; non-empty lists must include\n`defaultAudience`. A subsequent GET returns the\npersisted allowlist, which may differ from an empty list\nthat was sent on PUT.","items":{"type":"string"}},"tokenTtlSeconds":{"type":"integer","minimum":1,"description":"Issued-token TTL in seconds. Required in the REST request\nbody and must be > 0. The Core gRPC API enforces its\nconfigured `[machine_identity].token_ttl_min_sec` /\n`token_ttl_max_sec` window and rejects values outside the\nwindow with `400 Bad Request`. The window is per-site, so\nREST does not advertise a fixed maximum here."},"subjectPrefix":{"type":"string","description":"Optional SPIFFE ID URI prefix for JWT `sub` (RFC-shaped\n`spiffe://…`). When omitted, the Core gRPC API derives a\nprefix from the issuer's trust domain."},"rotateKey":{"type":"boolean","enum":[true],"description":"Must be `true` for this variant. Generates a fresh ES256\nsigning keypair into the other key slot, swaps the\ncurrent signer, and arms a JWKS overlap window for the\nprevious key."},"signingKeyOverlapSeconds":{"type":"integer","minimum":1,"description":"Required when `rotateKey` is `true`. Number of seconds\nthe previous verification key remains in JWKS so that\nJWTs already signed with it stay verifiable until they\nexpire. Must be `>= tokenTtlSeconds`. The Core gRPC API\nenforces an upper bound via its\n`[machine_identity].signing_key_overlap_max_sec` config;\nvalues above that bound are rejected with\n`400 Bad Request`."}}},"TenantIdentityConfig":{"title":"TenantIdentityConfig","description":"Current tenant identity configuration plus the per-org signing key\nmetadata (`signingKeys`). During a JWKS overlap window two\nentries appear; under steady state only the active signer is\nlisted. Use `signingKeys[].kid` (filtering by `currentSigner`)\ninstead of the legacy single `keyId` field, which was removed\nwith the key-rotation change in NICo-core.","type":"object","properties":{"org":{"type":"string","description":"Organization that owns the Tenant identity configuration"},"enabled":{"type":"boolean","description":"Whether Tenant identity token delegation is enabled"},"issuer":{"type":"string","description":"Issuer URL for Tenant identity tokens"},"defaultAudience":{"type":"string","description":"Default audience used for Tenant identity tokens"},"allowedAudiences":{"type":"array","description":"Stored allowlist of audience strings. Always non-empty: when a\nPUT supplied an empty list, the Core gRPC API substituted\n`[defaultAudience]` before persisting. Issuance rejects audiences\noutside this list.","items":{"type":"string"}},"tokenTtlSeconds":{"type":"integer","description":"Lifetime of issued Tenant identity tokens, in seconds"},"subjectPrefix":{"type":"string","description":"SPIFFE ID prefix used in the JWT `sub` claim. When the PUT body\nomitted `subjectPrefix`, Core stored\n`spiffe://<trust-domain-from-issuer>` here, so the value\nreturned by GET may differ from what was submitted."},"signingKeys":{"type":"array","items":{"$ref":"#/components/schemas/TenantIdentitySigningKey"},"description":"Per-org signing keys currently published in JWKS. Exactly\none entry has `currentSigner: true`. During a rotation\noverlap window a second entry is present with\n`currentSigner: false` and a populated `expireAt`; once\nthe overlap window elapses the Core gRPC API deletes the\nexpired entry and only the current signer remains."},"created":{"type":"string","description":"Date/time when the Tenant identity configuration was created","format":"date-time"},"updated":{"type":"string","description":"Date/time when the Tenant identity configuration was last updated","format":"date-time"}}},"TenantIdentitySigningKey":{"title":"TenantIdentitySigningKey","description":"A single JWT-SVID signing key entry returned in\n`TenantIdentityConfig.signingKeys`. Multiple entries appear\nduring a key-rotation overlap window; in steady state only the\nactive signer is listed.","type":"object","required":["kid","alg","currentSigner"],"properties":{"kid":{"type":"string","description":"Key identifier; matches the `kid` published in JWKS for this key."},"alg":{"type":"string","description":"Signing algorithm, e.g. `ES256`."},"currentSigner":{"type":"boolean","description":"True when this key is the active signer for new JWT-SVIDs.\nExactly one entry per response is `true`."},"expireAt":{"type":["string","null"],"format":"date-time","description":"Set on the inactive (previous) key during the JWKS overlap\nwindow; the Core gRPC API deletes the inactive slot once\n`now >= expireAt`. Null on the current signer."}}},"TenantIdentityBasicClientSecretRequest":{"title":"TenantIdentityBasicClientSecretRequest","description":"Raw OAuth2 `client_secret_basic` credentials. `clientSecret` is accepted on input but never returned in responses.","type":"object","required":["clientId","clientSecret"],"properties":{"clientId":{"type":"string","description":"Client identifier used for basic client-secret authentication"},"clientSecret":{"type":"string","description":"Raw OAuth2 client secret. Transmitted over TLS to the Core gRPC API,\nwhich encrypts it at rest in its database using a per-site key. Never\nechoed in responses; subsequent reads return only a `sha256:` hash\nprefix in `clientSecretHash`."}}},"TenantIdentityBasicClientSecretResponse":{"title":"TenantIdentityBasicClientSecretResponse","description":"Public half of `client_secret_basic` credentials. Only the SHA-256 hash of the secret is returned.","type":"object","properties":{"clientId":{"type":"string","description":"Client identifier used for basic client-secret authentication"},"clientSecretHash":{"type":"string","description":"SHA-256 hash of the raw secret."}}},"TenantIdentityTokenDelegationCreateOrUpdateRequest":{"title":"TenantIdentityTokenDelegationCreateOrUpdateRequest","description":"RFC 8693 token exchange callback configuration. Omit\n`clientSecretBasic` entirely for auth method `none`; include it\nfor `client_secret_basic`.\n\nBecause PUT is full-replace, omitting `clientSecretBasic` on a\nsubsequent update **clears** any previously-stored credentials\nand switches the org back to no-auth. To keep basic-auth across\nupdates, re-supply `clientId` and `clientSecret` on every PUT —\nCore never returns the raw secret (only its hash), so the secret\nmust be available to the caller.","type":"object","required":["tokenEndpoint","subjectTokenAudience"],"properties":{"tokenEndpoint":{"type":"string","format":"uri","description":"URL of the tenant's RFC 8693 token exchange endpoint.\nThe Core gRPC API validates scheme and host against its\nconfigured `[machine_identity].token_endpoint_domain_allowlist`\nand rejects mismatches with `400 Bad Request`. Operators that\nneed to enforce HTTPS-only must populate that allowlist."},"clientSecretBasic":{"$ref":"#/components/schemas/TenantIdentityBasicClientSecretRequest","description":"Client-secret basic authentication settings for token delegation"},"subjectTokenAudience":{"type":"string","description":"Audience value placed on the intermediate JWT-SVID posted to the exchange endpoint."}}},"TenantIdentityTokenDelegation":{"title":"TenantIdentityTokenDelegation","description":"Current token delegation configuration for the org.","type":"object","properties":{"tokenEndpoint":{"type":"string","description":"Token endpoint used to exchange delegated Tenant identity tokens","format":"uri"},"clientSecretBasic":{"$ref":"#/components/schemas/TenantIdentityBasicClientSecretResponse","description":"Client-secret basic authentication settings for token delegation"},"subjectTokenAudience":{"type":"string","description":"Audience value expected on the subject token"},"created":{"type":"string","description":"Date/time when the token delegation configuration was created","format":"date-time"},"updated":{"type":"string","description":"Date/time when the token delegation configuration was last updated","format":"date-time"}}},"TenantIdentityJWKS":{"title":"TenantIdentityJWKS","description":"RFC 7517 JSON Web Key Set. NICo-rest returns this schema only\non `200 OK`; in that case the `keys` member is present. The Core\ngRPC API normally returns one key, or two during a rotation overlap\nwindow. When no identity configuration exists for the org/site, the\nJWKS endpoints return `404 Not Found`.","type":"object","required":["keys"],"properties":{"keys":{"type":"array","description":"RFC 7517 JWK members. NICo currently emits only EC keys\n(`kty: EC`, `crv: P-256`, `alg: ES256`); the schema is\nintentionally open-ended so that future algorithms can be\nadded without a spec change.","items":{"type":"object","properties":{"kty":{"type":"string","example":"EC"},"use":{"type":"string","description":"`sig` for OIDC JWKS, `jwt-svid` for SPIFFE JWKS"},"crv":{"type":"string","example":"P-256"},"kid":{"type":"string"},"x":{"type":"string","description":"Base64url-encoded EC x coordinate"},"y":{"type":"string","description":"Base64url-encoded EC y coordinate"},"alg":{"type":"string","example":"ES256"}}}}}},"OpenIDConfiguration":{"title":"OpenIDConfiguration","description":"OIDC discovery document. Note: `id_token_signing_alg_values_supported`\nis always empty because NICo issues JWT bearer access tokens, not\nOIDC `id_token`s.","type":"object","properties":{"issuer":{"type":"string","description":"Issuer URL for OpenID Connect discovery"},"jwks_uri":{"type":"string","description":"URL of the JSON Web Key Set used to verify tokens","format":"uri"},"response_types_supported":{"type":"array","description":"OAuth response types supported by this issuer","items":{"type":"string"}},"subject_types_supported":{"type":"array","description":"Subject identifier types supported by this issuer","items":{"type":"string"}},"id_token_signing_alg_values_supported":{"type":"array","description":"ID token signing algorithms supported by this issuer","items":{"type":"string"}},"spiffe_jwks_uri":{"type":"string","description":"URL of the SPIFFE JSON Web Key Set used to verify SPIFFE JWT-SVIDs","format":"uri"}}},"DpuMachine":{"title":"DpuMachine","type":"object","description":"A DPU Machine with network configuration fields exposed by the REST API.","properties":{"id":{"type":"string","description":"ID of the DPU Machine"},"infrastructureProviderId":{"type":"string","format":"uuid","description":"ID of the Infrastructure Provider that owns the host Machine"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site that the host Machine belongs to"},"hostMachineId":{"type":"string","description":"ID of the host Machine that this DPU is attached to"},"dpuAgentVersion":{"type":"string","description":"Version of the DPU agent running on the DPU"},"bmcInfo":{"$ref":"#/components/schemas/MachineBMCInfo","description":"BMC (Baseboard Management Controller) information for the DPU"},"dmiData":{"$ref":"#/components/schemas/MachineDMIData","description":"DMI (Desktop Management Interface) data reported for the DPU"},"interfaces":{"type":"array","items":{"$ref":"#/components/schemas/DpuMachineInterface"},"description":"Interfaces reported on the DPU"},"softwareComponents":{"type":"array","items":{"$ref":"#/components/schemas/DpuMachineSoftwareComponent"},"description":"Software components reported on the DPU"},"health":{"$ref":"#/components/schemas/MachineHealth","description":"Health information for the DPU"},"labels":{"type":"object","additionalProperties":{"type":"string"},"description":"Labels associated with the DPU"},"state":{"type":"string","description":"Lifecycle state of the DPU"},"dpuNetworkConfig":{"$ref":"#/components/schemas/DpuNetworkConfig","description":"Network configuration fields exposed by the REST API"},"lastRebooted":{"type":["string","null"],"format":"date-time","description":"Last reboot timestamp"},"placementInRack":{"$ref":"#/components/schemas/PlacementInRack","description":"Physical placement of the DPU Machine within its Rack, when known"}},"required":["id","infrastructureProviderId","siteId","hostMachineId","state","dpuNetworkConfig"]},"DpuMachineInterface":{"title":"DpuMachineInterface","type":"object","description":"An interface reported on a DPU Machine","properties":{"id":{"type":"string","description":"Interface ID"},"machineId":{"type":"string","description":"ID of the Machine the interface belongs to"},"segmentId":{"type":"string","description":"Network segment ID"},"hostname":{"type":"string","description":"Hostname of the interface"},"primaryInterface":{"type":"boolean","description":"Whether this is the primary interface"},"macAddress":{"type":"string","description":"MAC address of the interface"},"address":{"type":"array","items":{"type":"string"},"description":"IP addresses assigned to the interface"},"vendor":{"type":["string","null"],"description":"Vendor of the interface"},"created":{"type":["string","null"],"format":"date-time","description":"Timestamp when the interface was first observed"},"lastDhcp":{"type":["string","null"],"format":"date-time","description":"Timestamp of the last DHCP lease for the interface"},"isBmc":{"type":"boolean","description":"Whether this interface is a BMC interface"}}},"DpuMachineSoftwareComponent":{"title":"DpuMachineSoftwareComponent","type":"object","description":"A software component reported on a DPU Machine","properties":{"name":{"type":"string","description":"Name of the software component"},"version":{"type":"string","description":"Version of the software component"},"url":{"type":"string","description":"URL where the software component can be obtained"}}},"DpuNetworkConfig":{"title":"DpuNetworkConfig","type":"object","description":"Network configuration fields exposed for a DPU Machine. Internal-only and sensitive fields from the Core configuration are omitted.","properties":{"asn":{"type":"integer","format":"uint32","description":"Autonomous System Number for BGP routing"},"dhcpServers":{"type":"array","items":{"type":"string"},"description":"List of DHCP server IP addresses"},"vniDevice":{"type":"string","description":"VNI device name"},"managedHostConfig":{"$ref":"#/components/schemas/ManagedHostNetworkConfig","description":"Network configuration applied to the managed host"},"managedHostConfigVersion":{"type":"string","description":"Version of the managed host configuration"},"useAdminNetwork":{"type":"boolean","description":"Whether to use the admin network"},"adminInterface":{"$ref":"#/components/schemas/DpuInterfaceConfig","description":"Admin network interface configuration for the DPU"},"tenantInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/DpuInterfaceConfig"},"description":"List of tenant interface configurations"},"instanceNetworkConfigVersion":{"type":["string","null"],"description":"Version of the instance network configuration"},"instanceId":{"type":["string","null"],"description":"ID of the associated instance"},"networkVirtualizationType":{"type":["string","null"],"description":"Type of network virtualization"},"vpcVni":{"type":["integer","null"],"format":"uint32","description":"VPC VNI identifier"},"routeServers":{"type":"array","items":{"type":"string"},"description":"List of route server IP addresses"},"remoteId":{"type":"string","description":"Remote identifier for the managed host"},"deprecatedDenyPrefixes":{"type":"array","items":{"type":"string"},"description":"Deprecated list of denied IP prefixes"},"dpuNetworkPingerType":{"type":["string","null"],"description":"Type of network pinger to use"},"denyPrefixes":{"type":"array","items":{"type":"string"},"description":"List of denied IP prefixes"},"siteFabricPrefixes":{"type":"array","items":{"type":"string"},"description":"List of site fabric IP prefixes"},"vpcIsolationBehavior":{"type":"string","description":"VPC isolation behavior setting"},"statefulAclsEnabled":{"type":"boolean","description":"Whether stateful ACLs are enabled"},"enableDhcp":{"type":"boolean","description":"Whether DHCP is enabled"},"hostInterfaceId":{"type":["string","null"],"description":"ID of the host interface"},"minDpuFunctioningLinks":{"type":["integer","null"],"format":"uint32","description":"Minimum number of functioning DPU links required"},"isPrimaryDpu":{"type":"boolean","description":"Whether this is the primary DPU"},"internetL3Vni":{"type":["integer","null"],"format":"uint32","description":"Layer 3 VNI used for internet access"},"datacenterAsn":{"type":"integer","format":"uint32","description":"Datacenter Autonomous System Number"},"anycastSitePrefixes":{"type":"array","items":{"type":"string"},"description":"List of anycast site IP prefixes"},"tenantHostAsn":{"type":["integer","null"],"format":"uint32","description":"Autonomous System Number for the tenant host"},"siteGlobalVpcVni":{"type":["integer","null"],"format":"uint32","description":"Site-global VPC VNI identifier"}},"required":["asn","vniDevice","managedHostConfigVersion","useAdminNetwork","remoteId","vpcIsolationBehavior","statefulAclsEnabled","enableDhcp","isPrimaryDpu","datacenterAsn"]},"ManagedHostNetworkConfig":{"title":"ManagedHostNetworkConfig","type":"object","description":"Network configuration for the managed host","properties":{"loopbackIp":{"type":"string","description":"Loopback IP address"},"quarantineState":{"$ref":"#/components/schemas/ManagedHostQuarantineState"}},"required":["loopbackIp"]},"ManagedHostQuarantineState":{"title":"ManagedHostQuarantineState","type":"object","description":"Quarantine state for the managed host","properties":{"mode":{"type":"string","description":"Quarantine mode"},"reason":{"type":["string","null"],"description":"Reason for quarantine"}},"required":["mode"]},"DpuInterfaceConfig":{"title":"DpuInterfaceConfig","type":"object","description":"Interface configuration for DPU networking","properties":{"functionType":{"type":"string","description":"Function type (e.g. PHYSICAL_FUNCTION, VIRTUAL_FUNCTION)"},"vlanId":{"type":"integer","format":"uint32","description":"VLAN ID"},"vni":{"type":"integer","format":"uint32","description":"VXLAN Network Identifier"},"gateway":{"type":"string","description":"Gateway IP address"},"ip":{"type":"string","description":"Interface IP address"},"interfacePrefix":{"type":"string","description":"Interface name prefix"},"virtualFunctionId":{"type":["integer","null"],"format":"uint32","description":"Virtual function ID if applicable"},"vpcPrefixes":{"type":"array","items":{"type":"string"},"description":"List of VPC IP prefixes"},"prefix":{"type":"string","description":"IP prefix for the interface"},"fqdn":{"type":"string","description":"Fully qualified domain name"},"bootUrl":{"type":["string","null"],"description":"Boot URL for PXE/iPXE boot"},"vpcVni":{"type":"integer","format":"uint32","description":"VPC VXLAN Network Identifier"},"sviIp":{"type":["string","null"],"description":"Switch virtual interface (SVI) IP address"},"tenantVrfLoopbackIp":{"type":["string","null"],"description":"Tenant VRF loopback IP address"},"isL2Segment":{"type":"boolean","description":"Whether the interface is an L2 segment"},"vpcPeerPrefixes":{"type":"array","items":{"type":"string"},"description":"List of peered VPC IP prefixes"},"vpcPeerVnis":{"type":"array","items":{"type":"integer","format":"uint32"},"description":"List of peered VPC VNIs"},"mtu":{"type":["integer","null"],"format":"uint32","description":"Maximum transmission unit (MTU) for the interface"},"networkSecurityGroup":{"$ref":"#/components/schemas/InterfaceNetworkSecurityGroupConfig","description":"Network security group configuration resolved on the interface"}},"required":["functionType","vlanId","vni","gateway","ip","interfacePrefix","prefix","fqdn","vpcVni","isL2Segment"]},"InterfaceNetworkSecurityGroupConfig":{"title":"InterfaceNetworkSecurityGroupConfig","type":"object","description":"Network security group configuration resolved on a DPU interface","properties":{"id":{"type":"string","description":"ID of the Network Security Group"},"version":{"type":"string","description":"Version of the Network Security Group"},"source":{"type":"string","description":"Source of the Network Security Group configuration"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/ResolvedNetworkSecurityGroupRule"},"description":"Resolved rules for the Network Security Group"}},"required":["id","version","source"]},"ResolvedNetworkSecurityGroupRule":{"title":"ResolvedNetworkSecurityGroupRule","type":"object","description":"A network security group rule with its source and destination prefixes resolved","properties":{"rule":{"$ref":"#/components/schemas/NetworkSecurityGroupRule","description":"The underlying Network Security Group rule"},"srcPrefixes":{"type":"array","items":{"type":"string"},"description":"Resolved source IP prefixes for the rule"},"dstPrefixes":{"type":"array","items":{"type":"string"},"description":"Resolved destination IP prefixes for the rule"}}}},"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}}}}}},"GatewayTimeoutError":{"description":"The Site did not return a result within the request budget allocated to\nSite communication within the request cycle. This can occur if the Site\nController is down or under heavy request load.\n\nOperations are in general safe to retry. In rare cases, operations that\ncreate or update resources may succeed even if timeout is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"},"examples":{"example-1":{"value":{"source":"nico","message":"Flow proxy request timed out","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}}}}}},"UnauthorizedError":{"description":"Error response when user is not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"},"examples":{"example-1":{"value":{"source":"nico","message":"User is not authenticated","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"}}}}}}},"ResourceExhaustedError":{"description":"Error response when the Controller cannot allocate a requested resource because capacity is exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"},"examples":{"example-1":{"value":{"source":"nico","message":"VPC prefix capacity exhausted","data":null}}}}}},"HostFirmwareConfigCoreUnavailable":{"description":"Core gRPC API is unavailable, so the host firmware config request cannot be served.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"}}}},"TenantIdentityCoreUnavailable":{"description":"Core gRPC API is unavailable, or site-level machine identity is\ndisabled (`enabled=false` in site config), so the request cannot\nbe served.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"}}}}},"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/BMC-Credential","tag/BMC-Credential/operation/create-or-update-bmc-credential","tag/UEFI-Credential","tag/UEFI-Credential/operation/create-uefi-credential","tag/Measured-Boot-Trusted-Machine","tag/Measured-Boot-Trusted-Machine/operation/create-measured-boot-trusted-machine","tag/Measured-Boot-Trusted-Machine/operation/get-all-measured-boot-trusted-machine","tag/Measured-Boot-Trusted-Machine/operation/delete-measured-boot-trusted-machine","tag/Measured-Boot-Trusted-Profile","tag/Measured-Boot-Trusted-Profile/operation/create-measured-boot-trusted-profile","tag/Measured-Boot-Trusted-Profile/operation/get-all-measured-boot-trusted-profile","tag/Measured-Boot-Trusted-Profile/operation/delete-measured-boot-trusted-profile","tag/Credential-Rotation","tag/Credential-Rotation/operation/rotate-credential","tag/Credential-Rotation/operation/get-credential-rotation-status","tag/Site-Explorer","tag/Site-Explorer/operation/get-all-site-explorer-endpoint","tag/Site-Explorer/operation/create-site-explorer-endpoint-action","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/update-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/create-sku","tag/SKU/operation/get-sku","tag/SKU/operation/delete-sku","tag/SKU/operation/update-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/iPXE-Template","tag/iPXE-Template/operation/get-all-ipxe-template","tag/iPXE-Template/operation/get-ipxe-template","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/machine-power-control-machine","tag/Machine/operation/get-machine-status-history","tag/Machine/operation/get-dpu-machines","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-Validation","tag/Machine-Validation/operation/get-all-machine-validation-runs","tag/Machine-Validation/operation/start-machine-validation","tag/Machine-Validation/operation/get-all-machine-validation-results","tag/BMC-Reset","tag/BMC-Reset/operation/reset-machine-bmc","tag/DPU-Reprovision","tag/DPU-Reprovision/operation/reprovision-machine-dpu","tag/Health-Report","tag/Health-Report/operation/get-all-machine-health-report","tag/Health-Report/operation/create-or-update-machine-health-report","tag/Health-Report/operation/delete-machine-health-report","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-tasks","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/Tray/operation/get-tray-tasks","tag/Task","tag/Task/operation/get-task","tag/Task/operation/cancel-task","tag/Rule","tag/Rule/operation/create-rule","tag/Rule/operation/list-rules","tag/Rule/operation/get-rule","tag/Rule/operation/update-rule","tag/Rule/operation/delete-rule","tag/Task-Run","tag/Task-Run/operation/create-task-run","tag/Task-Run/operation/get-all-task-run","tag/Task-Run/operation/get-task-run","tag/Task-Run/operation/get-all-task-run-target","tag/Task-Run/operation/pause-task-run","tag/Task-Run/operation/resume-task-run","tag/Task-Run/operation/advance-task-run","tag/Task-Run/operation/cancel-task-run","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/Host-Firmware-Config","tag/Host-Firmware-Config/operation/create-or-update-host-firmware-config","tag/Host-Firmware-Config/operation/delete-host-firmware-config","tag/Tenant-Identity","tag/Tenant-Identity/operation/create-or-update-tenant-identity-config","tag/Tenant-Identity/operation/get-tenant-identity-config","tag/Tenant-Identity/operation/delete-tenant-identity-config","tag/Tenant-Identity/operation/create-or-update-tenant-identity-token-delegation","tag/Tenant-Identity/operation/get-tenant-identity-token-delegation","tag/Tenant-Identity/operation/delete-tenant-identity-token-delegation","tag/Tenant-Identity/operation/get-jwks","tag/Tenant-Identity/operation/get-openid-configuration","tag/Tenant-Identity/operation/get-spiffe-jwks","tag/Deprecations"],"index":{"version":"2.3.9","fields":["title","description"],"fieldVectors":[["title/0",[0,6.046,1,4.532]],["description/0",[1,0.433,2,1.101,3,0.561,4,0.578,5,0.578,6,2.346,7,3.444,8,1.583,9,0.825,10,0.992,11,2.948,12,0.484,13,0.484,14,0.385,15,1.242,16,0.578,17,0.025,18,1.101,19,1.009,20,0.304,21,0.385,22,0.578,23,2.555,24,1.505,25,0.992,26,0.578,27,0.578,28,1.158,29,0.456,30,0.578,31,0.484,32,0.652,33,3.029,34,0.385,35,0.578,36,0.484,37,0.521,38,0.433,39,0.433,40,0.484,41,0.521,42,0.373,43,0.521,44,0.635,45,0.521,46,0.203,47,0.578,48,0.311,49,0.578,50,1.604,51,1.502,52,2.011,53,0.142,54,0.484,55,0.709,56,0.682,57,0.521,58,0.351,59,1.575,60,2.404,61,0.578,62,0.183,63,1.575,64,0.433,65,0.456,66,0.433,67,0.22,68,0.304,69,0.147,70,0.578,71,0.578,72,1.986,73,1.731,74,0.456,75,0.921,76,0.578,77,0.287,78,0.521,79,2.377,80,2.293,81,0.886,82,0.578,83,1.049,84,1.386,85,0.521,86,0.385,87,0.578,88,0.578,89,0.578,90,0.578,91,0.521,92,0.578,93,0.578,94,0.578,95,2.167,96,1.294,97,0.484,98,2.56,99,1.575,100,1.575,101,0.578,102,0.578,103,0.456,104,0.578,105,0.886,106,0.456,107,1.932,108,0.456,109,1.91,110,0.484,111,1.575,112,1.944,113,1.101,114,1.837,115,1.81,116,0.688,117,0.921,118,0.921,119,1.101,120,0.921,121,1.101,122,1.111,123,1.373,124,1.101,125,0.882,126,0.709,127,0.992,128,0.992,129,0.679,130,1.101,131,1.213,132,0.578,133,0.578,134,0.033,135,0.373,136,0.825,137,1.572,138,0.578,139,0.374,140,0.325,141,0.578,142,0.415,143,0.456,144,0.578,145,0.287,146,0.578,147,1.181,148,0.578,149,0.681,150,0.578,151,0.992,152,0.578]],["title/1",[50,2.84,51,1.86]],["description/1",[3,0.597,6,3.86,19,3.075,50,3.443,51,2.255,52,4.516,53,0.207,54,4.516,55,3.478,56,0.789,64,4.046,65,4.255,66,4.046,73,1.145,129,1.18,131,1.469,153,4.866,154,4.516,155,1.518,156,4.516,157,5.398]],["title/2",[32,0.403,46,1.308,50,1.75,51,1.146,134,0.215,158,2.203]],["description/2",[6,4.184,19,2.556,32,0.659,46,2.139,50,4.154,51,2.445,68,3.209,103,4.803,134,0.351,158,3.604,159,3.702,160,4.803,161,6.093,162,3.702,163,6.093]],["title/3",[3,0.669,69,0.808]],["description/3",[3,0.804,15,5.726,62,0.663,69,0.97,72,5.211,74,5.726,81,1.067,164,2.398,165,4.54]],["title/4",[3,0.456,32,0.445,46,1.447,69,0.55,134,0.237]],["description/4",[3,0.76,17,0.3,32,0.743,46,2.411,53,0.263,62,0.627,69,0.917,134,0.396,166,0.344,167,0.822,168,0.35,169,6.868]],["title/5",[3,0.456,32,0.445,46,1.447,69,0.55,170,2.575]],["description/5",[3,0.774,17,0.305,32,0.756,46,2.456,53,0.268,69,0.934,166,0.35,167,0.838,168,0.356,170,4.372,171,6.995]],["title/6",[56,0.679]],["description/6",[7,2.11,15,3.723,19,1.982,44,3.853,51,1.453,56,0.633,62,0.431,65,3.723,72,4.794,74,3.723,81,0.694,84,2.11,147,5.009,149,2.043,172,3.723,173,2.869,174,3.952,175,3.389,176,4.258,177,2.869,178,4.258,179,4.258,180,3.145,181,3.258,182,3.145,183,3.541,184,4.723,185,4.723,186,4.723,187,4.723,188,3.723,189,2.181,190,3.723]],["title/7",[32,0.498,46,1.618,56,0.437,134,0.266]],["description/7",[3,0.481,11,1.822,17,0.19,19,2.64,32,0.47,38,3.256,39,3.256,44,2.504,46,1.525,51,1.336,53,0.166,56,0.701,62,0.397,65,3.424,66,3.256,67,1.649,68,2.287,81,0.925,134,0.25,149,1.879,162,2.639,166,0.217,168,0.221,174,3.634,183,3.256,191,3.916,192,4.344,193,3.116,194,3.916,195,1.585,196,2.996,197,4.344,198,3.424,199,4.344,200,4.344,201,4.344,202,2.445,203,4.344,204,0.783,205,4.344]],["title/8",[32,0.498,46,1.618,56,0.437,170,2.881]],["description/8",[17,0.311,32,0.77,46,2.502,53,0.273,56,0.675,166,0.357,168,0.363,170,4.454,204,1.285,206,7.127]],["title/9",[32,0.367,81,0.499,107,1.405,131,0.925,137,1.345,170,2.124,207,3.399]],["description/9",[3,0.674,17,0.266,53,0.233,56,0.577,81,1.167,107,2.518,125,3.492,131,1.659,137,2.412,149,2.636,166,0.305,167,0.73,168,0.31,170,3.808,208,2.378,209,2.556,210,6.093]],["title/10",[51,1.86,56,0.573]],["description/10",[3,0.663,7,1.815,11,1.705,19,2.988,21,2.705,44,3.456,51,1.844,56,0.794,66,3.046,67,1.543,69,0.543,81,0.597,139,0.964,173,2.469,177,2.469,180,2.705,181,2.803,182,2.705,211,3.4,212,4.064,213,2.915,214,4.064,215,4.064,216,1.543,217,3.746,218,3.862,219,3.046,220,2.54,221,2.677,222,2.618,223,3.046,224,4.064,225,4.064,226,4.064,227,4.064,228,3.664,229,4.064,230,4.064]],["title/11",[32,0.566,51,1.609,56,0.496]],["description/11",[3,0.685,17,0.27,32,0.67,51,1.905,53,0.237,56,0.761,69,0.827,134,0.357,166,0.31,167,0.742,168,0.316,204,1.117,231,4.123,232,3.486,233,4.272,234,3.486,235,5.584]],["title/12",[51,1.609,56,0.496,73,1.109]],["description/12",[3,0.911,17,0.17,44,2.246,51,2.657,53,0.149,56,0.781,62,0.356,69,1.029,73,1.232,125,1.712,134,0.4,135,2.51,136,2.921,139,0.925,158,2.304,166,0.195,167,0.467,168,0.199,213,2.795,231,2.594,232,2.193,235,3.513,236,3.071,237,2.688,238,1.799,239,2.435,240,2.367,241,2.193,242,2.367,243,4.168,244,2.304,245,1.897,246,3.513,247,3.896]],["title/13",[32,0.566,51,1.609,56,0.496]],["description/13",[3,0.685,17,0.27,32,0.67,51,1.905,53,0.237,56,0.761,69,0.827,155,1.742,166,0.31,167,0.742,168,0.316,204,1.117,231,4.123,232,3.486,233,4.272,234,3.486,248,5.182]],["title/14",[51,1.609,56,0.496,139,1.242]],["description/14",[3,0.561,17,0.142,19,1.367,51,2.16,53,0.125,55,2.099,56,0.797,62,0.297,66,5.263,69,0.435,81,0.479,134,0.188,136,4.665,139,1.477,155,0.916,158,1.927,166,0.163,167,0.39,168,0.258,204,0.588,216,2.363,218,3.266,219,2.443,220,2.037,221,2.264,222,2.099,223,2.443,238,1.504,242,1.979,246,5.61,248,2.726,249,5.07,250,2.726,251,5.07,252,2.726,253,1.205,254,2.726,255,2.169,256,2.938,257,1.792,258,2.938,259,2.338,260,2.338,261,2.938,262,2.938,263,2.248,264,2.938]],["title/15",[51,1.609,56,0.496,265,1.322]],["description/15",[3,0.852,17,0.254,51,2.658,53,0.223,56,0.872,62,0.531,69,0.776,73,1.233,125,2.554,134,0.335,155,1.635,167,0.696,238,2.684,248,4.863,265,1.946]],["title/16",[81,1.052]],["description/16",[3,0.45,7,2.677,11,2.515,21,3.99,44,4.106,56,0.385,72,4.3,73,0.862,74,3.203,81,0.881,84,1.815,96,3.862,175,4.3,177,3.641,180,3.99,181,4.135,182,3.99,195,1.483,217,2.54,259,2.915,264,3.664,266,4.064,267,3.046,268,2.803,269,3.4,270,4.064,271,3.664,272,3.664,273,5.404,274,3.99,275,3.664,276,2.403,277,2.403,278,5.404]],["title/17",[32,0.654,81,0.888]],["description/17",[6,3.261,17,0.27,28,3.571,32,0.67,53,0.237,81,0.91,134,0.357,166,0.31,167,0.742,168,0.316,204,1.117,237,4.272,263,4.272,276,3.663,277,3.663,279,3.331,280,5.584,281,5.584]],["title/18",[73,1.282,81,0.888]],["description/18",[3,0.708,17,0.279,53,0.245,56,0.607,62,0.585,69,0.855,73,1.74,81,1.205,134,0.473,166,0.32,167,0.767,168,0.326,281,5.773]],["title/19",[32,0.654,81,0.888]],["description/19",[3,0.781,7,3.611,17,0.223,32,0.552,51,1.571,53,0.196,56,0.669,64,3.828,69,0.682,81,1.188,107,2.11,155,1.436,159,3.102,164,1.686,166,0.255,167,0.611,168,0.26,204,0.921,232,4.551,253,1.888,282,4.272,283,2.244,284,4.272]],["title/20",[81,0.888,139,1.435]],["description/20",[3,0.663,17,0.262,19,2.516,53,0.23,56,0.568,69,0.801,81,1.289,139,1.866,166,0.3,167,0.718,168,0.306,253,2.217,284,5.018,285,5.997,286,5.018,287,5.997,288,5.018]],["title/21",[81,0.888,265,1.528]],["description/21",[3,0.697,17,0.275,53,0.241,62,0.575,69,0.841,81,1.192,107,2.602,134,0.363,166,0.315,167,0.754,168,0.321,253,2.328,265,2.269,284,5.268]],["title/22",[32,0.498,81,0.677,158,2.726,173,2.8]],["description/22",[3,0.773,7,3.586,17,0.22,32,0.545,51,1.55,53,0.193,56,0.663,64,3.777,69,0.673,81,1.18,107,2.082,158,2.98,159,3.061,164,1.663,166,0.252,167,0.603,168,0.257,173,3.061,204,0.909,232,4.518,253,1.863,282,4.215,283,2.214,289,5.038]],["title/23",[290,3.486,291,2.999]],["description/23",[73,1.511,77,3.535,81,1.047,129,1.558,139,1.691,290,5.06,291,4.353,292,4.745]],["title/24",[73,0.978,139,1.094,290,2.658,291,2.287]],["description/24",[17,0.279,53,0.245,73,1.358,139,1.52,166,0.32,167,0.767,168,0.326,291,4.07,293,5.047,294,6.403,295,5.047,296,5.357,297,5.357,298,6.403,299,6.403]],["title/25",[291,2.999,300,4.766]],["description/25",[73,1.483,77,3.47,81,1.028,291,4.303,292,4.657,300,6.838,301,6.306,302,4.372,303,3.23]],["title/26",[73,1.109,291,2.595,300,4.124]],["description/26",[17,0.266,53,0.233,73,1.292,166,0.305,167,0.73,168,0.31,238,2.814,291,3.942,300,4.803,301,7.164,302,3.808,303,2.814,304,4.803,305,5.098,306,4.568,307,3.023,308,6.093]],["title/27",[129,1.008,309,2.881,310,2.8,311,2.535]],["description/27",[77,3.407,81,1.009,129,1.875,165,4.293,309,5.36,310,4.172,311,3.777,312,4.738,313,5.414,314,3.865]],["title/28",[73,0.79,129,0.814,309,2.328,310,2.263,311,2.049,314,2.096]],["description/28",[3,0.643,7,2.596,11,2.438,17,0.254,29,4.582,53,0.223,62,0.531,69,0.776,81,0.854,129,1.684,134,0.335,164,1.919,166,0.291,167,0.696,168,0.296,189,2.684,312,4.01,313,4.582,314,3.271,315,4.17,316,5.24]],["title/29",[32,0.403,129,0.814,309,2.328,310,2.263,311,2.049,314,2.096]],["description/29",[3,0.685,17,0.27,32,0.67,53,0.237,62,0.565,69,0.827,81,1.18,129,1.354,134,0.357,164,2.045,166,0.31,167,0.742,168,0.316,311,3.406,314,3.486,315,4.443,316,5.584]],["title/30",[129,0.814,265,0.941,309,2.328,310,2.263,311,2.049,314,2.096]],["description/30",[3,0.653,17,0.258,53,0.226,62,0.539,69,0.789,81,0.867,129,1.701,134,0.34,155,2.189,164,1.949,166,0.295,167,0.707,168,0.301,265,1.491,311,3.246,314,4.38,315,4.235,317,5.903]],["title/31",[309,2.881,310,2.8,311,2.535,318,2.97]],["description/31",[77,3.346,81,0.991,123,3.346,165,4.216,309,5.3,310,4.098,311,3.71,312,4.653,313,5.317,314,3.796,318,5.464]],["title/32",[73,0.79,309,2.328,310,2.263,311,2.049,314,2.096,318,2.4]],["description/32",[3,0.653,17,0.258,53,0.226,62,0.539,69,0.789,81,0.867,123,2.928,129,1.291,134,0.34,164,1.949,166,0.295,167,0.707,168,0.301,189,2.726,242,3.586,312,4.072,313,4.653,314,3.322,315,4.235,318,3.803,319,5.322]],["title/33",[32,0.403,309,2.328,310,2.263,311,2.049,314,2.096,318,2.4]],["description/33",[3,0.685,17,0.27,32,0.67,53,0.237,62,0.565,69,0.827,81,1.18,134,0.357,164,2.045,166,0.31,167,0.742,168,0.316,311,3.406,314,3.486,315,4.443,318,3.99,319,5.584]],["title/34",[265,0.941,309,2.328,310,2.263,311,2.049,314,2.096,318,2.4]],["description/34",[3,0.653,17,0.258,53,0.226,62,0.539,69,0.789,81,0.867,134,0.34,155,2.189,164,1.949,166,0.295,167,0.707,168,0.301,265,1.491,311,3.246,314,4.38,315,4.235,318,5.014,320,5.903]],["title/35",[291,2.999,321,4.025]],["description/35",[77,3.47,189,3.23,291,4.303,293,5.514,321,5.775,322,5.853,323,6.306,324,6.306,325,5.853]],["title/36",[291,2.999,321,4.025]],["description/36",[17,0.22,28,4.031,53,0.193,77,2.499,158,2.98,166,0.252,167,0.603,168,0.257,291,3.468,293,5.511,296,4.215,297,4.215,321,4.654,322,4.215,325,5.85,326,5.038,327,4.369,328,5.038,329,4.542,330,5.038,331,2.653,332,4.542,333,4.542,334,4.542,335,5.038,336,4.542]],["title/37",[158,3.094,291,2.595,321,3.482]],["description/37",[17,0.239,20,2.883,53,0.21,80,2.572,149,2.369,166,0.274,167,0.656,168,0.279,189,2.528,245,2.666,291,3.672,293,4.317,296,4.582,297,4.582,321,3.645,324,4.937,325,4.582,332,4.937,336,4.937,337,4.317,338,4.317,339,5.476,340,3.645,341,4.582,342,5.476]],["title/38",[81,0.888,343,4.337]],["description/38",[77,3.603,81,1.304,290,4.188,343,6.37,344,4.296,345,6.549,346,3.825]],["title/39",[32,0.566,77,2.595,343,3.753]],["description/39",[11,2.059,17,0.214,32,0.531,34,3.267,53,0.188,77,3.405,81,1.008,105,2.762,149,2.123,155,1.38,166,0.245,167,0.588,168,0.25,222,3.162,343,4.925,344,2.902,347,6.864,348,4.907,349,4.106,350,4.17,351,4.907,352,3.162,353,4.907,354,4.424,355,4.907,356,3.521,357,3.521,358,3.521,359,4.907]],["title/40",[77,2.044,81,0.605,343,2.956,360,3.715,361,3.089]],["description/40",[17,0.211,33,4.88,48,3.659,53,0.186,75,4.053,77,3.9,79,2.359,81,0.712,105,2.727,122,1.945,166,0.242,167,0.58,168,0.247,196,3.342,290,2.793,304,3.819,306,3.632,338,3.819,343,4.88,362,3.819,363,4.368,364,4.844,365,4.844,366,4.844,367,4.844,368,4.053,369,4.368,370,4.844,371,4.844,372,4.844]],["title/41",[107,2.96]],["description/41",[3,0.589,7,2.377,11,2.233,21,3.543,44,4.186,56,0.504,72,3.818,84,2.377,107,3,147,3.989,173,3.233,175,3.818,177,3.233,180,3.543,181,3.671,182,3.543,217,3.326,274,3.543,373,4.798,374,3.818,375,8.262,376,3.671,377,4.195,378,4.195]],["title/42",[32,0.654,107,2.499]],["description/42",[3,0.827,17,0.326,32,0.601,53,0.213,55,4.816,56,0.708,69,0.742,107,2.296,134,0.431,149,2.404,166,0.278,167,0.665,168,0.283,202,3.127,204,1.002,231,3.699,232,3.127,233,3.833,379,5.009,380,5.009]],["title/43",[73,1.282,107,2.499]],["description/43",[3,0.516,17,0.204,53,0.179,62,0.426,69,0.623,73,1.405,78,4.206,79,2.271,80,2.192,84,2.084,98,3.497,107,3.183,109,2.407,110,3.903,129,1.02,131,1.27,134,0.382,137,1.846,145,2.314,147,3.497,166,0.233,167,0.559,168,0.238,183,4.965,376,4.569,380,4.206,381,4.665,382,4.665,383,4.665,384,4.665,385,4.665,386,4.665]],["title/44",[32,0.654,107,2.499]],["description/44",[3,0.852,17,0.254,32,0.628,53,0.223,56,0.73,69,0.776,107,3.184,134,0.335,145,2.883,155,1.635,166,0.291,167,0.696,168,0.296,204,1.048,209,2.438,231,3.87,232,3.271,233,4.01,387,4.863]],["title/45",[107,2.499,265,1.528]],["description/45",[3,0.861,17,0.258,53,0.226,56,0.559,62,0.539,69,0.789,73,1.252,107,3.598,116,3.69,125,2.594,134,0.34,155,1.66,165,3.69,167,0.707,238,2.726,265,1.491,387,4.939,388,5.322]],["title/46",[107,2.499,139,1.435]],["description/46",[3,0.87,17,0.262,53,0.23,56,0.568,62,0.547,69,0.801,107,3.626,116,3.748,134,0.345,139,1.423,165,3.748,166,0.3,167,0.718,168,0.306,307,2.975,387,5.018,388,5.406]],["title/47",[107,2.162,139,1.242,376,3.609]],["description/47",[1,3.113,3,0.674,17,0.181,53,0.159,56,0.683,69,0.555,72,6.068,73,0.881,80,1.951,107,3.283,109,2.142,112,1.535,114,2.234,125,1.825,134,0.239,139,0.986,155,1.168,160,3.274,167,0.497,238,1.918,279,2.234,288,5.096,307,2.06,376,2.865,389,4.153,390,3.744,391,4.153,392,6.09,393,4.153,394,4.153,395,4.153,396,4.153,397,4.153,398,3.744,399,3.113,400,4.153]],["title/48",[112,2.648]],["description/48",[84,3.374,86,5.029,112,2.793,131,2.056,243,5.419,401,6.81,402,7.554]],["title/49",[32,0.654,112,2.235]],["description/49",[17,0.3,32,0.743,53,0.263,56,0.651,62,0.627,112,2.539,134,0.494,166,0.344,168,0.35,204,1.239,403,6.192]],["title/50",[73,1.282,112,2.235]],["description/50",[17,0.3,53,0.263,56,0.651,62,0.627,73,1.456,112,2.539,134,0.494,166,0.344,168,0.35,204,1.239,403,6.192]],["title/51",[32,0.654,112,2.235]],["description/51",[17,0.294,32,0.729,53,0.258,56,0.639,62,0.616,112,2.494,134,0.389,155,1.897,166,0.337,168,0.344,204,1.217,253,2.494,404,5.644]],["title/52",[112,2.235,265,1.528]],["description/52",[17,0.294,53,0.258,56,0.639,62,0.616,112,2.494,134,0.389,155,1.897,166,0.337,168,0.344,204,1.217,253,2.494,265,1.704,404,5.644]],["title/53",[112,2.235,139,1.435]],["description/53",[17,0.3,53,0.263,56,0.651,62,0.627,112,2.539,134,0.396,139,1.63,166,0.344,168,0.35,204,1.239,307,3.407,404,5.747]],["title/54",[112,1.934,139,1.242,405,4.716]],["description/54",[17,0.254,53,0.223,56,0.73,62,0.531,84,2.596,112,3.194,114,3.127,131,1.582,134,0.335,137,2.3,139,1.38,166,0.291,168,0.296,204,1.048,238,2.684,260,4.17,306,4.357,405,5.24,406,5.812]],["title/55",[112,2.235,407,3.779]],["description/55",[58,4.172,81,1.009,112,3.457,131,2.335,257,3.777,292,4.572,407,4.293,408,6.192,409,6.868]],["title/56",[32,0.566,112,1.934,407,3.269]],["description/56",[3,0.663,17,0.262,53,0.23,56,0.745,81,0.881,112,2.907,164,1.98,166,0.3,167,0.718,168,0.306,204,1.082,216,2.986,257,3.298,407,5.483,410,5.406]],["title/57",[73,1.109,112,1.934,407,3.269]],["description/57",[3,0.557,17,0.22,53,0.193,55,3.246,56,0.761,58,3.061,73,1.703,81,0.74,112,3.206,166,0.252,167,0.603,168,0.257,204,0.909,209,2.114,216,2.655,407,5.018,410,4.542,411,3.777,412,4.215,413,5.038,414,4.542,415,4.542]],["title/58",[32,0.566,112,1.934,407,3.269]],["description/58",[3,0.835,17,0.246,20,2.969,53,0.216,56,0.715,81,0.828,112,2.791,134,0.325,155,1.586,166,0.282,167,0.675,168,0.287,204,1.017,209,2.366,216,2.866,257,3.101,407,5.319,416,5.084]],["title/59",[112,1.934,265,1.322,407,3.269]],["description/59",[3,0.819,17,0.239,53,0.21,55,3.528,56,0.701,81,0.805,112,2.736,155,1.54,166,0.274,167,0.656,168,0.279,204,0.988,209,2.297,216,2.81,265,2.118,407,5.24,414,4.937,416,4.937]],["title/60",[109,3.119,112,2.235]],["description/60",[11,2.264,56,0.695,68,2.842,79,2.628,80,2.536,81,0.793,84,3.717,107,2.231,109,4.605,112,3.077,116,3.374,117,4.516,118,4.516,131,1.469,165,3.374,209,2.264,211,4.516,411,4.046,417,5.398]],["title/61",[32,0.566,109,2.698,112,1.934]],["description/61",[17,0.294,32,0.729,53,0.258,56,0.639,62,0.616,109,3.48,112,2.494,134,0.488,166,0.337,168,0.344,204,1.217,418,6.081]],["title/62",[73,1.109,109,2.698,112,1.934]],["description/62",[17,0.294,53,0.258,56,0.639,62,0.616,73,1.431,109,3.48,112,2.494,134,0.488,166,0.337,168,0.344,204,1.217,418,6.081]],["title/63",[32,0.566,109,2.698,112,1.934]],["description/63",[17,0.294,32,0.729,53,0.258,56,0.639,62,0.616,109,3.48,112,2.494,134,0.389,166,0.337,168,0.344,204,1.217,253,2.494,419,5.644]],["title/64",[109,2.698,112,1.934,265,1.322]],["description/64",[17,0.289,53,0.254,56,0.628,62,0.605,109,3.419,112,2.45,134,0.382,155,1.864,166,0.332,168,0.338,204,1.195,253,2.45,265,1.674,419,5.545]],["title/65",[109,2.698,112,1.934,139,1.242]],["description/65",[17,0.294,53,0.258,56,0.639,62,0.616,109,3.48,112,2.494,134,0.389,139,1.601,166,0.337,168,0.344,204,1.217,307,3.346,419,5.644]],["title/66",[114,3.852]],["description/66",[11,3.199,56,0.723,68,3.014,79,2.787,80,2.689,81,0.841,84,3.829,107,2.366,109,2.953,114,4.612,116,3.578,117,4.79,118,4.79,131,1.558,209,2.402,211,4.79,411,4.291]],["title/67",[32,0.654,114,3.252]],["description/67",[17,0.3,32,0.743,53,0.263,56,0.651,62,0.627,114,3.694,134,0.494,166,0.344,168,0.35,204,1.239,420,6.192]],["title/68",[73,1.282,114,3.252]],["description/68",[17,0.258,53,0.226,56,0.559,62,0.539,73,1.252,79,3.789,80,3.656,114,3.175,125,2.594,134,0.448,166,0.295,168,0.301,204,1.065,257,4.28,420,5.322,421,5.903,422,5.903]],["title/69",[32,0.654,114,3.252]],["description/69",[17,0.3,32,0.743,53,0.263,56,0.651,62,0.627,114,3.694,134,0.396,166,0.344,168,0.35,204,1.239,253,2.539,423,5.747]],["title/70",[114,3.252,265,1.528]],["description/70",[17,0.294,53,0.258,56,0.639,62,0.616,114,3.628,134,0.389,155,1.897,166,0.337,168,0.344,204,1.217,253,2.494,265,1.704,423,5.644]],["title/71",[114,3.252,139,1.435]],["description/71",[17,0.3,53,0.263,56,0.651,62,0.627,114,3.694,134,0.396,139,1.63,166,0.344,168,0.35,204,1.239,307,3.407,423,5.747]],["title/72",[129,1.322,424,1.738]],["description/72",[3,0.653,11,2.476,69,0.789,81,0.867,129,2.024,290,3.404,291,2.928,344,3.491,424,2.503,425,3.404,426,3.93,427,4.425,428,4.653,429,4.653,430,4.072,431,4.425]],["title/73",[73,1.109,129,1.144,424,1.504]],["description/73",[3,0.788,17,0.226,51,1.592,53,0.198,56,0.491,62,0.473,67,1.965,69,0.951,73,1.51,81,0.76,129,1.781,134,0.298,166,0.259,167,0.62,168,0.264,195,1.889,216,1.965,283,2.275,344,3.061,424,2.342,426,3.446,432,2.39,433,4.666]],["title/74",[32,0.566,129,1.144,424,1.504]],["description/74",[3,0.773,17,0.22,32,0.756,53,0.193,56,0.477,62,0.46,67,1.913,69,0.673,81,1.027,129,1.529,134,0.29,166,0.252,167,0.603,168,0.257,202,2.835,216,1.913,221,2.25,234,2.835,241,2.835,276,2.98,277,2.98,424,2.01,432,2.326,433,4.542,434,4.542,435,4.542,436,3.476]],["title/75",[32,0.566,129,1.144,424,1.504]],["description/75",[3,0.803,17,0.232,32,0.785,51,1.637,53,0.204,56,0.504,62,0.486,67,2.021,69,0.97,129,1.587,134,0.307,155,1.497,166,0.266,167,0.637,168,0.271,195,1.942,216,2.021,234,2.995,253,1.967,283,2.339,424,2.087,432,2.457,437,4.453]],["title/76",[129,1.144,139,1.242,424,1.504]],["description/76",[3,0.895,17,0.223,51,1.571,53,0.196,56,0.484,62,0.466,67,1.939,69,1.08,129,1.768,134,0.294,139,1.675,155,1.436,166,0.255,167,0.611,168,0.26,195,1.863,216,1.939,283,2.244,307,2.533,424,2.325,432,2.358,437,4.272]],["title/77",[129,1.144,265,1.322,424,1.504]],["description/77",[3,0.895,17,0.223,51,1.571,53,0.196,56,0.484,62,0.466,67,1.939,69,1.08,129,1.768,134,0.294,155,1.436,166,0.255,167,0.611,168,0.26,195,1.863,216,1.939,265,1.783,283,2.244,307,2.533,424,2.325,432,2.358,437,4.272]],["title/78",[73,0.978,129,1.008,424,1.325,438,3.307]],["description/78",[3,0.72,17,0.199,51,1.401,53,0.174,56,0.431,58,2.766,62,0.416,67,1.729,69,0.87,73,1.38,81,0.669,106,3.589,129,1.813,134,0.262,143,3.589,166,0.228,167,0.545,168,0.232,195,1.661,196,3.141,209,1.91,216,1.729,238,3.006,283,2.001,424,2.185,432,2.102,438,3.266,439,4.105,440,4.105,441,4.105,442,4.105]],["title/79",[129,1.008,139,1.094,424,1.325,438,3.307]],["description/79",[3,0.819,17,0.157,46,1.264,51,1.107,53,0.138,56,0.341,58,3.325,62,0.329,67,1.367,69,0.885,79,1.753,81,0.529,106,2.837,129,1.74,134,0.207,139,1.572,140,2.026,143,2.837,166,0.18,167,0.431,168,0.183,194,3.245,195,1.313,196,2.483,209,1.51,216,1.367,220,2.25,238,2.527,240,2.187,245,2.665,283,1.582,290,2.075,368,3.012,424,2.128,432,1.662,438,3.927,439,3.245,440,3.245,441,3.245,442,3.245,443,3.6,444,3.6,445,3.6,446,3.245]],["title/80",[424,1.504,447,2.457,448,3.269]],["description/80",[3,0.615,11,2.331,69,0.742,81,0.816,290,3.204,291,2.756,344,3.286,424,2.429,425,3.204,426,3.699,427,4.165,428,4.38,429,4.38,430,3.833,431,4.165,447,4.244,448,5.279,449,3.833]],["title/81",[73,0.978,424,1.325,447,2.165,448,2.881]],["description/81",[3,0.766,17,0.217,51,1.53,53,0.19,56,0.471,62,0.454,67,1.888,69,0.925,73,1.469,81,0.73,134,0.286,166,0.249,167,0.595,168,0.253,195,1.814,216,1.888,283,2.185,344,2.94,424,2.292,426,3.31,432,2.296,447,3.745,448,3.107,449,4.779,450,4.482]],["title/82",[32,0.498,424,1.325,447,2.165,449,3.18]],["description/82",[3,0.766,17,0.217,32,0.749,51,1.53,53,0.19,56,0.656,62,0.454,67,1.888,69,0.925,134,0.286,166,0.249,167,0.595,168,0.253,195,1.814,216,1.888,221,2.22,234,2.798,276,2.94,277,2.94,279,2.674,283,2.185,424,1.992,432,2.296,447,3.254,449,4.779,450,4.482]],["title/83",[32,0.498,424,1.325,447,2.165,448,2.881]],["description/83",[3,0.788,17,0.226,32,0.77,51,1.592,53,0.198,56,0.491,62,0.473,67,1.965,69,0.951,134,0.298,155,1.456,166,0.259,167,0.62,168,0.264,195,1.889,216,1.965,234,2.913,253,1.914,283,2.275,424,2.048,432,2.39,447,3.346,448,3.235,449,3.571,451,4.331]],["title/84",[139,1.094,424,1.325,447,2.165,448,2.881]],["description/84",[3,0.876,17,0.214,51,1.51,53,0.188,56,0.465,62,0.448,67,1.863,69,1.057,134,0.283,139,1.629,155,1.38,166,0.245,167,0.588,168,0.25,195,1.791,216,1.863,283,2.157,307,2.434,424,2.276,432,2.266,447,3.719,448,4.29,449,3.385,451,4.106]],["title/85",[265,1.165,424,1.325,447,2.165,448,2.881]],["description/85",[3,0.876,17,0.214,51,1.51,53,0.188,56,0.465,62,0.448,67,1.863,69,1.057,134,0.283,155,1.38,166,0.245,167,0.588,168,0.25,195,1.791,216,1.863,265,1.734,283,2.157,307,2.434,424,2.276,432,2.266,447,3.719,448,4.29,449,3.385,451,4.106]],["title/86",[424,1.738,452,2.02]],["description/86",[3,0.51,69,0.616,81,0.677,162,2.799,213,3.306,267,3.455,318,2.969,344,2.725,399,3.455,424,2.199,425,3.786,426,3.068,429,3.633,430,3.179,431,3.455,452,3.061,453,4.155,454,4.155,455,2.725,456,3.856,457,4.155,458,3.856,459,3.856,460,1.824,461,4.155,462,4.155,463,4.155,464,4.155,465,4.155,466,4.155,467,4.155]],["title/87",[73,1.109,424,1.504,452,1.748]],["description/87",[3,0.614,7,2.48,17,0.16,51,1.129,53,0.141,56,0.348,62,0.335,67,1.393,69,0.742,73,1.178,81,0.816,134,0.211,162,2.229,166,0.184,167,0.439,168,0.187,195,1.339,213,2.632,216,1.393,244,2.17,267,2.751,283,1.613,344,2.17,424,1.927,425,3.202,426,2.443,432,1.694,452,2.497,453,3.308,454,3.308,455,2.17,456,3.07,457,3.308,458,3.07,459,4.647,460,1.452,461,3.308,462,3.308,463,3.308,464,3.308,465,3.308,466,3.308,467,3.308,468,2.632,469,3.669,470,2.751,471,2.893,472,3.07]],["title/88",[32,0.566,424,1.504,452,1.748]],["description/88",[3,0.781,17,0.223,32,0.763,51,1.571,53,0.196,56,0.669,62,0.466,67,1.939,69,0.943,134,0.294,166,0.255,167,0.611,168,0.26,195,1.863,216,1.939,221,2.28,234,2.874,276,3.02,277,3.02,279,2.747,283,2.244,424,2.029,432,2.358,452,2.358,472,4.272]],["title/89",[252,4.377,424,1.504,452,1.748]],["description/89",[3,0.708,17,0.149,48,1.832,51,1.048,53,0.13,56,0.323,58,2.069,62,0.311,67,1.293,69,0.701,73,0.722,81,0.94,108,2.684,134,0.196,139,0.808,166,0.17,167,0.408,168,0.173,183,3.932,195,1.242,216,1.293,218,2.194,219,2.552,221,2.343,238,2.954,239,2.128,242,2.069,245,1.658,252,4.389,265,0.86,283,1.496,307,2.602,327,2.128,362,2.684,399,2.552,424,2.358,432,1.572,452,2.74,468,3.763,470,2.552,471,2.684,472,2.849,473,5.246,474,3.405,475,3.405]],["title/90",[265,1.322,424,1.504,452,1.748]],["description/90",[3,0.901,17,0.226,51,1.592,53,0.198,56,0.491,62,0.473,67,1.965,69,1.088,81,0.76,134,0.298,166,0.259,167,0.62,168,0.264,195,1.889,216,1.965,265,1.8,283,2.275,424,2.342,432,2.39,452,2.721,476,5.176]],["title/91",[32,0.566,424,1.504,452,1.748]],["description/91",[3,0.803,17,0.232,32,0.785,51,1.637,53,0.204,56,0.504,62,0.486,67,2.021,69,0.97,134,0.307,155,1.497,166,0.266,167,0.637,168,0.271,195,1.942,216,2.021,234,2.995,253,1.967,283,2.339,424,2.087,432,2.457,452,2.426,477,4.453]],["title/92",[139,1.242,424,1.504,452,1.748]],["description/92",[3,0.835,17,0.196,42,2.899,51,1.384,53,0.172,56,0.426,62,0.411,67,1.708,69,1.008,134,0.259,139,1.791,155,1.265,166,0.225,167,0.539,168,0.229,195,1.641,216,1.708,260,3.227,261,4.056,283,1.977,307,2.232,424,2.17,425,2.594,432,2.077,452,2.522,468,3.227,477,3.764,478,4.056,479,4.056,480,4.499,481,4.499]],["title/93",[265,1.322,424,1.504,452,1.748]],["description/93",[3,0.888,17,0.22,51,1.55,53,0.193,56,0.477,62,0.46,67,1.913,69,1.072,134,0.29,155,1.417,166,0.252,167,0.603,168,0.257,195,1.838,216,1.913,265,1.766,283,2.214,307,2.499,424,2.308,425,2.905,432,2.326,452,2.683,477,4.215]],["title/94",[424,1.738,482,3.486]],["description/94",[3,0.624,11,2.366,69,0.753,81,0.828,290,3.251,291,2.797,344,3.335,424,2.447,425,3.251,426,3.754,427,4.227,428,4.445,429,4.445,430,3.89,431,4.227,482,5.24,483,3.894,484,5.639]],["title/95",[73,1.109,424,1.504,482,3.016]],["description/95",[3,0.781,17,0.223,51,1.571,53,0.196,56,0.484,62,0.466,67,1.939,69,0.943,73,1.496,81,0.75,84,2.28,134,0.294,166,0.255,167,0.611,168,0.26,195,1.863,216,1.939,283,2.244,344,3.02,424,2.325,426,3.399,432,2.358,482,4.662,485,4.603]],["title/96",[32,0.566,424,1.504,482,3.016]],["description/96",[3,0.781,17,0.223,32,0.763,51,1.571,53,0.196,56,0.669,62,0.466,67,1.939,69,0.943,134,0.294,166,0.255,167,0.611,168,0.26,195,1.863,216,1.939,221,2.28,234,2.874,276,3.02,277,3.02,279,2.747,283,2.244,424,2.029,432,2.358,482,4.068,485,4.603]],["title/97",[32,0.566,424,1.504,482,3.016]],["description/97",[3,0.803,17,0.232,32,0.785,51,1.637,53,0.204,56,0.504,62,0.486,67,2.021,69,0.97,134,0.307,155,1.497,166,0.266,167,0.637,168,0.271,195,1.942,216,2.021,234,2.995,253,1.967,283,2.339,424,2.087,432,2.457,482,4.186,486,4.453]],["title/98",[139,1.242,424,1.504,482,3.016]],["description/98",[3,0.895,17,0.223,51,1.571,53,0.196,56,0.484,62,0.466,67,1.939,69,1.08,134,0.294,139,1.675,155,1.436,166,0.255,167,0.611,168,0.26,195,1.863,216,1.939,283,2.244,307,2.533,424,2.325,432,2.358,482,4.662,486,4.272]],["title/99",[265,1.322,424,1.504,482,3.016]],["description/99",[3,0.895,17,0.223,51,1.571,53,0.196,56,0.484,62,0.466,67,1.939,69,1.08,134,0.294,155,1.436,166,0.255,167,0.611,168,0.26,195,1.863,216,1.939,265,1.783,283,2.244,307,2.533,424,2.325,432,2.358,482,4.662,486,4.272]],["title/100",[487,4.235]],["description/100",[3,0.581,19,2.202,73,1.113,81,0.771,86,3.494,123,2.603,129,1.572,139,1.246,165,3.28,208,2.048,216,1.993,257,2.886,265,1.326,268,4.96,487,5.218,488,4.391,489,4.137,490,4.391,491,4.391,492,5.248,493,3.934,494,5.248,495,5.248,496,4.391]],["title/101",[32,0.654,487,3.576]],["description/101",[3,0.778,17,0.257,19,1.669,32,0.43,51,1.224,53,0.226,56,0.667,62,0.363,67,1.511,68,2.095,69,0.788,81,1.033,129,1.29,134,0.34,140,2.239,166,0.295,167,0.476,168,0.301,195,1.452,204,0.718,209,1.669,221,1.777,238,1.837,268,2.744,276,2.353,277,2.353,279,2.14,312,2.744,344,2.353,470,2.982,487,3.489,488,3.329,489,3.136,490,3.329,496,3.329,497,3.136,498,2.854,499,3.587]],["title/102",[73,1.282,487,3.576]],["description/102",[3,0.746,17,0.294,53,0.258,69,0.901,73,1.431,81,0.991,134,0.389,164,2.227,166,0.337,167,0.808,168,0.344,487,3.989,499,6.081]],["title/103",[32,0.654,487,3.576]],["description/103",[3,0.798,17,0.266,19,1.742,32,0.449,51,1.278,53,0.233,56,0.683,62,0.379,67,1.577,68,2.187,69,0.963,81,0.61,129,0.908,134,0.351,155,1.168,166,0.305,167,0.497,168,0.31,195,1.515,204,0.749,234,2.337,253,1.535,268,2.865,283,1.825,312,2.865,344,2.456,470,3.113,487,3.602,488,3.475,489,3.274,490,3.475,496,3.475,497,3.274,498,2.979,500,3.475,501,3.475]],["title/104",[265,1.528,487,3.576]],["description/104",[3,0.663,17,0.262,53,0.23,69,0.801,81,1.155,134,0.345,156,5.018,164,1.98,166,0.3,167,0.718,168,0.306,265,1.515,487,4.65,500,5.018,501,5.018,502,5.997,503,5.406,504,4.302]],["title/105",[139,1.435,487,3.576]],["description/105",[3,0.516,17,0.204,28,3.819,46,2.326,53,0.254,69,0.623,81,0.973,134,0.269,139,1.828,156,3.903,164,1.54,166,0.233,167,0.559,168,0.238,183,3.497,220,2.916,238,2.154,240,4.678,305,3.903,487,3.917,500,3.903,501,3.903,503,4.206,504,3.347,505,4.206,506,4.665,507,2.916,508,4.665,509,4.665]],["title/106",[510,3.252,511,2.792]],["description/106",[11,2.032,84,3.038,123,2.403,129,1.059,147,3.632,159,2.943,208,1.891,390,4.368,401,4.368,510,3.659,511,3.141,512,4.844,513,6.802,514,4.368,515,4.844,516,4.844,517,4.844,518,3.632,519,4.368,520,4.844,521,4.844,522,4.844,523,4.844,524,4.053,525,4.053,526,4.844,527,4.368,528,4.844,529,2.727,530,4.844,531,4.844]],["title/107",[32,0.566,510,2.814,511,2.415]],["description/107",[17,0.294,32,0.729,53,0.258,56,0.639,62,0.616,134,0.488,166,0.337,168,0.344,204,1.217,510,3.628,511,3.115,532,6.081]],["title/108",[73,1.109,510,2.814,511,2.415]],["description/108",[17,0.294,53,0.258,56,0.639,62,0.616,73,1.431,134,0.488,166,0.337,168,0.344,204,1.217,510,3.628,511,3.115,532,6.081]],["title/109",[32,0.566,510,2.814,511,2.415]],["description/109",[17,0.284,32,0.704,53,0.25,56,0.786,62,0.595,134,0.375,166,0.326,168,0.332,204,1.175,253,2.408,510,3.503,511,3.83,533,5.45]],["title/110",[265,1.322,510,2.814,511,2.415]],["description/110",[17,0.279,53,0.245,56,0.778,62,0.585,134,0.369,155,1.801,166,0.32,168,0.326,204,1.155,253,2.367,265,1.618,510,3.444,511,3.788,533,5.357]],["title/111",[139,1.242,510,2.814,511,2.415]],["description/111",[17,0.284,53,0.25,56,0.786,62,0.595,134,0.375,139,1.546,166,0.326,168,0.332,204,1.175,307,3.231,510,3.503,511,3.83,533,5.45]],["title/112",[32,0.566,510,2.814,534,3.016]],["description/112",[17,0.305,53,0.268,56,0.663,62,0.639,134,0.403,166,0.35,168,0.356,204,1.262,510,3.763,534,4.033,535,6.995]],["title/113",[483,2.698,511,2.415,529,2.944]],["description/113",[7,2.164,11,2.854,21,3.225,44,3.922,173,2.943,175,3.476,177,2.943,180,3.225,181,3.342,182,3.225,208,1.891,217,3.028,274,3.225,377,3.819,378,3.819,408,4.368,411,3.632,483,3.509,511,3.141,514,4.368,524,4.053,525,4.053,529,3.828,534,2.793,536,5.362,537,4.368,538,7.861]],["title/114",[32,0.498,483,2.378,511,2.128,529,2.594]],["description/114",[17,0.289,32,0.716,53,0.254,56,0.628,62,0.605,134,0.483,166,0.332,168,0.338,204,1.195,483,3.419,511,3.06,529,3.73,539,5.975]],["title/115",[73,0.978,483,2.378,511,2.128,529,2.594]],["description/115",[17,0.289,53,0.254,56,0.628,62,0.605,73,1.405,134,0.483,166,0.332,168,0.338,204,1.195,483,3.419,511,3.06,529,3.73,539,5.975]],["title/116",[32,0.498,483,2.378,511,2.128,529,2.594]],["description/116",[17,0.284,32,0.704,53,0.25,56,0.617,62,0.595,134,0.375,155,1.832,166,0.326,168,0.332,204,1.175,253,2.408,483,3.36,511,3.007,529,3.666,540,5.45]],["title/117",[139,1.094,483,2.378,511,2.128,529,2.594]],["description/117",[17,0.289,53,0.254,56,0.628,62,0.605,134,0.382,139,1.573,166,0.332,168,0.338,204,1.195,253,2.45,483,3.419,511,3.06,529,3.73,540,5.545]],["title/118",[265,1.165,483,2.378,511,2.128,529,2.594]],["description/118",[17,0.289,53,0.254,56,0.628,62,0.605,134,0.382,155,1.864,166,0.332,168,0.338,204,1.195,265,1.674,483,3.419,511,3.06,529,3.73,540,5.545]],["title/119",[32,0.566,483,2.698,534,3.016]],["description/119",[17,0.305,53,0.268,56,0.663,62,0.639,134,0.403,166,0.35,168,0.356,204,1.262,483,3.608,534,4.033,541,6.995]],["title/120",[122,2.427,123,2.999]],["description/120",[7,2.518,11,2.366,23,3.89,44,4.353,73,1.196,95,5.084,122,2.264,123,2.797,126,3.633,127,5.084,129,1.233,139,1.338,173,3.426,238,2.604,240,3.426,254,4.718,310,3.426,350,3.426,498,4.046,542,5.639,543,5.084,544,5.639,545,5.639]],["title/121",[32,0.566,122,2.1,123,2.595]],["description/121",[3,0.778,7,3.141,17,0.174,48,2.14,53,0.152,55,2.563,56,0.737,69,0.531,81,0.584,122,3.336,123,4.122,134,0.229,145,1.973,149,3.042,159,2.417,164,1.948,166,0.199,167,0.476,168,0.203,204,0.718,216,2.24,232,2.239,236,3.136,243,2.854,257,2.188,546,3.587,547,3.136,548,3.978,549,3.329,550,3.978,551,3.978,552,3.587,553,3.587]],["title/122",[73,1.109,122,2.1,123,2.595]],["description/122",[3,0.708,7,2.858,17,0.194,44,2.563,56,0.607,73,1.59,122,3.01,123,3.72,126,4.831,134,0.256,137,2.533,167,0.532,204,0.802,216,2.43,232,2.502,236,3.505,238,2.053,239,2.779,240,2.701,242,2.701,263,3.067,498,3.19,549,3.72,553,4.008,554,4.446,555,4.446,556,4.446,557,4.26]],["title/123",[32,0.566,122,2.1,123,2.595]],["description/123",[3,0.648,17,0.255,53,0.224,56,0.734,62,0.534,69,0.782,81,0.578,122,3.481,123,4.301,134,0.337,145,1.953,155,2.327,159,2.391,166,0.293,167,0.471,168,0.298,204,0.71,216,1.495,237,2.716,242,3.557,245,2.851,257,2.165,263,2.716,549,3.294,558,3.937,559,3.294]],["title/124",[122,2.1,123,2.595,265,1.322]],["description/124",[3,0.702,17,0.277,53,0.243,56,0.601,62,0.579,69,0.848,122,3.473,123,4.292,134,0.366,155,2.433,166,0.317,167,0.526,168,0.323,204,0.793,237,3.031,242,3.855,245,3.09,263,3.031,265,1.11,559,3.677]],["title/125",[122,2.1,123,2.595,139,1.242]],["description/125",[3,0.793,17,0.264,53,0.231,56,0.679,62,0.552,69,0.807,122,3.654,123,4.516,134,0.348,139,0.975,155,2.368,166,0.302,167,0.492,168,0.308,204,0.741,237,2.834,242,3.67,245,2.942,263,2.834,559,3.437]],["title/126",[126,3.895,557,4.025]],["description/126",[6,2.314,24,3.294,32,0.475,48,2.364,81,0.646,83,2.925,98,3.294,105,2.473,122,2.547,123,2.18,126,4.089,135,2.831,149,1.901,166,0.22,189,2.029,191,3.962,221,1.962,241,2.473,244,2.599,323,3.962,345,3.962,399,3.294,470,3.294,504,3.152,547,3.464,557,6.002,560,3.677,561,3.677,562,3.962,563,3.962,564,4.394,565,4.394,566,4.394,567,4.394,568,2.417,569,4.394]],["title/127",[126,3.895,557,4.025]],["description/127",[3,0.606,17,0.239,53,0.21,56,0.519,69,0.731,81,0.805,126,3.528,166,0.274,167,0.656,168,0.279,204,0.988,221,2.446,231,3.645,232,3.082,233,3.777,234,3.082,241,3.082,257,3.011,276,3.238,277,3.238,436,3.777,491,4.582,557,3.645,561,4.582,562,4.937,570,5.476]],["title/128",[32,0.566,126,3.37,557,3.482]],["description/128",[3,0.606,17,0.239,32,0.592,53,0.21,56,0.519,69,0.731,81,0.805,98,4.105,105,3.082,126,3.528,155,1.54,166,0.37,167,0.656,168,0.279,204,0.988,231,3.645,232,3.082,233,3.777,234,3.082,257,3.011,547,4.317,557,4.927,563,4.937,571,5.476]],["title/129",[131,1.646,137,2.393]],["description/129",[3,0.721,56,0.617,86,4.336,107,2.692,129,1.424,131,2.258,137,3.283,195,2.376,208,2.542,292,4.336,572,8.294,573,5.872]],["title/130",[32,0.566,131,1.424,137,2.07]],["description/130",[3,0.827,17,0.326,53,0.213,55,4.816,56,0.708,69,0.742,131,1.513,134,0.431,137,2.199,149,2.404,166,0.278,167,0.665,168,0.283,202,3.127,204,1.002,231,3.699,232,3.127,233,3.833,379,5.009,574,5.009]],["title/131",[73,1.109,131,1.424,137,2.07]],["description/131",[3,0.918,17,0.284,53,0.25,62,0.595,69,1.108,73,1.381,131,1.773,134,0.375,137,2.578,166,0.326,167,0.78,168,0.332,574,5.872]],["title/132",[32,0.566,131,1.424,137,2.07]],["description/132",[3,0.733,17,0.289,20,3.488,51,1.435,53,0.254,56,0.628,62,0.605,69,0.885,131,2.41,134,0.382,137,3.504,149,2.865,155,1.312,164,1.54,166,0.331,167,0.559,168,0.338,204,0.841,575,3.903]],["title/133",[131,1.424,137,2.07,265,1.322]],["description/133",[3,0.697,17,0.275,53,0.241,62,0.575,69,0.841,131,2.209,134,0.363,137,3.212,155,1.771,164,2.079,166,0.315,167,0.754,168,0.321,265,1.591,575,5.268]],["title/134",[131,1.424,137,2.07,139,1.242]],["description/134",[3,0.697,17,0.275,53,0.241,62,0.575,69,0.841,131,2.209,134,0.363,137,3.212,139,1.494,155,1.771,164,2.079,166,0.315,167,0.754,168,0.321,575,5.268]],["title/135",[32,0.498,137,1.824,145,2.287,576,4.61]],["description/135",[3,0.685,17,0.27,53,0.237,62,0.565,69,0.827,129,1.756,131,2.186,134,0.357,137,3.178,164,2.045,166,0.31,167,0.742,168,0.316,577,5.584,578,5.584]],["title/136",[73,0.978,137,1.824,145,2.287,579,3.857]],["description/136",[3,0.597,17,0.235,53,0.207,62,0.493,69,0.721,129,1.603,131,2.266,134,0.311,137,2.901,140,3.038,145,3.636,164,1.782,166,0.27,167,0.646,168,0.275,195,2.674,279,2.903,578,4.866,580,5.398,581,5.398,582,5.398]],["title/137",[137,1.824,145,2.287,265,1.165,579,3.857]],["description/137",[3,0.47,17,0.185,53,0.163,55,2.736,62,0.388,69,0.567,129,1.353,131,1.685,134,0.245,136,4.64,137,3.177,140,2.39,145,2.106,155,2.055,160,3.347,164,1.402,166,0.212,167,0.508,168,0.216,180,2.827,182,2.827,265,1.073,277,3.661,377,3.347,378,3.347,579,5.179,583,4.246,584,4.64,585,4.246,586,4.246,587,3.553,588,3.183,589,4.246,590,3.828,591,4.246]],["title/138",[131,1.95]],["description/138",[56,0.651,109,3.543,112,2.539,114,3.694,122,2.757,123,3.407,129,1.502,131,1.87,257,3.777,491,5.747,592,6.868,593,4.927]],["title/139",[32,0.654,131,1.646]],["description/139",[17,0.305,53,0.268,56,0.822,62,0.639,131,1.904,134,0.403,166,0.35,168,0.356,204,1.262,594,6.306]],["title/140",[73,1.282,131,1.646]],["description/140",[17,0.3,53,0.263,56,0.813,62,0.627,73,1.456,131,1.87,134,0.396,166,0.344,168,0.35,204,1.239,594,6.192]],["title/141",[73,1.109,131,1.424,438,3.753]],["description/141",[11,1.333,17,0.139,19,1.333,36,2.658,53,0.122,56,0.471,58,3.019,62,0.29,73,1.054,77,1.576,98,2.381,106,3.918,107,2.054,129,1.514,131,2.17,134,0.183,135,2.046,142,2.279,143,3.918,166,0.159,168,0.253,190,2.504,193,2.279,204,0.573,222,2.046,238,1.467,304,2.504,312,2.191,398,2.864,415,4.481,438,2.279,460,1.257,471,2.504,483,3.572,534,1.831,537,2.864,595,3.176,596,3.176,597,3.176,598,3.176,599,1.442,600,2.864,601,4.97,602,5.52,603,3.176,604,3.176,605,3.176,606,3.176,607,3.176,608,3.176,609,2.864,610,3.176,611,3.176,612,3.176]],["title/142",[32,0.654,131,1.646]],["description/142",[17,0.289,53,0.254,56,0.795,62,0.605,131,2.283,134,0.382,155,1.864,166,0.332,168,0.338,204,1.195,209,2.78,613,5.545]],["title/143",[131,1.646,265,1.528]],["description/143",[17,0.284,53,0.25,56,0.786,62,0.595,131,2.258,134,0.375,155,1.832,166,0.326,168,0.332,204,1.175,209,2.732,265,1.646,613,5.45]],["title/144",[131,1.646,139,1.435]],["description/144",[17,0.284,53,0.25,56,0.786,62,0.595,131,2.258,134,0.375,139,1.546,155,1.832,166,0.326,168,0.332,204,1.175,209,2.732,613,5.45]],["title/145",[32,0.498,131,1.255,158,2.726,173,2.8]],["description/145",[17,0.3,53,0.263,56,0.651,62,0.627,131,1.87,134,0.396,158,4.062,166,0.344,168,0.35,173,4.172,204,1.239,614,6.868]],["title/146",[32,0.654,534,3.486]],["description/146",[17,0.305,53,0.268,56,0.663,62,0.639,131,1.904,134,0.403,166,0.35,168,0.356,204,1.262,534,4.033,615,6.995]],["title/147",[32,0.498,131,1.255,510,2.48,534,2.658]],["description/147",[17,0.3,53,0.263,56,0.651,62,0.627,131,1.87,134,0.396,166,0.344,168,0.35,204,1.239,510,3.694,534,3.96,616,6.868]],["title/148",[32,0.498,131,1.255,483,2.378,534,2.658]],["description/148",[17,0.3,53,0.263,56,0.651,62,0.627,131,1.87,134,0.396,166,0.344,168,0.35,204,1.239,483,3.543,534,3.96,617,6.868]],["title/149",[129,1.566]],["description/149",[80,3.06,81,0.957,84,2.909,129,1.813,259,4.673,267,6.218,268,4.493,518,4.882,519,5.872,525,5.45,527,5.872,536,5.134,618,5.872]],["title/150",[32,0.654,129,1.322]],["description/150",[3,0.811,56,0.512,67,2.049,69,0.721,81,0.793,129,1.82,151,6.608,164,1.782,202,3.038,216,2.049,221,2.411,241,3.038,245,2.628,276,3.192,277,3.192,434,4.866,435,4.866,436,3.724,546,4.866,547,6.561,619,5.398]],["title/151",[32,0.654,129,1.322]],["description/151",[3,0.882,17,0.302,20,3.648,53,0.265,56,0.656,62,0.787,69,0.925,81,0.73,129,1.515,131,1.353,134,0.459,145,2.466,164,1.641,167,0.595,204,0.897,238,3.198,243,3.567,620,3.43,621,4.16]],["title/152",[129,1.322,139,1.435]],["description/152",[3,0.907,17,0.252,51,1.186,53,0.221,56,0.726,58,2.343,62,0.352,64,2.891,67,1.464,68,2.031,69,0.77,81,0.567,125,1.695,129,1.261,131,1.05,134,0.332,137,1.526,139,2.042,140,2.17,160,3.04,166,0.288,167,0.462,168,0.294,195,1.407,204,0.696,209,1.618,217,4.315,238,1.781,369,3.477,459,3.227,621,3.227,622,3.856,623,3.856,624,3.856]],["title/153",[81,0.769,129,1.144,265,1.322]],["description/153",[3,0.879,17,0.266,53,0.233,62,0.556,69,0.814,129,1.737,134,0.351,166,0.305,167,0.73,168,0.31,209,2.556,265,1.54,621,5.098,625,6.093,626,6.093,627,6.093,628,6.093]],["title/154",[129,1.144,447,2.457,629,3.178]],["description/154",[3,0.624,17,0.246,53,0.216,62,0.515,69,0.753,81,0.828,129,1.861,131,1.535,134,0.325,166,0.282,167,0.675,168,0.287,193,4.046,209,2.366,253,2.085,361,4.227,447,2.649,593,4.046,629,3.426,630,4.046,631,4.718,632,5.639]],["title/155",[32,0.498,129,1.008,158,2.726,173,2.8]],["description/155",[3,0.882,17,0.302,20,3.648,53,0.265,56,0.656,62,0.787,69,0.925,81,0.73,129,1.515,131,1.353,134,0.459,145,2.466,164,1.641,167,0.595,204,0.897,238,3.198,243,3.567,620,3.43,633,4.972]],["title/156",[32,0.403,129,1.228,302,2.328,303,1.72,593,2.672]],["description/156",[3,0.529,6,1.592,7,2.135,17,0.209,19,2.006,24,2.267,32,0.327,51,0.93,53,0.227,56,0.453,62,0.436,67,1.148,68,1.592,69,0.639,81,0.871,84,1.35,105,1.702,115,2.726,129,1.297,134,0.388,140,4.132,145,1.5,155,0.851,159,2.905,164,0.998,166,0.297,167,0.362,168,0.244,204,0.545,220,1.89,236,3.769,240,2.905,255,2.013,282,2.53,283,1.329,302,2.988,303,2.208,350,1.837,354,2.726,436,2.086,534,1.744,593,2.169,620,2.086,634,2.53,635,3.024,636,3.024,637,3.024,638,3.024,639,3.024,640,2.726,641,3.024,642,2.384,643,2.013,644,3.024]],["title/157",[32,0.445,81,0.605,129,0.901,170,2.575,536,3.248]],["description/157",[3,0.663,17,0.262,53,0.23,81,1.155,125,3.456,129,1.311,135,3.864,149,2.594,166,0.3,167,0.718,168,0.306,170,3.748,208,2.34,209,2.516,536,6.198,645,5.406,646,5.997]],["title/158",[32,0.367,81,0.499,129,0.743,131,0.925,137,1.345,142,2.438,645,3.064]],["description/158",[3,0.643,17,0.254,53,0.223,81,0.854,125,2.554,129,1.271,131,1.582,137,2.3,142,4.17,149,2.514,158,3.438,166,0.291,167,0.696,168,0.296,208,2.268,209,2.438,340,3.87,647,3.745,648,5.812,649,5.812,650,5.812,651,5.812]],["title/159",[20,1.961,32,0.403,81,0.547,129,0.814,170,2.328,652,3.725]],["description/159",[3,0.653,17,0.258,20,3.108,53,0.226,56,0.559,81,0.867,83,3.93,107,2.44,125,2.594,129,1.291,131,1.607,137,2.336,149,2.554,166,0.295,167,0.707,168,0.301,170,3.69,209,2.476,255,3.93,653,5.903,654,5.903]],["title/160",[32,0.566,129,1.144,195,1.909]],["description/160",[3,0.733,17,0.289,53,0.254,62,0.605,69,0.885,129,1.834,134,0.382,166,0.332,167,0.794,168,0.338,195,2.418,655,5.975,656,6.627]],["title/161",[129,1.322,657,2.999]],["description/161",[83,4.057,129,1.933,373,5.494,431,4.568,630,4.372,643,4.057,657,3.942,658,6.093,659,6.093,660,7.946,661,5.098,662,6.093,663,3.437,664,5.098]],["title/162",[32,0.498,129,1.008,657,2.287,663,1.994]],["description/162",[3,0.697,17,0.275,32,0.681,53,0.241,62,0.575,69,0.841,129,1.775,134,0.363,164,2.079,166,0.315,167,0.754,168,0.321,253,2.328,657,3.123,663,2.724,665,5.676]],["title/163",[73,0.874,129,0.901,657,2.044,663,1.782,664,3.448]],["description/163",[3,0.633,17,0.25,23,3.949,53,0.219,62,0.523,69,0.765,73,1.214,81,0.841,105,3.222,129,1.875,134,0.33,136,4.291,166,0.286,167,0.686,168,0.292,209,2.402,346,3.014,657,2.84,663,2.476,664,4.79,665,5.161]],["title/164",[32,0.498,129,1.008,202,2.594,657,2.287]],["description/164",[3,0.697,17,0.275,32,0.681,53,0.241,62,0.575,69,0.841,129,1.775,134,0.363,164,2.079,166,0.315,167,0.754,168,0.321,202,3.544,253,2.328,657,3.123,666,6.296]],["title/165",[290,3.486,667,4.766]],["description/165",[140,4.338,290,5.306,292,5.131,667,7.254]],["title/166",[129,1.144,290,3.016,667,4.124]],["description/166",[3,0.793,17,0.264,51,1.264,52,3.437,53,0.231,56,0.679,62,0.375,67,1.56,68,2.163,69,0.807,81,0.604,129,1.567,131,1.118,134,0.348,140,2.312,166,0.302,167,0.492,168,0.308,193,4.334,195,1.499,204,0.741,209,1.723,238,1.897,253,1.519,290,4.132,543,3.703,593,2.947,631,3.437,667,4.763,668,4.108,669,4.108,670,4.108,671,4.108]],["title/167",[303,2.792,672,4.766]],["description/167",[140,4.338,292,5.131,303,4.249,672,6.076,673,7.708]],["title/168",[129,1.144,303,2.415,672,4.124]],["description/168",[3,0.764,17,0.252,33,2.767,51,1.186,53,0.221,56,0.654,62,0.352,67,1.464,68,2.031,69,0.77,73,0.818,81,0.567,122,1.548,129,1.675,131,1.05,134,0.332,140,2.17,155,1.085,166,0.288,167,0.462,168,0.294,189,1.781,193,2.767,195,1.407,204,0.696,209,1.618,255,2.567,259,2.767,262,5.198,303,1.781,360,3.477,479,3.477,593,2.767,631,3.227,672,3.04,674,2.485,675,3.856,676,3.856,677,3.856,678,3.856,679,3.856]],["title/169",[189,2.792,674,3.895]],["description/169",[53,0.268,129,1.897,189,3.23,213,5.018,223,5.244,255,4.657,259,5.018,674,5.589,680,6.995]],["title/170",[32,0.498,129,1.008,189,2.128,674,2.97]],["description/170",[3,0.87,17,0.297,51,1.49,53,0.261,56,0.745,62,0.442,67,1.839,68,2.551,69,0.909,81,0.712,129,1.487,134,0.392,140,2.727,166,0.34,167,0.58,168,0.347,189,2.237,195,1.768,204,0.874,209,2.032,234,2.727,253,1.791,674,3.121,681,4.368]],["title/171",[73,0.874,129,0.901,139,0.978,189,1.902,674,2.655]],["description/171",[3,0.858,17,0.292,51,1.453,53,0.256,56,0.735,62,0.431,67,1.794,68,2.487,69,0.893,81,0.694,129,1.461,134,0.385,139,1.121,140,2.658,166,0.334,167,0.566,168,0.34,189,2.181,195,1.723,204,0.852,209,1.982,223,3.541,253,1.746,674,3.043,681,4.258,682,3.952]],["title/172",[129,1.008,189,2.128,265,1.165,674,2.97]],["description/172",[3,0.864,17,0.294,51,1.472,53,0.258,56,0.74,62,0.437,67,1.816,68,2.519,69,0.901,81,0.703,129,1.474,134,0.388,140,2.692,166,0.337,167,0.573,168,0.344,177,2.906,189,2.209,195,1.745,204,0.863,209,2.007,223,3.586,253,1.768,674,3.082,683,4.783]],["title/173",[129,1.322,195,2.206]],["description/173",[11,2.83,86,4.491,129,2.128,131,1.836,137,2.67,195,3.384,208,2.633,268,4.653]],["title/174",[452,2.393]],["description/174",[80,3.286,81,1.028,129,1.529,259,5.018,267,6.503,428,5.514,452,2.899,618,6.306,684,6.995]],["title/175",[32,0.654,452,2.02]],["description/175",[3,0.746,17,0.294,53,0.258,62,0.616,69,0.901,81,0.991,125,2.964,134,0.389,166,0.337,167,0.808,168,0.344,452,2.254,685,6.745]],["title/176",[32,0.654,452,2.02]],["description/176",[3,0.76,17,0.3,53,0.263,62,0.627,69,0.917,134,0.396,155,1.932,166,0.344,167,0.822,168,0.35,452,2.295,686,6.868]],["title/177",[452,2.02,657,2.999]],["description/177",[3,0.47,17,0.185,19,1.781,20,2.236,53,0.163,62,0.388,69,0.567,81,0.624,125,1.866,134,0.245,135,2.736,149,1.837,166,0.212,167,0.508,168,0.216,189,1.961,253,1.57,346,3.259,424,1.78,452,2.441,507,4.566,568,3.404,643,2.827,647,2.736,657,3.071,687,4.88,688,4.88,689,3.553,690,3.553,691,4.246,692,3.347,693,3.347,694,3.347,695,3.347,696,3.347,697,4.246]],["title/178",[452,2.02,657,2.999]],["description/178",[3,0.536,17,0.211,19,2.032,20,2.551,53,0.186,62,0.442,69,0.647,134,0.279,149,2.096,166,0.242,167,0.58,168,0.247,189,2.237,346,3.582,424,1.956,507,4.914,643,3.225,647,3.121,657,2.403,687,5.362,688,5.362,692,3.819,693,3.819,694,3.819,695,3.819,696,3.819,698,6.802,699,4.844]],["title/179",[447,2.457,452,1.748,629,3.178]],["description/179",[3,0.606,17,0.239,53,0.21,62,0.5,69,0.731,81,0.805,116,3.422,125,2.406,134,0.315,166,0.274,167,0.656,168,0.279,241,3.082,331,2.883,346,2.883,447,3.477,452,2.473,568,4.071,629,3.326,700,4.317,701,4.317,702,4.317,703,5.476]],["title/180",[447,2.457,452,1.748,629,3.178]],["description/180",[3,0.643,17,0.254,53,0.223,62,0.531,69,0.776,116,3.633,134,0.335,166,0.291,167,0.696,168,0.296,244,3.438,346,3.061,425,3.351,447,3.619,452,2.574,629,3.531,700,4.582,701,4.582,702,4.582,704,5.812]],["title/181",[139,1.242,452,1.748,705,2.754]],["description/181",[3,0.653,17,0.258,53,0.226,62,0.539,69,0.789,81,0.867,125,2.594,134,0.34,135,3.803,139,1.401,166,0.295,167,0.707,168,0.301,241,3.322,331,3.108,452,2.6,568,4.28,705,3.108,706,5.903]],["title/182",[139,1.242,452,1.748,705,2.754]],["description/182",[3,0.708,17,0.279,53,0.245,62,0.585,69,0.855,134,0.369,139,1.52,166,0.32,167,0.767,168,0.326,244,3.787,425,3.692,452,2.741,705,3.372,707,6.403]],["title/183",[452,1.748,708,4.124,709,4.124]],["description/183",[3,0.653,17,0.258,53,0.226,62,0.539,69,0.789,81,0.867,125,2.594,134,0.34,135,3.803,166,0.295,167,0.707,168,0.301,241,3.322,331,3.108,452,2.6,568,4.28,708,4.653,709,4.653,710,5.903]],["title/184",[452,1.748,708,4.124,709,4.124]],["description/184",[3,0.708,17,0.279,53,0.245,62,0.585,69,0.855,134,0.369,166,0.32,167,0.767,168,0.326,244,3.787,425,3.692,452,2.741,708,5.047,709,5.047,711,6.403]],["title/185",[32,0.566,452,1.748,712,2.263]],["description/185",[3,0.348,17,0.137,48,2.656,53,0.121,62,0.288,69,0.421,81,0.463,83,3.287,108,2.483,125,1.384,134,0.181,164,1.04,166,0.158,167,0.377,168,0.16,188,2.483,189,3.183,202,2.779,220,1.969,221,1.407,222,2.029,239,1.969,240,1.913,245,2.965,255,3.287,331,1.659,340,2.097,346,1.659,350,2.999,352,2.029,356,2.26,357,2.26,358,2.26,436,2.173,452,1.65,504,2.26,568,1.732,584,2.361,642,2.483,663,1.363,712,2.982,713,1.773,714,2.26,715,2.84,716,2.636,717,2.636,718,2.483,719,2.636,720,2.361,721,2.361,722,2.84,723,2.84,724,2.636,725,2.84,726,2.84,727,2.84,728,2.84,729,2.84,730,2.84,731,2.84,732,2.636,733,2.84,734,3.15]],["title/186",[735,3.487]],["description/186",[452,2.629,471,6.202,497,6.202,507,4.918,735,3.831]],["title/187",[32,0.654,735,2.944]],["description/187",[3,0.465,7,3.566,17,0.183,24,3.148,53,0.161,62,0.383,69,0.561,81,0.617,125,2.698,134,0.242,137,1.662,162,2.551,166,0.21,167,0.503,168,0.214,276,2.483,279,3.303,331,2.211,376,2.897,436,2.897,452,1.403,468,4.405,507,2.624,568,2.309,647,2.705,714,3.012,735,2.989,736,5.137,737,3.513,738,3.513,739,3.513,740,3.513,741,4.199,742,3.513,743,3.513,744,3.513,745,4.199,746,4.199,747,4.199]],["title/188",[32,0.654,735,2.944]],["description/188",[3,0.76,17,0.3,53,0.263,62,0.627,69,0.917,134,0.396,155,1.932,166,0.344,167,0.822,168,0.35,735,3.344,748,6.868]],["title/189",[657,2.999,735,2.944]],["description/189",[3,0.459,11,1.742,17,0.181,19,1.742,20,2.187,53,0.159,62,0.379,69,0.555,81,0.61,125,1.825,134,0.239,149,1.796,166,0.208,167,0.497,168,0.212,189,1.918,217,2.596,253,1.535,346,3.207,424,1.751,452,1.388,507,4.507,568,3.349,643,2.765,647,2.676,657,3.021,687,4.801,688,4.801,690,3.475,692,3.274,693,3.274,694,3.274,695,3.274,696,3.274,735,3.511,749,4.153,750,4.153,751,4.153]],["title/190",[657,2.999,735,2.944]],["description/190",[3,0.55,17,0.217,19,2.086,20,2.618,53,0.19,62,0.454,69,0.664,134,0.286,149,2.151,166,0.249,167,0.595,168,0.253,189,2.296,346,3.648,424,1.992,507,4.329,643,3.31,647,3.203,657,2.466,687,5.46,688,5.46,692,3.919,693,3.919,694,3.919,695,3.919,696,3.919,735,2.421,752,4.972]],["title/191",[447,2.457,629,3.178,735,2.547]],["description/191",[3,0.47,7,3.262,17,0.185,53,0.163,62,0.388,69,0.567,81,0.624,116,2.654,125,2.72,134,0.245,137,1.681,166,0.212,167,0.508,168,0.216,241,2.39,279,2.284,331,3.259,346,2.236,376,2.929,447,2.908,468,3.046,568,4.017,629,2.579,647,2.736,700,3.347,701,3.347,702,3.347,735,3.014,736,3.553,737,3.553,738,3.553,739,3.553,740,3.553,742,3.553,743,3.553,744,3.553,753,3.828,754,4.246]],["title/192",[447,2.457,629,3.178,735,2.547]],["description/192",[3,0.643,17,0.254,53,0.223,62,0.531,69,0.776,116,3.633,134,0.335,166,0.291,167,0.696,168,0.296,244,3.438,346,3.061,425,3.351,447,3.619,629,3.531,700,4.582,701,4.582,702,4.582,735,3.751,755,5.812]],["title/193",[139,1.242,705,2.754,735,2.547]],["description/193",[3,0.504,7,3.393,17,0.199,53,0.174,62,0.416,69,0.608,81,0.669,125,2.861,134,0.262,137,1.802,139,1.081,166,0.228,167,0.545,168,0.232,241,2.562,279,2.449,331,3.428,376,3.141,468,3.266,568,4.179,647,2.933,705,2.397,735,3.17,736,3.809,737,3.809,738,3.809,739,3.809,740,3.809,742,3.809,743,3.809,744,3.809,753,4.105,756,4.553]],["title/194",[139,1.242,705,2.754,735,2.547]],["description/194",[3,0.708,17,0.279,53,0.245,62,0.585,69,0.855,134,0.369,139,1.52,166,0.32,167,0.767,168,0.326,244,3.787,425,3.692,705,3.372,735,3.995,757,6.403]],["title/195",[32,0.566,712,2.263,735,2.547]],["description/195",[3,0.348,17,0.137,48,2.656,53,0.121,62,0.288,69,0.421,81,0.463,83,3.287,108,2.483,125,1.384,134,0.181,164,1.04,166,0.158,167,0.377,168,0.16,188,2.483,189,3.183,202,2.779,220,1.969,221,1.407,222,2.029,239,1.969,240,1.913,245,2.965,255,3.287,331,1.659,340,2.097,346,1.659,350,2.999,352,2.029,356,2.26,357,2.26,358,2.26,436,2.173,504,2.26,568,1.732,584,2.361,642,2.483,663,1.363,712,2.982,713,1.773,714,2.26,715,2.84,716,2.636,717,2.636,718,2.483,719,2.636,720,2.361,721,2.361,722,2.84,723,2.84,724,2.636,725,2.84,726,2.84,727,2.84,728,2.84,729,2.84,730,2.84,731,2.84,732,2.636,733,2.84,735,2.404,758,3.15]],["title/196",[712,3.098]],["description/196",[32,0.524,42,3.121,48,2.606,73,1.027,77,2.403,122,2.731,139,1.15,154,4.053,155,1.363,333,4.368,346,2.551,447,2.276,452,2.849,497,3.819,507,3.028,643,3.225,663,2.096,705,2.551,712,3.688,713,2.727,735,3.828,759,4.844,760,5.099,761,3.476,762,4.844]],["title/197",[32,0.654,712,2.615]],["description/197",[3,0.589,17,0.232,38,3.989,39,3.989,53,0.204,58,3.233,62,0.486,69,0.711,73,1.129,81,0.782,134,0.307,166,0.266,167,0.637,168,0.271,221,2.377,244,3.147,327,3.326,584,3.989,712,3.574,713,2.995,763,4.798,764,4.798,765,5.322,766,4.798,767,4.195,768,5.322]],["title/198",[712,2.615,761,4.337]],["description/198",[3,0.418,17,0.165,38,2.833,39,2.833,42,2.435,53,0.145,58,3.45,62,0.345,69,0.505,73,0.801,81,0.555,134,0.218,149,1.635,166,0.189,167,0.453,168,0.193,221,1.688,304,2.979,306,2.833,327,2.362,346,1.99,584,2.833,640,3.407,642,2.979,663,1.635,712,3.832,713,2.127,717,3.162,718,2.979,719,3.162,761,5.441,763,3.407,764,3.407,766,3.407,767,2.979,769,3.779,770,3.407,771,3.407,772,3.779,773,5.679,774,3.779,775,3.779,776,3.162,777,3.779,778,3.779,779,3.779]],["title/199",[780,4.235]],["description/199",[7,3.624,81,0.638,86,2.892,96,2.799,122,2.526,154,3.634,164,1.434,196,2.996,198,3.424,245,2.115,265,1.097,322,3.634,349,3.634,352,2.799,361,3.256,507,2.715,557,2.892,630,4.515,634,3.634,643,2.892,732,5.265,760,3.256,780,3.722,781,3.916,782,4.344,783,4.344,784,4.344,785,4.344,786,4.344,787,4.344,788,4.344,789,4.344,790,4.344,791,4.344,792,3.424,793,4.344,794,4.344]],["title/200",[73,1.109,122,2.1,780,3.094]],["description/200",[3,0.486,10,3.962,17,0.192,42,2.831,53,0.168,54,3.677,62,0.401,69,0.587,73,0.932,81,0.646,96,2.831,122,1.764,134,0.253,142,3.152,155,1.236,166,0.22,167,0.526,168,0.224,196,3.031,238,2.029,239,2.746,327,2.746,331,2.314,346,2.314,350,2.669,560,3.677,657,3.695,713,2.473,780,4.405,795,3.677,796,3.464,797,4.394,798,4.394,799,3.677,800,3.677,801,3.962,802,3.962,803,3.962,804,3.962]],["title/201",[48,2.814,122,2.1,780,3.094]],["description/201",[3,0.597,17,0.235,48,2.903,53,0.207,62,0.493,69,0.721,81,0.793,122,2.167,134,0.311,166,0.27,167,0.646,168,0.275,189,2.492,202,3.038,245,2.628,340,3.593,350,3.279,352,3.478,356,3.872,357,3.872,358,3.872,568,2.968,714,3.872,720,4.046,721,4.046,780,3.192,804,4.866]],["title/202",[32,0.566,122,2.1,780,3.094]],["description/202",[3,0.674,17,0.266,53,0.233,62,0.556,69,0.814,81,0.895,122,2.446,134,0.351,164,2.012,166,0.305,167,0.73,168,0.31,221,2.721,244,3.604,713,3.429,780,5.229,805,5.098]],["title/203",[122,2.1,139,1.242,780,3.094]],["description/203",[3,0.486,7,1.962,17,0.192,42,2.831,53,0.168,62,0.401,69,0.587,73,0.932,122,1.764,134,0.253,135,2.831,166,0.22,167,0.526,168,0.224,198,3.464,240,3.855,257,2.417,265,1.11,327,2.746,478,3.962,505,3.962,560,3.677,657,2.18,780,4.824,795,3.677,796,3.464,799,3.677,800,3.677,805,3.677,806,3.677,807,4.394,808,4.394,809,4.394,810,4.394,811,4.394,812,4.394,813,4.394,814,3.962,815,4.394]],["title/204",[122,2.1,265,1.322,780,3.094]],["description/204",[3,0.529,7,2.136,9,3.586,17,0.209,53,0.183,62,0.437,69,0.639,81,0.703,96,3.082,122,1.92,134,0.276,145,2.373,164,1.579,166,0.239,167,0.573,168,0.244,221,2.136,222,3.082,244,2.829,260,3.432,265,1.703,452,1.598,620,3.3,713,2.692,716,4.002,780,5.014,799,4.002,800,4.002,801,4.312,805,4.002,816,4.783,817,4.783]],["title/205",[663,2.615,712,2.615]],["description/205",[7,2.72,11,1.321,20,1.659,32,0.341,46,1.106,48,1.694,83,4.054,122,1.982,162,1.913,196,2.173,241,1.773,245,1.534,257,3.349,305,2.636,331,3.206,361,2.361,452,2.303,588,2.361,630,4.369,634,2.636,663,2.634,689,2.636,705,1.659,712,3.239,760,3.701,761,2.26,796,2.483,814,2.84,818,4.946,819,2.84,820,2.84,821,2.636,822,2.84,823,2.84,824,4.937,825,3.15,826,3.15,827,4.131,828,3.406,829,3.15,830,3.15,831,3.15,832,3.892,833,2.483,834,3.15,835,2.84,836,2.84,837,3.15,838,2.84]],["title/206",[73,1.109,663,2.263,712,2.263]],["description/206",[1,2.751,3,0.406,17,0.16,19,1.539,42,2.364,46,1.288,53,0.141,62,0.335,69,0.49,73,0.778,96,2.364,122,2.229,134,0.211,142,2.632,155,1.032,166,0.184,167,0.439,168,0.187,188,2.893,241,3.126,245,1.787,256,3.308,257,3.054,334,3.308,346,2.924,350,2.229,352,2.364,452,1.856,630,3.984,657,2.755,663,2.899,689,3.07,705,1.932,712,2.899,718,2.893,795,3.07,796,2.893,802,3.308,818,3.984,819,3.308,820,3.308,821,3.07,822,3.308,823,3.308,839,3.669,840,3.669,841,3.669,842,3.308]],["title/207",[32,0.566,663,2.263,712,2.263]],["description/207",[3,0.597,17,0.235,48,2.903,53,0.207,62,0.493,69,0.721,81,0.793,134,0.311,166,0.27,167,0.646,168,0.275,189,2.492,202,3.038,245,2.628,340,3.593,350,3.279,352,3.478,356,3.872,357,3.872,358,3.872,568,2.968,663,2.335,712,2.335,714,3.872,720,4.046,721,4.046,842,4.866]],["title/208",[32,0.566,663,2.263,712,2.263]],["description/208",[3,0.565,17,0.223,46,1.793,53,0.196,62,0.466,69,0.682,81,0.75,134,0.294,164,1.686,166,0.255,167,0.611,168,0.26,221,2.28,244,3.02,245,2.486,340,3.399,498,3.663,663,3.773,712,3.498,713,2.874,818,3.663,843,5.106,844,5.106,845,5.106,846,5.106,847,5.106]],["title/209",[32,0.498,331,2.427,663,1.994,712,1.994]],["description/209",[3,0.418,17,0.165,20,1.99,48,2.033,53,0.145,62,0.345,69,0.505,81,0.555,83,2.516,134,0.218,162,3.45,164,1.248,166,0.189,167,0.453,168,0.193,189,1.745,202,2.127,221,1.688,245,1.84,331,3.592,340,2.516,350,2.296,352,2.435,356,2.711,357,2.711,358,2.711,399,2.833,446,3.407,452,1.263,493,2.833,568,2.078,588,2.833,630,4.074,663,2.951,712,3.517,713,2.127,714,2.711,720,2.833,721,2.833,803,5.12,835,3.407,836,3.407,838,3.407,848,3.779,849,3.779,850,3.779]],["title/210",[663,2.263,712,2.263,828,3.609]],["description/210",[3,0.51,17,0.201,53,0.177,62,0.421,69,0.616,81,0.677,134,0.265,164,1.521,166,0.231,167,0.552,168,0.235,221,2.058,327,2.88,331,3.458,337,3.633,338,3.633,587,3.856,588,3.455,663,3.963,712,3.963,713,2.594,771,4.155,828,4.53,833,3.633,851,4.155,852,4.608,853,4.608]],["title/211",[663,2.263,712,2.263,833,4.124]],["description/211",[3,0.529,17,0.209,53,0.183,62,0.437,69,0.639,77,2.373,81,0.703,122,2.706,134,0.276,164,1.579,166,0.239,167,0.573,168,0.244,221,2.136,274,3.184,663,3.667,712,3.667,713,2.692,818,3.432,827,4.002,828,4.651,832,5.314,833,5.314,854,4.783,855,4.783,856,4.783]],["title/212",[29,3.248,663,1.782,712,1.782,818,2.956,832,3.248]],["description/212",[3,0.486,17,0.192,29,3.464,53,0.168,62,0.401,69,0.587,81,0.646,96,2.831,120,3.677,134,0.253,164,1.451,166,0.22,167,0.526,168,0.224,221,1.962,241,2.473,242,2.669,245,2.14,260,3.152,663,3.222,712,3.222,713,2.473,767,3.464,818,5.852,827,3.677,828,3.031,832,3.464,857,7.449,858,4.394,859,4.394,860,4.394,861,4.394,862,4.394,863,4.394]],["title/213",[663,2.263,712,2.263,761,3.753]],["description/213",[1,3.413,3,0.504,17,0.199,46,1.599,53,0.174,62,0.416,69,0.608,81,0.669,134,0.262,149,1.97,164,1.503,166,0.228,167,0.545,168,0.232,221,2.033,331,3.428,337,3.589,346,2.397,363,4.105,663,3.587,712,3.795,713,2.562,761,5.451,770,4.105,851,4.105,864,4.553,865,4.553,866,4.553,867,4.105,868,4.553]],["title/214",[84,2.336,208,2.041,869,3.094]],["description/214",[7,2.22,11,2.086,20,2.618,21,3.31,44,3.994,84,3.094,96,3.203,131,1.353,173,3.02,175,3.567,177,3.02,180,3.31,181,3.43,182,3.31,208,2.703,217,3.107,274,3.31,377,3.919,378,3.919,411,3.727,561,4.16,629,3.02,792,3.919,869,4.715,870,4.972,871,4.972,872,6.927]],["title/215",[32,0.498,84,2.059,208,1.799,869,2.726]],["description/215",[17,0.294,53,0.258,56,0.804,62,0.616,84,3.013,134,0.389,166,0.337,168,0.344,204,1.217,208,2.633,869,3.989,873,6.081]],["title/216",[73,0.978,84,2.059,208,1.799,869,2.726]],["description/216",[17,0.289,53,0.254,56,0.795,62,0.605,73,1.405,84,2.96,134,0.382,166,0.332,168,0.338,204,1.195,208,2.586,869,3.919,873,5.975]],["title/217",[32,0.498,84,2.059,208,1.799,869,2.726]],["description/217",[17,0.279,53,0.245,56,0.778,62,0.585,84,2.86,131,1.743,134,0.369,155,1.801,166,0.32,168,0.326,204,1.155,208,2.499,209,2.686,869,3.787,874,5.357]],["title/218",[84,2.059,139,1.094,208,1.799,869,2.726]],["description/218",[17,0.235,53,0.207,56,0.695,62,0.493,73,1.145,84,2.411,125,2.372,131,1.469,134,0.311,139,1.74,155,1.518,166,0.27,168,0.275,204,0.974,208,2.861,209,2.264,245,2.628,338,4.255,792,5.778,869,3.192,874,4.516,875,5.398,876,5.398]],["title/219",[84,2.059,208,1.799,265,1.165,869,2.726]],["description/219",[17,0.246,53,0.216,56,0.715,62,0.515,84,3.372,131,1.535,134,0.325,145,2.797,155,1.586,166,0.282,168,0.287,204,1.017,208,2.946,209,2.366,265,2.15,792,4.445,869,4.465,874,4.718]],["title/220",[79,2.944,80,2.84]],["description/220",[3,0.827,11,3.136,56,0.527,79,4.113,80,3.968,81,0.816,84,2.481,85,5.009,86,3.699,107,2.296,109,3.856,110,4.649,341,4.649,368,4.649,374,3.986,573,5.009,781,5.009,877,5.556]],["title/221",[32,0.566,79,2.547,80,2.457]],["description/221",[6,3.209,17,0.266,28,3.513,32,0.659,53,0.233,79,2.967,80,2.862,134,0.351,166,0.305,167,0.73,168,0.31,204,1.099,237,4.204,263,4.204,276,3.604,277,3.604,279,3.278,280,5.494,878,5.494]],["title/222",[73,1.109,79,2.547,80,2.457]],["description/222",[3,0.643,17,0.254,53,0.223,56,0.551,69,0.776,73,1.832,79,4.207,80,4.059,107,2.402,134,0.335,162,3.531,166,0.291,167,0.696,168,0.296,295,4.582,878,5.24]],["title/223",[32,0.566,79,2.547,80,2.457]],["description/223",[17,0.305,32,0.756,53,0.268,79,3.406,80,3.286,155,1.967,166,0.35,167,0.838,168,0.356,204,1.262,879,5.853]],["title/224",[79,2.547,80,2.457,265,1.322]],["description/224",[3,0.615,17,0.242,53,0.213,56,0.527,62,0.507,69,0.742,79,4.113,80,3.968,107,3.089,134,0.32,145,2.756,162,3.375,165,3.473,166,0.278,167,0.665,168,0.283,265,1.889,295,4.38,879,4.649]],["title/225",[79,2.547,80,2.457,139,1.242]],["description/225",[3,0.811,17,0.235,53,0.207,56,0.512,69,0.721,73,1.145,79,4.347,80,4.194,107,2.231,125,2.372,134,0.311,139,1.281,162,3.279,165,3.374,167,0.646,198,4.255,238,2.492,295,4.255,307,2.678,879,4.516]],["title/226",[32,0.498,79,2.244,80,2.165,498,3.307]],["description/226",[3,0.753,17,0.211,32,0.524,53,0.186,56,0.645,69,0.647,73,1.443,79,4.151,80,4.218,107,2.811,134,0.279,145,2.403,166,0.242,167,0.58,168,0.247,202,2.727,209,2.032,253,1.791,880,4.844,881,6.802,882,4.368,883,2.943,884,4.844]],["title/227",[50,2.457,303,2.415,885,2.814]],["description/227",[46,2.248,50,4.253,53,0.245,116,4.002,131,1.743,137,2.534,292,4.263,303,3.788,663,2.77,885,3.444,886,6.403,887,6.403,888,6.403]],["title/228",[32,0.498,50,2.165,303,2.128,885,2.48]],["description/228",[17,0.284,32,0.704,46,2.287,50,3.06,53,0.25,56,0.786,62,0.595,134,0.375,166,0.326,168,0.332,204,1.175,303,3.007,885,3.503,889,5.872]],["title/229",[50,2.165,73,0.978,303,2.128,885,2.48]],["description/229",[17,0.284,46,2.287,50,3.06,53,0.25,56,0.786,62,0.595,73,1.381,134,0.375,166,0.326,168,0.332,204,1.175,303,3.007,885,3.503,889,5.872]],["title/230",[32,0.498,50,2.165,303,2.128,885,2.48]],["description/230",[17,0.254,32,0.628,46,2.705,50,3.619,53,0.223,56,0.819,62,0.531,134,0.335,155,1.635,164,1.919,166,0.291,168,0.296,204,1.048,303,3.557,885,4.144,890,4.863]],["title/231",[50,2.165,265,1.165,303,2.128,885,2.48]],["description/231",[17,0.229,28,4.146,46,1.843,50,3.853,53,0.201,56,0.681,62,0.479,103,4.137,134,0.302,155,1.476,164,1.732,166,0.263,168,0.267,204,0.947,253,1.94,265,1.817,303,3.787,620,3.62,885,4.412,890,4.391]],["title/232",[50,2.165,139,1.094,303,2.128,885,2.48]],["description/232",[17,0.239,28,3.157,46,1.923,50,3.477,53,0.21,56,0.701,62,0.5,73,1.161,128,4.937,134,0.315,139,1.3,164,1.808,166,0.274,168,0.279,204,0.988,253,2.024,288,4.582,291,2.716,303,3.417,327,3.422,885,3.981,890,4.582]],["title/233",[28,2.376,32,0.445,50,1.936,303,1.902,885,2.216]],["description/233",[17,0.254,20,3.061,28,3.351,32,0.628,46,2.041,50,3.619,53,0.223,56,0.73,62,0.531,134,0.335,164,1.919,166,0.291,168,0.296,204,1.048,253,2.149,303,3.557,885,4.144,891,5.24]],["title/234",[28,2.376,50,1.936,265,1.041,303,1.902,885,2.216]],["description/234",[17,0.239,28,4.268,31,4.582,46,1.923,50,3.477,53,0.21,56,0.701,62,0.5,103,4.317,134,0.315,164,1.808,166,0.274,168,0.279,204,0.988,253,2.024,265,1.87,303,3.417,620,3.777,885,3.981,891,4.937]],["title/235",[208,2.041,460,2.07,599,2.375]],["description/235",[11,2.686,81,0.941,131,1.743,159,3.89,208,3.202,292,4.263,427,4.8,460,3.247,599,3.725,724,5.357,892,5.773,893,6.403,894,5.773]],["title/236",[32,0.498,208,1.799,460,1.824,599,2.093]],["description/236",[17,0.284,32,0.704,46,2.287,53,0.25,56,0.786,62,0.595,134,0.375,166,0.326,168,0.332,204,1.175,208,2.542,460,2.578,599,2.957,895,5.872]],["title/237",[73,0.978,208,1.799,460,1.824,599,2.093]],["description/237",[17,0.284,46,2.287,53,0.25,56,0.786,62,0.595,73,1.381,134,0.375,166,0.326,168,0.332,204,1.175,208,2.542,460,2.578,599,2.957,895,5.872]],["title/238",[32,0.498,208,1.799,460,1.824,599,2.093]],["description/238",[17,0.254,32,0.628,46,2.705,53,0.223,56,0.819,62,0.531,134,0.335,155,1.635,164,1.919,166,0.291,168,0.296,204,1.048,208,3.006,460,3.049,599,3.497,896,4.863]],["title/239",[208,1.799,265,1.165,460,1.824,599,2.093]],["description/239",[17,0.246,46,1.98,53,0.216,56,0.715,62,0.515,81,0.828,134,0.325,145,2.797,164,1.862,166,0.282,168,0.287,204,1.017,208,2.946,253,2.085,265,1.425,460,2.988,599,3.428,896,4.718,897,4.445,898,4.718]],["title/240",[139,1.094,208,1.799,460,1.824,599,2.093]],["description/240",[17,0.239,31,4.582,46,1.923,53,0.21,56,0.701,62,0.5,81,0.805,134,0.315,139,1.3,164,1.808,166,0.274,168,0.279,177,3.326,204,0.988,208,2.889,253,2.024,460,2.929,599,3.36,896,4.582,897,4.317,898,4.582,899,5.476]],["title/241",[460,2.393,599,2.745]],["description/241",[11,3.047,131,1.977,159,4.413,427,5.445,460,3.514,599,3.298,894,6.549,900,5.726]],["title/242",[32,0.566,460,2.07,599,2.375]],["description/242",[17,0.289,32,0.716,46,2.327,53,0.254,56,0.795,62,0.605,134,0.382,166,0.332,168,0.338,204,1.195,460,2.623,599,3.009,901,5.975]],["title/243",[73,1.109,460,2.07,599,2.375]],["description/243",[17,0.246,46,1.98,53,0.216,56,0.715,62,0.515,73,1.196,81,0.828,125,2.478,134,0.325,145,2.797,166,0.282,168,0.287,204,1.017,208,2.946,460,3.368,599,3.864,897,4.445,901,5.084]],["title/244",[32,0.566,460,2.07,599,2.375]],["description/244",[17,0.262,32,0.648,46,2.761,53,0.23,56,0.831,62,0.547,134,0.345,155,1.687,164,1.98,166,0.3,168,0.306,204,1.082,460,3.112,599,3.57,902,5.018]],["title/245",[265,1.322,460,2.07,599,2.375]],["description/245",[17,0.226,46,2.501,53,0.198,56,0.772,57,4.666,62,0.473,81,0.76,134,0.298,145,2.568,155,1.456,164,1.709,166,0.259,168,0.264,204,0.934,208,2.02,265,1.308,460,3.472,599,3.983,897,4.08,898,4.331,902,4.331]],["title/246",[139,1.242,460,2.07,599,2.375]],["description/246",[11,1.957,17,0.204,21,3.106,46,2.326,53,0.179,56,0.73,62,0.426,77,2.314,97,3.903,134,0.269,139,1.572,155,1.312,164,1.54,166,0.233,168,0.238,177,2.834,204,0.841,208,3.006,460,3.64,599,4.176,682,3.903,902,3.903]],["title/247",[53,0.274]],["description/247",[15,5.838,53,0.284,62,0.676,122,2.973,425,4.27,529,4.168,882,6.677,903,7.406]],["title/248",[32,0.566,46,1.837,53,0.2]],["description/248",[20,4.143,32,0.851,46,2.763,53,0.301,904,7.868]],["title/249",[905,5.138]],["description/249",[6,4.059,53,0.295,361,5.778,504,5.53,905,5.53,906,7.708]],["title/250",[32,0.498,218,2.97,905,3.307,907,3.634]],["description/250",[17,0.311,53,0.273,166,0.357,167,0.853,168,0.363,204,1.285,218,4.592,905,5.113,907,5.618,908,7.127]],["title/251",[32,0.498,218,2.97,905,3.307,907,3.634]],["description/251",[17,0.294,32,0.729,53,0.258,155,1.897,166,0.337,167,0.808,168,0.344,204,1.217,218,4.346,253,2.494,905,4.839,907,5.317,909,6.745]],["title/252",[34,4.768]],["description/252",[6,3.978,34,5.029,50,3.549,97,6.321,217,4.721,341,6.321,910,7.554]],["title/253",[6,2.427,32,0.498,34,3.069,518,3.456]],["description/253",[3,0.819,6,3.9,32,0.801,34,4.93,123,3.674,213,5.313,518,5.552,911,7.406]],["title/254",[302,3.269,705,2.754,912,3.753]],["description/254",[3,0.627,9,2.115,11,1.898,17,0.123,19,1.898,28,2.608,53,0.108,69,0.377,73,1.201,81,0.665,86,1.878,105,2.546,134,0.162,137,1.116,139,1.344,149,1.957,162,2.748,166,0.141,167,0.338,168,0.144,177,1.714,209,1.183,216,1.718,218,2.915,222,1.817,232,1.588,250,2.36,258,2.543,265,0.713,268,1.946,286,2.36,302,3.54,306,2.115,327,1.763,349,3.785,456,2.36,460,1.79,507,2.828,577,2.543,682,2.36,705,3.735,867,2.543,883,1.714,892,2.543,912,3.246,913,2.821,914,2.821,915,5.106,916,5.106,917,3.391,918,4.524,919,2.821,920,2.36,921,2.36,922,2.36,923,2.224,924,2.821,925,2.821,926,2.821,927,2.821]],["title/255",[73,0.874,139,0.978,302,2.575,705,2.17,912,2.956]],["description/255",[17,0.262,53,0.23,73,1.272,81,0.881,125,2.635,134,0.345,139,1.423,166,0.3,167,0.718,168,0.306,221,2.678,238,2.769,239,3.748,302,3.748,331,3.158,705,3.158,883,3.643,912,4.302,928,4.137,929,5.406]],["title/256",[265,1.165,302,2.881,705,2.427,912,3.307]],["description/256",[17,0.25,19,2.402,53,0.219,81,0.841,125,2.516,134,0.33,166,0.286,167,0.686,168,0.292,221,2.557,238,2.643,239,3.578,265,1.446,302,3.578,331,3.014,460,2.266,705,3.014,883,3.477,912,4.107,915,5.161,916,5.161,928,3.949,929,5.161]],["title/257",[56,0.573,455,3.576]],["description/257",[6,1.573,7,2.115,11,1.253,12,2.5,13,1.438,14,1.989,17,0.075,19,1.253,23,1.186,33,1.233,40,1.438,42,1.107,56,0.508,68,2.087,77,2.349,81,0.582,105,0.967,107,0.71,134,0.228,149,1.714,159,1.044,165,1.074,166,0.086,168,0.088,172,2.355,190,2.355,204,0.31,216,0.653,217,1.074,219,1.288,220,1.074,239,1.074,240,1.815,241,0.967,242,1.044,245,1.455,253,0.635,255,1.144,265,0.755,279,1.607,286,1.438,291,0.853,321,1.144,337,1.355,362,1.355,374,1.233,412,2.5,430,2.061,455,2.343,458,1.438,460,2.502,493,1.288,587,1.438,588,1.288,600,1.549,657,0.853,661,3.962,776,2.5,821,1.438,828,2.061,883,1.044,900,3.733,917,2.97,928,1.186,930,2.143,931,3.572,932,1.355,933,1.438,934,3.397,935,1.355,936,1.355,937,2.987,938,3.848,939,2.97,940,1.549,941,1.718,942,1.718,943,1.549,944,1.718,945,2.987,946,1.718,947,1.718,948,1.549,949,2.693,950,2.693,951,1.438,952,2.987,953,1.718,954,1.718,955,1.718,956,1.438,957,1.549,958,1.549,959,1.718,960,1.718,961,1.718,962,1.549,963,1.549,964,1.355,965,1.549,966,1.288,967,1.549,968,1.718,969,1.718,970,1.718,971,1.549,972,1.549,973,1.549,974,1.288,975,1.718,976,1.718]],["title/258",[19,1.729,56,0.39,73,0.874,139,0.978,455,2.437]],["description/258",[6,2.052,9,4.355,17,0.17,19,1.635,33,4.984,36,3.26,53,0.149,56,0.551,68,2.052,73,1.232,105,2.193,134,0.224,139,1.379,149,1.685,166,0.195,168,0.199,193,2.795,204,0.703,250,3.26,265,0.984,307,1.933,327,2.435,455,3.436,647,2.51,655,3.513,760,2.921,806,3.26,883,2.367,920,3.26,921,3.26,922,3.26,923,4.58,928,2.688,930,2.795,934,2.795,949,3.513,951,4.861,974,2.921,977,3.513,978,3.896,979,3.896,980,3.896,981,3.513,982,3.896,983,3.26]],["title/259",[19,1.563,32,0.403,46,1.308,56,0.353,134,0.215,455,2.203]],["description/259",[17,0.196,19,2.708,32,0.486,34,2.995,48,2.42,53,0.172,56,0.426,105,2.532,134,0.259,166,0.225,168,0.229,204,0.811,218,2.899,220,2.812,222,4.158,240,2.733,257,2.474,311,2.474,350,2.733,412,3.764,455,2.661,460,1.78,602,4.056,883,2.733,917,3.372,934,3.227,956,3.764,957,4.056,958,4.056,983,3.764,984,4.499,985,4.056,986,4.499,987,4.499,988,4.499,989,4.499,990,4.499,991,4.499,992,4.499]],["title/260",[19,1.934,56,0.437,265,1.165,455,2.726]],["description/260",[17,0.192,19,1.843,53,0.168,56,0.416,68,2.314,75,3.677,134,0.366,149,1.901,166,0.22,168,0.224,172,3.464,190,3.464,204,0.793,265,1.603,274,2.925,430,3.031,455,2.599,460,1.739,609,3.962,776,3.677,828,3.031,883,2.669,917,3.294,930,3.152,931,3.962,934,4.553,938,4.553,939,3.294,950,5.721,951,3.677,966,3.294,983,3.677,993,4.394,994,4.394,995,4.394,996,4.394,997,4.394,998,4.394]],["title/261",[14,3.069,73,0.978,139,1.094,374,3.307]],["description/261",[6,1.746,7,1.481,9,2.485,14,3.421,17,0.145,19,1.391,25,2.989,33,2.379,53,0.127,56,0.314,73,0.703,105,1.866,120,2.774,134,0.296,139,1.22,149,2.722,166,0.166,168,0.169,204,0.598,220,2.072,243,2.379,269,2.774,274,2.207,279,1.783,291,1.645,329,2.989,362,2.614,482,1.912,489,2.614,518,2.485,883,2.014,917,3.852,920,2.774,921,2.774,922,2.774,923,2.614,928,2.287,930,2.379,932,2.614,933,2.774,934,2.379,935,4.051,936,2.614,943,2.989,948,2.989,964,2.614,966,2.485,974,2.485,985,2.989,999,2.989,1000,3.315,1001,3.315,1002,3.315,1003,3.315,1004,3.315,1005,3.315,1006,3.315,1007,3.315,1008,3.315,1009,2.989,1010,3.315,1011,2.989,1012,2.989,1013,2.774]],["title/262",[14,2.743,32,0.445,46,1.447,134,0.237,374,2.956]],["description/262",[14,3.992,17,0.262,32,0.648,53,0.23,56,0.568,134,0.345,149,2.594,166,0.3,168,0.306,204,1.082,883,3.643,935,4.727,936,4.727,999,5.406,1009,5.406,1011,5.406,1012,5.406,1013,5.018,1014,5.997,1015,5.997]],["title/263",[14,3.482,265,1.322,374,3.753]],["description/263",[6,2.802,14,3.543,17,0.232,34,3.543,50,2.5,53,0.204,56,0.688,105,2.995,131,1.449,134,0.307,166,0.266,168,0.271,204,0.96,238,2.457,265,1.345,524,4.453,883,3.233,923,4.195,932,4.195,933,4.453,934,3.818,935,4.195,936,4.195,974,3.989,1013,4.453,1016,5.322,1017,5.322]],["title/264",[32,0.445,46,1.447,134,0.237,938,2.956,939,3.089]],["description/264",[6,2.163,8,3.238,11,1.723,19,1.723,23,2.834,46,1.442,56,0.389,105,2.312,149,2.614,172,3.238,239,2.567,245,2,279,2.21,307,2.038,321,2.735,352,2.647,455,3.573,460,2.836,760,3.079,806,3.437,900,3.238,928,2.834,930,2.947,932,3.238,956,3.437,964,3.238,966,3.079,967,3.703,971,3.703,972,3.703,973,3.703,974,3.079,977,3.703,981,3.703,1018,4.108,1019,4.108,1020,4.108,1021,5.447,1022,3.703,1023,4.108,1024,4.108,1025,4.108,1026,4.108,1027,4.108]],["title/265",[19,1.729,32,0.445,46,1.447,134,0.237,1028,4.12]],["description/265",[8,3.505,11,1.865,12,3.72,13,3.72,23,3.067,48,2.391,77,2.205,91,4.008,149,1.923,159,2.701,219,3.333,254,3.72,260,3.19,269,3.72,279,3.442,307,2.205,430,3.067,455,2.629,493,3.333,767,3.505,900,3.505,928,3.067,938,4.591,939,5.62,940,5.77,962,4.008,963,4.008,964,3.505,965,4.008,966,3.333,1021,4.008,1022,4.008,1029,4.446,1030,4.446,1031,4.446,1032,4.446,1033,4.446]],["title/266",[32,0.445,46,1.447,134,0.237,938,2.956,1034,3.715]],["description/266",[7,2.557,8,4.513,11,2.402,58,3.477,77,2.84,153,5.161,242,3.477,279,3.079,460,2.266,493,4.291,661,4.79,930,4.107,938,6.152,939,5.716,1034,5.161,1035,5.724,1036,5.724,1037,5.724,1038,5.724,1039,5.724]],["title/267",[44,4.129]],["description/267",[3,0.29,6,1.382,7,2.775,11,2.868,21,3.591,23,1.811,24,1.968,28,1.514,37,2.367,38,1.968,39,1.968,40,2.196,41,2.367,42,1.691,43,2.367,44,4.452,45,2.367,48,1.412,56,0.405,69,0.57,77,1.302,81,0.627,96,2.75,131,1.469,174,2.196,175,3.87,176,3.848,177,3.775,178,3.848,179,2.367,180,4.137,181,4.287,182,4.137,195,0.958,202,2.402,217,2.668,221,1.172,228,2.367,232,1.477,237,1.811,253,0.97,271,2.367,272,2.367,273,3.848,274,3.591,275,2.367,276,2.525,277,3.19,278,3.848,552,2.367,568,1.444,590,2.367,620,1.811,690,3.572]]],"invertedIndex":[["",{"_index":7,"title":{},"description":{"0":{},"6":{},"10":{},"16":{},"19":{},"22":{},"28":{},"41":{},"87":{},"113":{},"120":{},"121":{},"122":{},"156":{},"187":{},"191":{},"193":{},"199":{},"203":{},"204":{},"205":{},"214":{},"257":{},"261":{},"266":{},"267":{}}}],["00:00",{"_index":589,"title":{},"description":{"137":{}}}],["0:00",{"_index":181,"title":{},"description":{"6":{},"10":{},"16":{},"41":{},"113":{},"214":{},"267":{}}}],["100",{"_index":441,"title":{},"description":{"78":{},"79":{}}}],["10th",{"_index":228,"title":{},"description":{"10":{},"267":{}}}],["13th",{"_index":273,"title":{},"description":{"16":{},"267":{}}}],["1st",{"_index":179,"title":{},"description":{"6":{},"267":{}}}],["200",{"_index":921,"title":{},"description":{"254":{},"258":{},"261":{}}}],["201",{"_index":920,"title":{},"description":{"254":{},"258":{},"261":{}}}],["2026",{"_index":180,"title":{},"description":{"6":{},"10":{},"16":{},"41":{},"113":{},"137":{},"214":{},"267":{}}}],["204",{"_index":925,"title":{},"description":{"254":{}}}],["400",{"_index":261,"title":{},"description":{"14":{},"92":{}}}],["404",{"_index":966,"title":{},"description":{"257":{},"260":{},"261":{},"264":{},"265":{}}}],["5",{"_index":509,"title":{},"description":{"105":{}}}],["502",{"_index":971,"title":{},"description":{"257":{},"264":{}}}],["6-charact",{"_index":607,"title":{},"description":{"141":{}}}],["7517",{"_index":1018,"title":{},"description":{"264":{}}}],["8693",{"_index":933,"title":{},"description":{"257":{},"261":{},"263":{}}}],["9th",{"_index":378,"title":{},"description":{"41":{},"113":{},"137":{},"214":{}}}],["_disconnected_",{"_index":101,"title":{},"description":{"0":{}}}],["absolut",{"_index":875,"title":{},"description":{"218":{}}}],["accept",{"_index":136,"title":{},"description":{"0":{},"12":{},"14":{},"137":{},"163":{}}}],["access",{"_index":159,"title":{},"description":{"2":{},"19":{},"22":{},"106":{},"121":{},"123":{},"156":{},"235":{},"241":{},"257":{},"265":{}}}],["accordingli",{"_index":230,"title":{},"description":{"10":{}}}],["account",{"_index":51,"title":{"1":{},"2":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{}},"description":{"0":{},"1":{},"2":{},"6":{},"7":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"19":{},"22":{},"73":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"103":{},"132":{},"152":{},"156":{},"166":{},"168":{},"170":{},"171":{},"172":{}}}],["accountnumb",{"_index":224,"title":{},"description":{"10":{}}}],["acknowledgeattachedinst",{"_index":631,"title":{},"description":{"154":{},"166":{},"168":{}}}],["act",{"_index":54,"title":{},"description":{"0":{},"1":{},"200":{}}}],["action",{"_index":361,"title":{"40":{}},"description":{"154":{},"199":{},"205":{},"249":{}}}],["activ",{"_index":620,"title":{},"description":{"151":{},"155":{},"156":{},"204":{},"231":{},"234":{},"267":{}}}],["activeonly=tru",{"_index":715,"title":{},"description":{"185":{},"195":{}}}],["actual",{"_index":688,"title":{},"description":{"177":{},"178":{},"189":{},"190":{}}}],["ad",{"_index":899,"title":{},"description":{"240":{}}}],["add",{"_index":682,"title":{},"description":{"171":{},"246":{},"254":{}}}],["add-bmc",{"_index":298,"title":{},"description":{"24":{}}}],["addition",{"_index":970,"title":{},"description":{"257":{}}}],["address",{"_index":368,"title":{},"description":{"40":{},"79":{},"220":{}}}],["admin",{"_index":216,"title":{},"description":{"10":{},"14":{},"56":{},"57":{},"58":{},"59":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"100":{},"121":{},"122":{},"123":{},"150":{},"254":{},"257":{}}}],["advanc",{"_index":832,"title":{"212":{}},"description":{"205":{},"211":{},"212":{}}}],["against",{"_index":643,"title":{},"description":{"156":{},"161":{},"177":{},"178":{},"189":{},"190":{},"196":{},"199":{}}}],["aggreg",{"_index":192,"title":{},"description":{"7":{}}}],["ai",{"_index":521,"title":{},"description":{"106":{}}}],["alert",{"_index":675,"title":{},"description":{"168":{}}}],["algorithm",{"_index":1032,"title":{},"description":{"265":{}}}],["alloc",{"_index":107,"title":{"9":{},"41":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{}},"description":{"0":{},"9":{},"19":{},"21":{},"22":{},"41":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"60":{},"66":{},"129":{},"141":{},"159":{},"220":{},"222":{},"224":{},"225":{},"226":{},"257":{}}}],["allow",{"_index":292,"title":{},"description":{"23":{},"25":{},"55":{},"129":{},"165":{},"167":{},"227":{},"235":{}}}],["allowedaudi",{"_index":987,"title":{},"description":{"259":{}}}],["alongsid",{"_index":104,"title":{},"description":{"0":{}}}],["alreadi",{"_index":306,"title":{},"description":{"26":{},"40":{},"54":{},"198":{},"254":{}}}],["already-`termin",{"_index":775,"title":{},"description":{"198":{}}}],["already-paus",{"_index":852,"title":{},"description":{"210":{}}}],["already-termin",{"_index":866,"title":{},"description":{"213":{}}}],["altern",{"_index":432,"title":{},"description":{"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{}}}],["alway",{"_index":188,"title":{},"description":{"6":{},"185":{},"195":{},"206":{}}}],["anchor",{"_index":74,"title":{},"description":{"0":{},"3":{},"6":{},"16":{}}}],["announc",{"_index":43,"title":{},"description":{"0":{},"267":{}}}],["anoth",{"_index":409,"title":{},"description":{"55":{}}}],["api",{"_index":6,"title":{"253":{}},"description":{"0":{},"1":{},"2":{},"17":{},"126":{},"156":{},"221":{},"249":{},"252":{},"253":{},"257":{},"258":{},"261":{},"263":{},"264":{},"267":{}}}],["appli",{"_index":855,"title":{},"description":{"211":{}}}],["appropri",{"_index":76,"title":{},"description":{"0":{}}}],["approv",{"_index":314,"title":{"28":{},"29":{},"30":{},"32":{},"33":{},"34":{}},"description":{"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"34":{}}}],["array",{"_index":475,"title":{},"description":{"89":{}}}],["artifact",{"_index":913,"title":{},"description":{"254":{}}}],["assign",{"_index":142,"title":{"158":{}},"description":{"0":{},"141":{},"158":{},"200":{},"206":{}}}],["associ",{"_index":145,"title":{"135":{},"136":{},"137":{}},"description":{"0":{},"43":{},"44":{},"121":{},"123":{},"136":{},"137":{},"151":{},"155":{},"156":{},"204":{},"219":{},"224":{},"226":{},"239":{},"243":{},"245":{}}}],["asynchron",{"_index":333,"title":{},"description":{"36":{},"196":{}}}],["atom",{"_index":596,"title":{},"description":{"141":{}}}],["attach",{"_index":593,"title":{"156":{}},"description":{"138":{},"154":{},"156":{},"166":{},"168":{}}}],["attribut",{"_index":217,"title":{},"description":{"10":{},"16":{},"41":{},"113":{},"152":{},"189":{},"214":{},"252":{},"257":{},"267":{}}}],["audit",{"_index":905,"title":{"249":{},"250":{},"251":{}},"description":{"249":{},"250":{},"251":{}}}],["auth",{"_index":25,"title":{},"description":{"0":{},"261":{}}}],["authent",{"_index":8,"title":{},"description":{"0":{},"264":{},"265":{},"266":{}}}],["author",{"_index":166,"title":{},"description":{"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"26":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"36":{},"37":{},"39":{},"40":{},"42":{},"43":{},"44":{},"46":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"56":{},"57":{},"58":{},"59":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"102":{},"103":{},"104":{},"105":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"121":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"152":{},"153":{},"154":{},"156":{},"157":{},"158":{},"159":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"215":{},"216":{},"217":{},"218":{},"219":{},"221":{},"222":{},"223":{},"224":{},"226":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"250":{},"251":{},"254":{},"255":{},"256":{},"257":{},"258":{},"259":{},"260":{},"261":{},"262":{},"263":{}}}],["automat",{"_index":312,"title":{},"description":{"27":{},"28":{},"31":{},"32":{},"101":{},"103":{},"141":{}}}],["avail",{"_index":98,"title":{},"description":{"0":{},"43":{},"126":{},"128":{},"141":{}}}],["awar",{"_index":30,"title":{},"description":{"0":{}}}],["back",{"_index":1005,"title":{},"description":{"261":{}}}],["backward",{"_index":38,"title":{},"description":{"0":{},"7":{},"197":{},"198":{},"267":{}}}],["bad",{"_index":972,"title":{},"description":{"257":{},"264":{}}}],["basic",{"_index":1010,"title":{},"description":{"261":{}}}],["batch",{"_index":438,"title":{"78":{},"79":{},"141":{}},"description":{"78":{},"79":{},"141":{}}}],["be",{"_index":31,"title":{},"description":{"0":{},"234":{},"240":{}}}],["bearer",{"_index":13,"title":{},"description":{"0":{},"257":{},"265":{}}}],["becom",{"_index":609,"title":{},"description":{"141":{},"260":{}}}],["befor",{"_index":479,"title":{},"description":{"92":{},"168":{}}}],["begin",{"_index":994,"title":{},"description":{"260":{}}}],["behalf",{"_index":903,"title":{},"description":{"247":{}}}],["behavior",{"_index":153,"title":{},"description":{"1":{},"266":{}}}],["belong",{"_index":209,"title":{},"description":{"9":{},"44":{},"57":{},"58":{},"59":{},"60":{},"66":{},"78":{},"79":{},"101":{},"142":{},"143":{},"144":{},"152":{},"153":{},"154":{},"157":{},"158":{},"159":{},"163":{},"166":{},"168":{},"170":{},"171":{},"172":{},"217":{},"218":{},"219":{},"226":{},"254":{}}}],["best-effort",{"_index":770,"title":{},"description":{"198":{},"213":{}}}],["between",{"_index":411,"title":{},"description":{"57":{},"60":{},"66":{},"113":{},"214":{}}}],["bill",{"_index":492,"title":{},"description":{"100":{}}}],["block",{"_index":80,"title":{"220":{},"221":{},"222":{},"223":{},"224":{},"225":{},"226":{}},"description":{"0":{},"37":{},"43":{},"47":{},"60":{},"66":{},"68":{},"149":{},"174":{},"220":{},"221":{},"222":{},"223":{},"224":{},"225":{},"226":{}}}],["bmc",{"_index":290,"title":{"23":{},"24":{},"165":{},"166":{}},"description":{"23":{},"38":{},"40":{},"72":{},"79":{},"80":{},"94":{},"165":{},"166":{}}}],["bmcipaddress",{"_index":445,"title":{},"description":{"79":{}}}],["bodi",{"_index":239,"title":{},"description":{"12":{},"89":{},"122":{},"185":{},"195":{},"200":{},"255":{},"256":{},"257":{},"264":{}}}],["bom",{"_index":494,"title":{},"description":{"100":{}}}],["boot",{"_index":310,"title":{"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"34":{}},"description":{"27":{},"31":{},"120":{}}}],["both",{"_index":55,"title":{},"description":{"0":{},"1":{},"14":{},"42":{},"57":{},"59":{},"121":{},"130":{},"137":{}}}],["boundari",{"_index":402,"title":{},"description":{"48":{}}}],["break",{"_index":41,"title":{},"description":{"0":{},"267":{}}}],["breakdown",{"_index":653,"title":{},"description":{"159":{}}}],["brief",{"_index":93,"title":{},"description":{"0":{}}}],["bring",{"_index":708,"title":{"183":{},"184":{}},"description":{"183":{},"184":{}}}],["bring-up",{"_index":759,"title":{},"description":{"196":{}}}],["broken",{"_index":649,"title":{},"description":{"158":{}}}],["build",{"_index":618,"title":{},"description":{"149":{},"174":{}}}],["built",{"_index":637,"title":{},"description":{"156":{}}}],["bump",{"_index":330,"title":{},"description":{"36":{}}}],["cach",{"_index":998,"title":{},"description":{"260":{}}}],["call",{"_index":33,"title":{},"description":{"0":{},"40":{},"168":{},"257":{},"258":{},"261":{}}}],["callback",{"_index":936,"title":{},"description":{"257":{},"261":{},"262":{},"263":{}}}],["caller",{"_index":547,"title":{},"description":{"121":{},"126":{},"128":{},"150":{}}}],["caller'",{"_index":236,"title":{},"description":{"12":{},"121":{},"122":{},"156":{}}}],["caller-sid",{"_index":729,"title":{},"description":{"185":{},"195":{}}}],["cancel",{"_index":761,"title":{"198":{},"213":{}},"description":{"196":{},"198":{},"205":{},"213":{}}}],["candid",{"_index":821,"title":{},"description":{"205":{},"206":{},"257":{}}}],["capabilities.targetedinstancecr",{"_index":174,"title":{},"description":{"6":{},"7":{},"267":{}}}],["capabl",{"_index":195,"title":{"160":{},"173":{}},"description":{"7":{},"16":{},"73":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"103":{},"129":{},"136":{},"152":{},"160":{},"166":{},"168":{},"170":{},"171":{},"172":{},"173":{},"267":{}}}],["cascad",{"_index":864,"title":{},"description":{"213":{}}}],["case",{"_index":59,"title":{},"description":{"0":{}}}],["certain",{"_index":626,"title":{},"description":{"153":{}}}],["chang",{"_index":42,"title":{},"description":{"0":{},"92":{},"196":{},"198":{},"200":{},"203":{},"206":{},"257":{},"267":{}}}],["characterist",{"_index":496,"title":{},"description":{"100":{},"101":{},"103":{}}}],["chassi",{"_index":454,"title":{},"description":{"86":{},"87":{}}}],["chassis.manufactur",{"_index":461,"title":{},"description":{"86":{},"87":{}}}],["chassis.model",{"_index":463,"title":{},"description":{"86":{},"87":{}}}],["chassis.serial-numb",{"_index":462,"title":{},"description":{"86":{},"87":{}}}],["child",{"_index":880,"title":{},"description":{"226":{}}}],["choos",{"_index":100,"title":{},"description":{"0":{}}}],["claim",{"_index":851,"title":{},"description":{"210":{},"213":{}}}],["classif",{"_index":677,"title":{},"description":{"168":{}}}],["clear",{"_index":362,"title":{},"description":{"40":{},"89":{},"257":{},"261":{}}}],["client",{"_index":767,"title":{},"description":{"197":{},"198":{},"212":{},"265":{}}}],["clientid",{"_index":1008,"title":{},"description":{"261":{}}}],["clientsecret",{"_index":1009,"title":{},"description":{"261":{},"262":{}}}],["clientsecretbas",{"_index":1004,"title":{},"description":{"261":{}}}],["combin",{"_index":740,"title":{},"description":{"187":{},"191":{},"193":{}}}],["commun",{"_index":408,"title":{},"description":{"55":{},"113":{}}}],["compar",{"_index":687,"title":{},"description":{"177":{},"178":{},"189":{},"190":{}}}],["compat",{"_index":39,"title":{},"description":{"0":{},"7":{},"197":{},"198":{},"267":{}}}],["complet",{"_index":338,"title":{},"description":{"37":{},"40":{},"210":{},"218":{}}}],["compon",{"_index":507,"title":{},"description":{"105":{},"177":{},"178":{},"186":{},"187":{},"189":{},"190":{},"196":{},"199":{},"254":{}}}],["component-level",{"_index":743,"title":{},"description":{"187":{},"191":{},"193":{}}}],["componentid",{"_index":744,"title":{},"description":{"187":{},"191":{},"193":{}}}],["compos",{"_index":714,"title":{},"description":{"185":{},"187":{},"195":{},"201":{},"207":{},"209":{}}}],["comput",{"_index":147,"title":{},"description":{"0":{},"6":{},"41":{},"43":{},"106":{}}}],["concurr",{"_index":787,"title":{},"description":{"199":{}}}],["config",{"_index":912,"title":{"254":{},"255":{},"256":{}},"description":{"254":{},"255":{},"256":{}}}],["configur",{"_index":19,"title":{"258":{},"259":{},"260":{},"265":{}},"description":{"0":{},"1":{},"2":{},"6":{},"7":{},"10":{},"14":{},"20":{},"100":{},"101":{},"103":{},"141":{},"156":{},"177":{},"178":{},"189":{},"190":{},"206":{},"254":{},"256":{},"257":{},"258":{},"259":{},"260":{},"261":{},"264":{}}}],["connect",{"_index":211,"title":{},"description":{"10":{},"60":{},"66":{}}}],["consol",{"_index":894,"title":{},"description":{"235":{},"241":{}}}],["constraint",{"_index":376,"title":{"47":{}},"description":{"41":{},"43":{},"47":{},"187":{},"191":{},"193":{}}}],["constraintvalu",{"_index":392,"title":{},"description":{"47":{}}}],["consult",{"_index":22,"title":{},"description":{"0":{}}}],["consum",{"_index":172,"title":{},"description":{"6":{},"257":{},"260":{},"264":{}}}],["contain",{"_index":259,"title":{},"description":{"14":{},"16":{},"149":{},"168":{},"169":{},"174":{}}}],["content",{"_index":926,"title":{},"description":{"254":{}}}],["contigu",{"_index":877,"title":{},"description":{"220":{}}}],["continu",{"_index":587,"title":{},"description":{"137":{},"210":{},"257":{}}}],["control",{"_index":629,"title":{"154":{},"179":{},"180":{},"191":{},"192":{}},"description":{"154":{},"179":{},"180":{},"191":{},"192":{},"214":{}}}],["converg",{"_index":325,"title":{},"description":{"35":{},"36":{},"37":{}}}],["convey",{"_index":457,"title":{},"description":{"86":{},"87":{}}}],["core",{"_index":105,"title":{},"description":{"0":{},"39":{},"40":{},"126":{},"128":{},"156":{},"163":{},"254":{},"257":{},"258":{},"259":{},"261":{},"263":{},"264":{}}}],["count",{"_index":340,"title":{},"description":{"37":{},"158":{},"185":{},"195":{},"201":{},"207":{},"208":{},"209":{}}}],["cpu",{"_index":527,"title":{},"description":{"106":{},"149":{}}}],["creat",{"_index":73,"title":{"12":{},"18":{},"24":{},"26":{},"28":{},"32":{},"43":{},"50":{},"57":{},"62":{},"68":{},"73":{},"78":{},"81":{},"87":{},"95":{},"102":{},"108":{},"115":{},"122":{},"131":{},"136":{},"140":{},"141":{},"163":{},"171":{},"200":{},"206":{},"216":{},"222":{},"229":{},"237":{},"243":{},"255":{},"258":{},"261":{}},"description":{"0":{},"1":{},"12":{},"15":{},"16":{},"18":{},"23":{},"24":{},"25":{},"26":{},"43":{},"45":{},"47":{},"50":{},"57":{},"62":{},"68":{},"73":{},"78":{},"81":{},"87":{},"89":{},"95":{},"100":{},"102":{},"108":{},"115":{},"120":{},"122":{},"131":{},"140":{},"141":{},"163":{},"168":{},"196":{},"197":{},"198":{},"200":{},"203":{},"206":{},"216":{},"218":{},"222":{},"225":{},"226":{},"229":{},"232":{},"237":{},"243":{},"254":{},"255":{},"258":{},"261":{}}}],["creation",{"_index":814,"title":{},"description":{"203":{},"205":{}}}],["credenti",{"_index":291,"title":{"23":{},"24":{},"25":{},"26":{},"35":{},"36":{},"37":{}},"description":{"23":{},"24":{},"25":{},"26":{},"35":{},"36":{},"37":{},"72":{},"80":{},"94":{},"232":{},"257":{},"261":{}}}],["criteria",{"_index":627,"title":{},"description":{"153":{}}}],["crud",{"_index":794,"title":{},"description":{"199":{}}}],["cumul",{"_index":846,"title":{},"description":{"208":{}}}],["current",{"_index":46,"title":{"2":{},"4":{},"5":{},"7":{},"8":{},"248":{},"259":{},"262":{},"264":{},"265":{},"266":{}},"description":{"0":{},"2":{},"4":{},"5":{},"7":{},"8":{},"79":{},"105":{},"205":{},"206":{},"208":{},"213":{},"227":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"248":{},"264":{}}}],["custom",{"_index":886,"title":{},"description":{"227":{}}}],["cycl",{"_index":700,"title":{},"description":{"179":{},"180":{},"191":{},"192":{}}}],["data",{"_index":128,"title":{},"description":{"0":{},"232":{}}}],["databas",{"_index":480,"title":{},"description":{"92":{}}}],["datacent",{"_index":266,"title":{},"description":{"16":{}}}],["decommiss",{"_index":396,"title":{},"description":{"47":{}}}],["decrement",{"_index":394,"title":{},"description":{"47":{}}}],["default",{"_index":222,"title":{},"description":{"10":{},"14":{},"39":{},"141":{},"185":{},"195":{},"204":{},"254":{},"259":{}}}],["defaultaudi",{"_index":988,"title":{},"description":{"259":{}}}],["defin",{"_index":86,"title":{},"description":{"0":{},"48":{},"100":{},"129":{},"173":{},"199":{},"220":{},"254":{}}}],["definit",{"_index":560,"title":{},"description":{"126":{},"200":{},"203":{}}}],["deleg",{"_index":374,"title":{"261":{},"262":{},"263":{}},"description":{"41":{},"220":{},"257":{}}}],["delet",{"_index":265,"title":{"15":{},"21":{},"30":{},"34":{},"45":{},"52":{},"59":{},"64":{},"70":{},"77":{},"85":{},"90":{},"93":{},"99":{},"104":{},"110":{},"118":{},"124":{},"133":{},"137":{},"143":{},"153":{},"172":{},"204":{},"219":{},"224":{},"231":{},"234":{},"239":{},"245":{},"256":{},"260":{},"263":{}},"description":{"15":{},"21":{},"30":{},"34":{},"45":{},"52":{},"59":{},"64":{},"70":{},"77":{},"85":{},"89":{},"90":{},"93":{},"99":{},"100":{},"104":{},"110":{},"118":{},"124":{},"133":{},"137":{},"143":{},"153":{},"199":{},"203":{},"204":{},"219":{},"224":{},"231":{},"234":{},"239":{},"245":{},"254":{},"256":{},"257":{},"258":{},"260":{},"263":{}}}],["deletehostfirmwareconfig",{"_index":924,"title":{},"description":{"254":{}}}],["depend",{"_index":18,"title":{},"description":{"0":{}}}],["deploy",{"_index":103,"title":{},"description":{"0":{},"2":{},"231":{},"234":{}}}],["deprec",{"_index":44,"title":{"267":{}},"description":{"0":{},"6":{},"7":{},"10":{},"12":{},"16":{},"41":{},"113":{},"120":{},"122":{},"214":{},"267":{}}}],["deprecations](#tag/deprec",{"_index":49,"title":{},"description":{"0":{}}}],["deriv",{"_index":498,"title":{"226":{}},"description":{"101":{},"103":{},"120":{},"122":{},"208":{}}}],["describ",{"_index":341,"title":{},"description":{"37":{},"220":{},"252":{}}}],["descript",{"_index":806,"title":{},"description":{"203":{},"258":{},"264":{}}}],["design",{"_index":516,"title":{},"description":{"106":{}}}],["desir",{"_index":876,"title":{},"description":{"218":{}}}],["destroy",{"_index":950,"title":{},"description":{"257":{},"260":{}}}],["detail",{"_index":20,"title":{"159":{}},"description":{"0":{},"37":{},"58":{},"132":{},"151":{},"155":{},"159":{},"177":{},"178":{},"189":{},"190":{},"205":{},"209":{},"214":{},"233":{},"248":{}}}],["determin",{"_index":156,"title":{},"description":{"1":{},"104":{},"105":{}}}],["devic",{"_index":332,"title":{},"description":{"36":{},"37":{}}}],["devicemac",{"_index":339,"title":{},"description":{"37":{}}}],["diff",{"_index":692,"title":{},"description":{"177":{},"178":{},"189":{},"190":{}}}],["differ",{"_index":415,"title":{},"description":{"57":{},"141":{}}}],["direct",{"_index":524,"title":{},"description":{"106":{},"113":{},"263":{}}}],["directli",{"_index":269,"title":{},"description":{"16":{},"261":{},"265":{}}}],["disabl",{"_index":161,"title":{},"description":{"2":{}}}],["disallow",{"_index":200,"title":{},"description":{"7":{}}}],["discov",{"_index":344,"title":{},"description":{"38":{},"39":{},"72":{},"73":{},"80":{},"81":{},"86":{},"87":{},"94":{},"95":{},"101":{},"103":{}}}],["discoveri",{"_index":430,"title":{},"description":{"72":{},"80":{},"86":{},"94":{},"257":{},"260":{},"265":{}}}],["dissoci",{"_index":816,"title":{},"description":{"204":{}}}],["distinct",{"_index":655,"title":{},"description":{"160":{},"258":{}}}],["distribut",{"_index":531,"title":{},"description":{"106":{}}}],["divid",{"_index":823,"title":{},"description":{"205":{},"206":{}}}],["do",{"_index":395,"title":{},"description":{"47":{}}}],["document",{"_index":940,"title":{},"description":{"257":{},"265":{}}}],["domain",{"_index":602,"title":{},"description":{"141":{},"259":{}}}],["domain-awar",{"_index":595,"title":{},"description":{"141":{}}}],["down",{"_index":650,"title":{},"description":{"158":{}}}],["dpu",{"_index":303,"title":{"156":{},"167":{},"168":{},"227":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{}},"description":{"25":{},"26":{},"156":{},"167":{},"168":{},"227":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{}}}],["drill",{"_index":835,"title":{},"description":{"205":{},"209":{}}}],["drive",{"_index":824,"title":{},"description":{"205":{}}}],["dry-run",{"_index":797,"title":{},"description":{"200":{}}}],["dual-rol",{"_index":550,"title":{},"description":{"121":{}}}],["dure",{"_index":956,"title":{},"description":{"257":{},"259":{},"264":{}}}],["e.g",{"_index":398,"title":{},"description":{"47":{},"141":{}}}],["each",{"_index":83,"title":{},"description":{"0":{},"126":{},"159":{},"161":{},"185":{},"195":{},"205":{},"209":{}}}],["earlier",{"_index":371,"title":{},"description":{"40":{}}}],["echo",{"_index":802,"title":{},"description":{"200":{},"206":{}}}],["effect",{"_index":434,"title":{},"description":{"74":{},"150":{}}}],["elig",{"_index":628,"title":{},"description":{"153":{}}}],["embed",{"_index":185,"title":{},"description":{"6":{}}}],["empti",{"_index":219,"title":{},"description":{"10":{},"14":{},"89":{},"257":{},"265":{}}}],["enabl",{"_index":68,"title":{},"description":{"0":{},"2":{},"7":{},"60":{},"66":{},"101":{},"103":{},"152":{},"156":{},"166":{},"168":{},"170":{},"171":{},"172":{},"257":{},"258":{},"260":{}}}],["enclosur",{"_index":684,"title":{},"description":{"174":{}}}],["endpoint",{"_index":77,"title":{"39":{},"40":{}},"description":{"0":{},"23":{},"25":{},"27":{},"31":{},"35":{},"36":{},"38":{},"39":{},"40":{},"141":{},"196":{},"211":{},"246":{},"257":{},"265":{},"266":{},"267":{}}}],["endpoint'",{"_index":961,"title":{},"description":{"257":{}}}],["endpoint](#tag/allocation/operation/create-alloc",{"_index":111,"title":{},"description":{"0":{}}}],["endpoint](#tag/infrastructure-provider/operation/get-current-infrastructure-provid",{"_index":70,"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":89,"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":99,"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":71,"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":{}}}],["enforc",{"_index":680,"title":{},"description":{"169":{}}}],["enough",{"_index":382,"title":{},"description":{"43":{}}}],["entiti",{"_index":62,"title":{},"description":{"0":{},"3":{},"4":{},"6":{},"7":{},"12":{},"14":{},"15":{},"18":{},"21":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"43":{},"45":{},"46":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"103":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"123":{},"124":{},"125":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"215":{},"216":{},"217":{},"218":{},"219":{},"224":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"247":{}}}],["entri",{"_index":218,"title":{"250":{},"251":{}},"description":{"10":{},"14":{},"89":{},"250":{},"251":{},"254":{},"259":{}}}],["equal",{"_index":386,"title":{},"description":{"43":{}}}],["equival",{"_index":296,"title":{},"description":{"24":{},"36":{},"37":{}}}],["error",{"_index":364,"title":{},"description":{"40":{}}}],["es256",{"_index":977,"title":{},"description":{"258":{},"264":{}}}],["etc",{"_index":600,"title":{},"description":{"141":{},"257":{}}}],["exactli",{"_index":256,"title":{},"description":{"14":{},"206":{}}}],["exampl",{"_index":154,"title":{},"description":{"1":{},"196":{},"199":{}}}],["exce",{"_index":829,"title":{},"description":{"205":{}}}],["except",{"_index":444,"title":{},"description":{"79":{}}}],["exchang",{"_index":935,"title":{},"description":{"257":{},"261":{},"262":{},"263":{}}}],["exclus",{"_index":738,"title":{},"description":{"187":{},"191":{},"193":{}}}],["execut",{"_index":630,"title":{},"description":{"154":{},"161":{},"199":{},"205":{},"206":{},"209":{}}}],["exist",{"_index":307,"title":{},"description":{"26":{},"46":{},"47":{},"53":{},"65":{},"71":{},"76":{},"77":{},"84":{},"85":{},"89":{},"92":{},"93":{},"98":{},"99":{},"111":{},"225":{},"258":{},"264":{},"265":{}}}],["expect",{"_index":424,"title":{"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"86":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"96":{},"97":{},"98":{},"99":{}},"description":{"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"86":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"96":{},"97":{},"98":{},"99":{},"177":{},"178":{},"189":{},"190":{}}}],["expectedphaseindex",{"_index":860,"title":{},"description":{"212":{}}}],["expectedrack",{"_index":473,"title":{},"description":{"89":{}}}],["expir",{"_index":960,"title":{},"description":{"257":{}}}],["explicit",{"_index":367,"title":{},"description":{"40":{}}}],["explor",{"_index":343,"title":{"38":{},"39":{},"40":{}},"description":{"38":{},"39":{},"40":{}}}],["expos",{"_index":634,"title":{},"description":{"156":{},"199":{},"205":{}}}],["extens",{"_index":885,"title":{"227":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{}},"description":{"227":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{}}}],["extern",{"_index":946,"title":{},"description":{"257":{}}}],["extra",{"_index":695,"title":{},"description":{"177":{},"178":{},"189":{},"190":{}}}],["fail",{"_index":304,"title":{},"description":{"26":{},"40":{},"141":{},"198":{}}}],["failur",{"_index":796,"title":{},"description":{"200":{},"203":{},"205":{},"206":{}}}],["fals",{"_index":190,"title":{},"description":{"6":{},"141":{},"257":{},"260":{}}}],["favor",{"_index":175,"title":{},"description":{"6":{},"16":{},"41":{},"113":{},"214":{},"267":{}}}],["fetch",{"_index":947,"title":{},"description":{"257":{}}}],["field",{"_index":240,"title":{},"description":{"12":{},"79":{},"105":{},"120":{},"122":{},"156":{},"185":{},"195":{},"203":{},"257":{},"259":{}}}],["file",{"_index":88,"title":{},"description":{"0":{}}}],["fill",{"_index":986,"title":{},"description":{"259":{}}}],["filter",{"_index":568,"title":{},"description":{"126":{},"177":{},"179":{},"181":{},"183":{},"185":{},"187":{},"189":{},"191":{},"193":{},"195":{},"201":{},"207":{},"209":{},"267":{}}}],["findexploredendpointid",{"_index":353,"title":{},"description":{"39":{}}}],["findexploredendpointsbyid",{"_index":355,"title":{},"description":{"39":{}}}],["finish",{"_index":777,"title":{},"description":{"198":{}}}],["firmwar",{"_index":705,"title":{"181":{},"182":{},"193":{},"194":{},"254":{},"255":{},"256":{}},"description":{"181":{},"182":{},"193":{},"194":{},"196":{},"205":{},"206":{},"254":{},"255":{},"256":{}}}],["firmwarecontrol",{"_index":784,"title":{},"description":{"199":{}}}],["first",{"_index":9,"title":{},"description":{"0":{},"204":{},"254":{},"258":{},"261":{}}}],["flow",{"_index":96,"title":{},"description":{"0":{},"16":{},"199":{},"200":{},"204":{},"206":{},"212":{},"214":{},"267":{}}}],["fnn",{"_index":118,"title":{},"description":{"0":{},"60":{},"66":{}}}],["follow",{"_index":354,"title":{},"description":{"39":{},"156":{}}}],["forcecycl",{"_index":702,"title":{},"description":{"179":{},"180":{},"191":{},"192":{}}}],["forceoff",{"_index":701,"title":{},"description":{"179":{},"180":{},"191":{},"192":{}}}],["found",{"_index":967,"title":{},"description":{"257":{},"264":{}}}],["full",{"_index":108,"title":{},"description":{"0":{},"89":{},"185":{},"195":{}}}],["full-replac",{"_index":948,"title":{},"description":{"257":{},"261":{}}}],["further",{"_index":435,"title":{},"description":{"74":{},"150":{}}}],["gate",{"_index":827,"title":{},"description":{"205":{},"211":{},"212":{}}}],["gateway",{"_index":973,"title":{},"description":{"257":{},"264":{}}}],["gener",{"_index":36,"title":{},"description":{"0":{},"141":{},"258":{}}}],["get",{"_index":0,"title":{"0":{}},"description":{}}],["getdpumachin",{"_index":641,"title":{},"description":{"156":{}}}],["given",{"_index":577,"title":{},"description":{"135":{},"254":{}}}],["global",{"_index":564,"title":{},"description":{"126":{}}}],["gpu",{"_index":536,"title":{"157":{}},"description":{"113":{},"149":{},"157":{}}}],["grant",{"_index":282,"title":{},"description":{"19":{},"22":{},"156":{}}}],["group",{"_index":208,"title":{"214":{},"215":{},"216":{},"217":{},"218":{},"219":{},"235":{},"236":{},"237":{},"238":{},"239":{},"240":{}},"description":{"9":{},"100":{},"106":{},"113":{},"129":{},"157":{},"158":{},"173":{},"214":{},"215":{},"216":{},"217":{},"218":{},"219":{},"235":{},"236":{},"237":{},"238":{},"239":{},"240":{},"243":{},"245":{},"246":{}}}],["grpc",{"_index":974,"title":{},"description":{"257":{},"258":{},"261":{},"263":{},"264":{}}}],["guard",{"_index":858,"title":{},"description":{"212":{}}}],["guidanc",{"_index":1026,"title":{},"description":{"264":{}}}],["handler",{"_index":763,"title":{},"description":{"197":{},"198":{}}}],["hardwar",{"_index":268,"title":{},"description":{"16":{},"100":{},"101":{},"103":{},"149":{},"173":{},"254":{}}}],["hash",{"_index":1015,"title":{},"description":{"262":{}}}],["header",{"_index":358,"title":{},"description":{"39":{},"185":{},"195":{},"201":{},"207":{},"209":{}}}],["health",{"_index":674,"title":{"169":{},"170":{},"171":{},"172":{}},"description":{"168":{},"169":{},"170":{},"171":{},"172":{}}}],["help",{"_index":429,"title":{},"description":{"72":{},"80":{},"86":{},"94":{}}}],["here",{"_index":203,"title":{},"description":{"7":{}}}],["high-perform",{"_index":513,"title":{},"description":{"106":{}}}],["histori",{"_index":173,"title":{"22":{},"145":{},"155":{}},"description":{"6":{},"10":{},"22":{},"41":{},"113":{},"120":{},"145":{},"214":{}}}],["hold",{"_index":831,"title":{},"description":{"205":{}}}],["holder",{"_index":82,"title":{},"description":{"0":{}}}],["host",{"_index":302,"title":{"156":{},"254":{},"255":{},"256":{}},"description":{"25":{},"26":{},"156":{},"254":{},"255":{},"256":{}}}],["hostupdateinprogress",{"_index":676,"title":{},"description":{"168":{}}}],["hpc",{"_index":520,"title":{},"description":{"106":{}}}],["ib",{"_index":512,"title":{},"description":{"106":{}}}],["id",{"_index":155,"title":{},"description":{"1":{},"13":{},"14":{},"15":{},"19":{},"30":{},"34":{},"39":{},"44":{},"45":{},"47":{},"51":{},"52":{},"58":{},"59":{},"64":{},"70":{},"75":{},"76":{},"77":{},"83":{},"84":{},"85":{},"91":{},"92":{},"93":{},"97":{},"98":{},"99":{},"103":{},"110":{},"116":{},"118":{},"123":{},"124":{},"125":{},"128":{},"132":{},"133":{},"134":{},"137":{},"142":{},"143":{},"144":{},"156":{},"168":{},"176":{},"188":{},"196":{},"200":{},"206":{},"217":{},"218":{},"219":{},"223":{},"230":{},"231":{},"238":{},"244":{},"245":{},"246":{},"251":{}}}],["id_asc",{"_index":347,"title":{},"description":{"39":{}}}],["id_desc",{"_index":348,"title":{},"description":{"39":{}}}],["id_token_signing_alg_values_support",{"_index":962,"title":{},"description":{"257":{},"265":{}}}],["id_token`",{"_index":965,"title":{},"description":{"257":{},"265":{}}}],["id`/`componentid",{"_index":741,"title":{},"description":{"187":{}}}],["idempot",{"_index":771,"title":{},"description":{"198":{},"210":{}}}],["ident",{"_index":455,"title":{"257":{},"258":{},"259":{},"260":{}},"description":{"86":{},"87":{},"257":{},"258":{},"259":{},"260":{},"264":{},"265":{}}}],["identifi",{"_index":425,"title":{},"description":{"72":{},"80":{},"86":{},"87":{},"92":{},"93":{},"94":{},"180":{},"182":{},"184":{},"192":{},"194":{},"247":{}}}],["ids`/`componentid",{"_index":753,"title":{},"description":{"191":{},"193":{}}}],["ignor",{"_index":543,"title":{},"description":{"120":{},"166":{}}}],["imag",{"_index":556,"title":{},"description":{"122":{}}}],["immut",{"_index":478,"title":{},"description":{"92":{},"203":{}}}],["in-flight",{"_index":337,"title":{},"description":{"37":{},"210":{},"213":{},"257":{}}}],["includ",{"_index":255,"title":{},"description":{"14":{},"156":{},"159":{},"168":{},"169":{},"185":{},"195":{},"257":{}}}],["includereport=tru",{"_index":722,"title":{},"description":{"185":{},"195":{}}}],["includestats=tru",{"_index":843,"title":{},"description":{"208":{}}}],["increment",{"_index":393,"title":{},"description":{"47":{}}}],["indirectli",{"_index":270,"title":{},"description":{"16":{}}}],["individu",{"_index":882,"title":{},"description":{"226":{},"247":{}}}],["infer",{"_index":231,"title":{},"description":{"11":{},"12":{},"13":{},"42":{},"44":{},"127":{},"128":{},"130":{}}}],["infiniband",{"_index":510,"title":{"106":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"147":{}},"description":{"106":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"147":{}}}],["inform",{"_index":213,"title":{},"description":{"10":{},"12":{},"86":{},"87":{},"169":{},"253":{}}}],["infrastructur",{"_index":69,"title":{"3":{},"4":{},"5":{}},"description":{"0":{},"3":{},"4":{},"5":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"18":{},"19":{},"20":{},"21":{},"22":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"86":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"102":{},"103":{},"104":{},"105":{},"121":{},"123":{},"124":{},"125":{},"127":{},"128":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"150":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"222":{},"224":{},"225":{},"226":{},"254":{},"267":{}}}],["infrastructureproviderid",{"_index":237,"title":{},"description":{"12":{},"17":{},"123":{},"124":{},"125":{},"221":{},"267":{}}}],["ingest",{"_index":431,"title":{},"description":{"72":{},"80":{},"86":{},"94":{},"161":{}}}],["initi",{"_index":63,"title":{},"description":{"0":{}}}],["instal",{"_index":102,"title":{},"description":{"0":{}}}],["instanc",{"_index":131,"title":{"9":{},"129":{},"130":{},"131":{},"132":{},"133":{},"134":{},"138":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"147":{},"148":{},"158":{}},"description":{"0":{},"1":{},"9":{},"43":{},"48":{},"54":{},"55":{},"60":{},"66":{},"129":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"138":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"151":{},"152":{},"154":{},"155":{},"158":{},"159":{},"166":{},"168":{},"173":{},"214":{},"217":{},"218":{},"219":{},"227":{},"235":{},"241":{},"263":{},"267":{}}}],["instancetyp",{"_index":391,"title":{},"description":{"47":{}}}],["instead",{"_index":274,"title":{},"description":{"16":{},"41":{},"113":{},"211":{},"214":{},"260":{},"261":{},"267":{}}}],["insuffici",{"_index":603,"title":{},"description":{"141":{}}}],["integr",{"_index":662,"title":{},"description":{"161":{}}}],["intention",{"_index":963,"title":{},"description":{"257":{},"265":{}}}],["interconnect",{"_index":517,"title":{},"description":{"106":{}}}],["interfac",{"_index":534,"title":{"112":{},"119":{},"146":{},"147":{},"148":{}},"description":{"112":{},"113":{},"119":{},"141":{},"146":{},"147":{},"148":{},"156":{}}}],["intermedi",{"_index":1001,"title":{},"description":{"261":{}}}],["internal-onli",{"_index":635,"title":{},"description":{"156":{}}}],["invit",{"_index":246,"title":{},"description":{"12":{},"14":{}}}],["ip",{"_index":79,"title":{"220":{},"221":{},"222":{},"223":{},"224":{},"225":{},"226":{}},"description":{"0":{},"40":{},"43":{},"60":{},"66":{},"68":{},"79":{},"220":{},"221":{},"222":{},"223":{},"224":{},"225":{},"226":{}}}],["ipblock",{"_index":397,"title":{},"description":{"47":{}}}],["ipv4",{"_index":421,"title":{},"description":{"68":{}}}],["ipv6",{"_index":422,"title":{},"description":{"68":{}}}],["ipx",{"_index":126,"title":{"126":{},"127":{},"128":{}},"description":{"0":{},"120":{},"122":{},"126":{},"127":{},"128":{}}}],["ipxetemplateid",{"_index":569,"title":{},"description":{"126":{}}}],["ipxetemplatesiteassoci",{"_index":565,"title":{},"description":{"126":{}}}],["iscloudinit",{"_index":542,"title":{},"description":{"120":{}}}],["isflowen",{"_index":278,"title":{},"description":{"16":{},"267":{}}}],["isol",{"_index":401,"title":{},"description":{"48":{},"106":{}}}],["israckleveladministrationen",{"_index":275,"title":{},"description":{"16":{},"267":{}}}],["issu",{"_index":964,"title":{},"description":{"257":{},"261":{},"264":{},"265":{}}}],["issuanc",{"_index":931,"title":{},"description":{"257":{},"260":{}}}],["issuer'",{"_index":990,"title":{},"description":{"259":{}}}],["item",{"_index":443,"title":{},"description":{"79":{}}}],["itself",{"_index":567,"title":{},"description":{"126":{}}}],["json",{"_index":1019,"title":{},"description":{"264":{}}}],["juli",{"_index":377,"title":{},"description":{"41":{},"113":{},"137":{},"214":{}}}],["jwk",{"_index":938,"title":{"264":{},"266":{}},"description":{"257":{},"260":{},"265":{},"266":{}}}],["jwt",{"_index":12,"title":{},"description":{"0":{},"257":{},"265":{}}}],["jwt-svid",{"_index":930,"title":{},"description":{"257":{},"258":{},"260":{},"261":{},"264":{},"266":{}}}],["k8",{"_index":887,"title":{},"description":{"227":{}}}],["kb",{"_index":725,"title":{},"description":{"185":{},"195":{}}}],["keep",{"_index":489,"title":{},"description":{"100":{},"101":{},"103":{},"261":{}}}],["key",{"_index":460,"title":{"235":{},"236":{},"237":{},"238":{},"239":{},"240":{},"241":{},"242":{},"243":{},"244":{},"245":{},"246":{}},"description":{"86":{},"87":{},"141":{},"235":{},"236":{},"237":{},"238":{},"239":{},"240":{},"241":{},"242":{},"243":{},"244":{},"245":{},"246":{},"254":{},"256":{},"257":{},"259":{},"260":{},"264":{},"266":{}}}],["key-rot",{"_index":957,"title":{},"description":{"257":{},"259":{}}}],["keypair",{"_index":951,"title":{},"description":{"257":{},"258":{},"260":{}}}],["kid",{"_index":955,"title":{},"description":{"257":{}}}],["know",{"_index":133,"title":{},"description":{"0":{}}}],["known",{"_index":867,"title":{},"description":{"213":{},"254":{}}}],["label",{"_index":459,"title":{},"description":{"86":{},"87":{},"152":{}}}],["last",{"_index":363,"title":{},"description":{"40":{},"213":{}}}],["leav",{"_index":812,"title":{},"description":{"203":{}}}],["left",{"_index":809,"title":{},"description":{"203":{}}}],["length",{"_index":110,"title":{},"description":{"0":{},"43":{},"220":{}}}],["level",{"_index":201,"title":{},"description":{"7":{}}}],["librari",{"_index":1031,"title":{},"description":{"265":{}}}],["lifecycl",{"_index":834,"title":{},"description":{"205":{}}}],["list",{"_index":48,"title":{"201":{}},"description":{"0":{},"40":{},"89":{},"121":{},"126":{},"185":{},"195":{},"196":{},"201":{},"205":{},"207":{},"209":{},"259":{},"265":{},"267":{}}}],["load",{"_index":530,"title":{},"description":{"106":{}}}],["locat",{"_index":456,"title":{},"description":{"86":{},"87":{},"254":{}}}],["location.datacent",{"_index":465,"title":{},"description":{"86":{},"87":{}}}],["location.posit",{"_index":467,"title":{},"description":{"86":{},"87":{}}}],["location.region",{"_index":464,"title":{},"description":{"86":{},"87":{}}}],["location.room",{"_index":466,"title":{},"description":{"86":{},"87":{}}}],["lockdown",{"_index":670,"title":{},"description":{"166":{}}}],["log",{"_index":907,"title":{"250":{},"251":{}},"description":{"250":{},"251":{}}}],["logic",{"_index":529,"title":{"113":{},"114":{},"115":{},"116":{},"117":{},"118":{}},"description":{"106":{},"113":{},"114":{},"115":{},"116":{},"117":{},"118":{},"247":{}}}],["longer",{"_index":590,"title":{},"description":{"137":{},"267":{}}}],["low-lat",{"_index":514,"title":{},"description":{"106":{},"113":{}}}],["machin",{"_index":129,"title":{"27":{},"28":{},"29":{},"30":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"149":{},"150":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"173":{}},"description":{"0":{},"1":{},"23":{},"27":{},"28":{},"29":{},"30":{},"32":{},"43":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"100":{},"101":{},"103":{},"106":{},"120":{},"129":{},"135":{},"136":{},"137":{},"138":{},"141":{},"149":{},"150":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"162":{},"163":{},"164":{},"166":{},"168":{},"169":{},"170":{},"171":{},"172":{},"173":{},"174":{}}}],["machine'",{"_index":140,"title":{},"description":{"0":{},"79":{},"101":{},"136":{},"137":{},"152":{},"156":{},"165":{},"166":{},"167":{},"168":{},"170":{},"171":{},"172":{}}}],["machine/inst",{"_index":579,"title":{"136":{},"137":{}},"description":{"137":{}}}],["machineassociationid",{"_index":583,"title":{},"description":{"137":{}}}],["machineid",{"_index":586,"title":{},"description":{"137":{}}}],["machines/inst",{"_index":576,"title":{"135":{}},"description":{}}],["main",{"_index":789,"title":{},"description":{"199":{}}}],["maintain",{"_index":37,"title":{},"description":{"0":{},"267":{}}}],["mainten",{"_index":622,"title":{},"description":{"152":{}}}],["make",{"_index":60,"title":{},"description":{"0":{}}}],["malform",{"_index":1025,"title":{},"description":{"264":{}}}],["malformed-bodi",{"_index":1038,"title":{},"description":{"266":{}}}],["manag",{"_index":165,"title":{},"description":{"3":{},"27":{},"31":{},"45":{},"46":{},"60":{},"100":{},"224":{},"225":{},"257":{}}}],["mani",{"_index":820,"title":{},"description":{"205":{},"206":{}}}],["manufactur",{"_index":691,"title":{},"description":{"177":{}}}],["mark",{"_index":772,"title":{},"description":{"198":{}}}],["match",{"_index":242,"title":{},"description":{"12":{},"14":{},"32":{},"89":{},"122":{},"123":{},"124":{},"125":{},"212":{},"257":{},"266":{}}}],["materi",{"_index":493,"title":{},"description":{"100":{},"209":{},"257":{},"265":{},"266":{}}}],["maximum",{"_index":439,"title":{},"description":{"78":{},"79":{}}}],["measur",{"_index":309,"title":{"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"34":{}},"description":{"27":{},"31":{}}}],["measured-boot",{"_index":315,"title":{},"description":{"28":{},"29":{},"30":{},"32":{},"33":{},"34":{}}}],["mechan",{"_index":373,"title":{},"description":{"41":{},"161":{}}}],["meet",{"_index":625,"title":{},"description":{"153":{}}}],["membership",{"_index":233,"title":{},"description":{"11":{},"13":{},"42":{},"44":{},"127":{},"128":{},"130":{}}}],["memori",{"_index":525,"title":{},"description":{"106":{},"113":{},"149":{}}}],["merg",{"_index":918,"title":{},"description":{"254":{}}}],["metadata",{"_index":34,"title":{"252":{},"253":{}},"description":{"0":{},"39":{},"252":{},"253":{},"259":{},"263":{}}}],["mismatch",{"_index":696,"title":{},"description":{"177":{},"178":{},"189":{},"190":{}}}],["miss",{"_index":694,"title":{},"description":{"177":{},"178":{},"189":{},"190":{}}}],["mode",{"_index":52,"title":{},"description":{"0":{},"1":{},"166":{}}}],["model",{"_index":916,"title":{},"description":{"254":{},"256":{}}}],["modifi",{"_index":288,"title":{},"description":{"20":{},"47":{},"232":{}}}],["modul",{"_index":26,"title":{},"description":{"0":{}}}],["more",{"_index":491,"title":{},"description":{"100":{},"127":{},"138":{}}}],["mount",{"_index":764,"title":{},"description":{"197":{},"198":{}}}],["multi-ten",{"_index":414,"title":{},"description":{"57":{},"59":{}}}],["multipl",{"_index":143,"title":{},"description":{"0":{},"78":{},"79":{},"141":{}}}],["mutabl",{"_index":505,"title":{},"description":{"105":{},"203":{}}}],["mutat",{"_index":481,"title":{},"description":{"92":{}}}],["mutual",{"_index":737,"title":{},"description":{"187":{},"191":{},"193":{}}}],["mvp",{"_index":388,"title":{},"description":{"45":{},"46":{}}}],["name",{"_index":135,"title":{},"description":{"0":{},"12":{},"126":{},"141":{},"157":{},"177":{},"181":{},"183":{},"203":{}}}],["name/manufacturer/typ",{"_index":750,"title":{},"description":{"189":{}}}],["nameprefix",{"_index":605,"title":{},"description":{"141":{}}}],["narrow",{"_index":689,"title":{},"description":{"177":{},"205":{},"206":{}}}],["nativ",{"_index":117,"title":{},"description":{"0":{},"60":{},"66":{}}}],["nest",{"_index":187,"title":{},"description":{"6":{}}}],["network",{"_index":84,"title":{"214":{},"215":{},"216":{},"217":{},"218":{},"219":{}},"description":{"0":{},"6":{},"16":{},"41":{},"43":{},"48":{},"54":{},"60":{},"66":{},"95":{},"106":{},"149":{},"156":{},"214":{},"215":{},"216":{},"217":{},"218":{},"219":{},"220":{}}}],["never",{"_index":1012,"title":{},"description":{"261":{},"262":{}}}],["new",{"_index":327,"title":{},"description":{"36":{},"89":{},"197":{},"198":{},"200":{},"203":{},"210":{},"232":{},"254":{},"258":{}}}],["next",{"_index":29,"title":{"212":{}},"description":{"0":{},"28":{},"212":{}}}],["nico",{"_index":23,"title":{},"description":{"0":{},"120":{},"163":{},"257":{},"264":{},"265":{},"267":{}}}],["nico-admin-cli",{"_index":297,"title":{},"description":{"24":{},"36":{},"37":{}}}],["nico-cor",{"_index":562,"title":{},"description":{"126":{},"127":{}}}],["no-auth",{"_index":1006,"title":{},"description":{"261":{}}}],["non-deleg",{"_index":1017,"title":{},"description":{"263":{}}}],["non-empti",{"_index":254,"title":{},"description":{"14":{},"120":{},"265":{}}}],["non-rot",{"_index":953,"title":{},"description":{"257":{}}}],["non-termin",{"_index":717,"title":{},"description":{"185":{},"195":{},"198":{}}}],["normal",{"_index":992,"title":{},"description":{"259":{}}}],["not-configur",{"_index":1037,"title":{},"description":{"266":{}}}],["note",{"_index":90,"title":{},"description":{"0":{}}}],["notic",{"_index":45,"title":{},"description":{"0":{},"267":{}}}],["null",{"_index":446,"title":{},"description":{"79":{},"209":{}}}],["number",{"_index":428,"title":{},"description":{"72":{},"80":{},"94":{},"174":{}}}],["nvlink",{"_index":483,"title":{"113":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"148":{}},"description":{"94":{},"113":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"141":{},"148":{}}}],["nvlinklogicalpartitionid",{"_index":538,"title":{},"description":{"113":{}}}],["nvo",{"_index":484,"title":{},"description":{"94":{}}}],["object",{"_index":264,"title":{},"description":{"14":{},"16":{}}}],["object_id",{"_index":871,"title":{},"description":{"214":{}}}],["objectid",{"_index":872,"title":{},"description":{"214":{}}}],["observ",{"_index":335,"title":{},"description":{"36":{}}}],["octob",{"_index":178,"title":{},"description":{"6":{},"267":{}}}],["offer",{"_index":417,"title":{},"description":{"60":{}}}],["oidc",{"_index":939,"title":{"264":{}},"description":{"257":{},"260":{},"265":{},"266":{}}}],["ok",{"_index":922,"title":{},"description":{"254":{},"258":{},"261":{}}}],["old",{"_index":815,"title":{},"description":{"203":{}}}],["older",{"_index":280,"title":{},"description":{"17":{},"221":{}}}],["omit",{"_index":220,"title":{},"description":{"10":{},"14":{},"79":{},"105":{},"156":{},"185":{},"195":{},"257":{},"259":{},"261":{}}}],["on",{"_index":257,"title":{},"description":{"14":{},"55":{},"56":{},"58":{},"68":{},"100":{},"121":{},"123":{},"127":{},"128":{},"138":{},"203":{},"205":{},"206":{},"259":{}}}],["on-demand",{"_index":664,"title":{"163":{}},"description":{"161":{},"163":{}}}],["onc",{"_index":75,"title":{},"description":{"0":{},"40":{},"260":{}}}],["onlin",{"_index":897,"title":{},"description":{"239":{},"240":{},"243":{},"245":{}}}],["onward",{"_index":92,"title":{},"description":{"0":{}}}],["open",{"_index":857,"title":{},"description":{"212":{}}}],["openbao",{"_index":941,"title":{},"description":{"257":{}}}],["openid",{"_index":1028,"title":{"265":{}},"description":{}}],["oper",{"_index":122,"title":{"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"200":{},"201":{},"202":{},"203":{},"204":{}},"description":{"0":{},"40":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"138":{},"168":{},"196":{},"199":{},"200":{},"201":{},"202":{},"203":{},"204":{},"205":{},"206":{},"211":{},"247":{}}}],["operationcod",{"_index":800,"title":{},"description":{"200":{},"203":{},"204":{}}}],["operationtyp",{"_index":799,"title":{},"description":{"200":{},"203":{},"204":{}}}],["operator-paus",{"_index":854,"title":{},"description":{"211":{}}}],["operator-suppli",{"_index":453,"title":{},"description":{"86":{},"87":{}}}],["opt-in",{"_index":723,"title":{},"description":{"185":{},"195":{}}}],["option",{"_index":241,"title":{},"description":{"12":{},"74":{},"126":{},"127":{},"150":{},"179":{},"181":{},"183":{},"191":{},"193":{},"205":{},"206":{},"212":{},"257":{}}}],["options.phasepolici",{"_index":839,"title":{},"description":{"206":{}}}],["order",{"_index":349,"title":{},"description":{"39":{},"199":{},"254":{}}}],["org",{"_index":134,"title":{"2":{},"4":{},"7":{},"259":{},"262":{},"264":{},"265":{},"266":{}},"description":{"0":{},"2":{},"4":{},"7":{},"11":{},"12":{},"14":{},"15":{},"17":{},"18":{},"21":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"58":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"102":{},"103":{},"104":{},"105":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"121":{},"122":{},"123":{},"124":{},"125":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"215":{},"216":{},"217":{},"218":{},"219":{},"221":{},"222":{},"224":{},"225":{},"226":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"254":{},"255":{},"256":{},"257":{},"258":{},"259":{},"260":{},"261":{},"262":{},"263":{}}}],["org'",{"_index":232,"title":{},"description":{"11":{},"12":{},"13":{},"19":{},"22":{},"42":{},"44":{},"121":{},"122":{},"127":{},"128":{},"130":{},"254":{},"267":{}}}],["org/sit",{"_index":928,"title":{},"description":{"255":{},"256":{},"257":{},"258":{},"261":{},"264":{},"265":{}}}],["organ",{"_index":15,"title":{},"description":{"0":{},"3":{},"6":{},"247":{}}}],["os",{"_index":598,"title":{},"description":{"141":{}}}],["other",{"_index":624,"title":{},"description":{"152":{}}}],["otherwis",{"_index":120,"title":{},"description":{"0":{},"212":{},"261":{}}}],["outcom",{"_index":845,"title":{},"description":{"208":{}}}],["outlin",{"_index":94,"title":{},"description":{"0":{}}}],["over",{"_index":352,"title":{},"description":{"39":{},"185":{},"195":{},"199":{},"201":{},"206":{},"207":{},"209":{},"264":{}}}],["overhead",{"_index":528,"title":{},"description":{"106":{}}}],["overlap",{"_index":958,"title":{},"description":{"257":{},"259":{}}}],["overlay",{"_index":85,"title":{},"description":{"0":{},"220":{}}}],["overrid",{"_index":223,"title":{},"description":{"10":{},"14":{},"169":{},"171":{},"172":{}}}],["overview",{"_index":5,"title":{},"description":{"0":{}}}],["own",{"_index":164,"title":{},"description":{"3":{},"19":{},"22":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"56":{},"102":{},"104":{},"105":{},"121":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"150":{},"151":{},"155":{},"156":{},"162":{},"164":{},"185":{},"195":{},"199":{},"202":{},"204":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"230":{},"231":{},"232":{},"233":{},"234":{},"238":{},"239":{},"240":{},"244":{},"245":{},"246":{}}}],["owner",{"_index":285,"title":{},"description":{"20":{}}}],["ownership",{"_index":554,"title":{},"description":{"122":{}}}],["p-256",{"_index":1024,"title":{},"description":{"264":{}}}],["page",{"_index":351,"title":{},"description":{"39":{}}}],["pagin",{"_index":356,"title":{},"description":{"39":{},"185":{},"195":{},"201":{},"207":{},"209":{}}}],["paramet",{"_index":277,"title":{},"description":{"16":{},"17":{},"74":{},"82":{},"88":{},"96":{},"101":{},"127":{},"137":{},"150":{},"221":{},"267":{}}}],["parseabl",{"_index":976,"title":{},"description":{"257":{}}}],["part",{"_index":57,"title":{},"description":{"0":{},"245":{}}}],["particular",{"_index":781,"title":{},"description":{"199":{},"220":{}}}],["partit",{"_index":511,"title":{"106":{},"107":{},"108":{},"109":{},"110":{},"111":{},"113":{},"114":{},"115":{},"116":{},"117":{},"118":{}},"description":{"106":{},"107":{},"108":{},"109":{},"110":{},"111":{},"113":{},"114":{},"115":{},"116":{},"117":{},"118":{}}}],["past",{"_index":47,"title":{},"description":{"0":{}}}],["patch",{"_index":198,"title":{},"description":{"7":{},"199":{},"203":{},"225":{}}}],["path",{"_index":584,"title":{},"description":{"137":{},"185":{},"195":{},"197":{},"198":{}}}],["paus",{"_index":828,"title":{"210":{}},"description":{"205":{},"210":{},"211":{},"212":{},"257":{},"260":{}}}],["payload",{"_index":728,"title":{},"description":{"185":{},"195":{}}}],["peer",{"_index":407,"title":{"55":{},"56":{},"57":{},"58":{},"59":{}},"description":{"55":{},"56":{},"57":{},"58":{},"59":{}}}],["pend",{"_index":718,"title":{},"description":{"185":{},"195":{},"198":{},"206":{}}}],["per",{"_index":196,"title":{},"description":{"7":{},"40":{},"78":{},"79":{},"199":{},"200":{},"205":{}}}],["per-bmc",{"_index":294,"title":{},"description":{"24":{}}}],["per-compon",{"_index":914,"title":{},"description":{"254":{}}}],["per-component-typ",{"_index":786,"title":{},"description":{"199":{}}}],["per-devic",{"_index":324,"title":{},"description":{"35":{},"37":{}}}],["per-instance-typ",{"_index":652,"title":{"159":{}},"description":{}}],["per-org",{"_index":993,"title":{},"description":{"260":{}}}],["per-phas",{"_index":844,"title":{},"description":{"208":{}}}],["per-rack",{"_index":836,"title":{},"description":{"205":{},"209":{}}}],["per-sit",{"_index":323,"title":{},"description":{"35":{},"126":{}}}],["per-ten",{"_index":207,"title":{"9":{}},"description":{}}],["persist",{"_index":727,"title":{},"description":{"185":{},"195":{}}}],["perspect",{"_index":379,"title":{},"description":{"42":{},"130":{}}}],["pertain",{"_index":214,"title":{},"description":{"10":{}}}],["phase",{"_index":818,"title":{"212":{}},"description":{"205":{},"206":{},"208":{},"211":{},"212":{}}}],["phase'",{"_index":865,"title":{},"description":{"213":{}}}],["physic",{"_index":267,"title":{},"description":{"16":{},"86":{},"87":{},"149":{},"174":{}}}],["pleas",{"_index":21,"title":{},"description":{"0":{},"10":{},"16":{},"41":{},"113":{},"214":{},"246":{},"267":{}}}],["plu",{"_index":548,"title":{},"description":{"121":{}}}],["pod",{"_index":888,"title":{},"description":{"227":{}}}],["point",{"_index":91,"title":{},"description":{"0":{},"265":{}}}],["polici",{"_index":792,"title":{},"description":{"199":{},"214":{},"218":{},"219":{}}}],["policy-g",{"_index":819,"title":{},"description":{"205":{},"206":{}}}],["poll",{"_index":334,"title":{},"description":{"36":{},"206":{}}}],["pool",{"_index":572,"title":{},"description":{"129":{}}}],["portion",{"_index":573,"title":{},"description":{"129":{},"220":{}}}],["possibl",{"_index":389,"title":{},"description":{"47":{}}}],["post",{"_index":732,"title":{},"description":{"185":{},"195":{},"199":{}}}],["post-filt",{"_index":721,"title":{},"description":{"185":{},"195":{},"201":{},"207":{},"209":{}}}],["power",{"_index":447,"title":{"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"154":{},"179":{},"180":{},"191":{},"192":{}},"description":{"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"154":{},"179":{},"180":{},"191":{},"192":{},"196":{}}}],["power_on",{"_index":783,"title":{},"description":{"199":{}}}],["powercontrol",{"_index":782,"title":{},"description":{"199":{}}}],["pre",{"_index":788,"title":{},"description":{"199":{}}}],["pre-exist",{"_index":1003,"title":{},"description":{"261":{}}}],["pre-regist",{"_index":426,"title":{},"description":{"72":{},"73":{},"80":{},"81":{},"86":{},"87":{},"94":{},"95":{}}}],["prefer",{"_index":766,"title":{},"description":{"197":{},"198":{}}}],["prefix",{"_index":109,"title":{"60":{},"61":{},"62":{},"63":{},"64":{},"65":{}},"description":{"0":{},"43":{},"47":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"66":{},"138":{},"220":{}}}],["present",{"_index":286,"title":{},"description":{"20":{},"254":{},"257":{}}}],["preserv",{"_index":194,"title":{},"description":{"7":{},"79":{}}}],["preventalloc",{"_index":678,"title":{},"description":{"168":{}}}],["previou",{"_index":40,"title":{},"description":{"0":{},"257":{},"267":{}}}],["previously-issu",{"_index":995,"title":{},"description":{"260":{}}}],["privileg",{"_index":64,"title":{},"description":{"0":{},"1":{},"19":{},"22":{},"152":{}}}],["proce",{"_index":898,"title":{},"description":{"239":{},"240":{},"245":{}}}],["process",{"_index":369,"title":{},"description":{"40":{},"152":{}}}],["profil",{"_index":318,"title":{"31":{},"32":{},"33":{},"34":{}},"description":{"31":{},"32":{},"33":{},"34":{},"86":{}}}],["progress",{"_index":841,"title":{},"description":{"206":{}}}],["promot",{"_index":313,"title":{},"description":{"27":{},"28":{},"31":{},"32":{}}}],["propag",{"_index":561,"title":{},"description":{"126":{},"127":{},"214":{}}}],["provid",{"_index":3,"title":{"3":{},"4":{},"5":{}},"description":{"0":{},"1":{},"3":{},"4":{},"5":{},"7":{},"9":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"18":{},"19":{},"20":{},"21":{},"22":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"41":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"56":{},"57":{},"58":{},"59":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"86":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"96":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"103":{},"104":{},"105":{},"121":{},"122":{},"123":{},"124":{},"125":{},"127":{},"128":{},"129":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"150":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"220":{},"222":{},"224":{},"225":{},"226":{},"253":{},"254":{},"267":{}}}],["provider'",{"_index":552,"title":{},"description":{"121":{},"267":{}}}],["provider-own",{"_index":549,"title":{},"description":{"121":{},"122":{},"123":{}}}],["provider/p",{"_index":197,"title":{},"description":{"7":{}}}],["provider_admin",{"_index":167,"title":{},"description":{"4":{},"5":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"26":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"36":{},"37":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"56":{},"57":{},"58":{},"59":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"102":{},"103":{},"104":{},"105":{},"121":{},"122":{},"123":{},"124":{},"125":{},"127":{},"128":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"221":{},"222":{},"223":{},"224":{},"225":{},"226":{},"250":{},"251":{},"254":{},"255":{},"256":{}}}],["provider_view",{"_index":234,"title":{},"description":{"11":{},"13":{},"74":{},"75":{},"82":{},"83":{},"88":{},"91":{},"96":{},"97":{},"103":{},"127":{},"128":{},"170":{}}}],["provis",{"_index":592,"title":{},"description":{"138":{}}}],["public",{"_index":900,"title":{},"description":{"241":{},"257":{},"264":{},"265":{}}}],["publish",{"_index":326,"title":{},"description":{"36":{}}}],["pull",{"_index":726,"title":{},"description":{"185":{},"195":{}}}],["put",{"_index":917,"title":{},"description":{"254":{},"257":{},"259":{},"260":{},"261":{}}}],["queri",{"_index":276,"title":{},"description":{"16":{},"17":{},"74":{},"82":{},"88":{},"96":{},"101":{},"127":{},"150":{},"187":{},"221":{},"267":{}}}],["queue",{"_index":365,"title":{},"description":{"40":{}}}],["quick",{"_index":4,"title":{},"description":{"0":{}}}],["rack",{"_index":452,"title":{"86":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"174":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{}},"description":{"86":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"174":{},"175":{},"176":{},"177":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"186":{},"187":{},"189":{},"196":{},"204":{},"205":{},"206":{},"209":{}}}],["rack'",{"_index":698,"title":{},"description":{"178":{}}}],["rack-level",{"_index":742,"title":{},"description":{"187":{},"191":{},"193":{}}}],["rack/task/{id",{"_index":731,"title":{},"description":{"185":{},"195":{}}}],["rack/task/{id}/cancel",{"_index":733,"title":{},"description":{"185":{},"195":{}}}],["rackid",{"_index":468,"title":{},"description":{"87":{},"89":{},"92":{},"187":{},"191":{},"193":{}}}],["rackid/racknam",{"_index":749,"title":{},"description":{"189":{}}}],["rackid`/`racknam",{"_index":739,"title":{},"description":{"187":{},"191":{},"193":{}}}],["rackleveladministr",{"_index":272,"title":{},"description":{"16":{},"267":{}}}],["racknam",{"_index":736,"title":{},"description":{"187":{},"191":{},"193":{}}}],["random",{"_index":606,"title":{},"description":{"141":{}}}],["raw",{"_index":1011,"title":{},"description":{"261":{},"262":{}}}],["rdma",{"_index":522,"title":{},"description":{"106":{}}}],["re-explor",{"_index":366,"title":{},"description":{"40":{}}}],["re-provis",{"_index":673,"title":{},"description":{"167":{}}}],["re-suppli",{"_index":1007,"title":{},"description":{"261":{}}}],["re-valid",{"_index":811,"title":{},"description":{"203":{}}}],["read",{"_index":558,"title":{},"description":{"123":{}}}],["read-onli",{"_index":191,"title":{},"description":{"7":{},"126":{}}}],["readi",{"_index":65,"title":{},"description":{"0":{},"1":{},"6":{},"7":{}}}],["readme](https://github.com/nvidia/infra-controller/tree/main/rest-api/auth",{"_index":27,"title":{},"description":{"0":{}}}],["receiv",{"_index":151,"title":{},"description":{"0":{},"150":{}}}],["recent",{"_index":271,"title":{},"description":{"16":{},"267":{}}}],["record",{"_index":504,"title":{},"description":{"104":{},"105":{},"126":{},"185":{},"195":{},"249":{}}}],["reduc",{"_index":526,"title":{},"description":{"106":{}}}],["refer",{"_index":399,"title":{},"description":{"47":{},"86":{},"89":{},"126":{},"209":{}}}],["referenc",{"_index":115,"title":{},"description":{"0":{},"156":{}}}],["reflect",{"_index":984,"title":{},"description":{"259":{}}}],["refresh",{"_index":997,"title":{},"description":{"260":{}}}],["regist",{"_index":999,"title":{},"description":{"261":{},"262":{}}}],["reject",{"_index":260,"title":{},"description":{"14":{},"54":{},"92":{},"204":{},"212":{},"265":{}}}],["relationship",{"_index":215,"title":{},"description":{"10":{}}}],["remot",{"_index":523,"title":{},"description":{"106":{}}}],["remov",{"_index":177,"title":{},"description":{"6":{},"10":{},"16":{},"41":{},"113":{},"172":{},"214":{},"240":{},"246":{},"254":{},"267":{}}}],["renam",{"_index":585,"title":{},"description":{"137":{}}}],["repeat",{"_index":258,"title":{},"description":{"14":{},"254":{}}}],["replac",{"_index":252,"title":{"89":{}},"description":{"14":{},"89":{}}}],["report",{"_index":189,"title":{"169":{},"170":{},"171":{},"172":{}},"description":{"6":{},"28":{},"32":{},"35":{},"37":{},"126":{},"168":{},"169":{},"170":{},"171":{},"172":{},"177":{},"178":{},"185":{},"189":{},"190":{},"195":{},"201":{},"207":{},"209":{}}}],["repres",{"_index":497,"title":{},"description":{"101":{},"103":{},"186":{},"196":{}}}],["represents/contain",{"_index":212,"title":{},"description":{"10":{}}}],["reprovis",{"_index":672,"title":{"167":{},"168":{}},"description":{"167":{},"168":{}}}],["request",{"_index":238,"title":{},"description":{"12":{},"14":{},"15":{},"26":{},"45":{},"47":{},"54":{},"78":{},"79":{},"89":{},"101":{},"105":{},"120":{},"122":{},"141":{},"151":{},"152":{},"155":{},"166":{},"200":{},"225":{},"255":{},"256":{},"263":{}}}],["requir",{"_index":279,"title":{},"description":{"17":{},"47":{},"82":{},"88":{},"96":{},"101":{},"136":{},"187":{},"191":{},"193":{},"221":{},"257":{},"261":{},"264":{},"265":{},"266":{}}}],["reset",{"_index":667,"title":{"165":{},"166":{}},"description":{"165":{},"166":{}}}],["resourc",{"_index":72,"title":{},"description":{"0":{},"3":{},"6":{},"16":{},"41":{},"47":{}}}],["resourcetypeid",{"_index":375,"title":{},"description":{"41":{}}}],["respond",{"_index":975,"title":{},"description":{"257":{}}}],["respons",{"_index":350,"title":{},"description":{"39":{},"120":{},"156":{},"185":{},"195":{},"200":{},"201":{},"206":{},"207":{},"209":{},"259":{}}}],["rest",{"_index":24,"title":{},"description":{"0":{},"126":{},"156":{},"187":{},"267":{}}}],["restrict",{"_index":436,"title":{},"description":{"74":{},"127":{},"150":{},"156":{},"185":{},"187":{},"195":{}}}],["result",{"_index":202,"title":{"164":{}},"description":{"7":{},"42":{},"74":{},"130":{},"150":{},"164":{},"185":{},"195":{},"201":{},"207":{},"209":{},"226":{},"267":{}}}],["resum",{"_index":833,"title":{"211":{}},"description":{"205":{},"210":{},"211":{}}}],["retain",{"_index":506,"title":{},"description":{"105":{}}}],["retri",{"_index":791,"title":{},"description":{"199":{}}}],["retriev",{"_index":32,"title":{"2":{},"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"13":{},"17":{},"19":{},"22":{},"29":{},"33":{},"39":{},"42":{},"44":{},"49":{},"51":{},"56":{},"58":{},"61":{},"63":{},"67":{},"69":{},"74":{},"75":{},"82":{},"83":{},"88":{},"91":{},"96":{},"97":{},"101":{},"103":{},"107":{},"109":{},"112":{},"114":{},"116":{},"119":{},"121":{},"123":{},"128":{},"130":{},"132":{},"135":{},"139":{},"142":{},"145":{},"146":{},"147":{},"148":{},"150":{},"151":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"162":{},"164":{},"170":{},"175":{},"176":{},"185":{},"187":{},"188":{},"195":{},"197":{},"202":{},"207":{},"208":{},"209":{},"215":{},"217":{},"221":{},"223":{},"226":{},"228":{},"230":{},"233":{},"236":{},"238":{},"242":{},"244":{},"248":{},"250":{},"251":{},"253":{},"259":{},"262":{},"264":{},"265":{},"266":{}},"description":{"0":{},"2":{},"4":{},"5":{},"7":{},"8":{},"11":{},"13":{},"17":{},"19":{},"22":{},"29":{},"33":{},"39":{},"42":{},"44":{},"49":{},"51":{},"61":{},"63":{},"67":{},"69":{},"74":{},"75":{},"82":{},"83":{},"88":{},"91":{},"96":{},"97":{},"101":{},"103":{},"107":{},"109":{},"114":{},"116":{},"126":{},"128":{},"156":{},"162":{},"164":{},"196":{},"205":{},"221":{},"223":{},"226":{},"228":{},"230":{},"233":{},"236":{},"238":{},"242":{},"244":{},"248":{},"251":{},"253":{},"259":{},"262":{}}}],["return",{"_index":149,"title":{},"description":{"0":{},"6":{},"7":{},"9":{},"37":{},"39":{},"42":{},"121":{},"126":{},"130":{},"132":{},"157":{},"158":{},"159":{},"177":{},"178":{},"189":{},"190":{},"198":{},"213":{},"254":{},"257":{},"258":{},"260":{},"261":{},"262":{},"264":{},"265":{}}}],["reus",{"_index":978,"title":{},"description":{"258":{}}}],["reusabl",{"_index":793,"title":{},"description":{"199":{}}}],["revert",{"_index":1016,"title":{},"description":{"263":{}}}],["rfc",{"_index":932,"title":{},"description":{"257":{},"261":{},"263":{},"264":{}}}],["role",{"_index":17,"title":{},"description":{"0":{},"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"26":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"36":{},"37":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"56":{},"57":{},"58":{},"59":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"102":{},"103":{},"104":{},"105":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"121":{},"122":{},"123":{},"124":{},"125":{},"127":{},"128":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"215":{},"216":{},"217":{},"218":{},"219":{},"221":{},"222":{},"223":{},"224":{},"225":{},"226":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"250":{},"251":{},"254":{},"255":{},"256":{},"257":{},"258":{},"259":{},"260":{},"261":{},"262":{},"263":{}}}],["root",{"_index":295,"title":{},"description":{"24":{},"222":{},"224":{},"225":{}}}],["rotat",{"_index":321,"title":{"35":{},"36":{},"37":{}},"description":{"35":{},"36":{},"37":{},"257":{},"264":{}}}],["rotate-to",{"_index":328,"title":{},"description":{"36":{}}}],["rotatekey",{"_index":980,"title":{},"description":{"258":{}}}],["rotation-statu",{"_index":342,"title":{},"description":{"37":{}}}],["rout",{"_index":969,"title":{},"description":{"257":{}}}],["row",{"_index":566,"title":{},"description":{"126":{}}}],["rule",{"_index":780,"title":{"199":{},"200":{},"201":{},"202":{},"203":{},"204":{}},"description":{"199":{},"200":{},"201":{},"202":{},"203":{},"204":{}}}],["ruledefinit",{"_index":807,"title":{},"description":{"203":{}}}],["run",{"_index":663,"title":{"162":{},"163":{},"205":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{}},"description":{"161":{},"162":{},"163":{},"185":{},"195":{},"196":{},"198":{},"205":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"227":{}}}],["run'",{"_index":848,"title":{},"description":{"209":{}}}],["safeti",{"_index":826,"title":{},"description":{"205":{}}}],["same",{"_index":58,"title":{},"description":{"0":{},"55":{},"57":{},"78":{},"79":{},"89":{},"141":{},"152":{},"197":{},"198":{},"266":{}}}],["satisfi",{"_index":384,"title":{},"description":{"43":{}}}],["save",{"_index":503,"title":{},"description":{"104":{},"105":{}}}],["schedul",{"_index":638,"title":{},"description":{"156":{}}}],["schema",{"_index":508,"title":{},"description":{"105":{}}}],["scope",{"_index":690,"title":{},"description":{"177":{},"189":{},"267":{}}}],["script",{"_index":127,"title":{},"description":{"0":{},"120":{}}}],["secret",{"_index":329,"title":{},"description":{"36":{},"261":{}}}],["section",{"_index":2,"title":{},"description":{"0":{}}}],["secur",{"_index":869,"title":{"214":{},"215":{},"216":{},"217":{},"218":{},"219":{}},"description":{"214":{},"215":{},"216":{},"217":{},"218":{},"219":{}}}],["see",{"_index":981,"title":{},"description":{"258":{},"264":{}}}],["select",{"_index":305,"title":{},"description":{"26":{},"105":{},"205":{}}}],["selector",{"_index":822,"title":{},"description":{"205":{},"206":{}}}],["semant",{"_index":982,"title":{},"description":{"258":{}}}],["sensit",{"_index":636,"title":{},"description":{"156":{}}}],["sent",{"_index":249,"title":{},"description":{"14":{}}}],["separ",{"_index":623,"title":{},"description":{"152":{}}}],["septemb",{"_index":227,"title":{},"description":{"10":{}}}],["seri",{"_index":659,"title":{},"description":{"161":{}}}],["serial",{"_index":427,"title":{},"description":{"72":{},"80":{},"94":{},"235":{},"241":{}}}],["serv",{"_index":937,"title":{},"description":{"257":{}}}],["server",{"_index":518,"title":{"253":{}},"description":{"106":{},"149":{},"253":{},"261":{}}}],["server-sid",{"_index":795,"title":{},"description":{"200":{},"203":{},"206":{}}}],["servic",{"_index":50,"title":{"1":{},"2":{},"227":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{}},"description":{"0":{},"1":{},"2":{},"227":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"252":{},"263":{}}}],["set",{"_index":245,"title":{},"description":{"12":{},"37":{},"79":{},"89":{},"123":{},"124":{},"125":{},"150":{},"185":{},"195":{},"199":{},"201":{},"205":{},"206":{},"207":{},"208":{},"209":{},"212":{},"218":{},"257":{},"264":{}}}],["sever",{"_index":724,"title":{},"description":{"185":{},"195":{},"235":{}}}],["sha-256",{"_index":1014,"title":{},"description":{"262":{}}}],["share",{"_index":537,"title":{},"description":{"113":{},"141":{}}}],["shelf",{"_index":448,"title":{"80":{},"81":{},"83":{},"84":{},"85":{}},"description":{"80":{},"81":{},"83":{},"84":{},"85":{}}}],["shelv",{"_index":449,"title":{"82":{}},"description":{"80":{},"81":{},"82":{},"83":{},"84":{},"85":{}}}],["short-liv",{"_index":1000,"title":{},"description":{"261":{}}}],["show",{"_index":693,"title":{},"description":{"177":{},"178":{},"189":{},"190":{}}}],["sig",{"_index":1023,"title":{},"description":{"264":{}}}],["sign",{"_index":934,"title":{},"description":{"257":{},"258":{},"259":{},"260":{},"261":{},"263":{}}}],["signatur",{"_index":1021,"title":{},"description":{"264":{},"265":{}}}],["signingkey",{"_index":991,"title":{},"description":{"259":{}}}],["silent",{"_index":669,"title":{},"description":{"166":{}}}],["similar",{"_index":495,"title":{},"description":{"100":{}}}],["singl",{"_index":106,"title":{},"description":{"0":{},"78":{},"79":{},"141":{}}}],["single-task",{"_index":730,"title":{},"description":{"185":{},"195":{}}}],["single-ten",{"_index":413,"title":{},"description":{"57":{}}}],["site",{"_index":81,"title":{"9":{},"16":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"38":{},"40":{},"153":{},"157":{},"158":{},"159":{}},"description":{"0":{},"3":{},"6":{},"7":{},"9":{},"10":{},"14":{},"16":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"23":{},"25":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"34":{},"38":{},"39":{},"40":{},"55":{},"56":{},"57":{},"58":{},"59":{},"60":{},"66":{},"72":{},"73":{},"74":{},"78":{},"79":{},"80":{},"81":{},"86":{},"87":{},"89":{},"90":{},"94":{},"95":{},"100":{},"101":{},"102":{},"103":{},"104":{},"105":{},"121":{},"123":{},"126":{},"127":{},"128":{},"149":{},"150":{},"151":{},"152":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"163":{},"166":{},"168":{},"170":{},"171":{},"172":{},"174":{},"175":{},"177":{},"179":{},"181":{},"183":{},"185":{},"187":{},"189":{},"191":{},"193":{},"195":{},"197":{},"198":{},"199":{},"200":{},"201":{},"202":{},"204":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"220":{},"235":{},"239":{},"240":{},"243":{},"245":{},"254":{},"255":{},"256":{},"257":{},"267":{}}}],["site'",{"_index":283,"title":{},"description":{"19":{},"22":{},"73":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"103":{},"156":{}}}],["site-default",{"_index":301,"title":{},"description":{"25":{},"26":{}}}],["site-level",{"_index":78,"title":{},"description":{"0":{},"43":{}}}],["site-scop",{"_index":713,"title":{},"description":{"185":{},"195":{},"196":{},"197":{},"198":{},"200":{},"202":{},"204":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{}}}],["site-specif",{"_index":287,"title":{},"description":{"20":{}}}],["site-wid",{"_index":293,"title":{},"description":{"24":{},"35":{},"36":{},"37":{}}}],["sitecap",{"_index":66,"title":{},"description":{"0":{},"1":{},"7":{},"10":{},"14":{}}}],["siteid",{"_index":221,"title":{},"description":{"10":{},"14":{},"74":{},"82":{},"88":{},"89":{},"96":{},"101":{},"126":{},"127":{},"150":{},"185":{},"195":{},"197":{},"198":{},"202":{},"204":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"255":{},"256":{},"267":{}}}],["six",{"_index":942,"title":{},"description":{"257":{}}}],["size",{"_index":440,"title":{},"description":{"78":{},"79":{}}}],["sku",{"_index":487,"title":{"100":{},"101":{},"102":{},"103":{},"104":{},"105":{}},"description":{"100":{},"101":{},"102":{},"103":{},"104":{},"105":{}}}],["sku'",{"_index":500,"title":{},"description":{"103":{},"104":{},"105":{}}}],["slot",{"_index":746,"title":{},"description":{"187":{}}}],["slotid",{"_index":745,"title":{},"description":{"187":{}}}],["sourc",{"_index":385,"title":{},"description":{"43":{}}}],["specif",{"_index":253,"title":{},"description":{"14":{},"19":{},"20":{},"21":{},"22":{},"51":{},"52":{},"63":{},"64":{},"69":{},"70":{},"75":{},"83":{},"91":{},"97":{},"103":{},"109":{},"110":{},"116":{},"117":{},"154":{},"162":{},"164":{},"166":{},"170":{},"171":{},"172":{},"177":{},"189":{},"226":{},"231":{},"232":{},"233":{},"234":{},"239":{},"240":{},"251":{},"257":{},"267":{}}}],["specifi",{"_index":125,"title":{},"description":{"0":{},"9":{},"12":{},"15":{},"45":{},"47":{},"68":{},"152":{},"157":{},"158":{},"159":{},"175":{},"177":{},"179":{},"181":{},"183":{},"185":{},"187":{},"189":{},"191":{},"193":{},"195":{},"218":{},"225":{},"243":{},"255":{},"256":{}}}],["spiff",{"_index":1034,"title":{"266":{}},"description":{"266":{}}}],["spiffe-n",{"_index":1036,"title":{},"description":{"266":{}}}],["spread",{"_index":604,"title":{},"description":{"141":{}}}],["ssh",{"_index":599,"title":{"235":{},"236":{},"237":{},"238":{},"239":{},"240":{},"241":{},"242":{},"243":{},"244":{},"245":{},"246":{}},"description":{"141":{},"235":{},"236":{},"237":{},"238":{},"239":{},"240":{},"241":{},"242":{},"243":{},"244":{},"245":{},"246":{}}}],["stabl",{"_index":563,"title":{},"description":{"126":{},"128":{}}}],["stage",{"_index":322,"title":{},"description":{"35":{},"36":{},"199":{}}}],["stale",{"_index":861,"title":{},"description":{"212":{}}}],["standard",{"_index":515,"title":{},"description":{"106":{}}}],["start",{"_index":1,"title":{"0":{}},"description":{"0":{},"47":{},"206":{},"213":{}}}],["stat",{"_index":170,"title":{"5":{},"8":{},"9":{},"157":{},"159":{}},"description":{"5":{},"8":{},"9":{},"157":{},"159":{}}}],["state",{"_index":346,"title":{},"description":{"38":{},"163":{},"177":{},"178":{},"179":{},"180":{},"185":{},"189":{},"190":{},"191":{},"192":{},"195":{},"196":{},"198":{},"200":{},"206":{},"213":{}}}],["statu",{"_index":158,"title":{"2":{},"22":{},"37":{},"145":{},"155":{}},"description":{"2":{},"12":{},"14":{},"22":{},"36":{},"145":{},"158":{}}}],["step",{"_index":10,"title":{},"description":{"0":{},"200":{}}}],["still",{"_index":716,"title":{},"description":{"185":{},"195":{},"204":{}}}],["stock",{"_index":488,"title":{},"description":{"100":{},"101":{},"103":{}}}],["stop",{"_index":370,"title":{},"description":{"40":{}}}],["storag",{"_index":519,"title":{},"description":{"106":{},"149":{}}}],["store",{"_index":985,"title":{},"description":{"259":{},"261":{}}}],["strict",{"_index":1030,"title":{},"description":{"265":{}}}],["string",{"_index":469,"title":{},"description":{"87":{}}}],["structur",{"_index":16,"title":{},"description":{"0":{}}}],["subjectprefix",{"_index":989,"title":{},"description":{"259":{}}}],["submit",{"_index":803,"title":{},"description":{"200":{},"209":{}}}],["subnet",{"_index":114,"title":{"66":{},"67":{},"68":{},"69":{},"70":{},"71":{}},"description":{"0":{},"47":{},"54":{},"66":{},"67":{},"68":{},"69":{},"70":{},"71":{},"138":{}}}],["subscriptionid",{"_index":225,"title":{},"description":{"10":{}}}],["subscriptionti",{"_index":226,"title":{},"description":{"10":{}}}],["subsequ",{"_index":923,"title":{},"description":{"254":{},"258":{},"261":{},"263":{}}}],["succe",{"_index":582,"title":{},"description":{"136":{}}}],["succeed",{"_index":778,"title":{},"description":{"198":{}}}],["success",{"_index":927,"title":{},"description":{"254":{}}}],["successfulli",{"_index":381,"title":{},"description":{"43":{}}}],["suffix",{"_index":168,"title":{},"description":{"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"26":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"36":{},"37":{},"39":{},"40":{},"42":{},"43":{},"44":{},"46":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"56":{},"57":{},"58":{},"59":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"102":{},"103":{},"104":{},"105":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"121":{},"123":{},"124":{},"125":{},"127":{},"128":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"152":{},"153":{},"154":{},"156":{},"157":{},"158":{},"159":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"215":{},"216":{},"217":{},"218":{},"219":{},"221":{},"222":{},"223":{},"224":{},"226":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"250":{},"251":{},"254":{},"255":{},"256":{},"257":{},"258":{},"259":{},"260":{},"261":{},"262":{},"263":{}}}],["summari",{"_index":645,"title":{"158":{}},"description":{"157":{}}}],["super",{"_index":881,"title":{},"description":{"226":{}}}],["superset",{"_index":580,"title":{},"description":{"136":{}}}],["suppli",{"_index":250,"title":{},"description":{"14":{},"254":{},"258":{}}}],["support",{"_index":116,"title":{},"description":{"0":{},"45":{},"46":{},"60":{},"66":{},"179":{},"180":{},"191":{},"192":{},"227":{}}}],["surviv",{"_index":952,"title":{},"description":{"257":{}}}],["switch",{"_index":482,"title":{"94":{},"95":{},"96":{},"97":{},"98":{},"99":{}},"description":{"94":{},"95":{},"96":{},"97":{},"98":{},"99":{},"261":{}}}],["sync",{"_index":893,"title":{},"description":{"235":{}}}],["synchron",{"_index":639,"title":{},"description":{"156":{}}}],["system",{"_index":123,"title":{"120":{},"121":{},"122":{},"123":{},"124":{},"125":{}},"description":{"0":{},"31":{},"32":{},"100":{},"106":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"138":{},"253":{}}}],["system-level",{"_index":910,"title":{},"description":{"252":{}}}],["tag",{"_index":760,"title":{},"description":{"196":{},"199":{},"205":{},"258":{},"264":{}}}],["taken",{"_index":906,"title":{},"description":{"249":{}}}],["target",{"_index":331,"title":{"209":{}},"description":{"36":{},"179":{},"181":{},"183":{},"185":{},"187":{},"191":{},"193":{},"195":{},"200":{},"205":{},"209":{},"210":{},"213":{},"255":{},"256":{}}}],["target'",{"_index":837,"title":{},"description":{"205":{}}}],["targetedinstancecr",{"_index":67,"title":{},"description":{"0":{},"7":{},"10":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"103":{},"150":{},"152":{},"156":{},"166":{},"168":{},"170":{},"171":{},"172":{}}}],["task",{"_index":712,"title":{"185":{},"195":{},"196":{},"197":{},"198":{},"205":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{}},"description":{"185":{},"195":{},"196":{},"197":{},"198":{},"205":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{}}}],["task/run/{id",{"_index":840,"title":{},"description":{"206":{}}}],["task/{taskid",{"_index":849,"title":{},"description":{"209":{}}}],["taskid",{"_index":838,"title":{},"description":{"205":{},"209":{}}}],["templat",{"_index":557,"title":{"126":{},"127":{},"128":{}},"description":{"122":{},"126":{},"127":{},"128":{},"199":{}}}],["tempor",{"_index":640,"title":{},"description":{"156":{},"198":{}}}],["tenant",{"_index":56,"title":{"6":{},"7":{},"8":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"257":{},"258":{},"259":{},"260":{}},"description":{"0":{},"1":{},"6":{},"7":{},"8":{},"9":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"18":{},"19":{},"20":{},"22":{},"41":{},"42":{},"44":{},"45":{},"46":{},"47":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"56":{},"57":{},"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"66":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"103":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"121":{},"122":{},"123":{},"124":{},"125":{},"127":{},"128":{},"129":{},"130":{},"132":{},"138":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"150":{},"151":{},"152":{},"155":{},"156":{},"159":{},"166":{},"168":{},"170":{},"171":{},"172":{},"215":{},"216":{},"217":{},"218":{},"219":{},"220":{},"222":{},"224":{},"225":{},"226":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"257":{},"258":{},"259":{},"260":{},"261":{},"262":{},"263":{},"264":{},"267":{}}}],["tenant'",{"_index":243,"title":{},"description":{"12":{},"48":{},"121":{},"151":{},"155":{},"261":{}}}],["tenant-identity/config",{"_index":943,"title":{},"description":{"257":{},"261":{}}}],["tenant-identity/token-deleg",{"_index":944,"title":{},"description":{"257":{}}}],["tenant-level",{"_index":157,"title":{},"description":{"1":{}}}],["tenant-own",{"_index":555,"title":{},"description":{"122":{}}}],["tenant/account/{accountid",{"_index":199,"title":{},"description":{"7":{}}}],["tenant/curr",{"_index":184,"title":{},"description":{"6":{}}}],["tenant_admin",{"_index":204,"title":{},"description":{"7":{},"8":{},"11":{},"13":{},"14":{},"17":{},"19":{},"22":{},"42":{},"44":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"56":{},"57":{},"58":{},"59":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"101":{},"103":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"121":{},"122":{},"123":{},"124":{},"125":{},"127":{},"128":{},"130":{},"132":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"151":{},"152":{},"155":{},"156":{},"166":{},"168":{},"170":{},"171":{},"172":{},"215":{},"216":{},"217":{},"218":{},"219":{},"221":{},"223":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"250":{},"251":{},"257":{},"258":{},"259":{},"260":{},"261":{},"262":{},"263":{}}}],["tenantaccount.sitecap",{"_index":176,"title":{},"description":{"6":{},"267":{}}}],["tenantcontactid",{"_index":251,"title":{},"description":{"14":{}}}],["tenantid",{"_index":263,"title":{},"description":{"14":{},"17":{},"122":{},"123":{},"124":{},"125":{},"221":{}}}],["tenantsummary.cap",{"_index":186,"title":{},"description":{"6":{}}}],["termin",{"_index":773,"title":{},"description":{"198":{}}}],["test",{"_index":660,"title":{},"description":{"161":{}}}],["three",{"_index":945,"title":{},"description":{"257":{}}}],["threshold",{"_index":830,"title":{},"description":{"205":{}}}],["through",{"_index":658,"title":{},"description":{"161":{}}}],["time",{"_index":160,"title":{},"description":{"2":{},"47":{},"137":{},"152":{}}}],["timeout",{"_index":790,"title":{},"description":{"199":{}}}],["togeth",{"_index":892,"title":{},"description":{"235":{},"254":{}}}],["token",{"_index":14,"title":{"261":{},"262":{},"263":{}},"description":{"0":{},"257":{},"261":{},"262":{},"263":{}}}],["toml",{"_index":87,"title":{},"description":{"0":{}}}],["top-level",{"_index":474,"title":{},"description":{"89":{}}}],["topologyoptim",{"_index":601,"title":{},"description":{"141":{}}}],["total",{"_index":720,"title":{},"description":{"185":{},"195":{},"201":{},"207":{},"209":{}}}],["track",{"_index":345,"title":{},"description":{"38":{},"126":{}}}],["traffic",{"_index":870,"title":{},"description":{"214":{}}}],["transact",{"_index":597,"title":{},"description":{"141":{}}}],["transit",{"_index":859,"title":{},"description":{"212":{}}}],["tray",{"_index":735,"title":{"186":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{}},"description":{"186":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"196":{}}}],["treat",{"_index":954,"title":{},"description":{"257":{}}}],["trigger",{"_index":360,"title":{"40":{}},"description":{"168":{}}}],["true",{"_index":193,"title":{},"description":{"7":{},"141":{},"154":{},"166":{},"168":{},"258":{}}}],["trust",{"_index":311,"title":{"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"34":{}},"description":{"27":{},"29":{},"30":{},"31":{},"33":{},"34":{},"259":{}}}],["trust-domain",{"_index":1035,"title":{},"description":{"266":{}}}],["tupl",{"_index":801,"title":{},"description":{"200":{},"204":{}}}],["turn",{"_index":825,"title":{},"description":{"205":{}}}],["two",{"_index":412,"title":{},"description":{"57":{},"257":{},"259":{}}}],["type",{"_index":137,"title":{"9":{},"129":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"158":{}},"description":{"0":{},"9":{},"43":{},"54":{},"122":{},"129":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"152":{},"158":{},"159":{},"173":{},"187":{},"191":{},"193":{},"227":{},"254":{}}}],["type'",{"_index":581,"title":{},"description":{"136":{}}}],["type/machin",{"_index":144,"title":{},"description":{"0":{}}}],["typic",{"_index":95,"title":{},"description":{"0":{},"120":{}}}],["uefi",{"_index":300,"title":{"25":{},"26":{}},"description":{"25":{},"26":{}}}],["un-default",{"_index":817,"title":{},"description":{"204":{}}}],["unalloc",{"_index":383,"title":{},"description":{"43":{}}}],["unassign",{"_index":648,"title":{},"description":{"158":{}}}],["unchang",{"_index":810,"title":{},"description":{"203":{}}}],["under",{"_index":762,"title":{},"description":{"196":{}}}],["underli",{"_index":774,"title":{},"description":{"198":{}}}],["union",{"_index":551,"title":{},"description":{"121":{}}}],["uniqu",{"_index":470,"title":{},"description":{"87":{},"89":{},"101":{},"103":{},"126":{}}}],["unit",{"_index":490,"title":{},"description":{"100":{},"101":{},"103":{}}}],["unknown",{"_index":968,"title":{},"description":{"257":{}}}],["unless",{"_index":979,"title":{},"description":{"258":{}}}],["unset",{"_index":808,"title":{},"description":{"203":{}}}],["until",{"_index":588,"title":{},"description":{"137":{},"205":{},"209":{},"210":{},"257":{}}}],["untouch",{"_index":813,"title":{},"description":{"203":{}}}],["unus",{"_index":502,"title":{},"description":{"104":{}}}],["unverifi",{"_index":996,"title":{},"description":{"260":{}}}],["up",{"_index":709,"title":{"183":{},"184":{}},"description":{"183":{},"184":{}}}],["updat",{"_index":139,"title":{"14":{},"20":{},"24":{},"46":{},"47":{},"53":{},"54":{},"65":{},"71":{},"76":{},"79":{},"84":{},"92":{},"98":{},"105":{},"111":{},"117":{},"125":{},"134":{},"144":{},"152":{},"171":{},"181":{},"182":{},"193":{},"194":{},"203":{},"218":{},"225":{},"232":{},"240":{},"246":{},"255":{},"258":{},"261":{}},"description":{"0":{},"10":{},"12":{},"14":{},"20":{},"23":{},"24":{},"46":{},"47":{},"53":{},"54":{},"65":{},"71":{},"76":{},"79":{},"84":{},"89":{},"92":{},"98":{},"100":{},"105":{},"111":{},"117":{},"120":{},"125":{},"134":{},"144":{},"152":{},"171":{},"181":{},"182":{},"193":{},"194":{},"196":{},"218":{},"225":{},"232":{},"240":{},"246":{},"254":{},"255":{},"258":{},"261":{}}}],["upgrad",{"_index":785,"title":{},"description":{"199":{}}}],["upsert",{"_index":949,"title":{},"description":{"257":{},"258":{}}}],["upserthostfirmwareconfig",{"_index":919,"title":{},"description":{"254":{}}}],["uri",{"_index":1029,"title":{},"description":{"265":{}}}],["url",{"_index":883,"title":{},"description":{"226":{},"254":{},"255":{},"256":{},"257":{},"258":{},"259":{},"260":{},"261":{},"262":{},"263":{}}}],["us",{"_index":11,"title":{},"description":{"0":{},"7":{},"10":{},"16":{},"28":{},"39":{},"41":{},"60":{},"66":{},"72":{},"80":{},"94":{},"106":{},"113":{},"120":{},"141":{},"173":{},"189":{},"205":{},"214":{},"220":{},"235":{},"241":{},"246":{},"254":{},"257":{},"264":{},"265":{},"266":{},"267":{}}}],["usag",{"_index":229,"title":{},"description":{"10":{}}}],["useipmitool",{"_index":668,"title":{},"description":{"166":{}}}],["user",{"_index":53,"title":{"247":{},"248":{}},"description":{"0":{},"1":{},"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"26":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"36":{},"37":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"56":{},"57":{},"58":{},"59":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"102":{},"103":{},"104":{},"105":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"121":{},"123":{},"124":{},"125":{},"127":{},"128":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"169":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"215":{},"216":{},"217":{},"218":{},"219":{},"221":{},"222":{},"223":{},"224":{},"225":{},"226":{},"227":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"247":{},"248":{},"249":{},"250":{},"251":{},"254":{},"255":{},"256":{},"258":{},"259":{},"260":{},"261":{},"262":{},"263":{}}}],["userdata",{"_index":545,"title":{},"description":{"120":{}}}],["utc",{"_index":182,"title":{},"description":{"6":{},"10":{},"16":{},"41":{},"113":{},"137":{},"214":{},"267":{}}}],["util",{"_index":390,"title":{},"description":{"47":{},"106":{}}}],["uuid",{"_index":244,"title":{},"description":{"12":{},"87":{},"126":{},"180":{},"182":{},"184":{},"192":{},"194":{},"197":{},"202":{},"204":{},"208":{}}}],["v2/org/{org}/nico/alloc",{"_index":380,"title":{},"description":{"42":{},"43":{}}}],["v2/org/{org}/nico/allocation/{allocationid",{"_index":387,"title":{},"description":{"44":{},"45":{},"46":{}}}],["v2/org/{org}/nico/allocation/{allocationid}/constraint/{allocationconstraintid",{"_index":400,"title":{},"description":{"47":{}}}],["v2/org/{org}/nico/audit",{"_index":908,"title":{},"description":{"250":{}}}],["v2/org/{org}/nico/audit/{auditentryid",{"_index":909,"title":{},"description":{"251":{}}}],["v2/org/{org}/nico/credential/bmc",{"_index":299,"title":{},"description":{"24":{}}}],["v2/org/{org}/nico/credential/rot",{"_index":336,"title":{},"description":{"36":{},"37":{}}}],["v2/org/{org}/nico/credential/uefi",{"_index":308,"title":{},"description":{"26":{}}}],["v2/org/{org}/nico/dpu-extension-servic",{"_index":889,"title":{},"description":{"228":{},"229":{}}}],["v2/org/{org}/nico/dpu-extension-service/{dpuextensionserviceid",{"_index":890,"title":{},"description":{"230":{},"231":{},"232":{}}}],["v2/org/{org}/nico/dpu-extension-service/{dpuextensionserviceid}/version/{vers",{"_index":891,"title":{},"description":{"233":{},"234":{}}}],["v2/org/{org}/nico/expected-machin",{"_index":433,"title":{},"description":{"73":{},"74":{}}}],["v2/org/{org}/nico/expected-machine/batch",{"_index":442,"title":{},"description":{"78":{},"79":{}}}],["v2/org/{org}/nico/expected-machine/{expectedmachineid",{"_index":437,"title":{},"description":{"75":{},"76":{},"77":{}}}],["v2/org/{org}/nico/expected-power-shelf",{"_index":450,"title":{},"description":{"81":{},"82":{}}}],["v2/org/{org}/nico/expected-power-shelf/{expectedpowershelfid",{"_index":451,"title":{},"description":{"83":{},"84":{},"85":{}}}],["v2/org/{org}/nico/expected-rack",{"_index":472,"title":{},"description":{"87":{},"88":{},"89":{}}}],["v2/org/{org}/nico/expected-rack/al",{"_index":476,"title":{},"description":{"90":{}}}],["v2/org/{org}/nico/expected-rack/{id",{"_index":477,"title":{},"description":{"91":{},"92":{},"93":{}}}],["v2/org/{org}/nico/expected-switch",{"_index":485,"title":{},"description":{"95":{},"96":{}}}],["v2/org/{org}/nico/expected-switch/{expectedswitchid",{"_index":486,"title":{},"description":{"97":{},"98":{},"99":{}}}],["v2/org/{org}/nico/firmware-config/host",{"_index":929,"title":{},"description":{"255":{},"256":{}}}],["v2/org/{org}/nico/infiniband-interfac",{"_index":535,"title":{},"description":{"112":{}}}],["v2/org/{org}/nico/infiniband-partit",{"_index":532,"title":{},"description":{"107":{},"108":{}}}],["v2/org/{org}/nico/infiniband-partition/{infinibandpartitionid",{"_index":533,"title":{},"description":{"109":{},"110":{},"111":{}}}],["v2/org/{org}/nico/infrastructure-provider/curr",{"_index":169,"title":{},"description":{"4":{}}}],["v2/org/{org}/nico/infrastructure-provider/current/stat",{"_index":171,"title":{},"description":{"5":{}}}],["v2/org/{org}/nico/inst",{"_index":594,"title":{},"description":{"139":{},"140":{}}}],["v2/org/{org}/nico/instance/batch",{"_index":612,"title":{},"description":{"141":{}}}],["v2/org/{org}/nico/instance/typ",{"_index":574,"title":{},"description":{"130":{},"131":{}}}],["v2/org/{org}/nico/instance/type/{instancetypeid",{"_index":575,"title":{},"description":{"132":{},"133":{},"134":{}}}],["v2/org/{org}/nico/instance/type/{instancetypeid}/machin",{"_index":578,"title":{},"description":{"135":{},"136":{}}}],["v2/org/{org}/nico/instance/type/{instancetypeid}/machine/{machineassociationid",{"_index":591,"title":{},"description":{"137":{}}}],["v2/org/{org}/nico/instance/{instanceid",{"_index":613,"title":{},"description":{"142":{},"143":{},"144":{}}}],["v2/org/{org}/nico/instance/{instanceid}/infiniband-interfac",{"_index":616,"title":{},"description":{"147":{}}}],["v2/org/{org}/nico/instance/{instanceid}/interfac",{"_index":615,"title":{},"description":{"146":{}}}],["v2/org/{org}/nico/instance/{instanceid}/nvlink-interfac",{"_index":617,"title":{},"description":{"148":{}}}],["v2/org/{org}/nico/instance/{instanceid}/status-histori",{"_index":614,"title":{},"description":{"145":{}}}],["v2/org/{org}/nico/ipblock",{"_index":878,"title":{},"description":{"221":{},"222":{}}}],["v2/org/{org}/nico/ipblock/{ipblockid",{"_index":879,"title":{},"description":{"223":{},"224":{},"225":{}}}],["v2/org/{org}/nico/ipblock/{ipblockid}/deriv",{"_index":884,"title":{},"description":{"226":{}}}],["v2/org/{org}/nico/ipxe-templ",{"_index":570,"title":{},"description":{"127":{}}}],["v2/org/{org}/nico/ipxe-template/{ipxetemplateid",{"_index":571,"title":{},"description":{"128":{}}}],["v2/org/{org}/nico/machin",{"_index":619,"title":{},"description":{"150":{}}}],["v2/org/{org}/nico/machine-cap",{"_index":656,"title":{},"description":{"160":{}}}],["v2/org/{org}/nico/machine/gpu/stat",{"_index":646,"title":{},"description":{"157":{}}}],["v2/org/{org}/nico/machine/instance-type/stat",{"_index":654,"title":{},"description":{"159":{}}}],["v2/org/{org}/nico/machine/instance-type/stats/summari",{"_index":651,"title":{},"description":{"158":{}}}],["v2/org/{org}/nico/machine/{machineid",{"_index":621,"title":{},"description":{"151":{},"152":{},"153":{}}}],["v2/org/{org}/nico/machine/{machineid}/bmc/reset",{"_index":671,"title":{},"description":{"166":{}}}],["v2/org/{org}/nico/machine/{machineid}/dpu",{"_index":644,"title":{},"description":{"156":{}}}],["v2/org/{org}/nico/machine/{machineid}/dpu/reprovis",{"_index":679,"title":{},"description":{"168":{}}}],["v2/org/{org}/nico/machine/{machineid}/health-report",{"_index":681,"title":{},"description":{"170":{},"171":{}}}],["v2/org/{org}/nico/machine/{machineid}/health-report/{sourc",{"_index":683,"title":{},"description":{"172":{}}}],["v2/org/{org}/nico/machine/{machineid}/pow",{"_index":632,"title":{},"description":{"154":{}}}],["v2/org/{org}/nico/machine/{machineid}/status-histori",{"_index":633,"title":{},"description":{"155":{}}}],["v2/org/{org}/nico/machine/{machineid}/validation/result",{"_index":666,"title":{},"description":{"164":{}}}],["v2/org/{org}/nico/machine/{machineid}/validation/run",{"_index":665,"title":{},"description":{"162":{},"163":{}}}],["v2/org/{org}/nico/measured-boot/trusted-machin",{"_index":316,"title":{},"description":{"28":{},"29":{}}}],["v2/org/{org}/nico/measured-boot/trusted-machine/{id",{"_index":317,"title":{},"description":{"30":{}}}],["v2/org/{org}/nico/measured-boot/trusted-profil",{"_index":319,"title":{},"description":{"32":{},"33":{}}}],["v2/org/{org}/nico/measured-boot/trusted-profile/{id",{"_index":320,"title":{},"description":{"34":{}}}],["v2/org/{org}/nico/metadata",{"_index":911,"title":{},"description":{"253":{}}}],["v2/org/{org}/nico/network-security-group",{"_index":873,"title":{},"description":{"215":{},"216":{}}}],["v2/org/{org}/nico/network-security-group/{networksecuritygroupid",{"_index":874,"title":{},"description":{"217":{},"218":{},"219":{}}}],["v2/org/{org}/nico/nvlink-interfac",{"_index":541,"title":{},"description":{"119":{}}}],["v2/org/{org}/nico/nvlink-logical-partit",{"_index":539,"title":{},"description":{"114":{},"115":{}}}],["v2/org/{org}/nico/nvlink-logical-partition/{nvlinklogicalpartitionid",{"_index":540,"title":{},"description":{"116":{},"117":{},"118":{}}}],["v2/org/{org}/nico/operating-system",{"_index":553,"title":{},"description":{"121":{},"122":{}}}],["v2/org/{org}/nico/operating-system/{operatingsystemid",{"_index":559,"title":{},"description":{"123":{},"124":{},"125":{}}}],["v2/org/{org}/nico/rack",{"_index":685,"title":{},"description":{"175":{}}}],["v2/org/{org}/nico/rack/bringup",{"_index":710,"title":{},"description":{"183":{}}}],["v2/org/{org}/nico/rack/firmwar",{"_index":706,"title":{},"description":{"181":{}}}],["v2/org/{org}/nico/rack/pow",{"_index":703,"title":{},"description":{"179":{}}}],["v2/org/{org}/nico/rack/task/{id",{"_index":765,"title":{},"description":{"197":{}}}],["v2/org/{org}/nico/rack/task/{id}/cancel",{"_index":769,"title":{},"description":{"198":{}}}],["v2/org/{org}/nico/rack/valid",{"_index":697,"title":{},"description":{"177":{}}}],["v2/org/{org}/nico/rack/{id",{"_index":686,"title":{},"description":{"176":{}}}],["v2/org/{org}/nico/rack/{id}/bringup",{"_index":711,"title":{},"description":{"184":{}}}],["v2/org/{org}/nico/rack/{id}/firmwar",{"_index":707,"title":{},"description":{"182":{}}}],["v2/org/{org}/nico/rack/{id}/pow",{"_index":704,"title":{},"description":{"180":{}}}],["v2/org/{org}/nico/rack/{id}/task",{"_index":734,"title":{},"description":{"185":{}}}],["v2/org/{org}/nico/rack/{id}/valid",{"_index":699,"title":{},"description":{"178":{}}}],["v2/org/{org}/nico/service-account/curr",{"_index":163,"title":{},"description":{"2":{}}}],["v2/org/{org}/nico/sit",{"_index":281,"title":{},"description":{"17":{},"18":{}}}],["v2/org/{org}/nico/site-explorer/endpoint",{"_index":359,"title":{},"description":{"39":{}}}],["v2/org/{org}/nico/site-explorer/endpoint/act",{"_index":372,"title":{},"description":{"40":{}}}],["v2/org/{org}/nico/site/{siteid",{"_index":284,"title":{},"description":{"19":{},"20":{},"21":{}}}],["v2/org/{org}/nico/site/{siteid}/.well-known/jwks.json",{"_index":1027,"title":{},"description":{"264":{}}}],["v2/org/{org}/nico/site/{siteid}/.well-known/openid-configur",{"_index":1033,"title":{},"description":{"265":{}}}],["v2/org/{org}/nico/site/{siteid}/.well-known/spiffe/jwks.json",{"_index":1039,"title":{},"description":{"266":{}}}],["v2/org/{org}/nico/site/{siteid}/status-histori",{"_index":289,"title":{},"description":{"22":{}}}],["v2/org/{org}/nico/site/{siteid}/tenant-identity/config",{"_index":983,"title":{},"description":{"258":{},"259":{},"260":{}}}],["v2/org/{org}/nico/site/{siteid}/tenant-identity/token-deleg",{"_index":1013,"title":{},"description":{"261":{},"262":{},"263":{}}}],["v2/org/{org}/nico/sku",{"_index":499,"title":{},"description":{"101":{},"102":{}}}],["v2/org/{org}/nico/sku/{skuid",{"_index":501,"title":{},"description":{"103":{},"104":{},"105":{}}}],["v2/org/{org}/nico/sshkey",{"_index":901,"title":{},"description":{"242":{},"243":{}}}],["v2/org/{org}/nico/sshkey/{sshkeyid",{"_index":902,"title":{},"description":{"244":{},"245":{},"246":{}}}],["v2/org/{org}/nico/sshkeygroup",{"_index":895,"title":{},"description":{"236":{},"237":{}}}],["v2/org/{org}/nico/sshkeygroup/{sshkeygroupid",{"_index":896,"title":{},"description":{"238":{},"239":{},"240":{}}}],["v2/org/{org}/nico/subnet",{"_index":420,"title":{},"description":{"67":{},"68":{}}}],["v2/org/{org}/nico/subnet/{subnetid",{"_index":423,"title":{},"description":{"69":{},"70":{},"71":{}}}],["v2/org/{org}/nico/task/rul",{"_index":804,"title":{},"description":{"200":{},"201":{}}}],["v2/org/{org}/nico/task/rule/{id",{"_index":805,"title":{},"description":{"202":{},"203":{},"204":{}}}],["v2/org/{org}/nico/task/run",{"_index":842,"title":{},"description":{"206":{},"207":{}}}],["v2/org/{org}/nico/task/run/{id",{"_index":847,"title":{},"description":{"208":{}}}],["v2/org/{org}/nico/task/run/{id}/adv",{"_index":863,"title":{},"description":{"212":{}}}],["v2/org/{org}/nico/task/run/{id}/cancel",{"_index":868,"title":{},"description":{"213":{}}}],["v2/org/{org}/nico/task/run/{id}/paus",{"_index":853,"title":{},"description":{"210":{}}}],["v2/org/{org}/nico/task/run/{id}/resum",{"_index":856,"title":{},"description":{"211":{}}}],["v2/org/{org}/nico/task/run/{id}/target",{"_index":850,"title":{},"description":{"209":{}}}],["v2/org/{org}/nico/task/{id",{"_index":768,"title":{},"description":{"197":{}}}],["v2/org/{org}/nico/task/{id}/cancel",{"_index":779,"title":{},"description":{"198":{}}}],["v2/org/{org}/nico/tenant/account",{"_index":235,"title":{},"description":{"11":{},"12":{}}}],["v2/org/{org}/nico/tenant/account/{accountid",{"_index":248,"title":{},"description":{"13":{},"14":{},"15":{}}}],["v2/org/{org}/nico/tenant/curr",{"_index":205,"title":{},"description":{"7":{}}}],["v2/org/{org}/nico/tenant/current/stat",{"_index":206,"title":{},"description":{"8":{}}}],["v2/org/{org}/nico/tenant/instance-type/stat",{"_index":210,"title":{},"description":{"9":{}}}],["v2/org/{org}/nico/tray",{"_index":747,"title":{},"description":{"187":{}}}],["v2/org/{org}/nico/tray/firmwar",{"_index":756,"title":{},"description":{"193":{}}}],["v2/org/{org}/nico/tray/pow",{"_index":754,"title":{},"description":{"191":{}}}],["v2/org/{org}/nico/tray/valid",{"_index":751,"title":{},"description":{"189":{}}}],["v2/org/{org}/nico/tray/{id",{"_index":748,"title":{},"description":{"188":{}}}],["v2/org/{org}/nico/tray/{id}/firmwar",{"_index":757,"title":{},"description":{"194":{}}}],["v2/org/{org}/nico/tray/{id}/pow",{"_index":755,"title":{},"description":{"192":{}}}],["v2/org/{org}/nico/tray/{id}/task",{"_index":758,"title":{},"description":{"195":{}}}],["v2/org/{org}/nico/tray/{id}/valid",{"_index":752,"title":{},"description":{"190":{}}}],["v2/org/{org}/nico/user/curr",{"_index":904,"title":{},"description":{"248":{}}}],["v2/org/{org}/nico/vpc",{"_index":403,"title":{},"description":{"49":{},"50":{}}}],["v2/org/{org}/nico/vpc-p",{"_index":410,"title":{},"description":{"56":{},"57":{}}}],["v2/org/{org}/nico/vpc-peering/{id",{"_index":416,"title":{},"description":{"58":{},"59":{}}}],["v2/org/{org}/nico/vpc-prefix",{"_index":418,"title":{},"description":{"61":{},"62":{}}}],["v2/org/{org}/nico/vpc-prefix/{vpcprefixid",{"_index":419,"title":{},"description":{"63":{},"64":{},"65":{}}}],["v2/org/{org}/nico/vpc/{vpcid",{"_index":404,"title":{},"description":{"51":{},"52":{},"53":{}}}],["v2/org/{org}/nico/vpc/{vpcid}/virtu",{"_index":406,"title":{},"description":{"54":{}}}],["valid",{"_index":657,"title":{"161":{},"162":{},"163":{},"164":{},"177":{},"178":{},"189":{},"190":{}},"description":{"161":{},"162":{},"163":{},"164":{},"177":{},"178":{},"189":{},"190":{},"200":{},"203":{},"206":{},"257":{}}}],["valu",{"_index":183,"title":{},"description":{"6":{},"7":{},"43":{},"89":{},"105":{}}}],["variou",{"_index":97,"title":{},"description":{"0":{},"246":{},"252":{}}}],["vendor",{"_index":915,"title":{},"description":{"254":{},"256":{}}}],["verif",{"_index":1022,"title":{},"description":{"264":{},"265":{}}}],["verifi",{"_index":661,"title":{},"description":{"161":{},"257":{},"266":{}}}],["version",{"_index":28,"title":{"233":{},"234":{}},"description":{"0":{},"17":{},"36":{},"105":{},"221":{},"231":{},"232":{},"233":{},"234":{},"254":{},"267":{}}}],["via",{"_index":162,"title":{},"description":{"2":{},"7":{},"86":{},"87":{},"187":{},"205":{},"209":{},"222":{},"224":{},"225":{},"254":{}}}],["view",{"_index":247,"title":{},"description":{"12":{}}}],["virtual",{"_index":405,"title":{"54":{}},"description":{"54":{}}}],["visibl",{"_index":546,"title":{},"description":{"121":{},"150":{}}}],["vpc",{"_index":112,"title":{"48":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"55":{},"56":{},"57":{},"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{}},"description":{"0":{},"47":{},"48":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"55":{},"56":{},"57":{},"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"138":{}}}],["vs",{"_index":647,"title":{},"description":{"158":{},"177":{},"178":{},"187":{},"189":{},"190":{},"191":{},"193":{},"258":{}}}],["wait",{"_index":719,"title":{},"description":{"185":{},"195":{},"198":{}}}],["way",{"_index":798,"title":{},"description":{"200":{}}}],["web",{"_index":1020,"title":{},"description":{"264":{}}}],["well-known",{"_index":458,"title":{},"description":{"86":{},"87":{},"257":{}}}],["whether",{"_index":544,"title":{},"description":{"120":{}}}],["whose",{"_index":262,"title":{},"description":{"14":{},"168":{}}}],["window",{"_index":959,"title":{},"description":{"257":{}}}],["within",{"_index":471,"title":{},"description":{"87":{},"89":{},"141":{},"186":{}}}],["without",{"_index":776,"title":{},"description":{"198":{},"257":{},"260":{}}}],["worker",{"_index":608,"title":{},"description":{"141":{}}}],["worker-abc123",{"_index":610,"title":{},"description":{"141":{}}}],["worker-def456",{"_index":611,"title":{},"description":{"141":{}}}],["workflow",{"_index":642,"title":{},"description":{"156":{},"185":{},"195":{},"198":{}}}],["workload",{"_index":1002,"title":{},"description":{"261":{}}}],["wrong",{"_index":862,"title":{},"description":{"212":{}}}],["x-pagin",{"_index":357,"title":{},"description":{"39":{},"185":{},"195":{},"201":{},"207":{},"209":{}}}]],"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":"2.0.0","summary":"NVIDIA Infra Controller REST API is the RESTful gateway for accessing the NVIDIA Infra Controller service","description":"NVIDIA Infra Controller REST API allows users to create and manage resources, e.g., VPCs, Subnets, and 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/tree/main/rest-api/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 when a Ready Tenant Account has `siteCapabilities` with `targetedInstanceCreation` 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 use a NICo Site, the Provider or Service Account holder must create IP Blocks for each network overlay defined in the Site configuration TOML file.\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 with the full prefix length using the [Create Allocation endpoint](#tag/Allocation/operation/create-allocation).\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).\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 Machines on the 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 the 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  - If the 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 the API service is configured in Service Account mode, API users can act as both Provider and Tenant. Privileged Tenant behavior (for example, creating Instances by Machine ID) is determined by `siteCapabilities` on a Ready Tenant Account, not by tenant-level configuration."},{"name":"Infrastructure Provider","description":"Infrastructure Provider is the anchor entity for an organization that owns and manages Site resources."},{"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- `capabilities.targetedInstanceCreation` was deprecated in favor of `tenantAccount.siteCapabilities` and will be removed on October 1st, 2026 0:00 UTC. The value returned on GET `/tenant/current` is computed from Ready Tenant Account configuration; embedded `TenantSummary.capabilities` in nested resources always reports `false`."},{"name":"Tenant Account","description":"Tenant Account connects a Tenant with an Infrastructure Provider. It represents/contains any information pertaining to their relationship.\n\nProvider Admins configure TargetedInstanceCreation for a Tenant using the `siteCapabilities` attribute. An entry with empty or omitted `siteIds` configures the Tenant Account default; entries with `siteIds` configure Tenant Site overrides.\n\nDeprecation history:\n\n- `accountNumber`, `subscriptionId`, and `subscriptionTier` attributes were deprecated and will be removed on September 10th, 2026 0:00 UTC. Please update your usage accordingly."},{"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\nRecent deprecations:\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":"BMC Credential","x-displayName":"BMC Credential","description":"BMC Credential endpoints allow creating and updating BMC credentials across all Machines of a Site"},{"name":"UEFI Credential","x-displayName":"UEFI Credential","description":"UEFI Credential endpoints allow creating site-default host and DPU UEFI credentials for a Site"},{"name":"Measured Boot Trusted Machine","description":"Measured Boot Trusted Machine endpoints manage automatic measurement promotion approvals for Machines at a Site"},{"name":"Measured Boot Trusted Profile","description":"Measured Boot Trusted Profile endpoints manage automatic measurement promotion approvals for system profiles at a Site"},{"name":"Credential Rotation","description":"Credential Rotation endpoints stage a site-wide credential rotation and report per-Site or per-device convergence"},{"name":"Site Explorer","description":"Site Explorer discovers BMC endpoints on a Site and tracks their exploration state."},{"name":"Allocation","description":"Allocations are the mechanism by which Provider can delegate Network and Compute resources to Tenant.\n\nDeprecation history:\n\n- `ResourceTypeID` attribute on Allocation Constraint was deprecated in favor of `resourceTypeId` and will be removed on July 9th, 2026 0:00 UTC. Please use `resourceTypeId` instead."},{"name":"VPC","x-displayName":"VPC","description":"VPC defines the networking isolation boundary for Tenant's Instances."},{"name":"VPC Peering","x-displayName":"VPC Peering","description":"VPC Peering allows Instances in one VPC to communicate with Instances in another VPC on the same Site."},{"name":"VPC Prefix","x-displayName":"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)."},{"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 an NVLink 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 NVLink Switch discovery and ingestion."},{"name":"SKU","x-displayName":"SKU","description":"SKU (Stock Keeping Unit) defines one or more hardware configurations or Machine Bill of Materials (BOM).\n\nSKUs group similar machines by their hardware characteristics. Most SKUs are managed by the system, but Provider Admins can create, update, and delete SKUs for a Site."},{"name":"InfiniBand Partition","x-displayName":"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","x-displayName":"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.\n\nDeprecation history:\n\n- `nvLinklogicalPartitionId` attribute on NVLink Interface was deprecated in favor of `nvLinkLogicalPartitionId` and will be removed on July 9th, 2026 0:00 UTC. Please use `nvLinkLogicalPartitionId` instead."},{"name":"Operating System","description":"Operating Systems in NICo are typically iPXE scripts that are used to boot Machines.\n\nDeprecation history:\n\n- `isCloudInit` on create and update requests is deprecated and ignored; the response field is derived from whether `userData` is non-empty."},{"name":"iPXE Template","x-displayName":"iPXE Template","description":"iPXE Templates are read-only definitions propagated from nico-core into the REST API. Each template has a stable core UUID and a globally unique name; per-site availability is tracked in IpxeTemplateSiteAssociation records rather than on the template row itself. List and retrieve operations return templates reported at sites the caller is authorized for (optionally filtered by `siteId`). Templated iPXE Operating Systems reference a template by `ipxeTemplateId`."},{"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."},{"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."},{"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 Validation","description":"Machine Validation is the mechanism through which a series of validation tests are executed against a Machine verify its integrity. The tests are run for each Machine on ingestion, they can also be run on-demand."},{"name":"BMC Reset","x-displayName":"BMC Reset","description":"BMC Reset allows resetting a Machine's BMC"},{"name":"DPU Reprovision","x-displayName":"DPU Reprovision","description":"DPU Reprovision allows re-provisioning Machine's DPUs"},{"name":"Health Report","description":"Machine Health Report contains information about the health of a Machine including user enforced overrides"},{"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":"Task","description":"Task represents an asynchronous, site-scoped operation (for example firmware update, power state change, or rack bring-up). Tasks are created when operations run against Racks, Trays, or other components. Endpoints in this tag retrieve or cancel a Task by ID; list Tasks for a Rack or Tray under the Rack and Tray tags."},{"name":"Rule","description":"Operation Rule defines, per Site, how a particular operation (for example `PowerControl` / `power_on` or `FirmwareControl` / `upgrade`) should be executed against a set of components: ordered execution stages, per-component-type concurrency, pre / main / post actions, timeouts, and retry policy. Rules are reusable templates owned by Flow; this tag exposes CRUD (`POST`, `GET`, `PATCH`, `DELETE`) over them."},{"name":"Task Run","description":"A Task Run is a phased, policy-gated execution of one operation (currently firmware) across many Racks. A Task Run narrows a candidate set of Racks with an optional selector, divides the selected Racks into phases, and drives one execution target per Rack; each target in turn drives at most one Task. Safety gates pause the Task Run when failures exceed a threshold, and phase gates hold each phase until an operator advances it. This tag exposes creation, retrieval, target listing, and the pause / resume / advance / cancel lifecycle actions; drill into per-Rack execution detail via the Task tag using each target's `taskId`."},{"name":"Network Security Group","description":"Network Security Group is a security policy that controls the traffic flowing between Instances.\n\nDeprecation history:\n\n- `object_id` attribute on Network Security Group propagation details was deprecated in favor of `objectId` and will be removed on July 9th, 2026 0:00 UTC. Please use `objectId` instead."},{"name":"IP Block","x-displayName":"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."},{"name":"DPU Extension Service","x-displayName":"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","x-displayName":"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","x-displayName":"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":"Host Firmware Config","description":"Host firmware configuration defines known firmware versions, artifact\nlocations, update ordering, and per-component defaults for a given\nhardware vendor and model on a Site.\n\nProvider Admins use PUT to create or merge host firmware config entries\nin Core via `UpsertHostFirmwareConfig`. Configurations are keyed by\n`(vendor, model)`; repeated PUTs merge firmware versions for\ncomponents already present and add new component types when supplied\ntogether with an updated `ordering`. Returns `201 Created` on first\ncreate and `200 OK` on subsequent updates.\n\nProvider Admins use DELETE to remove a host firmware config entry from\nCore via `DeleteHostFirmwareConfig`, keyed by `(vendor, model)`.\nReturns `204 No Content` on success.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix in the\nURL `{org}`, and the Site must belong to the org's Infrastructure\nProvider."},{"name":"Tenant Identity","description":"Tenant identity (JWT-SVID issuance) and RFC 8693 token delegation.\n\nTenant Admins use these endpoints to enable JWT-SVID issuance for an\norg on a specific site, rotate the signing key, configure a token\nexchange callback, and serve the public JWKS / OIDC discovery\ndocuments that verifiers (OpenBao, tenant APIs, etc.) consume.\n\nThe six management endpoints (PUT / GET / DELETE on `tenant-identity/config`\nand `tenant-identity/token-delegation`) require an authorization role with\n`TENANT_ADMIN` suffix in the URL `{org}`. The three `.well-known/*`\nendpoints are public; external verifiers can fetch public keys\nwithout credentials.\n\nPUT is a full-replace upsert: every call must include all required\nfields, and omitted optional fields are cleared. To pause issuance\nwithout destroying signing keys, PUT with `enabled: false`; to\ndestroy the signing keypair, use DELETE. Signing keys survive\n`enabled: false` and survive non-rotation upserts, so JWKS consumers\nand in-flight JWTs continue to verify across pauses and attribute\nchanges.\n\nJWKS verifiers should treat every key in the returned set as valid\nand match candidates by `kid` — during a key-rotation overlap\nwindow two keys are present until the previous key expires. The\nOIDC discovery endpoint's `id_token_signing_alg_values_supported`\nis intentionally empty because NICo issues bearer access JWTs,\nnot OIDC `id_token`s. The three public endpoints return\n`404 Not Found` when identity material cannot be served for this\norg/site (unknown site, org is not a tenant, no tenant allocation\non the site, or no identity configuration); the two JWKS routes\nadditionally return `502 Bad Gateway` when the Core gRPC API\nresponds with a body that is not a parseable JWK Set."},{"name":"Deprecations","description":"NICo REST API maintains backward compatibility with the previous versions. Any breaking changes are announced using deprecation notices.\n\nActive Deprecations:\n\nInstance:\n- `infrastructureProviderId` query parameter on the list Instances endpoint was deprecated and will be removed on October 10th, 2026 0:00 UTC. Instances will no longer be filtered by Infrastructure Provider; results are scoped to the org's Tenant. Use the `siteId` parameter to scope results to a specific Infrastructure Provider's Sites.\n\nTenant:\n- `capabilities.targetedInstanceCreation` attribute was deprecated in favor of `tenantAccount.siteCapabilities` and will be removed on October 1st, 2026 0:00 UTC. Please use `tenantAccount.siteCapabilities` instead.\n\nRecent Deprecations:\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":true},"deprecations":[{"attribute":"capabilities.targetedInstanceCreation","replacedBy":"tenantAccount.siteCapabilities","takeActionBy":"2026-10-01T00:00:00Z","notice":"'capabilities.targetedInstanceCreation' is being deprecated in favor of 'tenantAccount.siteCapabilities'. Please take action prior to the specified date"}]}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"get-current-tenant","description":"Retrieve Tenant entity for current Org.\n\n`capabilities.targetedInstanceCreation` is a deprecated read-only aggregate: it is `true` when all Ready Tenant Account for this Tenant has TargetedInstanceCreation enabled in its configuration to preserve backwards compatibility. Configure the capability per Provider/per Site via PATCH `/tenant/account/{accountId}` using `siteCapabilities`. Disallowing at Provider or Site level would result in no value returned here.\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 for the org.\n\nThe Infrastructure Provider and Tenant are inferred from the org's membership. User must have authorization role with `PROVIDER_ADMIN`, `PROVIDER_VIEWER`, or `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","deprecated":true,"description":"Filter Tenant Accounts by Infrastructure Provider ID. Deprecated: Infrastructure Provider is now inferred from the org's membership."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","description":"Filter Tenant Accounts 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. User must have authorization role with `PROVIDER_ADMIN` suffix. The Infrastructure Provider is inferred from the caller's org; the deprecated `infrastructureProviderId` request body field is optional and, when provided, must match the org's Infrastructure Provider.\n\nInfrastructure Provider can create a Tenant Account by specifying the Tenant's UUID or Tenant's org name. This sets the Tenant Account status to \"Invited\". The Tenant can then view the account information and 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"}],"siteCapabilities":[{"targetedInstanceCreation":true}],"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\nThe Infrastructure Provider and Tenant are inferred from the org's membership. User must have authorization role with `PROVIDER_ADMIN`, `PROVIDER_VIEWER`, or `TENANT_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","deprecated":true,"description":"Filter Tenant Accounts by Infrastructure Provider ID. Deprecated: Infrastructure Provider is now inferred from the org's membership."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","deprecated":true,"description":"Filter Tenant Accounts by Tenant ID. Deprecated: Tenant is now inferred from the org's membership."},{"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"}],"siteCapabilities":[{"targetedInstanceCreation":true}],"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\nTenant Admins may accept an invitation sent by an Infrastructure Provider by supplying `tenantContactId`.\n\nProvider Admins may replace `siteCapabilities` to configure the Tenant Account default and overrides for specific Sites. When `siteCapabilities` is sent, it must be non-empty, include exactly one entry with empty or omitted `siteIds`, and must not repeat any `siteId` across entries. Requests containing both `tenantContactId` and `siteCapabilities` are rejected with 400.\n\nOrg must have a Tenant entity whose ID matches the `tenantId` of the Tenant Account object when accepting an invite. User must have authorization role with `TENANT_ADMIN` suffix to accept; `PROVIDER_ADMIN` suffix to update `siteCapabilities`. Tenant Admins can only update a Tenant Account that has `Invited` status.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantAccountUpdateRequest"},"examples":{"accept-invite":{"value":{}},"update-site-capabilities":{"value":{"siteCapabilities":[{"siteIds":[],"targetedInstanceCreation":true}]}}}}},"description":"Tenant invite acceptance or Provider Admin site capability update."}},"delete":{"summary":"Delete Tenant Account","operationId":"delete-tenant-account","responses":{"202":{"description":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was accepted"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete a Tenant Account by ID.\n\nOrg must have an Infrastructure Provider entity, and the specified Tenant Account must have been created by that 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 parameter may be required for older API versions.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","deprecated":true,"description":"Filter Sites by Infrastructure Provider ID. Deprecated: Infrastructure Provider is now inferred from the org's membership."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","deprecated":true,"description":"Filter Sites by Tenant ID. Deprecated: Tenant is now inferred from the org's membership."},{"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 lifecycle status and health. Requires Provider Admin role."},{"schema":{"type":"boolean"},"in":"query","name":"includeGpuStats","description":"Include a per-Site breakdown of GPU counts grouped by GPU type. 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"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"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","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was accepted"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"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/credential/bmc":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"put":{"summary":"Create Or Update BMC Credential","tags":["BMC Credential"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BMCCredentialRequest"}}}},"responses":{"200":{"description":"BMC credential was created or updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BMCCredential"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"create-or-update-bmc-credential","description":"Create or update a site-wide or per-BMC root credential. Equivalent\nto `nico-admin-cli credential add-bmc`.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix."}},"/v2/org/{org}/nico/credential/uefi":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create UEFI Credential","tags":["UEFI Credential"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UEFICredentialRequest"}}}},"responses":{"201":{"description":"UEFI credential was created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UEFICredential"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"409":{"description":"The selected site-default UEFI credential already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"}}}}},"operationId":"create-uefi-credential","description":"Create a site-default host or DPU UEFI credential. The request fails\nif the selected site-default credential already exists.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix."}},"/v2/org/{org}/nico/measured-boot/trusted-machine":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create Measured Boot Trusted Machine Approval","tags":["Measured Boot Trusted Machine"],"operationId":"create-measured-boot-trusted-machine","description":"Approve a Machine, or all Machines using `*`, for automatic promotion of its next measured-boot report.\n\nOrg must have an Infrastructure Provider entity that owns the Site. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeasuredBootTrustedMachineCreateRequest"}}}},"responses":{"201":{"description":"Measured Boot trusted Machine approval was created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeasuredBootTrustedMachine"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}}},"get":{"summary":"Retrieve All Measured Boot Trusted Machine Approvals","tags":["Measured Boot Trusted Machine"],"operationId":"get-all-measured-boot-trusted-machine","description":"Retrieve all measured-boot trusted Machine approvals for a Site.\n\nOrg must have an Infrastructure Provider entity that owns the Site. 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":"Measured Boot trusted Machine approvals","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MeasuredBootTrustedMachine"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}}}},"/v2/org/{org}/nico/measured-boot/trusted-machine/{id}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string"},"name":"id","in":"path","required":true,"description":"Approval ID or Machine ID, as selected by the selector query parameter"}],"delete":{"summary":"Delete Measured Boot Trusted Machine Approval","tags":["Measured Boot Trusted Machine"],"operationId":"delete-measured-boot-trusted-machine","description":"Delete a measured-boot trusted Machine approval by approval ID or Machine ID.\n\nOrg must have an Infrastructure Provider entity that owns the Site. 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","enum":["ApprovalId","MachineId"]},"name":"selector","in":"query","required":true,"description":"Whether id identifies the approval or the Machine"}],"responses":{"200":{"description":"Deleted measured-boot trusted Machine approval","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeasuredBootTrustedMachine"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}}}},"/v2/org/{org}/nico/measured-boot/trusted-profile":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create Measured Boot Trusted Profile Approval","tags":["Measured Boot Trusted Profile"],"operationId":"create-measured-boot-trusted-profile","description":"Approve a measured-boot system profile for automatic promotion of reports from matching Machines.\n\nOrg must have an Infrastructure Provider entity that owns the Site. User must have authorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeasuredBootTrustedProfileCreateRequest"}}}},"responses":{"201":{"description":"Measured Boot trusted Profile approval was created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeasuredBootTrustedProfile"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}}},"get":{"summary":"Retrieve All Measured Boot Trusted Profile Approvals","tags":["Measured Boot Trusted Profile"],"operationId":"get-all-measured-boot-trusted-profile","description":"Retrieve all measured-boot trusted Profile approvals for a Site.\n\nOrg must have an Infrastructure Provider entity that owns the Site. 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":"Measured Boot trusted Profile approvals","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MeasuredBootTrustedProfile"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}}}},"/v2/org/{org}/nico/measured-boot/trusted-profile/{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":"Approval ID or Profile ID, as selected by the selector query parameter"}],"delete":{"summary":"Delete Measured Boot Trusted Profile Approval","tags":["Measured Boot Trusted Profile"],"operationId":"delete-measured-boot-trusted-profile","description":"Delete a measured-boot trusted Profile approval by approval ID or Profile ID.\n\nOrg must have an Infrastructure Provider entity that owns the Site. 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","enum":["ApprovalId","ProfileId"]},"name":"selector","in":"query","required":true,"description":"Whether id identifies the approval or the system profile"}],"responses":{"200":{"description":"Deleted measured-boot trusted Profile approval","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeasuredBootTrustedProfile"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}}}},"/v2/org/{org}/nico/credential/rotation":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Rotate Credential","tags":["Credential Rotation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialRotationRequest"}}}},"responses":{"200":{"description":"Credential rotation was staged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialRotationResult"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"operationId":"rotate-credential","description":"Stage a site-wide credential rotation: publish a new rotate-to secret\nand bump the site-wide target version. Devices converge to the new\nversion asynchronously; poll the status endpoint to observe\nconvergence. Equivalent to `nico-admin-cli credential rotate`.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix."},"get":{"summary":"Get Credential Rotation Status","tags":["Credential Rotation"],"parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site to query."},{"schema":{"type":"string","enum":["BMC","HostUEFI","DPUUEFI","NVOS","LockdownIKM"]},"name":"credentialType","in":"query","required":true,"description":"Credential family to report."},{"schema":{"type":"string"},"name":"deviceMac","in":"query","required":false,"description":"Report only this device's convergence, matched by MAC."}],"responses":{"200":{"description":"Credential rotation status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialRotationStatus"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"description":"No rotation record exists for the requested device","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"}}}}},"operationId":"get-credential-rotation-status","description":"Report convergence of an in-flight or completed site-wide credential\nrotation. When `deviceMac` is set, the counts describe just that device\nand a per-device detail block is returned. Equivalent to\n`nico-admin-cli credential rotation-status`.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix."}},"/v2/org/{org}/nico/site-explorer/endpoint":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Retrieve all Explored Endpoints","tags":["Site Explorer"],"parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site"},{"schema":{"type":"integer"},"name":"pageNumber","in":"query","required":false,"description":"Page number of results returned"},{"schema":{"type":"integer"},"name":"pageSize","in":"query","required":false,"description":"Number of results per page"},{"schema":{"type":"string","enum":["ID_ASC","ID_DESC"],"default":"ID_ASC"},"name":"orderBy","in":"query","required":false,"description":"Order results by endpoint ID"}],"responses":{"200":{"description":"Explored endpoints for the Site","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExploredEndpoint"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":30,\"orderBy\":\"ID_ASC\"}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/GenericHttpError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/GenericHttpError"},"412":{"$ref":"#/components/responses/GenericHttpError"},"500":{"$ref":"#/components/responses/GenericHttpError"},"504":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"get-all-site-explorer-endpoint","description":"Retrieve explored endpoints discovered by Site Explorer for a Site. Use `ID_ASC` or `ID_DESC` to order by endpoint ID; the default is `ID_ASC`.\n\nThe response is paged over Core `FindExploredEndpointIds` followed by\n`FindExploredEndpointsByIds`. Pagination metadata is returned in the\n`X-Pagination` response header.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix."}},"/v2/org/{org}/nico/site-explorer/endpoint/action":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Trigger Site Explorer Endpoint Action","tags":["Site Explorer"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteExplorerEndpointActionRequest"}}}},"responses":{"200":{"description":"The action completed for every selected endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteExplorerEndpointAction"}}}},"400":{"$ref":"#/components/responses/GenericHttpError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/GenericHttpError"},"412":{"$ref":"#/components/responses/GenericHttpError"},"500":{"$ref":"#/components/responses/GenericHttpError"},"504":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"create-site-explorer-endpoint-action","description":"Clear the last exploration error or queue re-exploration for all\nexplored endpoints at a Site or an explicit BMC IP address list.\n\nThe operation calls Core once per endpoint. If a call fails, processing\nstops and endpoints earlier in the list may already have completed.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix."}},"/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\nThe Infrastructure Provider and Tenant 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 Allocations. 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 the 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\nThe Infrastructure Provider and Tenant 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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was accepted"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"description":"Delete an Allocation by ID.\n\nOrg must have an Infrastructure Provider entity, and the specified Allocation must have been created by that 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"}]}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"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/{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"}],"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"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"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\nFor an InstanceType resource, `constraintValue` can be incremented at any time, but not decremented if doing so requires decommissioning Tenant resources.\n\nFor an IPBlock resource, `constraintValue` cannot be modified if Tenant resources, e.g., Subnets or VPC Prefixes, reference the block.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllocationConstraintUpdateRequest"},"examples":{"example-1":{"value":{"constraintValue":20}}}}}},"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 parameter may be required for older API versions.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"infrastructureProviderId","deprecated":true,"description":"Filter IP Blocks by Infrastructure Provider ID. Deprecated: Infrastructure Provider is now inferred from the org's membership."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","deprecated":true,"description":"Filter IP Blocks by Tenant ID. Deprecated: Tenant is now inferred from the org's membership."},{"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 IP Blocks. 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":"192.168.20.0","prefixLength":24,"protocolVersion":"IPv4","usageStats":{"availableIPs":256,"acquiredIPs":2,"availablePrefixes":["192.168.20.32/27","192.168.20.64/26","192.168.20.128/25"],"availableSmallestPrefixes":56,"acquiredPrefixes":1},"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","deprecated":true,"description":"Filter IP Blocks by Infrastructure Provider ID. Deprecated: Infrastructure Provider is now inferred from the org's membership."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"tenantId","deprecated":true,"description":"Filter IP Blocks by Tenant ID. Deprecated: Tenant is now inferred from the org's membership."},{"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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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 them.\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"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"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 derived IP Blocks. 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":{"objectId":"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":{"objectId":"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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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":["Pending","Configuring","Requested","Ready","Deleting","Error"]},"in":"query","name":"status","required":false,"description":"Optional filter by peering status. Repeat the parameter to match multiple statuses."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"vpcId","required":false,"description":"Optional filter by VPC ID involved in the peering as either vpc1 or vpc2. Repeat the parameter to match multiple VPCs."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"peerTenantId","required":false,"description":"Optional filter by tenant ID of a VPC involved in the peering. Repeat the parameter to match multiple tenants."},{"schema":{"type":"string","enum":["Vpc1","Vpc2","Site","Tenant"]},"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","Tenant"]},"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 the vpcId query parameter 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 VPC Prefixes. 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":"boolean"},"in":"query","name":"includeUsageStats","description":"When true, each VPC Prefix object includes usage statistics using the same structure as IP Block usage. Prefix and IP usage data is derived by evaluating associated Ethernet interfaces. Each Interface associated with a VPC Prefix consumes a `/31` prefix."},{"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"},{"schema":{"type":"boolean"},"in":"query","name":"includeUsageStats","description":"When true, each VPC Prefix object includes usage statistics using the same structure as IP Block usage.\nPrefix and IP usage data is derived by evaluating associated Ethernet interfaces. Each Interface associated with a VPC Prefix consumes a `/31` prefix."}]},"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","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 the vpcId query parameter 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 Subnets. 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":"boolean"},"in":"query","name":"includeUsageStats","description":"When true, each Subnet object includes usage statistics using the same structure as IP Block usage.\nPrefix and IP usage data is derived by evaluating associated Ethernet interfaces. Each Interface associated with a Subnet consumes a single IP. In addition, one gateway and one broadcast IP address are reserved per Subnet."},{"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","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 one IPv4 IP block or one 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","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"},{"schema":{"type":"boolean"},"in":"query","name":"includeUsageStats","description":"When true, each Subnet object includes usage statistics using the same structure as IP Block usage.\nPrefix and IP usage data is derived by evaluating associated Ethernet interfaces. Each Interface associated with a Subnet consumes a single IP. In addition, one gateway and one broadcast IP address are reserved per Subnet."}]},"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","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 may retrieve Expected Machines across Sites where `TargetedInstanceCreation` is effective. The siteId query parameter is optional and, when provided, further restricts results to that Site.","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":"Expected Machine 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\nAll items in a batch update must provide the same set of fields, except that `bmcIpAddress` may be omitted or set to `null` to preserve that machine's current BMC IP address.\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 authorization role with `PROVIDER_ADMIN` suffix.\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 authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\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 authorization role with `PROVIDER_ADMIN` suffix.\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 authorization role with `PROVIDER_ADMIN` suffix.\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 authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\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 authorization role with `PROVIDER_ADMIN` suffix.\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.\n\n`rackId` is immutable: an update that changes it is rejected with `400` before any database mutation.","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 authorization role with `PROVIDER_ADMIN` suffix.\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","nvosMacAddresses":["00:1A:2B:3C:4D:60","00:1A:2B:3C:4D:61"],"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","nvosMacAddresses":["00:1A:2B:3C:4D:62","00:1A:2B:3C:4D:63"],"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 a Site.\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 and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled and Tenant Account with Machine's Provider. User must have authorization role with `TENANT_ADMIN` suffix.","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":"","model":"SAMSUNG MZ1L21T9HCLS-00A07","capacityMb":0,"minSizeMiB":7680000,"maxSizeMiB":7680000,"pciPatterns":["^/devices/pci.*nvme0$"],"count":4}],"chassis":{"vendor":"Supermicro","model":"SYS-420GP-TNR"}},"created":"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"]},"post":{"summary":"Create SKU","operationId":"create-sku","description":"Create a SKU.\n\nThe Org must have an Infrastructure Provider that owns the Site. The user must have an authorization role with the `PROVIDER_ADMIN` suffix.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkuCreateRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sku"}}}},"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":"","model":"SAMSUNG MZ1L21T9HCLS-00A07","capacityMb":0,"minSizeMiB":7680000,"maxSizeMiB":7680000,"pciPatterns":["^/devices/pci.*nvme0$"],"count":4}],"chassis":{"vendor":"Supermicro","model":"SYS-420GP-TNR"}},"created":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["SKU"]},"delete":{"summary":"Delete SKU","operationId":"delete-sku","description":"Delete an unused SKU. The Site is determined from the saved SKU record.\n\nThe Org must have an Infrastructure Provider that owns the SKU's Site. The user must have an authorization role with the `PROVIDER_ADMIN` suffix.","responses":{"204":{"description":"No Content"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}},"tags":["SKU"]},"patch":{"summary":"Update SKU","operationId":"update-sku","description":"Update selected mutable fields on a SKU. The Site is determined from the saved SKU record.\n\nFields omitted from the request retain their current values. If a user updates the components field,\nthe schema version will be updated to the current version (5).\n\nThe Org must have an Infrastructure Provider that owns the SKU's Site. The user must have an authorization role with the `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkuUpdateRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sku"}}}},"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 InfiniBand Partitions. 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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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 NVLink Logical Partitions. 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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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"}],"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"}],"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"}],"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\nThe Infrastructure Provider and Tenant 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 Instance Types. 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 Instance Type 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"}],"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"}],"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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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"}],"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 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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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":{"objectId":"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","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":"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":{"objectId":"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","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-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":{"objectId":"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","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-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","deprecated":true,"description":"Filter by Infrastructure Provider ID. Deprecated: Instances will no longer be filtered by Infrastructure Provider; results are scoped to the org's Tenant. Use the siteId parameter to scope results to a specific Infrastructure Provider's Sites."},{"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 Instances. 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 Network Security Group 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"}],"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"},"429":{"$ref":"#/components/responses/ResourceExhaustedError"}},"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"},"429":{"$ref":"#/components/responses/ResourceExhaustedError"}},"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":{"objectId":"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"}],"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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was accepted"}}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"}},"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","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"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"429":{"$ref":"#/components/responses/ResourceExhaustedError"}},"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":false,"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":"List Operating Systems visible to the caller.\n\nUser must have an authorization role with either the `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix for the org.\n\n- Provider admin: returns only Operating Systems owned by the org's Infrastructure Provider.\n- Tenant admin: returns Operating Systems owned by the caller's Tenant, plus Provider-owned Operating Systems that are associated with at least one Site the Tenant can access.\n- Dual-role (both Provider and Tenant): returns the union of the Tenant's and the Provider's Operating Systems.","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","TemplatedIpxe"]},"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\nOwnership is derived from the caller's role:\n\n- Tenant admin (`TENANT_ADMIN`): creates a Tenant-owned Operating System of any type (Image, iPXE, or Templated iPXE).\n- Provider admin (`PROVIDER_ADMIN`): may only create Provider-owned Operating Systems of type `Templated iPXE`.\n\nThe `tenantId` field in the request body is deprecated; if provided, it must match the org's Tenant.","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":false,"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":false,"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.\n\nA Tenant admin may also read a Provider-owned Operating System when it is associated with at least one Site the Tenant can access.","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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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 visible to the caller.\n\nInfrastructure Provider callers receive Machines owned by their Provider. Tenant Admin callers receive Machines only from Sites where `TargetedInstanceCreation` is effective. The siteId query parameter is optional and further restricts either result set.\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"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"}},"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\nFor Infrastructure Providers: Org must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled and Tenant Account with Machine's Provider. User must have authorization role with `TENANT_ADMIN` suffix.\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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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}/bmc/reset":{"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"}],"patch":{"summary":"Reset Machine BMC","tags":["BMC Reset"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BMCResetRequest"}}}},"responses":{"202":{"description":"Machine BMC reset request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Machine BMC reset request was accepted"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"reset-machine-bmc","description":"Reset the BMC of a specific Machine. When an Instance is attached to the\nMachine, `acknowledgeAttachedInstance` must be `true`.\n\nIf `useIpmiTool` is `true`, the BMC reset request may be silently\nignored while the BMC is in lockdown mode.\n\nFor Infrastructure Providers: Org must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled and Tenant Account with Machine's Provider. User must have authorization role with `TENANT_ADMIN` suffix."}},"/v2/org/{org}/nico/machine/{machineId}/dpu/reprovision":{"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"}],"patch":{"summary":"Reprovision Machine DPUs","tags":["DPU Reprovision"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DpuReprovisionRequest"}}}},"responses":{"202":{"description":"DPU reprovisioning request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"DPU reprovisioning request was accepted"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"reprovision-machine-dpu","description":"Trigger DPU reprovisioning for a Machine. Before calling this operation,\ncreate a Machine health report containing an alert whose ID is\n`HostUpdateInProgress` and whose classifications include\n`PreventAllocations`. When an Instance is attached to the Machine,\n`acknowledgeAttachedInstance` must be `true`.\n\nFor Infrastructure Providers: Org must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled and Tenant Account with Machine's Provider. User must have authorization role with `TENANT_ADMIN` suffix."}},"/v2/org/{org}/nico/machine/{machineId}/health-report":{"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 all Machine health reports","tags":["Health Report"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MachineHealthReportEntry"}}}}},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"get-all-machine-health-report","description":"Get all health reports for a specific Machine.\n\nFor Infrastructure Providers: Org must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` or `PROVIDER_VIEWER` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled and Tenant Account with Machine's Provider. User must have authorization role with `TENANT_ADMIN` suffix."},"put":{"summary":"Create or update Machine health report","tags":["Health Report"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MachineHealthReportEntryRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MachineHealthReportEntry"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"create-or-update-machine-health-report","description":"Add or update health report override for a specific Machine.\n\nFor Infrastructure Providers: Org must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled and Tenant Account with Machine's Provider. User must have authorization role with `TENANT_ADMIN` suffix."}},"/v2/org/{org}/nico/machine/{machineId}/health-report/{source}":{"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"},{"schema":{"type":"string"},"name":"source","in":"path","required":true,"description":"Health report source"}],"delete":{"summary":"Delete Machine health report","tags":["Health Report"],"responses":{"204":{"description":"Machine health report was successfully removed"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"delete-machine-health-report","description":"Remove a health report override for a specific Machine.\n\nFor Infrastructure Providers: Org must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nFor Tenants: Org must have a Tenant with `TargetedInstanceCreation` capability enabled and Tenant Account with Machine's Provider. User must have authorization role with `TENANT_ADMIN` suffix."}},"/v2/org/{org}/nico/machine/{machineId}/power":{"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"}],"patch":{"summary":"Machine power control","tags":["Machine"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MachinePowerControlRequest"},"examples":{"turn-on":{"value":{"action":"On"}},"force-restart":{"value":{"action":"ForceRestart"}}}}}},"responses":{"202":{"description":"Machine power control request was accepted. The message is empty unless Core returns a power-manager warning.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":""}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"machine-power-control-machine","description":"Execute power control actions for a specific Machine. When an Instance is\nattached to the Machine, `acknowledgeAttachedInstance` must be `true`.\n\nOrg must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix."}},"/v2/org/{org}/nico/machine/{machineId}/validation/run":{"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 validation runs","tags":["Machine Validation"],"responses":{"200":{"description":"Machine validation runs","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MachineValidationRun"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"get-all-machine-validation-runs","description":"Retrieve validation runs for a specific Machine.\n\nOrg must have an Infrastructure Provider entity that owns the Machine. User must have authorization role with `PROVIDER_ADMIN` suffix."},"post":{"summary":"Create an on-demand Machine validation run","tags":["Machine Validation"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MachineValidationRunCreateRequest"}}}},"responses":{"202":{"description":"On-demand Machine validation request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MachineValidationRun"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"start-machine-validation","description":"Create an on-demand Machine validation run. The Machine must be in a state accepted by NICo Core.\n\nOrg must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix."}},"/v2/org/{org}/nico/machine/{machineId}/validation/result":{"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 validation results","tags":["Machine Validation"],"responses":{"200":{"description":"Machine validation results","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MachineValidationResult"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"get-all-machine-validation-results","description":"Retrieve validation results for a specific Machine.\n\nOrg must have an Infrastructure Provider entity that owns the Machine. User must have authorization role with `PROVIDER_ADMIN` suffix."}},"/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/{machineId}/dpu":{"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 host Machine"}],"get":{"summary":"Retrieve DPU Machines attached to a host Machine","description":"Retrieve DPU Machines attached to the host Machine, including network configuration fields exposed by the REST API. Internal-only and sensitive fields from the Core configuration are omitted.\n\nThe response is built by scheduling a synchronous Temporal `GetDpuMachines` workflow against the Machine's Site for the DPU Machine IDs referenced by the host Machine's interfaces.\n\n**Authorization:**\n\nAccess is restricted to users associated with the Machine's Site. Either of the following grants access:\n\n* The caller's org has an Infrastructure Provider entity that owns the Machine's Site, and the user has authorization role with `PROVIDER_ADMIN` suffix on that org.\n* The caller's org has a Tenant entity with `TargetedInstanceCreation` enabled and an active Tenant Account on the Machine's Site's Infrastructure Provider, and the user has authorization role with `TENANT_ADMIN` suffix on that org.\n","tags":["Machine"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DpuMachine"}},"examples":{"Example 1":{"value":[{"id":"fm100dsg4ekcb4sdi6hkqn0iojhj18okrr8vct64luh8957lfe8e69vme20","infrastructureProviderId":"e94bcfda-f6cb-42e4-80ec-516811e5abbf","siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","hostMachineId":"fm200hkq8xncf7tgm9plurt4smono52pqvv2gxt97pyk2398qjk2a73qjf64","dpuAgentVersion":"1.0.0","state":"Ready","labels":{"env":"prod"},"dpuNetworkConfig":{"asn":65001,"vniDevice":"pf0hpf","managedHostConfigVersion":"v1.2.3","useAdminNetwork":true,"instanceNetworkConfigVersion":"v2.0.1","remoteId":"host-machine-123","vpcIsolationBehavior":"VPC_ISOLATION_MUTUAL","statefulAclsEnabled":true,"enableDhcp":false,"isPrimaryDpu":true,"datacenterAsn":65000,"dhcpServers":["192.168.1.1"],"routeServers":["192.168.2.1"],"managedHostConfig":{"loopbackIp":"10.0.0.1"},"tenantInterfaces":[{"functionType":"VIRTUAL_FUNCTION","vlanId":100,"vni":5000,"gateway":"192.168.10.1","ip":"192.168.10.10","interfacePrefix":"eth0","prefix":"192.168.10.0/24","fqdn":"tenant-vm.example.com","vpcVni":6000,"isL2Segment":false}]}}]}}}}},"400":{"$ref":"#/components/responses/GenericHttpError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/GenericHttpError"},"500":{"$ref":"#/components/responses/GenericHttpError"}},"operationId":"get-dpu-machines"}},"/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 parameters should be specified in the correct order. 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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Rack"]}},"/v2/org/{org}/nico/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-task","description":"Get a Task by UUID.\n\nThe same handler is also mounted at `/v2/org/{org}/nico/rack/task/{id}` for\nbackward compatibility; prefer this path for new clients.\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/Task"},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task"]}},"/v2/org/{org}/nico/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-task","description":"Cancel a Task.\n\nThe same handler is also mounted at `/v2/org/{org}/nico/rack/task/{id}/cancel`\nfor backward compatibility; prefer this path for new clients.\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 authorization role with `PROVIDER_ADMIN` suffix.","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's\nlast known state is returned. Clients should `GET` the task to\nobserve the final state, since cancellation is best-effort and\nthe operation may still be terminating.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Task"},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task"]}},"/v2/org/{org}/nico/task/rule":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create an Operation Rule","operationId":"create-rule","description":"Create a new Operation Rule on the target Site. The rule definition is validated\nserver-side by Flow; on validation failure no state changes (the request acts\nas a dry-run by way of its own validation step).\n\nRules are site-scoped and per (operationType, operationCode) tuple. The response\nechoes the submitted body with the assigned `id`.\n\nOrg must have an Infrastructure Provider entity. User must have authorization\nrole with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRuleRequest"}}}},"responses":{"201":{"description":"Rule was created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationRule"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Rule"]},"get":{"summary":"List Operation Rules","operationId":"list-rules","description":"List Operation Rules on a Site. Filters compose with AND; results are paginated\nand the `X-Pagination` response header reports the total count over the\npost-filter set.\n\nOrg must have an Infrastructure Provider entity. User must have authorization\nrole with `PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site that owns the rules (rules are site-scoped)."},{"schema":{"type":"string","enum":["PowerControl","FirmwareControl"]},"name":"operationType","in":"query","required":false,"description":"Filter by operation type."},{"schema":{"type":"integer","minimum":1},"name":"pageNumber","in":"query","required":false,"description":"Page number of results returned (1-indexed)."},{"schema":{"type":"integer","minimum":1},"name":"pageSize","in":"query","required":false,"description":"Number of results per page."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OperationRule"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Rule"]}},"/v2/org/{org}/nico/task/rule/{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 Rule"}],"get":{"summary":"Retrieve an Operation Rule","operationId":"get-rule","description":"Get an Operation Rule by UUID.\n\nRules are site-scoped; `siteId` must be the Site that owns the rule. Org must\nhave an Infrastructure Provider entity. User must have authorization role with\n`PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site that owns the rule (rules are site-scoped)."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationRule"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Rule"]},"patch":{"summary":"Update an Operation Rule","operationId":"update-rule","description":"Patch the mutable fields of an Operation Rule: `name`, `description`, and\n`ruleDefinition`. Unset fields are left unchanged. The rule definition is\nre-validated server-side; validation failure leaves the rule untouched.\n\n`operationType` and `operationCode` are immutable after creation — create a\nnew rule and delete the old one to change them.\n\nOrg must have an Infrastructure Provider entity. User must have authorization\nrole with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRuleRequest"}}}},"responses":{"204":{"description":"Rule was updated."},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Rule"]},"delete":{"summary":"Delete an Operation Rule","operationId":"delete-rule","description":"Delete an Operation Rule by UUID. Flow rejects deletion of rules that are\nstill associated with a Rack or that are the active default for their\n(operationType, operationCode) tuple; dissociate / un-default first.\n\nRules are site-scoped; `siteId` must be the Site that owns the rule. Org must\nhave an Infrastructure Provider entity. User must have authorization role with\n`PROVIDER_ADMIN` suffix.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site that owns the rule (rules are site-scoped)."}],"responses":{"204":{"description":"Rule was deleted."},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Rule"]}},"/v2/org/{org}/nico/task/run":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"post":{"summary":"Create a Task Run","operationId":"create-task-run","description":"Create a Task Run: a phased, policy-gated execution of one operation across\nmany Racks. The configuration is validated server-side by Flow; on\nvalidation failure no state changes.\n\nA Task Run executes exactly one operation (currently firmware) over a\ncandidate set of Racks, narrowed by an optional `selector` and divided\ninto phases by an optional `options.phasePolicy`. The response echoes the\nassigned `id`; the Task Run always starts in the `Pending` state. Poll\n`GET /task/run/{id}` for progress.\n\nOrg must have an Infrastructure Provider entity. User must have\nauthorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTaskRunRequest"}}}},"responses":{"201":{"description":"Task Run was created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskRun"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task Run"]},"get":{"summary":"Retrieve all Task Runs","operationId":"get-all-task-run","description":"List Task Runs on a Site. Filters compose with AND; results are paginated\nand the `X-Pagination` response header reports the total count over the\npost-filter set.\n\nOrg must have an Infrastructure Provider entity. User must have\nauthorization 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 Runs (Task Runs are site-scoped)."},{"schema":{"type":"string","enum":["Pending","Running","Paused","Completed","Cancelled","Failed","CompletedWithFailures"]},"name":"status","in":"query","required":false,"description":"Filter by Task Run status."},{"schema":{"type":"string","enum":["PowerControl","FirmwareControl"]},"name":"operationType","in":"query","required":false,"description":"Filter by operation type."},{"schema":{"type":"integer","minimum":1},"name":"pageNumber","in":"query","required":false,"description":"Page number of results returned (1-indexed)."},{"schema":{"type":"integer","minimum":1},"name":"pageSize","in":"query","required":false,"description":"Number of results per page."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TaskRun"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":2}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task Run"]}},"/v2/org/{org}/nico/task/run/{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 Run"}],"get":{"summary":"Retrieve a Task Run","operationId":"get-task-run","description":"Get a Task Run by UUID. Set `includeStats=true` for derived per-phase\noutcome counts (current phase and cumulative run).\n\nTask Runs are site-scoped; `siteId` must be the Site that owns the\nTask Run. Org must have an Infrastructure Provider entity. User must have\nauthorization 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 Run (Task Runs are site-scoped)."},{"schema":{"type":"boolean","default":false},"name":"includeStats","in":"query","required":false,"description":"Include derived per-phase outcome stats on the response."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskRun"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task Run"]}},"/v2/org/{org}/nico/task/run/{id}/target":{"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 Run"}],"get":{"summary":"Retrieve all Task Run Targets","operationId":"get-all-task-run-target","description":"List a Task Run's materialized per-Rack execution targets. Each target\nreferences the Task the Task Run submitted for that Rack via `taskId`\n(null until the target is submitted); drill into execution detail via\n`GET /task/{taskId}`.\n\nFilters compose with AND. Results are paginated; the `X-Pagination`\nresponse header reports the total count over the post-filter set.\n\nTask Runs are site-scoped; `siteId` must be the Site that owns the\nTask Run. Org must have an Infrastructure Provider entity. User must have\nauthorization 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 Run."},{"schema":{"type":"string","enum":["Pending","Blocked","Submitted","Completed","Failed","Terminated","Skipped","Claimed"]},"name":"status","in":"query","required":false,"description":"Filter by target status."},{"schema":{"type":"string","enum":["currentPhase","completedPhases","currentAndCompletedPhases"],"default":"currentPhase"},"name":"phaseScope","in":"query","required":false,"description":"Restrict targets to the current phase, completed phases, or both."},{"schema":{"type":"integer","minimum":1},"name":"pageNumber","in":"query","required":false,"description":"Page number of results returned (1-indexed)."},{"schema":{"type":"integer","minimum":1},"name":"pageSize","in":"query","required":false,"description":"Number of results per page."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TaskRunTarget"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":6}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task Run"]}},"/v2/org/{org}/nico/task/run/{id}/pause":{"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 Run"}],"post":{"summary":"Pause a Task Run","operationId":"pause-task-run","description":"Pause a running Task Run. In-flight target Tasks continue to completion;\nno new targets are claimed until the Task Run is resumed. Pausing an\nalready-paused Task Run is idempotent.\n\nTask Runs are site-scoped; `siteId` must be the Site that owns the\nTask Run. Org must have an Infrastructure Provider entity. User must have\nauthorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskRunSiteRequest"}}}},"responses":{"202":{"description":"Accepted. The pause request was accepted and the Task Run's last\nknown state is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskRun"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task Run"]}},"/v2/org/{org}/nico/task/run/{id}/resume":{"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 Run"}],"post":{"summary":"Resume a Task Run","operationId":"resume-task-run","description":"Resume an operator-paused Task Run. A Task Run paused at a phase gate\n(rather than by an operator) must be advanced with the advance endpoint\ninstead; resume applies only to operator pauses.\n\nTask Runs are site-scoped; `siteId` must be the Site that owns the\nTask Run. Org must have an Infrastructure Provider entity. User must have\nauthorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskRunSiteRequest"}}}},"responses":{"202":{"description":"Accepted. The resume request was accepted and the Task Run's last\nknown state is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskRun"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task Run"]}},"/v2/org/{org}/nico/task/run/{id}/advance":{"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 Run"}],"post":{"summary":"Advance a Task Run to its next phase","operationId":"advance-task-run","description":"Open the next phase of a Task Run that is paused at a phase gate.\nOptionally guard the transition with `expectedPhaseIndex`: when set, the\nphase that would be opened must match, otherwise Flow rejects the advance\nso a stale client cannot open the wrong phase.\n\nTask Runs are site-scoped; `siteId` must be the Site that owns the\nTask Run. Org must have an Infrastructure Provider entity. User must have\nauthorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvanceTaskRunRequest"}}}},"responses":{"202":{"description":"Accepted. The advance request was accepted and the Task Run's last\nknown state is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskRun"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task Run"]}},"/v2/org/{org}/nico/task/run/{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 Run"}],"post":{"summary":"Cancel a Task Run","operationId":"cancel-task-run","description":"Cancel a Task Run. Best-effort cancellation cascades to the current\nphase's in-flight target Tasks; targets not yet claimed are not started.\nCancelling an already-terminal Task Run returns its last known state.\n\nTask Runs are site-scoped; `siteId` must be the Site that owns the\nTask Run. Org must have an Infrastructure Provider entity. User must have\nauthorization role with `PROVIDER_ADMIN` suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelTaskRunRequest"}}}},"responses":{"202":{"description":"Accepted. The cancellation request was accepted and the Task Run's\nlast known state is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskRun"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Task Run"]}},"/v2/org/{org}/nico/rack/{id}/task":{"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 Rack"}],"get":{"summary":"Retrieve all Tasks for a Rack","operationId":"get-rack-tasks","description":"List Tasks targeting the specified Rack.\n\nTasks are site-scoped; `siteId` must be the Site that owns the Rack. Org must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nFilters compose with AND: setting `activeOnly=true` restricts the result to tasks that are still in a non-terminal state (`Pending`, `Running`, `Waiting`). Results are paginated; the `X-Pagination` response header reports the total count over the post-filter set.\n\nBy default the `report` field is omitted from each task in the response. Set `includeReport=true` to include it; this is opt-in because report bodies can be several KB and pulling them across the list path persists the full payload in each caller-side workflow record. Single-task `GET /rack/task/{id}` and `POST /rack/task/{id}/cancel` always include the report.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site that owns the Rack."},{"schema":{"type":"boolean","default":false},"name":"activeOnly","in":"query","description":"Restrict results to non-terminal Tasks."},{"schema":{"type":"boolean","default":false},"name":"includeReport","in":"query","description":"Include the per-task execution report on each returned task."},{"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"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Task"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":2}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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\n- `slotId` restricts to trays at that rack slot, requires `rackId` or `rackName`, and composes with the rest of the query via AND","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","format":"int32","minimum":0},"name":"slotId","in":"query","description":"Restrict to trays at this rack slot (matches `position.slotId`). Requires `rackId` or `rackName`. Composes with the rest of the filter via AND."},{"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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)"},{"schema":{"type":"integer","format":"int32","minimum":0},"name":"slotId","in":"query","required":false,"description":"Restrict validation to trays at this rack slot (matches `position.slotId`). Requires `rackId` or `rackName`. Composes with the rest of the filter via AND."}],"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"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"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/tray/{id}/task":{"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 Tray"}],"get":{"summary":"Retrieve all Tasks for a Tray","operationId":"get-tray-tasks","description":"List Tasks targeting the specified Tray.\n\nTasks are site-scoped; `siteId` must be the Site that owns the Tray. Org must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.\n\nFilters compose with AND: setting `activeOnly=true` restricts the result to tasks that are still in a non-terminal state (`Pending`, `Running`, `Waiting`). Results are paginated; the `X-Pagination` response header reports the total count over the post-filter set.\n\nBy default the `report` field is omitted from each task in the response. Set `includeReport=true` to include it; this is opt-in because report bodies can be several KB and pulling them across the list path persists the full payload in each caller-side workflow record. Single-task `GET /rack/task/{id}` and `POST /rack/task/{id}/cancel` always include the report.","parameters":[{"schema":{"type":"string","format":"uuid"},"name":"siteId","in":"query","required":true,"description":"ID of the Site that owns the Tray."},{"schema":{"type":"boolean","default":false},"name":"activeOnly","in":"query","description":"Restrict results to non-terminal Tasks."},{"schema":{"type":"boolean","default":false},"name":"includeReport","in":"query","description":"Include the per-task execution report on each returned task."},{"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"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Task"}}}},"headers":{"X-Pagination":{"schema":{"type":"string","example":"{\"pageNumber\":1,\"pageSize\":20,\"total\":2}"},"description":"Pagination result in JSON format"}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"504":{"$ref":"#/components/responses/GatewayTimeoutError"}},"tags":["Tray"]}},"/v2/org/{org}/nico/ipxe-template":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"get":{"summary":"Get all iPXE templates","description":"Get all iPXE templates propagated from nico-core. Optionally restrict to one or more sites with the siteId query parameter.\n\nThe Infrastructure Provider and Tenant are inferred from the org's membership. User must have authorization role with `PROVIDER_ADMIN`, `PROVIDER_VIEWER`, or `TENANT_ADMIN` suffix.","operationId":"get-all-ipxe-template","tags":["iPXE Template"],"parameters":[{"schema":{"type":"array","items":{"type":"string","format":"uuid"}},"name":"siteId","in":"query","required":false,"description":"Optional site ID(s); may be repeated to restrict results to templates available at any of the sites"},{"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","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/IpxeTemplate"}}}},"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"}}}},"/v2/org/{org}/nico/ipxe-template/{ipxeTemplateId}":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"},{"schema":{"type":"string","format":"uuid"},"name":"ipxeTemplateId","in":"path","required":true,"description":"Stable template ID (UUID from core)"}],"get":{"summary":"Retrieve an iPXE template","description":"Retrieve an iPXE template by its stable core ID. The caller must be authorized for at least one Site at which the template is available.\n\nThe Infrastructure Provider and Tenant are inferred from the org's membership. User must have authorization role with `PROVIDER_ADMIN`, `PROVIDER_VIEWER`, or `TENANT_ADMIN` suffix.","operationId":"get-ipxe-template","tags":["iPXE Template"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IpxeTemplate"}}}},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"}}}},"/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 Network Security Groups. 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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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 DPU Extension Services. Input will be matched against name, description, and status fields"},{"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 SSH Key Groups. Input will be matched against the 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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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 SSH Keys. Input will be matched against the 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":"Deletion request was accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageResponse"},"examples":{"example-1":{"value":{"message":"Deletion request was 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"}}}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"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"}}}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"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"}},"/v2/org/{org}/nico/firmware-config/host":{"parameters":[{"schema":{"type":"string"},"name":"org","in":"path","required":true,"description":"Name of the Org"}],"put":{"summary":"Create or Update Host Firmware Config","tags":["Host Firmware Config"],"operationId":"create-or-update-host-firmware-config","description":"Create or update host firmware config for the org/site. The target Site\nis specified by `siteId` in the request body.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix in the URL `{org}`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostFirmwareConfigCreateOrUpdateRequest"}}}},"responses":{"200":{"description":"Host firmware config replaced/updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostFirmwareConfig"}}}},"201":{"description":"Host firmware config created on first call","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostFirmwareConfig"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while loading the Provider or Site, contacting the Core gRPC API, starting the Host Firmware Config create or update workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"$ref":"#/components/responses/HostFirmwareConfigCoreUnavailable"}}},"delete":{"summary":"Delete Host Firmware Config","tags":["Host Firmware Config"],"operationId":"delete-host-firmware-config","description":"Delete host firmware config for the org/site. The target Site is\nspecified by `siteId` in the request body; the configuration is\nkeyed by `(vendor, model)`.\n\nUser must have authorization role with `PROVIDER_ADMIN` suffix in the URL `{org}`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HostFirmwareConfigDeleteRequest"}}}},"responses":{"204":{"description":"Host firmware config deleted"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while loading the Provider or Site, contacting the Core gRPC API, starting the Host Firmware Config delete workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"$ref":"#/components/responses/HostFirmwareConfigCoreUnavailable"}}}},"/v2/org/{org}/nico/site/{siteID}/tenant-identity/config":{"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"}],"put":{"summary":"Create or Update Tenant Identity Configuration","tags":["Tenant Identity"],"operationId":"create-or-update-tenant-identity-config","description":"Create or update tenant identity (JWT-SVID) configuration for the org/site.\n\nUser must have authorization role with `TENANT_ADMIN` suffix in the URL `{org}`.\n\nOn first call the Core gRPC API generates a new ES256 signing\nkeypair; on subsequent calls the existing keypair is reused unless\n`rotateKey: true` is supplied. Returns `201 Created` on first\ncall, `200 OK` on subsequent updates. See the Tenant Identity tag\ndescription for upsert semantics and the `enabled` vs DELETE\ndistinction.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityConfigCreateOrUpdateRequest"}}}},"responses":{"200":{"description":"Tenant identity configuration replaced/updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityConfig"}}}},"201":{"description":"Tenant identity configuration created on first call","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityConfig"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while loading the Tenant or Site, contacting the Core gRPC API, starting the configuration workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"$ref":"#/components/responses/TenantIdentityCoreUnavailable"}}},"get":{"summary":"Retrieve Tenant Identity Configuration for current Org","tags":["Tenant Identity"],"operationId":"get-tenant-identity-config","description":"Retrieve the tenant identity configuration and signing key metadata.\n\nUser must have authorization role with `TENANT_ADMIN` suffix in the URL `{org}`.\n\nThe response reflects the stored configuration. Fields you\nomitted on PUT may be filled in by Core: `allowedAudiences`\ndefaults to `[defaultAudience]`, and `subjectPrefix` defaults\nto the issuer's trust domain. `signingKeys` lists one entry\nnormally, or two during a key-rotation overlap.","responses":{"200":{"description":"Tenant identity configuration retrieved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityConfig"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while loading the Tenant or Site, contacting the Core gRPC API, starting the get workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"$ref":"#/components/responses/TenantIdentityCoreUnavailable"}}},"delete":{"summary":"Delete Tenant Identity Configuration","tags":["Tenant Identity"],"operationId":"delete-tenant-identity-config","description":"Delete the tenant identity configuration and destroy the per-org signing keypair.\n\nUser must have authorization role with `TENANT_ADMIN` suffix in the URL `{org}`.\n\nAfter DELETE, JWKS and OIDC discovery for this org begin returning\n`404`; previously-issued JWT-SVIDs become unverifiable once\nconsumers refresh their JWKS cache. To pause issuance without\ndestroying signing keys, PUT with `enabled: false` instead.","responses":{"204":{"description":"Tenant identity configuration deleted"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while loading the Tenant or Site, contacting the Core gRPC API, starting the delete workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"$ref":"#/components/responses/TenantIdentityCoreUnavailable"}}}},"/v2/org/{org}/nico/site/{siteID}/tenant-identity/token-delegation":{"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"}],"put":{"summary":"Create or Update Token Delegation","tags":["Tenant Identity"],"operationId":"create-or-update-tenant-identity-token-delegation","description":"Register an RFC 8693 token exchange callback for the tenant. When\nconfigured, the Core gRPC API issues a short-lived intermediate\nJWT-SVID to the tenant's exchange server instead of signing\nworkload tokens directly.\n\nUser must have authorization role with `TENANT_ADMIN` suffix in the URL `{org}`.\n\nRequires a pre-existing `/tenant-identity/config` on this org/site\n(returns `404` otherwise). Because PUT is full-replace, omitting\n`clientSecretBasic` on an update clears any stored credentials\nand switches the org back to no-auth; re-supply `clientId` /\n`clientSecret` on every PUT to keep basic auth (the raw secret\nis never returned by GET). Returns `201 Created` on first call,\n`200 OK` on subsequent updates.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityTokenDelegationCreateOrUpdateRequest"}}}},"responses":{"200":{"description":"Token delegation replaced/updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityTokenDelegation"}}}},"201":{"description":"Token delegation created on first call","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityTokenDelegation"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"description":"Returned when the org has no tenant identity configuration on\nthis site yet; create it via PUT `/tenant-identity/config` before\nregistering a token-delegation callback.","$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while loading the Tenant or Site, contacting the Core gRPC API, starting the token-delegation update workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"$ref":"#/components/responses/TenantIdentityCoreUnavailable"}}},"get":{"summary":"Retrieve Token Delegation for current Org","tags":["Tenant Identity"],"operationId":"get-tenant-identity-token-delegation","description":"Retrieve the registered token exchange callback for the tenant.\n\nUser must have authorization role with `TENANT_ADMIN` suffix in the URL `{org}`.\n\nThe raw `clientSecret` is never returned; only its SHA-256 hash.","responses":{"200":{"description":"Token delegation retrieved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityTokenDelegation"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while loading the Tenant or Site, contacting the Core gRPC API, starting the token-delegation get workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"$ref":"#/components/responses/TenantIdentityCoreUnavailable"}}},"delete":{"summary":"Delete Token Delegation","tags":["Tenant Identity"],"operationId":"delete-tenant-identity-token-delegation","description":"Delete the RFC 8693 token exchange callback for the tenant.\n\nUser must have authorization role with `TENANT_ADMIN` suffix in the URL `{org}`.\n\nSubsequent Instance Metadata Service requests for the tenant revert to direct (non-delegated) signing by the Core gRPC API.","responses":{"204":{"description":"Token delegation deleted"},"400":{"$ref":"#/components/responses/ValidationError"},"403":{"$ref":"#/components/responses/ForbiddenError"},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while loading the Tenant or Site, contacting the Core gRPC API, starting the token-delegation delete workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"$ref":"#/components/responses/TenantIdentityCoreUnavailable"}}}},"/v2/org/{org}/nico/site/{siteID}/.well-known/jwks.json":{"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 OIDC JWKS for current Org","tags":["Tenant Identity"],"operationId":"get-jwks","description":"Public RFC 7517 JSON Web Key Set for JWT-SVID signature verification (`use: sig`). No authentication required.\n\nNICo currently issues `ES256` signatures over `P-256` keys.\nReturns `404 Not Found` when no identity configuration exists\nfor this org/site, and `502 Bad Gateway` when the Core gRPC API\nreturns a malformed body. See the Tenant Identity tag\ndescription for consumer guidance during key rotation.","security":[],"responses":{"200":{"description":"JWKS document.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityJWKS"}}}},"404":{"description":"No identity configuration exists for this org/site.","$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while resolving the Site or Tenant, retrieving the Temporal client, starting the JWKS workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"502":{"description":"Core gRPC API returned a malformed JWKS body that could not be parsed as a keyset.","$ref":"#/components/responses/GenericHttpError"},"503":{"description":"Core gRPC API is unavailable.","$ref":"#/components/responses/GenericHttpError"}}}},"/v2/org/{org}/nico/site/{siteID}/.well-known/openid-configuration":{"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 OpenID Configuration for current Org","tags":["Tenant Identity"],"operationId":"get-openid-configuration","description":"Public OIDC discovery document pointing at the JWKS URIs. No authentication required.\n\n`id_token_signing_alg_values_supported` is intentionally empty\nbecause NICo issues bearer access JWTs, not OIDC `id_token`s;\nstrict OIDC client libraries that require a non-empty algorithm\nlist will reject this document. Use the JWKS endpoint directly\nfor signature verification. Returns `404` when no identity\nmaterial exists for this org/site.","security":[],"responses":{"200":{"description":"OpenID discovery document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenIDConfiguration"}}}},"404":{"$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while resolving the Site or Tenant, retrieving the Temporal client, starting the OpenID Configuration workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"503":{"description":"Core gRPC API is unavailable.","$ref":"#/components/responses/GenericHttpError"}}}},"/v2/org/{org}/nico/site/{siteID}/.well-known/spiffe/jwks.json":{"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 SPIFFE JWKS for current Org","tags":["Tenant Identity"],"operationId":"get-spiffe-jwks","description":"SPIFFE trust-domain JWKS — same key material as the OIDC JWKS but with `use: jwt-svid` for SPIFFE-native verifiers. No authentication required.\n\nNot-configured and malformed-body behavior matches the OIDC JWKS endpoint.","security":[],"responses":{"200":{"description":"SPIFFE JWKS document.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantIdentityJWKS"}}}},"404":{"description":"No identity configuration exists for this org/site.","$ref":"#/components/responses/NotFoundError"},"500":{"description":"Internal server error while resolving the Site or Tenant, retrieving the Temporal client, starting the SPIFFE JWKS workflow, or after the workflow timed out and was terminated.","$ref":"#/components/responses/GenericHttpError"},"502":{"description":"Core gRPC API returned a malformed SPIFFE JWKS body that could not be parsed as a keyset.","$ref":"#/components/responses/GenericHttpError"},"503":{"description":"Core gRPC API is unavailable.","$ref":"#/components/responses/GenericHttpError"}}}}},"components":{"schemas":{"MeasuredBootTrustedMachineCreateRequest":{"type":"object","title":"MeasuredBootTrustedMachineCreateRequest","description":"Request to approve a Machine for automatic promotion of measured-boot reports.","required":["siteId","machineId","approvalType"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the approval applies."},"machineId":{"type":"string","description":"Machine UUID, or `*` to approve all Machines at the Site."},"approvalType":{"type":"string","enum":["Oneshot","Persist"],"description":"Whether the approval is consumed once or persists for future reports."},"pcrRegisters":{"type":"string","description":"Optional comma-separated PCR register selector. All registers are used when omitted."},"comments":{"type":"string","description":"Optional operator comments about the approval."}}},"MeasuredBootTrustedMachine":{"type":"object","title":"MeasuredBootTrustedMachine","description":"A measured-boot trusted Machine approval.","required":["approvalId","machineId","approvalType","pcrRegisters","comments","created"],"properties":{"approvalId":{"type":"string","format":"uuid","description":"Unique approval ID."},"machineId":{"type":"string","description":"Machine UUID, or `*` when the approval applies to all Machines."},"approvalType":{"type":"string","enum":["Oneshot","Persist"],"description":"Whether the approval is consumed once or persists for future reports."},"pcrRegisters":{"type":"string","description":"Optional comma-separated PCR register selector."},"comments":{"type":"string","description":"Optional operator comments about the approval."},"created":{"type":["string","null"],"format":"date-time","description":"Time when the approval was created, or null when Core did not return a timestamp."}}},"MeasuredBootTrustedProfileCreateRequest":{"type":"object","title":"MeasuredBootTrustedProfileCreateRequest","description":"Request to approve a system profile for automatic promotion of measured-boot reports.","required":["siteId","profileId","approvalType"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the approval applies."},"profileId":{"type":"string","format":"uuid","description":"ID of the measured-boot system profile."},"approvalType":{"type":"string","enum":["Oneshot","Persist"],"description":"Whether the approval is consumed once or persists for future reports."},"pcrRegisters":{"type":"string","description":"Optional comma-separated PCR register selector. All registers are used when omitted."},"comments":{"type":"string","description":"Optional operator comments about the approval."}}},"MeasuredBootTrustedProfile":{"type":"object","title":"MeasuredBootTrustedProfile","description":"A measured-boot trusted system profile approval.","required":["approvalId","profileId","approvalType","pcrRegisters","comments","created"],"properties":{"approvalId":{"type":"string","format":"uuid","description":"Unique approval ID."},"profileId":{"type":"string","format":"uuid","description":"ID of the measured-boot system profile."},"approvalType":{"type":"string","enum":["Oneshot","Persist"],"description":"Whether the approval is consumed once or persists for future reports."},"pcrRegisters":{"type":"string","description":"Optional comma-separated PCR register selector."},"comments":{"type":"string","description":"Optional operator comments about the approval."},"created":{"type":["string","null"],"format":"date-time","description":"Time when the approval was created, or null when Core did not return a timestamp."}}},"BMCCredentialRequest":{"type":"object","title":"BMCCredentialRequest","description":"Request to create or update a BMC credential.","required":["siteId","kind","password"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the credential is stored."},"kind":{"type":"string","description":"Which BMC credential to store.","enum":["SiteWideRoot","BMCRoot"]},"password":{"type":"string","minLength":1,"description":"Credential password."},"username":{"type":"string","description":"Optional username; Core defaults to \"root\" for BMCRoot when omitted."},"macAddress":{"type":"string","description":"BMC MAC address. Required for kind BMCRoot, ignored for SiteWideRoot."}}},"BMCCredential":{"type":"object","title":"BMCCredential","description":"BMC credential metadata returned after create or update. Password is never returned.","required":["siteId","kind"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the credential is stored."},"kind":{"type":"string","description":"Which BMC credential was stored.","enum":["SiteWideRoot","BMCRoot"]},"username":{"type":"string","description":"Optional username; Core defaults to \"root\" for BMCRoot when omitted."},"macAddress":{"type":"string","description":"BMC MAC address. Required for kind BMCRoot, ignored for SiteWideRoot."}}},"UEFICredentialRequest":{"type":"object","title":"UEFICredentialRequest","description":"Request to create a site-default UEFI credential.","required":["siteId","kind","password"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the credential is stored."},"kind":{"type":"string","description":"Which site-default UEFI credential to create.","enum":["Host","DPU"]},"password":{"type":"string","minLength":1,"description":"Credential password."}}},"UEFICredential":{"type":"object","title":"UEFICredential","description":"UEFI credential metadata returned after creation. The password is never returned.","required":["siteId","kind"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the credential is stored."},"kind":{"type":"string","description":"Which site-default UEFI credential was created.","enum":["Host","DPU"]}}},"CredentialRotationRequest":{"type":"object","title":"CredentialRotationRequest","description":"Request to stage a site-wide credential rotation.","required":["siteId","credentialType"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site whose credential family is rotated."},"credentialType":{"type":"string","description":"Credential family to rotate.","enum":["BMC","HostUEFI","DPUUEFI","NVOS","LockdownIKM"]},"password":{"type":"string","minLength":1,"description":"Explicit rotate-to password. When omitted, a strong password is auto-generated. Never returned."},"reason":{"type":"string","description":"Free-form operator note recorded with the rotation. Must not contain secrets."}}},"CredentialRotationResult":{"type":"object","title":"CredentialRotationResult","description":"Result returned when a credential rotation is staged. The password is never returned.","required":["credentialType","targetVersion"],"properties":{"credentialType":{"type":"string","description":"Credential family that was rotated.","enum":["BMC","HostUEFI","DPUUEFI","NVOS","LockdownIKM"]},"targetVersion":{"type":"integer","format":"int64","description":"Newly published site-wide target version that devices converge to."},"started":{"type":["string","null"],"format":"date-time","description":"When the rotation was staged."}}},"CredentialRotationStatus":{"type":"object","title":"CredentialRotationStatus","description":"Convergence status of an in-flight or completed site-wide credential rotation.","required":["targetVersion","converged","pending","quarantined","complete"],"properties":{"targetVersion":{"type":"integer","format":"int64","description":"Current site-wide target version for this family."},"converged":{"type":"integer","format":"int64","description":"Number of devices at or beyond the target version."},"pending":{"type":"integer","format":"int64","description":"Number of devices not yet converged and eligible to rotate."},"quarantined":{"type":"integer","format":"int64","description":"Number of devices currently in a rotation backoff window."},"quarantinedDeviceMacs":{"type":["array","null"],"items":{"type":"string"},"description":"MAC addresses of the quarantined devices."},"started":{"type":["string","null"],"format":"date-time","description":"When the current target version was staged."},"complete":{"type":"boolean","description":"True only when every device in the queried set has reached the target with none pending and none quarantined."},"device":{"$ref":"#/components/schemas/DeviceCredentialRotationStatus"}}},"DeviceCredentialRotationStatus":{"type":"object","title":"DeviceCredentialRotationStatus","description":"Per-device convergence detail, returned only for a MAC-targeted status query.","required":["deviceMac","converged","quarantined","rotateAttempts"],"properties":{"deviceMac":{"type":"string","description":"The device this status describes."},"currentVersion":{"type":["integer","null"],"format":"int64","description":"Credential version live on the hardware. Null when not yet established."},"rotatingToVersion":{"type":["integer","null"],"format":"int64","description":"Set while a rotation is mid-flight on this device."},"converged":{"type":"boolean","description":"True once the current version reaches the site-wide target."},"quarantined":{"type":"boolean","description":"True while the device is in a rotation backoff window."},"quarantinedUntil":{"type":["string","null"],"format":"date-time","description":"When the current backoff window expires; set only while quarantined."},"rotateAttempts":{"type":"integer","format":"int64","description":"Number of rotation attempts recorded for this device."},"lastAttempted":{"type":["string","null"],"format":"date-time","description":"When the last rotation attempt ran; null if none."},"lastError":{"type":["string","null"],"description":"Redacted last-error string for observability; never a secret."}}},"SiteExplorerEndpointActionRequest":{"type":"object","title":"SiteExplorerEndpointActionRequest","description":"Request to trigger a Site Explorer action for explored endpoints.","required":["siteId","action","target"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site whose explored endpoints are targeted."},"action":{"type":"string","description":"Site Explorer endpoint action to trigger.","enum":["ClearError","ReExplore"]},"target":{"type":"string","description":"Endpoint set to target.","enum":["All","EndpointIds"]},"endpointIds":{"type":"array","description":"BMC IP addresses to target when target is EndpointIds.","items":{"type":"string"}}}},"SiteExplorerEndpointAction":{"type":"object","title":"SiteExplorerEndpointAction","description":"Completed Site Explorer endpoint action.","required":["siteId","action","target","endpointIds"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site whose explored endpoints were targeted."},"action":{"type":"string","description":"Site Explorer endpoint action that completed.","enum":["ClearError","ReExplore"]},"target":{"type":"string","description":"Endpoint set that was selected.","enum":["All","EndpointIds"]},"endpointIds":{"type":"array","description":"BMC IP addresses for which the action completed.","items":{"type":"string"}}}},"ExploredEndpoint":{"type":"object","title":"ExploredEndpoint","description":"An endpoint discovered and tracked by Site Explorer.","required":["address","reportVersion","explorationRequested","preingestionState","lastRedfishBmcReset","lastIpmitoolBmcReset","lastRedfishReboot","lastRedfishPowercycle","pauseRemediation"],"properties":{"address":{"type":"string","description":"BMC IP address used as the explored endpoint ID."},"report":{"$ref":"#/components/schemas/EndpointExplorationReport"},"reportVersion":{"type":"string","description":"Version of the exploration report; increases when the report is updated."},"explorationRequested":{"type":"boolean","description":"Whether the endpoint will be explored in the next Site Explorer run."},"preingestionState":{"type":"string","description":"Current preingestion state for the endpoint."},"lastRedfishBmcReset":{"type":"string","description":"Last BMC Redfish reset time."},"lastIpmitoolBmcReset":{"type":"string","description":"Last BMC IPMI tool reset time."},"lastRedfishReboot":{"type":"string","description":"Last BMC Redfish reboot time."},"lastRedfishPowercycle":{"type":"string","description":"Last BMC Redfish power-cycle time."},"pauseRemediation":{"type":"boolean","description":"When true, Site Explorer will not take remediation actions for Redfish errors."}}},"EndpointExplorationReport":{"type":"object","title":"EndpointExplorationReport","description":"Data gathered about an endpoint during site exploration.","required":["endpointType"],"properties":{"endpointType":{"type":"string","description":"Type of the explored endpoint."},"lastExplorationError":{"type":["string","null"],"description":"Last exploration error serialized as JSON, when present."},"machineId":{"type":["string","null"],"format":"uuid","description":"Machine ID derived for the endpoint when available."},"lastExplorationLatency":{"type":["string","null"],"description":"Go duration string for the last exploration latency (for example `1.5s`)."},"vendor":{"type":["string","null"],"description":"Vendor reported by Redfish."},"managers":{"type":"array","items":{"$ref":"#/components/schemas/ExploredManager"}},"systems":{"type":"array","items":{"$ref":"#/components/schemas/ExploredComputerSystem"}},"chassis":{"type":"array","items":{"$ref":"#/components/schemas/ExploredChassis"}},"service":{"type":"array","items":{"$ref":"#/components/schemas/ExploredService"}},"machineSetupStatus":{"$ref":"#/components/schemas/ExploredMachineSetupStatus"},"secureBootStatus":{"$ref":"#/components/schemas/ExploredSecureBootStatus"},"lockdownStatus":{"$ref":"#/components/schemas/ExploredLockdownStatus"},"firmwareVersions":{"type":"object","additionalProperties":{"type":"string"},"description":"Parsed firmware component versions keyed by component name."},"lastExplorationErrorSchema":{"$ref":"#/components/schemas/OperatorErrorSchema"}}},"OperatorErrorSchema":{"type":"object","title":"OperatorErrorSchema","description":"Structured exploration error for operator tooling.","required":["errorCode","text"],"properties":{"errorCode":{"type":"string","description":"Stable identifier for alerting and log filtering."},"mitigation":{"type":["string","null"],"description":"Suggested operator action when known."},"text":{"type":"string","description":"Human-readable problem description."}}},"ExploredManager":{"type":"object","title":"ExploredManager","description":"Redfish Manager reported during exploration.","required":["id"],"properties":{"id":{"type":"string"},"ethernetInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/ExploredEthernetInterface"}}}},"ExploredComputerSystem":{"type":"object","title":"ExploredComputerSystem","description":"Redfish ComputerSystem reported during exploration.","required":["id","powerState"],"properties":{"id":{"type":"string"},"manufacturer":{"type":["string","null"]},"model":{"type":["string","null"]},"serialNumber":{"type":["string","null"]},"attributes":{"$ref":"#/components/schemas/ExploredComputerSystemAttributes"},"ethernetInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/ExploredEthernetInterface"}},"pcieDevices":{"type":"array","items":{"$ref":"#/components/schemas/ExploredPCIeDevice"}},"powerState":{"type":"string","enum":["On","Off","PoweringOff","PoweringOn","Paused","Unknown","Hibernating","Sleeping"]},"bootOrder":{"$ref":"#/components/schemas/ExploredBootOrder"}}},"ExploredComputerSystemAttributes":{"type":"object","title":"ExploredComputerSystemAttributes","description":"ComputerSystem attributes from Redfish.","properties":{"nicMode":{"type":["string","null"],"enum":["Dpu","Nic","Unknown",null]}}},"ExploredEthernetInterface":{"type":"object","title":"ExploredEthernetInterface","description":"Redfish EthernetInterface reported during exploration.","properties":{"id":{"type":["string","null"]},"description":{"type":["string","null"]},"interfaceEnabled":{"type":["boolean","null"]},"macAddress":{"type":["string","null"]},"linkStatus":{"type":["string","null"]}}},"ExploredChassis":{"type":"object","title":"ExploredChassis","description":"Redfish Chassis reported during exploration.","required":["id"],"properties":{"id":{"type":"string"},"networkAdapters":{"type":"array","items":{"$ref":"#/components/schemas/ExploredNetworkAdapter"}},"manufacturer":{"type":["string","null"]},"model":{"type":["string","null"]},"partNumber":{"type":["string","null"]},"serialNumber":{"type":["string","null"]}}},"ExploredNetworkAdapter":{"type":"object","title":"ExploredNetworkAdapter","description":"Redfish NetworkAdapter reported during exploration.","required":["id"],"properties":{"id":{"type":"string"},"manufacturer":{"type":["string","null"]},"model":{"type":["string","null"]},"partNumber":{"type":["string","null"]},"serialNumber":{"type":["string","null"]}}},"ExploredService":{"type":"object","title":"ExploredService","description":"Redfish UpdateService reported during exploration.","required":["id"],"properties":{"id":{"type":"string"},"inventories":{"type":"array","items":{"$ref":"#/components/schemas/ExploredInventory"}}}},"ExploredInventory":{"type":"object","title":"ExploredInventory","description":"Firmware inventory entry from a Redfish UpdateService.","required":["id"],"properties":{"id":{"type":"string"},"description":{"type":["string","null"]},"version":{"type":["string","null"]},"releaseDate":{"type":["string","null"]}}},"ExploredMachineSetupStatus":{"type":"object","title":"ExploredMachineSetupStatus","description":"Result of a Redfish machine-setup check.","required":["isDone"],"properties":{"isDone":{"type":"boolean"},"diffs":{"type":"array","items":{"$ref":"#/components/schemas/ExploredMachineSetupDiff"}},"evaluatedBootInterface":{"$ref":"#/components/schemas/ExploredMachineBootInterfaceTarget"}}},"ExploredMachineBootInterfaceTarget":{"type":"object","title":"ExploredMachineBootInterfaceTarget","description":"Boot-interface target assessed during exploration.","properties":{"pair":{"$ref":"#/components/schemas/ExploredMachineBootInterfacePair"},"macOnly":{"type":["string","null"]}}},"ExploredMachineBootInterfacePair":{"type":"object","title":"ExploredMachineBootInterfacePair","description":"MAC and Redfish EthernetInterface.Id pair.","required":["macAddress","interfaceId"],"properties":{"macAddress":{"type":"string"},"interfaceId":{"type":"string"}}},"ExploredMachineSetupDiff":{"type":"object","title":"ExploredMachineSetupDiff","description":"One expected-vs-actual machine-setup difference.","required":["key","expected","actual"],"properties":{"key":{"type":"string"},"expected":{"type":"string"},"actual":{"type":"string"}}},"ExploredPCIeDevice":{"type":"object","title":"ExploredPCIeDevice","description":"Redfish PCIe device reported during exploration.","properties":{"description":{"type":["string","null"]},"firmwareVersion":{"type":["string","null"]},"gpuVendor":{"type":["string","null"]},"id":{"type":["string","null"]},"manufacturer":{"type":["string","null"]},"name":{"type":["string","null"]},"partNumber":{"type":["string","null"]},"serialNumber":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/ExploredSystemStatus"}}},"ExploredSystemStatus":{"type":"object","title":"ExploredSystemStatus","description":"Redfish health and state status.","required":["state"],"properties":{"health":{"type":["string","null"]},"healthRollup":{"type":["string","null"]},"state":{"type":"string"}}},"ExploredBootOrder":{"type":"object","title":"ExploredBootOrder","description":"Redfish boot order list.","properties":{"bootOrder":{"type":"array","items":{"$ref":"#/components/schemas/ExploredBootOption"}}}},"ExploredBootOption":{"type":"object","title":"ExploredBootOption","description":"One Redfish boot option.","required":["displayName","id"],"properties":{"displayName":{"type":"string"},"id":{"type":"string"},"bootOptionEnabled":{"type":["boolean","null"]},"uefiDevicePath":{"type":["string","null"]}}},"ExploredSecureBootStatus":{"type":"object","title":"ExploredSecureBootStatus","description":"Redfish secure-boot status.","required":["isEnabled"],"properties":{"isEnabled":{"type":"boolean"}}},"ExploredLockdownStatus":{"type":"object","title":"ExploredLockdownStatus","description":"Redfish lockdown status.","required":["status","message"],"properties":{"status":{"type":"string","enum":["Enabled","Partial","Disabled","Unknown"]},"message":{"type":"string"}}},"BMCResetRequest":{"type":"object","title":"BMCResetRequest","description":"Request to reset a Machine BMC","properties":{"useIpmiTool":{"type":"boolean","default":false,"description":"Reset the BMC via ipmitool instead of Redfish. The request may be silently ignored while the BMC is in lockdown mode."},"acknowledgeAttachedInstance":{"type":"boolean","description":"Acknowledges that an Instance is currently attached to the Machine and this action may disrupt Tenant workload on the Instance."}},"examples":[{"useIpmiTool":true}]},"DpuReprovisionRequest":{"type":"object","title":"DpuReprovisionRequest","description":"Request to trigger DPU reprovisioning for a Machine","required":["mode"],"properties":{"mode":{"type":"string","description":"Use `Set` to start reprovisioning, `Clear` to remove a pending request, or `Restart` to restart DPUs that already have a request. Restart accepts a host Machine ID only.","enum":["Set","Clear","Restart"]},"updateFirmware":{"type":"boolean","default":false,"deprecated":true,"description":"Deprecated compatibility field. Firmware is always verified and updated during reprovisioning."},"acknowledgeAttachedInstance":{"type":"boolean","description":"Acknowledges that an Instance is currently attached to the Machine and this action may disrupt Tenant workload on the Instance."}},"examples":[{"mode":"Set","updateFirmware":false}]},"MachineHealthReportEntry":{"type":"object","title":"MachineHealthReportEntry","description":"Machine health report entry","required":["source","mode"],"properties":{"source":{"type":"string","description":"Health report source."},"triggeredBy":{"type":"string","description":"Person or system that triggered this health report."},"observedAt":{"type":"string","format":"date-time","description":"Date/time when the health report was observed."},"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."},"mode":{"type":"string","description":"How this health report was updated","enum":["Merge","Replace"]}},"examples":[{"source":"maintenance.dpu-reprovision","triggeredBy":"operator","observedAt":"2026-06-24T12:00:00Z","mode":"Merge","alerts":[{"id":"HostUpdateInProgress","message":"DPU reprovisioning in progress","classifications":["PreventAllocations"]}]}]},"MachineHealthReportEntryRequest":{"type":"object","title":"MachineHealthReportEntryRequest","description":"Request to add or update a Machine health report override.","required":["source","mode"],"properties":{"source":{"type":"string","description":"Health report source."},"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."},"mode":{"type":"string","description":"How updates to this health report should be handled","enum":["Merge","Replace"]}},"examples":[{"source":"maintenance.dpu-reprovision","mode":"Merge","alerts":[{"id":"HostUpdateInProgress","message":"DPU reprovisioning in progress","classifications":["PreventAllocations"]}]}]},"HostFirmwareArtifact":{"type":"object","title":"HostFirmwareArtifact","description":"Location of a firmware artifact used during host firmware updates.","required":["url"],"properties":{"url":{"type":"string","minLength":1,"description":"URL from which the firmware artifact can be downloaded."},"sha256":{"type":"string","description":"Optional SHA-256 digest of the artifact, in lowercase hex."}},"example":{"url":"https://firmware.example.invalid/28.47.2682/fw.bin","sha256":"a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"}},"HostFirmwareVersionConfig":{"type":"object","title":"HostFirmwareVersionConfig","description":"One known firmware version for a host firmware component.","required":["version","artifacts"],"properties":{"version":{"type":"string","minLength":1,"description":"Firmware version string reported by inventory and stored in Core."},"default":{"type":"boolean","default":false,"description":"When `true`, marks this version as the default target for the component."},"artifacts":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/HostFirmwareArtifact"},"description":"Artifact locations used to install this firmware version."},"installOnlySpecified":{"type":"boolean","default":false,"description":"When `true`, install only the artifacts explicitly listed for this version."},"powerDrainsNeeded":{"type":"integer","minimum":0,"description":"Optional number of power drains required after installing this version."},"preUpdateResets":{"type":"boolean","default":false,"description":"When `true`, perform pre-update resets before installing this version."},"preingestionExclusiveConfig":{"type":"boolean","description":"Optional. When `true`, this firmware version applies only during BMC\npre-ingestion. Omitted on update preserves the stored value; set to\n`false` to clear a previously stored value."}},"example":{"version":"28.47.2682","default":true,"artifacts":[{"url":"https://firmware.example.invalid/28.47.2682/fw.bin","sha256":"a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"}],"installOnlySpecified":false,"preUpdateResets":false,"preingestionExclusiveConfig":false}},"HostFirmwareComponentConfig":{"type":"object","title":"HostFirmwareComponentConfig","description":"One component entry in a host firmware config upsert request.","required":["type","firmware"],"properties":{"type":{"$ref":"#/components/schemas/HostFirmwareComponentType"},"firmware":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/HostFirmwareVersionConfig"},"description":"Known firmware versions for this component. Versions are merged by version string on update."},"preingestUpgradeWhenBelow":{"type":"string","minLength":1,"description":"Optional minimum firmware version required before BMC pre-ingestion can\ncomplete. Omitted on update preserves the stored value."}}},"HostFirmwareComponent":{"type":"object","title":"HostFirmwareComponent","description":"One component entry in a stored host firmware config response.","required":["type","firmware"],"properties":{"type":{"$ref":"#/components/schemas/HostFirmwareComponentType"},"currentVersionDetectionRegEx":{"type":"string","readOnly":true,"description":"Inventory regex Core uses to match reported versions for this component."},"preingestUpgradeWhenBelow":{"type":"string","readOnly":true,"description":"Minimum firmware version required before BMC pre-ingestion can complete."},"firmware":{"type":"array","items":{"$ref":"#/components/schemas/HostFirmwareVersionConfig"},"description":"Known firmware versions currently stored for this component."}}},"HostFirmwareConfigCreateOrUpdateRequest":{"type":"object","title":"HostFirmwareConfigCreateOrUpdateRequest","description":"Host firmware configuration upsert payload. Configurations are keyed by\n`(vendor, model)` on the Site's Core instance. On first create,\n`ordering` must list every component being configured. On update,\nnewly added components must also appear in `ordering`.","required":["siteId","vendor","model","components"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the host firmware config is stored."},"vendor":{"type":"string","minLength":1,"description":"Hardware vendor for the configuration (for example `Nvidia`, `Dell`)."},"model":{"type":"string","minLength":1,"description":"Hardware model for the configuration (for example `DGXH100`)."},"components":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/HostFirmwareComponentConfig"},"description":"Component firmware entries to create or merge."},"explicitStartNeeded":{"type":"boolean","description":"Optional. When `true`, host firmware updates for this vendor/model\nrequire an explicit start. Omitted on update leaves the stored\nvalue unchanged."},"ordering":{"type":"array","items":{"$ref":"#/components/schemas/HostFirmwareComponentType"},"description":"Update order for configured components. Required on first create.\nMust include every configured component and must be updated when\nadding a new component on subsequent PUTs."}},"examples":[{"siteId":"00000000-0000-0000-0000-000000000001","vendor":"Nvidia","model":"DGXH100","explicitStartNeeded":true,"ordering":["Cx7","BMC"],"components":[{"type":"Cx7","firmware":[{"version":"28.47.2682","default":true,"installOnlySpecified":true,"powerDrainsNeeded":1,"preUpdateResets":true,"artifacts":[{"url":"https://firmware.example.invalid/28.47.2682/fw.bin","sha256":"a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"}]}]}]}]},"HostFirmwareConfigDeleteRequest":{"type":"object","title":"HostFirmwareConfigDeleteRequest","description":"Host firmware configuration delete payload.","required":["siteId","vendor","model"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the host firmware config is stored."},"vendor":{"type":"string","minLength":1,"description":"Hardware vendor for the configuration (for example `Nvidia`, `Dell`)."},"model":{"type":"string","minLength":1,"description":"Hardware model for the configuration (for example `DGXH100`)."}},"examples":[{"siteId":"00000000-0000-0000-0000-000000000001","vendor":"Nvidia","model":"DGXH100"}]},"HostFirmwareConfig":{"type":"object","title":"HostFirmwareConfig","description":"Stored host firmware configuration returned after create or update.","required":["vendor","model","components","explicitStartNeeded","ordering","created","updated"],"properties":{"vendor":{"type":"string","readOnly":true,"description":"Hardware vendor for the configuration."},"model":{"type":"string","readOnly":true,"description":"Hardware model for the configuration."},"components":{"type":"array","items":{"$ref":"#/components/schemas/HostFirmwareComponent"},"description":"Stored component firmware entries."},"explicitStartNeeded":{"type":"boolean","readOnly":true,"description":"Whether host firmware updates require an explicit start."},"ordering":{"type":"array","items":{"$ref":"#/components/schemas/HostFirmwareComponentType"},"readOnly":true,"description":"Stored update order for configured components."},"created":{"type":"string","format":"date-time","readOnly":true,"description":"When this vendor/model configuration was first created."},"updated":{"type":"string","format":"date-time","readOnly":true,"description":"When this vendor/model configuration was last updated."}},"examples":[{"vendor":"Nvidia","model":"DGXH100","explicitStartNeeded":true,"ordering":["Cx7","BMC"],"components":[{"type":"BMC","firmware":[{"version":"2.3.7","default":true,"installOnlySpecified":false,"powerDrainsNeeded":0,"preUpdateResets":false,"artifacts":[{"url":"https://firmware.example.invalid/2.3.7/fw.bin","sha256":"a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"}]}]},{"type":"Cx7","firmware":[{"version":"28.47.2682","default":true,"installOnlySpecified":true,"powerDrainsNeeded":1,"preUpdateResets":true,"artifacts":[{"url":"https://firmware.example.invalid/28.47.2682/fw.bin","sha256":"a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"}]}]}],"created":"2025-08-24T14:15:22Z","updated":"2025-08-24T14:15:22Z"}]},"HostFirmwareComponentType":{"type":"string","title":"HostFirmwareComponentType","description":"Host firmware component type exposed by the REST API.","enum":["BMC","CEC","UEFI","NIC","CpldMb","CpldPdb","HgxBmc","CombinedBmcUefi","GPU","Cx7"]},"MachinePowerControlRequest":{"type":"object","title":"MachinePowerControlRequest","description":"Request to power control a Machine","required":["action"],"properties":{"action":{"type":"string","description":"Redfish power control action to apply to the Machine. ACPowercycle is not supported on Viking systems.","enum":["On","GracefulShutdown","ForceOff","GracefulRestart","ForceRestart","ACPowercycle"]},"acknowledgeAttachedInstance":{"type":"boolean","description":"Acknowledges that an Instance is currently attached to the Machine and this action may disrupt Tenant workload on the Instance."}},"examples":[{"action":"ForceRestart","acknowledgeAttachedInstance":true}]},"MachineValidationRunCreateRequest":{"type":"object","title":"MachineValidationRunCreateRequest","description":"Optional filters for an on-demand Machine validation run","examples":[{"tags":["dgxcloud"],"allowedTests":["forge_DcgmFullLong"],"runUnverifiedTests":false,"contexts":["OnDemand"]}],"properties":{"tags":{"type":"array","description":"Tags used to select validation tests.","items":{"type":"string","minLength":1}},"allowedTests":{"type":"array","description":"Validation test names allowed for this run.","items":{"type":"string","minLength":1}},"runUnverifiedTests":{"type":"boolean","description":"Whether unverified validation tests may run.","default":false},"contexts":{"type":"array","description":"Contexts used to select validation tests.","items":{"type":"string","minLength":1}}}},"MachineValidationRun":{"type":"object","title":"MachineValidationRun","description":"Machine validation run","examples":[{"validationID":"20000000-0000-0000-0000-000000000001","machineID":"fm100htes3rn1npvbtm5qd57dkilaag7ljugl1llmm7rfuq1ov50i0rpl30","startTime":"2026-08-03T20:00:00Z","endTime":null,"name":"Test_fm100htes3rn1npvbtm5qd57dkilaag7ljugl1llmm7rfuq1ov50i0rpl30","context":"OnDemand","status":{"state":"InProgress","total":1,"completed":0},"durationToCompleteSecs":7200}],"required":["validationID","machineID","startTime","endTime","name","context","status","durationToCompleteSecs"],"properties":{"validationID":{"type":"string","description":"ID of the Machine validation run."},"machineID":{"type":"string","description":"ID of the validated Machine."},"startTime":{"type":"string","format":"date-time","description":"Time the validation run started."},"endTime":{"type":["string","null"],"format":"date-time","description":"Time the validation run completed, or null while it is active."},"name":{"type":"string","description":"Name of the validation run."},"context":{"type":"string","description":"Context in which the validation run was created."},"status":{"$ref":"#/components/schemas/MachineValidationStatus"},"durationToCompleteSecs":{"type":"integer","description":"Estimated maximum duration of the validation run in seconds. A value of zero can mean the estimate has not yet been calculated."}}},"MachineValidationStatus":{"type":"object","title":"MachineValidationStatus","description":"Progress and outcome of a Machine validation run","examples":[{"state":"InProgress","total":1,"completed":0}],"required":["state","total","completed"],"properties":{"state":{"type":"string","description":"Current state or completed outcome of the validation run.","enum":["Started","InProgress","Success","Failed","Skipped"]},"total":{"type":"integer","description":"Total number of validation tests in the run."},"completed":{"type":"integer","description":"Number of validation tests that have completed."}}},"MachineValidationResult":{"type":"object","title":"MachineValidationResult","description":"Result of one test in a Machine validation run","examples":[{"name":"DcgmFullLong","description":"Full DCGM diag test for 5 min","command":"dcgmi ","args":" diag -r 3","stdOut":"Diagnostic completed successfully","stdErr":"","context":"OnDemand","exitCode":0,"startTime":"2026-08-03T20:00:05Z","endTime":"2026-08-03T20:05:05Z","validationID":"20000000-0000-0000-0000-000000000001","testID":"forge_DcgmFullLong"}],"required":["name","description","command","args","stdOut","stdErr","context","exitCode","startTime","endTime","validationID","testID"],"properties":{"name":{"type":"string","description":"Name of the validation test."},"description":{"type":"string","description":"Description of the validation test."},"command":{"type":"string","description":"Command executed by the validation test."},"args":{"type":"string","description":"Arguments supplied to the validation command."},"stdOut":{"type":"string","description":"Standard output from the validation command."},"stdErr":{"type":"string","description":"Standard error from the validation command."},"context":{"type":"string","description":"Context in which the validation test ran."},"exitCode":{"type":"integer","description":"Exit code returned by the validation command."},"startTime":{"type":"string","format":"date-time","description":"Time the validation test started."},"endTime":{"type":"string","format":"date-time","description":"Time the validation test completed."},"validationID":{"type":"string","description":"ID of the Machine validation run."},"testID":{"type":"string","description":"ID of the validation test."}}},"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","description":"Unique UUID v4 identifier for the Infrastructure Provider","format":"uuid","readOnly":true},"org":{"type":"string","description":"Name of the org this Infrastructure Provider belongs to"},"orgDisplayName":{"type":["string","null"],"description":"Display name of the org this Infrastructure Provider belongs to"},"created":{"type":"string","description":"Date/time when the Infrastructure Provider was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Infrastructure Provider was last updated","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","description":"Machine status counts for the Infrastructure Provider"},"ipBlock":{"$ref":"#/components/schemas/IpBlockCountByStatus","description":"IP Block status counts for the Infrastructure Provider"},"tenantAccount":{"$ref":"#/components/schemas/TenantAccountCountByStatus","description":"Tenant Account status counts for the Infrastructure Provider"}}},"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","description":"Total number of Machines"},"initializing":{"type":"integer","description":"Number of Machines in Initializing status"},"reset":{"type":"integer","description":"Number of Machines in Reset status"},"assigned":{"type":"integer","description":"Number of Machines in Assigned status"},"ready":{"type":"integer","description":"Number of Machines in Ready status"},"error":{"type":"integer","description":"Number of Machines in Error status"},"decommissioned":{"type":"integer","description":"Number of Machines in Decommissioned status"},"unknown":{"type":"integer","description":"Number of Machines in Unknown status"}}},"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","description":"Total number of IP Blocks"},"pending":{"type":"integer","description":"Number of IP Blocks in Pending status"},"provisioning":{"type":"integer","description":"Number of IP Blocks in Provisioning status"},"ready":{"type":"integer","description":"Number of IP Blocks in Ready status"},"deleting":{"type":"integer","description":"Number of IP Blocks in Deleting status"},"error":{"type":"integer","description":"Number of IP Blocks in Error status"}}},"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","description":"Total number of Tenant Accounts"},"pending":{"type":"integer","description":"Number of Tenant Accounts in Pending status"},"invited":{"type":"integer","description":"Number of Tenant Accounts in Invited status"},"ready":{"type":"integer","description":"Number of Tenant Accounts in Ready status"},"error":{"type":"integer","description":"Number of Tenant Accounts in Error status"}}},"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":true},"deprecations":[{"attribute":"capabilities.targetedInstanceCreation","replacedBy":"tenantAccount.siteCapabilities","takeActionBy":"2026-10-01T00:00:00Z","notice":"'capabilities.targetedInstanceCreation' is being deprecated in favor of 'tenantAccount.siteCapabilities'. Please take action prior to the specified date"}]}],"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":"Deprecated read-only aggregate of tenant-wide feature flags. Source of truth is Tenant Account `siteCapabilities`."},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"},"description":"Deprecation notices for Tenant fields"}}},"TenantCapabilities":{"title":"TenantCapabilities","type":"object","description":"Deprecated tenant-wide capability summary. TargetedInstanceCreation is no longer stored on the Tenant entity; it is configured on Tenant Account `siteCapabilities` (and may be overridden per Site via Tenant Site configuration).\n\nOn GET `/tenant/current`, `targetedInstanceCreation` is present and `true` only when the Tenant has at least one Ready Tenant Account, every Ready Tenant Account has the capability enabled by default, and no Tenant Site explicitly disables it. Otherwise the property is omitted. Embedded `TenantSummary.capabilities` objects in nested resources also omit the property.","examples":[{"targetedInstanceCreation":true}],"properties":{"targetedInstanceCreation":{"type":"boolean","deprecated":true,"readOnly":true,"description":"Deprecated in favor of TenantAccount.siteCapabilities. On GET `/tenant/current`, the property is present and true only when every Ready Tenant Account enables TargetedInstanceCreation and no Tenant Site explicitly disables it; otherwise it is omitted. It is also omitted from embedded TenantSummary objects."}}},"TenantStats":{"title":"TenantStats","type":"object","description":"Provide operational stats for Tenant","examples":[{"instance":{"total":18,"pending":2,"provisioning":1,"configuring":2,"ready":8,"rebooting":1,"repairing":1,"terminating":2,"error":1,"updating":0,"unknown":0},"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},"tenantAccount":{"total":8,"pending":0,"invited":3,"ready":5,"error":0}}],"properties":{"instance":{"$ref":"#/components/schemas/InstanceCountByStatus","description":"Instance status counts for the Tenant"},"vpc":{"$ref":"#/components/schemas/VpcCountByStatus","description":"VPC status counts for the Tenant"},"subnet":{"$ref":"#/components/schemas/SubnetCountByStatus","description":"Subnet status counts for the Tenant"},"tenantAccount":{"$ref":"#/components/schemas/TenantAccountCountByStatus","description":"Tenant Account status counts for the Tenant"}}},"InstanceCountByStatus":{"title":"InstanceCountByStatus","type":"object","description":"Describes count of Instances in various statuses","examples":[{"total":18,"pending":2,"provisioning":1,"configuring":2,"ready":8,"rebooting":1,"repairing":1,"terminating":2,"error":1,"updating":0,"unknown":0}],"properties":{"total":{"type":"integer","description":"Total number of Instances"},"pending":{"type":"integer","description":"Number of Instances in Pending status"},"provisioning":{"type":"integer","description":"Number of Instances in Provisioning status"},"configuring":{"type":"integer","description":"Number of Instances in Configuring status"},"ready":{"type":"integer","description":"Number of Instances in Ready status"},"rebooting":{"type":"integer","description":"Number of Instances in Rebooting status"},"repairing":{"type":"integer","description":"Number of Instances in Repairing status"},"terminating":{"type":"integer","description":"Number of Instances in Terminating status"},"error":{"type":"integer","description":"Number of Instances in Error status"},"updating":{"type":"integer","description":"Number of Instances in Updating status"},"unknown":{"type":"integer","description":"Number of Instances in Unknown status"}}},"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","description":"Total number of VPCs"},"pending":{"type":"integer","description":"Number of VPCs in Pending status"},"provisioning":{"type":"integer","description":"Number of VPCs in Provisioning status"},"ready":{"type":"integer","description":"Number of VPCs in Ready status"},"deleting":{"type":"integer","description":"Number of VPCs in Deleting status"},"error":{"type":"integer","description":"Number of VPCs in Error status"}}},"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","description":"Total number of Subnets"},"pending":{"type":"integer","description":"Number of Subnets in Pending status"},"provisioning":{"type":"integer","description":"Number of Subnets in Provisioning status"},"ready":{"type":"integer","description":"Number of Subnets in Ready status"},"deleting":{"type":"integer","description":"Number of Subnets in Deleting status"},"error":{"type":"integer","description":"Number of Subnets in Error status"}}},"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":"Ready","statusHistory":[{"status":"Ready","message":"Account ready, Tenant accepted invite","created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"siteCapabilities":[{"targetedInstanceCreation":true}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","description":"Unique UUID v4 identifier for the Tenant Account","format":"uuid","readOnly":true},"infrastructureProviderId":{"type":"string","description":"ID of the Infrastructure Provider","format":"uuid"},"infrastructureProviderOrg":{"type":"string","description":"Organization name of the Infrastructure Provider"},"tenantId":{"type":["string","null"],"description":"ID of the Tenant","format":"uuid"},"tenantOrg":{"type":["string","null"],"description":"Org of the Tenant"},"tenantContact":{"$ref":"#/components/schemas/User","description":"Contact user for the Tenant"},"allocationCount":{"type":"integer","description":"Number of Allocations for the Tenant Account"},"status":{"$ref":"#/components/schemas/TenantAccountStatus","description":"Status of the Tenant Account"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the Tenant Account"},"deprecations":{"type":"array","description":"Deprecations active for this resource. Returned only if there are active deprecations.","items":{"$ref":"#/components/schemas/Deprecation"}},"created":{"type":"string","description":"Date/time when the Tenant Account was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Tenant Account was last updated","format":"date-time","readOnly":true},"siteCapabilities":{"type":"array","description":"Provider-scoped TargetedInstanceCreation settings for this Tenant Account. Replaces the deprecated tenant-level capabilities.targetedInstanceCreation attribute.\n\nWhen present on a Tenant Account response, the array always includes one entry with omitted `siteIds` derived from TenantAccount.config, followed by zero or more entries with `siteIds` for per-site overrides that differ from the account default.","minItems":1,"items":{"$ref":"#/components/schemas/TenantAccountSiteCapability"}}}},"TenantAccountSiteCapability":{"title":"TenantAccountSiteCapability","type":"object","description":"TargetedInstanceCreation capability for the Tenant Account default or an explicit Site list.\n\nUpdate payloads must satisfy all of the following when siteCapabilities is sent on PATCH:\n- the siteCapabilities array must contain at least one entry\n- exactly one entry must omit siteIds or provide an empty siteIds array\n- each siteId may appear at most once across all entries\n- every provided siteId must be a valid Site UUID\n- every provided siteId must identify a Site associated with the Tenant and owned by the Tenant Account's Infrastructure Provider; otherwise the server rejects the request with 400\n\nPATCH uses replace semantics: previously configured per-site overrides whose siteId is omitted from the new payload are cleared.","required":["targetedInstanceCreation"],"properties":{"siteIds":{"type":"array","description":"Sites to configure. An omitted or empty array identifies the Tenant Account default entry. Each value must be a valid Site UUID, may appear only once across all siteCapabilities entries in the same request, must be associated with the Tenant, and must be owned by the Tenant Account's Infrastructure Provider; otherwise the server rejects the request with 400.","items":{"type":"string","format":"uuid"}},"targetedInstanceCreation":{"type":"boolean","description":"Whether TargetedInstanceCreation is enabled for the Tenant Account default or listed Sites. When true, Tenant Admins with a Ready Tenant Account on the Site's Infrastructure Provider may create Instances by Machine ID and perform related privileged actions on that Site."}}},"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","deprecated":true,"description":"Deprecated; inferred from the caller's org Infrastructure Provider\nwhen omitted. When provided, the value must match the org's\nInfrastructure Provider — mismatched values are rejected with 400."},"tenantOrg":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","minLength":1,"description":"Must be a valid Org name"}},"required":["tenantOrg"]},"TenantAccountUpdateRequest":{"title":"TenantAccountUpdateRequest","type":"object","description":"Request data to update a TenantAccount.\n\nProvider Admins may replace `siteCapabilities` only.\nTenant Admins may accept an invite via `tenantContactId` only.\nRequests containing both fields are rejected with 400.\n\nWhen `siteCapabilities` is included, the replace payload must contain at least one entry, include exactly one entry with empty or omitted `siteIds`, and must not repeat any `siteId` across entries. Every provided `siteId` must be a valid UUID for a Site associated with the Tenant and owned by the Tenant Account's Infrastructure Provider; otherwise the server rejects the request with 400. Previously configured per-site overrides whose `siteId` is omitted from the replacement payload are cleared.","examples":[{"tenantContactId":"497f6eca-6276-4993-bfeb-53cbbbba6f08"},{"siteCapabilities":[{"siteIds":[],"targetedInstanceCreation":true},{"siteIds":["3fa85f64-5717-4562-b3fc-2c963f66afa6"],"targetedInstanceCreation":false}]}],"properties":{"tenantContactId":{"type":"string","format":"uuid","description":"Tenant Admin invite acceptance; must match the requesting user"},"siteCapabilities":{"type":"array","minItems":1,"description":"Provider Admin replace payload for TargetedInstanceCreation configuration. Required to be non-empty when sent.\n\nPATCH uses replace semantics: previously configured per-site overrides whose siteId is omitted from the new payload are cleared.\n\nServer validation rules:\n- must contain at least one entry\n- must contain exactly one entry with omitted or empty siteIds\n- must not repeat any siteId across entries\n- every provided siteId must be a valid Site UUID\n- every provided siteId must identify a Site associated with the Tenant and owned by the Tenant Account's Infrastructure Provider; otherwise the server rejects the request with 400","items":{"$ref":"#/components/schemas/TenantAccountSiteCapability"}}}},"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}},"gpuStats":[{"name":"NVIDIA GB200","gpus":64,"machines":16}],"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","description":"Unique UUID v4 identifier for the Site in NICo Cloud","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","description":"NGC organization ID of the Infrastructure Provider that owns the Site"},"infrastructureProviderId":{"type":"string","description":"ID of the Infrastructure Provider that owns the Site","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"],"description":"Serial console hostname of the site controller","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","description":"Status of the Site","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the Site"},"created":{"type":"string","description":"Date/time when the Site was created","format":"date-time"},"updated":{"type":"string","description":"Date/time when the Site was last updated","format":"date-time"},"location":{"$ref":"#/components/schemas/SiteLocation","description":"Site location information"},"contact":{"$ref":"#/components/schemas/SiteContact","description":"Site contact information"},"capabilities":{"$ref":"#/components/schemas/SiteCapabilities","description":"Site capabilities used for feature availability and configuration"},"machineStats":{"$ref":"#/components/schemas/SiteMachineStats","description":"Machine counts by status for the Site"},"gpuStats":{"type":"array","items":{"$ref":"#/components/schemas/MachineGPUStats"},"description":"GPU counts grouped by GPU type for the Site. Populated when includeGpuStats is set"}}},"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","description":"Unique UUID v4 identifier for the Site","format":"uuid","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":256,"description":"Name of the Site"},"infrastructureProviderId":{"type":"string","description":"ID of the Infrastructure Provider that owns the Site","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","description":"Site capabilities used for feature availability and configuration"},"status":{"$ref":"#/components/schemas/SiteStatus","description":"Status of the Site","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","description":"Whether the Site supports native networking"},"networkSecurityGroup":{"type":"boolean","description":"Whether the Site supports Network Security Groups"},"nvLinkPartition":{"type":"boolean","description":"Whether the Site supports NVLink partitioning"},"flow":{"type":"boolean","description":"Whether the Site supports Flow-based operations"},"imageBasedOperatingSystem":{"type":"boolean","description":"Whether the Site supports image-based operating system provisioning"}}},"SiteMachineStats":{"title":"SiteMachineStats","type":"object","description":"Machine stats for a Site","properties":{"total":{"type":"integer","description":"Total number of Machines at the Site"},"totalByStatus":{"$ref":"#/components/schemas/SiteMachineStatsByStatus","description":"Machine counts grouped by Machine status"},"totalByHealth":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Machine counts grouped by health state"},"totalByStatusAndHealth":{"$ref":"#/components/schemas/SiteMachineStatsByStatusAndHealth","description":"Machine health counts grouped by Machine status"},"totalByAllocation":{"$ref":"#/components/schemas/SiteMachineStatsByAllocation","description":"Machine counts grouped by allocation and usage state"}}},"SiteMachineStatsByAllocation":{"title":"SiteMachineStatsByAllocation","type":"object","description":"Machine stats for a Site by allocation","properties":{"allocatedInUse":{"type":"integer","description":"Number of allocated Machines currently in use"},"allocatedNotInUse":{"type":"integer","description":"Number of allocated Machines not currently in use"},"unallocated":{"type":"integer","description":"Number of Machines not currently allocated"}}},"SiteMachineStatsByHealth":{"title":"SiteMachineStatsByHealth","type":"object","description":"Machine stats for a Site by health","properties":{"healthy":{"type":"integer","description":"Number of healthy Machines"},"unhealthy":{"type":"integer","description":"Number of unhealthy Machines"}}},"SiteMachineStatsByStatus":{"title":"SiteMachineStatsByStatus","type":"object","description":"Machine stats for a Site by status","properties":{"Decommissioned":{"type":"integer","description":"Number of Machines in Decommissioned status"},"Error":{"type":"integer","description":"Number of Machines in Error status"},"Initializing":{"type":"integer","description":"Number of Machines in Initializing status"},"InUse":{"type":"integer","description":"Number of Machines in InUse status"},"Maintenance":{"type":"integer","description":"Number of Machines in Maintenance status"},"Ready":{"type":"integer","description":"Number of Machines in Ready status"},"Reset":{"type":"integer","description":"Number of Machines in Reset status"},"Unknown":{"type":"integer","description":"Number of Machines in Unknown status"}}},"SiteMachineStatsByStatusAndHealth":{"title":"SiteMachineStatsByStatusAndHealth","type":"object","description":"Machine stats for a Site by status and health","properties":{"Decommissioned":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Health breakdown for Machines in Decommissioned status"},"Error":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Health breakdown for Machines in Error status"},"Initializing":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Health breakdown for Machines in Initializing status"},"InUse":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Health breakdown for Machines in InUse status"},"Maintenance":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Health breakdown for Machines in Maintenance status"},"Ready":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Health breakdown for Machines in Ready status"},"Reset":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Health breakdown for Machines in Reset status"},"Unknown":{"$ref":"#/components/schemas/SiteMachineStatsByHealth","description":"Health breakdown for Machines in Unknown status"}}},"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","description":"Site location information"},"contact":{"$ref":"#/components/schemas/SiteContact","description":"Site contact information"}},"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","description":"Updated Site location information"},"contact":{"$ref":"#/components/schemas/SiteContact","description":"Updated Site contact information"},"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","description":"Status of the Allocation","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the Allocation","readOnly":true},"allocationConstraints":{"type":"array","items":{"$ref":"#/components/schemas/AllocationConstraint"},"description":"List of Allocation Constraints for the Allocation"},"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"},"description":"List of Allocation Constraint objects"}},"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 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 which 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","description":"Summary of the Instance Type"},"ipBlock":{"$ref":"#/components/schemas/IpBlockSummary","description":"Summary of the IP Block"},"deprecations":{"type":"array","description":"Deprecations active for this resource. Returned only if there are active deprecations.","items":{"$ref":"#/components/schemas/Deprecation"}},"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":{"objectId":"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","FLAT"],"description":"Network virtualization type of the VPC. Flat VPCs hold instances on zero-DPU hosts (or hosts with their DPU in NIC mode); their interfaces are bound to underlay (HostInband) network segments and NICo does not drive their data plane."},"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`."},"routingProfileOverrides":{"oneOf":[{"$ref":"#/components/schemas/VpcRoutingProfileOverrides"},{"type":"null"}],"description":"Routing-profile properties set directly on the VPC. Unset properties inherit from the named routing profile."},"effectiveRoutingProfile":{"$ref":"#/components/schemas/VpcEffectiveRoutingProfile","readOnly":true,"description":"Fully resolved routing profile last reported by Core for the VPC. This property is included only when the requesting Tenant has effective TargetedInstanceCreation permission for the VPC's Site."},"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"}}},"VpcRouteTarget":{"title":"VpcRouteTarget","type":"object","description":"BGP route target represented by an autonomous system number and VNI.","properties":{"asn":{"type":"integer","format":"int64","minimum":0,"maximum":4294967295,"description":"Autonomous system number."},"vni":{"type":"integer","format":"int64","minimum":0,"maximum":4294967295,"description":"Route-target VNI."}}},"VpcRoutingProfileOverrides":{"title":"VpcRoutingProfileOverrides","type":"object","description":"Presence-aware routing-profile properties set directly on a VPC. Each present property replaces the corresponding named-profile value; omitted properties inherit from that profile.","properties":{"routeTargetImports":{"type":["array","null"],"items":{"$ref":"#/components/schemas/VpcRouteTarget"},"description":"Route targets imported into the VPC. An empty array overrides the named profile with no imports."},"routeTargetsOnExports":{"type":["array","null"],"items":{"$ref":"#/components/schemas/VpcRouteTarget"},"description":"Route targets attached to VPC exports. An empty array overrides the named profile with no export targets."},"leakDefaultRouteFromUnderlay":{"type":["boolean","null"],"description":"Whether the underlay default route is leaked into the VPC."},"leakTenantHostRoutesToUnderlay":{"type":["boolean","null"],"description":"Whether tenant host routes are leaked into the underlay."},"tenantLeakCommunitiesAccepted":{"type":["boolean","null"],"description":"Whether tenant-supplied route-leak communities are honored."},"acceptedLeaksFromUnderlay":{"type":["array","null"],"items":{"type":"string","example":"192.0.2.0/24"},"description":"IPv4 or IPv6 CIDR prefixes allowed to leak from the underlay. An empty array disables explicitly accepted leaks."},"allowedAnycastPrefixes":{"type":["array","null"],"items":{"type":"string","example":"2001:db8::/64"},"description":"IPv4 or IPv6 CIDR prefixes tenant hosts may announce as anycast routes. An empty array disables anycast announcements."}}},"VpcEffectiveRoutingProfile":{"title":"VpcEffectiveRoutingProfile","type":"object","description":"Fully resolved routing profile computed by Core from the named profile and the VPC overrides.","properties":{"routeTargetImports":{"type":"array","items":{"$ref":"#/components/schemas/VpcRouteTarget"}},"routeTargetsOnExports":{"type":"array","items":{"$ref":"#/components/schemas/VpcRouteTarget"}},"leakDefaultRouteFromUnderlay":{"type":"boolean"},"leakTenantHostRoutesToUnderlay":{"type":"boolean"},"tenantLeakCommunitiesAccepted":{"type":"boolean"},"acceptedLeaksFromUnderlay":{"type":"array","items":{"type":"string"}},"allowedAnycastPrefixes":{"type":"array","items":{"type":"string"}},"internal":{"type":"boolean","description":"Operator-controlled internal-routing classification inherited from the named profile."},"accessTier":{"type":"integer","format":"int64","minimum":0,"maximum":4294967295,"description":"Operator-controlled access tier inherited from the named profile."}},"required":["routeTargetImports","routeTargetsOnExports","leakDefaultRouteFromUnderlay","leakTenantHostRoutesToUnderlay","tenantLeakCommunitiesAccepted","acceptedLeaksFromUnderlay","allowedAnycastPrefixes","internal","accessTier"]},"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","FLAT"],"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. Flat VPCs hold instances on zero-DPU hosts (or hosts with their DPU in NIC mode) and are never auto-selected -- `FLAT` must be specified explicitly."},"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`."},"routingProfileOverrides":{"oneOf":[{"$ref":"#/components/schemas/VpcRoutingProfileOverrides"},{"type":"null"}],"description":"Routing-profile properties to overlay on the resolved named profile. Only supported for FNN VPCs and requires `TargetedInstanceCreation` to be effective for the Tenant at the VPC's Site. `routingProfile` may be omitted when the Site and Tenant configuration select a named profile."},"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"},"routingProfileOverrides":{"oneOf":[{"$ref":"#/components/schemas/VpcRoutingProfileOverrides"},{"type":"null"}],"description":"Replaces the current inline routing-profile definition when present. Requires `TargetedInstanceCreation` to be effective for the Tenant at the VPC's Site. Omission or `null` preserves the current definition. An empty object restores inheritance for every property; a partial object replaces the previous definition and inherits its omitted properties from the named profile."},"labels":{"$ref":"#/components/schemas/Labels","description":"Update labels of the VPC. Up to 10 key-value pairs can be specified. The labels will be replaced with the labels sent in the request. Any labels not included in the request will be removed. To retain existing labels, fetch them first and include them in 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"}}},"VpcPeeringTenantSummary":{"title":"VpcPeeringTenantSummary","type":"object","description":"Summarizes a Tenant in context of a VPC Peering","properties":{"id":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the Tenant"},"org":{"type":"string","readOnly":true,"description":"Name of the org this tenant belongs to"},"orgDisplayName":{"type":["string","null"],"readOnly":true,"description":"Display name of the org the Tenant belongs to"}}},"VpcPeeringVpcSummary":{"title":"VpcPeeringVpcSummary","type":"object","description":"Summarizes a VPC in context of a VPC Peering","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"},"tenantId":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the tenant"},"tenant":{"$ref":"#/components/schemas/VpcPeeringTenantSummary","readOnly":true,"description":"Summary of the tenant"},"networkVirtualizationType":{"type":["string","null"],"enum":["ETHERNET_VIRTUALIZER","FNN","FLAT"],"description":"Network virtualization type of the VPC"},"status":{"$ref":"#/components/schemas/VpcStatus","readOnly":true,"description":"Status of the VPC"}}},"TenantSummary":{"title":"TenantSummary","type":"object","description":"Summarizes a Tenant","properties":{"org":{"type":"string","readOnly":true,"description":"Name of the org this tenant belongs to"},"orgDisplayName":{"type":["string","null"],"readOnly":true,"description":"Display name of the org the Tenant belongs to"},"capabilities":{"$ref":"#/components/schemas/TenantCapabilities","readOnly":true,"description":"Deprecated compatibility object. The targetedInstanceCreation property is omitted; use Tenant Account siteCapabilities for the authoritative configuration."},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"},"readOnly":true,"description":"Deprecation notices for Tenant fields"}}},"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"},"vpc1":{"$ref":"#/components/schemas/VpcPeeringVpcSummary","readOnly":true,"description":"Summary of the first VPC in the peering."},"vpc2Id":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the second VPC in the peering"},"vpc2":{"$ref":"#/components/schemas/VpcPeeringVpcSummary","readOnly":true,"description":"Summary of the second VPC in the peering."},"siteId":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the Site where the peering exists"},"site":{"$ref":"#/components/schemas/SiteSummary","readOnly":true,"description":"Summary of the Site where the peering exists."},"tenantId":{"type":"string","format":"uuid","readOnly":true,"description":"ID of the tenant that created the VPC peering."},"tenant":{"$ref":"#/components/schemas/TenantSummary","readOnly":true,"description":"Summary of the tenant that created the VPC peering."},"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","prefix":"192.168.1.0/24","ipBlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","prefixLength":24,"status":"Ready","usageStats":{"availableIPs":256,"acquiredIPs":2,"availablePrefixes":["192.168.1.0/28","192.168.1.16/30","192.168.1.24/29","192.168.1.32/27","192.168.1.64/26","192.168.1.128/25"],"availableSmallestPrefixes":63,"acquiredPrefixes":1},"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"},{"id":"42624127-ec6a-4829-b9ca-2f6ffb5d4215","name":"northern-vpc-traffic-net","siteId":"ea144def-d68f-44c3-9485-4b103fa2686f","vpcId":"4ea05fc4-2be8-4823-b574-e633b5ad3c4c","prefix":"10.217.98.100/30","ipBlockId":"65e14c37-5a8f-4c41-9b1c-f2e162bee11c","prefixLength":30,"status":"Ready","usageStats":{"availableIPs":4,"acquiredIPs":0,"availablePrefixes":["10.217.98.100/30"],"availableSmallestPrefixes":1,"acquiredPrefixes":0},"statusHistory":[{"status":"Ready","message":"Received VPC prefix creation request, ready","created":"2025-05-28T14:15:22Z","updated":"2025-05-28T14:15:22Z"}],"created":"2025-05-28T14:15:22Z","updated":"2025-05-28T14:15:22Z"}],"properties":{"id":{"type":"string","description":"Unique UUID v4 identifier for the VPCPrefix","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"},"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"},"usageStats":{"$ref":"#/components/schemas/IpBlockUsageStats","readOnly":true,"description":"Present when query parameter `includeUsageStats=true`. Prefix and IP usage data is derived by evaluating associated Ethernet interfaces. Each Interface associated with a VPC Prefix consumes a `/31` 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":["Provisioning","Ready","Deleting","Deleted","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","description":"Name of the VPCPrefix","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","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"},{"id":"82e4c3a7-5b4d-4c8e-a2f1-1c09d06e9120","name":"inference-training-net","description":"Provisioned subnet with IPv4 usage (includeUsageStats=true)","siteId":"ea144def-d68f-44c3-9485-4b103fa2686f","vpcId":"5e28ad7c-5fb7-46d6-a28a-fc0ba6fdc4a3","controllerNetworkSegmentId":"abe7b0e8-67db-4e89-903e-fc4f2bd7f034","ipv4Prefix":"10.217.98.64","ipv4BlockId":"8c1d1a06-90a2-4863-8ee1-6029265b9f0a","ipv4Gateway":"10.217.98.65","ipv6Prefix":null,"ipv6BlockId":null,"ipv6Gateway":null,"prefixLength":28,"routingType":"Public","status":"Ready","usageStats":{"availableIPs":16,"acquiredIPs":6,"availablePrefixes":["10.217.98.64/28"],"availableSmallestPrefixes":4,"acquiredPrefixes":0},"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-24T16:02:38Z"}],"properties":{"id":{"type":"string","description":"Unique UUID v4 identifier for the Subnet","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the Subnet","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Subnet"},"siteId":{"type":"string","description":"ID of the Site containing the Subnet","format":"uuid"},"vpcId":{"type":"string","description":"ID of the VPC containing the Subnet","format":"uuid"},"controllerNetworkSegmentId":{"type":["string","null"],"description":"ID of the Site Controller network segment corresponding to the Subnet","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"],"description":"ID of the derived Tenant IPv4 Block from an Allocation","format":"uuid"},"ipv4Gateway":{"type":["string","null"],"description":"Address of the IPv4 gateway in the Subnet","format":"ipv4"},"ipv6Prefix":{"type":["string","null"],"description":"Prefix of the network in CIDR notation","format":"ipv6"},"ipv6BlockId":{"type":["string","null"],"description":"ID of the derived Tenant IPv6 Block from an Allocation","format":"uuid"},"ipv6Gateway":{"type":["string","null"],"description":"Address of the IPv6 gateway in the Subnet","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"],"description":"Routing type of the Subnet","enum":["Public","DatacenterOnly"]},"status":{"$ref":"#/components/schemas/SubnetStatus","description":"Status of the Subnet","readOnly":true},"usageStats":{"$ref":"#/components/schemas/IpBlockUsageStats","readOnly":true,"description":"Present when query parameter `includeUsageStats=true`. Prefix and IP usage data is derived by evaluating associated Ethernet interfaces. Each Interface associated with a Subnet consumes a single IP. In addition, one gateway and one broadcast IP address are reserved per Subnet."},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the Subnet","readOnly":true},"created":{"type":"string","description":"Date/time when the Subnet was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Subnet was last updated","format":"date-time","readOnly":true}}},"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","description":"Name of the Subnet","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Subnet"},"vpcId":{"type":"string","description":"ID of the VPC containing the Subnet","format":"uuid"},"ipv4BlockId":{"type":["string","null"],"description":"ID of the derived Tenant IPv4 Block from an Allocation","format":"uuid"},"ipv6BlockId":{"type":["string","null"],"description":"ID of the derived Tenant IPv6 Block from an Allocation","format":"uuid"},"prefixLength":{"type":"integer","description":"Length of the prefix"}},"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","description":"Name of the Subnet","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Subnet"}},"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","description":"Unique UUID v4 identifier for the InfiniBand Partition","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the InfiniBand Partition","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the InfiniBand Partition"},"siteId":{"type":"string","description":"ID of the Site","format":"uuid"},"tenantId":{"type":"string","description":"ID of the Tenant","format":"uuid"},"controllerIBPartitionId":{"type":["string","null"],"description":"ID of the Site Controller InfiniBand partition corresponding to this InfiniBand Partition","format":"uuid"},"partitionKey":{"type":["string","null"],"description":"Partition key assigned to the InfiniBand Partition","readOnly":true},"partitionName":{"type":["string","null"],"description":"Partition name assigned to the InfiniBand Partition","readOnly":true},"serviceLevel":{"type":["integer","null"],"description":"Service level configured for the InfiniBand Partition","minimum":0,"maximum":15,"readOnly":true},"rateLimit":{"type":["number","null"],"description":"Rate limit configured for the InfiniBand Partition","enum":[2,5,10,14,20,25,30,40,56,60,80,100,112,120,168,200,300],"readOnly":true},"mtu":{"type":["integer","null"],"description":"MTU configured for the InfiniBand Partition","enum":[4000,8000],"readOnly":true},"enableSharp":{"type":"boolean","description":"Whether SHARP is enabled for the InfiniBand Partition","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","description":"Status of the InfiniBand Partition","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the InfiniBand Partition","readOnly":true},"created":{"type":"string","description":"Date/time when the InfiniBand Partition was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the InfiniBand Partition was last updated","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","description":"Name of the InfiniBand Partition","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the InfiniBand Partition"},"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},"nvLinkLogicalPartitionStats":{"$ref":"#/components/schemas/NVLinkLogicalPartitionStats","description":"GPU and Instance usage counts for the NVLink Logical Partition. Returned if the `includeStats` query parameter is set to true in retrieval endpoints"},"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"}}},"NVLinkLogicalPartitionStats":{"title":"NVLinkLogicalPartitionStats","type":"object","description":"GPU and Instance counts for an NVLink Logical Partition","properties":{"totalGpus":{"type":"integer","description":"Total number of GPUs associated with the NVLink Logical Partition"},"totalDistinctInstances":{"type":"integer","description":"Total number of distinct Instances associated with the NVLink Logical Partition"}}},"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":false,"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","TemplatedIpxe"]},"imageUrl":{"type":["string","null"],"format":"uri","description":"Original URL from which 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 mounted"},"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"},"ipxeTemplateId":{"type":["string","null"],"description":"ID of the iPXE template used, only present for Templated iPXE Operating System"},"ipxeTemplateParameters":{"type":"array","items":{"$ref":"#/components/schemas/OperatingSystemIpxeParameter"},"description":"Parameters passed to the iPXE template (Templated iPXE only)"},"ipxeTemplateArtifacts":{"type":"array","items":{"$ref":"#/components/schemas/OperatingSystemIpxeArtifact"},"description":"Artifacts for the iPXE OS definition (Templated iPXE only). authToken is redacted."},"userData":{"type":["string","null"],"description":"User data for the Operating System"},"isCloudInit":{"type":"boolean","description":"Whether the Operating System is cloud-init based; true if there is non-empty `userData`, false otherwise."},"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"]},"OperatingSystemIpxeParameter":{"title":"OperatingSystemIpxeParameter","type":"object","description":"A name/value parameter passed to an iPXE template","required":["name","value"],"properties":{"name":{"type":"string","description":"Parameter name (used as a variable in the template)"},"value":{"type":"string","description":"Parameter value"}}},"OperatingSystemIpxeArtifact":{"title":"OperatingSystemIpxeArtifact","type":"object","description":"An artifact (kernel, initrd, ISO, ...) referenced by an iPXE OS definition","required":["name","url"],"properties":{"name":{"type":"string","description":"Artifact name"},"url":{"type":"string","description":"Original URL for the artifact"},"sha":{"type":["string","null"],"description":"Optional SHA256 checksum"},"authType":{"type":["string","null"],"description":"Optional auth type: Basic or Bearer"},"authToken":{"type":["string","null"],"description":"Optional auth token. Redacted in API responses."},"cacheStrategy":{"type":"string","enum":["CacheAsNeeded","LocalOnly","CachedOnly","RemoteOnly"],"description":"How to handle caching for this artifact"}}},"IpxeTemplate":{"title":"IpxeTemplate","type":"object","description":"An iPXE script template propagated (read-only) from nico-core","required":["id","name","template","requiredParams","reservedParams","requiredArtifacts","visibility"],"examples":[{"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","name":"ubuntu-autoinstall","template":"#!ipxe\nkernel ${kernel_url} initrd=initrd autoinstall\ninitrd ${initrd_url}\nboot\n","requiredParams":["kernel_url","initrd_url"],"reservedParams":["mac"],"requiredArtifacts":["kernel","initrd"],"visibility":"Public","created":"2026-07-14T14:15:22Z","updated":"2026-07-14T14:15:22Z"}],"properties":{"id":{"type":"string","format":"uuid","description":"Stable template UUID assigned by core"},"name":{"type":"string","description":"Globally unique template name"},"template":{"type":"string","description":"Raw iPXE script content"},"requiredParams":{"type":"array","items":{"type":"string"},"description":"Parameters that must be provided to render the template"},"reservedParams":{"type":"array","items":{"type":"string"},"description":"Parameters reserved by the template and not user-supplied"},"requiredArtifacts":{"type":"array","items":{"type":"string"},"description":"Artifact names required for the template"},"visibility":{"type":"string","description":"Template visibility: Internal or Public"},"created":{"type":"string","format":"date-time","readOnly":true},"updated":{"type":"string","format":"date-time","readOnly":true}}},"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","description":"Summary of the Site"},"status":{"$ref":"#/components/schemas/SshKeyGroupStatus","description":"Status of the Operating SystemSiteAssociation"},"version":{"type":["string","null"],"description":"Version of the Key Group on Site","example":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3"},"created":{"type":"string","description":"Date/time when the Site was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Site was last updated","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":false,"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","minItems":1,"maxItems":1,"items":{"type":"string","format":"uuid"},"description":"Target Site for the Operating System. For image-based and Templated iPXE Operating Systems exactly one Site is required, even though this field is an array. The list is fixed at creation and cannot be changed on update. Not applicable to raw iPXE OS."},"ipxeScript":{"type":["string","null"],"deprecated":true,"description":"Deprecated: raw iPXE Operating Systems are superseded by Templated iPXE (ipxeTemplateId). 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 which the Operating System image can be retrieved; 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 if 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` is required for image-based OS"},"rootFsLabel":{"type":["string","null"],"description":"Root filesystem label; this or `rootFsId` is 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","deprecated":true,"description":"Deprecated and ignored: whether the Operating System is cloud-init based. Value now derived from `userData`."},"allowOverride":{"type":"boolean","description":"Indicates if the user data can be overridden at Instance creation time"},"ipxeTemplateId":{"type":["string","null"],"description":"ID of the iPXE template to use; identifies a Templated iPXE Operating System. Mutually exclusive with ipxeScript and imageUrl."},"ipxeTemplateParameters":{"type":"array","items":{"$ref":"#/components/schemas/OperatingSystemIpxeParameter"},"description":"Parameters passed to the iPXE template (Templated iPXE only)."},"ipxeTemplateArtifacts":{"type":"array","items":{"$ref":"#/components/schemas/OperatingSystemIpxeArtifact"},"description":"Artifacts (kernel, initrd, ISO, ...) for the iPXE OS definition (Templated iPXE only)."}},"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","imageAuthType":"Bearer","imageAuthToken":"acbd18db4cc2f85cedef654fccc4a4d8","imageDisk":"/dev/sda","rootFsId":"6c2ac315-3040-4728-94eb-b66d320206c1","isCloudInit":false,"allowOverride":false},{"isActive":false,"deactivationNote":"iPXE script is referencing a URL that is unreachable, needs to be researched"}],"description":"Request data to update an Operating System. For image-based OS, mutable image attributes (image authentication, root filesystem, image disk) can be updated; imageUrl and imageSha identify the underlying image and are immutable after creation. Only iPXE attributes can be updated for iPXE-based OS. A Templated iPXE Operating System can only be updated when it is associated with exactly one Site.","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 which the Operating System image can be retrieved. Immutable after creation: it may be re-sent unchanged, but changing it is rejected. Create a new Operating System to use a different image."},"imageSha":{"type":["string","null"],"description":"SHA hash of the image file. Immutable after creation: it may be re-sent unchanged, but changing it is rejected."},"imageAuthType":{"type":["string","null"],"description":"Authentication type for image URL, if needed, e.g., basic/bearer/token; required if imageAuthToken is specified. Can be updated independently without re-sending imageUrl/imageSha."},"imageAuthToken":{"type":["string","null"],"description":"Auth token to retrieve the image from image URL, required if imageAuthType is specified. Can be updated independently without re-sending imageUrl/imageSha."},"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` is required for image-based OS"},"rootFsLabel":{"type":["string","null"],"description":"Root filesystem label; this or `rootFsId` is 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"],"deprecated":true,"description":"Deprecated and ignored: whether the Operating System is cloud-init based. Value now derived from `userData`."},"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"},"ipxeTemplateId":{"type":["string","null"],"description":"ID of the iPXE template to use (Templated iPXE only). Mutually exclusive with ipxeScript and imageUrl."},"ipxeTemplateParameters":{"type":"array","items":{"$ref":"#/components/schemas/OperatingSystemIpxeParameter"},"description":"Parameters passed to the iPXE template (Templated iPXE only)."},"ipxeTemplateArtifacts":{"type":"array","items":{"$ref":"#/components/schemas/OperatingSystemIpxeArtifact"},"description":"Artifacts (kernel, initrd, ISO, ...) for the iPXE OS definition (Templated iPXE only)."}}},"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"}],"created":"2019-08-24T14:15:22Z","updated":"2019-08-24T14:15:22Z"}],"properties":{"id":{"type":"string","description":"Unique UUID v4 identifier for the Instance Type","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the Instance Type","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Instance Type"},"controllerMachineType":{"type":["string","null"],"description":"Machine type assigned by Site Controller"},"infrastructureProviderId":{"type":"string","description":"ID of the Infrastructure Provider that owns the Instance Type","format":"uuid"},"siteId":{"type":"string","description":"ID of the Site that owns the Instance Type","format":"uuid"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value labels for the Instance Type"},"machineCapabilities":{"type":"array","items":{"$ref":"#/components/schemas/MachineCapability"},"description":"List of capabilities that are supported by the Machine's of this Instance Type"},"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","description":"Status of the Instance Type"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the Instance Type"},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"},"description":"Deprecations active for this resource. Returned only if there are active deprecations."},"created":{"type":"string","description":"Date/time when the InstanceType was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the InstanceType was last updated","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","description":"ID of the Instance Type","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the Instance Type, only lowercase characters, digits, hyphens and cannot begin/end with hyphen","minLength":2,"maxLength":256},"infrastructureProviderId":{"type":"string","description":"ID of the Infrastructure Provider that owns the Instance Type","format":"uuid"},"siteId":{"type":"string","description":"ID of the Site that owns the Instance Type","format":"uuid"},"status":{"$ref":"#/components/schemas/InstanceTypeStatus","description":"Status of the Instance Type"}}},"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","description":"Name of the Instance Type","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Instance Type"},"siteId":{"type":"string","description":"ID of the site","format":"uuid"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value labels for the Instance Type"},"controllerMachineType":{"type":["string","null"],"description":"Site Controller assigned Machine type"},"machineCapabilities":{"type":"array","items":{"$ref":"#/components/schemas/InstanceTypeCapabilityCreateRequest"},"description":"List of Machine Capabilities to match"}},"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"],"description":"Name of the Instance Type","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Instance Type"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value labels for the Instance Type"},"machineCapabilities":{"type":"array","items":{"$ref":"#/components/schemas/MachineCapability"},"description":"List of Machine Capabilities to match"}}},"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":{"objectId":"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"}],"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"}],"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"],"description":"ID of the Instance Type","format":"uuid"},"vpcId":{"type":"string","description":"ID of the VPC","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"],"description":"ID of the Machine"},"operatingSystemId":{"type":["string","null"],"description":"ID of the Operating System","format":"uuid"},"networkSecurityGroupId":{"type":["string","null"],"description":"ID of the attached Network Security Group, if any"},"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"],"description":"ID of the Instance in Site Controller","format":"uuid"},"ipxeScript":{"type":["string","null"],"description":"Attribute which is inherited from Operating System"},"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 the Instance"},"userData":{"type":["string","null"],"description":"UserData is inherited from Operating System or specified by user if allowed"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-specified Instance 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"},"autoNetwork":{"type":"boolean","description":"True when this Instance uses NICo auto-resolved networking from the host's underlay (HostInband) network segments. When true, the caller's request `interfaces` list was empty, this `interfaces` field remains empty on readback, and the resolved per-interface details surface under `status.network.interfaces`."},"interfaces":{"type":"array","items":{"$ref":"#/components/schemas/Interface"},"description":"Interfaces are list of the subnet associated with the Instance"},"infinibandInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/InfiniBandInterface"},"description":"InfiniBandInterfaces are list of the InfiniBandInterface associated with the Instance"},"nvLinkInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/NVLinkInterface"},"description":"NVLinkInterfaces are list of the NVLinkInterface associated with the Instance"},"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","description":"Status of the Instance","readOnly":true},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the Instance"},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"},"description":"Deprecations active for this resource. Returned only if there are active deprecations."},"created":{"type":"string","description":"Date/time when the Instance was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Instance was last updated","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` or `vpcId`. 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"],"description":"ID of the desired Network Security Group to attach to the Instance"},"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","description":"User-defined key-value labels"},"interfaces":{"type":"array","description":"At least one interface must be specified unless `autoNetwork` is true. Interfaces must all be Subnet-backed or all be VPC-backed; VPC-backed interfaces may use an explicit `vpcPrefixId` or ask the Controller to select a prefix using `vpcId` and `ipFamilies`. Only one network can be attached over a physical interface. If only one Subnet is specified, it will be attached over a physical interface regardless of `isPhysical`. Mutually exclusive with `autoNetwork`: when `autoNetwork` is true this list MUST be empty.","items":{"$ref":"#/components/schemas/InterfaceCreateRequest"}},"autoNetwork":{"type":"boolean","description":"When true, asks NICo to auto-resolve the Instance's network interfaces from the host's underlay (HostInband) network segments. Intended for instances on zero-DPU hosts (or hosts with their DPU in NIC mode). When true: (1) the target VPC's `networkVirtualizationType` MUST be `FLAT`, (2) `interfaces` MUST be empty or omitted, and (3) `secondaryVpcIds` MUST be empty or omitted. Resolved interfaces surface on the Instance's read response."},"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"]},"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` or `vpcId`. 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","description":"Key-value objects to be applied to all instances (shared across all instances)"},"interfaces":{"type":"array","description":"Interface configuration shared across all instances. At least one interface must be specified unless `autoNetwork` is true. Interfaces must all be Subnet-backed or all be VPC-backed; VPC-backed interfaces may use an explicit `vpcPrefixId` or ask the Controller to select a prefix using `vpcId` and `ipFamilies`. Each batch member is resolved independently and may use a different prefix. Only one network can be attached over a physical interface. Interface `ipAddress` is not supported for batch instance creation requests. Mutually exclusive with `autoNetwork`: when `autoNetwork` is true this list MUST be empty.","items":{"$ref":"#/components/schemas/InterfaceCreateRequest"}},"autoNetwork":{"type":"boolean","description":"When true, asks NICo to auto-resolve each Instance's network interfaces from the host's underlay (HostInband) network segments. Intended for instances on zero-DPU hosts (or hosts with their DPU in NIC mode). When true: (1) the target VPC's `networkVirtualizationType` MUST be `FLAT`, (2) `interfaces` MUST be empty or omitted, and (3) `secondaryVpcIds` MUST be empty or omitted."},"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"]},"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, pending Instance updates such as DPU reprovisioning are 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"],"description":"ID of the Network Security Group to attach to the Instance"},"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 the Instance"},"labels":{"$ref":"#/components/schemas/Labels","description":"Update labels of the Instance. The labels will be replaced with the labels sent in the request. Any labels not included in the request will be removed. To retain existing labels, fetch them first and include them in 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` or `vpcId`. IDs must be unique, must be valid UUIDs, and must not include the primary `vpcId`.","items":{"type":"string","format":"uuid"}},"interfaces":{"type":"array","description":"Complete updated Interface configuration for the Instance. Interfaces must all be Subnet-backed or all be VPC-backed; VPC-backed interfaces may use an explicit `vpcPrefixId` or ask the Controller to select a prefix using `vpcId` and `ipFamilies`. Mutually exclusive with `autoNetwork`: when `autoNetwork` is true this list MUST be empty.","items":{"$ref":"#/components/schemas/InterfaceCreateRequest"}},"autoNetwork":{"type":["boolean","null"],"description":"When set, asks NICo to auto-resolve the Instance's network interfaces from the host's underlay (HostInband) segments. `null` leaves the value unchanged; `true` (re-)resolves; `false` returns to explicit interface configuration. When `true`, the Instance's VPC MUST already have `networkVirtualizationType: FLAT`, `interfaces` MUST be empty or omitted, and `secondaryVpcIds` MUST be empty or omitted."},"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 the Instance's VPC has the `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":"4c53d2f4-2a51-4ac5-90c9-87ad215c5091","instanceId":"371ddf80-a7ff-4ff6-9a37-0557cec8b9be","vpcId":"bdd3d1af-b4a8-4675-a59c-56548716ef45","ipFamilies":["IPv4"],"isPhysical":true,"macAddress":"2F-FC-34-AE-9C-2D","ipAddresses":["200.32.11.196"],"status":"Ready","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 or VPC-backed network","properties":{"id":{"type":"string","description":"Unique UUID v4 identifier for the Interface","minLength":1,"format":"uuid"},"instanceId":{"type":"string","description":"ID of the associated Instance","format":"uuid"},"subnetId":{"type":["string","null"],"description":"ID of the associated Subnet","format":"uuid"},"vpcPrefixId":{"type":["string","null"],"description":"ID of the VPC Prefix explicitly selected by the caller","format":"uuid"},"vpcId":{"type":"string","description":"ID of the VPC from which the Controller selects a prefix","format":"uuid"},"ipFamilies":{"type":"array","description":"Address families requested for Controller prefix selection","items":{"$ref":"#/components/schemas/IPFamily"}},"isPhysical":{"type":"boolean","description":"Indicates whether the network is bound on a physical Interface"},"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"],"description":"MAC address of the Interface"},"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 with an explicit `vpcPrefixId` and is not valid with `subnetId` or VPC-selected interfaces. The least-significant host bit must be 1."},"inlineRoutingProfile":{"oneOf":[{"$ref":"#/components/schemas/InterfaceInlineRoutingProfile"},{"type":"null"}],"description":"Inline interface-local routing profile options. Only valid for VPC-backed interfaces."},"status":{"$ref":"#/components/schemas/InterfaceStatus","description":"Status of the Interface"},"created":{"type":"string","description":"Date/time when the Interface was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Interface was last updated","format":"date-time","readOnly":true}}},"InterfaceStatus":{"title":"InterfaceStatus","type":"string","description":"Status values for Interface objects","enum":["Pending","Provisioning","Ready","Deleting","Error"]},"IPFamily":{"title":"IPFamily","type":"string","description":"Address family requested for a VPC-selected Interface","enum":["IPv4","IPv6"]},"InterfaceInlineRoutingProfile":{"title":"InterfaceInlineRoutingProfile","type":"object","description":"Interface-local routing profile options that narrow the owning VPC's routing profile.","properties":{"allowedAnycastPrefixes":{"type":"array","description":"CIDR prefixes this interface is allowed to announce as anycast routes.","default":[],"items":{"type":"string","example":"192.0.2.0/24"}}}},"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},{"vpcId":"bdd3d1af-b4a8-4675-a59c-56548716ef45","ipFamilies":["IPv4"],"isPhysical":true}],"description":"Request data to create an Interface for an Instance by associating it with a Subnet, an explicit VPC Prefix, or a VPC from which the Controller selects a prefix. Exactly one of `subnetId`, `vpcPrefixId`, or `vpcId` must be specified.\n\nIf the VPC specified in the request has FNN virtualization type, all interfaces must specify either `vpcPrefixId` or `vpcId`.\n\nIf the VPC has Ethernet network virtualization type then all interfaces must specify Subnet.","properties":{"subnetId":{"type":"string","description":"ID of the Subnet to attach to the Interface","format":"uuid"},"vpcPrefixId":{"type":"string","description":"ID of the VPC Prefix to attach to the Interface","format":"uuid"},"vpcId":{"type":"string","description":"ID of the VPC from which the Controller should select a prefix. `ipFamilies` must also be specified, and `ipAddress` cannot be specified.","format":"uuid"},"ipFamilies":{"type":"array","minItems":1,"description":"Address families requested for Controller prefix selection. Required with `vpcId` and prohibited otherwise. Only `IPv4` is currently accepted.","items":{"type":"string","enum":["IPv4"]}},"ipAddress":{"type":["string","null"],"description":"Explicitly requested IP address for the interface. It can only be specified with an explicit `vpcPrefixId`. The least-significant host bit must be 1."},"inlineRoutingProfile":{"oneOf":[{"$ref":"#/components/schemas/InterfaceInlineRoutingProfile"},{"type":"null"}],"description":"Inline interface-local routing profile options. It cannot be specified for Subnet-based interfaces."},"isPhysical":{"type":"boolean","description":"Specifies whether this network should be attached to the Instance over a 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":0,"maximum":15}},"oneOf":[{"required":["subnetId"]},{"required":["vpcPrefixId"]},{"required":["vpcId"]}],"dependentRequired":{"vpcId":["ipFamilies"],"ipFamilies":["vpcId"]},"dependentSchemas":{"subnetId":{"properties":{"ipAddress":{"type":"null"},"inlineRoutingProfile":{"type":"null"}}},"vpcId":{"properties":{"ipAddress":{"type":"null"}}}}},"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","description":"Unique UUID v4 identifier for the InfiniBandInterface","minLength":1,"format":"uuid"},"instanceId":{"type":"string","description":"ID of the associated Instance","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"},"vendor":{"type":["string","null"],"description":"Name of the InfiniBand device vendor associated with this interface"},"deviceInstance":{"type":"integer","description":"Index of the device where partition attach to"},"isPhysical":{"type":"boolean","description":"Indicates whether this is a physical interface"},"virtualFunctionId":{"type":["integer","null"],"description":"Must be specified if isPhysical is false"},"guid":{"type":["string","null"],"description":"Must be specified if isPhysical is false"},"status":{"$ref":"#/components/schemas/InfiniBandInterfaceStatus","description":"Status of the InfiniBandInterface"},"created":{"type":"string","description":"Date/time when the InfiniBandInterface was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the InfiniBandInterface was last updated","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","description":"Unique UUID v4 identifier for the NVLinkInterface","minLength":1,"format":"uuid"},"instanceId":{"type":"string","description":"ID of the associated Instance","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","description":"Status of the NVLinkInterface"},"created":{"type":"string","description":"Date/time when the NVLinkInterface was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the NVLinkInterface was last updated","format":"date-time","readOnly":true},"deprecations":{"type":"array","description":"Deprecations active for this resource. Returned only if there are active deprecations.","items":{"$ref":"#/components/schemas/Deprecation"}}}},"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"},"hardwareRevision":{"type":["string","null"],"description":"Hardware revision 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","description":"Physical or logical location of the Rack"},"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","description":"Expected component value"},"actual":{"$ref":"#/components/schemas/RackComponent","description":"Actual component value reported by the system"},"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"},"operationStatus":{"type":"string","enum":["Unknown","Initializing","Ready","InUse","Error","Deleting"],"description":"Flow-derived operability phase of the component"},"leakStatus":{"type":"string","enum":["Unknown","NoLeak","Leaking"],"description":"Whether the component is considered leaking coolant"}}},"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"},"operationStatus":{"type":"string","enum":["Unknown","Initializing","Ready","InUse","Error","Deleting"],"description":"Flow-derived operability phase of the tray"},"leakStatus":{"type":"string","enum":["Unknown","NoLeak","Leaking"],"description":"Whether the tray is considered leaking coolant"},"position":{"$ref":"#/components/schemas/TrayPosition","description":"Position of the Tray within the Rack"},"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`. `slotId` requires `rackId` or `rackName`, must be >= 0, and composes with the rest of the filter via AND.","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"},"slotId":{"type":"integer","format":"int32","minimum":0,"description":"Restrict to trays at this rack slot (matches `position.slotId`). Requires `rackId` or `rackName`. Composes with the rest of the filter via AND."}}},"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","description":"Filter that selects Racks whose power state should be updated"},"state":{"type":"string","enum":["on","off","cycle","forceoff","forcecycle"],"description":"Target power state"},"ruleId":{"type":"string","format":"uuid","description":"Optional Operation Rule UUID. When set, pins every task spawned by\nthis batch to the named rule and overrides Flow's default rule\nresolution."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"When true, proceed even if one or more target components (or hosts\non the owning rack for rack-scoped components) are reported as not\nready by their persisted status. Intended for operator-supervised\nmaintenance."}}},"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","description":"Filter that selects Trays whose power state should be updated"},"state":{"type":"string","enum":["on","off","cycle","forceoff","forcecycle"],"description":"Target power state"},"ruleId":{"type":"string","format":"uuid","description":"Optional Operation Rule UUID. When set, pins every task spawned by\nthis batch to the named rule and overrides Flow's default rule\nresolution."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"When true, proceed even if one or more target components (or hosts\non the owning rack for rack-scoped components) are reported as not\nready by their persisted status. Intended for operator-supervised\nmaintenance."}}},"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","description":"Filter that selects Racks targeted for firmware update"},"version":{"type":["string","null"],"description":"Target firmware version."},"ruleId":{"type":"string","format":"uuid","description":"Optional Operation Rule UUID. When set, pins every task spawned by\nthis batch to the named rule and overrides Flow's default rule\nresolution."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"When true, proceed even if one or more target components (or hosts\non the owning rack for rack-scoped components) are reported as not\nready by their persisted status. Intended for operator-supervised\nmaintenance."}}},"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"},"ruleId":{"type":"string","format":"uuid","description":"Optional Operation Rule UUID. When set, pins this bring-up to the\nnamed rule and overrides Flow's default rule resolution."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"When true, proceed even if one or more target components (or hosts\non the owning rack) are reported as not ready by their persisted\nstatus. Intended for operator-supervised maintenance."}},"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":"Filter that selects Racks targeted for bring-up"},"description":{"type":"string","description":"Optional description for the bring up operation"},"ruleId":{"type":"string","format":"uuid","description":"Optional Operation Rule UUID. When set, pins every bring-up task\nspawned by this batch to the named rule and overrides Flow's default\nrule resolution."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"When true, proceed even if one or more target components (or hosts\non the owning rack) are reported as not ready by their persisted\nstatus. Intended for operator-supervised maintenance."}}},"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"]}]},"Task":{"title":"Task","type":"object","description":"A task representing an asynchronous, site-scoped operation against rack, tray, or other site 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."},"ruleId":{"type":["string","null"],"format":"uuid","description":"Operation Rule that Flow resolved for this task — either because\nthe caller pinned one via `ruleId` on the originating request or\nbecause Flow's default rule resolution picked it. Null if Flow\nhas not yet recorded a resolution."},"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."},"report":{"allOf":[{"$ref":"#/components/schemas/TaskReportV1"}],"description":"Structured v1 execution report for the task. Populated on single-task `GET` and `cancel` responses, and on list responses only when `includeReport=true` is set. Omitted when the task has not yet produced a report (e.g. still queued) or when the caller did not opt in on list endpoints.\n\nA future schema revision will be exposed as a new `TaskReportV2` schema referenced from a parallel response field; v1 consumers are not disturbed by that bump.\n"}},"examples":[{"id":"550e8400-e29b-41d4-a716-446655440000","status":"Running","description":"Power on rack components","message":"Processing 3 of 5 components","ruleId":"7c9e6679-7425-40de-944b-e07fc1f90ae7","report":{"version":1,"stages":[{"number":1,"status":"completed","startedAt":"2026-06-08T18:00:00Z","finishedAt":"2026-06-08T18:00:42Z","steps":[{"componentType":"Compute","status":"completed","totalComponents":4,"startedAt":"2026-06-08T18:00:00Z","finishedAt":"2026-06-08T18:00:42Z"}]},{"number":2,"status":"running","startedAt":"2026-06-08T18:00:42Z","steps":[{"componentType":"NVLSwitch","status":"running","totalComponents":2,"startedAt":"2026-06-08T18:00:42Z"},{"componentType":"PowerShelf","status":"skipped","totalComponents":0}]}]}}]},"OperationRule":{"title":"OperationRule","type":"object","description":"An Operation Rule template for a single (operationType, operationCode) tuple.\nThe `ruleDefinition` carries the executable schedule (stages, per-component\nconcurrency, actions, retry) Flow runs when this rule is selected for an\noperation.","required":["id","name","operationType","operationCode","ruleDefinition","isDefault","created","updated"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the rule."},"name":{"type":"string","description":"Human-readable name of the rule. Required and non-empty."},"description":{"type":"string","description":"Optional free-form description."},"operationType":{"type":"string","enum":["PowerControl","FirmwareControl"],"description":"Type of operation this rule applies to. Immutable after creation."},"operationCode":{"type":"string","description":"Operation code within the operation type (e.g. `power_on`, `power_off`,\n`upgrade`). Server-side validated against Flow's allow-list for the type.\nImmutable after creation."},"ruleDefinition":{"$ref":"#/components/schemas/RuleDefinition"},"isDefault":{"type":"boolean","description":"Whether this rule is currently the default for its `(operationType,\noperationCode)` tuple."},"created":{"type":"string","format":"date-time","description":"Timestamp when the rule was created."},"updated":{"type":"string","format":"date-time","description":"Timestamp when the rule was last updated."}}},"RuleDefinition":{"title":"RuleDefinition","type":"object","description":"Executable definition of a rule. Mirrors Flow's wire schema 1:1 so existing\nYAML rule files can be converted to JSON without any key renaming\n(nested fields use `snake_case`).","required":["version"],"properties":{"version":{"type":"string","description":"Schema version. Currently always `v1`.","enum":["v1"]},"steps":{"type":"array","description":"Ordered execution steps. Steps with the same `stage` run in parallel,\nstages run sequentially in ascending numerical order. May be empty for\noperations whose sequencing is hardcoded in Flow (e.g. bring-up,\nfirmware update).","items":{"$ref":"#/components/schemas/SequenceStep"}}}},"SequenceStep":{"title":"SequenceStep","type":"object","description":"A single execution step inside a `RuleDefinition`.","required":["componentType","stage","mainOperation"],"properties":{"componentType":{"type":"string","description":"Component type this step targets (e.g. `Compute`, `NVLSwitch`,\n`PowerShelf`). Validated against Flow's component-type set."},"stage":{"type":"integer","minimum":1,"description":"Stage number; steps with the same stage run in parallel, lower stages run\nfirst. Component types must be unique within a stage."},"maxParallel":{"type":"integer","minimum":0,"description":"Maximum number of components of this type processed concurrently. `0`\nmeans unlimited, `1` means strictly sequential."},"timeout":{"type":"string","description":"Optional child-workflow timeout for this step, as a Go duration string\n(e.g. `30s`, `2m`). Applies to pre + main + post combined."},"retry":{"$ref":"#/components/schemas/RetryPolicy"},"preOperation":{"type":"array","description":"Actions to run before the main operation.","items":{"$ref":"#/components/schemas/ActionConfig"}},"mainOperation":{"$ref":"#/components/schemas/ActionConfig"},"postOperation":{"type":"array","description":"Actions to run after the main operation.","items":{"$ref":"#/components/schemas/ActionConfig"}},"delayAfter":{"type":"string","description":"Deprecated legacy field — sleep duration after this step, as a Go\nduration string. Prefer encoding the wait as an explicit `Sleep`\npost-operation action."}}},"ActionConfig":{"title":"ActionConfig","type":"object","description":"Configuration for a single action within a step.","required":["name"],"properties":{"name":{"type":"string","enum":["Sleep","PowerControl","VerifyPowerStatus","VerifyReachability","GetPowerStatus","FirmwareControl","VerifyFirmwareVersion","VerifyFirmwareConsistency","BringUpControl","WaitBringUp","InjectExpectation"],"description":"Executor-agnostic action name. Server-side validated; unknown names\nfail the rule definition."},"timeout":{"type":"string","description":"Optional per-action timeout override as a Go duration string\n(e.g. `30s`, `2m`)."},"pollInterval":{"type":"string","description":"Poll interval for actions that loop (e.g. `FirmwareControl`,\n`VerifyPowerStatus`) as a Go duration string."},"parameters":{"type":"object","additionalProperties":true,"description":"Action-specific parameters. Validated server-side against the action's\nschema. Examples:\n  - `Sleep`: `{ duration: \"30s\" }`\n  - `PowerControl`: `{ operation: \"on\" }`\n  - `VerifyPowerStatus`: `{ expected_status: \"on\" }`\n  - `VerifyReachability`: `{ component_types: [\"Compute\"], require_all: true }`\n  - `FirmwareControl`: `{ poll_interval: \"10s\", poll_timeout: \"30m\" }`"}}},"RetryPolicy":{"title":"RetryPolicy","type":"object","description":"Retry behavior for a step's child workflow.","required":["maxAttempts","initialInterval","backoffCoefficient"],"properties":{"maxAttempts":{"type":"integer","minimum":1,"description":"Maximum number of attempts including the first."},"initialInterval":{"type":"string","description":"Initial retry interval, as a Go duration string (e.g. `1s`)."},"backoffCoefficient":{"type":"number","minimum":1,"description":"Exponential backoff multiplier; must be `>= 1.0`."},"maxInterval":{"type":"string","description":"Optional cap on retry interval, as a Go duration string."}}},"CreateRuleRequest":{"title":"CreateRuleRequest","type":"object","description":"Request body for creating an Operation Rule.","required":["siteId","name","operationType","operationCode","ruleDefinition"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site to create the rule on."},"name":{"type":"string","description":"Human-readable name of the rule."},"description":{"type":"string","description":"Optional free-form description."},"operationType":{"type":"string","enum":["PowerControl","FirmwareControl"],"description":"Operation type the rule applies to."},"operationCode":{"type":"string","description":"Operation code within the operation type (e.g. `power_on`)."},"ruleDefinition":{"$ref":"#/components/schemas/RuleDefinition"}}},"UpdateRuleRequest":{"title":"UpdateRuleRequest","type":"object","description":"Request body for patching an Operation Rule. All mutable fields are optional;\nunset fields are left unchanged. At least one of `name`, `description`,\n`ruleDefinition` must be provided.","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site that owns the rule."},"name":{"type":"string","description":"New rule name. Must be non-empty when provided."},"description":{"type":"string","description":"New free-form description."},"ruleDefinition":{"$ref":"#/components/schemas/RuleDefinition"}}},"TaskRun":{"title":"TaskRun","type":"object","description":"A Task Run is a phased, policy-gated execution of one operation across\nmany Racks. List responses populate the summary fields; the\nsingle-Task-Run `GET` additionally populates `stats` when\n`includeStats=true`.","required":["id","name","operationType","status","statusReason","totalPhases","created","updated"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the Task Run."},"name":{"type":"string","description":"Human-readable name of the Task Run."},"description":{"type":"string","description":"Optional free-form description."},"operationType":{"type":"string","enum":["PowerControl","FirmwareControl"],"description":"Type of operation this Task Run executes. Currently always `FirmwareControl`."},"operationCode":{"type":"string","description":"Operation code within the operation type (e.g. `upgrade`)."},"status":{"type":"string","enum":["Unknown","Pending","Running","Paused","Completed","Cancelled","Failed","CompletedWithFailures"],"description":"Current lifecycle state of the Task Run."},"statusReason":{"type":"string","enum":["Unknown","None","OperatorPaused","PhaseGate","SafetyGate","ConflictRetryTimeout"],"description":"Why the Task Run is paused or terminal (e.g. `PhaseGate`, `SafetyGate`).\n`None` when there is no qualifying reason."},"statusMessage":{"type":"string","description":"Optional human-readable detail for the current status."},"totalPhases":{"type":"integer","description":"Total number of phases the selected targets were divided into."},"created":{"type":"string","format":"date-time","description":"Timestamp when the Task Run was created."},"updated":{"type":"string","format":"date-time","description":"Timestamp when the Task Run was last updated."},"started":{"type":["string","null"],"format":"date-time","description":"Timestamp when the Task Run started execution. Null before it starts."},"finished":{"type":["string","null"],"format":"date-time","description":"Timestamp when the Task Run reached a terminal state. Null while active."},"stats":{"allOf":[{"$ref":"#/components/schemas/TaskRunStats"}],"description":"Derived per-phase outcome stats. Present only on the single-Task-Run\n`GET` when `includeStats=true`; omitted otherwise."}}},"TaskRunStats":{"title":"TaskRunStats","type":"object","description":"Summarizes target outcomes for the active phase and cumulatively across all phases processed so far.","required":["currentPhase","cumulativePhase"],"properties":{"currentPhase":{"$ref":"#/components/schemas/TaskRunPhaseStats"},"cumulativePhase":{"$ref":"#/components/schemas/TaskRunPhaseStats"}}},"TaskRunPhaseStats":{"title":"TaskRunPhaseStats","type":"object","description":"Summarizes target outcomes for one phase scope.","required":["phaseIndex","selectedTargets","outcomeCounts"],"properties":{"phaseIndex":{"type":"integer","description":"Zero-based index of the phase this scope refers to."},"selectedTargets":{"type":"integer","description":"Number of targets selected within the scope."},"outcomeCounts":{"$ref":"#/components/schemas/TaskRunOutcomeCounts"}}},"TaskRunOutcomeCounts":{"title":"TaskRunOutcomeCounts","type":"object","description":"Counts terminal target outcomes within a phase scope.","required":["completed","failed","terminated","skipped"],"properties":{"completed":{"type":"integer","description":"Targets that completed successfully."},"failed":{"type":"integer","description":"Targets that failed."},"terminated":{"type":"integer","description":"Targets that were terminated (e.g. by cancellation)."},"skipped":{"type":"integer","description":"Targets that were skipped."}}},"TaskRunTarget":{"title":"TaskRunTarget","type":"object","description":"One materialized per-Rack execution target of a Task Run. Each target\ndrives at most one Task; `taskId` references it (null until the target is\nsubmitted).","required":["id","runId","rackId","sequenceIndex","phaseIndex","status","created","updated"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the target."},"runId":{"type":"string","format":"uuid","description":"ID of the Task Run that owns this target."},"rackId":{"type":"string","format":"uuid","description":"ID of the Rack this target operates on."},"sequenceIndex":{"type":"integer","description":"Position of this target in the Task Run's overall processing order."},"phaseIndex":{"type":"integer","description":"Zero-based index of the phase this target belongs to."},"taskId":{"type":["string","null"],"format":"uuid","description":"ID of the Task this target submitted. Null until the target is\nsubmitted; drill into execution detail via `GET /task/{taskId}`."},"status":{"type":"string","enum":["Unknown","Pending","Blocked","Submitted","Completed","Failed","Terminated","Skipped","Claimed"],"description":"Current execution state of the target."},"message":{"type":"string","description":"Optional human-readable detail for the current target status."},"created":{"type":"string","format":"date-time","description":"Timestamp when the target was created."},"updated":{"type":"string","format":"date-time","description":"Timestamp when the target was last updated."}}},"TaskRunSiteRequest":{"title":"TaskRunSiteRequest","type":"object","description":"Shared request body for the pause and resume lifecycle actions.","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site that owns the Task Run (Task Runs are site-scoped)."}}},"AdvanceTaskRunRequest":{"title":"AdvanceTaskRunRequest","type":"object","description":"Request body for advancing a Task Run to its next phase.","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site that owns the Task Run."},"expectedPhaseIndex":{"type":"integer","description":"Optional guard: when set, the phase that would be opened must match\nthis zero-based index, otherwise the advance is rejected."}}},"CancelTaskRunRequest":{"title":"CancelTaskRunRequest","type":"object","description":"Request body for cancelling a Task Run.","required":["siteId"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site that owns the Task Run."},"reason":{"type":"string","description":"Optional free-form reason recorded with the cancellation."}}},"CreateTaskRunRequest":{"title":"CreateTaskRunRequest","type":"object","description":"Request body for creating a Task Run. `operationType` is inferred from the\noperation and is not accepted here. Flow performs semantic validation\n(selector ranges, phase math, operation code membership) server-side.","required":["siteId","name","options","operation"],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site to create the Task Run on."},"name":{"type":"string","description":"Human-readable name of the Task Run."},"description":{"type":"string","description":"Optional free-form description."},"selector":{"allOf":[{"$ref":"#/components/schemas/TaskRunSelector"}],"description":"Narrows the candidate Racks. Omit to target the full candidate scope\n(100%)."},"options":{"$ref":"#/components/schemas/TaskRunOptions"},"operation":{"$ref":"#/components/schemas/TaskRunOperation"}}},"TaskRunSelector":{"title":"TaskRunSelector","type":"object","description":"Selects a subset of candidate Racks. Percentage is the only supported selector today.","properties":{"percentage":{"$ref":"#/components/schemas/TaskRunPercentageSelector"}}},"TaskRunPercentageSelector":{"title":"TaskRunPercentageSelector","type":"object","description":"Selects a percentage of the candidate Racks. `seed` is optional; when\nomitted Flow generates and stores one so the cohort is deterministic and\nauditable.","required":["percent"],"properties":{"percent":{"type":"integer","minimum":0,"maximum":100,"description":"Percentage of candidate Racks to select."},"seed":{"type":"string","description":"Optional seed for the deterministic selection."}}},"TaskRunOptions":{"title":"TaskRunOptions","type":"object","description":"Execution policy for the Task Run.","required":["maxConcurrentTargets"],"properties":{"maxConcurrentTargets":{"type":"integer","minimum":1,"description":"Caps how many targets may have active child Tasks at once. Must be\ngreater than zero."},"safetyPolicy":{"$ref":"#/components/schemas/TaskRunSafetyPolicy"},"conflictPolicy":{"$ref":"#/components/schemas/TaskRunConflictPolicy"},"orderingPolicy":{"$ref":"#/components/schemas/TaskRunOrderingPolicy"},"phasePolicy":{"$ref":"#/components/schemas/TaskRunPhasePolicy"}}},"TaskRunSafetyPolicy":{"title":"TaskRunSafetyPolicy","type":"object","description":"A set of gates that pause the Task Run when any one of them trips (OR composition).","properties":{"gates":{"type":"array","description":"Safety gates evaluated after each target outcome.","items":{"$ref":"#/components/schemas/TaskRunSafetyGate"}}}},"TaskRunSafetyGate":{"title":"TaskRunSafetyGate","type":"object","description":"Exactly one of `failureRate` or `failureCount` must be set.","properties":{"failureRate":{"$ref":"#/components/schemas/TaskRunFailureRateGate"},"failureCount":{"$ref":"#/components/schemas/TaskRunFailureCountGate"}}},"TaskRunFailureRateGate":{"title":"TaskRunFailureRateGate","type":"object","description":"Pauses when the failed/planned ratio reaches `thresholdPercent` for the scope.","required":["thresholdPercent"],"properties":{"scope":{"type":"string","enum":["currentPhase","cumulativeRun"],"default":"currentPhase","description":"Whether the ratio is evaluated over the current phase or the cumulative run."},"thresholdPercent":{"type":"integer","minimum":0,"maximum":100,"description":"Failure-rate percentage at which the gate trips."}}},"TaskRunFailureCountGate":{"title":"TaskRunFailureCountGate","type":"object","description":"Pauses when the number of failed targets reaches `thresholdCount` for the scope.","required":["thresholdCount"],"properties":{"scope":{"type":"string","enum":["currentPhase","cumulativeRun"],"default":"currentPhase","description":"Whether the count is evaluated over the current phase or the cumulative run."},"thresholdCount":{"type":"integer","minimum":0,"description":"Number of failed targets at which the gate trips."}}},"TaskRunConflictPolicy":{"title":"TaskRunConflictPolicy","type":"object","description":"Configures how blocked targets are retried. Retry is the only supported strategy today.","properties":{"retry":{"$ref":"#/components/schemas/TaskRunConflictRetry"}}},"TaskRunConflictRetry":{"title":"TaskRunConflictRetry","type":"object","description":"Retry backoff for blocked targets. Durations are Go duration strings\n(e.g. `30m`, `10s`); an empty value means \"use the operation default\".","properties":{"retryTimeout":{"type":"string","description":"Total time to keep retrying a blocked target before giving up."},"initialRetryDelay":{"type":"string","description":"Delay before the first retry."},"maxRetryDelay":{"type":"string","description":"Cap on the exponentially growing retry delay."}}},"TaskRunOrderingPolicy":{"title":"TaskRunOrderingPolicy","type":"object","description":"Controls the order in which targets are processed. Random is the only supported ordering today.","properties":{"random":{"$ref":"#/components/schemas/TaskRunRandomOrdering"}}},"TaskRunRandomOrdering":{"title":"TaskRunRandomOrdering","type":"object","description":"Orders targets randomly. `seed` is optional; Flow generates and stores one when omitted.","properties":{"seed":{"type":"string","description":"Optional seed for the deterministic random ordering."}}},"TaskRunPhasePolicy":{"title":"TaskRunPhasePolicy","type":"object","description":"Divides the selected targets into phases. Set at most one of `equal`,\n`percentage`, or `count`; omit the whole policy for a single phase\ncovering all targets.","properties":{"equal":{"$ref":"#/components/schemas/TaskRunEqualPhases"},"percentage":{"$ref":"#/components/schemas/TaskRunPercentagePhases"},"count":{"$ref":"#/components/schemas/TaskRunCountPhases"},"autoAdvance":{"type":"boolean","default":false,"description":"When true, phases advance automatically as long as safety gates are\nnot tripped. When false (default) each completed phase pauses at a\nphase gate until advanced explicitly."}}},"TaskRunEqualPhases":{"title":"TaskRunEqualPhases","type":"object","description":"Splits targets into up to `phaseCount` roughly equal phases. Phases that\nwould contain no selected targets are omitted.","required":["phaseCount"],"properties":{"phaseCount":{"type":"integer","minimum":1,"description":"Number of equally sized phases."}}},"TaskRunPercentagePhases":{"title":"TaskRunPercentagePhases","type":"object","description":"Splits targets by percentage. Values must sum to 100. A configured\nphase is omitted when its percentage rounds down to zero selected\ntargets.","required":["phases"],"properties":{"phases":{"type":"array","description":"Per-phase percentages, in phase order; must sum to 100.","items":{"type":"integer","minimum":0,"maximum":100}}}},"TaskRunCountPhases":{"title":"TaskRunCountPhases","type":"object","description":"Splits targets by explicit counts. A generated final phase covers any remaining targets.","required":["phases"],"properties":{"phases":{"type":"array","description":"Per-phase target counts, in phase order.","items":{"type":"integer","minimum":0}}}},"TaskRunOperation":{"title":"TaskRunOperation","type":"object","description":"The operation the Task Run executes. Firmware is the only supported operation today.","required":["firmware"],"properties":{"firmware":{"$ref":"#/components/schemas/TaskRunFirmwareOperation"},"excludeRunIds":{"type":"array","description":"Excludes Racks materialized by prior Task Runs from this Task Run's\ncandidate scope.","items":{"type":"string","format":"uuid"}}}},"TaskRunFirmwareOperation":{"title":"TaskRunFirmwareOperation","type":"object","description":"Configures a firmware rollout.","required":["version"],"properties":{"version":{"type":"string","description":"Target firmware version to roll out."},"ruleId":{"type":["string","null"],"format":"uuid","description":"Operation Rule to pin for each target's firmware Task. Null to let\nFlow's default rule resolution pick one."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"Skip the pre-flight readiness check when true."},"subTargets":{"type":"array","description":"Optional subset of firmware sub-targets to update.","items":{"type":"string"}}}},"TaskReportV1":{"title":"TaskReportV1","type":"object","description":"Structured execution report (version 1) for a Flow-scheduled task.\nThe document mirrors the structure of the operation rule that drives the workflow: each `Stage` corresponds to one rule stage and each `Step` within a stage corresponds to one rule sequence step at the same index.\n\nClients pick the decoder by the `version` field; future report schemas will be exposed as `TaskReportV2` etc. and conveyed via a parallel response field, leaving v1 consumers untouched.\n","required":["version","stages"],"properties":{"version":{"type":"integer","enum":[1],"description":"Schema version of this report. Always `1` for `TaskReportV1`."},"stages":{"type":"array","items":{"$ref":"#/components/schemas/TaskReportV1Stage"}},"error":{"type":"string","description":"Top-level failure summary: the message from the first stage that fails in this report. Not overwritten by subsequent failures, so it remains the canonical task-level error. Truncated to 512 bytes by the producer.\n"}}},"TaskReportV1Stage":{"title":"TaskReportV1Stage","type":"object","description":"Execution state of one rule stage. `number` is the canonical key for joining a stage record back to its rule entry.\n","required":["number","status","steps"],"properties":{"number":{"type":"integer","minimum":1,"description":"1-based rule stage number."},"status":{"$ref":"#/components/schemas/TaskReportV1Status"},"steps":{"type":"array","items":{"$ref":"#/components/schemas/TaskReportV1Step"}},"startedAt":{"type":"string","format":"date-time","description":"Set when the stage leaves `pending`."},"finishedAt":{"type":"string","format":"date-time","description":"Set when the stage reaches a terminal state."},"error":{"type":"string","description":"Failure summary when `status == failed`. Truncated to 512 bytes."}}},"TaskReportV1Step":{"title":"TaskReportV1Step","type":"object","description":"Execution state of one rule sequence step. Pairs 1:1 with the rule's ordered steps within the containing stage and shares its index.\n","required":["componentType","status"],"properties":{"componentType":{"type":"string","description":"Component class this step targets, e.g. `Compute`, `NVLSwitch`, `PowerShelf`."},"status":{"$ref":"#/components/schemas/TaskReportV1Status"},"totalComponents":{"type":"integer","description":"Count of components of `componentType` this step targets. Surfaced here because the task representation does not include the per-type component map.\n"},"completedComponents":{"type":"integer","description":"Reserved for a future best-effort activity contract that reports per-component outcomes. Not written under the current fail-fast contract and omitted by the producer.\n"},"failedComponents":{"type":"integer","description":"Reserved (see `completedComponents`)."},"startedAt":{"type":"string","format":"date-time","description":"Set when the step leaves `pending`. `skipped` steps carry no timestamp."},"finishedAt":{"type":"string","format":"date-time","description":"Set when the step reaches a terminal state."},"error":{"type":"string","description":"Failure summary when `status == failed`. Truncated to 512 bytes."}}},"TaskReportV1Status":{"title":"TaskReportV1Status","type":"string","description":"Per-stage and per-step execution status.\n\n- `pending`   — workflow has not yet reached this stage/step.\n- `running`   — execution is in progress.\n- `completed` — execution finished successfully.\n- `failed`    — execution finished with an error; see `error`.\n- `skipped`   — the rule lists this component type but the task targets no components of that type, so the workflow will not invoke it.\n","enum":["pending","running","completed","failed","skipped"]},"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","description":"Filter that selects Trays targeted for firmware update"},"version":{"type":["string","null"],"description":"Target firmware version."},"targets":{"type":"array","items":{"type":"string","minLength":1,"enum":["bmc","cpld","bios","nvos","pmc","psu","dpu"]},"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 `NICo-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) for compute-tray-internal targets.\nUnknown names are rejected. Requires `version` to be set.\nThe special target `dpu`, valid only on compute trays,\nrequests DPU reprovisioning on each matched host. Unlike\nthe other targets, `dpu` is NOT covered by the\n\"omitted/empty means everything\" default — it must be\nlisted explicitly. `version` is ignored on the `dpu`\nbranch; the target firmware version comes from site\nconfiguration."},"ruleId":{"type":"string","format":"uuid","description":"Optional Operation Rule UUID. When set, pins every task spawned by\nthis batch to the named rule and overrides Flow's default rule\nresolution."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"When true, proceed even if one or more target components (or hosts\non the owning rack for rack-scoped components) are reported as not\nready by their persisted status. Intended for operator-supervised\nmaintenance."}},"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)"},"ruleId":{"type":"string","format":"uuid","description":"Optional Operation Rule UUID. When set, pins this operation to the\nnamed rule and overrides Flow's default rule resolution."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"When true, proceed even if one or more target components (or hosts\non the owning rack for rack-scoped components) are reported as not\nready by their persisted status. Intended for operator-supervised\nmaintenance."}},"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","dpu"]},"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 `NICo-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) for compute-tray-internal targets.\nUnknown names are rejected. Requires `version` to be set.\nThe special target `dpu`, valid only on compute trays,\nrequests DPU reprovisioning on the matched host. Unlike\nthe other targets, `dpu` is NOT covered by the\n\"omitted/empty means everything\" default — it must be\nlisted explicitly. `version` is ignored on the `dpu`\nbranch; the target firmware version comes from site\nconfiguration."},"ruleId":{"type":"string","format":"uuid","description":"Optional Operation Rule UUID. When set, pins this firmware update to\nthe named rule and overrides Flow's default rule resolution."},"overrideReadinessCheck":{"type":"boolean","default":false,"description":"When true, proceed even if one or more target components (or hosts\non the owning rack for rack-scoped components) are reported as not\nready by their persisted status. Intended for operator-supervised\nmaintenance."}},"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,"scoutVersion":"2.6.1","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"},"description":"List of capabilities of the machine"},"machineInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/MachineInterface"},"description":"List of admin interfaces of the machine"},"associatedDpuMachineIds":{"type":"array","items":{"type":"string"},"description":"IDs of the DPU Machines attached to this host Machine","readOnly":true},"placementInRack":{"$ref":"#/components/schemas/PlacementInRack","description":"Physical placement of the Machine within its Rack, when known"},"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"},"scoutVersion":{"type":["string","null"],"description":"Scout version reported by the Machine, if known","readOnly":true},"health":{"$ref":"#/components/schemas/MachineHealth","description":"Health information about the machine"},"metadata":{"$ref":"#/components/schemas/MachineMetadata","description":"Only available to Providers. Returned if the `includeMetadata` query parameter is specified. Otherwise attribute is omitted from response."},"labels":{"$ref":"#/components/schemas/Labels","description":"User-specified Machine labels"},"status":{"$ref":"#/components/schemas/MachineStatus","description":"Status represents the status of the machine","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"},"description":"Chronological status history for the Machine"},"created":{"type":"string","description":"Date/time when the Machine was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Machine was last updated","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","description":"Status represents the status of the machine","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 by sending a merge-mode health override with source: `request-online-repair` and sets the associated Instance status to Repairing.\nWhen false, exits online repair by clearing the merge-mode health override and returns the Instance to Ready status. Cannot be combined with instance type, maintenance, or label updates in the same request."},"policy":{"$ref":"#/components/schemas/MachineOnlineRepairPolicy","description":"Online repair policy to apply to the Machine"},"acknowledgments":{"$ref":"#/components/schemas/MachineOnlineRepairAcknowledgments","description":"Acknowledgments required before online repair can proceed"}}},"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","description":"Request to enter/exit online repair"},"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","description":"Unique UUID v4 identifier for the Machine Interface","format":"uuid"},"machineId":{"type":"string","description":"ID of the Machine"},"controllerInterfaceId":{"type":["string","null"],"description":"ID of the interface in Site Controller","format":"uuid"},"controllerSegmentId":{"type":["string","null"],"description":"ID of the network segment in Site Controller","format":"uuid"},"attachedDpuMachineID":{"type":["string","null"],"description":"ID of the DPU attached to this interface in the Site Controller"},"subnetId":{"type":["string","null"],"description":"ID of the Subnet","format":"uuid"},"hostname":{"type":["string","null"],"description":"Hostname of the Machine Interface","format":"hostname"},"isPrimary":{"type":"boolean","description":"Boolean which indicates if the Machine Interface is primary"},"macAddress":{"type":["string","null"],"description":"Mac address of the Machine Interface"},"ipAddresses":{"type":"array","description":"Array of IP addresses","items":{"type":"string"}},"created":{"type":"string","description":"Date/time when the Machine Interface was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Machine Interface was last updated","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"}],"lifecycleState":{"value":"Ready","isAboveSLA":false,"updated":"2026-01-15T12:00:00Z","slaSeconds":300}}],"properties":{"dmiData":{"$ref":"#/components/schemas/MachineDMIData","description":"DMI data of the machine"},"bmcInfo":{"$ref":"#/components/schemas/MachineBMCInfo","description":"BMC Info of the machine"},"gpus":{"type":"array","items":{"$ref":"#/components/schemas/MachineGPUInfo"},"description":"GPU inventory reported for the Machine"},"networkInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/MachineNetworkInterface"},"description":"List of Ethernet interfaces of the machine"},"infinibandInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/MachineInfiniBandInterface"},"description":"List of InfiniBand interfaces of the machine"},"lifecycleState":{"oneOf":[{"$ref":"#/components/schemas/MachineLifecycleState"},{"type":"null"}],"description":"Lifecycle state details for the Machine"}}},"MachineLifecycleState":{"title":"MachineLifecycleState","type":"object","description":"Describes the current Machine lifecycle state and its SLA status","required":["value","isAboveSLA","slaSeconds"],"examples":[{"value":"Ready","isAboveSLA":false,"updated":"2026-01-15T12:00:00Z","slaSeconds":300}],"properties":{"value":{"type":"string","description":"Current lifecycle state value of the Machine"},"isAboveSLA":{"type":"boolean","description":"Whether the Machine has been in the current state longer than the defined SLA"},"updated":{"type":["string","null"],"description":"Date/time when the lifecycle state was updated to the current value","format":"date-time"},"slaSeconds":{"type":"integer","format":"int64","description":"Defined SLA for the current lifecycle state in seconds"}}},"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"],"description":"IP address of the Machine BMC","format":"ipv4"},"mac":{"type":["string","null"],"description":"MAC address of the Machine BMC"},"version":{"type":["string","null"],"description":"Version reported by the Machine BMC"},"firmwareRevision":{"type":["string","null"],"description":"Firmware revision reported by the Machine BMC"}}},"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"],"description":"DMI board name reported by the Machine"},"boardSerial":{"type":["string","null"],"description":"DMI board serial number reported by the Machine"},"boardVersion":{"type":["string","null"],"description":"DMI board version reported by the Machine"},"biosDate":{"type":["string","null"],"description":"DMI BIOS release date reported by the Machine"},"biosVersion":{"type":["string","null"],"description":"DMI BIOS version reported by the Machine"},"productName":{"type":["string","null"],"description":"DMI product name reported by the Machine"},"productSerial":{"type":["string","null"],"description":"DMI product serial number reported by the Machine"},"chassisSerial":{"type":["string","null"],"description":"DMI chassis serial number reported by the Machine"},"sysVendor":{"type":["string","null"],"description":"DMI system vendor reported by the Machine"}}},"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"],"description":"Name of the Machine's GPU"},"serial":{"type":["string","null"],"description":"Serial number of the Machine's GPU"},"driverVersion":{"type":["string","null"],"description":"Version of the Machine's GPU driver"},"vbiosVersion":{"type":["string","null"],"description":"Bios version of the Machine's GPU"},"inforomVersion":{"type":["string","null"],"description":"Info rom version of the Machine's GPU"},"totalMemory":{"type":["string","null"],"description":"Total memory of the Machine's GPU"},"frequency":{"type":["string","null"],"description":"Frequency of the Machine's GPU"},"pciBusId":{"type":["string","null"],"description":"PCI BusId of the Machine's GPU"}}},"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","required":["id"],"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","required":["id","message"],"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"],"format":"date-time","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"}}},"PlacementInRack":{"title":"PlacementInRack","type":"object","description":"Physical placement of a Machine within its Rack","examples":[{"slotNumber":1,"trayIndex":0}],"properties":{"slotNumber":{"type":["integer","null"],"format":"int32","description":"Rack slot the Machine occupies"},"trayIndex":{"type":["integer","null"],"format":"int32","description":"Index of the Machine's tray within its slot"}}},"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"],"description":"Name of the Machine's NetworkInterface"},"vendor":{"type":["string","null"],"description":"Serial number of the Machine's NetworkInterface"},"device":{"type":["string","null"],"description":"Device number of the Machine's NetworkInterface"},"path":{"type":["string","null"],"description":"Bios path of the Machine's NetworkInterface"},"numaNode":{"type":"integer","description":"Info of numa node Machine's NetworkInterface"},"description":{"type":["string","null"],"description":"Description the Machine's NetworkInterface"},"slot":{"type":["string","null"],"description":"Slot number of the Machine's NetworkInterface"}}},"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"],"description":"Guid of the Machine's InfiniBandInterface"},"vendor":{"type":["string","null"],"description":"Serial number of the Machine's InfiniBandInterface"},"device":{"type":["string","null"],"description":"Device number of the Machine's InfiniBandInterface"},"path":{"type":["string","null"],"description":"Bios path of the Machine's InfiniBandInterface"},"numaNode":{"type":"integer","description":"Info of numa node Machine's InfiniBandInterface"},"description":{"type":["string","null"],"description":"Description the Machine's InfiniBandInterface"},"slot":{"type":["string","null"],"description":"Slot number of the Machine's InfiniBandInterface"}}},"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","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","description":"ID of the associated Machine"},"instanceTypeId":{"type":"string","description":"ID of the associated Instance Type","format":"uuid"},"deprecations":{"type":"array","items":{"$ref":"#/components/schemas/Deprecation"},"description":"Deprecations active for this resource. Returned only if there are active deprecations."},"created":{"type":"string","description":"Date and time the Machine Instance Type was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date and time the Machine Instance Type was last updated","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","description":"ID of the Machine","minItems":1,"items":{"type":"string"}}},"required":["machineIds"]},"HostLifecycleProfile":{"title":"HostLifecycleProfile","type":"object","description":"Per-host lifecycle settings that affect how NICo progresses a host through its state machine.","properties":{"disableLockdown":{"type":["boolean","null"],"description":"When true, the server is not locked down during host lifecycle management. When omitted, the existing value is preserved."}}},"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","isDpfEnabled":true,"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"},"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"},"isDpfEnabled":{"type":"boolean","description":"When true, this host is eligible for DPF-based provisioning."},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Machines"},"hostLifecycleProfile":{"$ref":"#/components/schemas/HostLifecycleProfile","description":"Optional per-host lifecycle profile"},"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","isDpfEnabled":true,"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":16,"description":"Username for accessing the Expected Machine's BMC"},"defaultBmcPassword":{"type":["string","null"],"maxLength":20,"description":"Password for accessing the Expected Machine's BMC"},"chassisSerialNumber":{"type":"string","minLength":1,"maxLength":32,"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"},"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"},"isDpfEnabled":{"type":["boolean","null"],"description":"When true, this host is eligible for DPF-based provisioning."},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Machines"},"hostLifecycleProfile":{"$ref":"#/components/schemas/HostLifecycleProfile","description":"Optional per-host lifecycle profile"}},"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","isDpfEnabled":false,"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})$","deprecated":true,"description":"The Expected Machine's BMC MAC address is immutable after creation. Omit this field, or provide another case/separator spelling of the current MAC as a compatibility no-op."},"defaultBmcUsername":{"type":["string","null"],"maxLength":16,"description":"Username for accessing the Expected Machine's BMC"},"defaultBmcPassword":{"type":["string","null"],"maxLength":20,"description":"Password for accessing the Expected Machine's BMC"},"chassisSerialNumber":{"type":["string","null"],"minLength":1,"maxLength":32,"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). A non-empty address sets the value and pre-allocates a reserved IP for the BMC. An empty string clears the value. Omission or null preserves the current value."},"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"},"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"},"isDpfEnabled":{"type":["boolean","null"],"description":"When true, this host is eligible for DPF-based provisioning."},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value pairs for organizing and categorizing Expected Machines"},"hostLifecycleProfile":{"$ref":"#/components/schemas/HostLifecycleProfile","description":"Optional per-host lifecycle profile"}}},"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"},"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"},"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})$","deprecated":true,"description":"Immutable MAC address of the Expected Power Shelf's BMC (Baseboard Management Controller).\nOmit this field when updating. A formatting-equivalent value is accepted for compatibility\nand preserves the originally stored spelling, but changing the physical MAC address is rejected\nwith HTTP 400."},"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"},"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\nThe `rackId` field is immutable on update — omit it or provide the existing value.\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,"deprecated":true,"description":"Operator-supplied rack identifier. Immutable on update: omit this field, send `null`, or provide the existing value as a compatibility no-op. A changed value is rejected because Core and Flow use rackId as the identity key for expected racks."},"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","nvosMacAddresses":["00:1A:2B:3C:4D:60","00:1A:2B:3C:4D:61"],"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"},"nvosMacAddresses":{"type":"array","uniqueItems":true,"description":"MAC addresses of the Expected Switch's NvOS management interfaces","items":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$"}},"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"},"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","nvosMacAddresses":["00:1A:2B:3C:4D:60","00:1A:2B:3C:4D:61"],"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"},"nvosMacAddresses":{"type":"array","uniqueItems":true,"description":"MAC addresses of the Expected Switch's NvOS management interfaces","items":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$"}},"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"},"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","nvosMacAddresses":["00:1A:2B:3C:4D:62","00:1A:2B:3C:4D:63"],"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})$","deprecated":true,"description":"Immutable MAC address of the Expected Switch's BMC (Baseboard Management Controller).\nOmit this field when updating. A formatting-equivalent value is accepted for compatibility\nand preserves the originally stored spelling, but changing the physical MAC address is rejected\nwith HTTP 400."},"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"},"nvosMacAddresses":{"type":"array","uniqueItems":true,"description":"MAC addresses of the Expected Switch's NvOS management interfaces","items":{"type":"string","pattern":"^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$"}},"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"},"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","description":"Lenovo SR650 V2 compute node","schemaVersion":5,"deviceType":"gpu","associatedMachineIds":["fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g"],"components":{"cpus":[{"vendor":"Intel","model":"Xeon Platinum 8480+","threadCount":112,"count":2}],"gpus":[{"vendor":"NVIDIA","model":"H100 SXM5","totalMemory":"80GB HBM3","count":8}],"memory":[{"capacityMb":65536,"memoryType":"DDR5","count":16}],"storage":[{"vendor":"Samsung","model":"PM9A3","capacityMb":7680000,"count":4}],"chassis":{"vendor":"Supermicro","model":"SYS-420GP-TNR"}},"created":"2019-08-24T14:15:22Z"}],"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},"description":{"type":"string","description":"Human-readable SKU description","readOnly":true},"schemaVersion":{"type":"integer","format":"uint32","description":"Core SKU schema version when available","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, using the Site-reported timestamp when available","readOnly":true}}},"SkuCreateRequest":{"title":"SkuCreateRequest","type":"object","description":"Request data to create a SKU on a Site's NICo Core service.","examples":[{"siteId":"60189e9c-7d12-438c-b9ca-6998d9c364b1","id":"dgx-h100","description":"DGX H100 compute node","deviceType":"gpu-server","components":{"chassis":{"vendor":"NVIDIA","model":"DGX H100","architecture":"x86_64"}}}],"properties":{"siteId":{"type":"string","format":"uuid","description":"ID of the Site where the SKU will be created"},"id":{"type":"string","minLength":1,"description":"Unique SKU identifier"},"description":{"type":"string","description":"Human-readable SKU description"},"deviceType":{"type":["string","null"],"description":"Optional device type identifier"},"components":{"$ref":"#/components/schemas/SkuComponents"}},"required":["siteId","id","components"]},"SkuUpdateRequest":{"title":"SkuUpdateRequest","type":"object","description":"Request data to update a SKU.\nAt least one of description, deviceType, or components must be provided.\nThe service preserves the schema version for metadata-only updates.\nComponent updates replace the SKU using the current schema version,\nmigrating legacy SKU schemas to the current format.","examples":[{"description":"DGX H100 compute node with InfiniBand","components":{"infinibandDevices":[{"vendor":"Mellanox Technologies","model":"MT2910 Family [ConnectX-7]","count":4,"inactiveDevices":[]}]}}],"properties":{"description":{"type":"string","description":"Replacement SKU description"},"deviceType":{"type":"string","description":"Replacement device type identifier"},"components":{"$ref":"#/components/schemas/SkuComponents"}}},"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","readOnly":true,"description":"Read-only Ethernet device components reported by Core. Omit this property from REST mutation requests; null and an empty array are accepted for compatibility, while a non-empty array is rejected with HTTP 400.","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","examples":[{"vendor":"ARM","model":"Neoverse-V2","threadCount":72,"count":2}],"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","examples":[{"vendor":"NVIDIA","model":"NVIDIA GB200","totalMemory":"189471 MiB","count":4}],"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","examples":[{"capacityMb":491520,"memoryType":"LPDDR5","count":2}],"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","examples":[{"vendor":"","model":"SAMSUNG MZ1L21T9HCLS-00A07","capacityMb":0,"count":1,"minSizeMiB":1831420,"maxSizeMiB":1831420,"pciPatterns":["^/devices/pci.*nvme0$"]},{"vendor":"","model":"SAMSUNG MZTL63T8HFLT-00AW7","capacityMb":0,"count":8,"minSizeMiB":3662840,"maxSizeMiB":3662840,"pciPatterns":["^/devices/pci.*nvme[1-8]$"]}],"properties":{"vendor":{"type":"string","readOnly":true,"description":"Storage vendor used for schema version 4 matching. Read-only in REST mutation requests and preserved in responses for legacy SKUs. Schema version 5 does not use this field."},"model":{"type":"string","description":"Informational storage model. Starting with the 2.1 release, NICo does not use this field for storage matching or validation."},"capacityMb":{"type":"integer","format":"uint32","readOnly":true,"description":"Storage capacity in megabytes used for schema version 4 matching. Read-only in REST mutation requests and preserved in responses for legacy SKUs. Schema version 5 uses minSizeMiB and maxSizeMiB instead."},"count":{"type":"integer","format":"uint32","description":"Number of storage devices present"},"minSizeMiB":{"type":["integer","null"],"format":"uint32","description":"Inclusive minimum size in MiB for each storage device. Null or omission means no lower bound. Used for SKU schema version 5 and later."},"maxSizeMiB":{"type":["integer","null"],"format":"uint32","description":"Inclusive maximum size in MiB for each storage device. Null or omission means no upper bound. Used for SKU schema version 5 and later."},"pciPatterns":{"type":"array","description":"Regular expressions matched against storage sysfs PCI paths. An empty or omitted list disables PCI location matching. Used for SKU schema version 5 and later.","items":{"type":"string"}}}},"SkuChassis":{"title":"SkuChassis","type":"object","description":"Chassis component in a SKU","examples":[{"vendor":"NVIDIA","model":"GB200 NVL","architecture":"aarch64"}],"properties":{"vendor":{"type":"string","description":"Vendor of the chassis"},"model":{"type":"string","description":"Model of the chassis"},"architecture":{"type":"string","description":"Architecture 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"},"isConnected":{"type":"boolean","description":"Whether the ethernet device is connected"}}},"SkuInfinibandDevice":{"title":"SkuInfinibandDevice","type":"object","description":"Infiniband device component in a SKU","examples":[{"vendor":"Mellanox Technologies","model":"MT2910 Family [ConnectX-7]","count":4,"inactiveDevices":[]}],"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"},"inactiveDevices":{"type":"array","description":"Zero-based indexes of inactive devices","items":{"type":"integer","format":"uint32"}}}},"SkuTpm":{"title":"SkuTpm","type":"object","description":"TPM component in a SKU","properties":{"vendor":{"type":"string","description":"Vendor of the TPM"},"version":{"type":"string","description":"Version of the TPM"}}},"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","description":"Unique UUID v4 identifier for the IP Block","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the IP Block","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the IP Block"},"siteId":{"type":"string","description":"ID of the Site","format":"uuid"},"infrastructureProviderId":{"type":"string","description":"ID of the Infrastructure Provider","format":"uuid"},"tenantId":{"type":["string","null"],"description":"ID of the Tenant","format":"uuid"},"routingType":{"type":"string","description":"RoutingType of the IP Block","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","description":"Version of the ip network IPv4 or IPv6","enum":["IPv4","IPv6"]},"usageStats":{"$ref":"#/components/schemas/IpBlockUsageStats","description":"Usage summary from IPAM for the IP Block"},"status":{"$ref":"#/components/schemas/IpBlockStatus","description":"Status of the IP Block"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the IP Block"},"created":{"type":"string","description":"Date/time when the Ip Block was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Ip Block was last updated","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","description":"ID of the IP Block","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the IP Block, only lowercase characters, digits, hyphens and cannot begin/end with hyphen","minLength":2,"maxLength":256},"routingType":{"type":"string","description":"RoutingType of the IP Block","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","description":"Status of the IP Block"}}},"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":"Total number of IP addresses in the block (acquired and unused)","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\n","items":{"type":"string","readOnly":true}},"availableSmallestPrefixes":{"type":"integer","description":"Total number of /30 prefixes that can still be acquired from this block (only reduced if prefixes are acquired, not reduced by acquired IPs)\n","format":"int64","readOnly":true},"acquiredPrefixes":{"type":"integer","format":"int64","description":"Total number of prefixes (of any size) acquired from this block"}},"description":"Usage statistics for an IP Block, VPC Prefix or Subnet"},"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","description":"Name of the IP Block","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the IP Block"},"siteId":{"type":"string","description":"ID of the site","format":"uuid"},"routingType":{"type":"string","description":"Routing type of the IP Block","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","description":"Version of the ip network ipv4 or ipv6","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"],"description":"Name of the IP Block","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the IP Block"}}},"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","description":"Unique UUID v4 identifier for the Network Security Group"},"name":{"type":"string","description":"Name of the Network Security Group","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Network Security Group"},"siteId":{"type":"string","description":"ID of the Site","format":"uuid"},"tenantId":{"type":"string","description":"ID of the Tenant","format":"uuid"},"status":{"$ref":"#/components/schemas/NetworkSecurityGroupStatus","description":"Status of the Network Security Group"},"statusHistory":{"type":"array","items":{"$ref":"#/components/schemas/StatusDetail"},"description":"Chronological status history for the Network Security Group"},"statefulEgress":{"type":"boolean","description":"StatefulEgress defines whether a Network Security Group's egress rules will be automatically stateful"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/NetworkSecurityGroupRule"},"description":"Rules that belong to the Network Security Group"},"ruleCount":{"type":"integer","description":"Number of rules in the Network Security Group"},"attachmentStats":{"$ref":"#/components/schemas/NetworkSecurityGroupStats","description":"Attachment statistics for the Network Security Group. Returned when the `includeAttachmentStats` query parameter is set to true in retrieval endpoints."},"labels":{"$ref":"#/components/schemas/Labels","description":"Set of labels/tags for the Network Security Group"},"created":{"type":"string","description":"Date/time when the Network Security Group was created","format":"date-time"},"updated":{"type":"string","description":"Date/time when the Network Security Group was last updated","format":"date-time"}}},"NetworkSecurityGroupStats":{"title":"NetworkSecurityGroupStats","type":"object","description":"Detailed attachment statistics for a Network Security Group","properties":{"inUse":{"type":"boolean","description":"Whether the Network Security Group is directly attached to at least one object"},"directVpcAttachmentCount":{"type":"integer","description":"Number of VPCs that directly attach this Network Security Group"},"directInstanceAttachmentCount":{"type":"integer","description":"Number of Instances that directly attach this Network Security Group"},"totalDirectAttachmentCount":{"type":"integer","description":"Total number of objects that directly attach this Network Security Group"}}},"NetworkSecurityGroupStatus":{"title":"NetworkSecurityGroupStatus","type":"string","description":"Status values for Network Security Group objects","enum":["Pending","Provisioning","Ready","Deleting","Error"]},"NetworkSecurityGroupCreateRequest":{"type":"object","examples":[{"id":"2a21cf79-ea5e-4d28-b585-2e78948fcefb","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":{"id":{"type":"string","format":"uuid","description":"Optional user-specified UUID for the Network Security Group"},"name":{"type":"string","description":"Name of the Network Security Group","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Network Security Group"},"siteId":{"type":"string","description":"ID of the Site","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"},"description":"Rules that belong to the Network Security Group"},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value labels for the Network Security Group"}},"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"],"description":"Name of the Network Security Group","minLength":2,"maxLength":256},"description":{"type":["string","null"],"description":"Description of the Network Security Group"},"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 Network Security Group. The rules will be replaced with the rules sent in the request. Any rules not included in the request will be removed. To retain existing rules, fetch them first and include them.","items":{"$ref":"#/components/schemas/NetworkSecurityGroupRule"}},"labels":{"$ref":"#/components/schemas/Labels","description":"User-defined key-value labels for the Network Security Group"}}},"NetworkSecurityGroupRule":{"title":"NetworkSecurityGroupRule","type":"object","description":"Aggregation of Network Security Group rules","properties":{"name":{"type":["string","null"],"description":"Name of the Network Security Group rule"},"direction":{"type":"string","description":"Traffic direction the rule applies to","enum":["INGRESS","EGRESS"],"example":"INGRESS"},"sourcePortRange":{"type":["string","null"],"description":"Source port or port range matched by the rule","example":"80-81"},"destinationPortRange":{"type":["string","null"],"description":"Destination port or port range matched by the rule","example":"80-81"},"protocol":{"type":"string","description":"Network protocol matched by the rule","enum":["TCP","UDP","ICMP","ICMP6","ANY"],"example":"TCP"},"action":{"type":"string","description":"Action applied when traffic matches the rule","enum":["PERMIT","DENY"],"example":"PERMIT"},"priority":{"type":"integer","description":"Rule priority used to order evaluation"},"sourcePrefix":{"type":"string","description":"Source CIDR prefix matched by the rule","example":"10.5.44.0/24"},"destinationPrefix":{"type":"string","description":"Destination CIDR prefix matched by the rule","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":{"objectId":{"type":"string","format":"uuid","description":"The ID of the object (VPC/Instance etc.)"},"detailedStatus":{"type":"string","description":"The detailed propagation status that was actually returned from NICo","enum":["None","Partial","Full","Unknown","Error"]},"status":{"$ref":"#/components/schemas/NetworkSecurityGroupPropagationStatus","description":"The simplified propagation status that reduces the actual status to just a few values"},"details":{"type":["string","null"],"description":"Additional details for the status"},"unpropagatedInstanceIds":{"type":"array","description":"IDs of Instances associated with the object that have not yet updated their Network Security Group rules","items":{"type":"string","format":"uuid"}},"relatedInstanceIds":{"type":"array","description":"IDs of the instances involved in determining the propagation status","items":{"type":"string","format":"uuid"}},"deprecations":{"type":"array","description":"Deprecations active for this resource. Returned only if there are active deprecations.","items":{"$ref":"#/components/schemas/Deprecation"}}}},"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","description":"State of the associated entity at a particular time"},"message":{"type":["string","null"],"description":"Description of the state and cause/remedy in case of error"},"created":{"type":"string","description":"Date/time when the associated entity assumed the status","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the associated entity was last observed with this status","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","description":"Summary of the Site"},"status":{"$ref":"#/components/schemas/SshKeyGroupSiteAssociationStatus","description":"Status of the SSHKeyGroupSiteAssociation"},"version":{"type":["string","null"],"description":"Version of the Key Group on Site","example":"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3"},"created":{"type":"string","description":"Date/time when the Site was created","format":"date-time","readOnly":true},"updated":{"type":"string","description":"Date/time when the Site was last updated","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":"Name of the SSHKeyGroup"},"description":{"type":["string","null"],"description":"Description of the SSHKeyGroup"},"siteIds":{"type":"array","description":"List of Site objects","items":{"type":"string","format":"uuid"}},"sshKeyIds":{"type":"array","description":"List of SSHKeyID objects","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":"Name of the SSHKeyGroup"},"description":{"type":["string","null"],"description":"Description of the SSHKeyGroup"},"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","description":"Name of the SSHKey"},"org":{"type":"string","description":"Organization the SSHKey belongs to"},"tenantId":{"type":"string","description":"ID of the Tenant","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"],"description":"Name of the SSHKey"}}},"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 retrieving 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","description":"Prometheus scrape configuration"},"logging":{"$ref":"#/components/schemas/DpuExtensionServiceObservabilityLogging","description":"Logging configuration"}},"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"],"description":"Email used by the user to register with NGC","format":"email"},"firstName":{"type":["string","null"],"description":"First name of the user"},"lastName":{"type":["string","null"],"description":"Surname of the user"},"created":{"type":"string","format":"date-time","description":"The date that the user was created.","readOnly":true},"updated":{"type":"string","description":"Date/time when the user was last updated in NICo","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","properties":{"attribute":{"type":["string","null"],"description":"Name of the attribute that is deprecated. Omitted if queryParam or endpoint is being deprecated."},"queryParam":{"type":["string","null"],"description":"Query parameter that is deprecated. Omitted if attribute or endpoint is being deprecated."},"endpoint":{"type":["string","null"],"description":"API endpoint that is deprecated. Omitted if attribute or queryParam is being deprecated."},"replacedBy":{"type":["string","null"],"description":"Name of the attribute, query parameter, or endpoint that replaces the deprecated item. Omitted if no replacement is available."},"takeActionBy":{"type":"string","description":"Date/time by which clients should migrate away from the deprecated API surface","format":"date-time"},"notice":{"type":"string","description":"Message describing the deprecation"}}},"MessageResponse":{"title":"MessageResponse","type":"object","description":"Structured response with a human-readable message","required":["message"],"properties":{"message":{"type":"string","description":"Human-readable outcome of the request"}},"example":{"message":"Deletion request was accepted"}},"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 the calling token is authenticated as a Service Account.\nThis is determined per request from how the token's issuer is configured\nat deployment time (the issuer config in the `nico-rest-api-config`\nConfigMap); it cannot be toggled via the API. Rules by issuer origin:\n  - `keycloak`: true for a client-credentials (service-to-service) token —\n    i.e. the token carries a client ID — when the issuer is deployed with\n    `keycloak.serviceAccount: true`.\n  - `custom`: true when the `claimMapping` matched for this org sets\n    `isServiceAccount: true`. Only permitted when the API runs in\n    disconnected mode.\n  - `kas-ssa` / `kas-legacy`: always false; service accounts are not\n    supported for these origins.\n\nFor details on issuer origins and configuration, see the NICo REST `auth`\nmodule [README](https://github.com/NVIDIA/infra-controller/tree/main/rest-api/auth)."},"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"}},"examples":[{"name":"NVIDIA GB200","gpus":64,"machines":16},{"name":"NVIDIA H100","gpus":8,"machines":1}]},"MachineStatusBreakdown":{"title":"MachineStatusBreakdown","description":"Machine counts broken down by status","type":"object","properties":{"total":{"type":"integer","description":"Total number of machines in this group"},"initializing":{"type":"integer","description":"Number of machines being initialized"},"ready":{"type":"integer","description":"Number of machines in ready state"},"inUse":{"type":"integer","description":"Number of machines currently in use"},"error":{"type":"integer","description":"Number of machines in error state"},"maintenance":{"type":"integer","description":"Number of machines in maintenance state"},"unknown":{"type":"integer","description":"Number of machines in unknown state"}}},"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","description":"AssignedMachineStats captures the status of all Machines assigned to this Instance Type"},"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","description":"UsedMachineStats captures the usage status of machines assigned to this instance type that are currently associated with Tenant Instances"},"tenants":{"type":"array","items":{"$ref":"#/components/schemas/InstanceTypeStats"},"description":"Per-tenant breakdown for this instance type"}}},"InstanceTypeStats":{"title":"InstanceTypeStats","description":"Stats for an instance type including allocation details","type":"object","properties":{"id":{"type":"string","description":"Unique UUID v4 identifier for the Instance Type","format":"uuid"},"name":{"type":"string","description":"Name of the Instance Type"},"allocated":{"type":"integer","description":"Number of Machines allocated for this Instance Type"},"usedMachineStats":{"$ref":"#/components/schemas/MachineStatusBreakdown","description":"Usage statistics for Machines allocated to this Instance Type"},"maxAllocatable":{"type":"integer","description":"Maximum number of Machines of this Instance Type that can be allocated"},"allocations":{"type":"array","items":{"$ref":"#/components/schemas/TenantInstanceTypeAllocationStats"},"description":"Allocation statistics for this Instance Type"}}},"TenantInstanceTypeAllocationStats":{"title":"TenantInstanceTypeAllocationStats","description":"Stats for a single allocation within an instance type","type":"object","properties":{"id":{"type":"string","description":"Unique UUID v4 identifier for the Allocation","format":"uuid"},"name":{"type":"string","description":"Name of the Allocation"},"total":{"type":"integer","description":"Total number of Machines allocated to different Tenants for this Instance Type"}}},"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"},"description":"Instance Type statistics for this Tenant"}}},"TenantIdentityConfigCreateOrUpdateRequest":{"title":"TenantIdentityConfigCreateOrUpdateRequest","description":"Tenant identity configuration payload. `issuer`,\n`defaultAudience`, and `tokenTtlSeconds` are required. `enabled` is\noptional and defaults to `true` when omitted. The `org` identifier\nis taken from the URL path segment `{org}`.\n\nTwo request shapes are supported, distinguished by whether the\nPUT also forces a signing-key rotation:\n\n  1. **Without key rotation** -- `rotateKey` is omitted or `false`;\n     `signingKeyOverlapSeconds` must be omitted.\n  2. **With key rotation** -- `rotateKey: true` and\n     `signingKeyOverlapSeconds` are both required; the Core gRPC\n     API generates a fresh ES256 keypair into the other key slot,\n     swaps the active signer, and arms a JWKS overlap window for\n     the previous key.","oneOf":[{"$ref":"#/components/schemas/TenantIdentityConfigCreateOrUpdateRequestWithoutKeyRotation"},{"$ref":"#/components/schemas/TenantIdentityConfigCreateOrUpdateRequestWithKeyRotation"}]},"TenantIdentityConfigCreateOrUpdateRequestWithoutKeyRotation":{"title":"Without key rotation","description":"Standard create-or-update of the tenant identity config. Use\nthis shape when **not** rotating the signing key.\n`signingKeyOverlapSeconds` is not used here -- it is only\nmeaningful together with `rotateKey: true` and is rejected by\nthe REST API in that combination. Switch to the \"With key\nrotation\" variant when you need to set it.","type":"object","required":["issuer","defaultAudience","tokenTtlSeconds"],"properties":{"enabled":{"type":"boolean","default":true,"description":"Optional. Set to `true` to enable JWT-SVID issuance for\nthis org or `false` to keep the config but pause issuance.\nDefaults to `true` when omitted."},"issuer":{"type":"string","description":"JWT `iss` claim / OIDC issuer. Required in the REST\nrequest body. The Core gRPC API (`Issuer::parse`) is\nauthoritative for scheme and host rules and accepts\n`https://`, `http://`, or `spiffe://` URLs with a DNS\nhost; malformed values are rejected with\n`400 Bad Request`."},"defaultAudience":{"type":"string","description":"Default audience applied when a workload does not specify one. Required."},"allowedAudiences":{"type":"array","default":[],"description":"Allowlist of audience strings that may appear in issued\nJWT-SVIDs. When **empty or omitted**, the Core gRPC API\npersists `[defaultAudience]` as the stored allowlist, so\nonly the default audience can be issued -- empty is\n**not** \"allow any\". To accept additional audiences,\nprovide a non-empty list; non-empty lists must include\n`defaultAudience`. A subsequent GET returns the\npersisted allowlist, which may differ from an empty list\nthat was sent on PUT.","items":{"type":"string"}},"tokenTtlSeconds":{"type":"integer","minimum":1,"description":"Issued-token TTL in seconds. Required in the REST request\nbody and must be > 0. The Core gRPC API enforces its\nconfigured `[machine_identity].token_ttl_min_sec` /\n`token_ttl_max_sec` window and rejects values outside the\nwindow with `400 Bad Request`. The window is per-site, so\nREST does not advertise a fixed maximum here."},"subjectPrefix":{"type":"string","description":"Optional SPIFFE ID URI prefix for JWT `sub` (RFC-shaped\n`spiffe://…`). When omitted, the Core gRPC API derives a\nprefix from the issuer's trust domain."},"rotateKey":{"type":"boolean","enum":[false],"default":false,"description":"Must be omitted or `false` for this variant. Switch to the\n\"With key rotation\" variant to force a fresh ES256 signing\nkeypair and arm a JWKS overlap window."}}},"TenantIdentityConfigCreateOrUpdateRequestWithKeyRotation":{"title":"With key rotation","description":"Create-or-update of the tenant identity config that also\nforces a signing-key rotation. Both `rotateKey: true` and\n`signingKeyOverlapSeconds` are required.","type":"object","required":["issuer","defaultAudience","tokenTtlSeconds","rotateKey","signingKeyOverlapSeconds"],"properties":{"enabled":{"type":"boolean","default":true,"description":"Optional. Set to `true` to enable JWT-SVID issuance for\nthis org or `false` to keep the config but pause issuance.\nDefaults to `true` when omitted."},"issuer":{"type":"string","description":"JWT `iss` claim / OIDC issuer. Required in the REST\nrequest body. The Core gRPC API (`Issuer::parse`) is\nauthoritative for scheme and host rules and accepts\n`https://`, `http://`, or `spiffe://` URLs with a DNS\nhost; malformed values are rejected with\n`400 Bad Request`."},"defaultAudience":{"type":"string","description":"Default audience applied when a workload does not specify one. Required."},"allowedAudiences":{"type":"array","default":[],"description":"Allowlist of audience strings that may appear in issued\nJWT-SVIDs. When **empty or omitted**, the Core gRPC API\npersists `[defaultAudience]` as the stored allowlist, so\nonly the default audience can be issued -- empty is\n**not** \"allow any\". To accept additional audiences,\nprovide a non-empty list; non-empty lists must include\n`defaultAudience`. A subsequent GET returns the\npersisted allowlist, which may differ from an empty list\nthat was sent on PUT.","items":{"type":"string"}},"tokenTtlSeconds":{"type":"integer","minimum":1,"description":"Issued-token TTL in seconds. Required in the REST request\nbody and must be > 0. The Core gRPC API enforces its\nconfigured `[machine_identity].token_ttl_min_sec` /\n`token_ttl_max_sec` window and rejects values outside the\nwindow with `400 Bad Request`. The window is per-site, so\nREST does not advertise a fixed maximum here."},"subjectPrefix":{"type":"string","description":"Optional SPIFFE ID URI prefix for JWT `sub` (RFC-shaped\n`spiffe://…`). When omitted, the Core gRPC API derives a\nprefix from the issuer's trust domain."},"rotateKey":{"type":"boolean","enum":[true],"description":"Must be `true` for this variant. Generates a fresh ES256\nsigning keypair into the other key slot, swaps the\ncurrent signer, and arms a JWKS overlap window for the\nprevious key."},"signingKeyOverlapSeconds":{"type":"integer","minimum":1,"description":"Required when `rotateKey` is `true`. Number of seconds\nthe previous verification key remains in JWKS so that\nJWTs already signed with it stay verifiable until they\nexpire. Must be `>= tokenTtlSeconds`. The Core gRPC API\nenforces an upper bound via its\n`[machine_identity].signing_key_overlap_max_sec` config;\nvalues above that bound are rejected with\n`400 Bad Request`."}}},"TenantIdentityConfig":{"title":"TenantIdentityConfig","description":"Current tenant identity configuration plus the per-org signing key\nmetadata (`signingKeys`). During a JWKS overlap window two\nentries appear; under steady state only the active signer is\nlisted. Use `signingKeys[].kid` (filtering by `currentSigner`)\ninstead of the legacy single `keyId` field, which was removed\nwith the key-rotation change in NICo-core.","type":"object","properties":{"org":{"type":"string","description":"Organization that owns the Tenant identity configuration"},"enabled":{"type":"boolean","description":"Whether Tenant identity token delegation is enabled"},"issuer":{"type":"string","description":"Issuer URL for Tenant identity tokens"},"defaultAudience":{"type":"string","description":"Default audience used for Tenant identity tokens"},"allowedAudiences":{"type":"array","description":"Stored allowlist of audience strings. Always non-empty: when a\nPUT supplied an empty list, the Core gRPC API substituted\n`[defaultAudience]` before persisting. Issuance rejects audiences\noutside this list.","items":{"type":"string"}},"tokenTtlSeconds":{"type":"integer","description":"Lifetime of issued Tenant identity tokens, in seconds"},"subjectPrefix":{"type":"string","description":"SPIFFE ID prefix used in the JWT `sub` claim. When the PUT body\nomitted `subjectPrefix`, Core stored\n`spiffe://<trust-domain-from-issuer>` here, so the value\nreturned by GET may differ from what was submitted."},"signingKeys":{"type":"array","items":{"$ref":"#/components/schemas/TenantIdentitySigningKey"},"description":"Per-org signing keys currently published in JWKS. Exactly\none entry has `currentSigner: true`. During a rotation\noverlap window a second entry is present with\n`currentSigner: false` and a populated `expireAt`; once\nthe overlap window elapses the Core gRPC API deletes the\nexpired entry and only the current signer remains."},"created":{"type":"string","description":"Date/time when the Tenant identity configuration was created","format":"date-time"},"updated":{"type":"string","description":"Date/time when the Tenant identity configuration was last updated","format":"date-time"}}},"TenantIdentitySigningKey":{"title":"TenantIdentitySigningKey","description":"A single JWT-SVID signing key entry returned in\n`TenantIdentityConfig.signingKeys`. Multiple entries appear\nduring a key-rotation overlap window; in steady state only the\nactive signer is listed.","type":"object","required":["kid","alg","currentSigner"],"properties":{"kid":{"type":"string","description":"Key identifier; matches the `kid` published in JWKS for this key."},"alg":{"type":"string","description":"Signing algorithm, e.g. `ES256`."},"currentSigner":{"type":"boolean","description":"True when this key is the active signer for new JWT-SVIDs.\nExactly one entry per response is `true`."},"expireAt":{"type":["string","null"],"format":"date-time","description":"Set on the inactive (previous) key during the JWKS overlap\nwindow; the Core gRPC API deletes the inactive slot once\n`now >= expireAt`. Null on the current signer."}}},"TenantIdentityBasicClientSecretRequest":{"title":"TenantIdentityBasicClientSecretRequest","description":"Raw OAuth2 `client_secret_basic` credentials. `clientSecret` is accepted on input but never returned in responses.","type":"object","required":["clientId","clientSecret"],"properties":{"clientId":{"type":"string","description":"Client identifier used for basic client-secret authentication"},"clientSecret":{"type":"string","description":"Raw OAuth2 client secret. Transmitted over TLS to the Core gRPC API,\nwhich encrypts it at rest in its database using a per-site key. Never\nechoed in responses; subsequent reads return only a `sha256:` hash\nprefix in `clientSecretHash`."}}},"TenantIdentityBasicClientSecretResponse":{"title":"TenantIdentityBasicClientSecretResponse","description":"Public half of `client_secret_basic` credentials. Only the SHA-256 hash of the secret is returned.","type":"object","properties":{"clientId":{"type":"string","description":"Client identifier used for basic client-secret authentication"},"clientSecretHash":{"type":"string","description":"SHA-256 hash of the raw secret."}}},"TenantIdentityTokenDelegationCreateOrUpdateRequest":{"title":"TenantIdentityTokenDelegationCreateOrUpdateRequest","description":"RFC 8693 token exchange callback configuration. Omit\n`clientSecretBasic` entirely for auth method `none`; include it\nfor `client_secret_basic`.\n\nBecause PUT is full-replace, omitting `clientSecretBasic` on a\nsubsequent update **clears** any previously-stored credentials\nand switches the org back to no-auth. To keep basic-auth across\nupdates, re-supply `clientId` and `clientSecret` on every PUT —\nCore never returns the raw secret (only its hash), so the secret\nmust be available to the caller.","type":"object","required":["tokenEndpoint","subjectTokenAudience"],"properties":{"tokenEndpoint":{"type":"string","format":"uri","description":"URL of the tenant's RFC 8693 token exchange endpoint.\nThe Core gRPC API validates scheme and host against its\nconfigured `[machine_identity].token_endpoint_domain_allowlist`\nand rejects mismatches with `400 Bad Request`. Operators that\nneed to enforce HTTPS-only must populate that allowlist."},"clientSecretBasic":{"$ref":"#/components/schemas/TenantIdentityBasicClientSecretRequest","description":"Client-secret basic authentication settings for token delegation"},"subjectTokenAudience":{"type":"string","description":"Audience value placed on the intermediate JWT-SVID posted to the exchange endpoint."}}},"TenantIdentityTokenDelegation":{"title":"TenantIdentityTokenDelegation","description":"Current token delegation configuration for the org.","type":"object","properties":{"tokenEndpoint":{"type":"string","description":"Token endpoint used to exchange delegated Tenant identity tokens","format":"uri"},"clientSecretBasic":{"$ref":"#/components/schemas/TenantIdentityBasicClientSecretResponse","description":"Client-secret basic authentication settings for token delegation"},"subjectTokenAudience":{"type":"string","description":"Audience value expected on the subject token"},"created":{"type":"string","description":"Date/time when the token delegation configuration was created","format":"date-time"},"updated":{"type":"string","description":"Date/time when the token delegation configuration was last updated","format":"date-time"}}},"TenantIdentityJWKS":{"title":"TenantIdentityJWKS","description":"RFC 7517 JSON Web Key Set. NICo-rest returns this schema only\non `200 OK`; in that case the `keys` member is present. The Core\ngRPC API normally returns one key, or two during a rotation overlap\nwindow. When no identity configuration exists for the org/site, the\nJWKS endpoints return `404 Not Found`.","type":"object","required":["keys"],"properties":{"keys":{"type":"array","description":"RFC 7517 JWK members. NICo currently emits only EC keys\n(`kty: EC`, `crv: P-256`, `alg: ES256`); the schema is\nintentionally open-ended so that future algorithms can be\nadded without a spec change.","items":{"type":"object","properties":{"kty":{"type":"string","example":"EC"},"use":{"type":"string","description":"`sig` for OIDC JWKS, `jwt-svid` for SPIFFE JWKS"},"crv":{"type":"string","example":"P-256"},"kid":{"type":"string"},"x":{"type":"string","description":"Base64url-encoded EC x coordinate"},"y":{"type":"string","description":"Base64url-encoded EC y coordinate"},"alg":{"type":"string","example":"ES256"}}}}}},"OpenIDConfiguration":{"title":"OpenIDConfiguration","description":"OIDC discovery document. Note: `id_token_signing_alg_values_supported`\nis always empty because NICo issues JWT bearer access tokens, not\nOIDC `id_token`s.","type":"object","properties":{"issuer":{"type":"string","description":"Issuer URL for OpenID Connect discovery"},"jwks_uri":{"type":"string","description":"URL of the JSON Web Key Set used to verify tokens","format":"uri"},"response_types_supported":{"type":"array","description":"OAuth response types supported by this issuer","items":{"type":"string"}},"subject_types_supported":{"type":"array","description":"Subject identifier types supported by this issuer","items":{"type":"string"}},"id_token_signing_alg_values_supported":{"type":"array","description":"ID token signing algorithms supported by this issuer","items":{"type":"string"}},"spiffe_jwks_uri":{"type":"string","description":"URL of the SPIFFE JSON Web Key Set used to verify SPIFFE JWT-SVIDs","format":"uri"}}},"DpuMachine":{"title":"DpuMachine","type":"object","description":"A DPU Machine with network configuration fields exposed by the REST API.","properties":{"id":{"type":"string","description":"ID of the DPU Machine"},"infrastructureProviderId":{"type":"string","format":"uuid","description":"ID of the Infrastructure Provider that owns the host Machine"},"siteId":{"type":"string","format":"uuid","description":"ID of the Site that the host Machine belongs to"},"hostMachineId":{"type":"string","description":"ID of the host Machine that this DPU is attached to"},"dpuAgentVersion":{"type":"string","description":"Version of the DPU agent running on the DPU"},"bmcInfo":{"$ref":"#/components/schemas/MachineBMCInfo","description":"BMC (Baseboard Management Controller) information for the DPU"},"dmiData":{"$ref":"#/components/schemas/MachineDMIData","description":"DMI (Desktop Management Interface) data reported for the DPU"},"interfaces":{"type":"array","items":{"$ref":"#/components/schemas/DpuMachineInterface"},"description":"Interfaces reported on the DPU"},"softwareComponents":{"type":"array","items":{"$ref":"#/components/schemas/DpuMachineSoftwareComponent"},"description":"Software components reported on the DPU"},"health":{"$ref":"#/components/schemas/MachineHealth","description":"Health information for the DPU"},"labels":{"type":"object","additionalProperties":{"type":"string"},"description":"Labels associated with the DPU"},"state":{"type":"string","description":"Lifecycle state of the DPU"},"dpuNetworkConfig":{"$ref":"#/components/schemas/DpuNetworkConfig","description":"Network configuration fields exposed by the REST API"},"lastRebooted":{"type":["string","null"],"format":"date-time","description":"Last reboot timestamp"},"placementInRack":{"$ref":"#/components/schemas/PlacementInRack","description":"Physical placement of the DPU Machine within its Rack, when known"}},"required":["id","infrastructureProviderId","siteId","hostMachineId","state","dpuNetworkConfig"]},"DpuMachineInterface":{"title":"DpuMachineInterface","type":"object","description":"An interface reported on a DPU Machine","properties":{"id":{"type":"string","description":"Interface ID"},"machineId":{"type":"string","description":"ID of the Machine the interface belongs to"},"segmentId":{"type":"string","description":"Network segment ID"},"hostname":{"type":"string","description":"Hostname of the interface"},"primaryInterface":{"type":"boolean","description":"Whether this is the primary interface"},"macAddress":{"type":"string","description":"MAC address of the interface"},"address":{"type":"array","items":{"type":"string"},"description":"IP addresses assigned to the interface"},"vendor":{"type":["string","null"],"description":"Vendor of the interface"},"created":{"type":["string","null"],"format":"date-time","description":"Timestamp when the interface was first observed"},"lastDhcp":{"type":["string","null"],"format":"date-time","description":"Timestamp of the last DHCP lease for the interface"},"isBmc":{"type":"boolean","description":"Whether this interface is a BMC interface"}}},"DpuMachineSoftwareComponent":{"title":"DpuMachineSoftwareComponent","type":"object","description":"A software component reported on a DPU Machine","properties":{"name":{"type":"string","description":"Name of the software component"},"version":{"type":"string","description":"Version of the software component"},"url":{"type":"string","description":"URL where the software component can be obtained"}}},"DpuNetworkConfig":{"title":"DpuNetworkConfig","type":"object","description":"Network configuration fields exposed for a DPU Machine. Internal-only and sensitive fields from the Core configuration are omitted.","properties":{"asn":{"type":"integer","format":"uint32","description":"Autonomous System Number for BGP routing"},"dhcpServers":{"type":"array","items":{"type":"string"},"description":"List of DHCP server IP addresses"},"vniDevice":{"type":"string","description":"VNI device name"},"managedHostConfig":{"$ref":"#/components/schemas/ManagedHostNetworkConfig","description":"Network configuration applied to the managed host"},"managedHostConfigVersion":{"type":"string","description":"Version of the managed host configuration"},"useAdminNetwork":{"type":"boolean","description":"Whether to use the admin network"},"adminInterface":{"$ref":"#/components/schemas/DpuInterfaceConfig","description":"Admin network interface configuration for the DPU"},"tenantInterfaces":{"type":"array","items":{"$ref":"#/components/schemas/DpuInterfaceConfig"},"description":"List of tenant interface configurations"},"instanceNetworkConfigVersion":{"type":["string","null"],"description":"Version of the instance network configuration"},"instanceId":{"type":["string","null"],"description":"ID of the associated instance"},"networkVirtualizationType":{"type":["string","null"],"description":"Type of network virtualization"},"vpcVni":{"type":["integer","null"],"format":"uint32","description":"VPC VNI identifier"},"routeServers":{"type":"array","items":{"type":"string"},"description":"List of route server IP addresses"},"remoteId":{"type":"string","description":"Remote identifier for the managed host"},"deprecatedDenyPrefixes":{"type":"array","items":{"type":"string"},"description":"Deprecated list of denied IP prefixes"},"dpuNetworkPingerType":{"type":["string","null"],"description":"Type of network pinger to use"},"denyPrefixes":{"type":"array","items":{"type":"string"},"description":"List of denied IP prefixes"},"siteFabricPrefixes":{"type":"array","items":{"type":"string"},"description":"List of site fabric IP prefixes"},"vpcIsolationBehavior":{"type":"string","description":"VPC isolation behavior setting"},"statefulAclsEnabled":{"type":"boolean","description":"Whether stateful ACLs are enabled"},"enableDhcp":{"type":"boolean","description":"Whether DHCP is enabled"},"hostInterfaceId":{"type":["string","null"],"description":"ID of the host interface"},"minDpuFunctioningLinks":{"type":["integer","null"],"format":"uint32","description":"Minimum number of functioning DPU links required"},"isPrimaryDpu":{"type":"boolean","description":"Whether this is the primary DPU"},"internetL3Vni":{"type":["integer","null"],"format":"uint32","description":"Layer 3 VNI used for internet access"},"datacenterAsn":{"type":"integer","format":"uint32","description":"Datacenter Autonomous System Number"},"anycastSitePrefixes":{"type":"array","items":{"type":"string"},"description":"List of anycast site IP prefixes"},"tenantHostAsn":{"type":["integer","null"],"format":"uint32","description":"Autonomous System Number for the tenant host"},"siteGlobalVpcVni":{"type":["integer","null"],"format":"uint32","description":"Site-global VPC VNI identifier"}},"required":["asn","vniDevice","managedHostConfigVersion","useAdminNetwork","remoteId","vpcIsolationBehavior","statefulAclsEnabled","enableDhcp","isPrimaryDpu","datacenterAsn"]},"ManagedHostNetworkConfig":{"title":"ManagedHostNetworkConfig","type":"object","description":"Network configuration for the managed host","properties":{"loopbackIp":{"type":"string","description":"Loopback IP address"},"quarantineState":{"$ref":"#/components/schemas/ManagedHostQuarantineState"}},"required":["loopbackIp"]},"ManagedHostQuarantineState":{"title":"ManagedHostQuarantineState","type":"object","description":"Quarantine state for the managed host","properties":{"mode":{"type":"string","description":"Quarantine mode"},"reason":{"type":["string","null"],"description":"Reason for quarantine"}},"required":["mode"]},"DpuInterfaceConfig":{"title":"DpuInterfaceConfig","type":"object","description":"Interface configuration for DPU networking","properties":{"functionType":{"type":"string","description":"Function type (e.g. PHYSICAL_FUNCTION, VIRTUAL_FUNCTION)"},"vlanId":{"type":"integer","format":"uint32","description":"VLAN ID"},"vni":{"type":"integer","format":"uint32","description":"VXLAN Network Identifier"},"gateway":{"type":"string","description":"Gateway IP address"},"ip":{"type":"string","description":"Interface IP address"},"interfacePrefix":{"type":"string","description":"Interface name prefix"},"virtualFunctionId":{"type":["integer","null"],"format":"uint32","description":"Virtual function ID if applicable"},"vpcPrefixes":{"type":"array","items":{"type":"string"},"description":"List of VPC IP prefixes"},"prefix":{"type":"string","description":"IP prefix for the interface"},"fqdn":{"type":"string","description":"Fully qualified domain name"},"bootUrl":{"type":["string","null"],"description":"Boot URL for PXE/iPXE boot"},"vpcVni":{"type":"integer","format":"uint32","description":"VPC VXLAN Network Identifier"},"sviIp":{"type":["string","null"],"description":"Switch virtual interface (SVI) IP address"},"tenantVrfLoopbackIp":{"type":["string","null"],"description":"Tenant VRF loopback IP address"},"isL2Segment":{"type":"boolean","description":"Whether the interface is an L2 segment"},"vpcPeerPrefixes":{"type":"array","items":{"type":"string"},"description":"List of peered VPC IP prefixes"},"vpcPeerVnis":{"type":"array","items":{"type":"integer","format":"uint32"},"description":"List of peered VPC VNIs"},"mtu":{"type":["integer","null"],"format":"uint32","description":"Maximum transmission unit (MTU) for the interface"},"networkSecurityGroup":{"$ref":"#/components/schemas/InterfaceNetworkSecurityGroupConfig","description":"Network security group configuration resolved on the interface"}},"required":["functionType","vlanId","vni","gateway","ip","interfacePrefix","prefix","fqdn","vpcVni","isL2Segment"]},"InterfaceNetworkSecurityGroupConfig":{"title":"InterfaceNetworkSecurityGroupConfig","type":"object","description":"Network security group configuration resolved on a DPU interface","properties":{"id":{"type":"string","description":"ID of the Network Security Group"},"version":{"type":"string","description":"Version of the Network Security Group"},"source":{"type":"string","description":"Source of the Network Security Group configuration"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/ResolvedNetworkSecurityGroupRule"},"description":"Resolved rules for the Network Security Group"}},"required":["id","version","source"]},"ResolvedNetworkSecurityGroupRule":{"title":"ResolvedNetworkSecurityGroupRule","type":"object","description":"A network security group rule with its source and destination prefixes resolved","properties":{"rule":{"$ref":"#/components/schemas/NetworkSecurityGroupRule","description":"The underlying Network Security Group rule"},"srcPrefixes":{"type":"array","items":{"type":"string"},"description":"Resolved source IP prefixes for the rule"},"dstPrefixes":{"type":"array","items":{"type":"string"},"description":"Resolved destination IP prefixes for the rule"}}}},"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}}}}}},"GatewayTimeoutError":{"description":"The Site did not return a result within the request budget allocated to\nSite communication within the request cycle. This can occur if the Site\nController is down or under heavy request load.\n\nOperations are in general safe to retry. In rare cases, operations that\ncreate or update resources may succeed even if timeout is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"},"examples":{"example-1":{"value":{"source":"nico","message":"Flow proxy request timed out","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}}}}}},"UnauthorizedError":{"description":"Error response when user is not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"},"examples":{"example-1":{"value":{"source":"nico","message":"User is not authenticated","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"}}}}}}},"ResourceExhaustedError":{"description":"Error response when the Controller cannot allocate a requested resource because capacity is exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"},"examples":{"example-1":{"value":{"source":"nico","message":"VPC prefix capacity exhausted","data":null}}}}}},"HostFirmwareConfigCoreUnavailable":{"description":"Core gRPC API is unavailable, so the host firmware config request cannot be served.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"}}}},"TenantIdentityCoreUnavailable":{"description":"Core gRPC API is unavailable, or site-level machine identity is\ndisabled (`enabled=false` in site config), so the request cannot\nbe served.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NICoAPIError"}}}}},"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/BMC-Credential","tag/BMC-Credential/operation/create-or-update-bmc-credential","tag/UEFI-Credential","tag/UEFI-Credential/operation/create-uefi-credential","tag/Measured-Boot-Trusted-Machine","tag/Measured-Boot-Trusted-Machine/operation/create-measured-boot-trusted-machine","tag/Measured-Boot-Trusted-Machine/operation/get-all-measured-boot-trusted-machine","tag/Measured-Boot-Trusted-Machine/operation/delete-measured-boot-trusted-machine","tag/Measured-Boot-Trusted-Profile","tag/Measured-Boot-Trusted-Profile/operation/create-measured-boot-trusted-profile","tag/Measured-Boot-Trusted-Profile/operation/get-all-measured-boot-trusted-profile","tag/Measured-Boot-Trusted-Profile/operation/delete-measured-boot-trusted-profile","tag/Credential-Rotation","tag/Credential-Rotation/operation/rotate-credential","tag/Credential-Rotation/operation/get-credential-rotation-status","tag/Site-Explorer","tag/Site-Explorer/operation/get-all-site-explorer-endpoint","tag/Site-Explorer/operation/create-site-explorer-endpoint-action","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/update-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/create-sku","tag/SKU/operation/get-sku","tag/SKU/operation/delete-sku","tag/SKU/operation/update-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/iPXE-Template","tag/iPXE-Template/operation/get-all-ipxe-template","tag/iPXE-Template/operation/get-ipxe-template","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/machine-power-control-machine","tag/Machine/operation/get-machine-status-history","tag/Machine/operation/get-dpu-machines","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-Validation","tag/Machine-Validation/operation/get-all-machine-validation-runs","tag/Machine-Validation/operation/start-machine-validation","tag/Machine-Validation/operation/get-all-machine-validation-results","tag/BMC-Reset","tag/BMC-Reset/operation/reset-machine-bmc","tag/DPU-Reprovision","tag/DPU-Reprovision/operation/reprovision-machine-dpu","tag/Health-Report","tag/Health-Report/operation/get-all-machine-health-report","tag/Health-Report/operation/create-or-update-machine-health-report","tag/Health-Report/operation/delete-machine-health-report","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-tasks","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/Tray/operation/get-tray-tasks","tag/Task","tag/Task/operation/get-task","tag/Task/operation/cancel-task","tag/Rule","tag/Rule/operation/create-rule","tag/Rule/operation/list-rules","tag/Rule/operation/get-rule","tag/Rule/operation/update-rule","tag/Rule/operation/delete-rule","tag/Task-Run","tag/Task-Run/operation/create-task-run","tag/Task-Run/operation/get-all-task-run","tag/Task-Run/operation/get-task-run","tag/Task-Run/operation/get-all-task-run-target","tag/Task-Run/operation/pause-task-run","tag/Task-Run/operation/resume-task-run","tag/Task-Run/operation/advance-task-run","tag/Task-Run/operation/cancel-task-run","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/Host-Firmware-Config","tag/Host-Firmware-Config/operation/create-or-update-host-firmware-config","tag/Host-Firmware-Config/operation/delete-host-firmware-config","tag/Tenant-Identity","tag/Tenant-Identity/operation/create-or-update-tenant-identity-config","tag/Tenant-Identity/operation/get-tenant-identity-config","tag/Tenant-Identity/operation/delete-tenant-identity-config","tag/Tenant-Identity/operation/create-or-update-tenant-identity-token-delegation","tag/Tenant-Identity/operation/get-tenant-identity-token-delegation","tag/Tenant-Identity/operation/delete-tenant-identity-token-delegation","tag/Tenant-Identity/operation/get-jwks","tag/Tenant-Identity/operation/get-openid-configuration","tag/Tenant-Identity/operation/get-spiffe-jwks","tag/Deprecations"],"index":{"version":"2.3.9","fields":["title","description"],"fieldVectors":[["title/0",[0,6.046,1,4.532]],["description/0",[1,0.433,2,1.101,3,0.561,4,0.578,5,0.578,6,2.346,7,3.444,8,1.583,9,0.825,10,0.992,11,2.948,12,0.484,13,0.484,14,0.385,15,1.242,16,0.578,17,0.025,18,1.101,19,1.009,20,0.304,21,0.385,22,0.578,23,2.555,24,1.505,25,0.992,26,0.578,27,0.578,28,1.158,29,0.456,30,0.578,31,0.484,32,0.652,33,3.029,34,0.385,35,0.578,36,0.484,37,0.521,38,0.433,39,0.433,40,0.484,41,0.521,42,0.373,43,0.521,44,0.635,45,0.521,46,0.203,47,0.578,48,0.311,49,0.578,50,1.604,51,1.502,52,2.011,53,0.142,54,0.484,55,0.709,56,0.682,57,0.521,58,0.351,59,1.575,60,2.404,61,0.578,62,0.183,63,1.575,64,0.433,65,0.456,66,0.433,67,0.22,68,0.304,69,0.147,70,0.578,71,0.578,72,1.986,73,1.731,74,0.456,75,0.921,76,0.578,77,0.287,78,0.521,79,2.377,80,2.293,81,0.886,82,0.578,83,1.049,84,1.386,85,0.521,86,0.385,87,0.578,88,0.578,89,0.578,90,0.578,91,0.521,92,0.578,93,0.578,94,0.578,95,2.167,96,1.294,97,0.484,98,2.56,99,1.575,100,1.575,101,0.578,102,0.578,103,0.456,104,0.578,105,0.886,106,0.456,107,1.932,108,0.456,109,1.91,110,0.484,111,1.575,112,1.944,113,1.101,114,1.837,115,1.81,116,0.688,117,0.921,118,0.921,119,1.101,120,0.921,121,1.101,122,1.111,123,1.373,124,1.101,125,0.882,126,0.709,127,0.992,128,0.992,129,0.679,130,1.101,131,1.213,132,0.578,133,0.578,134,0.033,135,0.373,136,0.825,137,1.572,138,0.578,139,0.374,140,0.325,141,0.578,142,0.415,143,0.456,144,0.578,145,0.287,146,0.578,147,1.181,148,0.578,149,0.681,150,0.578,151,0.992,152,0.578]],["title/1",[50,2.84,51,1.86]],["description/1",[3,0.597,6,3.86,19,3.075,50,3.443,51,2.255,52,4.516,53,0.207,54,4.516,55,3.478,56,0.789,64,4.046,65,4.255,66,4.046,73,1.145,129,1.18,131,1.469,153,4.866,154,4.516,155,1.518,156,4.516,157,5.398]],["title/2",[32,0.403,46,1.308,50,1.75,51,1.146,134,0.215,158,2.203]],["description/2",[6,4.184,19,2.556,32,0.659,46,2.139,50,4.154,51,2.445,68,3.209,103,4.803,134,0.351,158,3.604,159,3.702,160,4.803,161,6.093,162,3.702,163,6.093]],["title/3",[3,0.669,69,0.808]],["description/3",[3,0.804,15,5.726,62,0.663,69,0.97,72,5.211,74,5.726,81,1.067,164,2.398,165,4.54]],["title/4",[3,0.456,32,0.445,46,1.447,69,0.55,134,0.237]],["description/4",[3,0.76,17,0.3,32,0.743,46,2.411,53,0.263,62,0.627,69,0.917,134,0.396,166,0.344,167,0.822,168,0.35,169,6.868]],["title/5",[3,0.456,32,0.445,46,1.447,69,0.55,170,2.575]],["description/5",[3,0.774,17,0.305,32,0.756,46,2.456,53,0.268,69,0.934,166,0.35,167,0.838,168,0.356,170,4.372,171,6.995]],["title/6",[56,0.679]],["description/6",[7,2.11,15,3.723,19,1.982,44,3.853,51,1.453,56,0.633,62,0.431,65,3.723,72,4.794,74,3.723,81,0.694,84,2.11,147,5.009,149,2.043,172,3.723,173,2.869,174,3.952,175,3.389,176,4.258,177,2.869,178,4.258,179,4.258,180,3.145,181,3.258,182,3.145,183,3.541,184,4.723,185,4.723,186,4.723,187,4.723,188,3.723,189,2.181,190,3.723]],["title/7",[32,0.498,46,1.618,56,0.437,134,0.266]],["description/7",[3,0.481,11,1.822,17,0.19,19,2.64,32,0.47,38,3.256,39,3.256,44,2.504,46,1.525,51,1.336,53,0.166,56,0.701,62,0.397,65,3.424,66,3.256,67,1.649,68,2.287,81,0.925,134,0.25,149,1.879,162,2.639,166,0.217,168,0.221,174,3.634,183,3.256,191,3.916,192,4.344,193,3.116,194,3.916,195,1.585,196,2.996,197,4.344,198,3.424,199,4.344,200,4.344,201,4.344,202,2.445,203,4.344,204,0.783,205,4.344]],["title/8",[32,0.498,46,1.618,56,0.437,170,2.881]],["description/8",[17,0.311,32,0.77,46,2.502,53,0.273,56,0.675,166,0.357,168,0.363,170,4.454,204,1.285,206,7.127]],["title/9",[32,0.367,81,0.499,107,1.405,131,0.925,137,1.345,170,2.124,207,3.399]],["description/9",[3,0.674,17,0.266,53,0.233,56,0.577,81,1.167,107,2.518,125,3.492,131,1.659,137,2.412,149,2.636,166,0.305,167,0.73,168,0.31,170,3.808,208,2.378,209,2.556,210,6.093]],["title/10",[51,1.86,56,0.573]],["description/10",[3,0.663,7,1.815,11,1.705,19,2.988,21,2.705,44,3.456,51,1.844,56,0.794,66,3.046,67,1.543,69,0.543,81,0.597,139,0.964,173,2.469,177,2.469,180,2.705,181,2.803,182,2.705,211,3.4,212,4.064,213,2.915,214,4.064,215,4.064,216,1.543,217,3.746,218,3.862,219,3.046,220,2.54,221,2.677,222,2.618,223,3.046,224,4.064,225,4.064,226,4.064,227,4.064,228,3.664,229,4.064,230,4.064]],["title/11",[32,0.566,51,1.609,56,0.496]],["description/11",[3,0.685,17,0.27,32,0.67,51,1.905,53,0.237,56,0.761,69,0.827,134,0.357,166,0.31,167,0.742,168,0.316,204,1.117,231,4.123,232,3.486,233,4.272,234,3.486,235,5.584]],["title/12",[51,1.609,56,0.496,73,1.109]],["description/12",[3,0.911,17,0.17,44,2.246,51,2.657,53,0.149,56,0.781,62,0.356,69,1.029,73,1.232,125,1.712,134,0.4,135,2.51,136,2.921,139,0.925,158,2.304,166,0.195,167,0.467,168,0.199,213,2.795,231,2.594,232,2.193,235,3.513,236,3.071,237,2.688,238,1.799,239,2.435,240,2.367,241,2.193,242,2.367,243,4.168,244,2.304,245,1.897,246,3.513,247,3.896]],["title/13",[32,0.566,51,1.609,56,0.496]],["description/13",[3,0.685,17,0.27,32,0.67,51,1.905,53,0.237,56,0.761,69,0.827,155,1.742,166,0.31,167,0.742,168,0.316,204,1.117,231,4.123,232,3.486,233,4.272,234,3.486,248,5.182]],["title/14",[51,1.609,56,0.496,139,1.242]],["description/14",[3,0.561,17,0.142,19,1.367,51,2.16,53,0.125,55,2.099,56,0.797,62,0.297,66,5.263,69,0.435,81,0.479,134,0.188,136,4.665,139,1.477,155,0.916,158,1.927,166,0.163,167,0.39,168,0.258,204,0.588,216,2.363,218,3.266,219,2.443,220,2.037,221,2.264,222,2.099,223,2.443,238,1.504,242,1.979,246,5.61,248,2.726,249,5.07,250,2.726,251,5.07,252,2.726,253,1.205,254,2.726,255,2.169,256,2.938,257,1.792,258,2.938,259,2.338,260,2.338,261,2.938,262,2.938,263,2.248,264,2.938]],["title/15",[51,1.609,56,0.496,265,1.322]],["description/15",[3,0.852,17,0.254,51,2.658,53,0.223,56,0.872,62,0.531,69,0.776,73,1.233,125,2.554,134,0.335,155,1.635,167,0.696,238,2.684,248,4.863,265,1.946]],["title/16",[81,1.052]],["description/16",[3,0.45,7,2.677,11,2.515,21,3.99,44,4.106,56,0.385,72,4.3,73,0.862,74,3.203,81,0.881,84,1.815,96,3.862,175,4.3,177,3.641,180,3.99,181,4.135,182,3.99,195,1.483,217,2.54,259,2.915,264,3.664,266,4.064,267,3.046,268,2.803,269,3.4,270,4.064,271,3.664,272,3.664,273,5.404,274,3.99,275,3.664,276,2.403,277,2.403,278,5.404]],["title/17",[32,0.654,81,0.888]],["description/17",[6,3.261,17,0.27,28,3.571,32,0.67,53,0.237,81,0.91,134,0.357,166,0.31,167,0.742,168,0.316,204,1.117,237,4.272,263,4.272,276,3.663,277,3.663,279,3.331,280,5.584,281,5.584]],["title/18",[73,1.282,81,0.888]],["description/18",[3,0.708,17,0.279,53,0.245,56,0.607,62,0.585,69,0.855,73,1.74,81,1.205,134,0.473,166,0.32,167,0.767,168,0.326,281,5.773]],["title/19",[32,0.654,81,0.888]],["description/19",[3,0.781,7,3.611,17,0.223,32,0.552,51,1.571,53,0.196,56,0.669,64,3.828,69,0.682,81,1.188,107,2.11,155,1.436,159,3.102,164,1.686,166,0.255,167,0.611,168,0.26,204,0.921,232,4.551,253,1.888,282,4.272,283,2.244,284,4.272]],["title/20",[81,0.888,139,1.435]],["description/20",[3,0.663,17,0.262,19,2.516,53,0.23,56,0.568,69,0.801,81,1.289,139,1.866,166,0.3,167,0.718,168,0.306,253,2.217,284,5.018,285,5.997,286,5.018,287,5.997,288,5.018]],["title/21",[81,0.888,265,1.528]],["description/21",[3,0.697,17,0.275,53,0.241,62,0.575,69,0.841,81,1.192,107,2.602,134,0.363,166,0.315,167,0.754,168,0.321,253,2.328,265,2.269,284,5.268]],["title/22",[32,0.498,81,0.677,158,2.726,173,2.8]],["description/22",[3,0.773,7,3.586,17,0.22,32,0.545,51,1.55,53,0.193,56,0.663,64,3.777,69,0.673,81,1.18,107,2.082,158,2.98,159,3.061,164,1.663,166,0.252,167,0.603,168,0.257,173,3.061,204,0.909,232,4.518,253,1.863,282,4.215,283,2.214,289,5.038]],["title/23",[290,3.486,291,2.999]],["description/23",[73,1.511,77,3.535,81,1.047,129,1.558,139,1.691,290,5.06,291,4.353,292,4.745]],["title/24",[73,0.978,139,1.094,290,2.658,291,2.287]],["description/24",[17,0.279,53,0.245,73,1.358,139,1.52,166,0.32,167,0.767,168,0.326,291,4.07,293,5.047,294,6.403,295,5.047,296,5.357,297,5.357,298,6.403,299,6.403]],["title/25",[291,2.999,300,4.766]],["description/25",[73,1.483,77,3.47,81,1.028,291,4.303,292,4.657,300,6.838,301,6.306,302,4.372,303,3.23]],["title/26",[73,1.109,291,2.595,300,4.124]],["description/26",[17,0.266,53,0.233,73,1.292,166,0.305,167,0.73,168,0.31,238,2.814,291,3.942,300,4.803,301,7.164,302,3.808,303,2.814,304,4.803,305,5.098,306,4.568,307,3.023,308,6.093]],["title/27",[129,1.008,309,2.881,310,2.8,311,2.535]],["description/27",[77,3.407,81,1.009,129,1.875,165,4.293,309,5.36,310,4.172,311,3.777,312,4.738,313,5.414,314,3.865]],["title/28",[73,0.79,129,0.814,309,2.328,310,2.263,311,2.049,314,2.096]],["description/28",[3,0.643,7,2.596,11,2.438,17,0.254,29,4.582,53,0.223,62,0.531,69,0.776,81,0.854,129,1.684,134,0.335,164,1.919,166,0.291,167,0.696,168,0.296,189,2.684,312,4.01,313,4.582,314,3.271,315,4.17,316,5.24]],["title/29",[32,0.403,129,0.814,309,2.328,310,2.263,311,2.049,314,2.096]],["description/29",[3,0.685,17,0.27,32,0.67,53,0.237,62,0.565,69,0.827,81,1.18,129,1.354,134,0.357,164,2.045,166,0.31,167,0.742,168,0.316,311,3.406,314,3.486,315,4.443,316,5.584]],["title/30",[129,0.814,265,0.941,309,2.328,310,2.263,311,2.049,314,2.096]],["description/30",[3,0.653,17,0.258,53,0.226,62,0.539,69,0.789,81,0.867,129,1.701,134,0.34,155,2.189,164,1.949,166,0.295,167,0.707,168,0.301,265,1.491,311,3.246,314,4.38,315,4.235,317,5.903]],["title/31",[309,2.881,310,2.8,311,2.535,318,2.97]],["description/31",[77,3.346,81,0.991,123,3.346,165,4.216,309,5.3,310,4.098,311,3.71,312,4.653,313,5.317,314,3.796,318,5.464]],["title/32",[73,0.79,309,2.328,310,2.263,311,2.049,314,2.096,318,2.4]],["description/32",[3,0.653,17,0.258,53,0.226,62,0.539,69,0.789,81,0.867,123,2.928,129,1.291,134,0.34,164,1.949,166,0.295,167,0.707,168,0.301,189,2.726,242,3.586,312,4.072,313,4.653,314,3.322,315,4.235,318,3.803,319,5.322]],["title/33",[32,0.403,309,2.328,310,2.263,311,2.049,314,2.096,318,2.4]],["description/33",[3,0.685,17,0.27,32,0.67,53,0.237,62,0.565,69,0.827,81,1.18,134,0.357,164,2.045,166,0.31,167,0.742,168,0.316,311,3.406,314,3.486,315,4.443,318,3.99,319,5.584]],["title/34",[265,0.941,309,2.328,310,2.263,311,2.049,314,2.096,318,2.4]],["description/34",[3,0.653,17,0.258,53,0.226,62,0.539,69,0.789,81,0.867,134,0.34,155,2.189,164,1.949,166,0.295,167,0.707,168,0.301,265,1.491,311,3.246,314,4.38,315,4.235,318,5.014,320,5.903]],["title/35",[291,2.999,321,4.025]],["description/35",[77,3.47,189,3.23,291,4.303,293,5.514,321,5.775,322,5.853,323,6.306,324,6.306,325,5.853]],["title/36",[291,2.999,321,4.025]],["description/36",[17,0.22,28,4.031,53,0.193,77,2.499,158,2.98,166,0.252,167,0.603,168,0.257,291,3.468,293,5.511,296,4.215,297,4.215,321,4.654,322,4.215,325,5.85,326,5.038,327,4.369,328,5.038,329,4.542,330,5.038,331,2.653,332,4.542,333,4.542,334,4.542,335,5.038,336,4.542]],["title/37",[158,3.094,291,2.595,321,3.482]],["description/37",[17,0.239,20,2.883,53,0.21,80,2.572,149,2.369,166,0.274,167,0.656,168,0.279,189,2.528,245,2.666,291,3.672,293,4.317,296,4.582,297,4.582,321,3.645,324,4.937,325,4.582,332,4.937,336,4.937,337,4.317,338,4.317,339,5.476,340,3.645,341,4.582,342,5.476]],["title/38",[81,0.888,343,4.337]],["description/38",[77,3.603,81,1.304,290,4.188,343,6.37,344,4.296,345,6.549,346,3.825]],["title/39",[32,0.566,77,2.595,343,3.753]],["description/39",[11,2.059,17,0.214,32,0.531,34,3.267,53,0.188,77,3.405,81,1.008,105,2.762,149,2.123,155,1.38,166,0.245,167,0.588,168,0.25,222,3.162,343,4.925,344,2.902,347,6.864,348,4.907,349,4.106,350,4.17,351,4.907,352,3.162,353,4.907,354,4.424,355,4.907,356,3.521,357,3.521,358,3.521,359,4.907]],["title/40",[77,2.044,81,0.605,343,2.956,360,3.715,361,3.089]],["description/40",[17,0.211,33,4.88,48,3.659,53,0.186,75,4.053,77,3.9,79,2.359,81,0.712,105,2.727,122,1.945,166,0.242,167,0.58,168,0.247,196,3.342,290,2.793,304,3.819,306,3.632,338,3.819,343,4.88,362,3.819,363,4.368,364,4.844,365,4.844,366,4.844,367,4.844,368,4.053,369,4.368,370,4.844,371,4.844,372,4.844]],["title/41",[107,2.96]],["description/41",[3,0.589,7,2.377,11,2.233,21,3.543,44,4.186,56,0.504,72,3.818,84,2.377,107,3,147,3.989,173,3.233,175,3.818,177,3.233,180,3.543,181,3.671,182,3.543,217,3.326,274,3.543,373,4.798,374,3.818,375,8.262,376,3.671,377,4.195,378,4.195]],["title/42",[32,0.654,107,2.499]],["description/42",[3,0.827,17,0.326,32,0.601,53,0.213,55,4.816,56,0.708,69,0.742,107,2.296,134,0.431,149,2.404,166,0.278,167,0.665,168,0.283,202,3.127,204,1.002,231,3.699,232,3.127,233,3.833,379,5.009,380,5.009]],["title/43",[73,1.282,107,2.499]],["description/43",[3,0.516,17,0.204,53,0.179,62,0.426,69,0.623,73,1.405,78,4.206,79,2.271,80,2.192,84,2.084,98,3.497,107,3.183,109,2.407,110,3.903,129,1.02,131,1.27,134,0.382,137,1.846,145,2.314,147,3.497,166,0.233,167,0.559,168,0.238,183,4.965,376,4.569,380,4.206,381,4.665,382,4.665,383,4.665,384,4.665,385,4.665,386,4.665]],["title/44",[32,0.654,107,2.499]],["description/44",[3,0.852,17,0.254,32,0.628,53,0.223,56,0.73,69,0.776,107,3.184,134,0.335,145,2.883,155,1.635,166,0.291,167,0.696,168,0.296,204,1.048,209,2.438,231,3.87,232,3.271,233,4.01,387,4.863]],["title/45",[107,2.499,265,1.528]],["description/45",[3,0.861,17,0.258,53,0.226,56,0.559,62,0.539,69,0.789,73,1.252,107,3.598,116,3.69,125,2.594,134,0.34,155,1.66,165,3.69,167,0.707,238,2.726,265,1.491,387,4.939,388,5.322]],["title/46",[107,2.499,139,1.435]],["description/46",[3,0.87,17,0.262,53,0.23,56,0.568,62,0.547,69,0.801,107,3.626,116,3.748,134,0.345,139,1.423,165,3.748,166,0.3,167,0.718,168,0.306,307,2.975,387,5.018,388,5.406]],["title/47",[107,2.162,139,1.242,376,3.609]],["description/47",[1,3.113,3,0.674,17,0.181,53,0.159,56,0.683,69,0.555,72,6.068,73,0.881,80,1.951,107,3.283,109,2.142,112,1.535,114,2.234,125,1.825,134,0.239,139,0.986,155,1.168,160,3.274,167,0.497,238,1.918,279,2.234,288,5.096,307,2.06,376,2.865,389,4.153,390,3.744,391,4.153,392,6.09,393,4.153,394,4.153,395,4.153,396,4.153,397,4.153,398,3.744,399,3.113,400,4.153]],["title/48",[112,2.648]],["description/48",[84,3.374,86,5.029,112,2.793,131,2.056,243,5.419,401,6.81,402,7.554]],["title/49",[32,0.654,112,2.235]],["description/49",[17,0.3,32,0.743,53,0.263,56,0.651,62,0.627,112,2.539,134,0.494,166,0.344,168,0.35,204,1.239,403,6.192]],["title/50",[73,1.282,112,2.235]],["description/50",[17,0.3,53,0.263,56,0.651,62,0.627,73,1.456,112,2.539,134,0.494,166,0.344,168,0.35,204,1.239,403,6.192]],["title/51",[32,0.654,112,2.235]],["description/51",[17,0.294,32,0.729,53,0.258,56,0.639,62,0.616,112,2.494,134,0.389,155,1.897,166,0.337,168,0.344,204,1.217,253,2.494,404,5.644]],["title/52",[112,2.235,265,1.528]],["description/52",[17,0.294,53,0.258,56,0.639,62,0.616,112,2.494,134,0.389,155,1.897,166,0.337,168,0.344,204,1.217,253,2.494,265,1.704,404,5.644]],["title/53",[112,2.235,139,1.435]],["description/53",[17,0.3,53,0.263,56,0.651,62,0.627,112,2.539,134,0.396,139,1.63,166,0.344,168,0.35,204,1.239,307,3.407,404,5.747]],["title/54",[112,1.934,139,1.242,405,4.716]],["description/54",[17,0.254,53,0.223,56,0.73,62,0.531,84,2.596,112,3.194,114,3.127,131,1.582,134,0.335,137,2.3,139,1.38,166,0.291,168,0.296,204,1.048,238,2.684,260,4.17,306,4.357,405,5.24,406,5.812]],["title/55",[112,2.235,407,3.779]],["description/55",[58,4.172,81,1.009,112,3.457,131,2.335,257,3.777,292,4.572,407,4.293,408,6.192,409,6.868]],["title/56",[32,0.566,112,1.934,407,3.269]],["description/56",[3,0.663,17,0.262,53,0.23,56,0.745,81,0.881,112,2.907,164,1.98,166,0.3,167,0.718,168,0.306,204,1.082,216,2.986,257,3.298,407,5.483,410,5.406]],["title/57",[73,1.109,112,1.934,407,3.269]],["description/57",[3,0.557,17,0.22,53,0.193,55,3.246,56,0.761,58,3.061,73,1.703,81,0.74,112,3.206,166,0.252,167,0.603,168,0.257,204,0.909,209,2.114,216,2.655,407,5.018,410,4.542,411,3.777,412,4.215,413,5.038,414,4.542,415,4.542]],["title/58",[32,0.566,112,1.934,407,3.269]],["description/58",[3,0.835,17,0.246,20,2.969,53,0.216,56,0.715,81,0.828,112,2.791,134,0.325,155,1.586,166,0.282,167,0.675,168,0.287,204,1.017,209,2.366,216,2.866,257,3.101,407,5.319,416,5.084]],["title/59",[112,1.934,265,1.322,407,3.269]],["description/59",[3,0.819,17,0.239,53,0.21,55,3.528,56,0.701,81,0.805,112,2.736,155,1.54,166,0.274,167,0.656,168,0.279,204,0.988,209,2.297,216,2.81,265,2.118,407,5.24,414,4.937,416,4.937]],["title/60",[109,3.119,112,2.235]],["description/60",[11,2.264,56,0.695,68,2.842,79,2.628,80,2.536,81,0.793,84,3.717,107,2.231,109,4.605,112,3.077,116,3.374,117,4.516,118,4.516,131,1.469,165,3.374,209,2.264,211,4.516,411,4.046,417,5.398]],["title/61",[32,0.566,109,2.698,112,1.934]],["description/61",[17,0.294,32,0.729,53,0.258,56,0.639,62,0.616,109,3.48,112,2.494,134,0.488,166,0.337,168,0.344,204,1.217,418,6.081]],["title/62",[73,1.109,109,2.698,112,1.934]],["description/62",[17,0.294,53,0.258,56,0.639,62,0.616,73,1.431,109,3.48,112,2.494,134,0.488,166,0.337,168,0.344,204,1.217,418,6.081]],["title/63",[32,0.566,109,2.698,112,1.934]],["description/63",[17,0.294,32,0.729,53,0.258,56,0.639,62,0.616,109,3.48,112,2.494,134,0.389,166,0.337,168,0.344,204,1.217,253,2.494,419,5.644]],["title/64",[109,2.698,112,1.934,265,1.322]],["description/64",[17,0.289,53,0.254,56,0.628,62,0.605,109,3.419,112,2.45,134,0.382,155,1.864,166,0.332,168,0.338,204,1.195,253,2.45,265,1.674,419,5.545]],["title/65",[109,2.698,112,1.934,139,1.242]],["description/65",[17,0.294,53,0.258,56,0.639,62,0.616,109,3.48,112,2.494,134,0.389,139,1.601,166,0.337,168,0.344,204,1.217,307,3.346,419,5.644]],["title/66",[114,3.852]],["description/66",[11,3.199,56,0.723,68,3.014,79,2.787,80,2.689,81,0.841,84,3.829,107,2.366,109,2.953,114,4.612,116,3.578,117,4.79,118,4.79,131,1.558,209,2.402,211,4.79,411,4.291]],["title/67",[32,0.654,114,3.252]],["description/67",[17,0.3,32,0.743,53,0.263,56,0.651,62,0.627,114,3.694,134,0.494,166,0.344,168,0.35,204,1.239,420,6.192]],["title/68",[73,1.282,114,3.252]],["description/68",[17,0.258,53,0.226,56,0.559,62,0.539,73,1.252,79,3.789,80,3.656,114,3.175,125,2.594,134,0.448,166,0.295,168,0.301,204,1.065,257,4.28,420,5.322,421,5.903,422,5.903]],["title/69",[32,0.654,114,3.252]],["description/69",[17,0.3,32,0.743,53,0.263,56,0.651,62,0.627,114,3.694,134,0.396,166,0.344,168,0.35,204,1.239,253,2.539,423,5.747]],["title/70",[114,3.252,265,1.528]],["description/70",[17,0.294,53,0.258,56,0.639,62,0.616,114,3.628,134,0.389,155,1.897,166,0.337,168,0.344,204,1.217,253,2.494,265,1.704,423,5.644]],["title/71",[114,3.252,139,1.435]],["description/71",[17,0.3,53,0.263,56,0.651,62,0.627,114,3.694,134,0.396,139,1.63,166,0.344,168,0.35,204,1.239,307,3.407,423,5.747]],["title/72",[129,1.322,424,1.738]],["description/72",[3,0.653,11,2.476,69,0.789,81,0.867,129,2.024,290,3.404,291,2.928,344,3.491,424,2.503,425,3.404,426,3.93,427,4.425,428,4.653,429,4.653,430,4.072,431,4.425]],["title/73",[73,1.109,129,1.144,424,1.504]],["description/73",[3,0.788,17,0.226,51,1.592,53,0.198,56,0.491,62,0.473,67,1.965,69,0.951,73,1.51,81,0.76,129,1.781,134,0.298,166,0.259,167,0.62,168,0.264,195,1.889,216,1.965,283,2.275,344,3.061,424,2.342,426,3.446,432,2.39,433,4.666]],["title/74",[32,0.566,129,1.144,424,1.504]],["description/74",[3,0.773,17,0.22,32,0.756,53,0.193,56,0.477,62,0.46,67,1.913,69,0.673,81,1.027,129,1.529,134,0.29,166,0.252,167,0.603,168,0.257,202,2.835,216,1.913,221,2.25,234,2.835,241,2.835,276,2.98,277,2.98,424,2.01,432,2.326,433,4.542,434,4.542,435,4.542,436,3.476]],["title/75",[32,0.566,129,1.144,424,1.504]],["description/75",[3,0.803,17,0.232,32,0.785,51,1.637,53,0.204,56,0.504,62,0.486,67,2.021,69,0.97,129,1.587,134,0.307,155,1.497,166,0.266,167,0.637,168,0.271,195,1.942,216,2.021,234,2.995,253,1.967,283,2.339,424,2.087,432,2.457,437,4.453]],["title/76",[129,1.144,139,1.242,424,1.504]],["description/76",[3,0.895,17,0.223,51,1.571,53,0.196,56,0.484,62,0.466,67,1.939,69,1.08,129,1.768,134,0.294,139,1.675,155,1.436,166,0.255,167,0.611,168,0.26,195,1.863,216,1.939,283,2.244,307,2.533,424,2.325,432,2.358,437,4.272]],["title/77",[129,1.144,265,1.322,424,1.504]],["description/77",[3,0.895,17,0.223,51,1.571,53,0.196,56,0.484,62,0.466,67,1.939,69,1.08,129,1.768,134,0.294,155,1.436,166,0.255,167,0.611,168,0.26,195,1.863,216,1.939,265,1.783,283,2.244,307,2.533,424,2.325,432,2.358,437,4.272]],["title/78",[73,0.978,129,1.008,424,1.325,438,3.307]],["description/78",[3,0.72,17,0.199,51,1.401,53,0.174,56,0.431,58,2.766,62,0.416,67,1.729,69,0.87,73,1.38,81,0.669,106,3.589,129,1.813,134,0.262,143,3.589,166,0.228,167,0.545,168,0.232,195,1.661,196,3.141,209,1.91,216,1.729,238,3.006,283,2.001,424,2.185,432,2.102,438,3.266,439,4.105,440,4.105,441,4.105,442,4.105]],["title/79",[129,1.008,139,1.094,424,1.325,438,3.307]],["description/79",[3,0.819,17,0.157,46,1.264,51,1.107,53,0.138,56,0.341,58,3.325,62,0.329,67,1.367,69,0.885,79,1.753,81,0.529,106,2.837,129,1.74,134,0.207,139,1.572,140,2.026,143,2.837,166,0.18,167,0.431,168,0.183,194,3.245,195,1.313,196,2.483,209,1.51,216,1.367,220,2.25,238,2.527,240,2.187,245,2.665,283,1.582,290,2.075,368,3.012,424,2.128,432,1.662,438,3.927,439,3.245,440,3.245,441,3.245,442,3.245,443,3.6,444,3.6,445,3.6,446,3.245]],["title/80",[424,1.504,447,2.457,448,3.269]],["description/80",[3,0.615,11,2.331,69,0.742,81,0.816,290,3.204,291,2.756,344,3.286,424,2.429,425,3.204,426,3.699,427,4.165,428,4.38,429,4.38,430,3.833,431,4.165,447,4.244,448,5.279,449,3.833]],["title/81",[73,0.978,424,1.325,447,2.165,448,2.881]],["description/81",[3,0.766,17,0.217,51,1.53,53,0.19,56,0.471,62,0.454,67,1.888,69,0.925,73,1.469,81,0.73,134,0.286,166,0.249,167,0.595,168,0.253,195,1.814,216,1.888,283,2.185,344,2.94,424,2.292,426,3.31,432,2.296,447,3.745,448,3.107,449,4.779,450,4.482]],["title/82",[32,0.498,424,1.325,447,2.165,449,3.18]],["description/82",[3,0.766,17,0.217,32,0.749,51,1.53,53,0.19,56,0.656,62,0.454,67,1.888,69,0.925,134,0.286,166,0.249,167,0.595,168,0.253,195,1.814,216,1.888,221,2.22,234,2.798,276,2.94,277,2.94,279,2.674,283,2.185,424,1.992,432,2.296,447,3.254,449,4.779,450,4.482]],["title/83",[32,0.498,424,1.325,447,2.165,448,2.881]],["description/83",[3,0.788,17,0.226,32,0.77,51,1.592,53,0.198,56,0.491,62,0.473,67,1.965,69,0.951,134,0.298,155,1.456,166,0.259,167,0.62,168,0.264,195,1.889,216,1.965,234,2.913,253,1.914,283,2.275,424,2.048,432,2.39,447,3.346,448,3.235,449,3.571,451,4.331]],["title/84",[139,1.094,424,1.325,447,2.165,448,2.881]],["description/84",[3,0.876,17,0.214,51,1.51,53,0.188,56,0.465,62,0.448,67,1.863,69,1.057,134,0.283,139,1.629,155,1.38,166,0.245,167,0.588,168,0.25,195,1.791,216,1.863,283,2.157,307,2.434,424,2.276,432,2.266,447,3.719,448,4.29,449,3.385,451,4.106]],["title/85",[265,1.165,424,1.325,447,2.165,448,2.881]],["description/85",[3,0.876,17,0.214,51,1.51,53,0.188,56,0.465,62,0.448,67,1.863,69,1.057,134,0.283,155,1.38,166,0.245,167,0.588,168,0.25,195,1.791,216,1.863,265,1.734,283,2.157,307,2.434,424,2.276,432,2.266,447,3.719,448,4.29,449,3.385,451,4.106]],["title/86",[424,1.738,452,2.02]],["description/86",[3,0.51,69,0.616,81,0.677,162,2.799,213,3.306,267,3.455,318,2.969,344,2.725,399,3.455,424,2.199,425,3.786,426,3.068,429,3.633,430,3.179,431,3.455,452,3.061,453,4.155,454,4.155,455,2.725,456,3.856,457,4.155,458,3.856,459,3.856,460,1.824,461,4.155,462,4.155,463,4.155,464,4.155,465,4.155,466,4.155,467,4.155]],["title/87",[73,1.109,424,1.504,452,1.748]],["description/87",[3,0.614,7,2.48,17,0.16,51,1.129,53,0.141,56,0.348,62,0.335,67,1.393,69,0.742,73,1.178,81,0.816,134,0.211,162,2.229,166,0.184,167,0.439,168,0.187,195,1.339,213,2.632,216,1.393,244,2.17,267,2.751,283,1.613,344,2.17,424,1.927,425,3.202,426,2.443,432,1.694,452,2.497,453,3.308,454,3.308,455,2.17,456,3.07,457,3.308,458,3.07,459,4.647,460,1.452,461,3.308,462,3.308,463,3.308,464,3.308,465,3.308,466,3.308,467,3.308,468,2.632,469,3.669,470,2.751,471,2.893,472,3.07]],["title/88",[32,0.566,424,1.504,452,1.748]],["description/88",[3,0.781,17,0.223,32,0.763,51,1.571,53,0.196,56,0.669,62,0.466,67,1.939,69,0.943,134,0.294,166,0.255,167,0.611,168,0.26,195,1.863,216,1.939,221,2.28,234,2.874,276,3.02,277,3.02,279,2.747,283,2.244,424,2.029,432,2.358,452,2.358,472,4.272]],["title/89",[252,4.377,424,1.504,452,1.748]],["description/89",[3,0.708,17,0.149,48,1.832,51,1.048,53,0.13,56,0.323,58,2.069,62,0.311,67,1.293,69,0.701,73,0.722,81,0.94,108,2.684,134,0.196,139,0.808,166,0.17,167,0.408,168,0.173,183,3.932,195,1.242,216,1.293,218,2.194,219,2.552,221,2.343,238,2.954,239,2.128,242,2.069,245,1.658,252,4.389,265,0.86,283,1.496,307,2.602,327,2.128,362,2.684,399,2.552,424,2.358,432,1.572,452,2.74,468,3.763,470,2.552,471,2.684,472,2.849,473,5.246,474,3.405,475,3.405]],["title/90",[265,1.322,424,1.504,452,1.748]],["description/90",[3,0.901,17,0.226,51,1.592,53,0.198,56,0.491,62,0.473,67,1.965,69,1.088,81,0.76,134,0.298,166,0.259,167,0.62,168,0.264,195,1.889,216,1.965,265,1.8,283,2.275,424,2.342,432,2.39,452,2.721,476,5.176]],["title/91",[32,0.566,424,1.504,452,1.748]],["description/91",[3,0.803,17,0.232,32,0.785,51,1.637,53,0.204,56,0.504,62,0.486,67,2.021,69,0.97,134,0.307,155,1.497,166,0.266,167,0.637,168,0.271,195,1.942,216,2.021,234,2.995,253,1.967,283,2.339,424,2.087,432,2.457,452,2.426,477,4.453]],["title/92",[139,1.242,424,1.504,452,1.748]],["description/92",[3,0.835,17,0.196,42,2.899,51,1.384,53,0.172,56,0.426,62,0.411,67,1.708,69,1.008,134,0.259,139,1.791,155,1.265,166,0.225,167,0.539,168,0.229,195,1.641,216,1.708,260,3.227,261,4.056,283,1.977,307,2.232,424,2.17,425,2.594,432,2.077,452,2.522,468,3.227,477,3.764,478,4.056,479,4.056,480,4.499,481,4.499]],["title/93",[265,1.322,424,1.504,452,1.748]],["description/93",[3,0.888,17,0.22,51,1.55,53,0.193,56,0.477,62,0.46,67,1.913,69,1.072,134,0.29,155,1.417,166,0.252,167,0.603,168,0.257,195,1.838,216,1.913,265,1.766,283,2.214,307,2.499,424,2.308,425,2.905,432,2.326,452,2.683,477,4.215]],["title/94",[424,1.738,482,3.486]],["description/94",[3,0.624,11,2.366,69,0.753,81,0.828,290,3.251,291,2.797,344,3.335,424,2.447,425,3.251,426,3.754,427,4.227,428,4.445,429,4.445,430,3.89,431,4.227,482,5.24,483,3.894,484,5.639]],["title/95",[73,1.109,424,1.504,482,3.016]],["description/95",[3,0.781,17,0.223,51,1.571,53,0.196,56,0.484,62,0.466,67,1.939,69,0.943,73,1.496,81,0.75,84,2.28,134,0.294,166,0.255,167,0.611,168,0.26,195,1.863,216,1.939,283,2.244,344,3.02,424,2.325,426,3.399,432,2.358,482,4.662,485,4.603]],["title/96",[32,0.566,424,1.504,482,3.016]],["description/96",[3,0.781,17,0.223,32,0.763,51,1.571,53,0.196,56,0.669,62,0.466,67,1.939,69,0.943,134,0.294,166,0.255,167,0.611,168,0.26,195,1.863,216,1.939,221,2.28,234,2.874,276,3.02,277,3.02,279,2.747,283,2.244,424,2.029,432,2.358,482,4.068,485,4.603]],["title/97",[32,0.566,424,1.504,482,3.016]],["description/97",[3,0.803,17,0.232,32,0.785,51,1.637,53,0.204,56,0.504,62,0.486,67,2.021,69,0.97,134,0.307,155,1.497,166,0.266,167,0.637,168,0.271,195,1.942,216,2.021,234,2.995,253,1.967,283,2.339,424,2.087,432,2.457,482,4.186,486,4.453]],["title/98",[139,1.242,424,1.504,482,3.016]],["description/98",[3,0.895,17,0.223,51,1.571,53,0.196,56,0.484,62,0.466,67,1.939,69,1.08,134,0.294,139,1.675,155,1.436,166,0.255,167,0.611,168,0.26,195,1.863,216,1.939,283,2.244,307,2.533,424,2.325,432,2.358,482,4.662,486,4.272]],["title/99",[265,1.322,424,1.504,482,3.016]],["description/99",[3,0.895,17,0.223,51,1.571,53,0.196,56,0.484,62,0.466,67,1.939,69,1.08,134,0.294,155,1.436,166,0.255,167,0.611,168,0.26,195,1.863,216,1.939,265,1.783,283,2.244,307,2.533,424,2.325,432,2.358,482,4.662,486,4.272]],["title/100",[487,4.235]],["description/100",[3,0.581,19,2.202,73,1.113,81,0.771,86,3.494,123,2.603,129,1.572,139,1.246,165,3.28,208,2.048,216,1.993,257,2.886,265,1.326,268,4.96,487,5.218,488,4.391,489,4.137,490,4.391,491,4.391,492,5.248,493,3.934,494,5.248,495,5.248,496,4.391]],["title/101",[32,0.654,487,3.576]],["description/101",[3,0.778,17,0.257,19,1.669,32,0.43,51,1.224,53,0.226,56,0.667,62,0.363,67,1.511,68,2.095,69,0.788,81,1.033,129,1.29,134,0.34,140,2.239,166,0.295,167,0.476,168,0.301,195,1.452,204,0.718,209,1.669,221,1.777,238,1.837,268,2.744,276,2.353,277,2.353,279,2.14,312,2.744,344,2.353,470,2.982,487,3.489,488,3.329,489,3.136,490,3.329,496,3.329,497,3.136,498,2.854,499,3.587]],["title/102",[73,1.282,487,3.576]],["description/102",[3,0.746,17,0.294,53,0.258,69,0.901,73,1.431,81,0.991,134,0.389,164,2.227,166,0.337,167,0.808,168,0.344,487,3.989,499,6.081]],["title/103",[32,0.654,487,3.576]],["description/103",[3,0.798,17,0.266,19,1.742,32,0.449,51,1.278,53,0.233,56,0.683,62,0.379,67,1.577,68,2.187,69,0.963,81,0.61,129,0.908,134,0.351,155,1.168,166,0.305,167,0.497,168,0.31,195,1.515,204,0.749,234,2.337,253,1.535,268,2.865,283,1.825,312,2.865,344,2.456,470,3.113,487,3.602,488,3.475,489,3.274,490,3.475,496,3.475,497,3.274,498,2.979,500,3.475,501,3.475]],["title/104",[265,1.528,487,3.576]],["description/104",[3,0.663,17,0.262,53,0.23,69,0.801,81,1.155,134,0.345,156,5.018,164,1.98,166,0.3,167,0.718,168,0.306,265,1.515,487,4.65,500,5.018,501,5.018,502,5.997,503,5.406,504,4.302]],["title/105",[139,1.435,487,3.576]],["description/105",[3,0.516,17,0.204,28,3.819,46,2.326,53,0.254,69,0.623,81,0.973,134,0.269,139,1.828,156,3.903,164,1.54,166,0.233,167,0.559,168,0.238,183,3.497,220,2.916,238,2.154,240,4.678,305,3.903,487,3.917,500,3.903,501,3.903,503,4.206,504,3.347,505,4.206,506,4.665,507,2.916,508,4.665,509,4.665]],["title/106",[510,3.252,511,2.792]],["description/106",[11,2.032,84,3.038,123,2.403,129,1.059,147,3.632,159,2.943,208,1.891,390,4.368,401,4.368,510,3.659,511,3.141,512,4.844,513,6.802,514,4.368,515,4.844,516,4.844,517,4.844,518,3.632,519,4.368,520,4.844,521,4.844,522,4.844,523,4.844,524,4.053,525,4.053,526,4.844,527,4.368,528,4.844,529,2.727,530,4.844,531,4.844]],["title/107",[32,0.566,510,2.814,511,2.415]],["description/107",[17,0.294,32,0.729,53,0.258,56,0.639,62,0.616,134,0.488,166,0.337,168,0.344,204,1.217,510,3.628,511,3.115,532,6.081]],["title/108",[73,1.109,510,2.814,511,2.415]],["description/108",[17,0.294,53,0.258,56,0.639,62,0.616,73,1.431,134,0.488,166,0.337,168,0.344,204,1.217,510,3.628,511,3.115,532,6.081]],["title/109",[32,0.566,510,2.814,511,2.415]],["description/109",[17,0.284,32,0.704,53,0.25,56,0.786,62,0.595,134,0.375,166,0.326,168,0.332,204,1.175,253,2.408,510,3.503,511,3.83,533,5.45]],["title/110",[265,1.322,510,2.814,511,2.415]],["description/110",[17,0.279,53,0.245,56,0.778,62,0.585,134,0.369,155,1.801,166,0.32,168,0.326,204,1.155,253,2.367,265,1.618,510,3.444,511,3.788,533,5.357]],["title/111",[139,1.242,510,2.814,511,2.415]],["description/111",[17,0.284,53,0.25,56,0.786,62,0.595,134,0.375,139,1.546,166,0.326,168,0.332,204,1.175,307,3.231,510,3.503,511,3.83,533,5.45]],["title/112",[32,0.566,510,2.814,534,3.016]],["description/112",[17,0.305,53,0.268,56,0.663,62,0.639,134,0.403,166,0.35,168,0.356,204,1.262,510,3.763,534,4.033,535,6.995]],["title/113",[483,2.698,511,2.415,529,2.944]],["description/113",[7,2.164,11,2.854,21,3.225,44,3.922,173,2.943,175,3.476,177,2.943,180,3.225,181,3.342,182,3.225,208,1.891,217,3.028,274,3.225,377,3.819,378,3.819,408,4.368,411,3.632,483,3.509,511,3.141,514,4.368,524,4.053,525,4.053,529,3.828,534,2.793,536,5.362,537,4.368,538,7.861]],["title/114",[32,0.498,483,2.378,511,2.128,529,2.594]],["description/114",[17,0.289,32,0.716,53,0.254,56,0.628,62,0.605,134,0.483,166,0.332,168,0.338,204,1.195,483,3.419,511,3.06,529,3.73,539,5.975]],["title/115",[73,0.978,483,2.378,511,2.128,529,2.594]],["description/115",[17,0.289,53,0.254,56,0.628,62,0.605,73,1.405,134,0.483,166,0.332,168,0.338,204,1.195,483,3.419,511,3.06,529,3.73,539,5.975]],["title/116",[32,0.498,483,2.378,511,2.128,529,2.594]],["description/116",[17,0.284,32,0.704,53,0.25,56,0.617,62,0.595,134,0.375,155,1.832,166,0.326,168,0.332,204,1.175,253,2.408,483,3.36,511,3.007,529,3.666,540,5.45]],["title/117",[139,1.094,483,2.378,511,2.128,529,2.594]],["description/117",[17,0.289,53,0.254,56,0.628,62,0.605,134,0.382,139,1.573,166,0.332,168,0.338,204,1.195,253,2.45,483,3.419,511,3.06,529,3.73,540,5.545]],["title/118",[265,1.165,483,2.378,511,2.128,529,2.594]],["description/118",[17,0.289,53,0.254,56,0.628,62,0.605,134,0.382,155,1.864,166,0.332,168,0.338,204,1.195,265,1.674,483,3.419,511,3.06,529,3.73,540,5.545]],["title/119",[32,0.566,483,2.698,534,3.016]],["description/119",[17,0.305,53,0.268,56,0.663,62,0.639,134,0.403,166,0.35,168,0.356,204,1.262,483,3.608,534,4.033,541,6.995]],["title/120",[122,2.427,123,2.999]],["description/120",[7,2.518,11,2.366,23,3.89,44,4.353,73,1.196,95,5.084,122,2.264,123,2.797,126,3.633,127,5.084,129,1.233,139,1.338,173,3.426,238,2.604,240,3.426,254,4.718,310,3.426,350,3.426,498,4.046,542,5.639,543,5.084,544,5.639,545,5.639]],["title/121",[32,0.566,122,2.1,123,2.595]],["description/121",[3,0.778,7,3.141,17,0.174,48,2.14,53,0.152,55,2.563,56,0.737,69,0.531,81,0.584,122,3.336,123,4.122,134,0.229,145,1.973,149,3.042,159,2.417,164,1.948,166,0.199,167,0.476,168,0.203,204,0.718,216,2.24,232,2.239,236,3.136,243,2.854,257,2.188,546,3.587,547,3.136,548,3.978,549,3.329,550,3.978,551,3.978,552,3.587,553,3.587]],["title/122",[73,1.109,122,2.1,123,2.595]],["description/122",[3,0.708,7,2.858,17,0.194,44,2.563,56,0.607,73,1.59,122,3.01,123,3.72,126,4.831,134,0.256,137,2.533,167,0.532,204,0.802,216,2.43,232,2.502,236,3.505,238,2.053,239,2.779,240,2.701,242,2.701,263,3.067,498,3.19,549,3.72,553,4.008,554,4.446,555,4.446,556,4.446,557,4.26]],["title/123",[32,0.566,122,2.1,123,2.595]],["description/123",[3,0.648,17,0.255,53,0.224,56,0.734,62,0.534,69,0.782,81,0.578,122,3.481,123,4.301,134,0.337,145,1.953,155,2.327,159,2.391,166,0.293,167,0.471,168,0.298,204,0.71,216,1.495,237,2.716,242,3.557,245,2.851,257,2.165,263,2.716,549,3.294,558,3.937,559,3.294]],["title/124",[122,2.1,123,2.595,265,1.322]],["description/124",[3,0.702,17,0.277,53,0.243,56,0.601,62,0.579,69,0.848,122,3.473,123,4.292,134,0.366,155,2.433,166,0.317,167,0.526,168,0.323,204,0.793,237,3.031,242,3.855,245,3.09,263,3.031,265,1.11,559,3.677]],["title/125",[122,2.1,123,2.595,139,1.242]],["description/125",[3,0.793,17,0.264,53,0.231,56,0.679,62,0.552,69,0.807,122,3.654,123,4.516,134,0.348,139,0.975,155,2.368,166,0.302,167,0.492,168,0.308,204,0.741,237,2.834,242,3.67,245,2.942,263,2.834,559,3.437]],["title/126",[126,3.895,557,4.025]],["description/126",[6,2.314,24,3.294,32,0.475,48,2.364,81,0.646,83,2.925,98,3.294,105,2.473,122,2.547,123,2.18,126,4.089,135,2.831,149,1.901,166,0.22,189,2.029,191,3.962,221,1.962,241,2.473,244,2.599,323,3.962,345,3.962,399,3.294,470,3.294,504,3.152,547,3.464,557,6.002,560,3.677,561,3.677,562,3.962,563,3.962,564,4.394,565,4.394,566,4.394,567,4.394,568,2.417,569,4.394]],["title/127",[126,3.895,557,4.025]],["description/127",[3,0.606,17,0.239,53,0.21,56,0.519,69,0.731,81,0.805,126,3.528,166,0.274,167,0.656,168,0.279,204,0.988,221,2.446,231,3.645,232,3.082,233,3.777,234,3.082,241,3.082,257,3.011,276,3.238,277,3.238,436,3.777,491,4.582,557,3.645,561,4.582,562,4.937,570,5.476]],["title/128",[32,0.566,126,3.37,557,3.482]],["description/128",[3,0.606,17,0.239,32,0.592,53,0.21,56,0.519,69,0.731,81,0.805,98,4.105,105,3.082,126,3.528,155,1.54,166,0.37,167,0.656,168,0.279,204,0.988,231,3.645,232,3.082,233,3.777,234,3.082,257,3.011,547,4.317,557,4.927,563,4.937,571,5.476]],["title/129",[131,1.646,137,2.393]],["description/129",[3,0.721,56,0.617,86,4.336,107,2.692,129,1.424,131,2.258,137,3.283,195,2.376,208,2.542,292,4.336,572,8.294,573,5.872]],["title/130",[32,0.566,131,1.424,137,2.07]],["description/130",[3,0.827,17,0.326,53,0.213,55,4.816,56,0.708,69,0.742,131,1.513,134,0.431,137,2.199,149,2.404,166,0.278,167,0.665,168,0.283,202,3.127,204,1.002,231,3.699,232,3.127,233,3.833,379,5.009,574,5.009]],["title/131",[73,1.109,131,1.424,137,2.07]],["description/131",[3,0.918,17,0.284,53,0.25,62,0.595,69,1.108,73,1.381,131,1.773,134,0.375,137,2.578,166,0.326,167,0.78,168,0.332,574,5.872]],["title/132",[32,0.566,131,1.424,137,2.07]],["description/132",[3,0.733,17,0.289,20,3.488,51,1.435,53,0.254,56,0.628,62,0.605,69,0.885,131,2.41,134,0.382,137,3.504,149,2.865,155,1.312,164,1.54,166,0.331,167,0.559,168,0.338,204,0.841,575,3.903]],["title/133",[131,1.424,137,2.07,265,1.322]],["description/133",[3,0.697,17,0.275,53,0.241,62,0.575,69,0.841,131,2.209,134,0.363,137,3.212,155,1.771,164,2.079,166,0.315,167,0.754,168,0.321,265,1.591,575,5.268]],["title/134",[131,1.424,137,2.07,139,1.242]],["description/134",[3,0.697,17,0.275,53,0.241,62,0.575,69,0.841,131,2.209,134,0.363,137,3.212,139,1.494,155,1.771,164,2.079,166,0.315,167,0.754,168,0.321,575,5.268]],["title/135",[32,0.498,137,1.824,145,2.287,576,4.61]],["description/135",[3,0.685,17,0.27,53,0.237,62,0.565,69,0.827,129,1.756,131,2.186,134,0.357,137,3.178,164,2.045,166,0.31,167,0.742,168,0.316,577,5.584,578,5.584]],["title/136",[73,0.978,137,1.824,145,2.287,579,3.857]],["description/136",[3,0.597,17,0.235,53,0.207,62,0.493,69,0.721,129,1.603,131,2.266,134,0.311,137,2.901,140,3.038,145,3.636,164,1.782,166,0.27,167,0.646,168,0.275,195,2.674,279,2.903,578,4.866,580,5.398,581,5.398,582,5.398]],["title/137",[137,1.824,145,2.287,265,1.165,579,3.857]],["description/137",[3,0.47,17,0.185,53,0.163,55,2.736,62,0.388,69,0.567,129,1.353,131,1.685,134,0.245,136,4.64,137,3.177,140,2.39,145,2.106,155,2.055,160,3.347,164,1.402,166,0.212,167,0.508,168,0.216,180,2.827,182,2.827,265,1.073,277,3.661,377,3.347,378,3.347,579,5.179,583,4.246,584,4.64,585,4.246,586,4.246,587,3.553,588,3.183,589,4.246,590,3.828,591,4.246]],["title/138",[131,1.95]],["description/138",[56,0.651,109,3.543,112,2.539,114,3.694,122,2.757,123,3.407,129,1.502,131,1.87,257,3.777,491,5.747,592,6.868,593,4.927]],["title/139",[32,0.654,131,1.646]],["description/139",[17,0.305,53,0.268,56,0.822,62,0.639,131,1.904,134,0.403,166,0.35,168,0.356,204,1.262,594,6.306]],["title/140",[73,1.282,131,1.646]],["description/140",[17,0.3,53,0.263,56,0.813,62,0.627,73,1.456,131,1.87,134,0.396,166,0.344,168,0.35,204,1.239,594,6.192]],["title/141",[73,1.109,131,1.424,438,3.753]],["description/141",[11,1.333,17,0.139,19,1.333,36,2.658,53,0.122,56,0.471,58,3.019,62,0.29,73,1.054,77,1.576,98,2.381,106,3.918,107,2.054,129,1.514,131,2.17,134,0.183,135,2.046,142,2.279,143,3.918,166,0.159,168,0.253,190,2.504,193,2.279,204,0.573,222,2.046,238,1.467,304,2.504,312,2.191,398,2.864,415,4.481,438,2.279,460,1.257,471,2.504,483,3.572,534,1.831,537,2.864,595,3.176,596,3.176,597,3.176,598,3.176,599,1.442,600,2.864,601,4.97,602,5.52,603,3.176,604,3.176,605,3.176,606,3.176,607,3.176,608,3.176,609,2.864,610,3.176,611,3.176,612,3.176]],["title/142",[32,0.654,131,1.646]],["description/142",[17,0.289,53,0.254,56,0.795,62,0.605,131,2.283,134,0.382,155,1.864,166,0.332,168,0.338,204,1.195,209,2.78,613,5.545]],["title/143",[131,1.646,265,1.528]],["description/143",[17,0.284,53,0.25,56,0.786,62,0.595,131,2.258,134,0.375,155,1.832,166,0.326,168,0.332,204,1.175,209,2.732,265,1.646,613,5.45]],["title/144",[131,1.646,139,1.435]],["description/144",[17,0.284,53,0.25,56,0.786,62,0.595,131,2.258,134,0.375,139,1.546,155,1.832,166,0.326,168,0.332,204,1.175,209,2.732,613,5.45]],["title/145",[32,0.498,131,1.255,158,2.726,173,2.8]],["description/145",[17,0.3,53,0.263,56,0.651,62,0.627,131,1.87,134,0.396,158,4.062,166,0.344,168,0.35,173,4.172,204,1.239,614,6.868]],["title/146",[32,0.654,534,3.486]],["description/146",[17,0.305,53,0.268,56,0.663,62,0.639,131,1.904,134,0.403,166,0.35,168,0.356,204,1.262,534,4.033,615,6.995]],["title/147",[32,0.498,131,1.255,510,2.48,534,2.658]],["description/147",[17,0.3,53,0.263,56,0.651,62,0.627,131,1.87,134,0.396,166,0.344,168,0.35,204,1.239,510,3.694,534,3.96,616,6.868]],["title/148",[32,0.498,131,1.255,483,2.378,534,2.658]],["description/148",[17,0.3,53,0.263,56,0.651,62,0.627,131,1.87,134,0.396,166,0.344,168,0.35,204,1.239,483,3.543,534,3.96,617,6.868]],["title/149",[129,1.566]],["description/149",[80,3.06,81,0.957,84,2.909,129,1.813,259,4.673,267,6.218,268,4.493,518,4.882,519,5.872,525,5.45,527,5.872,536,5.134,618,5.872]],["title/150",[32,0.654,129,1.322]],["description/150",[3,0.811,56,0.512,67,2.049,69,0.721,81,0.793,129,1.82,151,6.608,164,1.782,202,3.038,216,2.049,221,2.411,241,3.038,245,2.628,276,3.192,277,3.192,434,4.866,435,4.866,436,3.724,546,4.866,547,6.561,619,5.398]],["title/151",[32,0.654,129,1.322]],["description/151",[3,0.882,17,0.302,20,3.648,53,0.265,56,0.656,62,0.787,69,0.925,81,0.73,129,1.515,131,1.353,134,0.459,145,2.466,164,1.641,167,0.595,204,0.897,238,3.198,243,3.567,620,3.43,621,4.16]],["title/152",[129,1.322,139,1.435]],["description/152",[3,0.907,17,0.252,51,1.186,53,0.221,56,0.726,58,2.343,62,0.352,64,2.891,67,1.464,68,2.031,69,0.77,81,0.567,125,1.695,129,1.261,131,1.05,134,0.332,137,1.526,139,2.042,140,2.17,160,3.04,166,0.288,167,0.462,168,0.294,195,1.407,204,0.696,209,1.618,217,4.315,238,1.781,369,3.477,459,3.227,621,3.227,622,3.856,623,3.856,624,3.856]],["title/153",[81,0.769,129,1.144,265,1.322]],["description/153",[3,0.879,17,0.266,53,0.233,62,0.556,69,0.814,129,1.737,134,0.351,166,0.305,167,0.73,168,0.31,209,2.556,265,1.54,621,5.098,625,6.093,626,6.093,627,6.093,628,6.093]],["title/154",[129,1.144,447,2.457,629,3.178]],["description/154",[3,0.624,17,0.246,53,0.216,62,0.515,69,0.753,81,0.828,129,1.861,131,1.535,134,0.325,166,0.282,167,0.675,168,0.287,193,4.046,209,2.366,253,2.085,361,4.227,447,2.649,593,4.046,629,3.426,630,4.046,631,4.718,632,5.639]],["title/155",[32,0.498,129,1.008,158,2.726,173,2.8]],["description/155",[3,0.882,17,0.302,20,3.648,53,0.265,56,0.656,62,0.787,69,0.925,81,0.73,129,1.515,131,1.353,134,0.459,145,2.466,164,1.641,167,0.595,204,0.897,238,3.198,243,3.567,620,3.43,633,4.972]],["title/156",[32,0.403,129,1.228,302,2.328,303,1.72,593,2.672]],["description/156",[3,0.529,6,1.592,7,2.135,17,0.209,19,2.006,24,2.267,32,0.327,51,0.93,53,0.227,56,0.453,62,0.436,67,1.148,68,1.592,69,0.639,81,0.871,84,1.35,105,1.702,115,2.726,129,1.297,134,0.388,140,4.132,145,1.5,155,0.851,159,2.905,164,0.998,166,0.297,167,0.362,168,0.244,204,0.545,220,1.89,236,3.769,240,2.905,255,2.013,282,2.53,283,1.329,302,2.988,303,2.208,350,1.837,354,2.726,436,2.086,534,1.744,593,2.169,620,2.086,634,2.53,635,3.024,636,3.024,637,3.024,638,3.024,639,3.024,640,2.726,641,3.024,642,2.384,643,2.013,644,3.024]],["title/157",[32,0.445,81,0.605,129,0.901,170,2.575,536,3.248]],["description/157",[3,0.663,17,0.262,53,0.23,81,1.155,125,3.456,129,1.311,135,3.864,149,2.594,166,0.3,167,0.718,168,0.306,170,3.748,208,2.34,209,2.516,536,6.198,645,5.406,646,5.997]],["title/158",[32,0.367,81,0.499,129,0.743,131,0.925,137,1.345,142,2.438,645,3.064]],["description/158",[3,0.643,17,0.254,53,0.223,81,0.854,125,2.554,129,1.271,131,1.582,137,2.3,142,4.17,149,2.514,158,3.438,166,0.291,167,0.696,168,0.296,208,2.268,209,2.438,340,3.87,647,3.745,648,5.812,649,5.812,650,5.812,651,5.812]],["title/159",[20,1.961,32,0.403,81,0.547,129,0.814,170,2.328,652,3.725]],["description/159",[3,0.653,17,0.258,20,3.108,53,0.226,56,0.559,81,0.867,83,3.93,107,2.44,125,2.594,129,1.291,131,1.607,137,2.336,149,2.554,166,0.295,167,0.707,168,0.301,170,3.69,209,2.476,255,3.93,653,5.903,654,5.903]],["title/160",[32,0.566,129,1.144,195,1.909]],["description/160",[3,0.733,17,0.289,53,0.254,62,0.605,69,0.885,129,1.834,134,0.382,166,0.332,167,0.794,168,0.338,195,2.418,655,5.975,656,6.627]],["title/161",[129,1.322,657,2.999]],["description/161",[83,4.057,129,1.933,373,5.494,431,4.568,630,4.372,643,4.057,657,3.942,658,6.093,659,6.093,660,7.946,661,5.098,662,6.093,663,3.437,664,5.098]],["title/162",[32,0.498,129,1.008,657,2.287,663,1.994]],["description/162",[3,0.697,17,0.275,32,0.681,53,0.241,62,0.575,69,0.841,129,1.775,134,0.363,164,2.079,166,0.315,167,0.754,168,0.321,253,2.328,657,3.123,663,2.724,665,5.676]],["title/163",[73,0.874,129,0.901,657,2.044,663,1.782,664,3.448]],["description/163",[3,0.633,17,0.25,23,3.949,53,0.219,62,0.523,69,0.765,73,1.214,81,0.841,105,3.222,129,1.875,134,0.33,136,4.291,166,0.286,167,0.686,168,0.292,209,2.402,346,3.014,657,2.84,663,2.476,664,4.79,665,5.161]],["title/164",[32,0.498,129,1.008,202,2.594,657,2.287]],["description/164",[3,0.697,17,0.275,32,0.681,53,0.241,62,0.575,69,0.841,129,1.775,134,0.363,164,2.079,166,0.315,167,0.754,168,0.321,202,3.544,253,2.328,657,3.123,666,6.296]],["title/165",[290,3.486,667,4.766]],["description/165",[140,4.338,290,5.306,292,5.131,667,7.254]],["title/166",[129,1.144,290,3.016,667,4.124]],["description/166",[3,0.793,17,0.264,51,1.264,52,3.437,53,0.231,56,0.679,62,0.375,67,1.56,68,2.163,69,0.807,81,0.604,129,1.567,131,1.118,134,0.348,140,2.312,166,0.302,167,0.492,168,0.308,193,4.334,195,1.499,204,0.741,209,1.723,238,1.897,253,1.519,290,4.132,543,3.703,593,2.947,631,3.437,667,4.763,668,4.108,669,4.108,670,4.108,671,4.108]],["title/167",[303,2.792,672,4.766]],["description/167",[140,4.338,292,5.131,303,4.249,672,6.076,673,7.708]],["title/168",[129,1.144,303,2.415,672,4.124]],["description/168",[3,0.764,17,0.252,33,2.767,51,1.186,53,0.221,56,0.654,62,0.352,67,1.464,68,2.031,69,0.77,73,0.818,81,0.567,122,1.548,129,1.675,131,1.05,134,0.332,140,2.17,155,1.085,166,0.288,167,0.462,168,0.294,189,1.781,193,2.767,195,1.407,204,0.696,209,1.618,255,2.567,259,2.767,262,5.198,303,1.781,360,3.477,479,3.477,593,2.767,631,3.227,672,3.04,674,2.485,675,3.856,676,3.856,677,3.856,678,3.856,679,3.856]],["title/169",[189,2.792,674,3.895]],["description/169",[53,0.268,129,1.897,189,3.23,213,5.018,223,5.244,255,4.657,259,5.018,674,5.589,680,6.995]],["title/170",[32,0.498,129,1.008,189,2.128,674,2.97]],["description/170",[3,0.87,17,0.297,51,1.49,53,0.261,56,0.745,62,0.442,67,1.839,68,2.551,69,0.909,81,0.712,129,1.487,134,0.392,140,2.727,166,0.34,167,0.58,168,0.347,189,2.237,195,1.768,204,0.874,209,2.032,234,2.727,253,1.791,674,3.121,681,4.368]],["title/171",[73,0.874,129,0.901,139,0.978,189,1.902,674,2.655]],["description/171",[3,0.858,17,0.292,51,1.453,53,0.256,56,0.735,62,0.431,67,1.794,68,2.487,69,0.893,81,0.694,129,1.461,134,0.385,139,1.121,140,2.658,166,0.334,167,0.566,168,0.34,189,2.181,195,1.723,204,0.852,209,1.982,223,3.541,253,1.746,674,3.043,681,4.258,682,3.952]],["title/172",[129,1.008,189,2.128,265,1.165,674,2.97]],["description/172",[3,0.864,17,0.294,51,1.472,53,0.258,56,0.74,62,0.437,67,1.816,68,2.519,69,0.901,81,0.703,129,1.474,134,0.388,140,2.692,166,0.337,167,0.573,168,0.344,177,2.906,189,2.209,195,1.745,204,0.863,209,2.007,223,3.586,253,1.768,674,3.082,683,4.783]],["title/173",[129,1.322,195,2.206]],["description/173",[11,2.83,86,4.491,129,2.128,131,1.836,137,2.67,195,3.384,208,2.633,268,4.653]],["title/174",[452,2.393]],["description/174",[80,3.286,81,1.028,129,1.529,259,5.018,267,6.503,428,5.514,452,2.899,618,6.306,684,6.995]],["title/175",[32,0.654,452,2.02]],["description/175",[3,0.746,17,0.294,53,0.258,62,0.616,69,0.901,81,0.991,125,2.964,134,0.389,166,0.337,167,0.808,168,0.344,452,2.254,685,6.745]],["title/176",[32,0.654,452,2.02]],["description/176",[3,0.76,17,0.3,53,0.263,62,0.627,69,0.917,134,0.396,155,1.932,166,0.344,167,0.822,168,0.35,452,2.295,686,6.868]],["title/177",[452,2.02,657,2.999]],["description/177",[3,0.47,17,0.185,19,1.781,20,2.236,53,0.163,62,0.388,69,0.567,81,0.624,125,1.866,134,0.245,135,2.736,149,1.837,166,0.212,167,0.508,168,0.216,189,1.961,253,1.57,346,3.259,424,1.78,452,2.441,507,4.566,568,3.404,643,2.827,647,2.736,657,3.071,687,4.88,688,4.88,689,3.553,690,3.553,691,4.246,692,3.347,693,3.347,694,3.347,695,3.347,696,3.347,697,4.246]],["title/178",[452,2.02,657,2.999]],["description/178",[3,0.536,17,0.211,19,2.032,20,2.551,53,0.186,62,0.442,69,0.647,134,0.279,149,2.096,166,0.242,167,0.58,168,0.247,189,2.237,346,3.582,424,1.956,507,4.914,643,3.225,647,3.121,657,2.403,687,5.362,688,5.362,692,3.819,693,3.819,694,3.819,695,3.819,696,3.819,698,6.802,699,4.844]],["title/179",[447,2.457,452,1.748,629,3.178]],["description/179",[3,0.606,17,0.239,53,0.21,62,0.5,69,0.731,81,0.805,116,3.422,125,2.406,134,0.315,166,0.274,167,0.656,168,0.279,241,3.082,331,2.883,346,2.883,447,3.477,452,2.473,568,4.071,629,3.326,700,4.317,701,4.317,702,4.317,703,5.476]],["title/180",[447,2.457,452,1.748,629,3.178]],["description/180",[3,0.643,17,0.254,53,0.223,62,0.531,69,0.776,116,3.633,134,0.335,166,0.291,167,0.696,168,0.296,244,3.438,346,3.061,425,3.351,447,3.619,452,2.574,629,3.531,700,4.582,701,4.582,702,4.582,704,5.812]],["title/181",[139,1.242,452,1.748,705,2.754]],["description/181",[3,0.653,17,0.258,53,0.226,62,0.539,69,0.789,81,0.867,125,2.594,134,0.34,135,3.803,139,1.401,166,0.295,167,0.707,168,0.301,241,3.322,331,3.108,452,2.6,568,4.28,705,3.108,706,5.903]],["title/182",[139,1.242,452,1.748,705,2.754]],["description/182",[3,0.708,17,0.279,53,0.245,62,0.585,69,0.855,134,0.369,139,1.52,166,0.32,167,0.767,168,0.326,244,3.787,425,3.692,452,2.741,705,3.372,707,6.403]],["title/183",[452,1.748,708,4.124,709,4.124]],["description/183",[3,0.653,17,0.258,53,0.226,62,0.539,69,0.789,81,0.867,125,2.594,134,0.34,135,3.803,166,0.295,167,0.707,168,0.301,241,3.322,331,3.108,452,2.6,568,4.28,708,4.653,709,4.653,710,5.903]],["title/184",[452,1.748,708,4.124,709,4.124]],["description/184",[3,0.708,17,0.279,53,0.245,62,0.585,69,0.855,134,0.369,166,0.32,167,0.767,168,0.326,244,3.787,425,3.692,452,2.741,708,5.047,709,5.047,711,6.403]],["title/185",[32,0.566,452,1.748,712,2.263]],["description/185",[3,0.348,17,0.137,48,2.656,53,0.121,62,0.288,69,0.421,81,0.463,83,3.287,108,2.483,125,1.384,134,0.181,164,1.04,166,0.158,167,0.377,168,0.16,188,2.483,189,3.183,202,2.779,220,1.969,221,1.407,222,2.029,239,1.969,240,1.913,245,2.965,255,3.287,331,1.659,340,2.097,346,1.659,350,2.999,352,2.029,356,2.26,357,2.26,358,2.26,436,2.173,452,1.65,504,2.26,568,1.732,584,2.361,642,2.483,663,1.363,712,2.982,713,1.773,714,2.26,715,2.84,716,2.636,717,2.636,718,2.483,719,2.636,720,2.361,721,2.361,722,2.84,723,2.84,724,2.636,725,2.84,726,2.84,727,2.84,728,2.84,729,2.84,730,2.84,731,2.84,732,2.636,733,2.84,734,3.15]],["title/186",[735,3.487]],["description/186",[452,2.629,471,6.202,497,6.202,507,4.918,735,3.831]],["title/187",[32,0.654,735,2.944]],["description/187",[3,0.465,7,3.566,17,0.183,24,3.148,53,0.161,62,0.383,69,0.561,81,0.617,125,2.698,134,0.242,137,1.662,162,2.551,166,0.21,167,0.503,168,0.214,276,2.483,279,3.303,331,2.211,376,2.897,436,2.897,452,1.403,468,4.405,507,2.624,568,2.309,647,2.705,714,3.012,735,2.989,736,5.137,737,3.513,738,3.513,739,3.513,740,3.513,741,4.199,742,3.513,743,3.513,744,3.513,745,4.199,746,4.199,747,4.199]],["title/188",[32,0.654,735,2.944]],["description/188",[3,0.76,17,0.3,53,0.263,62,0.627,69,0.917,134,0.396,155,1.932,166,0.344,167,0.822,168,0.35,735,3.344,748,6.868]],["title/189",[657,2.999,735,2.944]],["description/189",[3,0.459,11,1.742,17,0.181,19,1.742,20,2.187,53,0.159,62,0.379,69,0.555,81,0.61,125,1.825,134,0.239,149,1.796,166,0.208,167,0.497,168,0.212,189,1.918,217,2.596,253,1.535,346,3.207,424,1.751,452,1.388,507,4.507,568,3.349,643,2.765,647,2.676,657,3.021,687,4.801,688,4.801,690,3.475,692,3.274,693,3.274,694,3.274,695,3.274,696,3.274,735,3.511,749,4.153,750,4.153,751,4.153]],["title/190",[657,2.999,735,2.944]],["description/190",[3,0.55,17,0.217,19,2.086,20,2.618,53,0.19,62,0.454,69,0.664,134,0.286,149,2.151,166,0.249,167,0.595,168,0.253,189,2.296,346,3.648,424,1.992,507,4.329,643,3.31,647,3.203,657,2.466,687,5.46,688,5.46,692,3.919,693,3.919,694,3.919,695,3.919,696,3.919,735,2.421,752,4.972]],["title/191",[447,2.457,629,3.178,735,2.547]],["description/191",[3,0.47,7,3.262,17,0.185,53,0.163,62,0.388,69,0.567,81,0.624,116,2.654,125,2.72,134,0.245,137,1.681,166,0.212,167,0.508,168,0.216,241,2.39,279,2.284,331,3.259,346,2.236,376,2.929,447,2.908,468,3.046,568,4.017,629,2.579,647,2.736,700,3.347,701,3.347,702,3.347,735,3.014,736,3.553,737,3.553,738,3.553,739,3.553,740,3.553,742,3.553,743,3.553,744,3.553,753,3.828,754,4.246]],["title/192",[447,2.457,629,3.178,735,2.547]],["description/192",[3,0.643,17,0.254,53,0.223,62,0.531,69,0.776,116,3.633,134,0.335,166,0.291,167,0.696,168,0.296,244,3.438,346,3.061,425,3.351,447,3.619,629,3.531,700,4.582,701,4.582,702,4.582,735,3.751,755,5.812]],["title/193",[139,1.242,705,2.754,735,2.547]],["description/193",[3,0.504,7,3.393,17,0.199,53,0.174,62,0.416,69,0.608,81,0.669,125,2.861,134,0.262,137,1.802,139,1.081,166,0.228,167,0.545,168,0.232,241,2.562,279,2.449,331,3.428,376,3.141,468,3.266,568,4.179,647,2.933,705,2.397,735,3.17,736,3.809,737,3.809,738,3.809,739,3.809,740,3.809,742,3.809,743,3.809,744,3.809,753,4.105,756,4.553]],["title/194",[139,1.242,705,2.754,735,2.547]],["description/194",[3,0.708,17,0.279,53,0.245,62,0.585,69,0.855,134,0.369,139,1.52,166,0.32,167,0.767,168,0.326,244,3.787,425,3.692,705,3.372,735,3.995,757,6.403]],["title/195",[32,0.566,712,2.263,735,2.547]],["description/195",[3,0.348,17,0.137,48,2.656,53,0.121,62,0.288,69,0.421,81,0.463,83,3.287,108,2.483,125,1.384,134,0.181,164,1.04,166,0.158,167,0.377,168,0.16,188,2.483,189,3.183,202,2.779,220,1.969,221,1.407,222,2.029,239,1.969,240,1.913,245,2.965,255,3.287,331,1.659,340,2.097,346,1.659,350,2.999,352,2.029,356,2.26,357,2.26,358,2.26,436,2.173,504,2.26,568,1.732,584,2.361,642,2.483,663,1.363,712,2.982,713,1.773,714,2.26,715,2.84,716,2.636,717,2.636,718,2.483,719,2.636,720,2.361,721,2.361,722,2.84,723,2.84,724,2.636,725,2.84,726,2.84,727,2.84,728,2.84,729,2.84,730,2.84,731,2.84,732,2.636,733,2.84,735,2.404,758,3.15]],["title/196",[712,3.098]],["description/196",[32,0.524,42,3.121,48,2.606,73,1.027,77,2.403,122,2.731,139,1.15,154,4.053,155,1.363,333,4.368,346,2.551,447,2.276,452,2.849,497,3.819,507,3.028,643,3.225,663,2.096,705,2.551,712,3.688,713,2.727,735,3.828,759,4.844,760,5.099,761,3.476,762,4.844]],["title/197",[32,0.654,712,2.615]],["description/197",[3,0.589,17,0.232,38,3.989,39,3.989,53,0.204,58,3.233,62,0.486,69,0.711,73,1.129,81,0.782,134,0.307,166,0.266,167,0.637,168,0.271,221,2.377,244,3.147,327,3.326,584,3.989,712,3.574,713,2.995,763,4.798,764,4.798,765,5.322,766,4.798,767,4.195,768,5.322]],["title/198",[712,2.615,761,4.337]],["description/198",[3,0.418,17,0.165,38,2.833,39,2.833,42,2.435,53,0.145,58,3.45,62,0.345,69,0.505,73,0.801,81,0.555,134,0.218,149,1.635,166,0.189,167,0.453,168,0.193,221,1.688,304,2.979,306,2.833,327,2.362,346,1.99,584,2.833,640,3.407,642,2.979,663,1.635,712,3.832,713,2.127,717,3.162,718,2.979,719,3.162,761,5.441,763,3.407,764,3.407,766,3.407,767,2.979,769,3.779,770,3.407,771,3.407,772,3.779,773,5.679,774,3.779,775,3.779,776,3.162,777,3.779,778,3.779,779,3.779]],["title/199",[780,4.235]],["description/199",[7,3.624,81,0.638,86,2.892,96,2.799,122,2.526,154,3.634,164,1.434,196,2.996,198,3.424,245,2.115,265,1.097,322,3.634,349,3.634,352,2.799,361,3.256,507,2.715,557,2.892,630,4.515,634,3.634,643,2.892,732,5.265,760,3.256,780,3.722,781,3.916,782,4.344,783,4.344,784,4.344,785,4.344,786,4.344,787,4.344,788,4.344,789,4.344,790,4.344,791,4.344,792,3.424,793,4.344,794,4.344]],["title/200",[73,1.109,122,2.1,780,3.094]],["description/200",[3,0.486,10,3.962,17,0.192,42,2.831,53,0.168,54,3.677,62,0.401,69,0.587,73,0.932,81,0.646,96,2.831,122,1.764,134,0.253,142,3.152,155,1.236,166,0.22,167,0.526,168,0.224,196,3.031,238,2.029,239,2.746,327,2.746,331,2.314,346,2.314,350,2.669,560,3.677,657,3.695,713,2.473,780,4.405,795,3.677,796,3.464,797,4.394,798,4.394,799,3.677,800,3.677,801,3.962,802,3.962,803,3.962,804,3.962]],["title/201",[48,2.814,122,2.1,780,3.094]],["description/201",[3,0.597,17,0.235,48,2.903,53,0.207,62,0.493,69,0.721,81,0.793,122,2.167,134,0.311,166,0.27,167,0.646,168,0.275,189,2.492,202,3.038,245,2.628,340,3.593,350,3.279,352,3.478,356,3.872,357,3.872,358,3.872,568,2.968,714,3.872,720,4.046,721,4.046,780,3.192,804,4.866]],["title/202",[32,0.566,122,2.1,780,3.094]],["description/202",[3,0.674,17,0.266,53,0.233,62,0.556,69,0.814,81,0.895,122,2.446,134,0.351,164,2.012,166,0.305,167,0.73,168,0.31,221,2.721,244,3.604,713,3.429,780,5.229,805,5.098]],["title/203",[122,2.1,139,1.242,780,3.094]],["description/203",[3,0.486,7,1.962,17,0.192,42,2.831,53,0.168,62,0.401,69,0.587,73,0.932,122,1.764,134,0.253,135,2.831,166,0.22,167,0.526,168,0.224,198,3.464,240,3.855,257,2.417,265,1.11,327,2.746,478,3.962,505,3.962,560,3.677,657,2.18,780,4.824,795,3.677,796,3.464,799,3.677,800,3.677,805,3.677,806,3.677,807,4.394,808,4.394,809,4.394,810,4.394,811,4.394,812,4.394,813,4.394,814,3.962,815,4.394]],["title/204",[122,2.1,265,1.322,780,3.094]],["description/204",[3,0.529,7,2.136,9,3.586,17,0.209,53,0.183,62,0.437,69,0.639,81,0.703,96,3.082,122,1.92,134,0.276,145,2.373,164,1.579,166,0.239,167,0.573,168,0.244,221,2.136,222,3.082,244,2.829,260,3.432,265,1.703,452,1.598,620,3.3,713,2.692,716,4.002,780,5.014,799,4.002,800,4.002,801,4.312,805,4.002,816,4.783,817,4.783]],["title/205",[663,2.615,712,2.615]],["description/205",[7,2.72,11,1.321,20,1.659,32,0.341,46,1.106,48,1.694,83,4.054,122,1.982,162,1.913,196,2.173,241,1.773,245,1.534,257,3.349,305,2.636,331,3.206,361,2.361,452,2.303,588,2.361,630,4.369,634,2.636,663,2.634,689,2.636,705,1.659,712,3.239,760,3.701,761,2.26,796,2.483,814,2.84,818,4.946,819,2.84,820,2.84,821,2.636,822,2.84,823,2.84,824,4.937,825,3.15,826,3.15,827,4.131,828,3.406,829,3.15,830,3.15,831,3.15,832,3.892,833,2.483,834,3.15,835,2.84,836,2.84,837,3.15,838,2.84]],["title/206",[73,1.109,663,2.263,712,2.263]],["description/206",[1,2.751,3,0.406,17,0.16,19,1.539,42,2.364,46,1.288,53,0.141,62,0.335,69,0.49,73,0.778,96,2.364,122,2.229,134,0.211,142,2.632,155,1.032,166,0.184,167,0.439,168,0.187,188,2.893,241,3.126,245,1.787,256,3.308,257,3.054,334,3.308,346,2.924,350,2.229,352,2.364,452,1.856,630,3.984,657,2.755,663,2.899,689,3.07,705,1.932,712,2.899,718,2.893,795,3.07,796,2.893,802,3.308,818,3.984,819,3.308,820,3.308,821,3.07,822,3.308,823,3.308,839,3.669,840,3.669,841,3.669,842,3.308]],["title/207",[32,0.566,663,2.263,712,2.263]],["description/207",[3,0.597,17,0.235,48,2.903,53,0.207,62,0.493,69,0.721,81,0.793,134,0.311,166,0.27,167,0.646,168,0.275,189,2.492,202,3.038,245,2.628,340,3.593,350,3.279,352,3.478,356,3.872,357,3.872,358,3.872,568,2.968,663,2.335,712,2.335,714,3.872,720,4.046,721,4.046,842,4.866]],["title/208",[32,0.566,663,2.263,712,2.263]],["description/208",[3,0.565,17,0.223,46,1.793,53,0.196,62,0.466,69,0.682,81,0.75,134,0.294,164,1.686,166,0.255,167,0.611,168,0.26,221,2.28,244,3.02,245,2.486,340,3.399,498,3.663,663,3.773,712,3.498,713,2.874,818,3.663,843,5.106,844,5.106,845,5.106,846,5.106,847,5.106]],["title/209",[32,0.498,331,2.427,663,1.994,712,1.994]],["description/209",[3,0.418,17,0.165,20,1.99,48,2.033,53,0.145,62,0.345,69,0.505,81,0.555,83,2.516,134,0.218,162,3.45,164,1.248,166,0.189,167,0.453,168,0.193,189,1.745,202,2.127,221,1.688,245,1.84,331,3.592,340,2.516,350,2.296,352,2.435,356,2.711,357,2.711,358,2.711,399,2.833,446,3.407,452,1.263,493,2.833,568,2.078,588,2.833,630,4.074,663,2.951,712,3.517,713,2.127,714,2.711,720,2.833,721,2.833,803,5.12,835,3.407,836,3.407,838,3.407,848,3.779,849,3.779,850,3.779]],["title/210",[663,2.263,712,2.263,828,3.609]],["description/210",[3,0.51,17,0.201,53,0.177,62,0.421,69,0.616,81,0.677,134,0.265,164,1.521,166,0.231,167,0.552,168,0.235,221,2.058,327,2.88,331,3.458,337,3.633,338,3.633,587,3.856,588,3.455,663,3.963,712,3.963,713,2.594,771,4.155,828,4.53,833,3.633,851,4.155,852,4.608,853,4.608]],["title/211",[663,2.263,712,2.263,833,4.124]],["description/211",[3,0.529,17,0.209,53,0.183,62,0.437,69,0.639,77,2.373,81,0.703,122,2.706,134,0.276,164,1.579,166,0.239,167,0.573,168,0.244,221,2.136,274,3.184,663,3.667,712,3.667,713,2.692,818,3.432,827,4.002,828,4.651,832,5.314,833,5.314,854,4.783,855,4.783,856,4.783]],["title/212",[29,3.248,663,1.782,712,1.782,818,2.956,832,3.248]],["description/212",[3,0.486,17,0.192,29,3.464,53,0.168,62,0.401,69,0.587,81,0.646,96,2.831,120,3.677,134,0.253,164,1.451,166,0.22,167,0.526,168,0.224,221,1.962,241,2.473,242,2.669,245,2.14,260,3.152,663,3.222,712,3.222,713,2.473,767,3.464,818,5.852,827,3.677,828,3.031,832,3.464,857,7.449,858,4.394,859,4.394,860,4.394,861,4.394,862,4.394,863,4.394]],["title/213",[663,2.263,712,2.263,761,3.753]],["description/213",[1,3.413,3,0.504,17,0.199,46,1.599,53,0.174,62,0.416,69,0.608,81,0.669,134,0.262,149,1.97,164,1.503,166,0.228,167,0.545,168,0.232,221,2.033,331,3.428,337,3.589,346,2.397,363,4.105,663,3.587,712,3.795,713,2.562,761,5.451,770,4.105,851,4.105,864,4.553,865,4.553,866,4.553,867,4.105,868,4.553]],["title/214",[84,2.336,208,2.041,869,3.094]],["description/214",[7,2.22,11,2.086,20,2.618,21,3.31,44,3.994,84,3.094,96,3.203,131,1.353,173,3.02,175,3.567,177,3.02,180,3.31,181,3.43,182,3.31,208,2.703,217,3.107,274,3.31,377,3.919,378,3.919,411,3.727,561,4.16,629,3.02,792,3.919,869,4.715,870,4.972,871,4.972,872,6.927]],["title/215",[32,0.498,84,2.059,208,1.799,869,2.726]],["description/215",[17,0.294,53,0.258,56,0.804,62,0.616,84,3.013,134,0.389,166,0.337,168,0.344,204,1.217,208,2.633,869,3.989,873,6.081]],["title/216",[73,0.978,84,2.059,208,1.799,869,2.726]],["description/216",[17,0.289,53,0.254,56,0.795,62,0.605,73,1.405,84,2.96,134,0.382,166,0.332,168,0.338,204,1.195,208,2.586,869,3.919,873,5.975]],["title/217",[32,0.498,84,2.059,208,1.799,869,2.726]],["description/217",[17,0.279,53,0.245,56,0.778,62,0.585,84,2.86,131,1.743,134,0.369,155,1.801,166,0.32,168,0.326,204,1.155,208,2.499,209,2.686,869,3.787,874,5.357]],["title/218",[84,2.059,139,1.094,208,1.799,869,2.726]],["description/218",[17,0.235,53,0.207,56,0.695,62,0.493,73,1.145,84,2.411,125,2.372,131,1.469,134,0.311,139,1.74,155,1.518,166,0.27,168,0.275,204,0.974,208,2.861,209,2.264,245,2.628,338,4.255,792,5.778,869,3.192,874,4.516,875,5.398,876,5.398]],["title/219",[84,2.059,208,1.799,265,1.165,869,2.726]],["description/219",[17,0.246,53,0.216,56,0.715,62,0.515,84,3.372,131,1.535,134,0.325,145,2.797,155,1.586,166,0.282,168,0.287,204,1.017,208,2.946,209,2.366,265,2.15,792,4.445,869,4.465,874,4.718]],["title/220",[79,2.944,80,2.84]],["description/220",[3,0.827,11,3.136,56,0.527,79,4.113,80,3.968,81,0.816,84,2.481,85,5.009,86,3.699,107,2.296,109,3.856,110,4.649,341,4.649,368,4.649,374,3.986,573,5.009,781,5.009,877,5.556]],["title/221",[32,0.566,79,2.547,80,2.457]],["description/221",[6,3.209,17,0.266,28,3.513,32,0.659,53,0.233,79,2.967,80,2.862,134,0.351,166,0.305,167,0.73,168,0.31,204,1.099,237,4.204,263,4.204,276,3.604,277,3.604,279,3.278,280,5.494,878,5.494]],["title/222",[73,1.109,79,2.547,80,2.457]],["description/222",[3,0.643,17,0.254,53,0.223,56,0.551,69,0.776,73,1.832,79,4.207,80,4.059,107,2.402,134,0.335,162,3.531,166,0.291,167,0.696,168,0.296,295,4.582,878,5.24]],["title/223",[32,0.566,79,2.547,80,2.457]],["description/223",[17,0.305,32,0.756,53,0.268,79,3.406,80,3.286,155,1.967,166,0.35,167,0.838,168,0.356,204,1.262,879,5.853]],["title/224",[79,2.547,80,2.457,265,1.322]],["description/224",[3,0.615,17,0.242,53,0.213,56,0.527,62,0.507,69,0.742,79,4.113,80,3.968,107,3.089,134,0.32,145,2.756,162,3.375,165,3.473,166,0.278,167,0.665,168,0.283,265,1.889,295,4.38,879,4.649]],["title/225",[79,2.547,80,2.457,139,1.242]],["description/225",[3,0.811,17,0.235,53,0.207,56,0.512,69,0.721,73,1.145,79,4.347,80,4.194,107,2.231,125,2.372,134,0.311,139,1.281,162,3.279,165,3.374,167,0.646,198,4.255,238,2.492,295,4.255,307,2.678,879,4.516]],["title/226",[32,0.498,79,2.244,80,2.165,498,3.307]],["description/226",[3,0.753,17,0.211,32,0.524,53,0.186,56,0.645,69,0.647,73,1.443,79,4.151,80,4.218,107,2.811,134,0.279,145,2.403,166,0.242,167,0.58,168,0.247,202,2.727,209,2.032,253,1.791,880,4.844,881,6.802,882,4.368,883,2.943,884,4.844]],["title/227",[50,2.457,303,2.415,885,2.814]],["description/227",[46,2.248,50,4.253,53,0.245,116,4.002,131,1.743,137,2.534,292,4.263,303,3.788,663,2.77,885,3.444,886,6.403,887,6.403,888,6.403]],["title/228",[32,0.498,50,2.165,303,2.128,885,2.48]],["description/228",[17,0.284,32,0.704,46,2.287,50,3.06,53,0.25,56,0.786,62,0.595,134,0.375,166,0.326,168,0.332,204,1.175,303,3.007,885,3.503,889,5.872]],["title/229",[50,2.165,73,0.978,303,2.128,885,2.48]],["description/229",[17,0.284,46,2.287,50,3.06,53,0.25,56,0.786,62,0.595,73,1.381,134,0.375,166,0.326,168,0.332,204,1.175,303,3.007,885,3.503,889,5.872]],["title/230",[32,0.498,50,2.165,303,2.128,885,2.48]],["description/230",[17,0.254,32,0.628,46,2.705,50,3.619,53,0.223,56,0.819,62,0.531,134,0.335,155,1.635,164,1.919,166,0.291,168,0.296,204,1.048,303,3.557,885,4.144,890,4.863]],["title/231",[50,2.165,265,1.165,303,2.128,885,2.48]],["description/231",[17,0.229,28,4.146,46,1.843,50,3.853,53,0.201,56,0.681,62,0.479,103,4.137,134,0.302,155,1.476,164,1.732,166,0.263,168,0.267,204,0.947,253,1.94,265,1.817,303,3.787,620,3.62,885,4.412,890,4.391]],["title/232",[50,2.165,139,1.094,303,2.128,885,2.48]],["description/232",[17,0.239,28,3.157,46,1.923,50,3.477,53,0.21,56,0.701,62,0.5,73,1.161,128,4.937,134,0.315,139,1.3,164,1.808,166,0.274,168,0.279,204,0.988,253,2.024,288,4.582,291,2.716,303,3.417,327,3.422,885,3.981,890,4.582]],["title/233",[28,2.376,32,0.445,50,1.936,303,1.902,885,2.216]],["description/233",[17,0.254,20,3.061,28,3.351,32,0.628,46,2.041,50,3.619,53,0.223,56,0.73,62,0.531,134,0.335,164,1.919,166,0.291,168,0.296,204,1.048,253,2.149,303,3.557,885,4.144,891,5.24]],["title/234",[28,2.376,50,1.936,265,1.041,303,1.902,885,2.216]],["description/234",[17,0.239,28,4.268,31,4.582,46,1.923,50,3.477,53,0.21,56,0.701,62,0.5,103,4.317,134,0.315,164,1.808,166,0.274,168,0.279,204,0.988,253,2.024,265,1.87,303,3.417,620,3.777,885,3.981,891,4.937]],["title/235",[208,2.041,460,2.07,599,2.375]],["description/235",[11,2.686,81,0.941,131,1.743,159,3.89,208,3.202,292,4.263,427,4.8,460,3.247,599,3.725,724,5.357,892,5.773,893,6.403,894,5.773]],["title/236",[32,0.498,208,1.799,460,1.824,599,2.093]],["description/236",[17,0.284,32,0.704,46,2.287,53,0.25,56,0.786,62,0.595,134,0.375,166,0.326,168,0.332,204,1.175,208,2.542,460,2.578,599,2.957,895,5.872]],["title/237",[73,0.978,208,1.799,460,1.824,599,2.093]],["description/237",[17,0.284,46,2.287,53,0.25,56,0.786,62,0.595,73,1.381,134,0.375,166,0.326,168,0.332,204,1.175,208,2.542,460,2.578,599,2.957,895,5.872]],["title/238",[32,0.498,208,1.799,460,1.824,599,2.093]],["description/238",[17,0.254,32,0.628,46,2.705,53,0.223,56,0.819,62,0.531,134,0.335,155,1.635,164,1.919,166,0.291,168,0.296,204,1.048,208,3.006,460,3.049,599,3.497,896,4.863]],["title/239",[208,1.799,265,1.165,460,1.824,599,2.093]],["description/239",[17,0.246,46,1.98,53,0.216,56,0.715,62,0.515,81,0.828,134,0.325,145,2.797,164,1.862,166,0.282,168,0.287,204,1.017,208,2.946,253,2.085,265,1.425,460,2.988,599,3.428,896,4.718,897,4.445,898,4.718]],["title/240",[139,1.094,208,1.799,460,1.824,599,2.093]],["description/240",[17,0.239,31,4.582,46,1.923,53,0.21,56,0.701,62,0.5,81,0.805,134,0.315,139,1.3,164,1.808,166,0.274,168,0.279,177,3.326,204,0.988,208,2.889,253,2.024,460,2.929,599,3.36,896,4.582,897,4.317,898,4.582,899,5.476]],["title/241",[460,2.393,599,2.745]],["description/241",[11,3.047,131,1.977,159,4.413,427,5.445,460,3.514,599,3.298,894,6.549,900,5.726]],["title/242",[32,0.566,460,2.07,599,2.375]],["description/242",[17,0.289,32,0.716,46,2.327,53,0.254,56,0.795,62,0.605,134,0.382,166,0.332,168,0.338,204,1.195,460,2.623,599,3.009,901,5.975]],["title/243",[73,1.109,460,2.07,599,2.375]],["description/243",[17,0.246,46,1.98,53,0.216,56,0.715,62,0.515,73,1.196,81,0.828,125,2.478,134,0.325,145,2.797,166,0.282,168,0.287,204,1.017,208,2.946,460,3.368,599,3.864,897,4.445,901,5.084]],["title/244",[32,0.566,460,2.07,599,2.375]],["description/244",[17,0.262,32,0.648,46,2.761,53,0.23,56,0.831,62,0.547,134,0.345,155,1.687,164,1.98,166,0.3,168,0.306,204,1.082,460,3.112,599,3.57,902,5.018]],["title/245",[265,1.322,460,2.07,599,2.375]],["description/245",[17,0.226,46,2.501,53,0.198,56,0.772,57,4.666,62,0.473,81,0.76,134,0.298,145,2.568,155,1.456,164,1.709,166,0.259,168,0.264,204,0.934,208,2.02,265,1.308,460,3.472,599,3.983,897,4.08,898,4.331,902,4.331]],["title/246",[139,1.242,460,2.07,599,2.375]],["description/246",[11,1.957,17,0.204,21,3.106,46,2.326,53,0.179,56,0.73,62,0.426,77,2.314,97,3.903,134,0.269,139,1.572,155,1.312,164,1.54,166,0.233,168,0.238,177,2.834,204,0.841,208,3.006,460,3.64,599,4.176,682,3.903,902,3.903]],["title/247",[53,0.274]],["description/247",[15,5.838,53,0.284,62,0.676,122,2.973,425,4.27,529,4.168,882,6.677,903,7.406]],["title/248",[32,0.566,46,1.837,53,0.2]],["description/248",[20,4.143,32,0.851,46,2.763,53,0.301,904,7.868]],["title/249",[905,5.138]],["description/249",[6,4.059,53,0.295,361,5.778,504,5.53,905,5.53,906,7.708]],["title/250",[32,0.498,218,2.97,905,3.307,907,3.634]],["description/250",[17,0.311,53,0.273,166,0.357,167,0.853,168,0.363,204,1.285,218,4.592,905,5.113,907,5.618,908,7.127]],["title/251",[32,0.498,218,2.97,905,3.307,907,3.634]],["description/251",[17,0.294,32,0.729,53,0.258,155,1.897,166,0.337,167,0.808,168,0.344,204,1.217,218,4.346,253,2.494,905,4.839,907,5.317,909,6.745]],["title/252",[34,4.768]],["description/252",[6,3.978,34,5.029,50,3.549,97,6.321,217,4.721,341,6.321,910,7.554]],["title/253",[6,2.427,32,0.498,34,3.069,518,3.456]],["description/253",[3,0.819,6,3.9,32,0.801,34,4.93,123,3.674,213,5.313,518,5.552,911,7.406]],["title/254",[302,3.269,705,2.754,912,3.753]],["description/254",[3,0.627,9,2.115,11,1.898,17,0.123,19,1.898,28,2.608,53,0.108,69,0.377,73,1.201,81,0.665,86,1.878,105,2.546,134,0.162,137,1.116,139,1.344,149,1.957,162,2.748,166,0.141,167,0.338,168,0.144,177,1.714,209,1.183,216,1.718,218,2.915,222,1.817,232,1.588,250,2.36,258,2.543,265,0.713,268,1.946,286,2.36,302,3.54,306,2.115,327,1.763,349,3.785,456,2.36,460,1.79,507,2.828,577,2.543,682,2.36,705,3.735,867,2.543,883,1.714,892,2.543,912,3.246,913,2.821,914,2.821,915,5.106,916,5.106,917,3.391,918,4.524,919,2.821,920,2.36,921,2.36,922,2.36,923,2.224,924,2.821,925,2.821,926,2.821,927,2.821]],["title/255",[73,0.874,139,0.978,302,2.575,705,2.17,912,2.956]],["description/255",[17,0.262,53,0.23,73,1.272,81,0.881,125,2.635,134,0.345,139,1.423,166,0.3,167,0.718,168,0.306,221,2.678,238,2.769,239,3.748,302,3.748,331,3.158,705,3.158,883,3.643,912,4.302,928,4.137,929,5.406]],["title/256",[265,1.165,302,2.881,705,2.427,912,3.307]],["description/256",[17,0.25,19,2.402,53,0.219,81,0.841,125,2.516,134,0.33,166,0.286,167,0.686,168,0.292,221,2.557,238,2.643,239,3.578,265,1.446,302,3.578,331,3.014,460,2.266,705,3.014,883,3.477,912,4.107,915,5.161,916,5.161,928,3.949,929,5.161]],["title/257",[56,0.573,455,3.576]],["description/257",[6,1.573,7,2.115,11,1.253,12,2.5,13,1.438,14,1.989,17,0.075,19,1.253,23,1.186,33,1.233,40,1.438,42,1.107,56,0.508,68,2.087,77,2.349,81,0.582,105,0.967,107,0.71,134,0.228,149,1.714,159,1.044,165,1.074,166,0.086,168,0.088,172,2.355,190,2.355,204,0.31,216,0.653,217,1.074,219,1.288,220,1.074,239,1.074,240,1.815,241,0.967,242,1.044,245,1.455,253,0.635,255,1.144,265,0.755,279,1.607,286,1.438,291,0.853,321,1.144,337,1.355,362,1.355,374,1.233,412,2.5,430,2.061,455,2.343,458,1.438,460,2.502,493,1.288,587,1.438,588,1.288,600,1.549,657,0.853,661,3.962,776,2.5,821,1.438,828,2.061,883,1.044,900,3.733,917,2.97,928,1.186,930,2.143,931,3.572,932,1.355,933,1.438,934,3.397,935,1.355,936,1.355,937,2.987,938,3.848,939,2.97,940,1.549,941,1.718,942,1.718,943,1.549,944,1.718,945,2.987,946,1.718,947,1.718,948,1.549,949,2.693,950,2.693,951,1.438,952,2.987,953,1.718,954,1.718,955,1.718,956,1.438,957,1.549,958,1.549,959,1.718,960,1.718,961,1.718,962,1.549,963,1.549,964,1.355,965,1.549,966,1.288,967,1.549,968,1.718,969,1.718,970,1.718,971,1.549,972,1.549,973,1.549,974,1.288,975,1.718,976,1.718]],["title/258",[19,1.729,56,0.39,73,0.874,139,0.978,455,2.437]],["description/258",[6,2.052,9,4.355,17,0.17,19,1.635,33,4.984,36,3.26,53,0.149,56,0.551,68,2.052,73,1.232,105,2.193,134,0.224,139,1.379,149,1.685,166,0.195,168,0.199,193,2.795,204,0.703,250,3.26,265,0.984,307,1.933,327,2.435,455,3.436,647,2.51,655,3.513,760,2.921,806,3.26,883,2.367,920,3.26,921,3.26,922,3.26,923,4.58,928,2.688,930,2.795,934,2.795,949,3.513,951,4.861,974,2.921,977,3.513,978,3.896,979,3.896,980,3.896,981,3.513,982,3.896,983,3.26]],["title/259",[19,1.563,32,0.403,46,1.308,56,0.353,134,0.215,455,2.203]],["description/259",[17,0.196,19,2.708,32,0.486,34,2.995,48,2.42,53,0.172,56,0.426,105,2.532,134,0.259,166,0.225,168,0.229,204,0.811,218,2.899,220,2.812,222,4.158,240,2.733,257,2.474,311,2.474,350,2.733,412,3.764,455,2.661,460,1.78,602,4.056,883,2.733,917,3.372,934,3.227,956,3.764,957,4.056,958,4.056,983,3.764,984,4.499,985,4.056,986,4.499,987,4.499,988,4.499,989,4.499,990,4.499,991,4.499,992,4.499]],["title/260",[19,1.934,56,0.437,265,1.165,455,2.726]],["description/260",[17,0.192,19,1.843,53,0.168,56,0.416,68,2.314,75,3.677,134,0.366,149,1.901,166,0.22,168,0.224,172,3.464,190,3.464,204,0.793,265,1.603,274,2.925,430,3.031,455,2.599,460,1.739,609,3.962,776,3.677,828,3.031,883,2.669,917,3.294,930,3.152,931,3.962,934,4.553,938,4.553,939,3.294,950,5.721,951,3.677,966,3.294,983,3.677,993,4.394,994,4.394,995,4.394,996,4.394,997,4.394,998,4.394]],["title/261",[14,3.069,73,0.978,139,1.094,374,3.307]],["description/261",[6,1.746,7,1.481,9,2.485,14,3.421,17,0.145,19,1.391,25,2.989,33,2.379,53,0.127,56,0.314,73,0.703,105,1.866,120,2.774,134,0.296,139,1.22,149,2.722,166,0.166,168,0.169,204,0.598,220,2.072,243,2.379,269,2.774,274,2.207,279,1.783,291,1.645,329,2.989,362,2.614,482,1.912,489,2.614,518,2.485,883,2.014,917,3.852,920,2.774,921,2.774,922,2.774,923,2.614,928,2.287,930,2.379,932,2.614,933,2.774,934,2.379,935,4.051,936,2.614,943,2.989,948,2.989,964,2.614,966,2.485,974,2.485,985,2.989,999,2.989,1000,3.315,1001,3.315,1002,3.315,1003,3.315,1004,3.315,1005,3.315,1006,3.315,1007,3.315,1008,3.315,1009,2.989,1010,3.315,1011,2.989,1012,2.989,1013,2.774]],["title/262",[14,2.743,32,0.445,46,1.447,134,0.237,374,2.956]],["description/262",[14,3.992,17,0.262,32,0.648,53,0.23,56,0.568,134,0.345,149,2.594,166,0.3,168,0.306,204,1.082,883,3.643,935,4.727,936,4.727,999,5.406,1009,5.406,1011,5.406,1012,5.406,1013,5.018,1014,5.997,1015,5.997]],["title/263",[14,3.482,265,1.322,374,3.753]],["description/263",[6,2.802,14,3.543,17,0.232,34,3.543,50,2.5,53,0.204,56,0.688,105,2.995,131,1.449,134,0.307,166,0.266,168,0.271,204,0.96,238,2.457,265,1.345,524,4.453,883,3.233,923,4.195,932,4.195,933,4.453,934,3.818,935,4.195,936,4.195,974,3.989,1013,4.453,1016,5.322,1017,5.322]],["title/264",[32,0.445,46,1.447,134,0.237,938,2.956,939,3.089]],["description/264",[6,2.163,8,3.238,11,1.723,19,1.723,23,2.834,46,1.442,56,0.389,105,2.312,149,2.614,172,3.238,239,2.567,245,2,279,2.21,307,2.038,321,2.735,352,2.647,455,3.573,460,2.836,760,3.079,806,3.437,900,3.238,928,2.834,930,2.947,932,3.238,956,3.437,964,3.238,966,3.079,967,3.703,971,3.703,972,3.703,973,3.703,974,3.079,977,3.703,981,3.703,1018,4.108,1019,4.108,1020,4.108,1021,5.447,1022,3.703,1023,4.108,1024,4.108,1025,4.108,1026,4.108,1027,4.108]],["title/265",[19,1.729,32,0.445,46,1.447,134,0.237,1028,4.12]],["description/265",[8,3.505,11,1.865,12,3.72,13,3.72,23,3.067,48,2.391,77,2.205,91,4.008,149,1.923,159,2.701,219,3.333,254,3.72,260,3.19,269,3.72,279,3.442,307,2.205,430,3.067,455,2.629,493,3.333,767,3.505,900,3.505,928,3.067,938,4.591,939,5.62,940,5.77,962,4.008,963,4.008,964,3.505,965,4.008,966,3.333,1021,4.008,1022,4.008,1029,4.446,1030,4.446,1031,4.446,1032,4.446,1033,4.446]],["title/266",[32,0.445,46,1.447,134,0.237,938,2.956,1034,3.715]],["description/266",[7,2.557,8,4.513,11,2.402,58,3.477,77,2.84,153,5.161,242,3.477,279,3.079,460,2.266,493,4.291,661,4.79,930,4.107,938,6.152,939,5.716,1034,5.161,1035,5.724,1036,5.724,1037,5.724,1038,5.724,1039,5.724]],["title/267",[44,4.129]],["description/267",[3,0.29,6,1.382,7,2.775,11,2.868,21,3.591,23,1.811,24,1.968,28,1.514,37,2.367,38,1.968,39,1.968,40,2.196,41,2.367,42,1.691,43,2.367,44,4.452,45,2.367,48,1.412,56,0.405,69,0.57,77,1.302,81,0.627,96,2.75,131,1.469,174,2.196,175,3.87,176,3.848,177,3.775,178,3.848,179,2.367,180,4.137,181,4.287,182,4.137,195,0.958,202,2.402,217,2.668,221,1.172,228,2.367,232,1.477,237,1.811,253,0.97,271,2.367,272,2.367,273,3.848,274,3.591,275,2.367,276,2.525,277,3.19,278,3.848,552,2.367,568,1.444,590,2.367,620,1.811,690,3.572]]],"invertedIndex":[["",{"_index":7,"title":{},"description":{"0":{},"6":{},"10":{},"16":{},"19":{},"22":{},"28":{},"41":{},"87":{},"113":{},"120":{},"121":{},"122":{},"156":{},"187":{},"191":{},"193":{},"199":{},"203":{},"204":{},"205":{},"214":{},"257":{},"261":{},"266":{},"267":{}}}],["00:00",{"_index":589,"title":{},"description":{"137":{}}}],["0:00",{"_index":181,"title":{},"description":{"6":{},"10":{},"16":{},"41":{},"113":{},"214":{},"267":{}}}],["100",{"_index":441,"title":{},"description":{"78":{},"79":{}}}],["10th",{"_index":228,"title":{},"description":{"10":{},"267":{}}}],["13th",{"_index":273,"title":{},"description":{"16":{},"267":{}}}],["1st",{"_index":179,"title":{},"description":{"6":{},"267":{}}}],["200",{"_index":921,"title":{},"description":{"254":{},"258":{},"261":{}}}],["201",{"_index":920,"title":{},"description":{"254":{},"258":{},"261":{}}}],["2026",{"_index":180,"title":{},"description":{"6":{},"10":{},"16":{},"41":{},"113":{},"137":{},"214":{},"267":{}}}],["204",{"_index":925,"title":{},"description":{"254":{}}}],["400",{"_index":261,"title":{},"description":{"14":{},"92":{}}}],["404",{"_index":966,"title":{},"description":{"257":{},"260":{},"261":{},"264":{},"265":{}}}],["5",{"_index":509,"title":{},"description":{"105":{}}}],["502",{"_index":971,"title":{},"description":{"257":{},"264":{}}}],["6-charact",{"_index":607,"title":{},"description":{"141":{}}}],["7517",{"_index":1018,"title":{},"description":{"264":{}}}],["8693",{"_index":933,"title":{},"description":{"257":{},"261":{},"263":{}}}],["9th",{"_index":378,"title":{},"description":{"41":{},"113":{},"137":{},"214":{}}}],["_disconnected_",{"_index":101,"title":{},"description":{"0":{}}}],["absolut",{"_index":875,"title":{},"description":{"218":{}}}],["accept",{"_index":136,"title":{},"description":{"0":{},"12":{},"14":{},"137":{},"163":{}}}],["access",{"_index":159,"title":{},"description":{"2":{},"19":{},"22":{},"106":{},"121":{},"123":{},"156":{},"235":{},"241":{},"257":{},"265":{}}}],["accordingli",{"_index":230,"title":{},"description":{"10":{}}}],["account",{"_index":51,"title":{"1":{},"2":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{}},"description":{"0":{},"1":{},"2":{},"6":{},"7":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"19":{},"22":{},"73":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"103":{},"132":{},"152":{},"156":{},"166":{},"168":{},"170":{},"171":{},"172":{}}}],["accountnumb",{"_index":224,"title":{},"description":{"10":{}}}],["acknowledgeattachedinst",{"_index":631,"title":{},"description":{"154":{},"166":{},"168":{}}}],["act",{"_index":54,"title":{},"description":{"0":{},"1":{},"200":{}}}],["action",{"_index":361,"title":{"40":{}},"description":{"154":{},"199":{},"205":{},"249":{}}}],["activ",{"_index":620,"title":{},"description":{"151":{},"155":{},"156":{},"204":{},"231":{},"234":{},"267":{}}}],["activeonly=tru",{"_index":715,"title":{},"description":{"185":{},"195":{}}}],["actual",{"_index":688,"title":{},"description":{"177":{},"178":{},"189":{},"190":{}}}],["ad",{"_index":899,"title":{},"description":{"240":{}}}],["add",{"_index":682,"title":{},"description":{"171":{},"246":{},"254":{}}}],["add-bmc",{"_index":298,"title":{},"description":{"24":{}}}],["addition",{"_index":970,"title":{},"description":{"257":{}}}],["address",{"_index":368,"title":{},"description":{"40":{},"79":{},"220":{}}}],["admin",{"_index":216,"title":{},"description":{"10":{},"14":{},"56":{},"57":{},"58":{},"59":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"100":{},"121":{},"122":{},"123":{},"150":{},"254":{},"257":{}}}],["advanc",{"_index":832,"title":{"212":{}},"description":{"205":{},"211":{},"212":{}}}],["against",{"_index":643,"title":{},"description":{"156":{},"161":{},"177":{},"178":{},"189":{},"190":{},"196":{},"199":{}}}],["aggreg",{"_index":192,"title":{},"description":{"7":{}}}],["ai",{"_index":521,"title":{},"description":{"106":{}}}],["alert",{"_index":675,"title":{},"description":{"168":{}}}],["algorithm",{"_index":1032,"title":{},"description":{"265":{}}}],["alloc",{"_index":107,"title":{"9":{},"41":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{}},"description":{"0":{},"9":{},"19":{},"21":{},"22":{},"41":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"60":{},"66":{},"129":{},"141":{},"159":{},"220":{},"222":{},"224":{},"225":{},"226":{},"257":{}}}],["allow",{"_index":292,"title":{},"description":{"23":{},"25":{},"55":{},"129":{},"165":{},"167":{},"227":{},"235":{}}}],["allowedaudi",{"_index":987,"title":{},"description":{"259":{}}}],["alongsid",{"_index":104,"title":{},"description":{"0":{}}}],["alreadi",{"_index":306,"title":{},"description":{"26":{},"40":{},"54":{},"198":{},"254":{}}}],["already-`termin",{"_index":775,"title":{},"description":{"198":{}}}],["already-paus",{"_index":852,"title":{},"description":{"210":{}}}],["already-termin",{"_index":866,"title":{},"description":{"213":{}}}],["altern",{"_index":432,"title":{},"description":{"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{}}}],["alway",{"_index":188,"title":{},"description":{"6":{},"185":{},"195":{},"206":{}}}],["anchor",{"_index":74,"title":{},"description":{"0":{},"3":{},"6":{},"16":{}}}],["announc",{"_index":43,"title":{},"description":{"0":{},"267":{}}}],["anoth",{"_index":409,"title":{},"description":{"55":{}}}],["api",{"_index":6,"title":{"253":{}},"description":{"0":{},"1":{},"2":{},"17":{},"126":{},"156":{},"221":{},"249":{},"252":{},"253":{},"257":{},"258":{},"261":{},"263":{},"264":{},"267":{}}}],["appli",{"_index":855,"title":{},"description":{"211":{}}}],["appropri",{"_index":76,"title":{},"description":{"0":{}}}],["approv",{"_index":314,"title":{"28":{},"29":{},"30":{},"32":{},"33":{},"34":{}},"description":{"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"34":{}}}],["array",{"_index":475,"title":{},"description":{"89":{}}}],["artifact",{"_index":913,"title":{},"description":{"254":{}}}],["assign",{"_index":142,"title":{"158":{}},"description":{"0":{},"141":{},"158":{},"200":{},"206":{}}}],["associ",{"_index":145,"title":{"135":{},"136":{},"137":{}},"description":{"0":{},"43":{},"44":{},"121":{},"123":{},"136":{},"137":{},"151":{},"155":{},"156":{},"204":{},"219":{},"224":{},"226":{},"239":{},"243":{},"245":{}}}],["asynchron",{"_index":333,"title":{},"description":{"36":{},"196":{}}}],["atom",{"_index":596,"title":{},"description":{"141":{}}}],["attach",{"_index":593,"title":{"156":{}},"description":{"138":{},"154":{},"156":{},"166":{},"168":{}}}],["attribut",{"_index":217,"title":{},"description":{"10":{},"16":{},"41":{},"113":{},"152":{},"189":{},"214":{},"252":{},"257":{},"267":{}}}],["audit",{"_index":905,"title":{"249":{},"250":{},"251":{}},"description":{"249":{},"250":{},"251":{}}}],["auth",{"_index":25,"title":{},"description":{"0":{},"261":{}}}],["authent",{"_index":8,"title":{},"description":{"0":{},"264":{},"265":{},"266":{}}}],["author",{"_index":166,"title":{},"description":{"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"26":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"36":{},"37":{},"39":{},"40":{},"42":{},"43":{},"44":{},"46":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"56":{},"57":{},"58":{},"59":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"102":{},"103":{},"104":{},"105":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"121":{},"123":{},"124":{},"125":{},"126":{},"127":{},"128":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"152":{},"153":{},"154":{},"156":{},"157":{},"158":{},"159":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"215":{},"216":{},"217":{},"218":{},"219":{},"221":{},"222":{},"223":{},"224":{},"226":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"250":{},"251":{},"254":{},"255":{},"256":{},"257":{},"258":{},"259":{},"260":{},"261":{},"262":{},"263":{}}}],["automat",{"_index":312,"title":{},"description":{"27":{},"28":{},"31":{},"32":{},"101":{},"103":{},"141":{}}}],["avail",{"_index":98,"title":{},"description":{"0":{},"43":{},"126":{},"128":{},"141":{}}}],["awar",{"_index":30,"title":{},"description":{"0":{}}}],["back",{"_index":1005,"title":{},"description":{"261":{}}}],["backward",{"_index":38,"title":{},"description":{"0":{},"7":{},"197":{},"198":{},"267":{}}}],["bad",{"_index":972,"title":{},"description":{"257":{},"264":{}}}],["basic",{"_index":1010,"title":{},"description":{"261":{}}}],["batch",{"_index":438,"title":{"78":{},"79":{},"141":{}},"description":{"78":{},"79":{},"141":{}}}],["be",{"_index":31,"title":{},"description":{"0":{},"234":{},"240":{}}}],["bearer",{"_index":13,"title":{},"description":{"0":{},"257":{},"265":{}}}],["becom",{"_index":609,"title":{},"description":{"141":{},"260":{}}}],["befor",{"_index":479,"title":{},"description":{"92":{},"168":{}}}],["begin",{"_index":994,"title":{},"description":{"260":{}}}],["behalf",{"_index":903,"title":{},"description":{"247":{}}}],["behavior",{"_index":153,"title":{},"description":{"1":{},"266":{}}}],["belong",{"_index":209,"title":{},"description":{"9":{},"44":{},"57":{},"58":{},"59":{},"60":{},"66":{},"78":{},"79":{},"101":{},"142":{},"143":{},"144":{},"152":{},"153":{},"154":{},"157":{},"158":{},"159":{},"163":{},"166":{},"168":{},"170":{},"171":{},"172":{},"217":{},"218":{},"219":{},"226":{},"254":{}}}],["best-effort",{"_index":770,"title":{},"description":{"198":{},"213":{}}}],["between",{"_index":411,"title":{},"description":{"57":{},"60":{},"66":{},"113":{},"214":{}}}],["bill",{"_index":492,"title":{},"description":{"100":{}}}],["block",{"_index":80,"title":{"220":{},"221":{},"222":{},"223":{},"224":{},"225":{},"226":{}},"description":{"0":{},"37":{},"43":{},"47":{},"60":{},"66":{},"68":{},"149":{},"174":{},"220":{},"221":{},"222":{},"223":{},"224":{},"225":{},"226":{}}}],["bmc",{"_index":290,"title":{"23":{},"24":{},"165":{},"166":{}},"description":{"23":{},"38":{},"40":{},"72":{},"79":{},"80":{},"94":{},"165":{},"166":{}}}],["bmcipaddress",{"_index":445,"title":{},"description":{"79":{}}}],["bodi",{"_index":239,"title":{},"description":{"12":{},"89":{},"122":{},"185":{},"195":{},"200":{},"255":{},"256":{},"257":{},"264":{}}}],["bom",{"_index":494,"title":{},"description":{"100":{}}}],["boot",{"_index":310,"title":{"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"34":{}},"description":{"27":{},"31":{},"120":{}}}],["both",{"_index":55,"title":{},"description":{"0":{},"1":{},"14":{},"42":{},"57":{},"59":{},"121":{},"130":{},"137":{}}}],["boundari",{"_index":402,"title":{},"description":{"48":{}}}],["break",{"_index":41,"title":{},"description":{"0":{},"267":{}}}],["breakdown",{"_index":653,"title":{},"description":{"159":{}}}],["brief",{"_index":93,"title":{},"description":{"0":{}}}],["bring",{"_index":708,"title":{"183":{},"184":{}},"description":{"183":{},"184":{}}}],["bring-up",{"_index":759,"title":{},"description":{"196":{}}}],["broken",{"_index":649,"title":{},"description":{"158":{}}}],["build",{"_index":618,"title":{},"description":{"149":{},"174":{}}}],["built",{"_index":637,"title":{},"description":{"156":{}}}],["bump",{"_index":330,"title":{},"description":{"36":{}}}],["cach",{"_index":998,"title":{},"description":{"260":{}}}],["call",{"_index":33,"title":{},"description":{"0":{},"40":{},"168":{},"257":{},"258":{},"261":{}}}],["callback",{"_index":936,"title":{},"description":{"257":{},"261":{},"262":{},"263":{}}}],["caller",{"_index":547,"title":{},"description":{"121":{},"126":{},"128":{},"150":{}}}],["caller'",{"_index":236,"title":{},"description":{"12":{},"121":{},"122":{},"156":{}}}],["caller-sid",{"_index":729,"title":{},"description":{"185":{},"195":{}}}],["cancel",{"_index":761,"title":{"198":{},"213":{}},"description":{"196":{},"198":{},"205":{},"213":{}}}],["candid",{"_index":821,"title":{},"description":{"205":{},"206":{},"257":{}}}],["capabilities.targetedinstancecr",{"_index":174,"title":{},"description":{"6":{},"7":{},"267":{}}}],["capabl",{"_index":195,"title":{"160":{},"173":{}},"description":{"7":{},"16":{},"73":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"103":{},"129":{},"136":{},"152":{},"160":{},"166":{},"168":{},"170":{},"171":{},"172":{},"173":{},"267":{}}}],["cascad",{"_index":864,"title":{},"description":{"213":{}}}],["case",{"_index":59,"title":{},"description":{"0":{}}}],["certain",{"_index":626,"title":{},"description":{"153":{}}}],["chang",{"_index":42,"title":{},"description":{"0":{},"92":{},"196":{},"198":{},"200":{},"203":{},"206":{},"257":{},"267":{}}}],["characterist",{"_index":496,"title":{},"description":{"100":{},"101":{},"103":{}}}],["chassi",{"_index":454,"title":{},"description":{"86":{},"87":{}}}],["chassis.manufactur",{"_index":461,"title":{},"description":{"86":{},"87":{}}}],["chassis.model",{"_index":463,"title":{},"description":{"86":{},"87":{}}}],["chassis.serial-numb",{"_index":462,"title":{},"description":{"86":{},"87":{}}}],["child",{"_index":880,"title":{},"description":{"226":{}}}],["choos",{"_index":100,"title":{},"description":{"0":{}}}],["claim",{"_index":851,"title":{},"description":{"210":{},"213":{}}}],["classif",{"_index":677,"title":{},"description":{"168":{}}}],["clear",{"_index":362,"title":{},"description":{"40":{},"89":{},"257":{},"261":{}}}],["client",{"_index":767,"title":{},"description":{"197":{},"198":{},"212":{},"265":{}}}],["clientid",{"_index":1008,"title":{},"description":{"261":{}}}],["clientsecret",{"_index":1009,"title":{},"description":{"261":{},"262":{}}}],["clientsecretbas",{"_index":1004,"title":{},"description":{"261":{}}}],["combin",{"_index":740,"title":{},"description":{"187":{},"191":{},"193":{}}}],["commun",{"_index":408,"title":{},"description":{"55":{},"113":{}}}],["compar",{"_index":687,"title":{},"description":{"177":{},"178":{},"189":{},"190":{}}}],["compat",{"_index":39,"title":{},"description":{"0":{},"7":{},"197":{},"198":{},"267":{}}}],["complet",{"_index":338,"title":{},"description":{"37":{},"40":{},"210":{},"218":{}}}],["compon",{"_index":507,"title":{},"description":{"105":{},"177":{},"178":{},"186":{},"187":{},"189":{},"190":{},"196":{},"199":{},"254":{}}}],["component-level",{"_index":743,"title":{},"description":{"187":{},"191":{},"193":{}}}],["componentid",{"_index":744,"title":{},"description":{"187":{},"191":{},"193":{}}}],["compos",{"_index":714,"title":{},"description":{"185":{},"187":{},"195":{},"201":{},"207":{},"209":{}}}],["comput",{"_index":147,"title":{},"description":{"0":{},"6":{},"41":{},"43":{},"106":{}}}],["concurr",{"_index":787,"title":{},"description":{"199":{}}}],["config",{"_index":912,"title":{"254":{},"255":{},"256":{}},"description":{"254":{},"255":{},"256":{}}}],["configur",{"_index":19,"title":{"258":{},"259":{},"260":{},"265":{}},"description":{"0":{},"1":{},"2":{},"6":{},"7":{},"10":{},"14":{},"20":{},"100":{},"101":{},"103":{},"141":{},"156":{},"177":{},"178":{},"189":{},"190":{},"206":{},"254":{},"256":{},"257":{},"258":{},"259":{},"260":{},"261":{},"264":{}}}],["connect",{"_index":211,"title":{},"description":{"10":{},"60":{},"66":{}}}],["consol",{"_index":894,"title":{},"description":{"235":{},"241":{}}}],["constraint",{"_index":376,"title":{"47":{}},"description":{"41":{},"43":{},"47":{},"187":{},"191":{},"193":{}}}],["constraintvalu",{"_index":392,"title":{},"description":{"47":{}}}],["consult",{"_index":22,"title":{},"description":{"0":{}}}],["consum",{"_index":172,"title":{},"description":{"6":{},"257":{},"260":{},"264":{}}}],["contain",{"_index":259,"title":{},"description":{"14":{},"16":{},"149":{},"168":{},"169":{},"174":{}}}],["content",{"_index":926,"title":{},"description":{"254":{}}}],["contigu",{"_index":877,"title":{},"description":{"220":{}}}],["continu",{"_index":587,"title":{},"description":{"137":{},"210":{},"257":{}}}],["control",{"_index":629,"title":{"154":{},"179":{},"180":{},"191":{},"192":{}},"description":{"154":{},"179":{},"180":{},"191":{},"192":{},"214":{}}}],["converg",{"_index":325,"title":{},"description":{"35":{},"36":{},"37":{}}}],["convey",{"_index":457,"title":{},"description":{"86":{},"87":{}}}],["core",{"_index":105,"title":{},"description":{"0":{},"39":{},"40":{},"126":{},"128":{},"156":{},"163":{},"254":{},"257":{},"258":{},"259":{},"261":{},"263":{},"264":{}}}],["count",{"_index":340,"title":{},"description":{"37":{},"158":{},"185":{},"195":{},"201":{},"207":{},"208":{},"209":{}}}],["cpu",{"_index":527,"title":{},"description":{"106":{},"149":{}}}],["creat",{"_index":73,"title":{"12":{},"18":{},"24":{},"26":{},"28":{},"32":{},"43":{},"50":{},"57":{},"62":{},"68":{},"73":{},"78":{},"81":{},"87":{},"95":{},"102":{},"108":{},"115":{},"122":{},"131":{},"136":{},"140":{},"141":{},"163":{},"171":{},"200":{},"206":{},"216":{},"222":{},"229":{},"237":{},"243":{},"255":{},"258":{},"261":{}},"description":{"0":{},"1":{},"12":{},"15":{},"16":{},"18":{},"23":{},"24":{},"25":{},"26":{},"43":{},"45":{},"47":{},"50":{},"57":{},"62":{},"68":{},"73":{},"78":{},"81":{},"87":{},"89":{},"95":{},"100":{},"102":{},"108":{},"115":{},"120":{},"122":{},"131":{},"140":{},"141":{},"163":{},"168":{},"196":{},"197":{},"198":{},"200":{},"203":{},"206":{},"216":{},"218":{},"222":{},"225":{},"226":{},"229":{},"232":{},"237":{},"243":{},"254":{},"255":{},"258":{},"261":{}}}],["creation",{"_index":814,"title":{},"description":{"203":{},"205":{}}}],["credenti",{"_index":291,"title":{"23":{},"24":{},"25":{},"26":{},"35":{},"36":{},"37":{}},"description":{"23":{},"24":{},"25":{},"26":{},"35":{},"36":{},"37":{},"72":{},"80":{},"94":{},"232":{},"257":{},"261":{}}}],["criteria",{"_index":627,"title":{},"description":{"153":{}}}],["crud",{"_index":794,"title":{},"description":{"199":{}}}],["cumul",{"_index":846,"title":{},"description":{"208":{}}}],["current",{"_index":46,"title":{"2":{},"4":{},"5":{},"7":{},"8":{},"248":{},"259":{},"262":{},"264":{},"265":{},"266":{}},"description":{"0":{},"2":{},"4":{},"5":{},"7":{},"8":{},"79":{},"105":{},"205":{},"206":{},"208":{},"213":{},"227":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"248":{},"264":{}}}],["custom",{"_index":886,"title":{},"description":{"227":{}}}],["cycl",{"_index":700,"title":{},"description":{"179":{},"180":{},"191":{},"192":{}}}],["data",{"_index":128,"title":{},"description":{"0":{},"232":{}}}],["databas",{"_index":480,"title":{},"description":{"92":{}}}],["datacent",{"_index":266,"title":{},"description":{"16":{}}}],["decommiss",{"_index":396,"title":{},"description":{"47":{}}}],["decrement",{"_index":394,"title":{},"description":{"47":{}}}],["default",{"_index":222,"title":{},"description":{"10":{},"14":{},"39":{},"141":{},"185":{},"195":{},"204":{},"254":{},"259":{}}}],["defaultaudi",{"_index":988,"title":{},"description":{"259":{}}}],["defin",{"_index":86,"title":{},"description":{"0":{},"48":{},"100":{},"129":{},"173":{},"199":{},"220":{},"254":{}}}],["definit",{"_index":560,"title":{},"description":{"126":{},"200":{},"203":{}}}],["deleg",{"_index":374,"title":{"261":{},"262":{},"263":{}},"description":{"41":{},"220":{},"257":{}}}],["delet",{"_index":265,"title":{"15":{},"21":{},"30":{},"34":{},"45":{},"52":{},"59":{},"64":{},"70":{},"77":{},"85":{},"90":{},"93":{},"99":{},"104":{},"110":{},"118":{},"124":{},"133":{},"137":{},"143":{},"153":{},"172":{},"204":{},"219":{},"224":{},"231":{},"234":{},"239":{},"245":{},"256":{},"260":{},"263":{}},"description":{"15":{},"21":{},"30":{},"34":{},"45":{},"52":{},"59":{},"64":{},"70":{},"77":{},"85":{},"89":{},"90":{},"93":{},"99":{},"100":{},"104":{},"110":{},"118":{},"124":{},"133":{},"137":{},"143":{},"153":{},"199":{},"203":{},"204":{},"219":{},"224":{},"231":{},"234":{},"239":{},"245":{},"254":{},"256":{},"257":{},"258":{},"260":{},"263":{}}}],["deletehostfirmwareconfig",{"_index":924,"title":{},"description":{"254":{}}}],["depend",{"_index":18,"title":{},"description":{"0":{}}}],["deploy",{"_index":103,"title":{},"description":{"0":{},"2":{},"231":{},"234":{}}}],["deprec",{"_index":44,"title":{"267":{}},"description":{"0":{},"6":{},"7":{},"10":{},"12":{},"16":{},"41":{},"113":{},"120":{},"122":{},"214":{},"267":{}}}],["deprecations](#tag/deprec",{"_index":49,"title":{},"description":{"0":{}}}],["deriv",{"_index":498,"title":{"226":{}},"description":{"101":{},"103":{},"120":{},"122":{},"208":{}}}],["describ",{"_index":341,"title":{},"description":{"37":{},"220":{},"252":{}}}],["descript",{"_index":806,"title":{},"description":{"203":{},"258":{},"264":{}}}],["design",{"_index":516,"title":{},"description":{"106":{}}}],["desir",{"_index":876,"title":{},"description":{"218":{}}}],["destroy",{"_index":950,"title":{},"description":{"257":{},"260":{}}}],["detail",{"_index":20,"title":{"159":{}},"description":{"0":{},"37":{},"58":{},"132":{},"151":{},"155":{},"159":{},"177":{},"178":{},"189":{},"190":{},"205":{},"209":{},"214":{},"233":{},"248":{}}}],["determin",{"_index":156,"title":{},"description":{"1":{},"104":{},"105":{}}}],["devic",{"_index":332,"title":{},"description":{"36":{},"37":{}}}],["devicemac",{"_index":339,"title":{},"description":{"37":{}}}],["diff",{"_index":692,"title":{},"description":{"177":{},"178":{},"189":{},"190":{}}}],["differ",{"_index":415,"title":{},"description":{"57":{},"141":{}}}],["direct",{"_index":524,"title":{},"description":{"106":{},"113":{},"263":{}}}],["directli",{"_index":269,"title":{},"description":{"16":{},"261":{},"265":{}}}],["disabl",{"_index":161,"title":{},"description":{"2":{}}}],["disallow",{"_index":200,"title":{},"description":{"7":{}}}],["discov",{"_index":344,"title":{},"description":{"38":{},"39":{},"72":{},"73":{},"80":{},"81":{},"86":{},"87":{},"94":{},"95":{},"101":{},"103":{}}}],["discoveri",{"_index":430,"title":{},"description":{"72":{},"80":{},"86":{},"94":{},"257":{},"260":{},"265":{}}}],["dissoci",{"_index":816,"title":{},"description":{"204":{}}}],["distinct",{"_index":655,"title":{},"description":{"160":{},"258":{}}}],["distribut",{"_index":531,"title":{},"description":{"106":{}}}],["divid",{"_index":823,"title":{},"description":{"205":{},"206":{}}}],["do",{"_index":395,"title":{},"description":{"47":{}}}],["document",{"_index":940,"title":{},"description":{"257":{},"265":{}}}],["domain",{"_index":602,"title":{},"description":{"141":{},"259":{}}}],["domain-awar",{"_index":595,"title":{},"description":{"141":{}}}],["down",{"_index":650,"title":{},"description":{"158":{}}}],["dpu",{"_index":303,"title":{"156":{},"167":{},"168":{},"227":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{}},"description":{"25":{},"26":{},"156":{},"167":{},"168":{},"227":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{}}}],["drill",{"_index":835,"title":{},"description":{"205":{},"209":{}}}],["drive",{"_index":824,"title":{},"description":{"205":{}}}],["dry-run",{"_index":797,"title":{},"description":{"200":{}}}],["dual-rol",{"_index":550,"title":{},"description":{"121":{}}}],["dure",{"_index":956,"title":{},"description":{"257":{},"259":{},"264":{}}}],["e.g",{"_index":398,"title":{},"description":{"47":{},"141":{}}}],["each",{"_index":83,"title":{},"description":{"0":{},"126":{},"159":{},"161":{},"185":{},"195":{},"205":{},"209":{}}}],["earlier",{"_index":371,"title":{},"description":{"40":{}}}],["echo",{"_index":802,"title":{},"description":{"200":{},"206":{}}}],["effect",{"_index":434,"title":{},"description":{"74":{},"150":{}}}],["elig",{"_index":628,"title":{},"description":{"153":{}}}],["embed",{"_index":185,"title":{},"description":{"6":{}}}],["empti",{"_index":219,"title":{},"description":{"10":{},"14":{},"89":{},"257":{},"265":{}}}],["enabl",{"_index":68,"title":{},"description":{"0":{},"2":{},"7":{},"60":{},"66":{},"101":{},"103":{},"152":{},"156":{},"166":{},"168":{},"170":{},"171":{},"172":{},"257":{},"258":{},"260":{}}}],["enclosur",{"_index":684,"title":{},"description":{"174":{}}}],["endpoint",{"_index":77,"title":{"39":{},"40":{}},"description":{"0":{},"23":{},"25":{},"27":{},"31":{},"35":{},"36":{},"38":{},"39":{},"40":{},"141":{},"196":{},"211":{},"246":{},"257":{},"265":{},"266":{},"267":{}}}],["endpoint'",{"_index":961,"title":{},"description":{"257":{}}}],["endpoint](#tag/allocation/operation/create-alloc",{"_index":111,"title":{},"description":{"0":{}}}],["endpoint](#tag/infrastructure-provider/operation/get-current-infrastructure-provid",{"_index":70,"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":89,"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":99,"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":71,"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":{}}}],["enforc",{"_index":680,"title":{},"description":{"169":{}}}],["enough",{"_index":382,"title":{},"description":{"43":{}}}],["entiti",{"_index":62,"title":{},"description":{"0":{},"3":{},"4":{},"6":{},"7":{},"12":{},"14":{},"15":{},"18":{},"21":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"43":{},"45":{},"46":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"103":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"123":{},"124":{},"125":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"215":{},"216":{},"217":{},"218":{},"219":{},"224":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"247":{}}}],["entri",{"_index":218,"title":{"250":{},"251":{}},"description":{"10":{},"14":{},"89":{},"250":{},"251":{},"254":{},"259":{}}}],["equal",{"_index":386,"title":{},"description":{"43":{}}}],["equival",{"_index":296,"title":{},"description":{"24":{},"36":{},"37":{}}}],["error",{"_index":364,"title":{},"description":{"40":{}}}],["es256",{"_index":977,"title":{},"description":{"258":{},"264":{}}}],["etc",{"_index":600,"title":{},"description":{"141":{},"257":{}}}],["exactli",{"_index":256,"title":{},"description":{"14":{},"206":{}}}],["exampl",{"_index":154,"title":{},"description":{"1":{},"196":{},"199":{}}}],["exce",{"_index":829,"title":{},"description":{"205":{}}}],["except",{"_index":444,"title":{},"description":{"79":{}}}],["exchang",{"_index":935,"title":{},"description":{"257":{},"261":{},"262":{},"263":{}}}],["exclus",{"_index":738,"title":{},"description":{"187":{},"191":{},"193":{}}}],["execut",{"_index":630,"title":{},"description":{"154":{},"161":{},"199":{},"205":{},"206":{},"209":{}}}],["exist",{"_index":307,"title":{},"description":{"26":{},"46":{},"47":{},"53":{},"65":{},"71":{},"76":{},"77":{},"84":{},"85":{},"89":{},"92":{},"93":{},"98":{},"99":{},"111":{},"225":{},"258":{},"264":{},"265":{}}}],["expect",{"_index":424,"title":{"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"86":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"96":{},"97":{},"98":{},"99":{}},"description":{"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"86":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"96":{},"97":{},"98":{},"99":{},"177":{},"178":{},"189":{},"190":{}}}],["expectedphaseindex",{"_index":860,"title":{},"description":{"212":{}}}],["expectedrack",{"_index":473,"title":{},"description":{"89":{}}}],["expir",{"_index":960,"title":{},"description":{"257":{}}}],["explicit",{"_index":367,"title":{},"description":{"40":{}}}],["explor",{"_index":343,"title":{"38":{},"39":{},"40":{}},"description":{"38":{},"39":{},"40":{}}}],["expos",{"_index":634,"title":{},"description":{"156":{},"199":{},"205":{}}}],["extens",{"_index":885,"title":{"227":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{}},"description":{"227":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{}}}],["extern",{"_index":946,"title":{},"description":{"257":{}}}],["extra",{"_index":695,"title":{},"description":{"177":{},"178":{},"189":{},"190":{}}}],["fail",{"_index":304,"title":{},"description":{"26":{},"40":{},"141":{},"198":{}}}],["failur",{"_index":796,"title":{},"description":{"200":{},"203":{},"205":{},"206":{}}}],["fals",{"_index":190,"title":{},"description":{"6":{},"141":{},"257":{},"260":{}}}],["favor",{"_index":175,"title":{},"description":{"6":{},"16":{},"41":{},"113":{},"214":{},"267":{}}}],["fetch",{"_index":947,"title":{},"description":{"257":{}}}],["field",{"_index":240,"title":{},"description":{"12":{},"79":{},"105":{},"120":{},"122":{},"156":{},"185":{},"195":{},"203":{},"257":{},"259":{}}}],["file",{"_index":88,"title":{},"description":{"0":{}}}],["fill",{"_index":986,"title":{},"description":{"259":{}}}],["filter",{"_index":568,"title":{},"description":{"126":{},"177":{},"179":{},"181":{},"183":{},"185":{},"187":{},"189":{},"191":{},"193":{},"195":{},"201":{},"207":{},"209":{},"267":{}}}],["findexploredendpointid",{"_index":353,"title":{},"description":{"39":{}}}],["findexploredendpointsbyid",{"_index":355,"title":{},"description":{"39":{}}}],["finish",{"_index":777,"title":{},"description":{"198":{}}}],["firmwar",{"_index":705,"title":{"181":{},"182":{},"193":{},"194":{},"254":{},"255":{},"256":{}},"description":{"181":{},"182":{},"193":{},"194":{},"196":{},"205":{},"206":{},"254":{},"255":{},"256":{}}}],["firmwarecontrol",{"_index":784,"title":{},"description":{"199":{}}}],["first",{"_index":9,"title":{},"description":{"0":{},"204":{},"254":{},"258":{},"261":{}}}],["flow",{"_index":96,"title":{},"description":{"0":{},"16":{},"199":{},"200":{},"204":{},"206":{},"212":{},"214":{},"267":{}}}],["fnn",{"_index":118,"title":{},"description":{"0":{},"60":{},"66":{}}}],["follow",{"_index":354,"title":{},"description":{"39":{},"156":{}}}],["forcecycl",{"_index":702,"title":{},"description":{"179":{},"180":{},"191":{},"192":{}}}],["forceoff",{"_index":701,"title":{},"description":{"179":{},"180":{},"191":{},"192":{}}}],["found",{"_index":967,"title":{},"description":{"257":{},"264":{}}}],["full",{"_index":108,"title":{},"description":{"0":{},"89":{},"185":{},"195":{}}}],["full-replac",{"_index":948,"title":{},"description":{"257":{},"261":{}}}],["further",{"_index":435,"title":{},"description":{"74":{},"150":{}}}],["gate",{"_index":827,"title":{},"description":{"205":{},"211":{},"212":{}}}],["gateway",{"_index":973,"title":{},"description":{"257":{},"264":{}}}],["gener",{"_index":36,"title":{},"description":{"0":{},"141":{},"258":{}}}],["get",{"_index":0,"title":{"0":{}},"description":{}}],["getdpumachin",{"_index":641,"title":{},"description":{"156":{}}}],["given",{"_index":577,"title":{},"description":{"135":{},"254":{}}}],["global",{"_index":564,"title":{},"description":{"126":{}}}],["gpu",{"_index":536,"title":{"157":{}},"description":{"113":{},"149":{},"157":{}}}],["grant",{"_index":282,"title":{},"description":{"19":{},"22":{},"156":{}}}],["group",{"_index":208,"title":{"214":{},"215":{},"216":{},"217":{},"218":{},"219":{},"235":{},"236":{},"237":{},"238":{},"239":{},"240":{}},"description":{"9":{},"100":{},"106":{},"113":{},"129":{},"157":{},"158":{},"173":{},"214":{},"215":{},"216":{},"217":{},"218":{},"219":{},"235":{},"236":{},"237":{},"238":{},"239":{},"240":{},"243":{},"245":{},"246":{}}}],["grpc",{"_index":974,"title":{},"description":{"257":{},"258":{},"261":{},"263":{},"264":{}}}],["guard",{"_index":858,"title":{},"description":{"212":{}}}],["guidanc",{"_index":1026,"title":{},"description":{"264":{}}}],["handler",{"_index":763,"title":{},"description":{"197":{},"198":{}}}],["hardwar",{"_index":268,"title":{},"description":{"16":{},"100":{},"101":{},"103":{},"149":{},"173":{},"254":{}}}],["hash",{"_index":1015,"title":{},"description":{"262":{}}}],["header",{"_index":358,"title":{},"description":{"39":{},"185":{},"195":{},"201":{},"207":{},"209":{}}}],["health",{"_index":674,"title":{"169":{},"170":{},"171":{},"172":{}},"description":{"168":{},"169":{},"170":{},"171":{},"172":{}}}],["help",{"_index":429,"title":{},"description":{"72":{},"80":{},"86":{},"94":{}}}],["here",{"_index":203,"title":{},"description":{"7":{}}}],["high-perform",{"_index":513,"title":{},"description":{"106":{}}}],["histori",{"_index":173,"title":{"22":{},"145":{},"155":{}},"description":{"6":{},"10":{},"22":{},"41":{},"113":{},"120":{},"145":{},"214":{}}}],["hold",{"_index":831,"title":{},"description":{"205":{}}}],["holder",{"_index":82,"title":{},"description":{"0":{}}}],["host",{"_index":302,"title":{"156":{},"254":{},"255":{},"256":{}},"description":{"25":{},"26":{},"156":{},"254":{},"255":{},"256":{}}}],["hostupdateinprogress",{"_index":676,"title":{},"description":{"168":{}}}],["hpc",{"_index":520,"title":{},"description":{"106":{}}}],["ib",{"_index":512,"title":{},"description":{"106":{}}}],["id",{"_index":155,"title":{},"description":{"1":{},"13":{},"14":{},"15":{},"19":{},"30":{},"34":{},"39":{},"44":{},"45":{},"47":{},"51":{},"52":{},"58":{},"59":{},"64":{},"70":{},"75":{},"76":{},"77":{},"83":{},"84":{},"85":{},"91":{},"92":{},"93":{},"97":{},"98":{},"99":{},"103":{},"110":{},"116":{},"118":{},"123":{},"124":{},"125":{},"128":{},"132":{},"133":{},"134":{},"137":{},"142":{},"143":{},"144":{},"156":{},"168":{},"176":{},"188":{},"196":{},"200":{},"206":{},"217":{},"218":{},"219":{},"223":{},"230":{},"231":{},"238":{},"244":{},"245":{},"246":{},"251":{}}}],["id_asc",{"_index":347,"title":{},"description":{"39":{}}}],["id_desc",{"_index":348,"title":{},"description":{"39":{}}}],["id_token_signing_alg_values_support",{"_index":962,"title":{},"description":{"257":{},"265":{}}}],["id_token`",{"_index":965,"title":{},"description":{"257":{},"265":{}}}],["id`/`componentid",{"_index":741,"title":{},"description":{"187":{}}}],["idempot",{"_index":771,"title":{},"description":{"198":{},"210":{}}}],["ident",{"_index":455,"title":{"257":{},"258":{},"259":{},"260":{}},"description":{"86":{},"87":{},"257":{},"258":{},"259":{},"260":{},"264":{},"265":{}}}],["identifi",{"_index":425,"title":{},"description":{"72":{},"80":{},"86":{},"87":{},"92":{},"93":{},"94":{},"180":{},"182":{},"184":{},"192":{},"194":{},"247":{}}}],["ids`/`componentid",{"_index":753,"title":{},"description":{"191":{},"193":{}}}],["ignor",{"_index":543,"title":{},"description":{"120":{},"166":{}}}],["imag",{"_index":556,"title":{},"description":{"122":{}}}],["immut",{"_index":478,"title":{},"description":{"92":{},"203":{}}}],["in-flight",{"_index":337,"title":{},"description":{"37":{},"210":{},"213":{},"257":{}}}],["includ",{"_index":255,"title":{},"description":{"14":{},"156":{},"159":{},"168":{},"169":{},"185":{},"195":{},"257":{}}}],["includereport=tru",{"_index":722,"title":{},"description":{"185":{},"195":{}}}],["includestats=tru",{"_index":843,"title":{},"description":{"208":{}}}],["increment",{"_index":393,"title":{},"description":{"47":{}}}],["indirectli",{"_index":270,"title":{},"description":{"16":{}}}],["individu",{"_index":882,"title":{},"description":{"226":{},"247":{}}}],["infer",{"_index":231,"title":{},"description":{"11":{},"12":{},"13":{},"42":{},"44":{},"127":{},"128":{},"130":{}}}],["infiniband",{"_index":510,"title":{"106":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"147":{}},"description":{"106":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"147":{}}}],["inform",{"_index":213,"title":{},"description":{"10":{},"12":{},"86":{},"87":{},"169":{},"253":{}}}],["infrastructur",{"_index":69,"title":{"3":{},"4":{},"5":{}},"description":{"0":{},"3":{},"4":{},"5":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"18":{},"19":{},"20":{},"21":{},"22":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"86":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"102":{},"103":{},"104":{},"105":{},"121":{},"123":{},"124":{},"125":{},"127":{},"128":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"150":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"222":{},"224":{},"225":{},"226":{},"254":{},"267":{}}}],["infrastructureproviderid",{"_index":237,"title":{},"description":{"12":{},"17":{},"123":{},"124":{},"125":{},"221":{},"267":{}}}],["ingest",{"_index":431,"title":{},"description":{"72":{},"80":{},"86":{},"94":{},"161":{}}}],["initi",{"_index":63,"title":{},"description":{"0":{}}}],["instal",{"_index":102,"title":{},"description":{"0":{}}}],["instanc",{"_index":131,"title":{"9":{},"129":{},"130":{},"131":{},"132":{},"133":{},"134":{},"138":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"147":{},"148":{},"158":{}},"description":{"0":{},"1":{},"9":{},"43":{},"48":{},"54":{},"55":{},"60":{},"66":{},"129":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"138":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"151":{},"152":{},"154":{},"155":{},"158":{},"159":{},"166":{},"168":{},"173":{},"214":{},"217":{},"218":{},"219":{},"227":{},"235":{},"241":{},"263":{},"267":{}}}],["instancetyp",{"_index":391,"title":{},"description":{"47":{}}}],["instead",{"_index":274,"title":{},"description":{"16":{},"41":{},"113":{},"211":{},"214":{},"260":{},"261":{},"267":{}}}],["insuffici",{"_index":603,"title":{},"description":{"141":{}}}],["integr",{"_index":662,"title":{},"description":{"161":{}}}],["intention",{"_index":963,"title":{},"description":{"257":{},"265":{}}}],["interconnect",{"_index":517,"title":{},"description":{"106":{}}}],["interfac",{"_index":534,"title":{"112":{},"119":{},"146":{},"147":{},"148":{}},"description":{"112":{},"113":{},"119":{},"141":{},"146":{},"147":{},"148":{},"156":{}}}],["intermedi",{"_index":1001,"title":{},"description":{"261":{}}}],["internal-onli",{"_index":635,"title":{},"description":{"156":{}}}],["invit",{"_index":246,"title":{},"description":{"12":{},"14":{}}}],["ip",{"_index":79,"title":{"220":{},"221":{},"222":{},"223":{},"224":{},"225":{},"226":{}},"description":{"0":{},"40":{},"43":{},"60":{},"66":{},"68":{},"79":{},"220":{},"221":{},"222":{},"223":{},"224":{},"225":{},"226":{}}}],["ipblock",{"_index":397,"title":{},"description":{"47":{}}}],["ipv4",{"_index":421,"title":{},"description":{"68":{}}}],["ipv6",{"_index":422,"title":{},"description":{"68":{}}}],["ipx",{"_index":126,"title":{"126":{},"127":{},"128":{}},"description":{"0":{},"120":{},"122":{},"126":{},"127":{},"128":{}}}],["ipxetemplateid",{"_index":569,"title":{},"description":{"126":{}}}],["ipxetemplatesiteassoci",{"_index":565,"title":{},"description":{"126":{}}}],["iscloudinit",{"_index":542,"title":{},"description":{"120":{}}}],["isflowen",{"_index":278,"title":{},"description":{"16":{},"267":{}}}],["isol",{"_index":401,"title":{},"description":{"48":{},"106":{}}}],["israckleveladministrationen",{"_index":275,"title":{},"description":{"16":{},"267":{}}}],["issu",{"_index":964,"title":{},"description":{"257":{},"261":{},"264":{},"265":{}}}],["issuanc",{"_index":931,"title":{},"description":{"257":{},"260":{}}}],["issuer'",{"_index":990,"title":{},"description":{"259":{}}}],["item",{"_index":443,"title":{},"description":{"79":{}}}],["itself",{"_index":567,"title":{},"description":{"126":{}}}],["json",{"_index":1019,"title":{},"description":{"264":{}}}],["juli",{"_index":377,"title":{},"description":{"41":{},"113":{},"137":{},"214":{}}}],["jwk",{"_index":938,"title":{"264":{},"266":{}},"description":{"257":{},"260":{},"265":{},"266":{}}}],["jwt",{"_index":12,"title":{},"description":{"0":{},"257":{},"265":{}}}],["jwt-svid",{"_index":930,"title":{},"description":{"257":{},"258":{},"260":{},"261":{},"264":{},"266":{}}}],["k8",{"_index":887,"title":{},"description":{"227":{}}}],["kb",{"_index":725,"title":{},"description":{"185":{},"195":{}}}],["keep",{"_index":489,"title":{},"description":{"100":{},"101":{},"103":{},"261":{}}}],["key",{"_index":460,"title":{"235":{},"236":{},"237":{},"238":{},"239":{},"240":{},"241":{},"242":{},"243":{},"244":{},"245":{},"246":{}},"description":{"86":{},"87":{},"141":{},"235":{},"236":{},"237":{},"238":{},"239":{},"240":{},"241":{},"242":{},"243":{},"244":{},"245":{},"246":{},"254":{},"256":{},"257":{},"259":{},"260":{},"264":{},"266":{}}}],["key-rot",{"_index":957,"title":{},"description":{"257":{},"259":{}}}],["keypair",{"_index":951,"title":{},"description":{"257":{},"258":{},"260":{}}}],["kid",{"_index":955,"title":{},"description":{"257":{}}}],["know",{"_index":133,"title":{},"description":{"0":{}}}],["known",{"_index":867,"title":{},"description":{"213":{},"254":{}}}],["label",{"_index":459,"title":{},"description":{"86":{},"87":{},"152":{}}}],["last",{"_index":363,"title":{},"description":{"40":{},"213":{}}}],["leav",{"_index":812,"title":{},"description":{"203":{}}}],["left",{"_index":809,"title":{},"description":{"203":{}}}],["length",{"_index":110,"title":{},"description":{"0":{},"43":{},"220":{}}}],["level",{"_index":201,"title":{},"description":{"7":{}}}],["librari",{"_index":1031,"title":{},"description":{"265":{}}}],["lifecycl",{"_index":834,"title":{},"description":{"205":{}}}],["list",{"_index":48,"title":{"201":{}},"description":{"0":{},"40":{},"89":{},"121":{},"126":{},"185":{},"195":{},"196":{},"201":{},"205":{},"207":{},"209":{},"259":{},"265":{},"267":{}}}],["load",{"_index":530,"title":{},"description":{"106":{}}}],["locat",{"_index":456,"title":{},"description":{"86":{},"87":{},"254":{}}}],["location.datacent",{"_index":465,"title":{},"description":{"86":{},"87":{}}}],["location.posit",{"_index":467,"title":{},"description":{"86":{},"87":{}}}],["location.region",{"_index":464,"title":{},"description":{"86":{},"87":{}}}],["location.room",{"_index":466,"title":{},"description":{"86":{},"87":{}}}],["lockdown",{"_index":670,"title":{},"description":{"166":{}}}],["log",{"_index":907,"title":{"250":{},"251":{}},"description":{"250":{},"251":{}}}],["logic",{"_index":529,"title":{"113":{},"114":{},"115":{},"116":{},"117":{},"118":{}},"description":{"106":{},"113":{},"114":{},"115":{},"116":{},"117":{},"118":{},"247":{}}}],["longer",{"_index":590,"title":{},"description":{"137":{},"267":{}}}],["low-lat",{"_index":514,"title":{},"description":{"106":{},"113":{}}}],["machin",{"_index":129,"title":{"27":{},"28":{},"29":{},"30":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"149":{},"150":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"173":{}},"description":{"0":{},"1":{},"23":{},"27":{},"28":{},"29":{},"30":{},"32":{},"43":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"100":{},"101":{},"103":{},"106":{},"120":{},"129":{},"135":{},"136":{},"137":{},"138":{},"141":{},"149":{},"150":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"161":{},"162":{},"163":{},"164":{},"166":{},"168":{},"169":{},"170":{},"171":{},"172":{},"173":{},"174":{}}}],["machine'",{"_index":140,"title":{},"description":{"0":{},"79":{},"101":{},"136":{},"137":{},"152":{},"156":{},"165":{},"166":{},"167":{},"168":{},"170":{},"171":{},"172":{}}}],["machine/inst",{"_index":579,"title":{"136":{},"137":{}},"description":{"137":{}}}],["machineassociationid",{"_index":583,"title":{},"description":{"137":{}}}],["machineid",{"_index":586,"title":{},"description":{"137":{}}}],["machines/inst",{"_index":576,"title":{"135":{}},"description":{}}],["main",{"_index":789,"title":{},"description":{"199":{}}}],["maintain",{"_index":37,"title":{},"description":{"0":{},"267":{}}}],["mainten",{"_index":622,"title":{},"description":{"152":{}}}],["make",{"_index":60,"title":{},"description":{"0":{}}}],["malform",{"_index":1025,"title":{},"description":{"264":{}}}],["malformed-bodi",{"_index":1038,"title":{},"description":{"266":{}}}],["manag",{"_index":165,"title":{},"description":{"3":{},"27":{},"31":{},"45":{},"46":{},"60":{},"100":{},"224":{},"225":{},"257":{}}}],["mani",{"_index":820,"title":{},"description":{"205":{},"206":{}}}],["manufactur",{"_index":691,"title":{},"description":{"177":{}}}],["mark",{"_index":772,"title":{},"description":{"198":{}}}],["match",{"_index":242,"title":{},"description":{"12":{},"14":{},"32":{},"89":{},"122":{},"123":{},"124":{},"125":{},"212":{},"257":{},"266":{}}}],["materi",{"_index":493,"title":{},"description":{"100":{},"209":{},"257":{},"265":{},"266":{}}}],["maximum",{"_index":439,"title":{},"description":{"78":{},"79":{}}}],["measur",{"_index":309,"title":{"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"34":{}},"description":{"27":{},"31":{}}}],["measured-boot",{"_index":315,"title":{},"description":{"28":{},"29":{},"30":{},"32":{},"33":{},"34":{}}}],["mechan",{"_index":373,"title":{},"description":{"41":{},"161":{}}}],["meet",{"_index":625,"title":{},"description":{"153":{}}}],["membership",{"_index":233,"title":{},"description":{"11":{},"13":{},"42":{},"44":{},"127":{},"128":{},"130":{}}}],["memori",{"_index":525,"title":{},"description":{"106":{},"113":{},"149":{}}}],["merg",{"_index":918,"title":{},"description":{"254":{}}}],["metadata",{"_index":34,"title":{"252":{},"253":{}},"description":{"0":{},"39":{},"252":{},"253":{},"259":{},"263":{}}}],["mismatch",{"_index":696,"title":{},"description":{"177":{},"178":{},"189":{},"190":{}}}],["miss",{"_index":694,"title":{},"description":{"177":{},"178":{},"189":{},"190":{}}}],["mode",{"_index":52,"title":{},"description":{"0":{},"1":{},"166":{}}}],["model",{"_index":916,"title":{},"description":{"254":{},"256":{}}}],["modifi",{"_index":288,"title":{},"description":{"20":{},"47":{},"232":{}}}],["modul",{"_index":26,"title":{},"description":{"0":{}}}],["more",{"_index":491,"title":{},"description":{"100":{},"127":{},"138":{}}}],["mount",{"_index":764,"title":{},"description":{"197":{},"198":{}}}],["multi-ten",{"_index":414,"title":{},"description":{"57":{},"59":{}}}],["multipl",{"_index":143,"title":{},"description":{"0":{},"78":{},"79":{},"141":{}}}],["mutabl",{"_index":505,"title":{},"description":{"105":{},"203":{}}}],["mutat",{"_index":481,"title":{},"description":{"92":{}}}],["mutual",{"_index":737,"title":{},"description":{"187":{},"191":{},"193":{}}}],["mvp",{"_index":388,"title":{},"description":{"45":{},"46":{}}}],["name",{"_index":135,"title":{},"description":{"0":{},"12":{},"126":{},"141":{},"157":{},"177":{},"181":{},"183":{},"203":{}}}],["name/manufacturer/typ",{"_index":750,"title":{},"description":{"189":{}}}],["nameprefix",{"_index":605,"title":{},"description":{"141":{}}}],["narrow",{"_index":689,"title":{},"description":{"177":{},"205":{},"206":{}}}],["nativ",{"_index":117,"title":{},"description":{"0":{},"60":{},"66":{}}}],["nest",{"_index":187,"title":{},"description":{"6":{}}}],["network",{"_index":84,"title":{"214":{},"215":{},"216":{},"217":{},"218":{},"219":{}},"description":{"0":{},"6":{},"16":{},"41":{},"43":{},"48":{},"54":{},"60":{},"66":{},"95":{},"106":{},"149":{},"156":{},"214":{},"215":{},"216":{},"217":{},"218":{},"219":{},"220":{}}}],["never",{"_index":1012,"title":{},"description":{"261":{},"262":{}}}],["new",{"_index":327,"title":{},"description":{"36":{},"89":{},"197":{},"198":{},"200":{},"203":{},"210":{},"232":{},"254":{},"258":{}}}],["next",{"_index":29,"title":{"212":{}},"description":{"0":{},"28":{},"212":{}}}],["nico",{"_index":23,"title":{},"description":{"0":{},"120":{},"163":{},"257":{},"264":{},"265":{},"267":{}}}],["nico-admin-cli",{"_index":297,"title":{},"description":{"24":{},"36":{},"37":{}}}],["nico-cor",{"_index":562,"title":{},"description":{"126":{},"127":{}}}],["no-auth",{"_index":1006,"title":{},"description":{"261":{}}}],["non-deleg",{"_index":1017,"title":{},"description":{"263":{}}}],["non-empti",{"_index":254,"title":{},"description":{"14":{},"120":{},"265":{}}}],["non-rot",{"_index":953,"title":{},"description":{"257":{}}}],["non-termin",{"_index":717,"title":{},"description":{"185":{},"195":{},"198":{}}}],["normal",{"_index":992,"title":{},"description":{"259":{}}}],["not-configur",{"_index":1037,"title":{},"description":{"266":{}}}],["note",{"_index":90,"title":{},"description":{"0":{}}}],["notic",{"_index":45,"title":{},"description":{"0":{},"267":{}}}],["null",{"_index":446,"title":{},"description":{"79":{},"209":{}}}],["number",{"_index":428,"title":{},"description":{"72":{},"80":{},"94":{},"174":{}}}],["nvlink",{"_index":483,"title":{"113":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"148":{}},"description":{"94":{},"113":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"141":{},"148":{}}}],["nvlinklogicalpartitionid",{"_index":538,"title":{},"description":{"113":{}}}],["nvo",{"_index":484,"title":{},"description":{"94":{}}}],["object",{"_index":264,"title":{},"description":{"14":{},"16":{}}}],["object_id",{"_index":871,"title":{},"description":{"214":{}}}],["objectid",{"_index":872,"title":{},"description":{"214":{}}}],["observ",{"_index":335,"title":{},"description":{"36":{}}}],["octob",{"_index":178,"title":{},"description":{"6":{},"267":{}}}],["offer",{"_index":417,"title":{},"description":{"60":{}}}],["oidc",{"_index":939,"title":{"264":{}},"description":{"257":{},"260":{},"265":{},"266":{}}}],["ok",{"_index":922,"title":{},"description":{"254":{},"258":{},"261":{}}}],["old",{"_index":815,"title":{},"description":{"203":{}}}],["older",{"_index":280,"title":{},"description":{"17":{},"221":{}}}],["omit",{"_index":220,"title":{},"description":{"10":{},"14":{},"79":{},"105":{},"156":{},"185":{},"195":{},"257":{},"259":{},"261":{}}}],["on",{"_index":257,"title":{},"description":{"14":{},"55":{},"56":{},"58":{},"68":{},"100":{},"121":{},"123":{},"127":{},"128":{},"138":{},"203":{},"205":{},"206":{},"259":{}}}],["on-demand",{"_index":664,"title":{"163":{}},"description":{"161":{},"163":{}}}],["onc",{"_index":75,"title":{},"description":{"0":{},"40":{},"260":{}}}],["onlin",{"_index":897,"title":{},"description":{"239":{},"240":{},"243":{},"245":{}}}],["onward",{"_index":92,"title":{},"description":{"0":{}}}],["open",{"_index":857,"title":{},"description":{"212":{}}}],["openbao",{"_index":941,"title":{},"description":{"257":{}}}],["openid",{"_index":1028,"title":{"265":{}},"description":{}}],["oper",{"_index":122,"title":{"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"200":{},"201":{},"202":{},"203":{},"204":{}},"description":{"0":{},"40":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"138":{},"168":{},"196":{},"199":{},"200":{},"201":{},"202":{},"203":{},"204":{},"205":{},"206":{},"211":{},"247":{}}}],["operationcod",{"_index":800,"title":{},"description":{"200":{},"203":{},"204":{}}}],["operationtyp",{"_index":799,"title":{},"description":{"200":{},"203":{},"204":{}}}],["operator-paus",{"_index":854,"title":{},"description":{"211":{}}}],["operator-suppli",{"_index":453,"title":{},"description":{"86":{},"87":{}}}],["opt-in",{"_index":723,"title":{},"description":{"185":{},"195":{}}}],["option",{"_index":241,"title":{},"description":{"12":{},"74":{},"126":{},"127":{},"150":{},"179":{},"181":{},"183":{},"191":{},"193":{},"205":{},"206":{},"212":{},"257":{}}}],["options.phasepolici",{"_index":839,"title":{},"description":{"206":{}}}],["order",{"_index":349,"title":{},"description":{"39":{},"199":{},"254":{}}}],["org",{"_index":134,"title":{"2":{},"4":{},"7":{},"259":{},"262":{},"264":{},"265":{},"266":{}},"description":{"0":{},"2":{},"4":{},"7":{},"11":{},"12":{},"14":{},"15":{},"17":{},"18":{},"21":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"58":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"102":{},"103":{},"104":{},"105":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"121":{},"122":{},"123":{},"124":{},"125":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"215":{},"216":{},"217":{},"218":{},"219":{},"221":{},"222":{},"224":{},"225":{},"226":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"254":{},"255":{},"256":{},"257":{},"258":{},"259":{},"260":{},"261":{},"262":{},"263":{}}}],["org'",{"_index":232,"title":{},"description":{"11":{},"12":{},"13":{},"19":{},"22":{},"42":{},"44":{},"121":{},"122":{},"127":{},"128":{},"130":{},"254":{},"267":{}}}],["org/sit",{"_index":928,"title":{},"description":{"255":{},"256":{},"257":{},"258":{},"261":{},"264":{},"265":{}}}],["organ",{"_index":15,"title":{},"description":{"0":{},"3":{},"6":{},"247":{}}}],["os",{"_index":598,"title":{},"description":{"141":{}}}],["other",{"_index":624,"title":{},"description":{"152":{}}}],["otherwis",{"_index":120,"title":{},"description":{"0":{},"212":{},"261":{}}}],["outcom",{"_index":845,"title":{},"description":{"208":{}}}],["outlin",{"_index":94,"title":{},"description":{"0":{}}}],["over",{"_index":352,"title":{},"description":{"39":{},"185":{},"195":{},"199":{},"201":{},"206":{},"207":{},"209":{},"264":{}}}],["overhead",{"_index":528,"title":{},"description":{"106":{}}}],["overlap",{"_index":958,"title":{},"description":{"257":{},"259":{}}}],["overlay",{"_index":85,"title":{},"description":{"0":{},"220":{}}}],["overrid",{"_index":223,"title":{},"description":{"10":{},"14":{},"169":{},"171":{},"172":{}}}],["overview",{"_index":5,"title":{},"description":{"0":{}}}],["own",{"_index":164,"title":{},"description":{"3":{},"19":{},"22":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"56":{},"102":{},"104":{},"105":{},"121":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"150":{},"151":{},"155":{},"156":{},"162":{},"164":{},"185":{},"195":{},"199":{},"202":{},"204":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"230":{},"231":{},"232":{},"233":{},"234":{},"238":{},"239":{},"240":{},"244":{},"245":{},"246":{}}}],["owner",{"_index":285,"title":{},"description":{"20":{}}}],["ownership",{"_index":554,"title":{},"description":{"122":{}}}],["p-256",{"_index":1024,"title":{},"description":{"264":{}}}],["page",{"_index":351,"title":{},"description":{"39":{}}}],["pagin",{"_index":356,"title":{},"description":{"39":{},"185":{},"195":{},"201":{},"207":{},"209":{}}}],["paramet",{"_index":277,"title":{},"description":{"16":{},"17":{},"74":{},"82":{},"88":{},"96":{},"101":{},"127":{},"137":{},"150":{},"221":{},"267":{}}}],["parseabl",{"_index":976,"title":{},"description":{"257":{}}}],["part",{"_index":57,"title":{},"description":{"0":{},"245":{}}}],["particular",{"_index":781,"title":{},"description":{"199":{},"220":{}}}],["partit",{"_index":511,"title":{"106":{},"107":{},"108":{},"109":{},"110":{},"111":{},"113":{},"114":{},"115":{},"116":{},"117":{},"118":{}},"description":{"106":{},"107":{},"108":{},"109":{},"110":{},"111":{},"113":{},"114":{},"115":{},"116":{},"117":{},"118":{}}}],["past",{"_index":47,"title":{},"description":{"0":{}}}],["patch",{"_index":198,"title":{},"description":{"7":{},"199":{},"203":{},"225":{}}}],["path",{"_index":584,"title":{},"description":{"137":{},"185":{},"195":{},"197":{},"198":{}}}],["paus",{"_index":828,"title":{"210":{}},"description":{"205":{},"210":{},"211":{},"212":{},"257":{},"260":{}}}],["payload",{"_index":728,"title":{},"description":{"185":{},"195":{}}}],["peer",{"_index":407,"title":{"55":{},"56":{},"57":{},"58":{},"59":{}},"description":{"55":{},"56":{},"57":{},"58":{},"59":{}}}],["pend",{"_index":718,"title":{},"description":{"185":{},"195":{},"198":{},"206":{}}}],["per",{"_index":196,"title":{},"description":{"7":{},"40":{},"78":{},"79":{},"199":{},"200":{},"205":{}}}],["per-bmc",{"_index":294,"title":{},"description":{"24":{}}}],["per-compon",{"_index":914,"title":{},"description":{"254":{}}}],["per-component-typ",{"_index":786,"title":{},"description":{"199":{}}}],["per-devic",{"_index":324,"title":{},"description":{"35":{},"37":{}}}],["per-instance-typ",{"_index":652,"title":{"159":{}},"description":{}}],["per-org",{"_index":993,"title":{},"description":{"260":{}}}],["per-phas",{"_index":844,"title":{},"description":{"208":{}}}],["per-rack",{"_index":836,"title":{},"description":{"205":{},"209":{}}}],["per-sit",{"_index":323,"title":{},"description":{"35":{},"126":{}}}],["per-ten",{"_index":207,"title":{"9":{}},"description":{}}],["persist",{"_index":727,"title":{},"description":{"185":{},"195":{}}}],["perspect",{"_index":379,"title":{},"description":{"42":{},"130":{}}}],["pertain",{"_index":214,"title":{},"description":{"10":{}}}],["phase",{"_index":818,"title":{"212":{}},"description":{"205":{},"206":{},"208":{},"211":{},"212":{}}}],["phase'",{"_index":865,"title":{},"description":{"213":{}}}],["physic",{"_index":267,"title":{},"description":{"16":{},"86":{},"87":{},"149":{},"174":{}}}],["pleas",{"_index":21,"title":{},"description":{"0":{},"10":{},"16":{},"41":{},"113":{},"214":{},"246":{},"267":{}}}],["plu",{"_index":548,"title":{},"description":{"121":{}}}],["pod",{"_index":888,"title":{},"description":{"227":{}}}],["point",{"_index":91,"title":{},"description":{"0":{},"265":{}}}],["polici",{"_index":792,"title":{},"description":{"199":{},"214":{},"218":{},"219":{}}}],["policy-g",{"_index":819,"title":{},"description":{"205":{},"206":{}}}],["poll",{"_index":334,"title":{},"description":{"36":{},"206":{}}}],["pool",{"_index":572,"title":{},"description":{"129":{}}}],["portion",{"_index":573,"title":{},"description":{"129":{},"220":{}}}],["possibl",{"_index":389,"title":{},"description":{"47":{}}}],["post",{"_index":732,"title":{},"description":{"185":{},"195":{},"199":{}}}],["post-filt",{"_index":721,"title":{},"description":{"185":{},"195":{},"201":{},"207":{},"209":{}}}],["power",{"_index":447,"title":{"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"154":{},"179":{},"180":{},"191":{},"192":{}},"description":{"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"154":{},"179":{},"180":{},"191":{},"192":{},"196":{}}}],["power_on",{"_index":783,"title":{},"description":{"199":{}}}],["powercontrol",{"_index":782,"title":{},"description":{"199":{}}}],["pre",{"_index":788,"title":{},"description":{"199":{}}}],["pre-exist",{"_index":1003,"title":{},"description":{"261":{}}}],["pre-regist",{"_index":426,"title":{},"description":{"72":{},"73":{},"80":{},"81":{},"86":{},"87":{},"94":{},"95":{}}}],["prefer",{"_index":766,"title":{},"description":{"197":{},"198":{}}}],["prefix",{"_index":109,"title":{"60":{},"61":{},"62":{},"63":{},"64":{},"65":{}},"description":{"0":{},"43":{},"47":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"66":{},"138":{},"220":{}}}],["present",{"_index":286,"title":{},"description":{"20":{},"254":{},"257":{}}}],["preserv",{"_index":194,"title":{},"description":{"7":{},"79":{}}}],["preventalloc",{"_index":678,"title":{},"description":{"168":{}}}],["previou",{"_index":40,"title":{},"description":{"0":{},"257":{},"267":{}}}],["previously-issu",{"_index":995,"title":{},"description":{"260":{}}}],["privileg",{"_index":64,"title":{},"description":{"0":{},"1":{},"19":{},"22":{},"152":{}}}],["proce",{"_index":898,"title":{},"description":{"239":{},"240":{},"245":{}}}],["process",{"_index":369,"title":{},"description":{"40":{},"152":{}}}],["profil",{"_index":318,"title":{"31":{},"32":{},"33":{},"34":{}},"description":{"31":{},"32":{},"33":{},"34":{},"86":{}}}],["progress",{"_index":841,"title":{},"description":{"206":{}}}],["promot",{"_index":313,"title":{},"description":{"27":{},"28":{},"31":{},"32":{}}}],["propag",{"_index":561,"title":{},"description":{"126":{},"127":{},"214":{}}}],["provid",{"_index":3,"title":{"3":{},"4":{},"5":{}},"description":{"0":{},"1":{},"3":{},"4":{},"5":{},"7":{},"9":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"18":{},"19":{},"20":{},"21":{},"22":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"41":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"56":{},"57":{},"58":{},"59":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"84":{},"85":{},"86":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"94":{},"95":{},"96":{},"97":{},"98":{},"99":{},"100":{},"101":{},"102":{},"103":{},"104":{},"105":{},"121":{},"122":{},"123":{},"124":{},"125":{},"127":{},"128":{},"129":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"150":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"220":{},"222":{},"224":{},"225":{},"226":{},"253":{},"254":{},"267":{}}}],["provider'",{"_index":552,"title":{},"description":{"121":{},"267":{}}}],["provider-own",{"_index":549,"title":{},"description":{"121":{},"122":{},"123":{}}}],["provider/p",{"_index":197,"title":{},"description":{"7":{}}}],["provider_admin",{"_index":167,"title":{},"description":{"4":{},"5":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"26":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"36":{},"37":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"56":{},"57":{},"58":{},"59":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"102":{},"103":{},"104":{},"105":{},"121":{},"122":{},"123":{},"124":{},"125":{},"127":{},"128":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"221":{},"222":{},"223":{},"224":{},"225":{},"226":{},"250":{},"251":{},"254":{},"255":{},"256":{}}}],["provider_view",{"_index":234,"title":{},"description":{"11":{},"13":{},"74":{},"75":{},"82":{},"83":{},"88":{},"91":{},"96":{},"97":{},"103":{},"127":{},"128":{},"170":{}}}],["provis",{"_index":592,"title":{},"description":{"138":{}}}],["public",{"_index":900,"title":{},"description":{"241":{},"257":{},"264":{},"265":{}}}],["publish",{"_index":326,"title":{},"description":{"36":{}}}],["pull",{"_index":726,"title":{},"description":{"185":{},"195":{}}}],["put",{"_index":917,"title":{},"description":{"254":{},"257":{},"259":{},"260":{},"261":{}}}],["queri",{"_index":276,"title":{},"description":{"16":{},"17":{},"74":{},"82":{},"88":{},"96":{},"101":{},"127":{},"150":{},"187":{},"221":{},"267":{}}}],["queue",{"_index":365,"title":{},"description":{"40":{}}}],["quick",{"_index":4,"title":{},"description":{"0":{}}}],["rack",{"_index":452,"title":{"86":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"174":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{}},"description":{"86":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"174":{},"175":{},"176":{},"177":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"186":{},"187":{},"189":{},"196":{},"204":{},"205":{},"206":{},"209":{}}}],["rack'",{"_index":698,"title":{},"description":{"178":{}}}],["rack-level",{"_index":742,"title":{},"description":{"187":{},"191":{},"193":{}}}],["rack/task/{id",{"_index":731,"title":{},"description":{"185":{},"195":{}}}],["rack/task/{id}/cancel",{"_index":733,"title":{},"description":{"185":{},"195":{}}}],["rackid",{"_index":468,"title":{},"description":{"87":{},"89":{},"92":{},"187":{},"191":{},"193":{}}}],["rackid/racknam",{"_index":749,"title":{},"description":{"189":{}}}],["rackid`/`racknam",{"_index":739,"title":{},"description":{"187":{},"191":{},"193":{}}}],["rackleveladministr",{"_index":272,"title":{},"description":{"16":{},"267":{}}}],["racknam",{"_index":736,"title":{},"description":{"187":{},"191":{},"193":{}}}],["random",{"_index":606,"title":{},"description":{"141":{}}}],["raw",{"_index":1011,"title":{},"description":{"261":{},"262":{}}}],["rdma",{"_index":522,"title":{},"description":{"106":{}}}],["re-explor",{"_index":366,"title":{},"description":{"40":{}}}],["re-provis",{"_index":673,"title":{},"description":{"167":{}}}],["re-suppli",{"_index":1007,"title":{},"description":{"261":{}}}],["re-valid",{"_index":811,"title":{},"description":{"203":{}}}],["read",{"_index":558,"title":{},"description":{"123":{}}}],["read-onli",{"_index":191,"title":{},"description":{"7":{},"126":{}}}],["readi",{"_index":65,"title":{},"description":{"0":{},"1":{},"6":{},"7":{}}}],["readme](https://github.com/nvidia/infra-controller/tree/main/rest-api/auth",{"_index":27,"title":{},"description":{"0":{}}}],["receiv",{"_index":151,"title":{},"description":{"0":{},"150":{}}}],["recent",{"_index":271,"title":{},"description":{"16":{},"267":{}}}],["record",{"_index":504,"title":{},"description":{"104":{},"105":{},"126":{},"185":{},"195":{},"249":{}}}],["reduc",{"_index":526,"title":{},"description":{"106":{}}}],["refer",{"_index":399,"title":{},"description":{"47":{},"86":{},"89":{},"126":{},"209":{}}}],["referenc",{"_index":115,"title":{},"description":{"0":{},"156":{}}}],["reflect",{"_index":984,"title":{},"description":{"259":{}}}],["refresh",{"_index":997,"title":{},"description":{"260":{}}}],["regist",{"_index":999,"title":{},"description":{"261":{},"262":{}}}],["reject",{"_index":260,"title":{},"description":{"14":{},"54":{},"92":{},"204":{},"212":{},"265":{}}}],["relationship",{"_index":215,"title":{},"description":{"10":{}}}],["remot",{"_index":523,"title":{},"description":{"106":{}}}],["remov",{"_index":177,"title":{},"description":{"6":{},"10":{},"16":{},"41":{},"113":{},"172":{},"214":{},"240":{},"246":{},"254":{},"267":{}}}],["renam",{"_index":585,"title":{},"description":{"137":{}}}],["repeat",{"_index":258,"title":{},"description":{"14":{},"254":{}}}],["replac",{"_index":252,"title":{"89":{}},"description":{"14":{},"89":{}}}],["report",{"_index":189,"title":{"169":{},"170":{},"171":{},"172":{}},"description":{"6":{},"28":{},"32":{},"35":{},"37":{},"126":{},"168":{},"169":{},"170":{},"171":{},"172":{},"177":{},"178":{},"185":{},"189":{},"190":{},"195":{},"201":{},"207":{},"209":{}}}],["repres",{"_index":497,"title":{},"description":{"101":{},"103":{},"186":{},"196":{}}}],["represents/contain",{"_index":212,"title":{},"description":{"10":{}}}],["reprovis",{"_index":672,"title":{"167":{},"168":{}},"description":{"167":{},"168":{}}}],["request",{"_index":238,"title":{},"description":{"12":{},"14":{},"15":{},"26":{},"45":{},"47":{},"54":{},"78":{},"79":{},"89":{},"101":{},"105":{},"120":{},"122":{},"141":{},"151":{},"152":{},"155":{},"166":{},"200":{},"225":{},"255":{},"256":{},"263":{}}}],["requir",{"_index":279,"title":{},"description":{"17":{},"47":{},"82":{},"88":{},"96":{},"101":{},"136":{},"187":{},"191":{},"193":{},"221":{},"257":{},"261":{},"264":{},"265":{},"266":{}}}],["reset",{"_index":667,"title":{"165":{},"166":{}},"description":{"165":{},"166":{}}}],["resourc",{"_index":72,"title":{},"description":{"0":{},"3":{},"6":{},"16":{},"41":{},"47":{}}}],["resourcetypeid",{"_index":375,"title":{},"description":{"41":{}}}],["respond",{"_index":975,"title":{},"description":{"257":{}}}],["respons",{"_index":350,"title":{},"description":{"39":{},"120":{},"156":{},"185":{},"195":{},"200":{},"201":{},"206":{},"207":{},"209":{},"259":{}}}],["rest",{"_index":24,"title":{},"description":{"0":{},"126":{},"156":{},"187":{},"267":{}}}],["restrict",{"_index":436,"title":{},"description":{"74":{},"127":{},"150":{},"156":{},"185":{},"187":{},"195":{}}}],["result",{"_index":202,"title":{"164":{}},"description":{"7":{},"42":{},"74":{},"130":{},"150":{},"164":{},"185":{},"195":{},"201":{},"207":{},"209":{},"226":{},"267":{}}}],["resum",{"_index":833,"title":{"211":{}},"description":{"205":{},"210":{},"211":{}}}],["retain",{"_index":506,"title":{},"description":{"105":{}}}],["retri",{"_index":791,"title":{},"description":{"199":{}}}],["retriev",{"_index":32,"title":{"2":{},"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"13":{},"17":{},"19":{},"22":{},"29":{},"33":{},"39":{},"42":{},"44":{},"49":{},"51":{},"56":{},"58":{},"61":{},"63":{},"67":{},"69":{},"74":{},"75":{},"82":{},"83":{},"88":{},"91":{},"96":{},"97":{},"101":{},"103":{},"107":{},"109":{},"112":{},"114":{},"116":{},"119":{},"121":{},"123":{},"128":{},"130":{},"132":{},"135":{},"139":{},"142":{},"145":{},"146":{},"147":{},"148":{},"150":{},"151":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"162":{},"164":{},"170":{},"175":{},"176":{},"185":{},"187":{},"188":{},"195":{},"197":{},"202":{},"207":{},"208":{},"209":{},"215":{},"217":{},"221":{},"223":{},"226":{},"228":{},"230":{},"233":{},"236":{},"238":{},"242":{},"244":{},"248":{},"250":{},"251":{},"253":{},"259":{},"262":{},"264":{},"265":{},"266":{}},"description":{"0":{},"2":{},"4":{},"5":{},"7":{},"8":{},"11":{},"13":{},"17":{},"19":{},"22":{},"29":{},"33":{},"39":{},"42":{},"44":{},"49":{},"51":{},"61":{},"63":{},"67":{},"69":{},"74":{},"75":{},"82":{},"83":{},"88":{},"91":{},"96":{},"97":{},"101":{},"103":{},"107":{},"109":{},"114":{},"116":{},"126":{},"128":{},"156":{},"162":{},"164":{},"196":{},"205":{},"221":{},"223":{},"226":{},"228":{},"230":{},"233":{},"236":{},"238":{},"242":{},"244":{},"248":{},"251":{},"253":{},"259":{},"262":{}}}],["return",{"_index":149,"title":{},"description":{"0":{},"6":{},"7":{},"9":{},"37":{},"39":{},"42":{},"121":{},"126":{},"130":{},"132":{},"157":{},"158":{},"159":{},"177":{},"178":{},"189":{},"190":{},"198":{},"213":{},"254":{},"257":{},"258":{},"260":{},"261":{},"262":{},"264":{},"265":{}}}],["reus",{"_index":978,"title":{},"description":{"258":{}}}],["reusabl",{"_index":793,"title":{},"description":{"199":{}}}],["revert",{"_index":1016,"title":{},"description":{"263":{}}}],["rfc",{"_index":932,"title":{},"description":{"257":{},"261":{},"263":{},"264":{}}}],["role",{"_index":17,"title":{},"description":{"0":{},"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"26":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"36":{},"37":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"56":{},"57":{},"58":{},"59":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"102":{},"103":{},"104":{},"105":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"121":{},"122":{},"123":{},"124":{},"125":{},"127":{},"128":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"215":{},"216":{},"217":{},"218":{},"219":{},"221":{},"222":{},"223":{},"224":{},"225":{},"226":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"250":{},"251":{},"254":{},"255":{},"256":{},"257":{},"258":{},"259":{},"260":{},"261":{},"262":{},"263":{}}}],["root",{"_index":295,"title":{},"description":{"24":{},"222":{},"224":{},"225":{}}}],["rotat",{"_index":321,"title":{"35":{},"36":{},"37":{}},"description":{"35":{},"36":{},"37":{},"257":{},"264":{}}}],["rotate-to",{"_index":328,"title":{},"description":{"36":{}}}],["rotatekey",{"_index":980,"title":{},"description":{"258":{}}}],["rotation-statu",{"_index":342,"title":{},"description":{"37":{}}}],["rout",{"_index":969,"title":{},"description":{"257":{}}}],["row",{"_index":566,"title":{},"description":{"126":{}}}],["rule",{"_index":780,"title":{"199":{},"200":{},"201":{},"202":{},"203":{},"204":{}},"description":{"199":{},"200":{},"201":{},"202":{},"203":{},"204":{}}}],["ruledefinit",{"_index":807,"title":{},"description":{"203":{}}}],["run",{"_index":663,"title":{"162":{},"163":{},"205":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{}},"description":{"161":{},"162":{},"163":{},"185":{},"195":{},"196":{},"198":{},"205":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"227":{}}}],["run'",{"_index":848,"title":{},"description":{"209":{}}}],["safeti",{"_index":826,"title":{},"description":{"205":{}}}],["same",{"_index":58,"title":{},"description":{"0":{},"55":{},"57":{},"78":{},"79":{},"89":{},"141":{},"152":{},"197":{},"198":{},"266":{}}}],["satisfi",{"_index":384,"title":{},"description":{"43":{}}}],["save",{"_index":503,"title":{},"description":{"104":{},"105":{}}}],["schedul",{"_index":638,"title":{},"description":{"156":{}}}],["schema",{"_index":508,"title":{},"description":{"105":{}}}],["scope",{"_index":690,"title":{},"description":{"177":{},"189":{},"267":{}}}],["script",{"_index":127,"title":{},"description":{"0":{},"120":{}}}],["secret",{"_index":329,"title":{},"description":{"36":{},"261":{}}}],["section",{"_index":2,"title":{},"description":{"0":{}}}],["secur",{"_index":869,"title":{"214":{},"215":{},"216":{},"217":{},"218":{},"219":{}},"description":{"214":{},"215":{},"216":{},"217":{},"218":{},"219":{}}}],["see",{"_index":981,"title":{},"description":{"258":{},"264":{}}}],["select",{"_index":305,"title":{},"description":{"26":{},"105":{},"205":{}}}],["selector",{"_index":822,"title":{},"description":{"205":{},"206":{}}}],["semant",{"_index":982,"title":{},"description":{"258":{}}}],["sensit",{"_index":636,"title":{},"description":{"156":{}}}],["sent",{"_index":249,"title":{},"description":{"14":{}}}],["separ",{"_index":623,"title":{},"description":{"152":{}}}],["septemb",{"_index":227,"title":{},"description":{"10":{}}}],["seri",{"_index":659,"title":{},"description":{"161":{}}}],["serial",{"_index":427,"title":{},"description":{"72":{},"80":{},"94":{},"235":{},"241":{}}}],["serv",{"_index":937,"title":{},"description":{"257":{}}}],["server",{"_index":518,"title":{"253":{}},"description":{"106":{},"149":{},"253":{},"261":{}}}],["server-sid",{"_index":795,"title":{},"description":{"200":{},"203":{},"206":{}}}],["servic",{"_index":50,"title":{"1":{},"2":{},"227":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{}},"description":{"0":{},"1":{},"2":{},"227":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"252":{},"263":{}}}],["set",{"_index":245,"title":{},"description":{"12":{},"37":{},"79":{},"89":{},"123":{},"124":{},"125":{},"150":{},"185":{},"195":{},"199":{},"201":{},"205":{},"206":{},"207":{},"208":{},"209":{},"212":{},"218":{},"257":{},"264":{}}}],["sever",{"_index":724,"title":{},"description":{"185":{},"195":{},"235":{}}}],["sha-256",{"_index":1014,"title":{},"description":{"262":{}}}],["share",{"_index":537,"title":{},"description":{"113":{},"141":{}}}],["shelf",{"_index":448,"title":{"80":{},"81":{},"83":{},"84":{},"85":{}},"description":{"80":{},"81":{},"83":{},"84":{},"85":{}}}],["shelv",{"_index":449,"title":{"82":{}},"description":{"80":{},"81":{},"82":{},"83":{},"84":{},"85":{}}}],["short-liv",{"_index":1000,"title":{},"description":{"261":{}}}],["show",{"_index":693,"title":{},"description":{"177":{},"178":{},"189":{},"190":{}}}],["sig",{"_index":1023,"title":{},"description":{"264":{}}}],["sign",{"_index":934,"title":{},"description":{"257":{},"258":{},"259":{},"260":{},"261":{},"263":{}}}],["signatur",{"_index":1021,"title":{},"description":{"264":{},"265":{}}}],["signingkey",{"_index":991,"title":{},"description":{"259":{}}}],["silent",{"_index":669,"title":{},"description":{"166":{}}}],["similar",{"_index":495,"title":{},"description":{"100":{}}}],["singl",{"_index":106,"title":{},"description":{"0":{},"78":{},"79":{},"141":{}}}],["single-task",{"_index":730,"title":{},"description":{"185":{},"195":{}}}],["single-ten",{"_index":413,"title":{},"description":{"57":{}}}],["site",{"_index":81,"title":{"9":{},"16":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"38":{},"40":{},"153":{},"157":{},"158":{},"159":{}},"description":{"0":{},"3":{},"6":{},"7":{},"9":{},"10":{},"14":{},"16":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"23":{},"25":{},"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"34":{},"38":{},"39":{},"40":{},"55":{},"56":{},"57":{},"58":{},"59":{},"60":{},"66":{},"72":{},"73":{},"74":{},"78":{},"79":{},"80":{},"81":{},"86":{},"87":{},"89":{},"90":{},"94":{},"95":{},"100":{},"101":{},"102":{},"103":{},"104":{},"105":{},"121":{},"123":{},"126":{},"127":{},"128":{},"149":{},"150":{},"151":{},"152":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"163":{},"166":{},"168":{},"170":{},"171":{},"172":{},"174":{},"175":{},"177":{},"179":{},"181":{},"183":{},"185":{},"187":{},"189":{},"191":{},"193":{},"195":{},"197":{},"198":{},"199":{},"200":{},"201":{},"202":{},"204":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"220":{},"235":{},"239":{},"240":{},"243":{},"245":{},"254":{},"255":{},"256":{},"257":{},"267":{}}}],["site'",{"_index":283,"title":{},"description":{"19":{},"22":{},"73":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"103":{},"156":{}}}],["site-default",{"_index":301,"title":{},"description":{"25":{},"26":{}}}],["site-level",{"_index":78,"title":{},"description":{"0":{},"43":{}}}],["site-scop",{"_index":713,"title":{},"description":{"185":{},"195":{},"196":{},"197":{},"198":{},"200":{},"202":{},"204":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{}}}],["site-specif",{"_index":287,"title":{},"description":{"20":{}}}],["site-wid",{"_index":293,"title":{},"description":{"24":{},"35":{},"36":{},"37":{}}}],["sitecap",{"_index":66,"title":{},"description":{"0":{},"1":{},"7":{},"10":{},"14":{}}}],["siteid",{"_index":221,"title":{},"description":{"10":{},"14":{},"74":{},"82":{},"88":{},"89":{},"96":{},"101":{},"126":{},"127":{},"150":{},"185":{},"195":{},"197":{},"198":{},"202":{},"204":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"255":{},"256":{},"267":{}}}],["six",{"_index":942,"title":{},"description":{"257":{}}}],["size",{"_index":440,"title":{},"description":{"78":{},"79":{}}}],["sku",{"_index":487,"title":{"100":{},"101":{},"102":{},"103":{},"104":{},"105":{}},"description":{"100":{},"101":{},"102":{},"103":{},"104":{},"105":{}}}],["sku'",{"_index":500,"title":{},"description":{"103":{},"104":{},"105":{}}}],["slot",{"_index":746,"title":{},"description":{"187":{}}}],["slotid",{"_index":745,"title":{},"description":{"187":{}}}],["sourc",{"_index":385,"title":{},"description":{"43":{}}}],["specif",{"_index":253,"title":{},"description":{"14":{},"19":{},"20":{},"21":{},"22":{},"51":{},"52":{},"63":{},"64":{},"69":{},"70":{},"75":{},"83":{},"91":{},"97":{},"103":{},"109":{},"110":{},"116":{},"117":{},"154":{},"162":{},"164":{},"166":{},"170":{},"171":{},"172":{},"177":{},"189":{},"226":{},"231":{},"232":{},"233":{},"234":{},"239":{},"240":{},"251":{},"257":{},"267":{}}}],["specifi",{"_index":125,"title":{},"description":{"0":{},"9":{},"12":{},"15":{},"45":{},"47":{},"68":{},"152":{},"157":{},"158":{},"159":{},"175":{},"177":{},"179":{},"181":{},"183":{},"185":{},"187":{},"189":{},"191":{},"193":{},"195":{},"218":{},"225":{},"243":{},"255":{},"256":{}}}],["spiff",{"_index":1034,"title":{"266":{}},"description":{"266":{}}}],["spiffe-n",{"_index":1036,"title":{},"description":{"266":{}}}],["spread",{"_index":604,"title":{},"description":{"141":{}}}],["ssh",{"_index":599,"title":{"235":{},"236":{},"237":{},"238":{},"239":{},"240":{},"241":{},"242":{},"243":{},"244":{},"245":{},"246":{}},"description":{"141":{},"235":{},"236":{},"237":{},"238":{},"239":{},"240":{},"241":{},"242":{},"243":{},"244":{},"245":{},"246":{}}}],["stabl",{"_index":563,"title":{},"description":{"126":{},"128":{}}}],["stage",{"_index":322,"title":{},"description":{"35":{},"36":{},"199":{}}}],["stale",{"_index":861,"title":{},"description":{"212":{}}}],["standard",{"_index":515,"title":{},"description":{"106":{}}}],["start",{"_index":1,"title":{"0":{}},"description":{"0":{},"47":{},"206":{},"213":{}}}],["stat",{"_index":170,"title":{"5":{},"8":{},"9":{},"157":{},"159":{}},"description":{"5":{},"8":{},"9":{},"157":{},"159":{}}}],["state",{"_index":346,"title":{},"description":{"38":{},"163":{},"177":{},"178":{},"179":{},"180":{},"185":{},"189":{},"190":{},"191":{},"192":{},"195":{},"196":{},"198":{},"200":{},"206":{},"213":{}}}],["statu",{"_index":158,"title":{"2":{},"22":{},"37":{},"145":{},"155":{}},"description":{"2":{},"12":{},"14":{},"22":{},"36":{},"145":{},"158":{}}}],["step",{"_index":10,"title":{},"description":{"0":{},"200":{}}}],["still",{"_index":716,"title":{},"description":{"185":{},"195":{},"204":{}}}],["stock",{"_index":488,"title":{},"description":{"100":{},"101":{},"103":{}}}],["stop",{"_index":370,"title":{},"description":{"40":{}}}],["storag",{"_index":519,"title":{},"description":{"106":{},"149":{}}}],["store",{"_index":985,"title":{},"description":{"259":{},"261":{}}}],["strict",{"_index":1030,"title":{},"description":{"265":{}}}],["string",{"_index":469,"title":{},"description":{"87":{}}}],["structur",{"_index":16,"title":{},"description":{"0":{}}}],["subjectprefix",{"_index":989,"title":{},"description":{"259":{}}}],["submit",{"_index":803,"title":{},"description":{"200":{},"209":{}}}],["subnet",{"_index":114,"title":{"66":{},"67":{},"68":{},"69":{},"70":{},"71":{}},"description":{"0":{},"47":{},"54":{},"66":{},"67":{},"68":{},"69":{},"70":{},"71":{},"138":{}}}],["subscriptionid",{"_index":225,"title":{},"description":{"10":{}}}],["subscriptionti",{"_index":226,"title":{},"description":{"10":{}}}],["subsequ",{"_index":923,"title":{},"description":{"254":{},"258":{},"261":{},"263":{}}}],["succe",{"_index":582,"title":{},"description":{"136":{}}}],["succeed",{"_index":778,"title":{},"description":{"198":{}}}],["success",{"_index":927,"title":{},"description":{"254":{}}}],["successfulli",{"_index":381,"title":{},"description":{"43":{}}}],["suffix",{"_index":168,"title":{},"description":{"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"26":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"36":{},"37":{},"39":{},"40":{},"42":{},"43":{},"44":{},"46":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"56":{},"57":{},"58":{},"59":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"102":{},"103":{},"104":{},"105":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"121":{},"123":{},"124":{},"125":{},"127":{},"128":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"152":{},"153":{},"154":{},"156":{},"157":{},"158":{},"159":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"215":{},"216":{},"217":{},"218":{},"219":{},"221":{},"222":{},"223":{},"224":{},"226":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"250":{},"251":{},"254":{},"255":{},"256":{},"257":{},"258":{},"259":{},"260":{},"261":{},"262":{},"263":{}}}],["summari",{"_index":645,"title":{"158":{}},"description":{"157":{}}}],["super",{"_index":881,"title":{},"description":{"226":{}}}],["superset",{"_index":580,"title":{},"description":{"136":{}}}],["suppli",{"_index":250,"title":{},"description":{"14":{},"254":{},"258":{}}}],["support",{"_index":116,"title":{},"description":{"0":{},"45":{},"46":{},"60":{},"66":{},"179":{},"180":{},"191":{},"192":{},"227":{}}}],["surviv",{"_index":952,"title":{},"description":{"257":{}}}],["switch",{"_index":482,"title":{"94":{},"95":{},"96":{},"97":{},"98":{},"99":{}},"description":{"94":{},"95":{},"96":{},"97":{},"98":{},"99":{},"261":{}}}],["sync",{"_index":893,"title":{},"description":{"235":{}}}],["synchron",{"_index":639,"title":{},"description":{"156":{}}}],["system",{"_index":123,"title":{"120":{},"121":{},"122":{},"123":{},"124":{},"125":{}},"description":{"0":{},"31":{},"32":{},"100":{},"106":{},"120":{},"121":{},"122":{},"123":{},"124":{},"125":{},"126":{},"138":{},"253":{}}}],["system-level",{"_index":910,"title":{},"description":{"252":{}}}],["tag",{"_index":760,"title":{},"description":{"196":{},"199":{},"205":{},"258":{},"264":{}}}],["taken",{"_index":906,"title":{},"description":{"249":{}}}],["target",{"_index":331,"title":{"209":{}},"description":{"36":{},"179":{},"181":{},"183":{},"185":{},"187":{},"191":{},"193":{},"195":{},"200":{},"205":{},"209":{},"210":{},"213":{},"255":{},"256":{}}}],["target'",{"_index":837,"title":{},"description":{"205":{}}}],["targetedinstancecr",{"_index":67,"title":{},"description":{"0":{},"7":{},"10":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"103":{},"150":{},"152":{},"156":{},"166":{},"168":{},"170":{},"171":{},"172":{}}}],["task",{"_index":712,"title":{"185":{},"195":{},"196":{},"197":{},"198":{},"205":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{}},"description":{"185":{},"195":{},"196":{},"197":{},"198":{},"205":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{}}}],["task/run/{id",{"_index":840,"title":{},"description":{"206":{}}}],["task/{taskid",{"_index":849,"title":{},"description":{"209":{}}}],["taskid",{"_index":838,"title":{},"description":{"205":{},"209":{}}}],["templat",{"_index":557,"title":{"126":{},"127":{},"128":{}},"description":{"122":{},"126":{},"127":{},"128":{},"199":{}}}],["tempor",{"_index":640,"title":{},"description":{"156":{},"198":{}}}],["tenant",{"_index":56,"title":{"6":{},"7":{},"8":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"257":{},"258":{},"259":{},"260":{}},"description":{"0":{},"1":{},"6":{},"7":{},"8":{},"9":{},"10":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"18":{},"19":{},"20":{},"22":{},"41":{},"42":{},"44":{},"45":{},"46":{},"47":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"56":{},"57":{},"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"66":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"103":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"121":{},"122":{},"123":{},"124":{},"125":{},"127":{},"128":{},"129":{},"130":{},"132":{},"138":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"150":{},"151":{},"152":{},"155":{},"156":{},"159":{},"166":{},"168":{},"170":{},"171":{},"172":{},"215":{},"216":{},"217":{},"218":{},"219":{},"220":{},"222":{},"224":{},"225":{},"226":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"257":{},"258":{},"259":{},"260":{},"261":{},"262":{},"263":{},"264":{},"267":{}}}],["tenant'",{"_index":243,"title":{},"description":{"12":{},"48":{},"121":{},"151":{},"155":{},"261":{}}}],["tenant-identity/config",{"_index":943,"title":{},"description":{"257":{},"261":{}}}],["tenant-identity/token-deleg",{"_index":944,"title":{},"description":{"257":{}}}],["tenant-level",{"_index":157,"title":{},"description":{"1":{}}}],["tenant-own",{"_index":555,"title":{},"description":{"122":{}}}],["tenant/account/{accountid",{"_index":199,"title":{},"description":{"7":{}}}],["tenant/curr",{"_index":184,"title":{},"description":{"6":{}}}],["tenant_admin",{"_index":204,"title":{},"description":{"7":{},"8":{},"11":{},"13":{},"14":{},"17":{},"19":{},"22":{},"42":{},"44":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"56":{},"57":{},"58":{},"59":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"101":{},"103":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"121":{},"122":{},"123":{},"124":{},"125":{},"127":{},"128":{},"130":{},"132":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"151":{},"152":{},"155":{},"156":{},"166":{},"168":{},"170":{},"171":{},"172":{},"215":{},"216":{},"217":{},"218":{},"219":{},"221":{},"223":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"250":{},"251":{},"257":{},"258":{},"259":{},"260":{},"261":{},"262":{},"263":{}}}],["tenantaccount.sitecap",{"_index":176,"title":{},"description":{"6":{},"267":{}}}],["tenantcontactid",{"_index":251,"title":{},"description":{"14":{}}}],["tenantid",{"_index":263,"title":{},"description":{"14":{},"17":{},"122":{},"123":{},"124":{},"125":{},"221":{}}}],["tenantsummary.cap",{"_index":186,"title":{},"description":{"6":{}}}],["termin",{"_index":773,"title":{},"description":{"198":{}}}],["test",{"_index":660,"title":{},"description":{"161":{}}}],["three",{"_index":945,"title":{},"description":{"257":{}}}],["threshold",{"_index":830,"title":{},"description":{"205":{}}}],["through",{"_index":658,"title":{},"description":{"161":{}}}],["time",{"_index":160,"title":{},"description":{"2":{},"47":{},"137":{},"152":{}}}],["timeout",{"_index":790,"title":{},"description":{"199":{}}}],["togeth",{"_index":892,"title":{},"description":{"235":{},"254":{}}}],["token",{"_index":14,"title":{"261":{},"262":{},"263":{}},"description":{"0":{},"257":{},"261":{},"262":{},"263":{}}}],["toml",{"_index":87,"title":{},"description":{"0":{}}}],["top-level",{"_index":474,"title":{},"description":{"89":{}}}],["topologyoptim",{"_index":601,"title":{},"description":{"141":{}}}],["total",{"_index":720,"title":{},"description":{"185":{},"195":{},"201":{},"207":{},"209":{}}}],["track",{"_index":345,"title":{},"description":{"38":{},"126":{}}}],["traffic",{"_index":870,"title":{},"description":{"214":{}}}],["transact",{"_index":597,"title":{},"description":{"141":{}}}],["transit",{"_index":859,"title":{},"description":{"212":{}}}],["tray",{"_index":735,"title":{"186":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{}},"description":{"186":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"196":{}}}],["treat",{"_index":954,"title":{},"description":{"257":{}}}],["trigger",{"_index":360,"title":{"40":{}},"description":{"168":{}}}],["true",{"_index":193,"title":{},"description":{"7":{},"141":{},"154":{},"166":{},"168":{},"258":{}}}],["trust",{"_index":311,"title":{"27":{},"28":{},"29":{},"30":{},"31":{},"32":{},"33":{},"34":{}},"description":{"27":{},"29":{},"30":{},"31":{},"33":{},"34":{},"259":{}}}],["trust-domain",{"_index":1035,"title":{},"description":{"266":{}}}],["tupl",{"_index":801,"title":{},"description":{"200":{},"204":{}}}],["turn",{"_index":825,"title":{},"description":{"205":{}}}],["two",{"_index":412,"title":{},"description":{"57":{},"257":{},"259":{}}}],["type",{"_index":137,"title":{"9":{},"129":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"158":{}},"description":{"0":{},"9":{},"43":{},"54":{},"122":{},"129":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"152":{},"158":{},"159":{},"173":{},"187":{},"191":{},"193":{},"227":{},"254":{}}}],["type'",{"_index":581,"title":{},"description":{"136":{}}}],["type/machin",{"_index":144,"title":{},"description":{"0":{}}}],["typic",{"_index":95,"title":{},"description":{"0":{},"120":{}}}],["uefi",{"_index":300,"title":{"25":{},"26":{}},"description":{"25":{},"26":{}}}],["un-default",{"_index":817,"title":{},"description":{"204":{}}}],["unalloc",{"_index":383,"title":{},"description":{"43":{}}}],["unassign",{"_index":648,"title":{},"description":{"158":{}}}],["unchang",{"_index":810,"title":{},"description":{"203":{}}}],["under",{"_index":762,"title":{},"description":{"196":{}}}],["underli",{"_index":774,"title":{},"description":{"198":{}}}],["union",{"_index":551,"title":{},"description":{"121":{}}}],["uniqu",{"_index":470,"title":{},"description":{"87":{},"89":{},"101":{},"103":{},"126":{}}}],["unit",{"_index":490,"title":{},"description":{"100":{},"101":{},"103":{}}}],["unknown",{"_index":968,"title":{},"description":{"257":{}}}],["unless",{"_index":979,"title":{},"description":{"258":{}}}],["unset",{"_index":808,"title":{},"description":{"203":{}}}],["until",{"_index":588,"title":{},"description":{"137":{},"205":{},"209":{},"210":{},"257":{}}}],["untouch",{"_index":813,"title":{},"description":{"203":{}}}],["unus",{"_index":502,"title":{},"description":{"104":{}}}],["unverifi",{"_index":996,"title":{},"description":{"260":{}}}],["up",{"_index":709,"title":{"183":{},"184":{}},"description":{"183":{},"184":{}}}],["updat",{"_index":139,"title":{"14":{},"20":{},"24":{},"46":{},"47":{},"53":{},"54":{},"65":{},"71":{},"76":{},"79":{},"84":{},"92":{},"98":{},"105":{},"111":{},"117":{},"125":{},"134":{},"144":{},"152":{},"171":{},"181":{},"182":{},"193":{},"194":{},"203":{},"218":{},"225":{},"232":{},"240":{},"246":{},"255":{},"258":{},"261":{}},"description":{"0":{},"10":{},"12":{},"14":{},"20":{},"23":{},"24":{},"46":{},"47":{},"53":{},"54":{},"65":{},"71":{},"76":{},"79":{},"84":{},"89":{},"92":{},"98":{},"100":{},"105":{},"111":{},"117":{},"120":{},"125":{},"134":{},"144":{},"152":{},"171":{},"181":{},"182":{},"193":{},"194":{},"196":{},"218":{},"225":{},"232":{},"240":{},"246":{},"254":{},"255":{},"258":{},"261":{}}}],["upgrad",{"_index":785,"title":{},"description":{"199":{}}}],["upsert",{"_index":949,"title":{},"description":{"257":{},"258":{}}}],["upserthostfirmwareconfig",{"_index":919,"title":{},"description":{"254":{}}}],["uri",{"_index":1029,"title":{},"description":{"265":{}}}],["url",{"_index":883,"title":{},"description":{"226":{},"254":{},"255":{},"256":{},"257":{},"258":{},"259":{},"260":{},"261":{},"262":{},"263":{}}}],["us",{"_index":11,"title":{},"description":{"0":{},"7":{},"10":{},"16":{},"28":{},"39":{},"41":{},"60":{},"66":{},"72":{},"80":{},"94":{},"106":{},"113":{},"120":{},"141":{},"173":{},"189":{},"205":{},"214":{},"220":{},"235":{},"241":{},"246":{},"254":{},"257":{},"264":{},"265":{},"266":{},"267":{}}}],["usag",{"_index":229,"title":{},"description":{"10":{}}}],["useipmitool",{"_index":668,"title":{},"description":{"166":{}}}],["user",{"_index":53,"title":{"247":{},"248":{}},"description":{"0":{},"1":{},"4":{},"5":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"24":{},"26":{},"28":{},"29":{},"30":{},"32":{},"33":{},"34":{},"36":{},"37":{},"39":{},"40":{},"42":{},"43":{},"44":{},"45":{},"46":{},"47":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"56":{},"57":{},"58":{},"59":{},"61":{},"62":{},"63":{},"64":{},"65":{},"67":{},"68":{},"69":{},"70":{},"71":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"79":{},"81":{},"82":{},"83":{},"84":{},"85":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{},"95":{},"96":{},"97":{},"98":{},"99":{},"101":{},"102":{},"103":{},"104":{},"105":{},"107":{},"108":{},"109":{},"110":{},"111":{},"112":{},"114":{},"115":{},"116":{},"117":{},"118":{},"119":{},"121":{},"123":{},"124":{},"125":{},"127":{},"128":{},"130":{},"131":{},"132":{},"133":{},"134":{},"135":{},"136":{},"137":{},"139":{},"140":{},"141":{},"142":{},"143":{},"144":{},"145":{},"146":{},"147":{},"148":{},"151":{},"152":{},"153":{},"154":{},"155":{},"156":{},"157":{},"158":{},"159":{},"160":{},"162":{},"163":{},"164":{},"166":{},"168":{},"169":{},"170":{},"171":{},"172":{},"175":{},"176":{},"177":{},"178":{},"179":{},"180":{},"181":{},"182":{},"183":{},"184":{},"185":{},"187":{},"188":{},"189":{},"190":{},"191":{},"192":{},"193":{},"194":{},"195":{},"197":{},"198":{},"200":{},"201":{},"202":{},"203":{},"204":{},"206":{},"207":{},"208":{},"209":{},"210":{},"211":{},"212":{},"213":{},"215":{},"216":{},"217":{},"218":{},"219":{},"221":{},"222":{},"223":{},"224":{},"225":{},"226":{},"227":{},"228":{},"229":{},"230":{},"231":{},"232":{},"233":{},"234":{},"236":{},"237":{},"238":{},"239":{},"240":{},"242":{},"243":{},"244":{},"245":{},"246":{},"247":{},"248":{},"249":{},"250":{},"251":{},"254":{},"255":{},"256":{},"258":{},"259":{},"260":{},"261":{},"262":{},"263":{}}}],["userdata",{"_index":545,"title":{},"description":{"120":{}}}],["utc",{"_index":182,"title":{},"description":{"6":{},"10":{},"16":{},"41":{},"113":{},"137":{},"214":{},"267":{}}}],["util",{"_index":390,"title":{},"description":{"47":{},"106":{}}}],["uuid",{"_index":244,"title":{},"description":{"12":{},"87":{},"126":{},"180":{},"182":{},"184":{},"192":{},"194":{},"197":{},"202":{},"204":{},"208":{}}}],["v2/org/{org}/nico/alloc",{"_index":380,"title":{},"description":{"42":{},"43":{}}}],["v2/org/{org}/nico/allocation/{allocationid",{"_index":387,"title":{},"description":{"44":{},"45":{},"46":{}}}],["v2/org/{org}/nico/allocation/{allocationid}/constraint/{allocationconstraintid",{"_index":400,"title":{},"description":{"47":{}}}],["v2/org/{org}/nico/audit",{"_index":908,"title":{},"description":{"250":{}}}],["v2/org/{org}/nico/audit/{auditentryid",{"_index":909,"title":{},"description":{"251":{}}}],["v2/org/{org}/nico/credential/bmc",{"_index":299,"title":{},"description":{"24":{}}}],["v2/org/{org}/nico/credential/rot",{"_index":336,"title":{},"description":{"36":{},"37":{}}}],["v2/org/{org}/nico/credential/uefi",{"_index":308,"title":{},"description":{"26":{}}}],["v2/org/{org}/nico/dpu-extension-servic",{"_index":889,"title":{},"description":{"228":{},"229":{}}}],["v2/org/{org}/nico/dpu-extension-service/{dpuextensionserviceid",{"_index":890,"title":{},"description":{"230":{},"231":{},"232":{}}}],["v2/org/{org}/nico/dpu-extension-service/{dpuextensionserviceid}/version/{vers",{"_index":891,"title":{},"description":{"233":{},"234":{}}}],["v2/org/{org}/nico/expected-machin",{"_index":433,"title":{},"description":{"73":{},"74":{}}}],["v2/org/{org}/nico/expected-machine/batch",{"_index":442,"title":{},"description":{"78":{},"79":{}}}],["v2/org/{org}/nico/expected-machine/{expectedmachineid",{"_index":437,"title":{},"description":{"75":{},"76":{},"77":{}}}],["v2/org/{org}/nico/expected-power-shelf",{"_index":450,"title":{},"description":{"81":{},"82":{}}}],["v2/org/{org}/nico/expected-power-shelf/{expectedpowershelfid",{"_index":451,"title":{},"description":{"83":{},"84":{},"85":{}}}],["v2/org/{org}/nico/expected-rack",{"_index":472,"title":{},"description":{"87":{},"88":{},"89":{}}}],["v2/org/{org}/nico/expected-rack/al",{"_index":476,"title":{},"description":{"90":{}}}],["v2/org/{org}/nico/expected-rack/{id",{"_index":477,"title":{},"description":{"91":{},"92":{},"93":{}}}],["v2/org/{org}/nico/expected-switch",{"_index":485,"title":{},"description":{"95":{},"96":{}}}],["v2/org/{org}/nico/expected-switch/{expectedswitchid",{"_index":486,"title":{},"description":{"97":{},"98":{},"99":{}}}],["v2/org/{org}/nico/firmware-config/host",{"_index":929,"title":{},"description":{"255":{},"256":{}}}],["v2/org/{org}/nico/infiniband-interfac",{"_index":535,"title":{},"description":{"112":{}}}],["v2/org/{org}/nico/infiniband-partit",{"_index":532,"title":{},"description":{"107":{},"108":{}}}],["v2/org/{org}/nico/infiniband-partition/{infinibandpartitionid",{"_index":533,"title":{},"description":{"109":{},"110":{},"111":{}}}],["v2/org/{org}/nico/infrastructure-provider/curr",{"_index":169,"title":{},"description":{"4":{}}}],["v2/org/{org}/nico/infrastructure-provider/current/stat",{"_index":171,"title":{},"description":{"5":{}}}],["v2/org/{org}/nico/inst",{"_index":594,"title":{},"description":{"139":{},"140":{}}}],["v2/org/{org}/nico/instance/batch",{"_index":612,"title":{},"description":{"141":{}}}],["v2/org/{org}/nico/instance/typ",{"_index":574,"title":{},"description":{"130":{},"131":{}}}],["v2/org/{org}/nico/instance/type/{instancetypeid",{"_index":575,"title":{},"description":{"132":{},"133":{},"134":{}}}],["v2/org/{org}/nico/instance/type/{instancetypeid}/machin",{"_index":578,"title":{},"description":{"135":{},"136":{}}}],["v2/org/{org}/nico/instance/type/{instancetypeid}/machine/{machineassociationid",{"_index":591,"title":{},"description":{"137":{}}}],["v2/org/{org}/nico/instance/{instanceid",{"_index":613,"title":{},"description":{"142":{},"143":{},"144":{}}}],["v2/org/{org}/nico/instance/{instanceid}/infiniband-interfac",{"_index":616,"title":{},"description":{"147":{}}}],["v2/org/{org}/nico/instance/{instanceid}/interfac",{"_index":615,"title":{},"description":{"146":{}}}],["v2/org/{org}/nico/instance/{instanceid}/nvlink-interfac",{"_index":617,"title":{},"description":{"148":{}}}],["v2/org/{org}/nico/instance/{instanceid}/status-histori",{"_index":614,"title":{},"description":{"145":{}}}],["v2/org/{org}/nico/ipblock",{"_index":878,"title":{},"description":{"221":{},"222":{}}}],["v2/org/{org}/nico/ipblock/{ipblockid",{"_index":879,"title":{},"description":{"223":{},"224":{},"225":{}}}],["v2/org/{org}/nico/ipblock/{ipblockid}/deriv",{"_index":884,"title":{},"description":{"226":{}}}],["v2/org/{org}/nico/ipxe-templ",{"_index":570,"title":{},"description":{"127":{}}}],["v2/org/{org}/nico/ipxe-template/{ipxetemplateid",{"_index":571,"title":{},"description":{"128":{}}}],["v2/org/{org}/nico/machin",{"_index":619,"title":{},"description":{"150":{}}}],["v2/org/{org}/nico/machine-cap",{"_index":656,"title":{},"description":{"160":{}}}],["v2/org/{org}/nico/machine/gpu/stat",{"_index":646,"title":{},"description":{"157":{}}}],["v2/org/{org}/nico/machine/instance-type/stat",{"_index":654,"title":{},"description":{"159":{}}}],["v2/org/{org}/nico/machine/instance-type/stats/summari",{"_index":651,"title":{},"description":{"158":{}}}],["v2/org/{org}/nico/machine/{machineid",{"_index":621,"title":{},"description":{"151":{},"152":{},"153":{}}}],["v2/org/{org}/nico/machine/{machineid}/bmc/reset",{"_index":671,"title":{},"description":{"166":{}}}],["v2/org/{org}/nico/machine/{machineid}/dpu",{"_index":644,"title":{},"description":{"156":{}}}],["v2/org/{org}/nico/machine/{machineid}/dpu/reprovis",{"_index":679,"title":{},"description":{"168":{}}}],["v2/org/{org}/nico/machine/{machineid}/health-report",{"_index":681,"title":{},"description":{"170":{},"171":{}}}],["v2/org/{org}/nico/machine/{machineid}/health-report/{sourc",{"_index":683,"title":{},"description":{"172":{}}}],["v2/org/{org}/nico/machine/{machineid}/pow",{"_index":632,"title":{},"description":{"154":{}}}],["v2/org/{org}/nico/machine/{machineid}/status-histori",{"_index":633,"title":{},"description":{"155":{}}}],["v2/org/{org}/nico/machine/{machineid}/validation/result",{"_index":666,"title":{},"description":{"164":{}}}],["v2/org/{org}/nico/machine/{machineid}/validation/run",{"_index":665,"title":{},"description":{"162":{},"163":{}}}],["v2/org/{org}/nico/measured-boot/trusted-machin",{"_index":316,"title":{},"description":{"28":{},"29":{}}}],["v2/org/{org}/nico/measured-boot/trusted-machine/{id",{"_index":317,"title":{},"description":{"30":{}}}],["v2/org/{org}/nico/measured-boot/trusted-profil",{"_index":319,"title":{},"description":{"32":{},"33":{}}}],["v2/org/{org}/nico/measured-boot/trusted-profile/{id",{"_index":320,"title":{},"description":{"34":{}}}],["v2/org/{org}/nico/metadata",{"_index":911,"title":{},"description":{"253":{}}}],["v2/org/{org}/nico/network-security-group",{"_index":873,"title":{},"description":{"215":{},"216":{}}}],["v2/org/{org}/nico/network-security-group/{networksecuritygroupid",{"_index":874,"title":{},"description":{"217":{},"218":{},"219":{}}}],["v2/org/{org}/nico/nvlink-interfac",{"_index":541,"title":{},"description":{"119":{}}}],["v2/org/{org}/nico/nvlink-logical-partit",{"_index":539,"title":{},"description":{"114":{},"115":{}}}],["v2/org/{org}/nico/nvlink-logical-partition/{nvlinklogicalpartitionid",{"_index":540,"title":{},"description":{"116":{},"117":{},"118":{}}}],["v2/org/{org}/nico/operating-system",{"_index":553,"title":{},"description":{"121":{},"122":{}}}],["v2/org/{org}/nico/operating-system/{operatingsystemid",{"_index":559,"title":{},"description":{"123":{},"124":{},"125":{}}}],["v2/org/{org}/nico/rack",{"_index":685,"title":{},"description":{"175":{}}}],["v2/org/{org}/nico/rack/bringup",{"_index":710,"title":{},"description":{"183":{}}}],["v2/org/{org}/nico/rack/firmwar",{"_index":706,"title":{},"description":{"181":{}}}],["v2/org/{org}/nico/rack/pow",{"_index":703,"title":{},"description":{"179":{}}}],["v2/org/{org}/nico/rack/task/{id",{"_index":765,"title":{},"description":{"197":{}}}],["v2/org/{org}/nico/rack/task/{id}/cancel",{"_index":769,"title":{},"description":{"198":{}}}],["v2/org/{org}/nico/rack/valid",{"_index":697,"title":{},"description":{"177":{}}}],["v2/org/{org}/nico/rack/{id",{"_index":686,"title":{},"description":{"176":{}}}],["v2/org/{org}/nico/rack/{id}/bringup",{"_index":711,"title":{},"description":{"184":{}}}],["v2/org/{org}/nico/rack/{id}/firmwar",{"_index":707,"title":{},"description":{"182":{}}}],["v2/org/{org}/nico/rack/{id}/pow",{"_index":704,"title":{},"description":{"180":{}}}],["v2/org/{org}/nico/rack/{id}/task",{"_index":734,"title":{},"description":{"185":{}}}],["v2/org/{org}/nico/rack/{id}/valid",{"_index":699,"title":{},"description":{"178":{}}}],["v2/org/{org}/nico/service-account/curr",{"_index":163,"title":{},"description":{"2":{}}}],["v2/org/{org}/nico/sit",{"_index":281,"title":{},"description":{"17":{},"18":{}}}],["v2/org/{org}/nico/site-explorer/endpoint",{"_index":359,"title":{},"description":{"39":{}}}],["v2/org/{org}/nico/site-explorer/endpoint/act",{"_index":372,"title":{},"description":{"40":{}}}],["v2/org/{org}/nico/site/{siteid",{"_index":284,"title":{},"description":{"19":{},"20":{},"21":{}}}],["v2/org/{org}/nico/site/{siteid}/.well-known/jwks.json",{"_index":1027,"title":{},"description":{"264":{}}}],["v2/org/{org}/nico/site/{siteid}/.well-known/openid-configur",{"_index":1033,"title":{},"description":{"265":{}}}],["v2/org/{org}/nico/site/{siteid}/.well-known/spiffe/jwks.json",{"_index":1039,"title":{},"description":{"266":{}}}],["v2/org/{org}/nico/site/{siteid}/status-histori",{"_index":289,"title":{},"description":{"22":{}}}],["v2/org/{org}/nico/site/{siteid}/tenant-identity/config",{"_index":983,"title":{},"description":{"258":{},"259":{},"260":{}}}],["v2/org/{org}/nico/site/{siteid}/tenant-identity/token-deleg",{"_index":1013,"title":{},"description":{"261":{},"262":{},"263":{}}}],["v2/org/{org}/nico/sku",{"_index":499,"title":{},"description":{"101":{},"102":{}}}],["v2/org/{org}/nico/sku/{skuid",{"_index":501,"title":{},"description":{"103":{},"104":{},"105":{}}}],["v2/org/{org}/nico/sshkey",{"_index":901,"title":{},"description":{"242":{},"243":{}}}],["v2/org/{org}/nico/sshkey/{sshkeyid",{"_index":902,"title":{},"description":{"244":{},"245":{},"246":{}}}],["v2/org/{org}/nico/sshkeygroup",{"_index":895,"title":{},"description":{"236":{},"237":{}}}],["v2/org/{org}/nico/sshkeygroup/{sshkeygroupid",{"_index":896,"title":{},"description":{"238":{},"239":{},"240":{}}}],["v2/org/{org}/nico/subnet",{"_index":420,"title":{},"description":{"67":{},"68":{}}}],["v2/org/{org}/nico/subnet/{subnetid",{"_index":423,"title":{},"description":{"69":{},"70":{},"71":{}}}],["v2/org/{org}/nico/task/rul",{"_index":804,"title":{},"description":{"200":{},"201":{}}}],["v2/org/{org}/nico/task/rule/{id",{"_index":805,"title":{},"description":{"202":{},"203":{},"204":{}}}],["v2/org/{org}/nico/task/run",{"_index":842,"title":{},"description":{"206":{},"207":{}}}],["v2/org/{org}/nico/task/run/{id",{"_index":847,"title":{},"description":{"208":{}}}],["v2/org/{org}/nico/task/run/{id}/adv",{"_index":863,"title":{},"description":{"212":{}}}],["v2/org/{org}/nico/task/run/{id}/cancel",{"_index":868,"title":{},"description":{"213":{}}}],["v2/org/{org}/nico/task/run/{id}/paus",{"_index":853,"title":{},"description":{"210":{}}}],["v2/org/{org}/nico/task/run/{id}/resum",{"_index":856,"title":{},"description":{"211":{}}}],["v2/org/{org}/nico/task/run/{id}/target",{"_index":850,"title":{},"description":{"209":{}}}],["v2/org/{org}/nico/task/{id",{"_index":768,"title":{},"description":{"197":{}}}],["v2/org/{org}/nico/task/{id}/cancel",{"_index":779,"title":{},"description":{"198":{}}}],["v2/org/{org}/nico/tenant/account",{"_index":235,"title":{},"description":{"11":{},"12":{}}}],["v2/org/{org}/nico/tenant/account/{accountid",{"_index":248,"title":{},"description":{"13":{},"14":{},"15":{}}}],["v2/org/{org}/nico/tenant/curr",{"_index":205,"title":{},"description":{"7":{}}}],["v2/org/{org}/nico/tenant/current/stat",{"_index":206,"title":{},"description":{"8":{}}}],["v2/org/{org}/nico/tenant/instance-type/stat",{"_index":210,"title":{},"description":{"9":{}}}],["v2/org/{org}/nico/tray",{"_index":747,"title":{},"description":{"187":{}}}],["v2/org/{org}/nico/tray/firmwar",{"_index":756,"title":{},"description":{"193":{}}}],["v2/org/{org}/nico/tray/pow",{"_index":754,"title":{},"description":{"191":{}}}],["v2/org/{org}/nico/tray/valid",{"_index":751,"title":{},"description":{"189":{}}}],["v2/org/{org}/nico/tray/{id",{"_index":748,"title":{},"description":{"188":{}}}],["v2/org/{org}/nico/tray/{id}/firmwar",{"_index":757,"title":{},"description":{"194":{}}}],["v2/org/{org}/nico/tray/{id}/pow",{"_index":755,"title":{},"description":{"192":{}}}],["v2/org/{org}/nico/tray/{id}/task",{"_index":758,"title":{},"description":{"195":{}}}],["v2/org/{org}/nico/tray/{id}/valid",{"_index":752,"title":{},"description":{"190":{}}}],["v2/org/{org}/nico/user/curr",{"_index":904,"title":{},"description":{"248":{}}}],["v2/org/{org}/nico/vpc",{"_index":403,"title":{},"description":{"49":{},"50":{}}}],["v2/org/{org}/nico/vpc-p",{"_index":410,"title":{},"description":{"56":{},"57":{}}}],["v2/org/{org}/nico/vpc-peering/{id",{"_index":416,"title":{},"description":{"58":{},"59":{}}}],["v2/org/{org}/nico/vpc-prefix",{"_index":418,"title":{},"description":{"61":{},"62":{}}}],["v2/org/{org}/nico/vpc-prefix/{vpcprefixid",{"_index":419,"title":{},"description":{"63":{},"64":{},"65":{}}}],["v2/org/{org}/nico/vpc/{vpcid",{"_index":404,"title":{},"description":{"51":{},"52":{},"53":{}}}],["v2/org/{org}/nico/vpc/{vpcid}/virtu",{"_index":406,"title":{},"description":{"54":{}}}],["valid",{"_index":657,"title":{"161":{},"162":{},"163":{},"164":{},"177":{},"178":{},"189":{},"190":{}},"description":{"161":{},"162":{},"163":{},"164":{},"177":{},"178":{},"189":{},"190":{},"200":{},"203":{},"206":{},"257":{}}}],["valu",{"_index":183,"title":{},"description":{"6":{},"7":{},"43":{},"89":{},"105":{}}}],["variou",{"_index":97,"title":{},"description":{"0":{},"246":{},"252":{}}}],["vendor",{"_index":915,"title":{},"description":{"254":{},"256":{}}}],["verif",{"_index":1022,"title":{},"description":{"264":{},"265":{}}}],["verifi",{"_index":661,"title":{},"description":{"161":{},"257":{},"266":{}}}],["version",{"_index":28,"title":{"233":{},"234":{}},"description":{"0":{},"17":{},"36":{},"105":{},"221":{},"231":{},"232":{},"233":{},"234":{},"254":{},"267":{}}}],["via",{"_index":162,"title":{},"description":{"2":{},"7":{},"86":{},"87":{},"187":{},"205":{},"209":{},"222":{},"224":{},"225":{},"254":{}}}],["view",{"_index":247,"title":{},"description":{"12":{}}}],["virtual",{"_index":405,"title":{"54":{}},"description":{"54":{}}}],["visibl",{"_index":546,"title":{},"description":{"121":{},"150":{}}}],["vpc",{"_index":112,"title":{"48":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"55":{},"56":{},"57":{},"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{}},"description":{"0":{},"47":{},"48":{},"49":{},"50":{},"51":{},"52":{},"53":{},"54":{},"55":{},"56":{},"57":{},"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{},"65":{},"138":{}}}],["vs",{"_index":647,"title":{},"description":{"158":{},"177":{},"178":{},"187":{},"189":{},"190":{},"191":{},"193":{},"258":{}}}],["wait",{"_index":719,"title":{},"description":{"185":{},"195":{},"198":{}}}],["way",{"_index":798,"title":{},"description":{"200":{}}}],["web",{"_index":1020,"title":{},"description":{"264":{}}}],["well-known",{"_index":458,"title":{},"description":{"86":{},"87":{},"257":{}}}],["whether",{"_index":544,"title":{},"description":{"120":{}}}],["whose",{"_index":262,"title":{},"description":{"14":{},"168":{}}}],["window",{"_index":959,"title":{},"description":{"257":{}}}],["within",{"_index":471,"title":{},"description":{"87":{},"89":{},"141":{},"186":{}}}],["without",{"_index":776,"title":{},"description":{"198":{},"257":{},"260":{}}}],["worker",{"_index":608,"title":{},"description":{"141":{}}}],["worker-abc123",{"_index":610,"title":{},"description":{"141":{}}}],["worker-def456",{"_index":611,"title":{},"description":{"141":{}}}],["workflow",{"_index":642,"title":{},"description":{"156":{},"185":{},"195":{},"198":{}}}],["workload",{"_index":1002,"title":{},"description":{"261":{}}}],["wrong",{"_index":862,"title":{},"description":{"212":{}}}],["x-pagin",{"_index":357,"title":{},"description":{"39":{},"185":{},"195":{},"201":{},"207":{},"209":{}}}]],"pipeline":[]}},"options":{"expandResponses":"200,201","schemasExpansionLevel":2}};
 
       var container = document.getElementById('redoc');
       Redoc.hydrate(__redoc_state, container);
diff --git a/rest-api/flow/internal/converter/dao/converter.go b/rest-api/flow/internal/converter/dao/converter.go
index 35f9e6707d..68e752ba61 100644
--- a/rest-api/flow/internal/converter/dao/converter.go
+++ b/rest-api/flow/internal/converter/dao/converter.go
@@ -342,6 +342,7 @@ func OperationRunFrom(dao *model.OperationRun) *operationrun.OperationRun {
 		StatusReason:      dao.StatusReason,
 		StatusMessage:     dao.StatusMessage,
 		CurrentPhaseIndex: dao.CurrentPhaseIndex,
+		TotalPhases:       dao.TotalPhases,
 		Selector:          dao.Selector,
 		Options:           dao.Options,
 		OperationTemplate: dao.OperationTemplate,
@@ -368,6 +369,7 @@ func OperationRunTo(run *operationrun.OperationRun) *model.OperationRun {
 		StatusReason:      run.StatusReason,
 		StatusMessage:     run.StatusMessage,
 		CurrentPhaseIndex: run.CurrentPhaseIndex,
+		TotalPhases:       run.TotalPhases,
 		Selector:          run.Selector,
 		Options:           run.Options,
 		OperationTemplate: run.OperationTemplate,
diff --git a/rest-api/flow/internal/converter/protobuf/operationrun_converter.go b/rest-api/flow/internal/converter/protobuf/operationrun_converter.go
index 103fb53653..83b5d050c6 100644
--- a/rest-api/flow/internal/converter/protobuf/operationrun_converter.go
+++ b/rest-api/flow/internal/converter/protobuf/operationrun_converter.go
@@ -1125,7 +1125,7 @@ func OperationRunTo(run *operationrun.OperationRun) (*pb.OperationRun, error) {
 	}
 
 	result := &pb.OperationRun{
-		Summary: operationRunSummaryTo(run, &options),
+		Summary: operationRunSummaryTo(run),
 		Configuration: &pb.OperationRunConfiguration{
 			Selector:  pbSelector,
 			Options:   pbOptions,
@@ -1140,8 +1140,7 @@ func OperationRunTo(run *operationrun.OperationRun) (*pb.OperationRun, error) {
 }
 
 // OperationRunSummaryTo converts a domain operation run to the lightweight
-// list shape. It intentionally avoids unmarshalling selector and operation
-// template JSON.
+// list shape without unmarshalling configuration JSON.
 func OperationRunSummaryTo(
 	run *operationrun.OperationRun,
 ) (*pb.OperationRunSummary, error) {
@@ -1149,17 +1148,11 @@ func OperationRunSummaryTo(
 		return nil, nil
 	}
 
-	var options operationrun.Options
-	if err := operationrun.UnmarshalConfig(run.Options, &options); err != nil {
-		return nil, fmt.Errorf("unmarshal options: %w", err)
-	}
-
-	return operationRunSummaryTo(run, &options), nil
+	return operationRunSummaryTo(run), nil
 }
 
 func operationRunSummaryTo(
 	run *operationrun.OperationRun,
-	options *operationrun.Options,
 ) *pb.OperationRunSummary {
 	summary := &pb.OperationRunSummary{
 		Id:            UUIDTo(run.ID),
@@ -1168,7 +1161,7 @@ func operationRunSummaryTo(
 		OperationKind: OperationKindTo(run.OperationType, run.OperationCode),
 		State:         OperationRunStateTo(run.Status, run.StatusReason),
 		StatusMessage: run.StatusMessage,
-		TotalPhases:   operationRunPhaseCount(&options.PhasePolicy),
+		TotalPhases:   run.TotalPhases,
 		CreatedAt:     timestamppb.New(run.CreatedAt),
 		UpdatedAt:     timestamppb.New(run.UpdatedAt),
 	}
@@ -1428,38 +1421,6 @@ func OperationRunTargetListOptionsFrom(
 	return opts, nil
 }
 
-func operationRunPhaseCount(policy *operationrun.PhasePolicy) int32 {
-	if policy == nil {
-		return 0
-	}
-	if policy.Plan == nil {
-		return 0
-	}
-
-	switch policy.Plan.PhasePlanKind() {
-	case operationrun.PhasePlanKindEqual:
-		equal, ok := policy.Plan.(*operationrun.EqualPhases)
-		if !ok || equal == nil {
-			return 0
-		}
-		return equal.PhaseCount
-	case operationrun.PhasePlanKindPercentage:
-		percentage, ok := policy.Plan.(*operationrun.PercentagePhases)
-		if !ok || percentage == nil {
-			return 0
-		}
-		return int32(len(percentage.Phases))
-	case operationrun.PhasePlanKindCount:
-		count, ok := policy.Plan.(*operationrun.CountPhases)
-		if !ok || count == nil {
-			return 0
-		}
-		return int32(len(count.Phases) + 1)
-	default:
-		return 0
-	}
-}
-
 // OperationRunStatusTo converts a domain operation-run status to proto.
 func OperationRunStatusTo(
 	status operationrun.OperationRunStatus,
diff --git a/rest-api/flow/internal/converter/protobuf/operationrun_converter_test.go b/rest-api/flow/internal/converter/protobuf/operationrun_converter_test.go
index 0fdb93dcfd..45183cd257 100644
--- a/rest-api/flow/internal/converter/protobuf/operationrun_converter_test.go
+++ b/rest-api/flow/internal/converter/protobuf/operationrun_converter_test.go
@@ -83,11 +83,13 @@ func TestOperationRunFromDefaults(t *testing.T) {
 func TestOperationRunToRebuildsConfigurationFromInternalJSON(t *testing.T) {
 	run, err := OperationRunFrom(validCreateRequest())
 	require.NoError(t, err)
+	run.TotalPhases = 2
 
 	got, err := OperationRunTo(run)
 	require.NoError(t, err)
 
 	require.NotNil(t, got.GetConfiguration())
+	require.Equal(t, int32(2), got.GetSummary().GetTotalPhases())
 	require.EqualValues(
 		t,
 		10,
@@ -138,6 +140,18 @@ func TestOperationRunToRebuildsConfigurationFromInternalJSON(t *testing.T) {
 	)
 }
 
+func TestOperationRunSummaryToUsesMaterializedPhaseCount(t *testing.T) {
+	run := &operationrun.OperationRun{
+		TotalPhases: 2,
+		Options:     []byte("{"),
+	}
+
+	got, err := OperationRunSummaryTo(run)
+
+	require.NoError(t, err)
+	require.Equal(t, int32(2), got.GetTotalPhases())
+}
+
 func TestOperationRunStatusConversionIncludesCompletedWithFailures(t *testing.T) {
 	require.Equal(
 		t,
diff --git a/rest-api/flow/internal/db/model/operation_run.go b/rest-api/flow/internal/db/model/operation_run.go
index e4ad8b9c72..f407ccab4b 100644
--- a/rest-api/flow/internal/db/model/operation_run.go
+++ b/rest-api/flow/internal/db/model/operation_run.go
@@ -26,6 +26,7 @@ type OperationRun struct {
 	StatusReason      operationrun.OperationRunStatusReason `bun:"status_reason,type:varchar(64),notnull"` //nolint:lll
 	StatusMessage     string                                `bun:"status_message,nullzero"`
 	CurrentPhaseIndex int32                                 `bun:"current_phase_index,notnull"`
+	TotalPhases       int32                                 `bun:"total_phases,scanonly"`
 	Selector          json.RawMessage                       `bun:"selector,type:jsonb,notnull"`
 	Options           json.RawMessage                       `bun:"options,type:jsonb,notnull"`
 	OperationTemplate json.RawMessage                       `bun:"operation_template,type:jsonb,notnull"`
diff --git a/rest-api/flow/internal/operationrun/manager/dispatcher/decision.go b/rest-api/flow/internal/operationrun/manager/dispatcher/decision.go
index edc6e4de04..bcf45467e9 100644
--- a/rest-api/flow/internal/operationrun/manager/dispatcher/decision.go
+++ b/rest-api/flow/internal/operationrun/manager/dispatcher/decision.go
@@ -189,9 +189,14 @@ func (d *Dispatcher) decide(
 	)
 	switch phaseDecision.action {
 	case phaseDecisionActionAdvance:
+		if phaseDecision.nextPhaseIndex == nil {
+			return dispatchDecision{}, fmt.Errorf(
+				"advance phase decision is missing next phase index",
+			)
+		}
 		// The next phase's targets were not locked during this transaction.
 		// Persist the phase pointer first; the next pass will lock and submit them.
-		prep.run.CurrentPhaseIndex++
+		prep.run.CurrentPhaseIndex = *phaseDecision.nextPhaseIndex
 		return newStopDecision(startRunTransition(phaseDecision.message)), nil
 	case phaseDecisionActionPause:
 		return newStopDecision(
diff --git a/rest-api/flow/internal/operationrun/manager/dispatcher/dispatcher_test.go b/rest-api/flow/internal/operationrun/manager/dispatcher/dispatcher_test.go
index 7b6043df94..3e47d7eb6e 100644
--- a/rest-api/flow/internal/operationrun/manager/dispatcher/dispatcher_test.go
+++ b/rest-api/flow/internal/operationrun/manager/dispatcher/dispatcher_test.go
@@ -268,6 +268,62 @@ func TestDispatchRunLocksOnlyCurrentPhaseTargets(t *testing.T) {
 	require.Equal(t, operationrun.OperationRunStatusReasonPhaseGate, store.run.StatusReason)
 }
 
+func TestDispatchRunSkipsLegacyConsecutiveEmptyPhases(t *testing.T) {
+	tests := []struct {
+		name        string
+		autoAdvance bool
+	}{
+		{name: "automatic phase policy", autoAdvance: true},
+		{name: "manual phase policy"},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			runID := uuid.New()
+			nextRackID := uuid.New()
+			nextTaskID := uuid.New()
+			now := time.Date(2026, 8, 14, 10, 0, 0, 0, time.UTC)
+			completed := testTarget(runID, uuid.New(), uuid.New(), 0, 0)
+			completed.Status = operationrun.OperationRunTargetStatusCompleted
+			pending := testTarget(runID, nextRackID, uuid.New(), 1, 3)
+
+			store := newFakeStore(
+				testRun(t, runID, 1, operationrun.PhasePolicy{
+					AdvancePolicy: operationrun.PhaseAdvancePolicy{
+						AutoAdvance: tt.autoAdvance,
+					},
+				}),
+				[]*operationrun.OperationRunTarget{completed, pending},
+			)
+			store.run.Status = operationrun.OperationRunStatusRunning
+			store.run.CurrentPhaseIndex = 1
+			taskManager := &fakeTaskManager{
+				results: map[uuid.UUID]submitResult{
+					nextRackID: {ids: []uuid.UUID{nextTaskID}},
+				},
+			}
+			dispatcher := newTestDispatcherAt(t, Dependencies{
+				Store:       store,
+				TaskManager: taskManager,
+				TaskStore:   &fakeTaskStore{},
+			}, Config{FetchBatch: 10}, now)
+
+			err := dispatcher.dispatchRun(context.Background(), runID)
+			require.NoError(t, err)
+			require.Equal(t, int32(3), store.run.CurrentPhaseIndex)
+			require.Equal(t, operationrun.OperationRunStatusRunning, store.run.Status)
+			require.Equal(t, "skipped empty phase", store.run.StatusMessage)
+			require.Empty(t, taskManager.requests)
+
+			err = dispatcher.dispatchRun(context.Background(), runID)
+			require.NoError(t, err)
+			require.Len(t, taskManager.requests, 1)
+			require.Equal(t, nextRackID, taskManager.requests[0].RequiredRackID)
+			require.Equal(t, operationrun.OperationRunTargetStatusSubmitted, pending.Status)
+		})
+	}
+}
+
 func TestDispatchRunPausesWhenSafetyGateTrips(t *testing.T) {
 	runID := uuid.New()
 	taskID := uuid.New()
@@ -628,7 +684,6 @@ func TestDecideSetsTerminalStatusFromTargetOutcomes(t *testing.T) {
 				Status: operationrun.OperationRunStatusRunning,
 			}
 			summary := operationrun.TargetPhaseSummary{}
-			summary.TotalPhases = 1
 			summary.CurrentPhaseStats.SelectedTargets = len(tt.statuses)
 			for _, status := range tt.statuses {
 				summary.CurrentPhaseStats.StatusCounts.Add(status)
@@ -713,19 +768,21 @@ func (s *fakeStore) GetTargetPhaseAggregate(
 	runID uuid.UUID,
 	currentPhaseIndex int32,
 ) (operationrun.TargetPhaseAggregate, error) {
-	var totalPhases int32
+	var nextPhaseIndex *int32
 	completedStats := operationrun.PhaseStats{PhaseIndex: max(currentPhaseIndex-1, 0)}
 	for _, target := range s.targets {
-		if target.PhaseIndex+1 > totalPhases {
-			totalPhases = target.PhaseIndex + 1
-		}
 		if target.PhaseIndex < currentPhaseIndex {
 			completedStats.AddTarget(target)
 		}
+		if target.PhaseIndex > currentPhaseIndex &&
+			(nextPhaseIndex == nil || target.PhaseIndex < *nextPhaseIndex) {
+			candidate := target.PhaseIndex
+			nextPhaseIndex = &candidate
+		}
 	}
 
 	return operationrun.TargetPhaseAggregate{
-		TotalPhases:         totalPhases,
+		NextPhaseIndex:      nextPhaseIndex,
 		CompletedPhaseStats: completedStats,
 	}, nil
 }
diff --git a/rest-api/flow/internal/operationrun/manager/dispatcher/phase.go b/rest-api/flow/internal/operationrun/manager/dispatcher/phase.go
index 79ba720d16..df4a57f898 100644
--- a/rest-api/flow/internal/operationrun/manager/dispatcher/phase.go
+++ b/rest-api/flow/internal/operationrun/manager/dispatcher/phase.go
@@ -22,9 +22,18 @@ const (
 )
 
 type phaseDecision struct {
-	action  phaseDecisionAction
-	reason  operationrun.OperationRunStatusReason
-	message string
+	action         phaseDecisionAction
+	nextPhaseIndex *int32
+	reason         operationrun.OperationRunStatusReason
+	message        string
+}
+
+func newAdvancePhaseDecision(nextPhaseIndex int32, message string) phaseDecision {
+	return phaseDecision{
+		action:         phaseDecisionActionAdvance,
+		nextPhaseIndex: &nextPhaseIndex,
+		message:        message,
+	}
 }
 
 func newPhasePolicy(options *operationrun.Options) (*phasePolicyRuntime, error) {
@@ -40,17 +49,22 @@ func newPhasePolicy(options *operationrun.Options) (*phasePolicyRuntime, error)
 func (p phasePolicyRuntime) evaluate(
 	summary operationrun.TargetPhaseSummary,
 ) phaseDecision {
-	if !summary.CurrentPhaseTerminal() || !summary.HasNextPhase() {
+	nextPhaseIndex, hasNextPhase := summary.NextPhase()
+
+	// Empty phases are planner artifacts rather than rollout boundaries. Skip
+	// legacy gaps without applying the configured automatic or manual gate.
+	if summary.CurrentPhaseEmpty() && hasNextPhase {
+		return newAdvancePhaseDecision(nextPhaseIndex, "skipped empty phase")
+	}
+
+	if !summary.CurrentPhaseTerminal() || !hasNextPhase {
 		return phaseDecision{
 			action: phaseDecisionActionClaim,
 		}
 	}
 
 	if p.autoAdvance {
-		return phaseDecision{
-			action:  phaseDecisionActionAdvance,
-			message: "advanced to next phase",
-		}
+		return newAdvancePhaseDecision(nextPhaseIndex, "advanced to next phase")
 	}
 
 	return phaseDecision{
diff --git a/rest-api/flow/internal/operationrun/manager/dispatcher/phase_test.go b/rest-api/flow/internal/operationrun/manager/dispatcher/phase_test.go
new file mode 100644
index 0000000000..e60f710f02
--- /dev/null
+++ b/rest-api/flow/internal/operationrun/manager/dispatcher/phase_test.go
@@ -0,0 +1,30 @@
+// SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+package dispatcher
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestNewAdvancePhaseDecisionCarriesExplicitPhaseIndex(t *testing.T) {
+	tests := []struct {
+		name           string
+		nextPhaseIndex int32
+	}{
+		{name: "phase zero is explicit", nextPhaseIndex: 0},
+		{name: "later phase", nextPhaseIndex: 3},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			decision := newAdvancePhaseDecision(tt.nextPhaseIndex, "advance")
+
+			require.Equal(t, phaseDecisionActionAdvance, decision.action)
+			require.NotNil(t, decision.nextPhaseIndex)
+			require.Equal(t, tt.nextPhaseIndex, *decision.nextPhaseIndex)
+		})
+	}
+}
diff --git a/rest-api/flow/internal/operationrun/manager/manager_test.go b/rest-api/flow/internal/operationrun/manager/manager_test.go
index 2d8558d505..7befd0dd3f 100644
--- a/rest-api/flow/internal/operationrun/manager/manager_test.go
+++ b/rest-api/flow/internal/operationrun/manager/manager_test.go
@@ -329,6 +329,30 @@ func TestAdvancePhaseChecksExpectedPhase(t *testing.T) {
 	require.Zero(t, store.updateRunCalls)
 }
 
+func TestAdvancePhaseSkipsLegacyEmptyPhases(t *testing.T) {
+	runID := uuid.MustParse("11111111-1111-1111-1111-111111111111")
+	store := &mockStore{
+		lockRun: testLockedRun(
+			t,
+			runID,
+			operationrun.OperationRunStatusPaused,
+			operationrun.OperationRunStatusReasonPhaseGate,
+		),
+		lockedTargets: []*operationrun.OperationRunTarget{
+			testOperationRunTarget(runID, 0, operationrun.OperationRunTargetStatusCompleted),
+			testOperationRunTarget(runID, 3, operationrun.OperationRunTargetStatusPending),
+		},
+	}
+	manager := newTestManager(t, store, planner.New(&mockTargetLookup{}, planner.Config{}))
+	expectedPhase := int32(3)
+
+	got, err := manager.AdvancePhase(context.Background(), runID, &expectedPhase)
+
+	require.NoError(t, err)
+	require.Equal(t, int32(3), got.CurrentPhaseIndex)
+	require.Equal(t, "advanced to phase 3", got.StatusMessage)
+}
+
 func TestAdvancePhaseCompletesAllTerminalRun(t *testing.T) {
 	runID := uuid.MustParse("11111111-1111-1111-1111-111111111111")
 	store := &mockStore{
@@ -724,19 +748,21 @@ func (m *mockStore) GetTargetPhaseAggregate(
 	runID uuid.UUID,
 	currentPhaseIndex int32,
 ) (operationrun.TargetPhaseAggregate, error) {
-	var totalPhases int32
+	var nextPhaseIndex *int32
 	completedStats := operationrun.PhaseStats{PhaseIndex: max(currentPhaseIndex-1, 0)}
 	for _, target := range m.lockedTargets {
-		if target.PhaseIndex+1 > totalPhases {
-			totalPhases = target.PhaseIndex + 1
-		}
 		if target.PhaseIndex < currentPhaseIndex {
 			completedStats.AddTarget(target)
 		}
+		if target.PhaseIndex > currentPhaseIndex &&
+			(nextPhaseIndex == nil || target.PhaseIndex < *nextPhaseIndex) {
+			candidate := target.PhaseIndex
+			nextPhaseIndex = &candidate
+		}
 	}
 
 	return operationrun.TargetPhaseAggregate{
-		TotalPhases:         totalPhases,
+		NextPhaseIndex:      nextPhaseIndex,
 		CompletedPhaseStats: completedStats,
 	}, nil
 }
diff --git a/rest-api/flow/internal/operationrun/manager/manual_controls.go b/rest-api/flow/internal/operationrun/manager/manual_controls.go
index f1ed8259d8..5199d0a973 100644
--- a/rest-api/flow/internal/operationrun/manager/manual_controls.go
+++ b/rest-api/flow/internal/operationrun/manager/manual_controls.go
@@ -299,7 +299,14 @@ func (m *ManagerImpl) continueOperationRun(
 			case expectedPhaseIndex == resumeExpectedPhaseIndex:
 				run.Start(now, "operation run resumed")
 			case expectedPhaseIndex >= advanceWithoutExpectedPhaseIndex:
-				run.CurrentPhaseIndex++
+				nextPhaseIndex, ok := summary.NextPhase()
+				if !ok {
+					return nil, fmt.Errorf(
+						"phase %d has no next phase",
+						run.CurrentPhaseIndex,
+					)
+				}
+				run.CurrentPhaseIndex = nextPhaseIndex
 				run.Start(
 					now,
 					fmt.Sprintf(
@@ -388,14 +395,14 @@ func ensurePhaseCanAdvance(
 		)
 	}
 
-	if !summary.HasNextPhase() {
+	nextPhaseIndex, hasNextPhase := summary.NextPhase()
+	if !hasNextPhase {
 		return invalidStateError(
 			"phase %d is the final phase",
 			summary.CurrentPhaseStats.PhaseIndex,
 		)
 	}
 
-	nextPhaseIndex := summary.CurrentPhaseStats.PhaseIndex + 1
 	if expectedPhaseIndex > 0 && expectedPhaseIndex != nextPhaseIndex {
 		return invalidStateError(
 			"expected phase %d, next phase is %d",
diff --git a/rest-api/flow/internal/operationrun/manager/planner/planner.go b/rest-api/flow/internal/operationrun/manager/planner/planner.go
index 09d2dfce81..9b78866a14 100644
--- a/rest-api/flow/internal/operationrun/manager/planner/planner.go
+++ b/rest-api/flow/internal/operationrun/manager/planner/planner.go
@@ -211,20 +211,26 @@ func phasedExecutionTargets(
 
 	targets := make([]*operationrun.OperationRunTarget, 0, len(ordered))
 	seqIdx := 0
-	for phaseIdx, phaseSize := range phaseCounts {
+	materializedPhaseIdx := int32(0)
+	for _, phaseSize := range phaseCounts {
+		if phaseSize == 0 {
+			continue
+		}
+
 		for range phaseSize {
 			targets = append(
 				targets,
 				&operationrun.OperationRunTarget{
 					RackID:           ordered[seqIdx].RackID,
 					SequenceIndex:    int32(seqIdx),
-					PhaseIndex:       int32(phaseIdx),
+					PhaseIndex:       materializedPhaseIdx,
 					ComponentsByType: ordered[seqIdx].ComponentsByType.Clone(),
 					Status:           operationrun.OperationRunTargetStatusPending,
 				},
 			)
 			seqIdx++
 		}
+		materializedPhaseIdx++
 	}
 
 	return targets, nil
diff --git a/rest-api/flow/internal/operationrun/manager/planner/planner_test.go b/rest-api/flow/internal/operationrun/manager/planner/planner_test.go
index 4bc9bb0769..617f74170f 100644
--- a/rest-api/flow/internal/operationrun/manager/planner/planner_test.go
+++ b/rest-api/flow/internal/operationrun/manager/planner/planner_test.go
@@ -122,6 +122,65 @@ func TestPhaseTargetCountsRejectsCountPhasesThatExceedSelection(t *testing.T) {
 	require.ErrorContains(t, err, "count phase counts exceed selected target count")
 }
 
+func TestPhasedExecutionTargetsCompactsEmptyPhases(t *testing.T) {
+	tests := []struct {
+		name        string
+		targetCount int
+		policy      operationrun.PhasePolicy
+		wantCounts  map[int32]int
+	}{
+		{
+			name:        "percentage phase rounds to zero for two targets",
+			targetCount: 2,
+			policy: operationrun.PhasePolicy{
+				Plan: &operationrun.PercentagePhases{
+					Phases: []operationrun.PercentagePhase{
+						{Percentage: 10},
+						{Percentage: 30},
+						{Percentage: 60},
+					},
+				},
+			},
+			wantCounts: map[int32]int{0: 1, 1: 1},
+		},
+		{
+			name:        "percentage phase rounds to zero for five targets",
+			targetCount: 5,
+			policy: operationrun.PhasePolicy{
+				Plan: &operationrun.PercentagePhases{
+					Phases: []operationrun.PercentagePhase{
+						{Percentage: 10},
+						{Percentage: 10},
+						{Percentage: 80},
+					},
+				},
+			},
+			wantCounts: map[int32]int{0: 1, 1: 4},
+		},
+		{
+			name:        "equal phases outnumber targets",
+			targetCount: 2,
+			policy: operationrun.PhasePolicy{
+				Plan: &operationrun.EqualPhases{PhaseCount: 10},
+			},
+			wantCounts: map[int32]int{0: 1, 1: 1},
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			targets, err := phasedExecutionTargets(
+				executionTargetFixtures(tt.targetCount),
+				tt.policy,
+			)
+			require.NoError(t, err)
+
+			require.Len(t, targets, tt.targetCount)
+			require.Equal(t, tt.wantCounts, phaseCounts(targets))
+		})
+	}
+}
+
 func TestPlanAssignsSequenceAndPhaseIndexes(t *testing.T) {
 	lookup := &testTargetLookup{
 		defaultScope: executionTargetFixtures(10),
diff --git a/rest-api/flow/internal/operationrun/manager/store/dispatch.go b/rest-api/flow/internal/operationrun/manager/store/dispatch.go
index b0cbab7e86..d2214b34c4 100644
--- a/rest-api/flow/internal/operationrun/manager/store/dispatch.go
+++ b/rest-api/flow/internal/operationrun/manager/store/dispatch.go
@@ -105,18 +105,21 @@ func (s *PostgresStore) GetTargetPhaseAggregate(
 	currentPhaseIndex int32,
 ) (operationrun.TargetPhaseAggregate, error) {
 	type aggregateRow struct {
-		TotalPhases         int32 `bun:"total_phases"`
-		CompletedTargets    int   `bun:"completed_targets"`
-		CompletedCompleted  int   `bun:"completed_completed"`
-		CompletedFailed     int   `bun:"completed_failed"`
-		CompletedTerminated int   `bun:"completed_terminated"`
-		CompletedSkipped    int   `bun:"completed_skipped"`
+		NextPhaseIndex      *int32 `bun:"next_phase_index"`
+		CompletedTargets    int    `bun:"completed_targets"`
+		CompletedCompleted  int    `bun:"completed_completed"`
+		CompletedFailed     int    `bun:"completed_failed"`
+		CompletedTerminated int    `bun:"completed_terminated"`
+		CompletedSkipped    int    `bun:"completed_skipped"`
 	}
 
 	var row aggregateRow
 	err := s.idb(ctx).NewSelect().
 		TableExpr("operation_run_target AS ort").
-		ColumnExpr("COALESCE(MAX(ort.phase_index) + 1, 0) AS total_phases").
+		ColumnExpr(
+			"MIN(ort.phase_index) FILTER (WHERE ort.phase_index > ?) AS next_phase_index",
+			currentPhaseIndex,
+		).
 		ColumnExpr(
 			"COUNT(*) FILTER (WHERE ort.phase_index < ?) AS completed_targets",
 			currentPhaseIndex,
@@ -148,7 +151,7 @@ func (s *PostgresStore) GetTargetPhaseAggregate(
 	}
 
 	return operationrun.TargetPhaseAggregate{
-		TotalPhases: row.TotalPhases,
+		NextPhaseIndex: row.NextPhaseIndex,
 		CompletedPhaseStats: operationrun.PhaseStats{
 			PhaseIndex:      max(currentPhaseIndex-1, 0),
 			SelectedTargets: row.CompletedTargets,
diff --git a/rest-api/flow/internal/operationrun/manager/store/store.go b/rest-api/flow/internal/operationrun/manager/store/store.go
index 4525c56e3c..a7b302e0d5 100644
--- a/rest-api/flow/internal/operationrun/manager/store/store.go
+++ b/rest-api/flow/internal/operationrun/manager/store/store.go
@@ -32,6 +32,14 @@ type txKeyType struct{}
 
 var txKey = txKeyType{}
 
+// operationRunTotalPhasesColumn keeps detail and list summaries on the same
+// target-derived phase coordinate used by the dispatcher.
+const operationRunTotalPhasesColumn = `COALESCE((
+	SELECT MAX(phase_target.phase_index) + 1
+	FROM operation_run_target AS phase_target
+	WHERE phase_target.operation_run_id = orun.id
+), 0) AS total_phases`
+
 // PostgresStore persists operation runs using PostgreSQL via bun.
 type PostgresStore struct {
 	pg *cdb.Session
@@ -97,10 +105,12 @@ func (s *PostgresStore) Get(
 ) (*operationrun.OperationRun, error) {
 	var row dbmodel.OperationRun
 
-	err := s.idb(ctx).NewSelect().
+	q := s.idb(ctx).NewSelect().
 		Model(&row).
-		Where("orun.id = ?", id).
-		Scan(ctx)
+		ColumnExpr("orun.*").
+		ColumnExpr(operationRunTotalPhasesColumn).
+		Where("orun.id = ?", id)
+	err := q.Scan(ctx)
 	if err != nil {
 		if errors.Is(err, sql.ErrNoRows) {
 			return nil, fmt.Errorf("operation run %s not found: %w", id, sql.ErrNoRows)
@@ -119,11 +129,13 @@ func (s *PostgresStore) LockOperationRun(
 ) (*operationrun.OperationRun, error) {
 	var row dbmodel.OperationRun
 
-	err := s.idb(ctx).NewSelect().
+	q := s.idb(ctx).NewSelect().
 		Model(&row).
+		ColumnExpr("orun.*").
+		ColumnExpr(operationRunTotalPhasesColumn).
 		Where("orun.id = ?", id).
-		For("UPDATE").
-		Scan(ctx)
+		For("UPDATE")
+	err := q.Scan(ctx)
 	if err != nil {
 		if errors.Is(err, sql.ErrNoRows) {
 			return nil, fmt.Errorf("operation run %s not found: %w", id, sql.ErrNoRows)
@@ -174,7 +186,8 @@ func (s *PostgresStore) List(
 		"updated_at",
 		"started_at",
 		"finished_at",
-	).OrderExpr("orun.created_at DESC")
+	).ColumnExpr(operationRunTotalPhasesColumn).
+		OrderExpr("orun.created_at DESC")
 	if opts.Pagination != nil {
 		q = q.Offset(opts.Pagination.Offset).Limit(opts.Pagination.Limit)
 	}
diff --git a/rest-api/flow/internal/operationrun/manager/store/store_test.go b/rest-api/flow/internal/operationrun/manager/store/store_test.go
index 7a16204728..cf9ab02960 100644
--- a/rest-api/flow/internal/operationrun/manager/store/store_test.go
+++ b/rest-api/flow/internal/operationrun/manager/store/store_test.go
@@ -53,17 +53,95 @@ func newMockPostgresStore(t *testing.T) (*PostgresStore, sqlmock.Sqlmock) {
 	}, mock
 }
 
-func TestGetPreservesNoRowsForMissingRun(t *testing.T) {
+func TestPostgresStore_Get(t *testing.T) {
+	t.Run("preserves no rows for missing run", func(t *testing.T) {
+		store, mock := newMockPostgresStore(t)
+		id := uuid.MustParse("11111111-1111-1111-1111-111111111111")
+		mock.ExpectQuery("SELECT").
+			WillReturnError(sql.ErrNoRows)
+
+		run, err := store.Get(context.Background(), id)
+
+		require.Nil(t, run)
+		require.ErrorIs(t, err, sql.ErrNoRows)
+		require.ErrorContains(t, err, "operation run "+id.String()+" not found")
+		require.NoError(t, mock.ExpectationsWereMet())
+	})
+
+	t.Run("returns materialized phase count", func(t *testing.T) {
+		store, mock := newMockPostgresStore(t)
+		id := uuid.MustParse("11111111-1111-1111-1111-111111111111")
+		mock.ExpectQuery(`(?s)SELECT.*MAX\(phase_target\.phase_index\) \+ 1.*AS total_phases.*FROM "operation_run" AS "orun"`).
+			WillReturnRows(
+				sqlmock.NewRows([]string{"id", "total_phases"}).
+					AddRow(id, 2),
+			)
+
+		run, err := store.Get(context.Background(), id)
+
+		require.NoError(t, err)
+		require.Equal(t, int32(2), run.TotalPhases)
+		require.NoError(t, mock.ExpectationsWereMet())
+	})
+}
+
+func TestPostgresStore_LockOperationRunReturnsMaterializedPhaseCount(t *testing.T) {
 	store, mock := newMockPostgresStore(t)
 	id := uuid.MustParse("11111111-1111-1111-1111-111111111111")
-	mock.ExpectQuery("SELECT").
-		WillReturnError(sql.ErrNoRows)
+	mock.ExpectQuery(`(?s)SELECT.*MAX\(phase_target\.phase_index\) \+ 1.*AS total_phases.*FROM "operation_run" AS "orun".*FOR UPDATE`).
+		WillReturnRows(
+			sqlmock.NewRows([]string{"id", "total_phases"}).
+				AddRow(id, 2),
+		)
+
+	run, err := store.LockOperationRun(context.Background(), id)
 
-	run, err := store.Get(context.Background(), id)
+	require.NoError(t, err)
+	require.Equal(t, int32(2), run.TotalPhases)
+	require.NoError(t, mock.ExpectationsWereMet())
+}
 
-	require.Nil(t, run)
-	require.ErrorIs(t, err, sql.ErrNoRows)
-	require.ErrorContains(t, err, "operation run "+id.String()+" not found")
+func TestPostgresStore_List(t *testing.T) {
+	store, mock := newMockPostgresStore(t)
+	id := uuid.MustParse("11111111-1111-1111-1111-111111111111")
+	mock.ExpectQuery(`SELECT count\(\*\) FROM "operation_run" AS "orun"`).
+		WillReturnRows(sqlmock.NewRows([]string{"count"}).AddRow(1))
+	mock.ExpectQuery(`(?s)SELECT.*MAX\(phase_target\.phase_index\) \+ 1.*AS total_phases.*FROM "operation_run" AS "orun"`).
+		WillReturnRows(
+			sqlmock.NewRows([]string{"id", "total_phases"}).
+				AddRow(id, 2),
+		)
+
+	runs, total, err := store.List(context.Background(), operationrun.ListOptions{})
+
+	require.NoError(t, err)
+	require.Equal(t, int32(1), total)
+	require.Len(t, runs, 1)
+	require.Equal(t, int32(2), runs[0].TotalPhases)
+	require.NoError(t, mock.ExpectationsWereMet())
+}
+
+func TestPostgresStore_GetTargetPhaseAggregate(t *testing.T) {
+	store, mock := newMockPostgresStore(t)
+	runID := uuid.MustParse("11111111-1111-1111-1111-111111111111")
+	mock.ExpectQuery(`(?s)SELECT.*MIN\(ort\.phase_index\).*next_phase_index.*FROM operation_run_target AS ort`).
+		WillReturnRows(
+			sqlmock.NewRows([]string{
+				"next_phase_index",
+				"completed_targets",
+				"completed_completed",
+				"completed_failed",
+				"completed_terminated",
+				"completed_skipped",
+			}).AddRow(3, 1, 1, 0, 0, 0),
+		)
+
+	aggregate, err := store.GetTargetPhaseAggregate(context.Background(), runID, 1)
+
+	require.NoError(t, err)
+	require.NotNil(t, aggregate.NextPhaseIndex)
+	require.Equal(t, int32(3), *aggregate.NextPhaseIndex)
+	require.Equal(t, 1, aggregate.CompletedPhaseStats.SelectedTargets)
 	require.NoError(t, mock.ExpectationsWereMet())
 }
 
diff --git a/rest-api/flow/internal/operationrun/operationrun.go b/rest-api/flow/internal/operationrun/operationrun.go
index 57de9300e3..178c6dbacd 100644
--- a/rest-api/flow/internal/operationrun/operationrun.go
+++ b/rest-api/flow/internal/operationrun/operationrun.go
@@ -150,6 +150,9 @@ type OperationRun struct {
 	StatusReason      OperationRunStatusReason
 	StatusMessage     string
 	CurrentPhaseIndex int32
+	// TotalPhases is derived from materialized target phase indexes when runs
+	// are read; it is not persisted on the operation_run row.
+	TotalPhases       int32
 	Selector          json.RawMessage
 	Options           json.RawMessage
 	OperationTemplate json.RawMessage
diff --git a/rest-api/flow/internal/operationrun/progress.go b/rest-api/flow/internal/operationrun/progress.go
index e5066e680d..83439ab036 100644
--- a/rest-api/flow/internal/operationrun/progress.go
+++ b/rest-api/flow/internal/operationrun/progress.go
@@ -6,14 +6,14 @@ package operationrun
 // TargetPhaseSummary groups targets by the active rollout phase. The current
 // phase is the lowest phase index that still has non-terminal work.
 type TargetPhaseSummary struct {
-	TotalPhases         int32
+	NextPhaseIndex      *int32
 	CurrentPhaseTargets []*OperationRunTarget
 	CompletedPhaseStats PhaseStats
 	CurrentPhaseStats   PhaseStats
 }
 
 type TargetPhaseAggregate struct {
-	TotalPhases         int32
+	NextPhaseIndex      *int32
 	CompletedPhaseStats PhaseStats
 }
 
@@ -31,7 +31,7 @@ func NewTargetPhaseSummary(
 	currentPhaseTargets []*OperationRunTarget,
 ) TargetPhaseSummary {
 	summary := TargetPhaseSummary{
-		TotalPhases:         aggregate.TotalPhases,
+		NextPhaseIndex:      aggregate.NextPhaseIndex,
 		CurrentPhaseTargets: currentPhaseTargets,
 		CompletedPhaseStats: aggregate.CompletedPhaseStats,
 		CurrentPhaseStats:   PhaseStats{PhaseIndex: currentPhaseIndex},
@@ -44,17 +44,32 @@ func NewTargetPhaseSummary(
 
 // IsAllTerminal reports whether there is no remaining active target work.
 func (s TargetPhaseSummary) IsAllTerminal() bool {
-	return s.TotalPhases > 0 &&
-		s.CurrentPhaseStats.PhaseIndex+1 >= s.TotalPhases &&
-		s.CurrentPhaseStats.AllTargetsTerminal()
+	return !s.HasNextPhase() && s.CurrentPhaseTerminal()
 }
 
 func (s TargetPhaseSummary) CurrentPhaseTerminal() bool {
 	return s.CurrentPhaseStats.AllTargetsTerminal()
 }
 
+// CurrentPhaseEmpty reports whether the persisted phase index has no targets.
+// New plans use contiguous materialized indexes, but older runs can contain
+// gaps when percentage or equal phase sizes rounded to zero.
+func (s TargetPhaseSummary) CurrentPhaseEmpty() bool {
+	return s.CurrentPhaseStats.SelectedTargets == 0
+}
+
 func (s TargetPhaseSummary) HasNextPhase() bool {
-	return s.TotalPhases > 0 && s.CurrentPhaseStats.PhaseIndex+1 < s.TotalPhases
+	_, ok := s.NextPhase()
+	return ok
+}
+
+// NextPhase returns the next materialized phase index, including across legacy
+// phase-index gaps.
+func (s TargetPhaseSummary) NextPhase() (int32, bool) {
+	if s.NextPhaseIndex == nil {
+		return 0, false
+	}
+	return *s.NextPhaseIndex, true
 }
 
 // TerminalRunStatus returns the terminal run status implied by an all-terminal
diff --git a/rest-api/flow/internal/operationrun/progress_test.go b/rest-api/flow/internal/operationrun/progress_test.go
index 85a78214ce..16d9221dcf 100644
--- a/rest-api/flow/internal/operationrun/progress_test.go
+++ b/rest-api/flow/internal/operationrun/progress_test.go
@@ -11,6 +11,7 @@ import (
 )
 
 func TestNewTargetPhaseSummaryCombinesAggregateAndCurrentStats(t *testing.T) {
+	nextPhaseIndex := int32(3)
 	currentSubmitted := &OperationRunTarget{
 		PhaseIndex: 1,
 		Status:     OperationRunTargetStatusSubmitted,
@@ -22,7 +23,7 @@ func TestNewTargetPhaseSummaryCombinesAggregateAndCurrentStats(t *testing.T) {
 	summary := NewTargetPhaseSummary(
 		1,
 		TargetPhaseAggregate{
-			TotalPhases: 3,
+			NextPhaseIndex: &nextPhaseIndex,
 			CompletedPhaseStats: PhaseStats{
 				PhaseIndex:      0,
 				SelectedTargets: 2,
@@ -37,6 +38,9 @@ func TestNewTargetPhaseSummaryCombinesAggregateAndCurrentStats(t *testing.T) {
 
 	require.False(t, summary.IsAllTerminal())
 	require.True(t, summary.HasNextPhase())
+	gotNextPhaseIndex, ok := summary.NextPhase()
+	require.True(t, ok)
+	require.Equal(t, int32(3), gotNextPhaseIndex)
 	require.Equal(t, 4, summary.SelectedTargetCount())
 	require.Equal(t, 1, summary.FailedOrTerminatedTargetCount())
 	require.EqualValues(t, 1, summary.CurrentPhaseStats.PhaseIndex)
@@ -58,6 +62,7 @@ func TestNewTargetPhaseSummaryCombinesAggregateAndCurrentStats(t *testing.T) {
 }
 
 func TestTargetPhaseSummaryTerminalRunStatus(t *testing.T) {
+	nextPhaseIndex := int32(3)
 	tests := []struct {
 		name                    string
 		summary                 TargetPhaseSummary
@@ -67,7 +72,6 @@ func TestTargetPhaseSummaryTerminalRunStatus(t *testing.T) {
 		{
 			name: "still active",
 			summary: TargetPhaseSummary{
-				TotalPhases: 2,
 				CurrentPhaseStats: PhaseStats{
 					PhaseIndex:      1,
 					SelectedTargets: 1,
@@ -78,10 +82,22 @@ func TestTargetPhaseSummaryTerminalRunStatus(t *testing.T) {
 			name:    "no targets",
 			summary: TargetPhaseSummary{},
 		},
+		{
+			name: "current phase completed with later materialized phase",
+			summary: TargetPhaseSummary{
+				NextPhaseIndex: &nextPhaseIndex,
+				CurrentPhaseStats: PhaseStats{
+					PhaseIndex:      1,
+					SelectedTargets: 1,
+					StatusCounts: TargetStatusCounts{
+						Completed: 1,
+					},
+				},
+			},
+		},
 		{
 			name: "all completed",
 			summary: TargetPhaseSummary{
-				TotalPhases: 1,
 				CurrentPhaseStats: PhaseStats{
 					SelectedTargets: 2,
 					StatusCounts: TargetStatusCounts{
@@ -95,7 +111,6 @@ func TestTargetPhaseSummaryTerminalRunStatus(t *testing.T) {
 		{
 			name: "completed with failures",
 			summary: TargetPhaseSummary{
-				TotalPhases: 1,
 				CurrentPhaseStats: PhaseStats{
 					SelectedTargets: 2,
 					StatusCounts: TargetStatusCounts{
@@ -110,7 +125,6 @@ func TestTargetPhaseSummaryTerminalRunStatus(t *testing.T) {
 		{
 			name: "all failed",
 			summary: TargetPhaseSummary{
-				TotalPhases: 1,
 				CurrentPhaseStats: PhaseStats{
 					SelectedTargets: 2,
 					StatusCounts: TargetStatusCounts{
@@ -190,10 +204,38 @@ func TestTargetPhaseSummaryCurrentPhaseNotStarted(t *testing.T) {
 	}
 }
 
+func TestTargetPhaseSummaryCurrentPhaseEmpty(t *testing.T) {
+	tests := []struct {
+		name    string
+		targets []*OperationRunTarget
+		want    bool
+	}{
+		{name: "empty", want: true},
+		{
+			name: "has target",
+			targets: []*OperationRunTarget{
+				{Status: OperationRunTargetStatusPending},
+			},
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			summary := NewTargetPhaseSummary(
+				1,
+				TargetPhaseAggregate{},
+				tt.targets,
+			)
+
+			require.Equal(t, tt.want, summary.CurrentPhaseEmpty())
+		})
+	}
+}
+
 func TestEvaluateSafetyGatesReturnsFirstTrippedGate(t *testing.T) {
 	summary := NewTargetPhaseSummary(
 		1,
-		TargetPhaseAggregate{TotalPhases: 2},
+		TargetPhaseAggregate{},
 		[]*OperationRunTarget{
 			{
 				PhaseIndex: 1,
diff --git a/rest-api/openapi/spec.yaml b/rest-api/openapi/spec.yaml
index 4b872fd17e..cad517739b 100644
--- a/rest-api/openapi/spec.yaml
+++ b/rest-api/openapi/spec.yaml
@@ -23138,7 +23138,9 @@ components:
     TaskRunEqualPhases:
       title: TaskRunEqualPhases
       type: object
-      description: Splits targets into `phaseCount` roughly equal phases.
+      description: |-
+        Splits targets into up to `phaseCount` roughly equal phases. Phases that
+        would contain no selected targets are omitted.
       required:
         - phaseCount
       properties:
@@ -23149,7 +23151,10 @@ components:
     TaskRunPercentagePhases:
       title: TaskRunPercentagePhases
       type: object
-      description: Splits targets by percentage. Values must sum to 100.
+      description: |-
+        Splits targets by percentage. Values must sum to 100. A configured
+        phase is omitted when its percentage rounds down to zero selected
+        targets.
       required:
         - phases
       properties:
diff --git a/rest-api/sdk/standard/model_task_run_equal_phases.go b/rest-api/sdk/standard/model_task_run_equal_phases.go
index 211bd6aec0..5ad0535d47 100644
--- a/rest-api/sdk/standard/model_task_run_equal_phases.go
+++ b/rest-api/sdk/standard/model_task_run_equal_phases.go
@@ -22,7 +22,7 @@ import (
 // checks if the TaskRunEqualPhases type satisfies the MappedNullable interface at compile time
 var _ MappedNullable = &TaskRunEqualPhases{}
 
-// TaskRunEqualPhases Splits targets into `phaseCount` roughly equal phases.
+// TaskRunEqualPhases Splits targets into up to `phaseCount` roughly equal phases. Phases that would contain no selected targets are omitted.
 type TaskRunEqualPhases struct {
 	// Number of equally sized phases.
 	PhaseCount int32 `json:"phaseCount"`
diff --git a/rest-api/sdk/standard/model_task_run_percentage_phases.go b/rest-api/sdk/standard/model_task_run_percentage_phases.go
index 6fd0c497d3..94c455ddaf 100644
--- a/rest-api/sdk/standard/model_task_run_percentage_phases.go
+++ b/rest-api/sdk/standard/model_task_run_percentage_phases.go
@@ -22,7 +22,7 @@ import (
 // checks if the TaskRunPercentagePhases type satisfies the MappedNullable interface at compile time
 var _ MappedNullable = &TaskRunPercentagePhases{}
 
-// TaskRunPercentagePhases Splits targets by percentage. Values must sum to 100.
+// TaskRunPercentagePhases Splits targets by percentage. Values must sum to 100. A configured phase is omitted when its percentage rounds down to zero selected targets.
 type TaskRunPercentagePhases struct {
 	// Per-phase percentages, in phase order; must sum to 100.
 	Phases []int32 `json:"phases"`