Suggest an edit

Increasing Block Storage volumes via the Instance API

Reviewed on 19 February 2024Published on 10 January 2020
Security & Identity (IAM)

To perform certain actions described below, you must either be the Owner of the Organization in which the actions will be performed or an IAM user with the necessary permissions.

  • You have a Scaleway account
  • You have configured your API keys
  • You have a Block Storage volume
  1. Inspect the volume and verify its name, size, and if the type is b_ssd by running the following request.

    curl -q -H "X-Auth-Token: $SECRET_KEY" -X GET<REGION>/volumes/<VOLUME_ID>

    Replace REGION with the geographical region of the Instance. This value can either be fr-par-1, fr-par-2, or fr-par-3 for Instances located in Paris, nl-ams-1, nl-ams-2 or nl-ams-3 for Instances located in Amsterdam, or pl-waw-1, pl-waw-2, or pl-waw-3 for Instances located in Warsaw. Replace VOLUME_ID with the unique identifier of the volume, which can be found on the Scaleway console under Instances > Volumes > More info (for the selected volume).

    The following response should appear as an output:

    {"volume": {"creation_date": "2020-06-02T08:04:50.094118+00:00", "server": null, "id": "<VOLUME_ID>", "size": 25000000000, "name": "myAwesomeVolume", "zone": "<REGION>", "export_uri": null, "volume_type": "b_ssd", "modification_date": "2020-06-02T08:04:50.094118+00:00", "state": "available", "organization": "<ORGANIZATION_ID>"}}
  2. To modify the volume size, run the request below:

    curl -H "X-Auth-Token: $SECRET_KEY" -X PATCH -H 'Content-Type: application/json;charset=utf-8' --data '{ "name":"new_name", "size":26000000000 }'

Replace REGION and VOLUME_ID following the guidelines mentioned previously and replace the existing size value with the new one.


You can use the same request to change the name of your volume by replacing new_name with another of your choice. If you do not wish to change the volume name, erase "name":"new_name", from the request before running it.

A response appears confirming the changes:

{"volume": {"creation_date": "2020-06-02T08:04:50.094118+00:00", "server": null, "id": "VOLUME_ID", "size": 26000000000, "name": "new_name", "zone": "REGION", "export_uri": null, "volume_type": "b_ssd", "modification_date": "2020-06-02T08:08:27.385208+00:00", "state": "resizing", "organization": "ORGANIZATION_ID"}}
See also
Attaching a Block Storage volume via the Instance APIDetaching a Block Storage volume via the Instance API
Cloud Products & Resources
  • Scaleway Console
  • Compute
  • Storage
  • Network
  • IoT
  • AI
Dedicated Products & Resources
  • Dedibox Console
  • Dedibox Servers
  • Network
  • Web Hosting
  • Blog
  • Careers
  • Scaleway Learning
Follow us
ContractsLegal NoticePrivacy PolicyCookie PolicyDocumentation license
© 1999-2024 – Scaleway SAS