10.13 ShadowImageペアを再同期する
- ヒント
-
このAPIは、リクエストヘッダにJob-Mode-Wait-Configuration-Change:NoWaitを指定して実行することをお勧めします。詳細についてはペアの操作の流れの説明を参照してください。
実行権限
ストレージ管理者(ローカルバックアップ管理)
リクエストライン
PUT <ベースURL>/v1/objects/storages/<ストレージデバイスID>/local-clone-copypairs/<オブジェクトID>/actions/resync/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 } }
属性
型
説明
quickMode
boolean
(任意)クイックモードで実行するかどうかを指定します。- true:クイックモードで実行する
- false:ノーマルモードで実行する
省略した場合、falseが設定されたと見なされます。
copyPace
int
(任意)コピー速度
1~15の数値を指定します。数字が大きい方が高速になります。
レスポンスメッセージ
- ボディ
-
ジョブオブジェクトを返します。affectedResources以外の属性については、ジョブオブジェクトの説明を参照してください。
属性
説明
affectedResources
再同期したShadowImageペアのURL
Actionテンプレート
GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/local-clone-copypairs/<オブジェクトID>/actions/resync
ステータスコード
この操作のリクエストに対するステータスコードの意味を次に示します。そのほかのステータスコードについては、HTTPステータスコードの説明を参照してください。
ステータスコード |
メッセージ |
説明 |
---|---|---|
412 |
Precondition Failed |
オブジェクトが不正なため、Actionテンプレートが取得できない。 |
コード例
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/resync
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/resync/invoke