Link Search Menu Expand Document Documentation Menu
Documentation

You're viewing version 2.17 of the OpenSearch documentation. This version is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.

Get snapshot.

Introduced 1.0

Retrieves information about a snapshot.

Path and HTTP methods

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 Whether to show all, or just basic snapshot information. If true, returns all information. If false, omits information like start/end times, failures, and shards. Optional, defaults to 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, defaults to 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 .