Skip to content

Block Storage API

Cinder v3 · Microversion ceiling: 3.70 · OpenStack Antelope (2023.1)

Base URL: https://volume.{region}.rumble.cloud/v3/{project_id}

Upstream reference: OpenStack Block Storage API ↗ · Error handling: API errors

All requests require a Keystone token in the X-Auth-Token header. See Authentication for token issuance.
Microversion note: os-extend_volume_completion is not available; it requires microversion 3.71, above Quake AI's ceiling of 3.70.

Volumes

GET/v3/{project_id}/volumes
POST/v3/{project_id}/volumes
GET/v3/{project_id}/volumes/{volume_id}
PUT/v3/{project_id}/volumes/{volume_id}
DELETE/v3/{project_id}/volumes/{volume_id}
Examples

List volumes

curl -s -H "X-Auth-Token: $TOKEN" \
  https://volume.us-east-1.rumble.cloud/v3/{project_id}/volumes | jq '.volumes[] | {id, name, status}'

Create a volume: request body

curl -s -X POST -H "X-Auth-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  https://volume.us-east-1.rumble.cloud/v3/{project_id}/volumes \
  -d '{
  "volume": {
    "size": 10,
    "name": "my-volume",
    "description": "Data volume for my-server"
  }
}'

Key response fields: id, name, size, status, attachments

Snapshots

GET/v3/{project_id}/snapshots
POST/v3/{project_id}/snapshots
GET/v3/{project_id}/snapshots/{snapshot_id}
PUT/v3/{project_id}/snapshots/{snapshot_id}
DELETE/v3/{project_id}/snapshots/{snapshot_id}
Examples

Create a snapshot: request body

curl -s -X POST -H "X-Auth-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  https://volume.us-east-1.rumble.cloud/v3/{project_id}/snapshots \
  -d '{
  "snapshot": {
    "volume_id": "{volume_id}",
    "name": "my-snapshot",
    "description": "Pre-upgrade backup"
  }
}'

Key response fields: id, volume_id, status, size

Guides

Create a volume →Create a snapshot →Extend volume capacity →
← Network APIObject Storage / S3 API →