Hitachi

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


14.12 コピーグループ単位でglobal-active deviceペアを中断する

指定したコピーグループ単位でglobal-active deviceペアを中断(サスペンド)します。プライマリボリューム側のコピーグループを指定してペアを中断する方法と、セカンダリボリューム側のコピーグループを指定してペアを中断する方法があります。コピーグループ内にプライマリボリュームとセカンダリボリュームが混在している場合は、コピーグループを指定してペアの中断はできません。また、コピーグループ単位でペアの中断をする場合、同一のコピーグループやコピーグループ内のペアに対して、同時にほかの処理を行わないでください。
ヒント

この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文字で指定します。大文字と小文字を区別します。

クエリパラメータ

なし。

ボディ

中断だけをする場合のコード例を次に示します。中断したあと、P-VOLでI/Oが継続されます。

{
  "parameters": {
    "replicationType": "GAD"
  }
}

S-VOLを指定して中断する場合のコード例を次に示します。中断したあと、S-VOLでI/Oが継続されます。

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

属性

説明

replicationType

string

(必須)ペア種別を指定します。

GADglobal-active device

svolOperationMode

string

(任意)ペアを中断したあとに、I/Oを継続するボリュームを指定します。次の値を指定します。

  • SSWS:S-VOLでI/Oが継続されます。

    S-VOLを指定してペアを中断してください。

省略した場合、P-VOLでI/Oが継続されます。P-VOLを指定してペアを中断してください。

レスポンスメッセージ

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

属性

説明

affectedResources

中断したglobal-active deviceペアのコピーグループのURL

Actionテンプレート

GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/remote-mirror-copygroups/<オブジェクト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-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