openstack/python-openstackclient
Code Issues Proposed changes
af81a92c37
python-openstackclient/doc/source/command-objects/volume-backup.rst
Huanxuan Ao 39c5eb9e3f Rename backup commands in volume v1 and v2 
Backup commands are used only in volume service now,
but "backup" is too generic, users may not know the
commands are used for volume from the commands name.
By seeing the command name, users can only see the
"backup" but do not know which object the backup
commands work for. It may confuse users. I think
rename "backup" to "volume backup" can depict resource
relation and will be helpful for users to know the
commands clearly.

So add new commands ``volume backup create/delete/
list/show/restore`` to replace the old commands
``backup create/delete/list/show/restore``. And also
deprecate old commands.

Change-Id: I4f844d9bc48573eb4d17288ce6b8a90cea00d16a
Implements: bp backup-snapshot-renamed-for-volume-resource
Co-Authored-By: Sheel Rana <ranasheel2000@gmail.com>
2016-08-11 09:32:10 +08:00

2.1 KiB
Raw Blame History

volume backup

Block Storage v1, v2

volume backup create

Create new volume backup

volume backup create

os volume backup create
    [--container <container>]
    [--name <name>]
    [--description <description>]
    [--snapshot <snapshot>]
    [--force]
    [--incremental]
    <volume>

--container <container>

Optional backup container name

--name <name>

Name of the backup

--description <description>

Description of the backup

--snapshot <snapshot>

Snapshot to backup (name or ID)

Volume version 2 only

--force

Allow to back up an in-use volume

Volume version 2 only

--incremental

Perform an incremental backup

Volume version 2 only

Volume to backup (name or ID)

volume backup delete

Delete volume backup(s)

volume backup delete

os volume backup delete
    [--force]
    <backup> [<backup> ...]

--force

Allow delete in state other than error or available

Volume version 2 only

Backup(s) to delete (name or ID)

volume backup list

List volume backups

volume backup list

os volume backup list




List additional fields in output

volume backup restore

Restore volume backup

volume backup restore

os volume backup restore
    <backup>
    <volume>




Backup to restore (name or ID)

<volume>

Volume to restore to (name or ID)

volume backup show

Display volume backup details

volume backup show

os volume backup show
    <backup>




Backup to display (name or ID)