Hitachi

Hitachi Command Suite Configuration Manager REST API リファレンスガイド


14.4 リモートコピーグループの一覧を取得する

対象のストレージシステム内のリモートコピーペア(TrueCopyUniversal Replicatorglobal-active device)が登録されているすべてのリモートコピーグループの一覧を取得します。デバイスグループ名やコピーグループ名に半角スペースが含まれている場合などは、コピーグループの情報を取得できません。

実行権限

ストレージ管理者(参照)

リクエストライン

GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/remote-mirror-copygroups

リクエストメッセージ

オブジェクトID

なし。

クエリパラメータ

リモートコピーグループの一覧だけを取得したり、リモートコピーグループの一覧に加えて、リモートコピーペアの詳細な情報を取得したりできます。

  • リモートコピーグループの一覧だけを取得する場合

    パラメータ

    フィルタ条件

    remoteStorageDeviceId

    string

    (必須)リモートストレージシステムのストレージデバイスID

    VSP 5000 シリーズVSP E シリーズVSP Gx00 モデルVSP G1000VSP G1500VSP Fx00 モデル、またはVSP F1500の場合、リモートストレージシステムの障害時などに、NotSpecifiedを指定すると、ローカルストレージシステム側の情報だけを取得します。このとき、Remote-Authorizationヘッダを指定する必要はありません。

    このパラメータにNotSpecifiedを指定した場合、detailInfoTypeパラメータとは同時に指定できません。

  • 詳細情報を追加して取得する場合

    パラメータ

    説明

    detailInfoType

    string

    (任意)取得する詳細情報のタイプ

    • pair

      リモートコピーペアの詳細な情報を追加します。

      ストレージシステムがVSP 5000 シリーズVSP E シリーズVSP Gx00 モデルVSP G1000VSP G1500VSP Fx00 モデルVSP F1500の場合に指定できます。VSP E シリーズVSP G150、G350、G370、G700、G900VSP F350、F370、F700、F900の場合、SVP と連携する構成のときに指定できます。

      最新の情報を取得する場合、事前にストレージシステムの構成情報のキャッシュを更新するAPI を実行する必要があります。詳細については、「ストレージシステムの構成情報のキャッシュを更新する」の説明を参照してください。

    remoteStorageDeviceIdパラメータにNotSpecifiedを指定した場合、このパラメータと同時に指定できません。

    注※ リモートストレージシステムがVSP E シリーズVSP G150、G350、G370、G700、G900VSP 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

クエリパラメータでdetailInfoTypepairを指定して実行すると、リモートコピーグループの情報に加えて次の情報も取得されます。

属性

説明

copyPairs

object[]

リモートコピーペアの詳細情報が出力されます。

情報が取得できない場合、copyPairsオブジェクト配下の属性は出力されません。

  • copyGroupName(string)

    コピーグループ名

  • copyPairName(string)

    コピーペア名

  • replicationType(string)

    ペア種別

    • TCTrueCopy
    • URUniversal Replicator
    • GADglobal-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の場合だけ0255の値が出力されます。ペア種別が取得できない場合は出力されません。

  • svolJournalId(int)

    S-VOLのジャーナルID

    Universal Replicatorの場合だけ0255の値が出力されます。ペア種別が取得できない場合は出力されません。

  • quorumDiskId(int)

    QuorumディスクID

    global-active deviceの場合だけ031の値が出力されます。ペア種別が取得できない場合は出力されません。

  • pvolStatus(string)

    P-VOLのペア状態

    詳細については、ペアの状態遷移(TrueCopyUniversal Replicator)またはペアの状態遷移(global-active device)の説明を参照してください。

    ペア状態が取得できない場合は出力されません。

    Universal Replicatorの場合、Universal Replicatorペアの遷移中の状態がSuspendingまたはDeletingのときは出力されません。

  • svolStatus(string)

    S-VOLのペア状態

    詳細については、ペアの状態遷移(TrueCopyUniversal 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マルチターゲット構成の場合に出力されます。

    • HOLDUniversal Replicatorのデルタリシンクペア(通常)
    • HLDEUniversal Replicator のデルタリシンクペア(失敗)
    • HOLDINGUniversal 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