pbs_group_move
Move a backup group between namespaces within the same datastore. Use dry-run to plan, then confirm to execute the move.
Instructions
MUTATION: move a backup group to a different namespace within the same datastore.
RISK_MEDIUM — data-relocating, not destroying: sync/verify/prune jobs, ACL paths, and pull/push targets scoped to the OLD namespace silently stop seeing this group afterward. Dry-run by default (the PLAN discloses source ns, target ns, and the merge behavior including the upstream default); confirm=True executes (POST /admin/datastore/{store}/move-group, async — UPID; a null return records "ok") and tracks with pbs_tasks_list. Reverse with a second pbs_group_move. Needs PROXIMO_PBS_* config.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ns | No | SOURCE namespace; omit for the root namespace. | |
| store | Yes | PBS datastore name (source and target — same datastore). | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the move. | |
| backup_id | Yes | Backup group ID to move. | |
| target_ns | No | TARGET namespace; omit for the root namespace. | |
| backup_type | Yes | Backup type: vm, ct, or host. | |
| merge_group | No | Upstream default TRUE: if the group already exists in the target namespace, merge snapshots into it (requires matching ownership and non-overlapping snapshot times). False = fail instead. | |
| 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
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |