pve_clone
Clone a Proxmox guest to a new ID with options for full or linked clone. Dry-run by default to plan before execution; specify target storage for full clones.
Instructions
MUTATION: clone a guest to a new id. Dry-run by default; confirm=True. Async — returns a UPID (poll with pve_task_status). pool: place the new guest in a resource pool (needed when the token is pool-scoped). storage: target storage for the full clone's disks (full=True only) — keeps a clone off the source storage; refused for a linked clone (PVE only honors it on a full clone). To create a guest from scratch instead use pve_create_vm / pve_create_container.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| full | No | If true, make a full independent copy of the disks; if false (default), make a space-saving linked clone. | |
| kind | No | Guest type: `lxc` for a container or `qemu` for a VM. | lxc |
| name | No | Name to give the new cloned guest. | |
| node | No | PVE node the source guest runs on. Omit to resolve it automatically from the cluster. | |
| pool | No | Resource pool to place the new guest in — needed when the calling token is pool-scoped. | |
| vmid | Yes | Numeric ID of the source guest to clone — VMID for a QEMU VM or CTID for an LXC container. | |
| newid | Yes | Numeric ID to assign to the new cloned guest. | |
| confirm | No | Leave `false` (default) to get a dry-run PLAN; set `true` to execute the clone. | |
| storage | No | Target storage for the full clone's disks (full=True only); keeps the clone off the source storage. Refused for a linked clone. | |
| 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 |