HP 3PAR Web Service API 1.3.1 Developer's Guide

where:
• <vlun_id> is the VLUN identifier returned in the location header after the VLUN was created.
• <vlun_id> format can be one of the following:
<vvname>,<lunID>,<hostname>,<portPos>◦
◦ <vvname>,<lunID>,<hostname>
◦ <vvname>,<lunID>,,<portPos>
The <vvname> and <lunID> fields are mandatory. The <hostname> and <portPos> fields
are optional, but one or both of them must be specified.
NOTE: The use of patterns or sets in querying volumes and hosts is not supported in WSAPI 1.2.
In order to query a single instance of a VLUN object, the specific volume name and host name
must be specified.
Single-VLUN Query Success
In a single-VLUN query, there is no need for chunking, because the data sent back to the client is
small and there is no issue with memory allocation. The WSAPI server does not use chunked transfer
encoding when the request is for a single volume or VLUN.
Upon a successful VLUN query, the HTTP code 200 OK is returned.
Table 99 Message Body JSON Objects for Single-VLUN Query Response
DescriptionAPI TypeJSON TypeMember
Number of VLUN objects
returned.
int32numbertotal
VLUN properties.array of VLUN Property
objects
array of objectsmembers
(Since WSAPI 1.2
As with all collection queries, the total is the number objects in the collection.
NOTE: If no VLUN is specified with the volume name, LUN, and host and/or port, a
NON_EXISTENT_VLUN error is returned.
The members object is a JSON array of zero or more JSON objects as listed in Table 100 (page
109).
Table 100 JSON Objects for members object in Single-VLUN Query Response
DescriptionAPI TypeJSON TypeMember
LUN ID.int32numberlun
(Since WSAPI 1.2)
Volume name or VV set
name.
name31stringvolumeName
(For volumes, since WSAPI
1.2; for VV sets, since
WSAPI 1.3)
Host name or host set name.name31stringhostname
(For hosts, since WSAPI 1.2;
for host sets, since WSAPI
1.3)
Querying VLUNs 109