pbs_node_disk_initgpt
Initialize a GPT partition table on a whole PBS disk. Dry-run returns a plan; confirm executes the irreversible operation.
Instructions
MUTATION: initialize a GPT partition table on a whole PBS disk.
RISK_HIGH: overwrites the existing partition table on the named disk; irreversible — less destructive than pbs_node_disk_wipe, which also erases the underlying data and accepts a partition target. Dry-run by default (returns a PLAN); confirm=True executes (POST /nodes/{node}/disks/initgpt, Smoke-confirm) and returns {"status": "submitted", "result": <task UPID | None>}. Needs PROXIMO_PBS_* config.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| disk | Yes | Bare WHOLE-disk name to initialize with a new GPT partition table (e.g. 'sda', 'nvme0n1') — NOT a /dev/ path and NOT a partition; overwrites the existing partition table. | |
| node | No | PBS node name (or 'localhost'). | localhost |
| uuid | No | Optional UUID to assign to the new GPT table. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the irreversible GPT init. | |
| 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 |