Creating a Block Storage volume via the API
Published on 10 January 2020
Identity and Access Management (IAM):
If you have activated IAM, you may need certain IAM permissions to carry out some actions described on this page. This means:
- you are the Owner of the Scaleway Organization in which the actions will be carried out, or
- you are an IAM user of the Organization, with a policy granting you the necessary permission sets
Requirements:
- You have a Scaleway account
- You have configured your API keys
- Create a block volume from the API by launching the following command:
$ curl -q \
-H "X-Auth-Token: $SECRET_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{"name": "block-volume-101", "organization": "'$SCW_ORGANIZATION'", "size": 10000000000, "volume_type": "b_ssd"}' \
https://api.scaleway.com/instance/v1/zones/fr-par-1/volumes - To retrieve the current status of the block volume, query the volume endpoint.
$ curl -q \
-H "X-Auth-Token: $SECRET_KEY" \
-H 'Content-Type: application/json' \
https://api.scaleway.com/instance/v1/zones/fr-par-1/volumes/b3a42fb1-e85c-46e9-b0a6-9adb62278295
{
"volume": {
"size": 10000000000,
"state": "available",
"name": "block-volume101",
"modification_date": "2019-09-03T09:57:53.742130+00:00",
...
"id": "b3a42fb1-e85c-46e9-b0a6-9adb62278295",
"volume_type": "b_ssd",
"server": null
}
}
See Also