mirror of
https://github.com/iSharkFly-Docs/opensearch-docs-cn
synced 2025-02-07 10:48:09 +00:00
84e4ab158e
* Fix APIs File Signed-off-by: samipak458 <samipak458@gmail.com> * Update API files according to API template Signed-off-by: samipak458 <samipak458@gmail.com> * Update exec-stored-script.md Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> * Update cat-aliases.md Signed-off-by: MUHAMMAD SAMIULLAH <samipak458@gmail.com> * Update cat-allocation.md Signed-off-by: MUHAMMAD SAMIULLAH <samipak458@gmail.com> * Update cat-cluster_manager.md Signed-off-by: MUHAMMAD SAMIULLAH <samipak458@gmail.com> * Update cat-count.md Signed-off-by: MUHAMMAD SAMIULLAH <samipak458@gmail.com> * Update cat-field-data.md Signed-off-by: MUHAMMAD SAMIULLAH <samipak458@gmail.com> * Update cat-health.md Signed-off-by: MUHAMMAD SAMIULLAH <samipak458@gmail.com> * updated * updated * updated --------- Signed-off-by: samipak458 <samipak458@gmail.com> Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Signed-off-by: MUHAMMAD SAMIULLAH <samipak458@gmail.com> Co-authored-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
63 lines
1.9 KiB
Markdown
63 lines
1.9 KiB
Markdown
---
|
|
layout: default
|
|
title: Get Snapshot Repository
|
|
parent: Snapshot APIs
|
|
nav_order: 2
|
|
---
|
|
|
|
# Get snapshot repository.
|
|
**Introduced 1.0**
|
|
{: .label .label-purple }
|
|
|
|
Retrieves information about a snapshot repository.
|
|
|
|
To learn more about repositories, see [Register repository]({{site.url}}{{site.baseurl}}/opensearch/snapshots/snapshot-restore#register-repository).
|
|
|
|
You can also get details about a snapshot during and after snapshot creation. See [Get snapshot status]({{site.url}}{{site.baseurl}}/api-reference/snapshots/get-snapshot-status/).
|
|
{: .note}
|
|
|
|
## 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 master node. Optional, defaults to 30 seconds. |
|
|
|
|
#### Example request
|
|
|
|
The following request retrieves information for the `my-opensearch-repo` repository:
|
|
|
|
````json
|
|
GET /_snapshot/my-opensearch-repo
|
|
````
|
|
{% include copy-curl.html %}
|
|
|
|
#### Example response
|
|
|
|
Upon success, the response returns repositry information. This sample is for an `s3` repository type.
|
|
|
|
````json
|
|
{
|
|
"my-opensearch-repo" : {
|
|
"type" : "s3",
|
|
"settings" : {
|
|
"bucket" : "my-open-search-bucket",
|
|
"base_path" : "snapshots"
|
|
}
|
|
}
|
|
}
|
|
````
|
|
|
|
## Response 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. | |