Link Search Menu Expand Document Documentation Menu

CAT snapshots

Introduced 1.0

The CAT snapshots operation lists all snapshots for a repository.

Endpoints

GET /_cat/snapshots
GET /_cat/snapshots/{repository}

Query parameters

The following table lists the available query parameters. All query parameters are optional.

Parameter Data type Description Default
cluster_manager_timeout String The amount of time allowed to establish a connection to the cluster manager node. N/A
format String A short version of the Accept header, such as json or yaml. N/A
h List A comma-separated list of column names to display. N/A
help Boolean Returns help information. false
ignore_unavailable Boolean When true, the response does not include information from unavailable snapshots. false
s List A comma-separated list of column names or column aliases to sort by. N/A
time String Specifies the time units, for example, 5d or 7h. For more information, see Supported units.
Valid values are: nanos, micros, ms, s, m, h, d
N/A
v Boolean Enables verbose mode, which displays column headers. false

Example request

The following example request lists all snapshots:

GET _cat/snapshots?v

Example response

index | shard | prirep | state   | docs | store | ip |       | node
plugins | 0   |   p    | STARTED |   0  |  208b | 172.18.0.4 | odfe-node1
plugins | 0   |   r    | STARTED |   0  |  208b | 172.18.0.3 |  odfe-node2          
350 characters left

Have a question? .

Want to contribute? or .