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 repository.
Introduced 1.0
Retrieves information about a snapshot repository.
To learn more about repositories, see Register repository.
You can also get details about a snapshot during and after snapshot creation. See Get snapshot status.
Path and HTTP methods
GET /_snapshot/<repository>
Path parameters
| Parameter | Data type | Description |
|---|---|---|
| repository | String | A comma-separated list of snapshot repository names to retrieve. Wildcard (*) expressions are supported including combining wildcards with exclude patterns starting with -. |
Query parameters
| Parameter | Data type | Description |
|---|---|---|
| local | Boolean | Whether to get information from the local node. Optional, defaults to false. |
| cluster_manager_timeout | Time | Amount of time to wait for a connection to the cluster manager node. Optional, defaults to 30 seconds. |
Example request
The following request retrieves information for the my-opensearch-repo repository:
GET /_snapshot/my-opensearch-repo
Example response
Upon success, the response returns repositry information. This sample is for an s3 repository type.
{
"my-opensearch-repo" : {
"type" : "s3",
"settings" : {
"bucket" : "my-open-search-bucket",
"base_path" : "snapshots"
}
}
}
Response body fields
| Field | Data type | Description |
|---|---|---|
| type | string | Bucket type: fs (file system) or s3 (s3 bucket) |
| bucket | string | S3 bucket name. |
| base_path | string | Folder within the bucket where snapshots are stored. |