Skip to main content

Reboot

Schedule a reboot on the target host. The agent calls shutdown -r with the configured delay. When --delay is 0, the reboot happens immediately:

$ osapi client node power reboot --target web-01

Job ID: 550e8400-e29b-41d4-a716-446655440000

STATUS CHANGED ERROR ACTION DELAY
ok true reboot 0

Reboot with a 60-second delay and a broadcast message:

$ osapi client node power reboot --target web-01 \
--delay 60 --message "Scheduled maintenance reboot"

Job ID: 550e8400-e29b-41d4-a716-446655440000

STATUS CHANGED ERROR ACTION DELAY
ok true reboot 60

Broadcast reboot to all hosts at once:

$ osapi client node power reboot --target _all --delay 30

Job ID: 550e8400-e29b-41d4-a716-446655440000

HOSTNAME STATUS CHANGED ERROR ACTION DELAY
web-01 ok true reboot 30
mac-01 skipped unsupported platform

JSON Output

Use --json to get the full API response:

$ osapi client node power reboot --target web-01 --json
{"results":[{"hostname":"web-01","action":"reboot","delay":0,"changed":true,"status":"ok"}],"job_id":"..."}

Flags

FlagDescriptionDefault
--delaySeconds to wait before rebooting0
--messageOptional message to broadcast before reboot
-T, --targetTarget: _any, _all, hostname, or label (group:web)_all
-j, --jsonOutput raw JSON response