Description
Specify tenant ID and create a volume by using json parameter.
Request URL
Block Storage API v2
POST /v2/{tenant_id}/volumes
Request Paramters
| Parameter | Value | Style | Description |
|---|---|---|---|
| X-Auth-Token | User Token | header | |
| tenant_id | Tenant ID | URI | |
| source_volid (Optional) | plain | ||
| description (Optional) | plain | The volume description | |
| snapshot_id (Optional) | plain | ||
| size | plain | 200 or 500 are only allowed. | |
| name (Optional) | plain | Half-width alphanumeric, "-" and "_" are only allowed. The length should be of 1-255 characters. | |
| imageRef (Optional) | plain | ||
| bootable (Optional) | plain | ||
| metadata (Optional) | plain |
Normal response codes
Accepted (202)
Example
curl -i -X POST \
-H "Accept: application/json" \
-H "X-Auth-Token: 35941e7df872405d84e5b026dba8323c" \
-H "Content-Type: application/json" \
-d '{"volume":{"source_volid":null, "description":null,"snapshot_id":null,"size":200,"name":"gmo-vol","imageRef":null,"metadata":{}}}' \
https://block-storage.tyo1.cloud.z.com/v2/1864e71d2deb46f6b47526b69c65a45d/volumes
HTTP/1.1 202 Accepted
Date: Thu, 11 Dec 2014 11:17:52 GMT
Server: Apache
Content-Length: 820
Content-Type: application/json
{
"volume": {
"attachments": [],
"availability_zone": "nova",
"bootable": "false",
"consistencygroup_id": null,
"created_at": "2015-05-08T09:17:04.365238",
"description": null,
"encrypted": false,
"id": "40e84769-f99a-4d7f-8594-4d0db87bc7e4",
"links": [
{
"href": "https://block-storage.tyo1.cloud.z.com/v2/1864e71d2deb46f6b47526b69c65a45d/volumes/40e84769-f99a-4d7f-8594-4d0db87bc7e4",
"rel": "self"
},
{
"href": "https://block-storage.tyo1.cloud.z.com/1864e71d2deb46f6b47526b69c65a45d/volumes/40e84769-f99a-4d7f-8594-4d0db87bc7e4",
"rel": "bookmark"
}
],
"metadata": {},
"name": "gmo-vol",
"replication_status": "disabled",
"size": 200,
"snapshot_id": null,
"source_volid": null,
"status": "creating",
"user_id": "ea63fc7a16bb4250aff7e203198eea22",
"volume_type": "gnc_ext_ssd"
}
}