pve_ceph_osd_destroy
Destroy a Ceph OSD with dry-run planning; confirm executes removal and initiates data rebalancing.
Instructions
MUTATION: destroy a Ceph OSD.
RISK_HIGH: data it held is recovered/rebalanced onto remaining OSDs — durability risk if too few replicas/OSDs remain. cmd-safety ADVISORY citation (action=destroy, service=osd) is included in the plan's blast_radius — fail-open, never a gate. CAPTURE-or-declare: reads the OSD CRUSH tree before planning (also readable directly via pve_ceph_osd_tree); if unreadable -> complete=False. Dry-run by default (returns a PLAN); confirm=True executes (DELETE /nodes/{node}/ceph/osd/{osdid}) and returns {"status": "submitted", "result": }. No rollback primitive on this plane — recreate with pve_ceph_osd_create (a NEW OSD, different id, not a byte-for-byte restore of this one's data).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | No | PVE node the OSD is on; defaults to the configured node if omitted. | |
| osdid | Yes | OSD ID to destroy (0 is a valid id). | |
| cleanup | No | If True, also destroy the underlying logical volumes (ceph-volume lvm zap --destroy + pvremove) and wipe leftover journal/block.db/block.wal partitions. Without this, LVs/partitions are left intact for inspection. | |
| 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |