Increasing Block Storage volumes via the Instance API

The Instances API allows you to interact with Block Storage volumes programmatically through API calls. To increase the size of a volume using the Block Storage API, refer to the dedicated documentation.

Before you startLink to this anchor

To complete the actions presented below, you must have:

• A Scaleway account logged into the console
• Owner status or IAM permissions allowing you to perform actions in the intended Organization
• A valid API key
• A Block Storage volume attached to an Instance

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 https://api.scaleway.com/instance/v1/zones/<REGION>/volumes/<VOLUME_ID>
   

   Note

   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 https://api.scaleway.com/instance/v1/zones/REGION/volumes/VOLUME_ID -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.

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"}}