Deleting a global-active device pair

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 the specified global-active device pair. As a result of deleting a pair, if there is no pair in the copy group, the copy group and the device group are also deleted. You can specify the primary volume to delete a pair. Alternatively, you can specify the secondary volume to delete a pair. Before deleting a pair, suspend the pair, and then change the status of the pair to suspension. 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-copypairs/object-ID

Request message

Object ID

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

remoteStorageDeviceId,copyGroupName,localDeviceGroupName,remoteDeviceGroupName,copyPairName

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.

copyPairName

string

(Required) Copy pair name

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 the pair is deleted.

  • true: Deletes the pair 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 pair 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 deleted global-active device pair

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-copypairs/886000123789,remoteCopyGroup,remoteCopyGroupP_,remoteCopyGroupS_,pair1