15.8　特定のコピーグループの情報を取得する（Volume Migration）

重要

• 対象のコピーグループに、ほかのREST APIサーバやREST API以外のソフトウェアを使用して作成または削除したペアが含まれている場合、その情報が正しく取得できないことがあります。最新のペアの情報を取得したいときは、ペアの一覧を取得するAPIを使用してください。
• コピーグループ名、デバイスグループ名、またはコピーペア名に半角スペースが含まれている場合、その情報は取得できません。

実行権限

ストレージ管理者（参照）

リクエストライン

GET ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/local-clone-copygroups/＜オブジェクトID＞

リクエストメッセージ

オブジェクトID

コピーグループ一覧から取得したlocalCloneCopygroupIdの値を指定します。次に示す属性値を連結した形式でも指定できます。

＜copyGroupName＞,＜pvolDeviceGroupName＞,＜svolDeviceGroupName＞

属性	型	説明
copyGroupName	string	（必須）コピーグループ名を31文字以内で指定します。大文字と小文字を区別します。
pvolDeviceGroupName	string	（必須）P-VOL（ソースボリューム）のデバイスグループ名を31文字以内で指定します。大文字と小文字を区別します。
svolDeviceGroupName	string	（必須）S-VOL（ターゲットボリューム）のデバイスグループ名を31文字以内で指定します。大文字と小文字を区別します。

クエリパラメータ

なし。

ボディ

なし。

レスポンスメッセージ

ボディ

{
  "localCloneCopygroupId" : "vm-cg,dgp,dgs",
  "copyGroupName" : "vm-cg",
  "pvolDeviceGroupName" : "dgp",
  "svolDeviceGroupName" : "dgs",
  "copyPairs" : [ {
    "localCloneCopypairId" : "vm-cg,dgp,dgs,p0",
    "copyGroupName" : "vm-cg",
    "copyPairName" : "p0",
    "replicationType" : "SI",
    "copyMode" : "NotSynchronized",
    "pvolLdevId" : 40970,
    "pvolStatus" : "SMPL",
    "svolLdevId" : 40960,
    "svolStatus" : "SMPL",
    "pvolMuNumber" : 0,
    "pvolProcessingStatus": "N",
    "svolProcessingStatus": "N"
  }, {
    "localCloneCopypairId" : "vm-cg,dgp,dgs,p1",
    "copyGroupName" : "vm-cg",
    "copyPairName" : "p1",
    "replicationType" : "SI",
    "copyMode" : "NotSynchronized",
    "pvolLdevId" : 40971,
    "pvolStatus" : "SMPL",
    "svolLdevId" : 40961,
    "svolStatus" : "SMPL",
    "pvolMuNumber" : 0,
    "pvolProcessingStatus": "N",
    "svolProcessingStatus": "N"
  } ]
}

属性	型	説明
copyGroupName	string	コピーグループ名
pvolDeviceGroupName	string	P-VOLのデバイスグループ名
svolDeviceGroupName	string	S-VOLのデバイスグループ名
localCloneCopygroupId	string	ペアが登録されているコピーグループのオブジェクトID 次の属性をコンマで連結した形式で出力します。 copyGroupName pvolDeviceGroupName svolDeviceGroupName
copyPairs	object[]	ペアに関する、次の属性が出力されます。 copyGroupName（string） コピーグループ名 copyPairName（string） ペア名 replicationType（string） ペア種別 SIが出力されます。 copyMode（string） コピーモード NotSynchronized：マイグレーションをするために作成したペア VolumeMigration：マイグレーション中またはマイグレーションが完了したペア そのほかのペアは、それ以外の値が表示されます。 copyProgressRate（int） コピーの進捗率（％） 情報が取得できない場合、この属性は出力しません。 pvolLdevId（int） P-VOLのLDEV番号（10進数） svolLdevId（int） S-VOLのLDEV番号（10進数） pvolStatus（string） P-VOLのペアボリューム状態 詳細については、ペアの状態遷移（Volume Migration）の説明を参照してください。 情報が取得できない場合、この属性は出力しません。 svolStatus（string） S-VOLのペアボリューム状態 詳細については、ペアの状態遷移（Volume Migration）の説明を参照してください。 情報が取得できない場合、この属性は出力しません。 localCloneCopypairId（string） ペアのオブジェクトID pvolMuNumber（int） P-VOLのMU番号 pvolProcessingStatus（string） ペアに対する処理の状態 E：拡張処理が実行中 N：拡張処理が実行中でない svolProcessingStatusと同じ値が出力されます。 VSP 5000 シリーズ、VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP G1000、VSP G1500、VSP F350、F370、F700、F900、VSP F1500の場合に出力されます。 svolProcessingStatus（string） ペアに対する処理の状態 E：拡張処理が実行中 N：拡張処理が実行中でない pvolProcessingStatusと同じ値が出力されます。 VSP 5000 シリーズ、VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP G1000、VSP G1500、VSP F350、F370、F700、F900、VSP F1500の場合に出力されます。

ステータスコード

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

コード例

curl -v -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/886000123457/local-clone-copypairs?localCloneCopyGroupId=vm-cg,dgp,dgs