pve_ceph_osd_create
Creates a new Ceph OSD by reformatting a block device as BlueStore storage. Dry-run returns a plan; confirm executes the operation with data loss risk.
Instructions
MUTATION: create a new Ceph OSD, consuming and REFORMATTING dev as BlueStore storage.
RISK_HIGH: ALL existing data on dev (and on db_dev/wal_dev, if given) is destroyed. No
CAPTURE possible — this is a brand-new OSD, nothing existing to snapshot. Dry-run by default
(returns a PLAN); confirm=True executes (POST /nodes/{node}/ceph/osd) and returns {"status":
"submitted", "result": } — the NEW OSD's id is NOT in this response, only discoverable
afterward via pve_ceph_osd_tree. No rollback primitive on this plane — revert by destroying
the new OSD with pve_ceph_osd_destroy once its id is known.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dev | Yes | Block device to consume as a NEW Ceph OSD (e.g. '/dev/sdb'). ALL existing data on this device is destroyed. | |
| node | No | PVE node to create the OSD on; defaults to the configured node if omitted. | |
| db_dev | No | Dedicated block device for block.db (RocksDB metadata). Mutually exclusive with osds_per_device. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the create. | |
| wal_dev | No | Dedicated block device for block.wal (write-ahead log). Mutually exclusive with osds_per_device. | |
| encrypted | No | Enable OSD encryption (LUKS/dm-crypt). Default False. | |
| db_dev_size | No | Size in GiB for block.db (>=1). REQUIRES db_dev to also be set. | |
| wal_dev_size | No | Size in GiB for block.wal (>=0.5). REQUIRES wal_dev to also be set. | |
| 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. | |
| osds_per_device | No | OSD services per physical device (>=1) — for fast NVMe devices only. Mutually exclusive with db_dev/wal_dev. | |
| crush_device_class | No | Override the OSD's CRUSH device class (e.g. 'ssd', 'hdd', 'nvme'). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |