pve_agent_fs
Freeze guest I/O for consistent backups, thaw after snapshot, or run fstrim to reclaim unused storage space via the QEMU guest agent.
Instructions
MUTATION: fsfreeze-freeze, fsfreeze-thaw, or fstrim inside the guest via the qemu-agent.
Requires PROXIMO_ENABLE_AGENT=1, the VMID in PROXIMO_AGENT_ALLOWLIST, and a running guest agent inside the VM. Dry-run by default (returns a PLAN); confirm=True executes and returns {"status": "ok", "result": }. command: fsfreeze-freeze | fsfreeze-thaw | fstrim — freeze stalls guest I/O until thawed, so always pair them. Irreversible; no undo primitive on this plane.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | No | Proxmox node name hosting the guest; auto-detected if omitted. | |
| vmid | Yes | Numeric VM ID of the guest to operate on via the qemu-agent. | |
| command | Yes | Filesystem operation: fsfreeze-freeze, fsfreeze-thaw, or fstrim. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the command. | |
| 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 |