get_guest_status
Retrieve live status for a specific guest on a named Proxmox node, including state, uptime, CPU, memory, swap, disk, network, and HA state. Read-only and safe for stopped guests, which return a partial warning.
Instructions
One guest's live status, on exactly the node named.
Read-only and idempotent. Returns state, uptime, CPU, memory, swap, disk read and write, network in and out, and the high-availability state.
A stopped guest is an answer, not a failure: it returns this model with its state, a
warning saying the live figures are not meaningful, and partial set. A vmid the cluster
does not report on the node named raises a structured error naming both.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | Yes | ||
| vmid | Yes | ||
| profile | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | Yes | ||
| vmid | Yes | ||
| cores | No | ||
| source | Yes | ||
| status | Yes | ||
| partial | No | ||
| profile | Yes | ||
| warnings | No | ||
| guest_type | Yes | ||
| collected_at | Yes | ||
| uptime_seconds | No | ||
| disk_read_bytes | No | ||
| disk_used_bytes | No | ||
| swap_used_bytes | No | ||
| disk_total_bytes | No | ||
| disk_write_bytes | No | ||
| network_in_bytes | No | ||
| swap_total_bytes | No | ||
| cpu_used_fraction | No | ||
| high_availability | No | ||
| memory_used_bytes | No | ||
| network_out_bytes | No | ||
| memory_total_bytes | No |