volume backup¶
Block Storage v1, v2
volume backup create¶
Create new volume backup
openstack volume backup create
[--name <name>]
[--description <description>]
[--container <container>]
[--snapshot <snapshot>]
[--force]
[--incremental]
[--no-incremental]
[--property <key=value>]
[--availability-zone <zone-name>]
<volume>
- --name <name>¶
Name of the backup
- --description <description>¶
Description of the backup
- --container <container>¶
Optional backup container name
- --snapshot <snapshot>¶
Snapshot to backup (name or ID)
- --force¶
Allow to back up an in-use volume
- --incremental¶
Perform an incremental backup
- --no-incremental¶
Do not perform an incremental backup
- --property <key=value>¶
Set a property on this backup (repeat option to remove multiple values) (supported by –os-volume-api-version 3.43 or above)
- --availability-zone <zone-name>¶
AZ where the backup should be stored; by default it will be the same as the source (supported by –os-volume-api-version 3.51 or above)
- volume¶
Volume to backup (name or ID)
volume backup delete¶
Delete volume backup(s)
openstack volume backup delete [--force] <backup> [<backup> ...]
- --force¶
Allow delete in state other than error or available
- backup¶
Backup(s) to delete (name or ID)
volume backup list¶
List volume backups
openstack volume backup list
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--long]
[--name <name>]
[--status <status>]
[--volume <volume>]
[--marker <volume-backup>]
[--limit <num-backups>]
[--all-projects]
- --sort-column SORT_COLUMN¶
specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
- --sort-ascending¶
sort the column(s) in ascending order
- --sort-descending¶
sort the column(s) in descending order
- --long¶
List additional fields in output
- --name <name>¶
Filters results by the backup name
- --status <status>¶
Filters results by the backup status, one of: creating, available, deleting, error, restoring or error_restoring
- --volume <volume>¶
Filters results by the volume which they backup (name or ID)
- --marker <volume-backup>¶
The last backup of the previous page (name or ID)
- --limit <num-backups>¶
Maximum number of backups to display
- --all-projects¶
Include all projects (admin only)
volume backup record export¶
Export volume backup details. Backup information can be imported into a new service instance to be able to restore.
openstack volume backup record export <backup>
- backup¶
Backup to export (name or ID)
volume backup record import¶
Import volume backup details. Exported backup details contain the metadata necessary to restore to a new or rebuilt service instance
openstack volume backup record import
<backup_service>
<backup_metadata>
- backup_service¶
Backup service containing the backup.
- backup_metadata¶
Encoded backup metadata from export.
volume backup restore¶
Restore volume backup
openstack volume backup restore [--force] <backup> [<volume>]
- --force¶
Restore the backup to an existing volume (default to False)
- backup¶
Backup to restore (name or ID)
- volume¶
Volume to restore to (name or ID for existing volume, name only for new volume) (default to None)
volume backup set¶
Set volume backup properties
openstack volume backup set
[--name <name>]
[--description <description>]
[--state <state>]
[--no-property]
[--property <key=value>]
<backup>
- --name <name>¶
New backup name(supported by –os-volume-api-version 3.9 or above)
- --description <description>¶
New backup description (supported by –os-volume-api-version 3.9 or above)
- --state <state>¶
New backup state (“available” or “error”) (admin only) (This option simply changes the state of the backup in the database with no regard to actual status; exercise caution when using)
- --no-property¶
Remove all properties from this backup (specify both –no-property and –property to remove the current properties before setting new properties)
- --property <key=value>¶
Set a property on this backup (repeat option to set multiple values) (supported by –os-volume-api-version 3.43 or above)
- backup¶
Backup to modify (name or ID)
volume backup show¶
Display volume backup details
openstack volume backup show <backup>
- backup¶
Backup to display (name or ID)