Table 46 Host Modification Error Codes (continued)
DescriptionHTTP CodeAPI Error
Setting persona with active export;
remove a host path on an active export.
409 ConflictEXPORTED_VLUN
Removing a non-existent path.400 Bad RequestNON_EXISTENT_PATH
LUN number and persona capability
conflict.
409 ConflictLUN_HOSTPERSONA_CONFLICT
Duplicate path specified.404 Bad RequestINV_INPUT_DUP_PATH
Removing a Host
To remove a host, use the HTTP DELETE method. Use the following URI:
https://<storage system>:8080/api/v1/hosts/<host-name>
NOTE: Any user with Super or Edit role, or any role granted the host_remove right, can perform
this operation. Access to all domains is required for this operation.
Host Removal Success
Upon success, the HTTP code 200 OK is returned with no message body.
Host Removal Errors
Table 47 (page 58) shows the errors that can occur following a request for host removal. For
generic API error codes, see Table 5 (page 17).
Table 47 Host Removal Error Codes
DescriptionHTTP CodeAPI Error
Host not found.404 Not FoundNON_EXISTENT_HOST
Host is a member of a set.409 ConflictHOST_IN_SET
(Since WSAPI 1.2)
Querying Hosts
Query hosts using the HTTP GET method. Use the following URI with no message body:
https://<storage system>:8080/api/v1/hosts
To query a single host, use the following URI with no message body:
https://<storage system>:8080/api/v1/hosts/<host name>
Host Query Success
Unless an error occurs, the response will include a message body that is a JSON array of zero or
more JSON objects, as shown in Table 48 (page 58).
Table 48 Host Query JSON Objects
DescriptionAPI TypeJSON TypeMember
Specifies the name of the
host.
name31stringname
(Since WSAPI 1.2)
ID of the persona to
assigned to the host.
HostPersona Enumnumberpersona
58 Working with Hosts