HP 3PAR Web Service API 1.3.1 Developer's Guide

6 Working with Host Sets and VV Sets
This chapter describes how to manage sets for VVs and hosts. The sections describe how to create,
modify, remove, and perform query operations on sets.
You can use this chapter to:
• Create a host set or VV set
• Modify a host set or VV set
• Remove a host set or VV set
• Query all host sets or VV sets
• Query single host sets or single VV sets
• Export a VLUN from a VV set
For information about exporting a VLUN to a host set, see “Creating a VLUN” (page 101).
Creating a Host Set or VV Set
To create a host set, use the HTTP POST in the following URI, with a message body as shown in
Table 67 (page 85):
https://:8080/api/v1/hostsets/<host_set_name>
To create a VV set, use the HTTP POST method in the following URI, with message body parameters
as shown in Table 67 (page 85):
https://<storage_system>:8080/api/v1/volumesets/
Table 67 Message Body JSON Objects for Host-Set and VV-Set Creation
DescriptionIgnored ValuesMandatoryAPI TypeJSON TypeMember
Name of the VV or
host set to be
created
None.
This is a required
field.
YesName27stringname
Comment for the
VV or host set.
Null, empty stringNoPrint255stringcomment
The domain in
which the VV or
Null, empty stringNoname31stringdomain
host set will be
created.
The VV or host to
be added to the
set.
NullNoarray of stringsetmembers
The existence of
the VV or host will
not be checked
NOTE: Any user with the Super or Edit role can create a host set or VV set.
Any role granted the hostset_set right can add hosts to a host set.
Any role granted the vvset_set right can add VVs to a 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.
For information about creating a snapshot of a VV set, see “Creating a VV-Set Snapshot” (page
119),
Creating a Host Set or VV Set 85