HP 3PAR Web Service API 1.3.1 Developer's Guide

Errors for Resynchronizing a Physical Copy to Its VV Set, or Stopping a Physical Copy
of a VV Set
For possible errors following a request to synchronize a physical copy to its VV set, or for stopping
the physical copy of a VV set, see “Physical Copy of VV set Creation Errors” (page 122).
Promoting a VV Set Virtual Copy
To promote a VV set virtual copy, use the HTTP PUT method on the following URL:
https://<storage_system>:8080/api/vi/volumesets/<volume_set_name>
where <volume_set_name> is the name of the VV set containing virtual copies that need to be
promoted. The message body is a JSON object with members as described in Table 115 (page
124).
Table 115 JSON Object Members of the Parameter Object for Promoting a VV-Set Virtual Copy
DescriptionIgnored ValuesAPI TypeJSON TypeMember
Specifies the promote
operation to be
Required field.setAction Enumnumberaction
performed on the VV
set.
If True, the promote
operation is executed
on an online volume.
BooleanOnline
The default setting is
False.
Does not apply to
online promote
Zero and negative
numbers.
taskPriorityEnumnumberpriority
operation or to stop
promote operation.
To stop the promote VV set virtual copy operation, see Table 114 (page 123).
VV Set Virtual Copy Promotion Success
Upon success, the HTTP code 200 OK is returned. The message body shows an array of task IDs
for each of the virtual copies in the VV set as well as an array of links which, by default, contains
an href to itself (“self”).
For example:
{
tasks: [2]
-0 {
taskid: 7650
}
-1 {
taskid: 7651
}
links: [ 1 ]
- 0: {
href: "https://<server_name>:<http{s}port>/api/v1/volumesets/vvset"
rel: "self"
}
}
When a VV set virtual copy promote operation is successfully stopped, the HTTP code 200 OK is
returned, with no message body.
124 Performing Copy Operations