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)


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":{}}}' \
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": "",
                "rel": "self"
                "href": "",
                "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"