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]
    <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

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 (‘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 <backup> <volume>

backup¶: Backup to restore (name or ID)

volume¶: Volume to restore to (name or ID)

volume backup set¶

Set volume backup properties

openstack volume backup set
    [--name <name>]
    [--description <description>]
    [--state <state>]
    <backup>

--name <name>¶: New backup name

--description <description>¶: New backup description

--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)

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)

volume backup