You're viewing version 2.13 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 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 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 . |