Snapshots
Create, list, restore, and delete VM snapshots.
Create, list, restore, and delete VM snapshots using libvirt’s built-in snapshot support.
Usage
Parameters
vm_name: VM name (required)snap_action:create/list/restore/delete(required)snapshot_name: snapshot name (auto-generated for create; required for restore/delete)snapshot_desc: description (optional, create only)halt: shutdown VM before snapshot for disk consistency, then restore to previous state (optional, create only, default:true)confirm: safety flag (required for restore and delete)
Behavior
- halt=true (default): If VM is running → shutdown → snapshot → start (restore running state). If VM is off → snapshot → remain off (preserve off state).
- halt=false: Create snapshot while VM is running (live snapshot). Faster but may have incomplete disk writes.
- Restore returns the VM to the exact state at snapshot time (running or off depending on snapshot state).