HP 3PAR Web Service API 1.3.1 Developer's Guide

Table 51 Message Body JSON Objects for Host Creation (continued)
DescriptionIgnored ValuesMandatoryValue RangeJSON TypeMember
(Since WSAPI 1.2)
See
HostDescriptors.
NullNodescriptors objectHostDescriptorsdescriptors
(Since WSAPI 1.2)
When creating a host, the name is required. Other members are optional.
Host Creation Success
Upon successful creation of the host, the location portion of the response header contains the URI
for the newly created host in the following format:
/api/v1/hosts/<host_name>
For example:
URL: https://<Storage Server>:8080/api/v1/hosts
Post: {"name":"apitesthost","persona":5}
Response: HTTP/1.1 201 Created
with the location header:
/api/v1/hosts/apitesthost
Host Creation Errors
Table 52 (page 74) shows possible host creation errors. For generic API error codes, see
Table 5 (page 22).
Table 52 Host Creation Error Codes
DescriptionHTTP CodeAPI Error
Name not specified.400 Bad RequestINV_INPUT_MISSING_REQUIRED
(Since WSAPI 1.2)
Both iSCSINames and FCWWNs
are specified.
400 Bad RequestINV_INPUT_PARAM_CONFLICT
(Since WSAPI 1.2)
Host name, domain name, or
iSCSI name is too long.
400 Bad RequestINV_INPUT_EXCEEDS_LENGTH
(Since WSAPI 1.2)
Input string (for domain name,
iSCSI name, etc.) is empty.
400 Bad RequestINV_INPUT_EMPTY_STR
(Since WSAPI 1.2)
Any error from host-name or
domain-name parsing.
400 Bad RequestINV_INPUT_ILLEGAL_CHAR
(Since WSAPI 1.2)
More than 1024 WWNs or iSCSI
names are specified.
400 Bad RequestINV_INPUT_TOO_MANY_WWN_OR_iSCSI
(Since WSAPI 1.2)
The length of WWN is not 16.400 Bad RequestINV_INPUT_WRONG_TYPE
74 Working with Hosts