
Proxmox VE Migrate
CertifiedMigrate a QEMU virtual machine to another Proxmox VE node
Proxmox VE Migrate
Migrate a QEMU virtual machine to another Proxmox VE node
Initiates a live or offline migration of a QEMU VM to a target node via POST /nodes/{node}/qemu/{vmid}/migrate and waits for completion.
type: io.kestra.plugin.proxmox.vm.MigrateExamples
Migrate a VM to another node
id: migrate_vm
namespace: company.team
tasks:
- id: migrate
type: io.kestra.plugin.proxmox.vm.Migrate
host: "{{ secret('PROXMOX_HOST') }}"
username: "{{ secret('PROXMOX_USERNAME') }}"
password: "{{ secret('PROXMOX_PASSWORD') }}"
node: pve
vmName: my-vm
targetNode: pve2
Properties
host *Requiredstring
Proxmox host
Hostname or IP address of the Proxmox VE node (no scheme, no port).
node *Requiredstring
Proxmox node name
Name of the cluster node that scopes all API calls (e.g. pve, node1).
targetNode *Requiredstring
Target node
Name of the destination Proxmox node.
vmName *Requiredstring
VM name or ID
Either a VM name (resolved at runtime) or an integer VMID.
password string
Password
Password for ticket-based authentication.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
port integerstring
8006API port
Defaults to 8006.
tokenId string
API token ID
Full token identifier in the form user@realm!tokenname (e.g. root@pam!mytoken). Use together with tokenSecret.
tokenSecret string
API token secret
The UUID secret associated with the token ID.
username string
Username
PAM or PVE user in the form user@realm (e.g. root@pam). Required when using ticket-based auth.
verifySsl booleanstring
trueVerify SSL
Validate the server TLS certificate. Defaults to true; set to false only for trusted networks with self-signed Proxmox certificates.