Change server power state
VirtFusion supports boot, restart, shutdown and poweroff. TenantOS supports boot, restart and poweroff; graceful shutdown is refused rather than mapped to a hard power cut.
409 is the normal answer a few seconds after any other operation, including a console being closed: the panel queues one task per server. Back off and retry; it is not a failure.
No idempotency key in v1. boot and shutdown are safe to repeat; a retried restart
reboots the machine a second time, so a client that retries automatically should read
powerState first.
apiToken services:powerAuthorizationBearer <token>A personal API token: Authorization: Bearer dh_live_…. See Authentication for scopes.
Scope: services:power
id*integerThe service id, as returned by GET /v1/services.
application/json- body
action*string"boot""restart""shutdown""poweroff"The panel accepted the action. It is queued, not necessarily finished.
application/json- response
ok*booleanaction*string"boot""restart""shutdown""poweroff"taskId*integerThe task this call created. Find it by id in GET /v1/services/{id}/tasks to see whether it finished.
curl -X POST 'https://api.deluxhost.net/v1/services/0/power' \ -H "Authorization: Bearer $DELUXHOST_TOKEN" \ -H 'Content-Type: application/json' \ -d '{ "action": "boot"}'{ "ok": true, "action": "boot", "taskId": 0}Get server resource usage GET
`limitBytes: 0` means unmetered. `cpuPercent`, `memUsedMb` and `disks` come from the guest agent and are null or empty without it.
Get service metrics GET
What the server has been doing, from samples taken about every ten minutes. `/usage` answers the same question about *right now* with a live call to the panel; this one never leaves our process, which is why it can be polled and `/usage` cannot. `rxDeltaBytes` and `txDeltaBytes` are traffic **in that interval**, not since the beginning: the panel's counters are cumulative and reset monthly. They are null on the first point, which has no previous sample to subtract. An empty `points` is a normal answer — a service provisioned ten minutes ago has no samples, and one that is not a VirtFusion server never will.