Sign in
NVLink Domain

Firmware update NVLink Domains

Update firmware for one or more NVLink Domains identified by UUID. Flow resolves each NVLink Domain to its member Racks and creates one task per Rack.

Org must have an Infrastructure Provider entity. User must have authorization role with PROVIDER_ADMIN suffix.

patch/v2/org/{org}/nico/domain/nvlink/firmware

Request body

siteIdstring uuid required

ID of the Site

domainIdsstring[] required

UUIDs of the NVLink Domains to update. IDs must be unique after UUID normalization (case-insensitive).

versionstring nullable

Target firmware version. When empty, null, or omitted, use the default firmware version for each targeted component.

ruleIdstring uuid

Optional Operation Rule UUID. When set, pins every task spawned by this operation to the named rule and overrides Flow's default rule resolution.

overrideReadinessCheckboolean

When true, proceed even if one or more target components (or hosts on the owning rack for rack-scoped components) are reported as not ready by their persisted status. Intended for operator-supervised maintenance.

Example request

{
  "siteId": "550e8400-e29b-41d4-a716-446655440000",
  "domainIds": [
    "650e8400-e29b-41d4-a716-446655440001",
    "750e8400-e29b-41d4-a716-446655440002"
  ],
  "version": "24.11.0"
}

Response

OK

taskIdsstring[]

List of task IDs created for the firmware update operation

Example response

{
  "taskIds": [
    "550e8400-e29b-41d4-a716-446655440000"
  ]
}

Changes

Changed in 1 of the 90 revisions of this API.1