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"
  }
}