Removing A Host; Host Removal Success; Host Removal Errors; Querying Hosts - HP 3PAR StoreServ 7200 2-node Manual

Table 46 Host Modification Error Codes (continued)
API Error
EXPORTED_VLUN
NON_EXISTENT_PATH
LUN_HOSTPERSONA_CONFLICT
INV_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)
generic API error codes, see
Table 47 Host Removal Error Codes
API Error
NON_EXISTENT_HOST
HOST_IN_SET

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 Host Query JSON Objects
Member
name
persona
58 Working with Hosts
HTTP Code
409 Conflict
400 Bad Request
409 Conflict
404 Bad Request
shows the errors that can occur following a request for host removal. For
Table 5 (page
HTTP Code
404 Not Found
409 Conflict
Table 48 (page
JSON Type
string
number
Description
Setting persona with active export;
remove a host path on an active export.
Removing a non-existent path.
LUN number and persona capability
conflict.
Duplicate path specified.
17).
Description
Host not found.
Host is a member of a set.
(Since WSAPI 1.2)
58).
API Type
name31
HostPersona Enum
Description
Specifies the name of the
host.
(Since WSAPI 1.2)
ID of the persona to
assigned to the host.