From 9599ffe65d9dcd4b3aa780d346eccd1e760890bf Mon Sep 17 00:00:00 2001 From: Doug Hellmann Date: Tue, 13 Jun 2017 15:55:33 -0400 Subject: reorganize existing documentation according to the new standard layout Move existing content around based on the doc-migration specification. Replace :doc: markup with :ref: to have sphinx keep track of where the files move and generate valid hyperlinks. Add a few toctrees and index pages for the new directories. Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454 Change-Id: I253ee8f89d3ec40e39310c18bb87ed1d3d5de330 Signed-off-by: Doug Hellmann --- doc/source/cli/command-objects/snapshot.rst | 176 ++++++++++++++++++++++++++++ 1 file changed, 176 insertions(+) create mode 100644 doc/source/cli/command-objects/snapshot.rst (limited to 'doc/source/cli/command-objects/snapshot.rst') diff --git a/doc/source/cli/command-objects/snapshot.rst b/doc/source/cli/command-objects/snapshot.rst new file mode 100644 index 00000000..fc516067 --- /dev/null +++ b/doc/source/cli/command-objects/snapshot.rst @@ -0,0 +1,176 @@ +======== +snapshot +======== + +Block Storage v1, v2 + +snapshot create +--------------- + +Create new snapshot +(Deprecated, please use ``volume snapshot create`` instead) + +.. program:: snapshot create +.. code:: bash + + openstack snapshot create + [--name ] + [--description ] + [--force] + [--property [...] ] + + +.. option:: --name + + Name of the snapshot + +.. option:: --description + + Description of the snapshot + +.. option:: --force + + Create a snapshot attached to an instance. Default is False + +.. option:: --property + + Set a property to this snapshot (repeat option to set multiple properties) + + *Volume version 2 only* + +.. _snapshot_create-snapshot: +.. describe:: + + Volume to snapshot (name or ID) + +snapshot delete +--------------- + +Delete snapshot(s) +(Deprecated, please use ``volume snapshot delete`` instead) + +.. program:: snapshot delete +.. code:: bash + + openstack snapshot delete + [ ...] + +.. _snapshot_delete-snapshot: +.. describe:: + + Snapshot(s) to delete (name or ID) + +snapshot list +------------- + +List snapshots +(Deprecated, please use ``volume snapshot list`` instead) + +.. program:: snapshot list +.. code:: bash + + openstack snapshot list + [--all-projects] + [--long] + [--limit ] + [--marker ] + +.. option:: --all-projects + + Include all projects (admin only) + +.. option:: --long + + List additional fields in output + +.. option:: --limit + + Maximum number of snapshots to display + + *Volume version 2 only* + +.. option:: --marker + + The last snapshot ID of the previous page + + *Volume version 2 only* + +snapshot set +------------ + +Set snapshot properties +(Deprecated, please use ``volume snapshot set`` instead) + +.. program:: snapshot set +.. code:: bash + + openstack snapshot set + [--name ] + [--description ] + [--property [...] ] + [--state ] + + +.. _snapshot_restore-snapshot: +.. option:: --name + + New snapshot name + +.. option:: --description + + New snapshot description + +.. option:: --property + + Property to add or modify for this snapshot (repeat option to set multiple properties) + +.. option:: --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* + +.. describe:: + + Snapshot to modify (name or ID) + +snapshot show +------------- + +Display snapshot details +(Deprecated, please use ``volume snapshot show`` instead) + +.. program:: snapshot show +.. code:: bash + + openstack snapshot show + + +.. _snapshot_show-snapshot: +.. describe:: + + Snapshot to display (name or ID) + +snapshot unset +-------------- + +Unset snapshot properties +(Deprecated, please use ``volume snapshot unset`` instead) + +.. program:: snapshot unset +.. code:: bash + + openstack snapshot unset + [--property ] + + +.. option:: --property + + Property to remove from snapshot (repeat option to remove multiple properties) + +.. describe:: + + Snapshot to modify (name or ID) -- cgit v1.2.1