Get Snapshot Repository. API
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.
Endpoints
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-reporesponse = client.snapshot.get_repository( repository = "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. |