Sign in

v57

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-08-012143051018.3 KB
DPU Reprovision

Reprovision Machine DPUs

Trigger DPU reprovisioning for a Machine. Before calling this operation, create a Machine health report containing an alert whose ID is HostUpdateInProgress and whose classifications include PreventAllocations. When an Instance is attached to the Machine, acknowledgeAttachedInstance must be true.

For 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.

For 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.

patch/v2/org/{org}/nico/machine/{machineId}/dpu/reprovision

Request body

mode'Set' | 'Clear' | 'Restart' required

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.

updateFirmwareboolean

Deprecated compatibility field. Firmware is always verified and updated during reprovisioning.

acknowledgeAttachedInstanceboolean

Acknowledges that an Instance is currently attached to the Machine and this action may disrupt Tenant workload on the Instance.

Example request

{
  "mode": "Set",
  "updateFirmware": false
}

Response

DPU reprovisioning request was accepted

messagestring required

Human-readable outcome of the request

Example response

{
  "message": "Deletion request was accepted"
}