[[snapshot_flag]]
== --snapshot

[float]
Summary
~~~~~~~

IMPORTANT: This flag only functions within the scope of <<snapshot-selection,snapshot selection>>.

Add a snapshot (or snapshots) by name at the command-line. Snapshots added with
the `--snapshot` flag _will not_ be filtered by any of the other snapshot
selection flags. The snapshot _must_ exist. This flag can be used in lieu of
filtering from the list of all snapshots. This flag can be invoked multiple
times.

[float]
Flags
~~~~~

* `--snapshot` Include the named snapshot in the list. Can be invoked multiple
times.

[float]
Examples
~~~~~~~~

Include `snapshot_name` as one of the snapshots to be shown in addition to the
provided criteria:

---------------------------------------------------------
curator show snapshots --repository REPO --prefix curator --snapshot snapshot_name
---------------------------------------------------------

Delete only snapshots `snap1` and `snap2`:

----------------------------------------------------
curator delete snapshots --repository REPO --snapshot snap1 --snapshot snap2
----------------------------------------------------