10.11　ShadowImageペアを分割する

ヒント

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

メモ

Actionテンプレート中のforceSplit属性は不要です。Actionテンプレートを使用する場合、この属性を削除してからリクエストを作成してください。

実行権限

ストレージ管理者（ローカルバックアップ管理）

リクエストライン

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

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

リクエストメッセージ

オブジェクトID

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

＜copyGroupName＞,＜pvolDeviceGroupName＞,＜svolDeviceGroupName＞,＜copyPairName＞

属性	型	説明
copyGroupName	string	（必須）コピーグループ名を31文字以内で指定します。大文字と小文字を区別します。
pvolDeviceGroupName	string	（必須）P-VOLデバイスグループ名を31文字以内で指定します。大文字と小文字を区別します。
svolDeviceGroupName	string	（必須）S-VOLデバイスグループ名を31文字以内で指定します。大文字と小文字を区別します。
copyPairName	string	（必須）コピーペア名を31文字以内で指定します。大文字と小文字を区別します。

クエリパラメータ

なし。

ボディ

{
  "parameters": {
    "quickMode": true,
    "copyPace": 10,
    "forceSuspend": false
  }
}

属性	型	説明
quickMode	boolean	（任意）クイックモードで実行するかどうかを指定します。 true：クイックモードで実行する false：ノーマルモードで実行する 省略した場合、falseが設定されたと見なされます。
copyPace	int	（任意）コピー速度 1～15の数値を指定します。数字が大きい方が高速になります。 forceSuspend属性にtrueを指定した場合は指定できません。
forceSuspend	boolean	（任意）ペアを強制で分割するかどうかを指定します。 true：強制的にペア分割する false：強制的にペア分割しない 省略した場合、falseが設定されたと見なされます。 この属性にtrueを指定した場合、copyPace属性は指定できません。

レスポンスメッセージ

ボディ

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

属性	説明
affectedResources	分割したShadowImageペアのURL

Actionテンプレート

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

ステータスコード

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

コード例

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

curl -v -H "Accept: application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/local-clone-copypairs/localCopyGroup1,localCopyGroup1P_,localCopyGroup1S_,pair1/actions/split

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

curl -v -H "Accept: application/json" -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/local-clone-copypairs/localCopyGroup1,localCopyGroup1P_,localCopyGroup1S_,pair1/actions/split/invoke