Power Control
Read and change node power state, and run the coordinated rack cold reboot.
For definitions of execution modes and job polling, refer to Async jobs.
SetPowerState
rack_manager.RackManager/SetPowerState
SetPowerState controls the power state of a single node. Supports power on, power off, and power reset operations.
Request: SetPowerStateRequest
Response: SetPowerStateResponse
Errors: Refer to Conventions for how RMS reports failures. This RPC also returns these gRPC errors:
INVALID_ARGUMENT: Theoperationvalue is not a validPowerOperation.
Example request
Replace each <placeholder> with a real value. Define RMS_GRPCURL_FLAGS and RMS_ADDR as described in Getting started.
The rack_manager_client test client offers an equivalent command:
BatchSetPowerState
rack_manager.RackManager/BatchSetPowerState
BatchSetPowerState controls power for caller-supplied nodes without requiring them to be registered in RMS inventory.
Request: BatchSetPowerStateRequest
Response: BatchSetPowerStateResponse
Errors: Refer to Conventions for how RMS reports failures. This RPC also returns these gRPC errors:
INVALID_ARGUMENT: Theoperationvalue is not a validPowerOperation.
Example request
Replace each <placeholder> with a real value. Define RMS_GRPCURL_FLAGS and RMS_ADDR as described in Getting started.
The rack_manager_client test client offers an equivalent command:
GetPowerState
rack_manager.RackManager/GetPowerState
GetPowerState retrieves the current power state of a node. Returns the current state (ON, OFF, or UNKNOWN).
Request: GetPowerStateRequest
Response: GetPowerStateResponse
Errors: Refer to Conventions for how RMS reports failures.
Example request
Replace each <placeholder> with a real value. Define RMS_GRPCURL_FLAGS and RMS_ADDR as described in Getting started.
The rack_manager_client test client offers an equivalent command:
BatchGetPowerState
rack_manager.RackManager/BatchGetPowerState
BatchGetPowerState retrieves the current power state for caller-supplied nodes without requiring them to be registered in RMS inventory. Returns per-node power state along with batch status.
Request: BatchGetPowerStateRequest
Response: BatchGetPowerStateResponse
Errors: Refer to Conventions for how RMS reports failures.
Example request
Replace each <placeholder> with a real value. Define RMS_GRPCURL_FLAGS and RMS_ADDR as described in Getting started.
The rack_manager_client test client offers an equivalent command:
ExecuteColdReboot
rack_manager.RackManager/ExecuteColdReboot
ExecuteColdReboot orchestrates the full DGX GB200 rack COLD reboot sequence on caller-supplied nodes (no inventory registration required): gracefully shut down the compute trays over BMC, power off the power shelves, wait for capacitor discharge, power the shelves back on, wait for the compute/switch tray BMCs and switch NVOS to come up, then power on the compute nodes. Returns a coordinator job ID immediately; poll GetJobStatus on it: while running, execution_state is RUNNING and state_description reports the current stage by its rack-reboot runbook step number(s) (e.g. “Rack reboot step 7-8: …”); on completion or failure the full per-stage stage timeline is written to result_json. Runbook steps 9 (switch fabric provisioning) and 13 (post-reboot host/GPU verification) are out of scope. The sequence is fail-fast with no automated rollback.
The sequence stops at the first failed stage and does not roll back. The response job_id identifies the coordinator job.
Request: ExecuteColdRebootRequest
Response: ExecuteColdRebootResponse
Errors: Refer to Conventions for how RMS reports failures.
Example request
Replace each <placeholder> with a real value. Define RMS_GRPCURL_FLAGS and RMS_ADDR as described in Getting started.