pve_ceph_pool_destroy
Destroy a Ceph pool and all stored data. Dry-run by default; set confirm=True to execute.
Instructions
MUTATION: destroy a Ceph pool.
RISK_HIGH: destroys the pool and ALL data stored in it — UNRECOVERABLE via the API (a recreated pool with the same name is a fresh EMPTY pool, not a restore). No upstream cmd-safety check exists for pool destroy. 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 (DELETE /nodes/{node}/ceph/pool/{name}) and returns {"status": "submitted", "result": }. No rollback primitive on this plane.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name of the pool to destroy. | |
| node | No | PVE node the pool is on; defaults to the configured node if omitted. | |
| force | No | If True, destroys the pool EVEN IF IN USE. NEVER defaulted on — only forwarded when explicitly set. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the destroy. | |
| 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. | |
| remove_storages | No | Remove all pveceph-managed PVE storage entries configured for this pool. Schema-defaults False. | |
| remove_ecprofile | No | Remove the erasure-code profile too, if applicable. Schema-defaults True. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |