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 *string
Proxmox host
Hostname or IP address of the Proxmox VE node (no scheme, no port).
node *string
Proxmox node name
Name of the cluster node that scopes all API calls (e.g. pve, node1).
targetNode *string
Target node
Name of the destination Proxmox node.
vmName *string
VM name or ID
Either a VM name (resolved at runtime) or an integer VMID.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150password string
Password
Password for ticket-based authentication.
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.
