15.7　コピーグループの一覧を取得する（Volume Migration）

重要

コピーグループ名またはデバイスグループ名に半角スペースが含まれている場合、そのコピーグループの情報は取得できません。

実行権限

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

リクエストライン

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

リクエストメッセージ

オブジェクトID

なし。

クエリパラメータ

パラメータ	型	説明
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を実行する必要があります。詳細については、「ストレージシステムの構成情報のキャッシュを更新する」の説明を参照してください。

ボディ

なし。

レスポンスメッセージ

ボディ

{
  "data": [
    {
      "copyGroupName": "localCopyGroup1",
      "pvolDeviceGroupName": "localCopyGroup1P_",
      "svolDeviceGroupName": "localCopyGroup1S_",
      "localCloneCopygroupId": "localCopyGroup1,localCopyGroup1P_,localCopyGroup1S_"
    },
    {
      "copyGroupName": "localCopyGroup2",
      "pvolDeviceGroupName": "localCopyGrouppvol",
      "svolDeviceGroupName": "localCopyGroupsvol",
      "localCloneCopygroupId": "localCopyGroup2,localCopyGrouppvol,localCopyGroupsvol"
    }
  ]
}

属性	型	説明
copyGroupName	string	コピーグループ名
pvolDeviceGroupName	string	P-VOL（ソースボリューム）のデバイスグループ名
svolDeviceGroupName	string	S-VOL（ターゲットボリューム）のデバイスグループ名
localCloneCopygroupId	string	ペアが登録されているコピーグループのオブジェクトID 次の属性をコンマで連結した形式で出力します。 copyGroupName pvolDeviceGroupName svolDeviceGroupName

クエリパラメータでdetailInfoTypeにpairを指定して実行すると、コピーグループの一覧に加えて次の情報も取得できます。

属性	型	説明
copyPairs	object[]	ペアに関する、次の属性が出力されます。 情報が取得できない場合、copyPairsオブジェクト配下の属性は出力されません。 copyGroupName（string） コピーグループ名 copyPairName（string） ペア名 replicationType（string） ペア種別 SIが出力されます。 copyMode（string） コピーモード NotSynchronized：マイグレーションをするために作成したペア VolumeMigration：マイグレーション中またはマイグレーションが完了したペア そのほかのペアは、それ以外の値が表示されます。 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番号

ステータスコード

この操作のリクエストに対するステータスコードについては、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/886000123457/local-clone-copygroups