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