HP 3PAR Web Service API 1.3.1 Developer's Guide

https://<storage_system>:8080/api/v1/hostsets/<host_set_name>
To modify a VV set, use the HTTP PUT method in the following URI, with message body parameters
as shown in Table 69 (page 87):
https://<storage_system>:8080/api/v1/volumesets/<volume_set_name>
Table 69 Message Body JSON Objects Modifying a Host Set or VV Set
DescriptionIgnored ValuesAPI TypeJSON TypeMember
Add or remove.Zero and negative
values.
memEditOperationnumberaction
For enumeration of the
action JSON object,
see Table 114 (page
123).
New name of the set.NullName27stringnewName
New comment for the
VV set or host set.
Nullname255stringcomment
To remove the
comment, use “”.
The VV or host to be
added to or removed
from the set.
Nullarray of stringsetmembers
Zero and negative
values.
TaskPriorityEnumnumberpriority 1: high
2: medium
The default is 2,
medium. This applies
3: low
only if the action is 3
(resynchronize the
physical copy).
NOTE: Any user with the Super or Edit role can modify a host set or VV set.
Any role granted the hostset_set right can add a host to the host set or remove a host from
the host set.
Any role granted the vvset_set right can add VVs to the VV set or remove VVs from the VV set.
Hosts can be added to a host set, or volumes to a VV set, by using a glob-style pattern. A glob-style
pattern is not supported when removing hosts or volumes from sets.
Host-Set or VV-Set Modification Success
Upon successful modification of a host set or VV set, the HTTP code 200 OK is returned, and there
is no message body. The URI of the updated host will be returned in the location portion of the
response header:
/api/v1/hostsets/<host_set_name>
/api/v1/volumesets/<volume_set_name>
Host-Set or VV-Set Modification Errors
If an error occurs, the system returns one of the error codes shown in Table 70 (page 87) or
Table 112 (page 122), or a general error code as shown in Table 5 (page 22).
Table 70 Host-Set or VV-Set Modification Error Codes
DescriptionHTTP CodeAPI Error
The set already exists.400 Bad RequestEXISTENT_SET
Modifying a Host Set or VV Set 87