pve_task_status
Retrieve the current status of a Proxmox task by its UPID. Returns running or stopped state and exit status for polling long-running operations.
Instructions
READ-ONLY: get an async Proxmox task's status by its UPID — running vs stopped, plus the exit status once it has finished.
No state change. Use it to poll long-running ops (migrate, snapshot, rollback, backup) that
return a UPID. Returns a dict with status and exitstatus. To block until the task completes
use pve_task_wait, and for its log output use pve_task_log. Pass node for a task on a
non-default node; omitting it falls back to the configured default node (the UPID is not parsed for the node).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | No | PVE node the task is running on. Omit to resolve it automatically. | |
| upid | Yes | Proxmox task UPID (unique process ID) returned by an async operation. | |
| proximo_target | No | Which configured Proxmox target to run this call against — a target name from your multi-target config (a specific PVE/PBS/PMG/PDM box). Omit to use the single/default target from the environment; the selection applies only to this call. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |