HP 3PAR Web Service API 1.3.1 Developer's Guide

Table 45 Storage Volume Removal Error Codes
DescriptionHTTP CodeAPI Error
The volume does not exist.404 Not FoundNON_EXISTENT_VOL
The volume retention time has not expired.409 ConflictRETAINED
The volume has read-only child.409 ConflictHAS_RO_CHILD
The volume has child VV.409 ConflictHAS_CHILD
(Since WSAPI 1.2)
The volume is in use by VV set, VLUN, etc.409 ConflictIN_USE
(Since WSAPI 1.2)
Querying Volume Information
Querying All Volumes
To query for storage volume information, use the HTTP GET method in the URI, with no message
body:
https://<storage_system>:8080/api/v1/volumes
All-Volumes Query Success
As of WSAPI 1.3, in order to support a large number of volumes and VLUNs in the HP 3PAR OS,
HTTP chunked transfer encoding is used to send a response in chunked format. The HTTP response
header will be similar to the following example:
HTTP/1.1 200 OK
Date: Fri, 22 May 2013 18:05:43 GMT
Server: hp3par-wsapi
Cache-Control: no-cache
Pragma: no-cache
Content-Type: application/json
Connection: close
Transfer-Encoding: chunked
Each chunk starts with the chunk-size field, which is a string of hexadecimal digits and a
terminating carriage-return and linefeed (CRLF) sequence followed by the chunk data. The chunk
is terminated by CRLF. The last chunk is a regular chunk, except that its length is zero.
Unless an error occurs, the response includes a message body with JSON objects total and
members. The total object is the number of objects in the members array. The members object
contains an array of zero or more JSON objects, one for each volume on the system. JSON object
members are shown in Table 46 (page 68)
Table 46 Message Body JSON Objects for Volume Query
DescriptionAPI TypeJSON TypeMember
VV identifier.int32numberid
The UUID that was automatically
assigned to the volume at creation.
uuid stringstringuuid
VV namename31stringname
VV domainname31stringdomain
The provisioning for the VV.provisioningType EnumnumberprovisioningType
Indicates the copy type of the VV.copyType EnumnumbercopyType
68 Working with Storage Volumes