2021-06-22 02:13:40 -04:00
|
|
|
---
|
|
|
|
layout: default
|
2022-10-31 12:21:32 -04:00
|
|
|
title: CAT repositories
|
|
|
|
parent: CAT API
|
2022-10-27 12:50:39 -04:00
|
|
|
|
2023-05-02 11:05:49 -04:00
|
|
|
nav_order: 52
|
2021-06-22 02:13:40 -04:00
|
|
|
has_children: false
|
2023-05-04 14:22:52 -04:00
|
|
|
redirect_from:
|
|
|
|
- /opensearch/rest-api/cat/cat-repositories/
|
2021-06-22 02:13:40 -04:00
|
|
|
---
|
|
|
|
|
2022-10-31 12:21:32 -04:00
|
|
|
# CAT repositories
|
2023-10-23 10:53:52 -04:00
|
|
|
**Introduced 1.0**
|
2021-07-26 19:14:22 -04:00
|
|
|
{: .label .label-purple }
|
2021-06-22 02:13:40 -04:00
|
|
|
|
2023-10-26 15:15:56 -04:00
|
|
|
The CAT repositories operation lists all snapshot repositories for a cluster.
|
2021-06-22 02:13:40 -04:00
|
|
|
|
|
|
|
## Example
|
|
|
|
|
|
|
|
```
|
|
|
|
GET _cat/repositories?v
|
|
|
|
```
|
2023-01-30 17:09:38 -05:00
|
|
|
{% include copy-curl.html %}
|
2021-06-22 02:13:40 -04:00
|
|
|
|
|
|
|
## Path and HTTP methods
|
|
|
|
|
|
|
|
```
|
|
|
|
GET _cat/repositories
|
|
|
|
```
|
|
|
|
|
|
|
|
## URL parameters
|
|
|
|
|
2022-10-31 12:21:32 -04:00
|
|
|
All CAT repositories URL parameters are optional.
|
2021-06-22 02:13:40 -04:00
|
|
|
|
2022-10-27 12:50:39 -04:00
|
|
|
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters:
|
2021-06-22 02:13:40 -04:00
|
|
|
|
|
|
|
Parameter | Type | Description
|
|
|
|
:--- | :--- | :---
|
2022-12-06 16:52:33 -05:00
|
|
|
local | Boolean | Whether to return information from the local node only instead of from the cluster_manager node. Default is false.
|
|
|
|
cluster_manager_timeout | Time | The amount of time to wait for a connection to the cluster_manager node. Default is 30 seconds.
|
2021-06-22 02:13:40 -04:00
|
|
|
|
|
|
|
|
|
|
|
## Response
|
|
|
|
|
|
|
|
```json
|
|
|
|
id type
|
|
|
|
repo1 fs
|
|
|
|
repo2 s3
|
|
|
|
```
|