Getting information about global-active device pairs

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 acquires a list of volume information and storage system information about the P-VOLs and S-VOLs that make up a global-active device pair. You can get information about a pair without specifying information about the remote storage system in the request message.
Important:

Pay attention to the number of concurrent executions of this API request. For details, see "Implementing retry processing".

Execution permission

Administrator user group (built-in user group)

Request line

GET base-URL/v1/objects/remote-copypairs

Request message

Object ID

None.

Query parameters

Parameter

Type

Filter Condition

replicationType

string

(Required) Specify the pair type.

GAD: global-active device

startLdevId

int

(Optional) Specify, as a decimal (base 10) number, the number of the first LDEV for which you want to acquire information about the pair.

Specify a value in the range from 0 to 65279.

If you specify this attribute, be sure to also specify the endLdevId attribute. The value of this attribute must be equal to or less than the value of endLdevId.

If this attribute is omitted, 0 is set.

endLdevId

int

(Optional) Specify, as a decimal (base 10) number, the number of the last LDEV for which you want to acquire information about the pair.

Specify a value in the range from 0 to 65279.

If you specify this attribute, be sure to also specify the startLdevId attribute. The value of this attribute must be equal to or greater than the value of startLdevId.

Specify these values so that the range indicated by the startLdevId and endLdevId attributes consists of no more than 2048 LDEVs.

If this attribute is omitted, 2047 will be set.

Body

None.

Response message

Body
{
  "data" : [ {
    "replicationType" : "GAD",
    "ldevId" : 8,
    "remoteSerialNumber" : "415008",
    "remoteStorageTypeId" : "M8",
    "remoteLdevId" : 22,
    "primaryOrSecondary" : "P-VOL",
    "muNumber" : 0,
    "status" : "PSUE",
    "isSSWS" : false,
    "createdLocalTime" : "2017-09-29T16:26:07",
    "quorumDiskId" : 1,
    "suspendedMode" : "BLOCK"
  }, {
    "replicationType" : "GAD",
    "ldevId" : 9,
    "remoteSerialNumber" : "415008",
    "remoteStorageTypeId" : "M8",
    "remoteLdevId" : 23,
    "primaryOrSecondary" : "P-VOL",
    "muNumber" : 2,
    "status" : "PSUS",
    "isSSWS" : false,
    "createdLocalTime" : "2017-10-02T09:46:36",
    "quorumDiskId" : 1,
    "suspendedMode" : "BLOCK"
  }, {
    "replicationType" : "GAD",
    "ldevId" : 73,
    "remoteSerialNumber" : "415008",
    "remoteStorageTypeId" : "M8",
    "remoteLdevId" : 2171,
    "primaryOrSecondary" : "P-VOL",
    "muNumber" : 0,
    "status" : "PAIR",
    "isSSWS" : false,
    "createdLocalTime" : "2018-11-04T01:12:39",
    "quorumDiskId" : 1,
    "suspendedMode" : "BLOCK"
  }, {
    "replicationType" : "GAD",
    "ldevId" : 93,
    "remoteSerialNumber" : "415008",
    "remoteStorageTypeId" : "M8",
    "remoteLdevId" : 25,
    "primaryOrSecondary" : "P-VOL",
    "muNumber" : 0,
    "status" : "PSUE",
    "isSSWS" : false,
    "createdLocalTime" : "2017-10-27T17:42:33",
    "quorumDiskId" : 1,
    "suspendedMode" : "BLOCK"
  }, {
    "replicationType" : "GAD",
    "ldevId" : 99,
    "remoteSerialNumber" : "415008",
    "remoteStorageTypeId" : "M8",
    "remoteLdevId" : 2163,
    "primaryOrSecondary" : "P-VOL",
    "muNumber" : 0,
    "status" : "PAIR",
    "isSSWS" : false,
    "createdLocalTime" : "2018-03-11T03:10:22",
    "quorumDiskId" : 1,
    "suspendedMode" : "BLOCK"
  } ]
}

Attribute

Type

Description

replicationType

string

Pair type

GAD: global-active device

ldevId

int

LDEV number of the volume on the local storage system.

remoteSerialNumber

string

Serial number of the remote storage system

remoteStorageTypeId

string

ID corresponding to the model of the remote storage system

  • R8: VSP G1000, VSP G1500, or VSP F1500

  • R9: VSP 5000 series
  • M8: VSP E series, VSP Gx00 models or VSP Fx00 models

remoteLdevId

int

LDEV number of the volume on the remote storage system

primaryOrSecondary

string

Attribute of the volume on the local storage system
  • P-VOL
  • S-VOL

muNumber

int

MU number

status

string

Pair status of the volume on the local storage system

For details, see the section about pair status transition (global-active device).

isSSWS

boolean

Indicates whether the state of the volume on the local storage system is SSWS.
  • true: The state of the volume is SSWS.
  • false: The state of the volume is not SSWS.

createdLocalTime

string

Time at which the pair was created.

The local time of the storage system is displayed in YYYY-MM-DDThh:mm:ss format.

quorumDiskId

int

Quorum disk ID

suspendedMode

string

Block or Remote instructions when a pair is suspended

  • BLOCK_IO: Block with I/O check

  • BLOCK: Block without I/O check

  • REMOTE: Remote

Status codes

For details on the status codes for the request that performs this operation, see the description of HTTP status codes.

Coding example

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X GET https://192.0.2.100/ConfigurationManager/v1/objects/remote-copypairs?replicationType=GAD