Hitachi

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


14.8 すべてのリモートコピーペアの情報を取得する

対象のストレージシステム内に登録されているリモートコピーペア(TrueCopyUniversal Replicatorglobal-active device)の情報の一覧を取得します。コピーグループで管理されているかどうかに関わらず、ストレージシステムのキャッシュからすべてのペアの情報が取得できます。リクエストメッセージにリモートストレージシステム側の情報を指定する必要はありません。
メモ
  • このAPIは、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 を実行する必要があります。詳細については、「ストレージシステムの構成情報のキャッシュを更新する」の説明を参照してください。

実行権限

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

リクエストライン

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

リクエストメッセージ

オブジェクトID

なし。

クエリパラメータ

パラメータ

フィルタ条件

startLdevId

int

(任意)LDEV番号の範囲を指定する場合の先頭のLDEV番号を指定します。

範囲内のLDEVからP-VOLまたはS-VOLを検索し、該当するペアの情報を取得します。

065279の値を指定します。

この属性には、endLdevIdパラメータ以下の値を指定する必要があります。

省略した場合は0が設定されます。

endLdevId

int

(任意)LDEV番号の範囲を指定する場合の末尾のLDEV番号を指定します。

範囲内のLDEVからP-VOLまたはS-VOLを検索し、該当するペアの情報を取得します。

065279の値を指定します。

この属性には、startLdevIdパラメータ以上の値を指定する必要があります。

省略した場合はストレージシステム内で最大のLDEV番号が設定されます。

replicationType

string

(任意)ペアの情報を取得するペア種別を指定します。

  • TCTrueCopy
  • URUniversal Replicator
  • GADglobal-active device
ボディ

なし。

レスポンスメッセージ

ボディ
{
    "data": [
        {
            "remoteReplicationId": "R8,51304,375,R8,51305,969",
            "muNumber": 2,
            "replicationType": "UR",
            "pvolLdevId": 375,
            "svolLdevId": 969,
            "fenceLevel": "ASYNC",
            "pvolJournalId": 10,
            "svolJournalId": 0,
            "pvolStatus": "PAIR",
            "consistencyGroupId": 17,
            "pvolStorageType": "R8",
            "pvolStorageSerial": "51304",
            "svolStorageType": "R8",
            "svolStorageSerial": "51305",
            "transitionStatus": "None",
            "pathGroupId": 0
        },
        {
            "remoteReplicationId": "R8,51304,378,R8,51305,765",
            "replicationType": "TC",
            "pvolLdevId": 378,
            "svolLdevId": 765,
            "fenceLevel": "DATA",
            "pvolStatus": "PAIR",
            "pvolStorageType": "R8",
            "pvolStorageSerial": "51304",
            "svolStorageType": "R8",
            "svolStorageSerial": "51305", 
            "copyPace": 3,
            "pathGroupId": 0
        },
        {
            "remoteReplicationId": "R8,51304,400,R8,51305,567",
            "muNumber": 0,
            "replicationType": "GAD",
            "pvolLdevId": 400,
            "svolLdevId": 567,
            "fenceLevel": "NEVER",
            "quorumDiskId": 4,
            "pvolStatus": "PAIR",
            "consistencyGroupId": 11,
            "pvolIOMode": "L/M",
            "pvolStorageType": "R8",
            "pvolStorageSerial": "51304",
            "svolStorageType": "R8",
            "svolStorageSerial": "51305",
            "copyPace": 7,
            "pathGroupId": 0
        }
    ]
}

属性

説明

remoteReplicationId

string

リモートコピーペアのオブジェクトID

次の属性をコンマで連結した形式で出力されます。
  • pvolStorageType
  • pvolStorageSerial
  • pvolLdevId
  • svolStorageType
  • svolStorageSerial
  • svolLdevId

remoteReplicationIdの値にUnknown-1が含まれる場合、正常なペアではないおそれがあります。ストレージシステムの状態を確認してください。

muNumber

int

MU(ミラーユニット)番号

replicationType

string

ペア種別

  • TCTrueCopy
  • URUniversal Replicator
  • GADglobal-active device

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のペアボリューム状態

指定したストレージシステムがP-VOL側のストレージシステムの場合だけ出力されます。

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

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

svolStatus

string

S-VOLのペアボリューム状態

指定したストレージシステムが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で、指定したストレージシステムがP-VOL側のストレージシステムの場合だけ出力されます。

svolIOMode

string

S-VOLのI/Oモード
  • L/M:Mirror(RL)
  • L/L:Local
  • B/B:Block

global-active deviceで、指定したストレージシステムがS-VOL側のストレージシステムの場合だけ出力されます。

pvolStorageType

string

P-VOL側のストレージシステムのモデルを示すID

  • R6Universal Storage Platform V/VM

  • R7Virtual Storage Platform

  • R8VSP G1000VSP G1500またはVSP F1500

  • R9VSP 5000 シリーズ
  • M7HUS VM

  • M8VSP E シリーズVSP Gx00 モデルVSP Fx00 モデル

  • UNKNOWN:不明

pvolStorageSerial

string

P-VOL側のストレージシステムのシリアル番号

svolStorageType

string

S-VOL側のストレージシステムのモデルを示すID

  • R6Universal Storage Platform V/VM

  • R7Virtual Storage Platform

  • R8VSP G1000VSP G1500またはVSP F1500

  • R9VSP 5000 シリーズ
  • M7HUS VM

  • M8VSP E シリーズVSP Gx00 モデルVSP Fx00 モデル

  • UNKNOWN:不明

svolStorageSerial

string

S-VOL側のストレージシステムのシリアル番号

transitionStatus

string

Universal Replicatorの場合に、ペアの遷移中の状態が出力されます。

  • None:遷移中ではない
  • Suspending:ペア分割中
  • Deleting:ペア削除中

Universal Replicator以外の場合には出力されません。

copyPace

int

コピー速度

ペア種別がTrueCopyの場合は、指定したストレージシステムがP-VOL側のときに出力されます。

ペア種別がglobal-active deviceの場合は、指定したストレージシステムがP-VOL側、S-VOL側に関わらず出力されます。

ペア種別がUniversal Replicatorの場合は出力されません。

pathGroupId

int

RCUのパスグループID

リモートパスの接続設定がCU指定の場合は出力されません。

deltaStatus

string

デルタリシンクを用いた3DCマルチターゲット構成の状態

ペア種別がUniversal Replicatorで、かつデルタリシンクを用いた3DCマルチターゲット構成の場合に出力されます。

  • HOLDUniversal Replicatorのデルタリシンクペア(通常)
  • HLDEUniversal Replicator のデルタリシンクペア(失敗)
  • HOLDINGUniversal Replicatorのデルタリシンクペアへ遷移中

ステータスコード

この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

curl -v -H "Accept: application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/800000012345/remote-replications