10.6　ShadowImageペアの一覧を取得する

重要

• 対象のコピーグループに、ほかのREST APIサーバやREST API以外のソフトウェアを使用して作成または削除したShadowImageペアが含まれている場合、その情報が取得できないことがあります。この場合、クエリパラメータにrefresh=trueを指定して実行すると、最新のペアの情報を取得できます。ただし、指定したコピーグループに含まれるペアの情報を更新してから情報を取得するため、処理に時間がかかります。
• コピーグループ名、デバイスグループ名、またはコピーペア名に半角スペースが含まれている場合、その情報は取得できません。

実行権限

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

リクエストライン

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

リクエストメッセージ

オブジェクトID

なし。

クエリパラメータ

パラメータ	型	フィルタ条件
localCloneCopyGroupId	string	（必須）ペアが登録されているコピーグループのオブジェクトID コピーグループ一覧で取得したlocalCloneCopygroupIdの値を指定します。次に示す属性値を連結した形式でも指定できます。 ＜copyGroupName＞,＜pvolDeviceGroupName＞,＜svolDeviceGroupName＞ copyGroupName（string） コピーグループ名 31文字以内で指定します。 pvolDeviceGroupName（string） P-VOLのデバイスグループ名 31文字以内で指定します。 svolDeviceGroupName（string） S-VOLのデバイスグループ名 31文字以内で指定します。
refresh	boolean	（任意）ペアの情報を最新の状態に更新するかどうか true：更新する false：更新しない trueを指定した場合、指定したコピーグループに含まれるペアの情報を更新してから情報を取得するため、処理に時間がかかります。 省略した場合は、falseが指定されたと見なされます。

ボディ

なし。

レスポンスメッセージ

ボディ

指定したコピーグループ内のペアの情報が一覧で取得されます。レスポンスボディの内容については、特定のShadowImageペアの情報を取得する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/800000012345/local-clone-copypairs?localCloneCopyGroupId=localCopyGroup1,localCopyGroup1P_,localCopyGroup1S_&refresh=true"