13.18　コピーペア単位で副サイト側のボリュームで業務を引き継ぐ（テイクオーバー）

正サイトで障害が発生した場合に、コピーペア単位でUniversal Replicatorペアのプライマリボリュームとセカンダリボリュームの役割を入れ替え、セカンダリボリュームに書き込みができるようにする（テイクオーバー）ことで、副サイト側で業務を継続できるようにします。このAPIは、副サイト側のストレージシステムで実行します。

メモ

このAPIは、VSP 5000 シリーズ、VSP E シリーズ、VSP Gx00 モデル、VSP G1000、VSP G1500、VSP Fx00 モデル、またはVSP F1500の場合に使用できます。
カスケード構成ではないUniversal Replicatorペアが対象です。
このAPIを実行する場合、リクエストヘッダにRemote-Authorizationを指定する必要はありません。
リクエストヘッダにJob-Mode-Wait-Configuration-Change:NoWaitを指定する場合は、リクエストボディでmodeにforceSplitを指定してください。また、この場合、timeoutに指定した値は無視されます。

実行権限

ストレージ管理者（リモートバックアップ管理）

リクエストライン

PUT ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/remote-mirror-copypairs/＜オブジェクトID＞/actions/takeover/invoke

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

リクエストメッセージ

オブジェクトID

リモートコピーペアの情報取得で取得したremoteMirrorCopyPairIdの値を指定します。次のように属性値を連結した形式でも指定できます。

＜remoteStorageDeviceId＞,＜copyGroupName＞,＜localDeviceGroupName＞,＜remoteDeviceGroupName＞,＜copyPairName＞

属性	型	説明
remoteStorageDeviceId	string	（必須）リモートストレージシステムのストレージデバイスID このAPIでは、`NotSpecified`を指定します。
copyGroupName	string	（必須）コピーグループ名 1～31文字で指定します。大文字と小文字を区別します。
localDeviceGroupName	string	（必須）ローカルストレージシステム側のデバイスグループ名 1～31文字で指定します。大文字と小文字を区別します。
remoteDeviceGroupName	string	（必須）リモートストレージシステム側のデバイスグループ名このAPIでは、`NotSpecified`を指定します。
copyPairName	string	（必須）コピーペア名 1～31文字で指定します。大文字と小文字を区別します。

クエリパラメータ: なし。

ボディ

{
    "parameters": {
        "mode": "auto"
    }
}

属性	型	説明
mode	string	（必須）テイクオーバの実行モード P-VOLとS-VOLを入れ替えたあと、ペアは分割されている状態（SSWS）になり、書き込み可能になります。その後のペアの状態遷移について、次のどちらかを指定します。 `forceSplit`：ペアが分割されている状態（SSWS）のままにする `auto`：ストレージシステムの状態に応じて、可能であればペアを再同期するリクエストヘッダで`Job-Mode-Wait-Configuration-Change:NoWait`を指定した場合は、`forceSplit`を指定してください。
timeout	int	（任意）差分データの同期完了待ちタイムアウト時間（秒）ジャーナルに差分データがある場合に、S-VOLに差分データを同期する処理のタイムアウト時間を指定します。 `1`～`10000`の値を指定します。省略した場合、`7200`が指定されたと見なされます。リクエストヘッダで`Job-Mode-Wait-Configuration-Change:NoWait`を指定した場合、この属性に指定した値は無視されます。指定した時間内にペアの同期が完了しなかった場合、REST APIのジョブは失敗しますが、ストレージシステム側では同期処理と同期完了後の分割処理は継続して実行されます。ペアの同期が完了したかどうかは、対象のペアの情報を取得して確認してください。

属性

型

説明

mode

string

（必須）テイクオーバの実行モード

P-VOLとS-VOLを入れ替えたあと、ペアは分割されている状態（SSWS）になり、書き込み可能になります。その後のペアの状態遷移について、次のどちらかを指定します。

forceSplit：ペアが分割されている状態（SSWS）のままにする
auto：ストレージシステムの状態に応じて、可能であればペアを再同期する

リクエストヘッダでJob-Mode-Wait-Configuration-Change:NoWaitを指定した場合は、forceSplitを指定してください。

timeout

int

（任意）差分データの同期完了待ちタイムアウト時間（秒）

ジャーナルに差分データがある場合に、S-VOLに差分データを同期する処理のタイムアウト時間を指定します。

1～10000の値を指定します。

省略した場合、7200が指定されたと見なされます。

リクエストヘッダでJob-Mode-Wait-Configuration-Change:NoWaitを指定した場合、この属性に指定した値は無視されます。

指定した時間内にペアの同期が完了しなかった場合、REST APIのジョブは失敗しますが、ストレージシステム側では同期処理と同期完了後の分割処理は継続して実行されます。ペアの同期が完了したかどうかは、対象のペアの情報を取得して確認してください。

レスポンスメッセージ

ボディ

ジョブオブジェクトを返します。affectedResources以外の属性については、ジョブオブジェクトの説明を参照してください。

属性	説明
affectedResources	入れ替えを実行したUniversal ReplicatorペアのURL

Actionテンプレート

なし。

ステータスコード

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

コード例

curl -v -H "Accept: application/json" -H "Content-type: application/json" -H "Authorization:Session 10399a1f-fce3-489b-9c3a-823017462396" -X PUT --data-binary @./InputParameters.json https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/800000012345/remote-mirror-copypairs/NotSpecified,copyGroup,localDeviceGroup,NotSpecified,pair/actions/takeover/invoke

13.18 コピーペア単位で副サイト側のボリュームで業務を引き継ぐ（テイクオーバー）

13.18　コピーペア単位で副サイト側のボリュームで業務を引き継ぐ（テイクオーバー）