python-openstackclient/doc/source/command-objects/volume-snapshot.rst
2016-12-21 10:29:38 +08:00

4.2 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 (default to None)

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]
    [--long]
    [--limit <limit>]
    [--marker <marker>]
    [--name <name>]
    [--status <status>]
    [--volume <volume>]

--all-projects

Include all projects (admin 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 <limit>

Maximum number of snapshots to display

Volume version 2 only

--marker <marker>

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>]
    [--property <key=value> [...] ]
    [--state <state>]
    <snapshot>

--name <name>

New snapshot name

--description <description>

New snapshot description

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