10.4　コピーグループの一覧を取得する

重要

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

実行権限

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

リクエストライン

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	ShadowImageペアが登録されているコピーグループのオブジェクトID 次の属性をコンマで連結した形式で出力します。 copyGroupName pvolDeviceGroupName svolDeviceGroupName

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

属性	型	説明
copyPairs	object[]	コピーグループに含まれるShadowImageペアに関する、次の属性が出力されます。 情報が取得できない場合、copyPairsオブジェクト配下の属性は出力されません。 copyGroupName（string） コピーグループ名 copyPairName（string） コピーペア名 replicationType（string） ペア種別 SI（ShadowImage）が出力されます。 copyMode（string）※ コピーモード NotSnapshotが出力されます。 pvolLdevId（int） P-VOLのLDEV番号（10進数） svolLdevId（int） S-VOLのLDEV番号（10進数） pvolMuNumber（int） P-VOLのMU番号 pvolStatus（string）※ P-VOLのペアボリューム状態 詳細については、ペアの状態遷移（ShadowImage）の説明を参照してください。 情報が取得できない場合、またはShadowImageペアの遷移中の状態がDeletingの場合、この属性は出力しません。 svolStatus（string）※ S-VOLのペアボリューム状態 詳細については、ペアの状態遷移（ShadowImage）の説明を参照してください。 情報が取得できない場合、またはShadowImageペアの遷移中の状態がDeletingの場合、この属性は出力しません。 consistencyGroupId（int） コンシステンシーグループID VSP E シリーズ、VSP Gx00 モデルまたはVSP Fx00 モデルの場合は-1が出力されます。 コンシステンシーグループでない場合、この属性は出力しません。 localCloneCopypairId（string） ShadowImageペアのオブジェクトID 次の属性をコンマで連結した形式で出力します。 copyGroupName pvolDeviceGroupName svolDeviceGroupName copyPairName transitionStatus（string） ShadowImageペアの遷移中の状態 None：遷移中ではない Deleting：ペア削除中

注※　ShadowImageペアを作成した直後は、ペア情報が次のように出力されることがあります。

• copyMode属性がNotSynchronized
• pvolStatus属性がSMPL
• svolStatus属性がSMPL

この場合、ストレージシステムの構成情報のキャッシュを更新するAPIを実行したあとに再実行するか、または特定のコピーグループの情報を取得するAPIを実行して正しい情報を取得してください。

ステータスコード

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