volume snapshot

volume snapshot

Block Storage v1, v2

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)

Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.