14.13 global-active deviceペアを中断する
- ヒント
-
このAPIは、リクエストヘッダにJob-Mode-Wait-Configuration-Change:NoWaitを指定して実行することをお勧めします。詳細についてはペアの操作の流れの説明を参照してください。
実行権限
ストレージ管理者(リモートバックアップ管理)
リクエストライン
PUT <ベースURL>/v1/objects/storages/<ストレージデバイスID>/remote-mirror-copypairs/<オブジェクトID>/actions/split/invoke
このAPIはPOSTメソッドでも実行できます。
リクエストメッセージ
- オブジェクトID
-
リモートコピーペアの情報取得で取得したremoteMirrorCopyPairIdの値を指定します。次のように属性値を連結した形式でも指定できます。
<remoteStorageDeviceId>,<copyGroupName>,<localDeviceGroupName>,<remoteDeviceGroupName>,<copyPairName>
属性
型
説明
remoteStorageDeviceId
string
(必須)リモートストレージシステムのストレージデバイスID
copyGroupName
string
(必須)コピーグループ名
1~31文字で指定します。大文字と小文字を区別します。
localDeviceGroupName
string
(必須)ローカルストレージシステム側のデバイスグループ名
1~31文字で指定します。大文字と小文字を区別します。
remoteDeviceGroupName
string
(必須)リモートストレージシステム側のデバイスグループ名
1~31文字で指定します。大文字と小文字を区別します。
copyPairName
string
(必須)コピーペア名
1~31文字で指定します。大文字と小文字を区別します。
- クエリパラメータ
-
なし。
- ボディ
-
中断だけをする場合のコード例を次に示します。中断したあと、P-VOLでI/Oが継続されます。
{ "parameters": { "replicationType": "GAD" } }
S-VOLを指定して中断する場合のコード例を次に示します。中断したあと、S-VOLでI/Oが継続されます。
{ "parameters": { "replicationType": "GAD", "svolOperationMode": "SSWS" } }
属性
型
説明
replicationType
string
(必須)ペア種別を指定します。
GAD:global-active device
svolOperationMode
string
(任意)ペアを中断したあとに、I/Oを継続するボリュームを指定します。次の値を指定します。
- SSWS:S-VOLでI/Oが継続されます。
S-VOLを指定してペアを中断してください。
省略した場合、P-VOLでI/Oが継続されます。P-VOLを指定してペアを中断してください。
- SSWS:S-VOLでI/Oが継続されます。
レスポンスメッセージ
- ボディ
-
ジョブオブジェクトを返します。affectedResources以外の属性については、ジョブオブジェクトの説明を参照してください。
属性
説明
affectedResources
中断したglobal-active deviceペアのURL
Actionテンプレート
GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/remote-mirror-copypairs/<オブジェクトID>/actions/split
このActionテンプレートでは、オブジェクトIDで指定されたペアのペア種別と、ローカルストレージシステムにあるボリュームがP-VOLかS-VOLかによって、指定できる属性だけを返します。
ステータスコード
この操作のリクエストに対するステータスコードの意味を次に示します。そのほかのステータスコードについては、HTTPステータスコードの説明を参照してください。
ステータスコード |
メッセージ |
説明 |
---|---|---|
412 |
Precondition Failed |
このオブジェクトは、指定したペアの操作ができないことを示します。 |
コード例
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-copypairs/836000123789,remoteCopyGroup,remoteCopyGroupP_,remoteCopyGroupS_,pair1/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-copypairs/836000123456,remoteCopyGroup,remoteCopyGroupS_,remoteCopyGroupP_,pair1/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-copypairs/836000123789,remoteCopyGroup,remoteCopyGroupP_,remoteCopyGroupS_,pair1/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-copypairs/836000123456,remoteCopyGroup,remoteCopyGroupS_,remoteCopyGroupP_,pair1/actions/split/invoke