Restoring ShadowImage pairs in units of copy groups

Execution permission

Storage Administrator (Local Copy)

Request line

POST base-URL/v1/objects/local-clone-copygroups/object-ID/actions/restore/invoke

Request message

Object ID

Specify the localCloneCopygroupId value obtained by getting the list of copy groups. You can also specify the following attributes and connect them with commas:

copyGroupName,pvolDeviceGroupName,svolDeviceGroupName

Attribute	Type	Description
copyGroupName	string	(Required) Specify the copy group name. Value should not exceed 31 characters. The name is case sensitive.
pvolDeviceGroupName	string	(Required) Specify the P-VOL device group name. Value should not exceed 31 characters. The name is case sensitive.
svolDeviceGroupName	string	(Required) Specify the S-VOL device group name. Value should not exceed 31 characters. The name is case sensitive.

Query parameters

None.

Body

{
  "parameters": {
    "quickMode": true,
    "copyPace": 10
  }
}

Attribute	Type	Description
quickMode	boolean	(Optional) Specify whether to run in quick mode. true: Performs execution in quick mode. false: Performs execution in normal mode. If this value is omitted, false is assumed.
copyPace	int	(Optional) Specify a value in the range from 1 to 15 to be the copy speed. The larger the value, the higher the speed.

Response message

Body

A job object is returned. For details on attributes other than affectedResources, see the section explaining job objects.

Attribute	Description
affectedResources	URL of the restored copy group

Action template

GET base-URL/v1/objects/local-clone-copygroups/object-ID/actions/restore

Status codes

The following table describes the meaning of the status code of the request for this operation. For details on other status codes, see the description on HTTP status codes.

Coding example

To get an action template:

curl -v -H "Accept: application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X GET https://192.0.2.100/ConfigurationManager/v1/objects/local-clone-copygroups/localCopyGroup1,localCopyGroup1P_,localCopyGroup1S_/actions/restore

To run the request after getting an action template:

curl -v -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X POST --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/v1/objects/local-clone-copygroups/localCopyGroup1,localCopyGroup1P_,localCopyGroup1S_/actions/restore/invoke