Restoring backups
POST /v3/{project_id}/backups/{backup_id}/restore
Restore a backup to a new volume.
Source: https://docs.openstack.org/api-ref/block-storage/v3/#restore-a-backup
Request
Parameters
Name | In | Type | Description |
---|---|---|---|
project_id
|
path | string | The UUID of the project. |
backup_id
|
path | string | The UUID for a backup. |
restore
|
body | object | A restore object. |
volume_type
|
body | string | The name of the storage policy for a new volume. |
name (Optional) |
body | string | The name of a new volume. |
Example
# curl -ks -X POST -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' -d '\{ "restore": { "name": "newvolume", "volume_type": "default" } }' https://<node_IP_addr>:8776/v3/3046fb2c2a314a0fbb32607caa1e5277/backups/bcb8fc88-a0ba-4cd0-801a-e9face1eac88/restore
Response
Parameters
Name | In | Type | Description |
---|---|---|---|
restore
|
body | object | A restore object. |
backup_id
|
body | string | The UUID of the backup. |
volume_id
|
body | string | The UUID of the volume. |
volume_name
|
body | string | The volume name. |
Status codes
Success
Code | Reason |
---|---|
202 - Accepted
|
Request was accepted for processing, but the processing has not been completed. A ‘location’ header is included in the response which contains a link to check the progress of the request. |
Error
Code | Reason |
---|---|
400 - Bad Request
|
Some content in the request was invalid. |
413 - Request Entity Too Large
|
This operation cannot be completed. |
Example
{ "restore": { "backup_id": "bcb8fc88-a0ba-4cd0-801a-e9face1eac88", "volume_id": "a28b2729-0dda-4441-9e10-39fbc52fa134", "volume_name": "newvolume" } }