python-openstackclient/doc/source/command-objects/volume-snapshot.rst
Huanxuan Ao 1c49a1f01d Fix NoneType error for volume snapshot create command
In volume snapshot command, <volume> is the same
as <snapshot-name> when --volume is not specified,
but <volume> cannot be None, so when <snapshot-name>
is not specified (<snapshot-name> is None), a NoneType
error appears.
So make <snapshot-name> no longer optional, it should
be always present.

Change-Id: I3d9f10753a8ef601e70816421c160598e2cc811f
Closes-bug: #1659894
2017-04-26 11:07:08 -05:00

4.8 KiB

volume snapshot

Block Storage v1, v2

volume snapshot create

Create new volume snapshot

volume snapshot create

openstack volume snapshot create
    [--volume <volume>]
    [--description <description>]
    [--force]
    [--property <key=value> [...] ]
    [--remote-source <key=value> [...]]
    <snapshot-name>

--volume <volume>

Volume to snapshot (name or ID) (default is <snapshot-name>)

--description <description>

Description of the snapshot

--force

Create a snapshot attached to an instance. Default is False

--property <key=value>

Set a property to this snapshot (repeat option to set multiple properties)

Volume version 2 only

--remote-source <key=value>

The attribute(s) of the exsiting remote volume snapshot (admin required) (repeat option to specify multiple attributes) e.g.: '--remote-source source-name=test_name --remote-source source-id=test_id'

Volume version 2 only

Name of the new snapshot

volume snapshot delete

Delete volume snapshot(s)

volume snapshot delete

openstack volume snapshot delete
    [--force]
    <snapshot> [<snapshot> ...]

--force

Attempt forced removal of snapshot(s), regardless of state (defaults to False)

Snapshot(s) to delete (name or ID)

volume snapshot list

List volume snapshots

volume snapshot list

openstack volume snapshot list
    [--all-projects]
    [--project <project> [--project-domain <project-domain>]]
    [--long]
    [--limit <num-snapshots>]
    [--marker <snapshot>]
    [--name <name>]
    [--status <status>]
    [--volume <volume>]

--all-projects

Include all projects (admin only)

--project <project>

Filter results by project (name or ID) (admin only)

Volume version 2 only

--project-domain <project-domain>

Domain the project belongs to (name or ID).

This can be used in case collisions between project names exist.

Volume version 2 only

--long

List additional fields in output

--status <status>

Filters results by a status. ('available', 'error', 'creating', 'deleting' or 'error-deleting')

--name <name>

Filters results by a name.

--volume <volume>

Filters results by a volume (name or ID).

--limit <num-snapshots>

Maximum number of snapshots to display

Volume version 2 only

--marker <snapshot>

The last snapshot ID of the previous page

Volume version 2 only

volume snapshot set

Set volume snapshot properties

volume snapshot set

openstack volume snapshot set
    [--name <name>]
    [--description <description>]
    [--no-property]
    [--property <key=value> [...] ]
    [--state <state>]
    <snapshot>

--name <name>

New snapshot name

--description <description>

New snapshot description

--no-property

Remove all properties from \<snapshot\> <volume_snapshot_set-snapshot> (specify both --no-property and --property to remove the current properties before setting new properties.)

--property <key=value>

Property to add or modify for this snapshot (repeat option to set multiple properties)

--state <state>

New snapshot state. ("available", "error", "creating", "deleting", or "error_deleting") (admin only) (This option simply changes the state of the snapshot in the database with no regard to actual status, exercise caution when using)

Volume version 2 only

Snapshot to modify (name or ID)

volume snapshot show

Display volume snapshot details

volume snapshot show

openstack volume snapshot show
    <snapshot>




Snapshot to display (name or ID)

volume snapshot unset

Unset volume snapshot properties

volume snapshot unset

openstack volume snapshot unset
    [--property <key>]
    <snapshot>

--property <key>

Property to remove from snapshot (repeat option to remove multiple properties)

Snapshot to modify (name or ID)