Hitachi

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


11.13 Thin Imageペアを再同期してスナップショットデータを削除する

指定したスナップショットデータでThin Imageペアを再同期します。ペアを再同期すると、スナップショットデータはすべて削除されます。また、再同期したペアの分割を指定することで、スナップショットデータを新たに取得します。

実行権限

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

リクエストライン

PUT <ベースURL>/v1/objects/storages/<ストレージデバイスID>/snapshots/<オブジェクトID>/actions/resync/invoke

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

リクエストメッセージ

オブジェクトID

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

pvolLdevId>,<muNumber

属性

説明

pvolLdevId

int

(必須)再同期するThin ImageペアのP-VOLのLDEV番号

0以上の10進数で指定します。

muNumber

int

(必須)再同期するThin ImageペアのP-VOLのMU番号

01023の値を指定します。

クエリパラメータ

なし。

ボディ
{
  "parameters": {
    "autoSplit": false
  }
}

属性

説明

autoSplit

boolean

(任意)Thin Imageペアの再同期が完了したあと、ペアを分割するかどうかを指定します。
  • true:ペアを分割します。
  • false:ペアを分割しません。

trueを指定した場合は、ペアを分割しスナップショットデータを取得します。

省略した場合、falseが設定されたと見なされます。

レスポンスメッセージ

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

属性

説明

affectedResources

再同期したThin ImageペアのURL

Actionテンプレート

GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/snapshots/<オブジェクトID>/actions/resync

ステータスコード

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

ステータスコード

メッセージ

説明

412

Precondition Failed

このオブジェクトは、ペアの再同期で指定されたアクションを実行できないことを示します。

コード例

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/snapshots/100,3/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/snapshots/100,3/actions/resync/invoke