15.10 特定のペアの情報を取得する(Volume Migration)
- 重要
-
- 対象のペアを、ほかのREST APIサーバやREST API以外のソフトウェアを使用して作成したりまたは削除した場合、その情報が正しく取得できないことがあります。最新のペアの情報を取得したいときは、ペアの一覧を取得するAPIを使用してください。
- コピーグループ名、デバイスグループ名、またはペア名に半角スペースが含まれている場合、その情報は取得できません。
実行権限
ストレージ管理者(参照)
リクエストライン
GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/local-clone-copypairs/<オブジェクトID>
リクエストメッセージ
- オブジェクトID
-
ペアの情報から取得したlocalCloneCopypairIdの値を指定します。次に示す属性値を連結した形式でも指定できます。
<copyGroupName>,<pvolDeviceGroupName>,<svolDeviceGroupName>,<copyPairName>
属性
型
説明
copyGroupName
string
(必須)コピーグループ名を31文字以内で指定します。大文字と小文字を区別します。
pvolDeviceGroupName
string
(必須)P-VOL(ソースボリューム)デバイスグループ名を31文字以内で指定します。大文字と小文字を区別します。
svolDeviceGroupName
string
(必須)S-VOL(ターゲットボリューム)デバイスグループ名を31文字以内で指定します。大文字と小文字を区別します。
copyPairName
string
(必須)ペア名を31文字以内で指定します。大文字と小文字を区別します。
- クエリパラメータ
- なし。
- ボディ
- なし。
レスポンスメッセージ
- ボディ
-
{ "localCloneCopypairId" : "vm-cg,dgp,dgs,p1", "copyGroupName" : "vm-cg", "copyPairName" : "p1", "replicationType" : "SI", "copyMode" : "NotSynchronized", "pvolLdevId" : 40971, "pvolStatus" : "SMPL", "svolLdevId" : 40961, "svolStatus" : "SMPL", "pvolMuNumber" : 0, "pvolProcessingStatus": "N", "svolProcessingStatus": "N" }属性
型
説明
copyGroupName
string
コピーグループ名
copyPairName
string
ペア名
replicationType
string
ペア種別
SIが出力されます。
copyMode
string
コピーモード
- NotSynchronized:マイグレーションをするために作成したペア
- VolumeMigration:マイグレーション中またはマイグレーションが完了したペア
そのほかのペアは、それ以外の値が表示されます。
copyProgressRate
int
コピーの進捗率(%)
情報が取得できない場合、この属性は出力しません。
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番号
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 "Content-Type: 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-copypairs/vm-cg,dgp,dgs,p1