pve_ceph_pool_create
Create a Ceph pool on a Proxmox node with customizable replication, placement groups, and CRUSH rules. Supports dry-run planning and erasure coding.
Instructions
MUTATION: create a Ceph pool.
RISK_MEDIUM: consumes cluster capacity per its size/pg_num settings. No upstream cmd-safety check exists for pool creation (cmd-safety's service enum is {osd, mon, mds} — covers neither pool nor filesystem). CAPTURE-or-declare: reads the current pool list before planning (also readable directly via pve_ceph_pool_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/pool) and returns {"status": "submitted", "result": }. No rollback primitive on this plane — revert with pve_ceph_pool_destroy(name=...).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name of the new pool. Must be unique; no ':', '/', or whitespace. | |
| node | No | PVE node to create the pool on; defaults to the configured node if omitted. | |
| size | No | Number of replicas per object (1-7, default 3). | |
| pg_num | No | Number of placement groups (1-32768, default 128). | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the create. | |
| min_size | No | Minimum number of replicas per object to allow I/O (1-7, default 2). | |
| crush_rule | No | CRUSH rule NAME to use for object placement (a string — NOT the numeric id pve_ceph_pool_list returns for this same field; pve_ceph_pool_status's crush_rule is ALREADY the same string type, no divergence there). | |
| pg_num_min | No | Minimum placement-group count the autoscaler may choose (<=32768, no declared lower bound). | |
| application | No | Pool application: 'rbd' (default), 'cephfs', or 'rgw'. | |
| target_size | No | Estimated target size for the PG autoscaler: a number optionally suffixed with K/M/G/T (e.g. '10G'). | |
| add_storages | No | Register a PVE storage entry using the new pool. Schema-defaults False for replicated pools, True for erasure-coded pools; omit to let PVE apply that default. | |
| erasure_coding | No | Create an erasure-coded pool instead of replicated: a PVE propertyString 'k=<int>,m=<int>[,device-class=<class>][,failure-domain=<domain>][,profile=<profile>]' (k>=2 data chunks, m>=1 coding chunks required). Also creates an accompanying replicated metadata pool. | |
| 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. | |
| pg_autoscale_mode | No | PG autoscaler mode: 'on', 'off', or 'warn' (default). | |
| target_size_ratio | No | Estimated target ratio of total pool capacity, for the PG autoscaler. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |