14.4 リモートコピーグループの一覧を取得する
実行権限
ストレージ管理者(参照)
リクエストライン
GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/remote-mirror-copygroups
リクエストメッセージ
- オブジェクトID
-
なし。
- クエリパラメータ
-
リモートコピーグループの一覧だけを取得したり、リモートコピーグループの一覧に加えて、リモートコピーペアの詳細な情報を取得したりできます。
-
リモートコピーグループの一覧だけを取得する場合
パラメータ
型
フィルタ条件
remoteStorageDeviceId
string
(必須)リモートストレージシステムのストレージデバイスID
VSP 5000 シリーズ、VSP E シリーズ、VSP Gx00 モデル、VSP G1000、VSP G1500、VSP Fx00 モデル、またはVSP F1500の場合、リモートストレージシステムの障害時などに、NotSpecifiedを指定すると、ローカルストレージシステム側の情報だけを取得します。このとき、Remote-Authorizationヘッダを指定する必要はありません。
このパラメータにNotSpecifiedを指定した場合、detailInfoTypeパラメータとは同時に指定できません。
詳細情報を追加して取得する場合
パラメータ
型
説明
detailInfoType
string
(任意)取得する詳細情報のタイプ
- pair
リモートコピーペアの詳細な情報※を追加します。
ストレージシステムがVSP 5000 シリーズ、VSP E シリーズ、VSP Gx00 モデル、VSP G1000、VSP G1500、VSP Fx00 モデル、VSP F1500の場合に指定できます。VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合、SVP と連携する構成のときに指定できます。
最新の情報を取得する場合、事前にストレージシステムの構成情報のキャッシュを更新するAPI を実行する必要があります。詳細については、「ストレージシステムの構成情報のキャッシュを更新する」の説明を参照してください。
remoteStorageDeviceIdパラメータにNotSpecifiedを指定した場合、このパラメータと同時に指定できません。
注※ リモートストレージシステムがVSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合、リモートストレージシステム側の一部の情報が取得できないことがあります。
それ以外のストレージシステムの場合、次のどちらかの条件を満たすときは、リモートストレージシステム側の一部の情報が取得できないことがあります。
- リモートストレージシステム側を管理しているREST APIサーバが、Configuration Manager 10.0.0より前の場合
- リモートストレージシステムのマイクロコードが、Configuration Manager
10.0.0に対応しているマイクロコードのバージョンよりも古い場合
Configuration Manager 10.0.0に対応しているストレージシステムのマイクロコードのバージョンについては、Configuration Managerバージョン対応表を参照してください。
- pair
-
- ボディ
-
なし。
レスポンスメッセージ
- ボディ
-
{ "data" : [ { "remoteMirrorCopyGroupId" : "836000123789,remoteCopyGroup1,remoteCopyGroup1S_,remoteCopyGroup1P_", "copyGroupName" : "remoteCopyGroup1", "muNumber" : 0, "remoteStorageDeviceId" : "836000123789", "localDeviceGroupName" : "remoteCopyGroup1S_", "remoteDeviceGroupName" : "remoteCopyGroup1P_" }, { "remoteMirrorCopyGroupId" : "836000123789,remoteCopyGroup2,remoteCopyGroup2P_,remoteCopyGroup2S_", "copyGroupName" : "remoteCopyGroup2", "muNumber" : 0, "remoteStorageDeviceId" : "836000123789", "localDeviceGroupName" : "remoteCopyGroup2P_", "remoteDeviceGroupName" : "remoteCopyGroup2S_" }, { "remoteMirrorCopyGroupId" : "836000123789,remoteCopyGroup3,remoteCopyGroup3P_,remoteCopyGroup3S_", "copyGroupName" : "remoteCopyGroup3", "muNumber" : 0, "remoteStorageDeviceId" : "836000123789", "localDeviceGroupName" : "remoteCopyGroup3P_", "remoteDeviceGroupName" : "remoteCopyGroup3S_" } ] }
属性
型
説明
remoteStorageDeviceId
string
リモートストレージシステムのストレージデバイスID
remoteStorageDeviceIdにNotSpecifiedを指定した場合は、NotSpecifiedが出力されます。
copyGroupName
string
コピーグループ名
localDeviceGroupName
string
ローカルストレージシステム側のデバイスグループ名
remoteDeviceGroupName
string
リモートストレージシステム側のデバイスグループ名
remoteStorageDeviceIdにNotSpecifiedを指定した場合は、NotSpecifiedが出力されます。
muNumber
int
MU(ミラーユニット)番号
MU番号が取得できない場合は出力されません。
remoteMirrorCopyGroupId
string
リモートコピーグループのオブジェクトID
次の属性をコンマで連結した形式で出力されます。- remoteStorageDeviceId
- copyGroupName
- localDeviceGroupName
- remoteDeviceGroupName
クエリパラメータでdetailInfoTypeにpairを指定して実行すると、リモートコピーグループの情報に加えて次の情報も取得されます。
属性
型
説明
copyPairs
object[]
リモートコピーペアの詳細情報が出力されます。
情報が取得できない場合、copyPairsオブジェクト配下の属性は出力されません。
- copyGroupName(string)
コピーグループ名
- copyPairName(string)
コピーペア名
- replicationType(string)
ペア種別
- TC:TrueCopy
- UR:Universal Replicator
- GAD:global-active device
ペア状態がSMPLの場合は出力されません。
- pvolLdevId(int)
P-VOLのLDEV番号
- svolLdevId(int)
S-VOLのLDEV番号
- fenceLevel(string)フェンスレベル
- DATA:S-VOLデータ
- STATUS:S-VOL状態
- NEVER:なし
- ASYNC:非同期
フェンスレベルが取得できない場合は出力されません。
- pvolJournalId(int)
P-VOLのジャーナルID
Universal Replicatorの場合だけ0~255の値が出力されます。ペア種別が取得できない場合は出力されません。
- svolJournalId(int)
S-VOLのジャーナルID
Universal Replicatorの場合だけ0~255の値が出力されます。ペア種別が取得できない場合は出力されません。
- quorumDiskId(int)
QuorumディスクID
global-active deviceの場合だけ0~31の値が出力されます。ペア種別が取得できない場合は出力されません。
- pvolStatus(string)
P-VOLのペア状態
詳細については、ペアの状態遷移(TrueCopy/Universal Replicator)またはペアの状態遷移(global-active device)の説明を参照してください。
ペア状態が取得できない場合は出力されません。
Universal Replicatorの場合、Universal Replicatorペアの遷移中の状態がSuspendingまたはDeletingのときは出力されません。
- svolStatus(string)
S-VOLのペア状態
詳細については、ペアの状態遷移(TrueCopy/Universal Replicator)またはペアの状態遷移(global-active device)の説明を参照してください。
ペア状態が取得できない場合は出力されません。
Universal Replicatorの場合、Universal Replicatorペアの遷移中の状態がSuspendingまたはDeletingのときは出力されません。
- consistencyGroupId(int)
コンシステンシーグループID
コンシステンシーグループでない場合は出力されません。
- pvolIOMode(string)P-VOLのI/Oモード
- L/M:Mirror(RL)
- L/L:Local
- B/B:Block
global-active deviceの場合だけ出力されます。ペア状態がSMPLの場合は出力されません。
- svolIOMode(string)S-VOLのI/Oモード
- L/M:Mirror(RL)
- L/L:Local
- B/B:Block
global-active deviceの場合だけ出力されます。ペア状態がSMPLの場合は出力されません。
- pvolStorageDeviceId(string)
P-VOL側のストレージシステムのストレージデバイスID
- svolStorageDeviceId(string)
S-VOL側のストレージシステムのストレージデバイスID
- remoteMirrorCopyPairId(string)
リモートコピーペアのオブジェクトID
次の属性をコンマで連結した形式で出力されます。- remoteStorageDeviceId
- copyGroupName
- localDeviceGroupName
- remoteDeviceGroupName
- copyPairName
-
transitionStatus(string)
Universal Replicatorの場合に、ペアの遷移中の状態が出力されます。
- None:遷移中ではない
- Suspending:ペア分割中
- Deleting:ペア削除中
Universal Replicator以外の場合には出力されません。
-
copyPace(int)
コピー速度
Universal Replicatorの場合は出力されません。
-
pathGroupId(int)
RCUのパスグループID
リモートパスの接続設定がCU指定の場合は出力されません。
P-VOLのペア状態、またはS-VOLのペア状態がSMPLの場合は出力されません。
-
deltaStatus(string)
デルタリシンクを用いた3DCマルチターゲット構成の状態
ペア種別がUniversal Replicatorで、かつデルタリシンクを用いた3DCマルチターゲット構成の場合に出力されます。
- HOLD:Universal Replicatorのデルタリシンクペア(通常)
- HLDE:Universal Replicator のデルタリシンクペア(失敗)
- HOLDING:Universal Replicatorのデルタリシンクペアへ遷移中
ステータスコード
この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。
コード例
curl -v -H "Accept: application/json" -H "Remote-Authorization:Session 10399a1f-fce3-489b-9c3a-823017462396" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/remote-mirror-copygroups?remoteStorageDeviceId=836000123789