Sign in

v57

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

Machine power control

Execute power control actions for a specific Machine. When an Instance is attached to the Machine, acknowledgeAttachedInstance must be true.

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.

patch/v2/org/{org}/nico/machine/{machineId}/power

Request body

action'On' | 'GracefulShutdown' | 'ForceOff' | 'GracefulRestart' | 'ForceRestart' | 'ACPowercycle' required

Redfish power control action to apply to the Machine. ACPowercycle is not supported on Viking systems.

acknowledgeAttachedInstanceboolean

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

Example request

{
  "action": "ForceRestart",
  "acknowledgeAttachedInstance": true
}

Response

Machine power control request was accepted. The message is empty unless Core returns a power-manager warning.

messagestring required

Human-readable outcome of the request

Example response

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