10.7 特定のShadowImageペアの情報を取得する
- 重要
-
- 対象のShadowImageペアを、ほかのREST APIサーバやREST API以外のソフトウェアを使用して作成したりまたは削除した場合、その情報が正しく取得できないことがあります。最新のペアの情報を取得したいときは、ShadowImageペアの一覧を取得するAPIを使用してください。
- コピーグループ名、デバイスグループ名、またはコピーペア名に半角スペースが含まれている場合、その情報は取得できません。
実行権限
ストレージ管理者(参照)
リクエストライン
GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/local-clone-copypairs/<オブジェクトID>
リクエストメッセージ
- オブジェクトID
-
ShadowImageペアの情報から取得したlocalCloneCopypairIdの値を指定します。次に示す属性値を連結した形式でも指定できます。
<copyGroupName>,<pvolDeviceGroupName>,<svolDeviceGroupName>,<copyPairName>
属性
型
説明
copyGroupName
string
(必須)コピーグループ名を31文字以内で指定します。大文字と小文字を区別します。
pvolDeviceGroupName
string
(必須)P-VOLデバイスグループ名を31文字以内で指定します。大文字と小文字を区別します。
svolDeviceGroupName
string
(必須)S-VOLデバイスグループ名を31文字以内で指定します。大文字と小文字を区別します。
copyPairName
string
(必須)コピーペア名を31文字以内で指定します。大文字と小文字を区別します。
- クエリパラメータ
- なし。
- ボディ
- なし。
レスポンスメッセージ
- ボディ
-
{ "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" }
属性
型
説明
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-copypairs/localCopyGroup1,localCopyGroup1P_,localCopyGroup1S_,pair1