HP 3PAR Web Service API 1.3.1 Developer's Guide

Host-Set or VV-Set Creation Success
Upon successful creation of the host set, the location portion of the response header contains the
URI for the newly created host in the following format:
api/v1/hostsets/<host_set_name>
Upon successful creation of the VV set, the location portion of the response header contains the
URI for the newly created VV set in the following format:
api/v1/volumesets/<volume_set_name>
The system returns the following HTTP status code:
HTTP_CREATED
Host-Set or VV-Set Creation Errors
If an error occurs, the system returns one of the error codes shown in Table 68 (page 86), or a
general error code as shown in Table 5 (page 22).
Table 68 Host-Set or VV-Set Creation Error Codes
DescriptionHTTP CodeAPI Error
The set already exists.400 Bad RequestEXISTENT_SET
(Since WSAPI 1.3)
The domain does not exist.404 Not FoundNON_EXISTENT_DOMAIN
(Since WSAPI 1.3)
The host is in a domain set.409 ConflictMEMBER_IN_DOMAINSET
(Since WSAPI 1.3)
The object is already part of the
set.
409 ConflictMEMBER_IN_SET
(Since WSAPI 1.3)
Objects must be in the same
domain to perform the operation.
409 ConflictMEMBER_NOT_IN_SAME_DOMAIN
(Since WSAPI 1.3)
The volume has an internal
inconsistency error.
403 ForbiddenVV_IN_INCONSISTENT_STATE
(Since WSAPI 1.3)
The volume is being removed.403 ForbiddenVV_IS_BEING_REMOVED
(Since WSAPI 1.3)
The volume does not exist.404 Not FoundNON_EXISTENT_VOL
The host does not exist.404 Not FoundNON_EXISTENT_HOST
The operation is not allowed on
a system volume.
403 ForbiddenINV_OPERATION_VV_SYS_VOLUME
The operation is not allowed on
an internal volume.
403 ForbiddenINV_OPERATION_VV_INTERNAL_VOLUME
Invalid input (duplicate name).400 Bad RequestINV_INPUT_DUP_NAME
Modifying a Host Set or VV Set
To modify a host set, use the HTTP PUT method in the following URI, with a message body as shown
in Table 69 (page 87):
86 Working with Host Sets and VV Sets