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. |