Link Search Menu Expand Document Documentation Menu

Get snapshot

Introduced 1.0

Retrieves information about a snapshot.

Endpoints

GET _snapshot/<repository>/<snapshot>/

Path parameters

Parameter Data type Description
repository String The repository that contains the snapshot to retrieve.
snapshot String Snapshot to retrieve.

Query parameters

Parameter Data type Description
verbose Boolean When true, returns additional information about each snapshot, such as the version of OpenSearch that took the snapshot, the start and end times of the snapshot, and the number of shards contained in the snapshot. When false, returns only snapshot names and contained indexes. This is useful when the snapshots belong to a cloud-based repository, where each blob read is a cost or performance concern. Optional. Default is true.
ignore_unavailable Boolean How to handle snapshots that are unavailable (corrupted or otherwise temporarily can’t be returned). If true and the snapshot is unavailable, the request does not return the snapshot. If false and the snapshot is unavailable, the request returns an error. Optional. Default is false.

Example request

The following request retrieves information for the my-first-snapshot located in the my-opensearch-repo repository:

GET _snapshot/my-opensearch-repo/my-first-snapshot

Example response

Upon success, the response returns snapshot information:

{
  "snapshots" : [
    {
      "snapshot" : "my-first-snapshot",
      "uuid" : "3P7Qa-M8RU6l16Od5n7Lxg",
      "version_id" : 136217927,
      "version" : "2.0.1",
      "indices" : [
        ".opensearch-observability",
        ".opendistro-reports-instances",
        ".opensearch-notifications-config",
        "shakespeare",
        ".opendistro-reports-definitions",
        "opensearch_dashboards_sample_data_flights",
        ".kibana_1"
      ],
      "data_streams" : [ ],
      "include_global_state" : true,
      "state" : "SUCCESS",
      "start_time" : "2022-08-11T20:30:00.399Z",
      "start_time_in_millis" : 1660249800399,
      "end_time" : "2022-08-11T20:30:14.851Z",
      "end_time_in_millis" : 1660249814851,
      "duration_in_millis" : 14452,
      "failures" : [ ],
      "shards" : {
        "total" : 7,
        "failed" : 0,
        "successful" : 7
      }
    }
  ]
}

Response body fields

Field Data type Description
snapshot string Snapshot name.
uuid string Snapshot’s universally unique identifier (UUID).
version_id int Build ID of the Open Search version that created the snapshot.
version float Open Search version that created the snapshot.
indices array Indices in the snapshot.
data_streams array Data streams in the snapshot.
include_global_state boolean Whether the current cluster state is included in the snapshot.
start_time string Date/time when the snapshot creation process began.
start_time_in_millis long Time (in milliseconds) when the snapshot creation process began.
end_time string Date/time when the snapshot creation process ended.
end_time_in_millis long Time (in milliseconds) when the snapshot creation process ended.
duration_in_millis long Total time (in milliseconds) that the snapshot creation process lasted.
failures array Failures, if any, that occured during snapshot creation.
shards object Total number of shards created along with number of successful and failed shards.
state string Snapshot status. Possible values: IN_PROGRESS, SUCCESS, FAILED, PARTIAL.
350 characters left

Have a question? .

Want to contribute? or .