You can use the CloneMultipleVolumes method to create a clone of a group of specified volumes. You can assign a consistent set of characteristics to a group of multiple volumes when they are cloned together.
Before using the groupSnapshotID parameter to clone the volumes in a group snapshot, you must first create the group snapshot using the CreateGroupSnapshot API method or the web UI. Using groupSnapshotID is optional when cloning multiple volumes.
This method has the following input parameters:
Name | Description | Type | Default value | Required |
---|---|---|---|---|
access | New default access method for the new volumes if not overridden by information passed in the volume's array. | string | None | No |
enableSnapMirrorReplication | Determines whether the volume can be used for replication with SnapMirror endpoints. Possible values:
|
boolean | false | No |
groupSnapshotID | ID of the group snapshot to use as a basis for the clone. | integer | None | No |
newAccountID | New account ID for the volumes if not overridden by information passed in the volumes array. | integer | None | No |
volumes | Collection of members that you specify for the new volumes. Members:
|
JSON object array | None | Yes (volumeID) |
This method has the following return values:
Name | Description | Type |
---|---|---|
asyncHandle | A value returned from an asynchronous method call. | integer |
groupCloneID | Unique ID of the new group clone. | integer |
members | List of volumeIDs for the source and destination volume pairs. | JSON object array |
Requests for this method are similar to the following example:
{ "method": "CloneMultipleVolumes", "params": { "volumes": [ { "volumeID": 5 "name":"foxhill", "access":"readOnly" }, { "volumeID": 18 }, { "volumeID": 20 } ] }, "id": 1 }
This method returns a response similar to the following example:
{ "id": 1, "result": { "asyncHandle": 12, "groupCloneID": 4, "members": [ { "srcVolumeID": 5, "volumeID": 29 }, { "srcVolumeID": 18, "volumeID": 30 }, { "srcVolumeID": 20, "volumeID": 31 } ] } }
9.6