diff --git a/v2/src/openstack-blockstorage-devguide.xml b/v2/src/openstack-blockstorage-devguide.xml index 84a779b..81dc80d 100644 --- a/v2/src/openstack-blockstorage-devguide.xml +++ b/v2/src/openstack-blockstorage-devguide.xml @@ -70,12 +70,24 @@ format="SVG" scale="60"/> This document is for software developers who develop - applications by using the OpenStack Block Storage Service Application Programming - Interface (API). + applications by using the OpenStack Block Storage Service + Application Programming Interface (API). + + 2013-12-14 + + + + Corrected code example for list volume details + request. + + + + + 2013-05-22 @@ -165,8 +177,8 @@ format="SVG" scale="60"/> xmlns:m="http://www.w3.org/1998/Math/MathML" xmlns:html="http://www.w3.org/1999/xhtml"> Overview - OpenStack Block Storage Service is a block-level storage solution that enables - you to: + OpenStack Block Storage Service is a block-level storage + solution that enables you to: Mount drives to OpenStack Cloud Servers to scale storage without paying for more compute @@ -780,29 +792,29 @@ X-Compute-Request-Id: req-8e0295cd-a283-46e4-96da-cae05cbfd1c7 &GET; /volumes Lists a summary of all volumes defined in Block - Storage that are accessible to the tenant who submits - the request. + Storage that the tenant who submits the request can + access. &GET; /volumes/volume_id - Lists detailed information for the specified + Lists detailed information for a specified volume. &POST; /volumes - Creates a new Block Storage volume. + Creates a Block Storage volume. &PUT; /volumes/volume_id - Updates the specified volume. + Updates a specified volume. &DELETE; /volumes/volume_id - Destroys the specified volume. + Deletes a specified volume. @@ -858,8 +870,8 @@ Accept: application/json &GET; /volumes - Lists volumes defined in Block Storage that are - accessible to the tenant who submits the request. + Lists volumes defined in Block Storage that the + tenant who submits the request can access. @@ -892,19 +904,19 @@ Accept: application/json &GET; /volumes/details - Lists detailed information for volumes defined in - Block Storage that are accessible to the tenant who - submits the request. + Lists detailed information for Block Storage volumes + that the tenant who submits the request can access. + - List Volumes: JSON Request + List Volume Details: JSON Request GET /&VERSION;/volumes/details Accept: application/json - List Volumes: JSON Response + List Volume Details: JSON Response Returns status code 200 on @@ -1091,8 +1103,8 @@ Accept: application/json &GET; /snapshots - Lists snapshots defined in Block Storage that are - accessible to the tenant who submits the request. + Lists snapshots defined in Block Storage that the + tenant who submits the request can access. @@ -1126,8 +1138,8 @@ Accept: application/json &GET; /snapshots/details Lists detailed information for snapshots defined in - Block Storage that are accessible to the tenant who - submits the request. + Block Storage that the tenant who submits the request + can access. @@ -1372,15 +1384,15 @@ Accept: application/json &GET; /backups - Lists backups defined in Block Storage that are - accessible to the tenant who submits the request. + Lists backups defined in Block Storage that the + tenant who submits the request can access. &GET; /backups/detail Lists detailed information for backups defined in - Block Storage that are accessible to the tenant who - submits the request. + Block Storage that the tenant who submits the request + can access. &GET; @@ -1457,8 +1469,8 @@ Accept: application/json &GET; /backups - Lists backups defined in Block Storage that are - accessible to the tenant who submits the request. + Lists backups defined in Block Storage that the + tenant who submits the request can access. @@ -1492,8 +1504,8 @@ Accept: application/json &GET; /backups/details Lists detailed information for backups defined in - Block Storage that are accessible to the tenant who - submits the request. + Block Storage that the tenant who submits the + request can access. diff --git a/v2/src/samples/volume_list_detail_response.json b/v2/src/samples/volume_list_detail_response.json index 9950842..2284e2f 100644 --- a/v2/src/samples/volume_list_detail_response.json +++ b/v2/src/samples/volume_list_detail_response.json @@ -1,32 +1,64 @@ { "volumes":[ { - "id":"45baf976-c20a-4894-a7c3-c94b7376bf55", + "status":"available", + "attachments":[ + + ], "links":[ { - "href":"http://54.241.241.145:8776/v2/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/45baf976-c20a-4894-a7c3-c94b7376bf55", + "href":"http://localhost:8776/v2/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/45baf976-c20a-4894-a7c3-c94b7376bf55", "rel":"self" }, { - "href":"http://54.241.241.145:8776/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/45baf976-c20a-4894-a7c3-c94b7376bf55", + "href":"http://localhost:8776/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/45baf976-c20a-4894-a7c3-c94b7376bf55", "rel":"bookmark" } ], - "name":"vol-004" + "availability_zone":"nova", + "os-vol-host-attr:host":"ip-10-168-107-25", + "source_volid":null, + "snapshot_id":null, + "id":"45baf976-c20a-4894-a7c3-c94b7376bf55", + "description":"Another volume.", + "name":"vol-004", + "created_at":"2013-02-25T06:36:28.000000", + "volume_type":"None", + "os-vol-tenant-attr:tenant_id":"0c2eba2c5af04d3f9e9d0d410b371fde", + "size":1, + "metadata":{ + "contents":"junk" + } }, { - "id":"5aa119a8-d25b-45a7-8d1b-88e127885635", + "status":"available", + "attachments":[ + + ], "links":[ { - "href":"http://54.241.241.145:8776/v2/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/5aa119a8-d25b-45a7-8d1b-88e127885635", + "href":"http://localhost:8776/v2/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/5aa119a8-d25b-45a7-8d1b-88e127885635", "rel":"self" }, { - "href":"http://54.241.241.145:8776/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/5aa119a8-d25b-45a7-8d1b-88e127885635", + "href":"http://localhost:8776/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/5aa119a8-d25b-45a7-8d1b-88e127885635", "rel":"bookmark" } ], - "name":"vol-003" + "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":"This is yet, another volume.", + "name":"vol-003", + "created_at":"2013-02-25T02:40:21.000000", + "volume_type":"None", + "os-vol-tenant-attr:tenant_id":"0c2eba2c5af04d3f9e9d0d410b371fde", + "size":1, + "metadata":{ + "contents":"not junk" + } } ] } \ No newline at end of file