Hitachi

Hitachi Command Suite Configuration Manager REST API リファレンスガイド


15.6 マイグレーションを実行する

マイグレーションを実行して、ソースボリューム(P-VOL)のデータをターゲットボリューム(S-VOL)にコピーします。コピーが完了すると、ホストのアクセスがソースボリュームからターゲットボリュームに切り替わります。
メモ

マイグレーション実行のAPIが成功してデータのコピーが完了したあとに、ペアを削除するAPIを実行して、ソースボリュームとターゲットボリュームのペアの状態をSMPLにしてください。

ヒント

このAPIは、リクエストヘッダにJob-Mode-Wait-Configuration-Change:NoWaitを指定して実行することをお勧めします。詳細についてはVolume Migrationの操作の流れの説明を参照してください。

実行権限

ストレージ管理者(プロビジョニング)

リクエストライン

PUT <ベースURL>/v1/objects/storages/<ストレージデバイスID>/local-clone-copypairs/<オブジェクトID>/actions/migrate/invoke

このAPIはPOSTメソッドでも実行できます。

リクエストメッセージ

オブジェクトID

ペアの情報から取得したlocalCloneCopypairIdの値を指定します。次に示す属性値を連結した形式でも指定できます。

copyGroupName>,<pvolDeviceGroupName>,<svolDeviceGroupName>,<copyPairName

属性

説明

copyGroupName

string

(必須)コピーグループ名を31文字以内で指定します。大文字と小文字を区別します。

pvolDeviceGroupName

string

(必須)P-VOL(ソースボリューム)デバイスグループ名を31文字以内で指定します。大文字と小文字を区別します。

svolDeviceGroupName

string

(必須)S-VOL(ターゲットボリューム)デバイスグループ名を31文字以内で指定します。大文字と小文字を区別します。

copyPairName

string

(必須)ペア名を31文字以内で指定します。大文字と小文字を区別します。

クエリパラメータ

なし。

ボディ

なし。

レスポンスメッセージ

ボディ

ジョブオブジェクトを返します。ジョブオブジェクトの説明を参照してください。このAPI はaffectedResourcesを表示しません。マイグレーションが成功したかどうかは、ペアの情報を取得するAPIを実行して確認してください。ペアの状態を次に示します。

  • マイグレーション成功:PSUS
  • マイグレーション失敗:PSUE

Actionテンプレート

なし。

ステータスコード

この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

curl -v -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X PUT -d "" https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/886000123457/local-clone-copypairs/vm-cg,dgp,dgs,p1/actions/migrate/invoke