Proxmox VE Rollback

Proxmox VE Rollback

Certified

Roll back a QEMU VM or LXC container to a snapshot on Proxmox VE

Issues a rollback via POST /nodes/{node}/qemu|lxc/{vmid}/snapshot/{snapname}/rollback and waits for the task to complete.

yaml
type: io.kestra.plugin.proxmox.snapshot.Rollback

Roll back a VM to a snapshot

yaml
id: rollback_snapshot
namespace: company.team

tasks:
  - id: rollback
    type: io.kestra.plugin.proxmox.snapshot.Rollback
    host: "{{ secret('PROXMOX_HOST') }}"
    username: "{{ secret('PROXMOX_USERNAME') }}"
    password: "{{ secret('PROXMOX_PASSWORD') }}"
    node: pve
    vmName: my-vm
    snapName: before-upgrade
Properties

Proxmox host

Hostname or IP address of the Proxmox VE node (no scheme, no port).

Proxmox node name

Name of the cluster node that scopes all API calls (e.g. pve, node1).

Snapshot name to roll back to

VM or container name or ID

VM or container name (resolved at runtime) or integer VMID.

Password

Password for ticket-based authentication.

Reference (ref) of the pluginDefaults to apply to this task.

Default8006

API port

Defaults to 8006.

DefaultVM
Possible Values
VMCONTAINER

Resource type

Resource type: vm or container.

API token ID

Full token identifier in the form user@realm!tokenname (e.g. root@pam!mytoken). Use together with tokenSecret.

API token secret

The UUID secret associated with the token ID.

Username

PAM or PVE user in the form user@realm (e.g. root@pam). Required when using ticket-based auth.

Defaulttrue

Verify SSL

Validate the server TLS certificate. Defaults to true; set to false only for trusted networks with self-signed Proxmox certificates.