HP 3PAR Web Service API 1.3.1 Developer's Guide

9 Performing Copy Operations
You can use the WSAPI server to make snapshots of volumes and VV sets, make physical copies
of volumes and VV sets, resynchronize a physical copy to its parent volume or VV set, and to stop
a physical-copy operation.
Creating Snapshots
To create a snapshot of a volume, use the HTTP POST method in the URI:
https://<storage_system>:8080/api/v1/volumes/<volume_name>
where <volume_name> is the name of the volume being copied.
When creating a snapshot, the message body is a JSON object with two members, action and
parameters.
The action member is a string with the value createSnapshot and the parameters member
is a JSON object with members as described in Table 102 (page 112).
Table 102 Message Body parameters JSON Object Members for Snapshot Creation
DescriptionIgnored valuesAPI TypeJSON TypeMember
Specifies a snapshot VV name
up to 31 characters in length.
None (Required)name31stringname
Specifies the ID of the volume.
If not specified, the next
available ID is chosen.
Negative valuesigint32numberid
Specifies any additional
information up to 511
characters for the volume.
Noneprint511stringcomment
true: Specifies that the copied
volume is read-only.
NoneBooleanBooleanreadOnly
false: (default) The volume is
read-write.
Specifies the relative time from
the current time that the volume
Negative valuesigint32numberexpirationHours
will expire. Value is a positive
integer and in the range of
1–43,800 hours, or 1825
days.
Specifies the relative time from
the current time that the volume
Negative valuesigint32numberretentionHours
will expire. Value is a positive
integer and in the range of
1–43,800 hours, or 1825
days.
For information about creating a physical copy of a volume or VV set, see “Performing Copy
Operations” (page 112).
Creating a Physical Copy of a Volume
To create a physical copy of a volume, use the HTTP POST method in the URI:
https://<storage_system>:8080/api/v1/volumes/<volume_name>
where <volume_name> is the name of the volume being copied (not the name of the destination
volume).
112 Performing Copy Operations