Body Required

  • name string

    Volume name

    Maximum length is 255.

  • size integer(int64)

    Volume size in GiB. When a snapshot ID is supplied, this defaults to the size of the source volume, but can be set to a larger value.

    Minimum value is 10.

  • labels object

    Resource labels

    Hide labels attributes Show labels attributes
  • Target block storage snapshot

    Hide block-storage-snapshot attribute Show block-storage-snapshot attribute
    • id string(uuid)

      Block storage snapshot ID


  • 200 application/json


    Hide response attributes Show response attributes object
    • id string(uuid)

      Operation ID

    • reason string

      Operation failure reason

      Values are incorrect, unknown, unavailable, forbidden, busy, fault, partial, not-found, interrupted, unsupported, or conflict.

    • Related resource reference

      Hide reference attributes Show reference attributes
      • id string(uuid)

        Reference ID

      • command string

        Command name

    • message string

      Operation message

    • state string

      Operation status

      Values are failure, pending, success, or timeout.

POST /block-storage
curl \
 -X POST \
 -H "Content-Type: application/json" \
 -d '{"name":"string","size":42,"labels":{"key":"string"},"block-storage-snapshot":{"id":"string"}}'
Request examples
  "name": "string",
  "size": 42,
  "labels": {
    "key": "string"
  "block-storage-snapshot": {
    "id": "string"
Response examples (200)
  "id": "string",
  "reason": "incorrect",
  "reference": {
    "id": "string",
    "link": "string",
    "command": "string"
  "message": "string",
  "state": "failure"