HP 3PAR Web Service API 1.3.1 Developer's Guide

Querying Host Information with WWN Filtering
To query a host with a given WWN or iSCSI name, use the HTTP GET method. You must specify
the FCPaths WWN or the iSCSIPaths name in the URI, as shown in the following example:
https://<storage_system>
:8080/api/v1/hosts?query=" FCPaths[wwn==5001438024226EAE OR wwn==20010002AC000999 OR
wwn==10000000C98C4D95] OR
iSCSIPaths[name==iqn.1991-05.com.microsoft:fakeISCSIHost1 OR
name==iqn.1991-05.com.microsoft:fakeISCSIHost2 OR
name==iqn.1991-05.com.microsoft:fakeISCSIHost3 OR
name==iqn.1991-05.com.microsoft:fakeISCSIHost4 OR
name==iqn.1991-05.com.microsoft:fakeISCSIHost5] "
Host Query with WWN Filtering Success
Upon a successful query filtering operation, a message body is returned with JSON object members
as shown in Table 66 (page 84).
Table 66 Message Body JSON Objects for Host Query with a WWN Filtering
DescriptionAPI TypeJSON TypeMember
Number of host objects
returned. If the host record
int32numbertotal
matching the WWN is
found, the number of hosts
will be 1; otherwise, it will
be 0.
Since WSAPI 1.3
Storage host properties.array of Host Property
objects.
array of objectsmembers
Since WSAPI 1.3
(An array of size 1 will be
returned if a host is found
matching the WWN;
otherwise, an empty array
will be returned.)
Host Query with WWN Filtering Errors
Possible errors following a query for host information with WWN filtering are shown in
Table 65 (page 83). For generic API error codes, see Table 5 (page 22).
84 Working with Hosts