Volumes¶
Persistent block storage volumes backed by Ceph. Volumes can be attached to servers, detached and re-attached, and persist independently of server lifecycle.
Endpoints¶
| Method | Path | Description |
|---|---|---|
GET | /cloud/volumes?project_id=<uuid> | List volumes in a project |
GET | /cloud/volumes/{id}?project_id=<uuid> | Show a volume |
List volumes¶
Returns an array of volume objects.
Show a volume¶
Response fields:
| Field | Description |
|---|---|
id | OpenStack volume UUID |
name | Display name |
status | available, in-use, creating, deleting, error |
size | Size in GB |
volume_type | Storage tier/backend |
availability_zone | AZ where the volume resides |
bootable | Whether the volume can be used as a boot disk |
encrypted | Whether the volume is encrypted at rest |
multiattach | Whether the volume supports simultaneous attachment to multiple servers |
attachments | Array of {server_id, attachment_id, device, host_name} |
snapshot_id | Source snapshot UUID if created from a snapshot; null otherwise |
source_volid | Source volume UUID if cloned; null otherwise |
metadata | Key-value user metadata |
Attach and detach¶
Volume attach/detach operations are performed directly through OpenStack (via the dashboard or the b'nerd CLI) — the API currently exposes read operations only. Use DELETE /cloud/servers/{id} with delete_on_termination: true on the attachment to auto-delete a volume when its server is removed.