11.14 スナップショットグループ単位でスナップショットデータをリストアする
実行権限
ストレージ管理者（ローカルバックアップ管理）
リクエストライン
PUT ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/snapshot-groups/＜オブジェクトID＞/actions/restore/invoke
このAPIはPOSTメソッドでも実行できます。
リクエストメッセージ
- オブジェクトID
-
スナップショットグループの情報取得で取得したsnapshotGroupIdの値を指定します。
属性
型
説明
snapshotGroupId
string
（必須）リストアするThin Imageペアが所属するスナップショットグループのオブジェクトID
1～32文字で指定します。大文字と小文字を区別します。
- クエリパラメータ
-
なし。
- ボディ
-
{ "parameters": { "autoSplit": false } }属性
型
説明
autoSplit
boolean
（任意）Thin Imageペアのリストアが完了したあと、ペアを分割するかどうかを指定します。
- true：ペアを分割します。
- false：ペアを分割しません。
trueを指定した場合は、スナップショットグループ単位でペアを分割し、スナップショットデータを取得します。
省略した場合、falseが設定されたと見なされます。
レスポンスメッセージ
- ボディ
-
ジョブオブジェクトを返します。affectedResources以外の属性については、ジョブオブジェクトの説明を参照してください。
属性
説明
affectedResources
リストアしたスナップショットグループのURL
Actionテンプレート
GET ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/snapshot-groups/＜オブジェクトID＞/actions/restore
ステータスコード
この操作のリクエストに対するステータスコードの意味を次に示します。そのほかのステータスコードについては、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/snapshot-groups/snapshotGroup/actions/restore
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/snapshot-groups/snapshotGroup/actions/restore/invoke