v57

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-08-012143051018.3 KB
BMC Reset

Reset Machine BMC

Reset the BMC of a specific Machine. When an Instance is attached to the Machine, acknowledgeAttachedInstance must be true.

If useIpmiTool is true, the BMC reset request may be silently ignored while the BMC is in lockdown mode.

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}/bmc/reset

Request body

useIpmiToolboolean

Reset the BMC via ipmitool instead of Redfish. The request may be silently ignored while the BMC is in lockdown mode.

acknowledgeAttachedInstanceboolean

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

Example request

{
  "useIpmiTool": true
}

Response

Machine BMC reset request was accepted

messagestring required

Human-readable outcome of the request

Example response

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