pve_node_disk_initgpt
Initialize a new GPT partition table on a disk, overwriting the existing table. Use dry-run mode to review changes before irreversible execution.
Instructions
MUTATION: initialize a GPT partition table on a node disk.
RISK_HIGH: overwrites the existing partition table on the named disk; irreversible — less destructive than pve_node_disk_wipe, which also erases the underlying data. Dry-run by default (returns a PLAN); confirm=True executes (POST /disks/initgpt, Smoke-confirm) and returns {"status": "submitted", "result": <task UPID | None>}.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| disk | Yes | Device path/identifier of the disk to initialize with a new GPT partition table (e.g. /dev/sda); overwrites the existing partition table. | |
| node | No | PVE node name the disk lives on; defaults to the configured node if omitted. | |
| 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 |