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バージョン対応表を参照してください。

ボディ

なし。

レスポンスメッセージ

ボディ

{
  "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