pdm_pve_qemu_migrate
Migrate a QEMU VM to a different node within a Proxmox cluster using PDM. Supports live migration (online) and dry-run planning before submission.
Instructions
MUTATION: migrate a VM to another node within the remote's cluster (through PDM).
For a container use pdm_pve_lxc_migrate; for a different remote/datacenter use pdm_pve_qemu_remote_migrate; to drive a cluster directly without PDM use pve_guest_migrate. online=True migrates it running; the default requires it stopped first. Dry-run by default (PLAN); confirm=True submits and returns a PDM task reference — track it with pdm_tasks_list (pve_task_status cannot poll a PDM UPID).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vmid | Yes | Numeric VMID of the VM to migrate, as a string. | |
| online | No | True live-migrates the VM; else it must be stopped. | |
| remote | Yes | PDM-registered remote (Proxmox cluster) currently hosting the VM. | |
| target | Yes | Destination node name within the same remote's cluster. | |
| confirm | No | False (default) returns a PLAN only; True submits it. | |
| 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
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |