pve_ceph_fs_create
Create a Ceph filesystem (CephFS) with new metadata and data pools. Use dry-run to review the plan, then confirm to execute the operation.
Instructions
MUTATION: create a Ceph filesystem (CephFS).
RISK_MEDIUM: allocates a new metadata pool + data pool; requires at least one MDS to
actually serve it (pve_ceph_mds_create). name defaults to the literal 'cephfs' when
omitted. No upstream cmd-safety check exists for filesystem creation. CAPTURE-or-declare:
reads the current filesystem list before planning (also readable directly via
pve_ceph_fs_list, ADVERSARIAL — taint marked when tracking is on); if unreadable ->
complete=False. Dry-run by default (returns a PLAN); confirm=True executes (POST
/nodes/{node}/ceph/fs/{name}) and returns {"status": "submitted", "result": }. No
rollback primitive on this plane — revert with pve_ceph_fs_destroy(name=...).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Filesystem name; defaults to 'cephfs' if omitted. No ':', '/', or whitespace. | |
| node | No | PVE node to create the filesystem on; defaults to the configured node if omitted. | |
| pg_num | No | Number of placement groups for the backing data pool (8-32768, default 128). The metadata pool uses a quarter of this. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the create. | |
| add_storage | No | Configure the created CephFS as PVE storage for this cluster. Schema-defaults False. | |
| 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 |