pbs_node_disk_directory_create
Formats a raw disk and mounts it as a directory datastore on a PBS node. Irreversibly destroys any existing data on the disk.
Instructions
MUTATION: format a disk and mount it as a directory datastore on a PBS node.
RISK_HIGH: FORMATS the named disk immediately — any pre-existing data is destroyed, irreversibly. To see what already exists use pbs_node_disk_directory_list; to remove one use pbs_node_disk_directory_delete (note: PBS's delete has NO cleanup-disks option — it never wipes the disk). Dry-run by default (returns a PLAN); confirm=True executes (POST /nodes/{node}/disks/directory, 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 format (e.g. 'sda') — NOT a /dev/ path. | |
| name | Yes | Datastore name to create (3-32 chars, alnum/underscore start). | |
| node | No | PBS node name (or 'localhost'). | localhost |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the creation. | |
| filesystem | No | Filesystem to format with: 'ext4' or 'xfs'. PBS default is ext4 if omitted. | |
| add_datastore | No | If True, also register a PBS datastore using this directory. | |
| 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. | |
| removable_datastore | No | If True, mark the datastore as removable media. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |