pdm_pve_qemu_snapshot_rollback
Roll back a VM to a snapshot on a PDM-registered remote, with automatic safety snapshot and dry-run planning by default.
Instructions
MUTATION: roll a VM back to a snapshot on a PDM-registered remote (through PDM).
For a container use pdm_pve_lxc_snapshot_rollback; to roll back without PDM use pve_rollback. DESTRUCTIVE (discards current state). Takes an auto safety-snapshot first (fail-closed: no snapshot, no rollback) and returns its name as safety_snapshot — the handle to undo this rollback. Dry-run by default (PLAN); confirm=True submits and returns the Proxmox task UPID.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vmid | Yes | Numeric VMID of the target VM, as a string. | |
| remote | Yes | PDM-registered remote (Proxmox cluster) hosting the VM. | |
| confirm | No | False (default) returns a PLAN only; True runs it. | |
| snapname | Yes | Name of the snapshot to roll back to. | |
| 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
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |