Deleting global-active device pairs in units of copy groups

REST API Reference Guide for Virtual Storage Platform 5000, Virtual Storage Platform E Series, and Virtual Storage Platform G/F Series

Version
93-07-0x
90-09-0x
88-08-10
Audience
anonymous
Part Number
MK-98RD9014-17
The following request deletes global-active device pairs by using the specified copy group. When the pairs are all deleted, the device groups are also deleted. You can specify a copy group on the primary volume side to delete pairs. Alternatively, you can specify a copy group on the secondary volume side to delete pairs. Before deleting pairs, specify the copy group to suspend the pairs, and then change the statuses of the pairs to suspension. If a copy group includes the primary volume and the secondary volume, you cannot specify a copy group to delete pairs. Before deleting a pair, lock the resources or make sure that the resources have not been locked by another user.

Execution permission

Storage Administrator (Provisioning) and Storage Administrator (Remote Copy)

Request line

DELETE base-URL/v1/objects/remote-mirror-copygroups/object-ID

Request message

Object ID

Specify the value of remoteMirrorCopyGroupId that was obtained by the processing to get information about the remote copy group. You can also specify the attributes and connect them with commas as follows:

remoteStorageDeviceId,copyGroupName,localDeviceGroupName,remoteDeviceGroupName

Attribute

Type

Description

remoteStorageDeviceId

string

(Required) Storage device ID of the remote storage system

copyGroupName

string

(Required) Copy group name

Specify a name consisting of 1 to 31 characters. The name is case sensitive.

localDeviceGroupName

string

(Required) Device group name in the local storage system

Specify a name consisting of 1 to 31 characters. The name is case sensitive.

remoteDeviceGroupName

string

(Required) Device group name in the remote storage system

Specify a name consisting of 1 to 31 characters. The name is case sensitive.

Query parameters

None.

Body

The following is a coding example of continuing to use the S-VOL after a suspended (S-LOCAL) pair is deleted:

{
  "isSvolToKeepUsing" : true
}

Attribute

Type

Description

isSvolToKeepUsing

boolean

(Optional) Specify the volume that continues I/O after pairs are deleted.

  • true: Deletes the pairs by specifying the S-VOL.

    The S-VOL continues I/O, and the reserved attribute of global-active device is set for the P-VOL. If you set true, you must suspend pairs in advance by specifying the S-VOL.

  • false: Deletes the pairs by specifying the P-VOL.

    The P-VOL continues I/O, and the reserved attribute of global-active device is set for the S-VOL. If you set false, you must suspend pairs in advance by specifying the P-VOL.

If this value is omitted, false is set.

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 copy group of the deleted global-active device pairs

Status codes

For details on the status codes of the request for this operation, see the section explaining HTTP status codes.

Coding example

curl -v -H "Accept: application/json" -H "Remote-Authorization:Session 10399a1ffce3489b9c3a823017462396" -H "Content-Type: application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X DELETE --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/v1/objects/remote-mirror-copygroups/886000123789,remoteCopyGroup,remoteCopyGroupP_,remoteCopyGroupS_