/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
with the location header:
/api/v1/hosts/apitesthost
Host Creation Errors
Table 41 (page 53) shows possible host creation errors. For generic API error codes, see
Table 5 (page 17).
Table 41 Host Creation Error Codes
DescriptionHTTP CodeAPI Error
Permission denied.403 ForbiddenPERM_DENIED
Name not specified.400 Bad RequestINV_INPUT_MISSING_REQUIRED
(Since WSAPI 1.2)
FCWWNs and iSCSINames are
both 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
WWN specification contains
non-hexadecimal digit.
(Since WSAPI 1.2)
iSCSI name or WWN is already
claimed by other host.
409 ConflictEXISTENT_PATH
(Since WSAPI 1.2)
host name is already used.409 ConflictEXISTENT_HOST
(Since WSAPI 1.2)
No space to create host.400 Bad RequestNO_SPACE
Creating a Host 53