13.11　コピーグループ単位でTrueCopyペア／Universal Replicatorペアを分割する

ヒント

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

実行権限

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

リクエストライン

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

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

リクエストメッセージ

オブジェクトID

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

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

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

クエリパラメータ

なし。

ボディ

分割だけをする場合のコード例を次に示します。

{
  "parameters": {
    "replicationType": "TC"
  }
}

S-VOLを指定して分割したあと、S-VOLのペア状態をSSWSへ強制的に変更する場合のコード例を次に示します。

{
  "parameters": {
    "replicationType": "UR",
    "svolOperationMode": "SSWS"
  }
}

TrueCopyの場合で、分割したあと、P-VOLへの書き込みを不可にするときのコード例を次に示します。

{
  "parameters": {
    "replicationType": "TC",
    "doPvolWriteProtect": true
  }
}

Universal Replicatorの場合で、分割したあと、ジャーナルボリュームを強制的に停止するときのコード例を次に示します。

{
  "parameters": {
    "replicationType": "UR",
    "doDataSuspend": true
  }
}

属性	型	説明
replicationType	string	（必須）ペア種別を指定します。 TC：TrueCopy UR：Universal Replicator
svolAccessMode	string	（任意）ペアを分割したあとのS-VOLへのアクセスモードを指定します。 r：Readだけ rw：ReadおよびWrite 省略した場合、rが設定されたと見なされます。 この属性を指定する場合はsvolOperationMode属性の指定はできません。 TCの場合は、doPvolWriteProtect属性にtrueを指定できません。 URの場合は、doDataSuspend属性にtrueを指定できません。
svolOperationMode	string	（任意）正サイトのストレージシステムで障害が発生した場合などに、S-VOLのペアの状態を強制的に変更します。副サイトのストレージシステムからリクエストを発行してください。 SSWS：SSWSモードにする PSUS：PSUS（PSUE、SSUS）モードにする この属性を指定する場合はsvolAccessMode属性を指定できません。 TCの場合は、doPvolWriteProtect属性にtrueを指定できません。 URの場合は、doDataSuspend属性にtrueを指定できません。
doPvolWriteProtect	boolean	（任意）TCの場合、P-VOLへの書き込みを強制的に不可にします。 true：P-VOLを書き込み不可にする false：P-VOLを書き込み不可にしない 省略した場合、falseが設定されたと見なされます。 この属性にtrueを指定する場合は、svolAccessMode属性およびsvolOperationMode属性を指定できません。
doDataSuspend	boolean	（任意）URの場合、ジャーナルの利用アクセス量が多くなったときに、ジャーナルの操作を強制的に停止します。 true：ジャーナルの操作を強制的に停止する S-VOL側のグループにデータをコピーしないで、マスタジャーナルボリュームとリストアジャーナルボリュームのデータを消去します。 false：ジャーナルの操作を強制的に停止しない 省略した場合、falseが設定されたと見なされます。 この属性にtrueを指定する場合は、svolOperationMode属性を指定できません。svolAccessMode属性はrwだけ指定できます。

レスポンスメッセージ

ボディ

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

属性	説明
affectedResources	分割したTrueCopyペアまたはUniversal ReplicatorペアのコピーグループのURL

Actionテンプレート

GET ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/remote-mirror-copygroups/＜オブジェクトID＞/actions/split

このActionテンプレートでは、オブジェクトIDで指定されたコピーグループのペア種別と、ローカルストレージシステムにあるコピーグループ内のボリュームがP-VOLかS-VOLかによって、指定できる属性だけを返します。

ステータスコード

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

コード例

Actionテンプレートを取得する場合

P-VOL側のストレージシステムを指定するとき

curl -v -H "Accept: application/json" -H "Remote-Authorization:Session 10399a1f-fce3-489b-9c3a-823017462396" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/remote-mirror-copygroups/836000123789,remoteCopyGroup,remoteCopyGroupP_,remoteCopyGroupS_/actions/split

S-VOL側のストレージシステムを指定するとき

curl -v -H "Accept: application/json" -H "Remote-Authorization:Session 10399a1f-fce3-489b-9c3a-823017462396" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123789/remote-mirror-copygroups/836000123456,remoteCopyGroup,remoteCopyGroupS_,remoteCopyGroupP_/actions/split

Actionテンプレートを取得してリクエストを実行する場合

P-VOL側のストレージシステムを指定するとき

curl -v -H "Accept: application/json" -H "Remote-Authorization:Session 10399a1f-fce3-489b-9c3a-823017462396" -H "Content-Type: application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X PUT --data-binary @./InputParameters.json https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/remote-mirror-copygroups/836000123789,remoteCopyGroup,remoteCopyGroupP_,remoteCopyGroupS_/actions/split/invoke

S-VOL側のストレージシステムを指定するとき

curl -v -H "Accept: application/json" -H "Remote-Authorization:Session 10399a1f-fce3-489b-9c3a-823017462396" -H "Content-Type: application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X PUT --data-binary @./InputParameters.json https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123789/remote-mirror-copygroups/836000123456,remoteCopyGroup,remoteCopyGroupS_,remoteCopyGroupP_/actions/split/invoke