volume snapshot¶

volume snapshot create¶

Create new volume snapshot

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

<snapshot-name>

Name of the new snapshot

volume snapshot delete¶

Delete volume snapshot(s)

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

--force¶

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

<snapshot>

Snapshot(s) to delete (name or ID)

volume snapshot list¶

List volume snapshots

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

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

Snapshot to modify (name or ID)

volume snapshot show¶

Display volume snapshot details

openstack volume snapshot show
    <snapshot>

<snapshot>

Snapshot to display (name or ID)

volume snapshot unset¶

Unset volume snapshot properties

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

--property <key>¶

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

<snapshot>

Snapshot to modify (name or ID)