10.5　特定のコピーグループの情報を取得する

重要

• 対象のコピーグループに、ほかのREST APIサーバやREST API以外のソフトウェアを使用して作成または削除したShadowImageペアが含まれている場合、その情報が正しく取得できないことがあります。最新のペアの情報を取得したいときは、ShadowImageペアの一覧を取得する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" : "localCopyGroup1,localCopyGroup1P_,localCopyGroup1S_",
  "copyGroupName" : "localCopyGroup1",
  "pvolDeviceGroupName" : "localCopyGroup1P_",
  "svolDeviceGroupName" : "localCopyGroup1S_",
  "copyPairs" : [ {
    "localCloneCopypairId" : "localCopyGroup1,localCopyGroup1P_,localCopyGroup1S_,pair1",
    "copyGroupName" : "localCopyGroup1",
    "copyPairName" : "pair1",
    "replicationType" : "SI",
    "copyMode" : "NotSnapshot",
    "copyProgressRate" : 100,
    "pvolLdevId" : 10,
    "pvolStatus" : "PAIR",
    "svolLdevId" : 20,
    "svolStatus" : "PAIR",
    "pvolMuNumber" : 0,
    "pvolProcessingStatus": "N",
    "svolProcessingStatus": "N"
  }, {
    "localCloneCopypairId" : "localCopyGroup1,localCopyGroup1P_,localCopyGroup1S_,pair2",
    "copyGroupName" : "localCopyGroup1",
    "copyPairName" : "pair2",
    "replicationType" : "SI",
    "copyMode" : "NotSnapshot",
    "copyProgressRate" : 100,
    "pvolLdevId" : 30,
    "pvolStatus" : "PAIR",
    "svolLdevId" : 40,
    "svolStatus" : "PAIR",
    "pvolMuNumber" : 0,
    "pvolProcessingStatus": "N",
    "svolProcessingStatus": "N"
  } ]
}

属性	型	説明
copyGroupName	string	コピーグループ名
pvolDeviceGroupName	string	P-VOLのデバイスグループ名
svolDeviceGroupName	string	S-VOLのデバイスグループ名
localCloneCopygroupId	string	ShadowImageペアが登録されているコピーグループのオブジェクトID 次の属性をコンマで連結した形式で出力します。 copyGroupName pvolDeviceGroupName svolDeviceGroupName
copyPairs	object[]	コピーグループに含まれるShadowImageペアに関する、次の属性が出力されます。 copyGroupName（string） コピーグループ名 copyPairName（string） コピーペア名 replicationType（string） ペア種別 SI（ShadowImage）が出力されます。 copyMode（string） コピーモード NotSnapshotが出力されます。 copyProgressRate（int） コピーの進捗率（％） 情報が取得できない場合、この属性は出力しません。 pvolLdevId（int） P-VOLのLDEV番号（10進数） svolLdevId（int） S-VOLのLDEV番号（10進数） pvolMuNumber（int） P-VOLのMU番号 pvolStatus（string） P-VOLのペアボリューム状態 詳細については、ペアの状態遷移（ShadowImage）の説明を参照してください。 情報が取得できない場合、この属性は出力しません。 svolStatus（string） S-VOLのペアボリューム状態 詳細については、ペアの状態遷移（ShadowImage）の説明を参照してください。 情報が取得できない場合、この属性は出力しません。 consistencyGroupId（int） コンシステンシーグループID コンシステンシーグループでない場合、この属性は出力しません。 localCloneCopypairId（string） ShadowImageペアのオブジェクトID 次の属性をコンマで連結した形式で出力します。 copyGroupName pvolDeviceGroupName svolDeviceGroupName copyPairName 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 "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/local-clone-copygroups/localCopyGroup1,localCopyGroup1P_,localCopyGroup1S_