pve_storage_create
Define a new cluster storage entry in Proxmox VE, supporting dir, nfs, pbs, and cifs types. Dry-run mode returns a plan; confirm writes the configuration.
Instructions
MUTATION: define a new cluster storage entry in storage.cfg (dir / nfs / pbs / cifs / …).
This registers a storage definition the cluster can use; it does NOT format disks or provision
a backend — to create a disk-backed backend (lvm/zfs/directory) on a node use
pve_node_storage_backend_create. Required params depend on storage_type (dir needs path; nfs
needs server+export). MEDIUM risk — a bad definition can fail to mount and slow cluster
storage enumeration; no existing data is touched. Dry-run by default (returns a PLAN);
confirm=True writes storage.cfg (the confirm result payload is typically null).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | Filesystem path (required for storage_type='dir'). | |
| nodes | No | Comma-separated node list this storage is available on; omit for all nodes. | |
| export | No | NFS export path (required for storage_type='nfs'). | |
| server | No | Remote host address (required for nfs/cifs/pbs). | |
| shared | No | If True, marks storage as shared across all nodes. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the creation. | |
| content | No | Comma-separated content types to allow, e.g. 'iso,backup,images'. | |
| disable | No | If True, storage is created in a disabled state. | |
| storage | Yes | New storage ID (name used across the cluster). | |
| storage_type | Yes | PVE storage driver type, e.g. 'dir', 'nfs', 'pbs'. | |
| 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 |