pve_ceph_osd_out
Exclude a Ceph OSD from the CRUSH acting set by marking it out, initiating data rebalance away from the OSD. Supports dry-run planning before execution.
Instructions
MUTATION: mark a Ceph OSD 'out' — excluded from the CRUSH acting set; triggers data rebalance/recovery AWAY from it.
RISK_MEDIUM. No upstream cmd-safety check exists for the 'out' action (cmd-safety's action enum is {stop, destroy} only — 'out' neither stops the daemon nor destroys anything). CAPTURE-or-declare: reads the OSD CRUSH tree before planning; if unreadable -> complete=False. Runs SYNCHRONOUSLY (schema: returns null) — dry-run by default (returns a PLAN); confirm=True executes (POST /nodes/{node}/ceph/osd/{osdid}/out) and returns {"status": "ok", "result": None}. No rollback primitive on this plane — revert with pve_ceph_osd_in.
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 mark out (0 is a valid id). | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the change. | |
| 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 |