Resize a block storage volume

PUT /block-storage/{id}:resize-volume

This operation resizes a Block storage volume. Note: the volume can only grow, cannot be shrunk.

Path parameters

  • id string(uuid) Required

Body Required

  • size integer(int64) Required

    Volume size in GiB

    Minimum value is 11.


  • 200 application/json


    Hide response attributes Show response attributes object
    • labels object

      Resource labels

      Hide labels attributes Show labels attributes
    • instance object

      Volume attached instance, if any

      Hide instance attribute Show instance attribute
      • id string(uuid)

        Instance ID

    • name string

      Volume name

      Minimum length is 1, maximum length is 255.

    • state string

      Volume state

      Values are snapshotting, deleted, creating, detached, deleting, attaching, error, attached, or detaching.

    • size integer(int64)

      Volume size

      Minimum value is 10.

    • blocksize integer(int64)

      Volume block size

      Minimum value is 0.

    • Target block storage snapshot

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

        Block storage snapshot ID

    • id string(uuid)

      Volume ID

    • created-at string(date-time)

      Volume creation date

PUT /block-storage/{id}:resize-volume
curl \
 -X PUT{id}:resize-volume \
 -H "Content-Type: application/json" \
 -d '{"size":42}'
Request examples
  "size": 42
Response examples (200)
  "labels": {
    "key": "string"
  "instance": {
    "id": "string"
  "name": "string",
  "state": "snapshotting",
  "size": 42,
  "blocksize": 42,
  "block-storage-snapshots": [
      "id": "string"
  "id": "string",
  "created-at": "2024-05-04T09:42:00+00:00"