Method | URI | Description |
---|---|---|
GET | /v2/{tenant_id}/volumes/{volume_id} | Shows information about a specified volume. |
Normal response codes: 200
This table shows the URI parameters for the show volume information request:
Name | Type | Description |
---|---|---|
| String | The unique identifier of the tenant or account. |
| UUID | The unique identifier of an existing volume. |
This operation does not require a request body.
Example 3.9. Show volume information: XML response
<?xml version='1.0' encoding='UTF-8'?> <volume xmlns:os-vol-image-meta="http://docs.openstack.org/openstack-block-storage/2.0/content/Volume_Image_Metadata.html" xmlns:os-vol-tenant-attr="http://docs.openstack.org/openstack-block-storage/2.0/content/Volume_Tenant_Attribute.html" xmlns:os-vol-host-attr="http://docs.openstack.org/openstack-block-storage/2.0/content/Volume_Host_Attribute.html" xmlns:atom="http://www.w3.org/2005/Atom" xmlns="http://docs.openstack.org/api/openstack-block-storage/2.0/content" status="available" name="vol-003" availability_zone="nova" created_at="2013-02-25 02:40:21" description="This is yet, another volume." volume_type="None" source_volid="None" snapshot_id="None" id="5aa119a8-d25b-45a7-8d1b-88e127885635" size="1" os-vol-tenant-attr:tenant_id="0c2eba2c5af04d3f9e9d0d410b371fde" os-vol-host-attr:host="ip-10-168-107-25"> <attachments/> <metadata> <meta key="contents">not junk</meta> </metadata> </volume>
Example 3.10. Show volume information: JSON response
{ "volume":{ "status":"available", "attachments":[ ], "links":[ { "href":"http://localhost:8776/v2/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/5aa119a8-d25b-45a7-8d1b-88e127885635", "rel":"self" }, { "href":"http://localhost:8776/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/5aa119a8-d25b-45a7-8d1b-88e127885635", "rel":"bookmark" } ], "availability_zone":"nova", "os-vol-host-attr:host":"ip-10-168-107-25", "source_volid":null, "snapshot_id":null, "id":"5aa119a8-d25b-45a7-8d1b-88e127885635", "description":"Super volume.", "name":"vol-002", "created_at":"2013-02-25T02:40:21.000000", "volume_type":"None", "os-vol-tenant-attr:tenant_id":"0c2eba2c5af04d3f9e9d0d410b371fde", "size":1, "metadata":{ "contents":"not junk" } } }
This operation does not return a response body.