2021-06-22 02:13:40 -04:00
|
|
|
---
|
|
|
|
layout: default
|
2022-10-31 12:21:32 -04:00
|
|
|
title: CAT templates
|
|
|
|
parent: CAT API
|
2022-10-27 12:50:39 -04:00
|
|
|
|
2021-06-22 02:13:40 -04:00
|
|
|
nav_order: 70
|
|
|
|
has_children: false
|
2023-05-04 14:22:52 -04:00
|
|
|
redirect_from:
|
|
|
|
- /opensearch/rest-api/cat/cat-templates/
|
2021-06-22 02:13:40 -04:00
|
|
|
---
|
|
|
|
|
2022-10-31 12:21:32 -04:00
|
|
|
# CAT templates
|
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-05-04 14:22:52 -04:00
|
|
|
The CAT templates operation lists the names, patterns, order numbers, and version numbers of index templates.
|
2021-06-22 02:13:40 -04:00
|
|
|
|
|
|
|
## Example
|
|
|
|
|
|
|
|
```
|
|
|
|
GET _cat/templates?v
|
|
|
|
```
|
2023-01-30 17:09:38 -05:00
|
|
|
{% include copy-curl.html %}
|
2021-06-22 02:13:40 -04:00
|
|
|
|
2022-10-06 12:50:04 -04:00
|
|
|
If you want to get information for a specific template or pattern:
|
2021-06-22 02:13:40 -04:00
|
|
|
|
|
|
|
```
|
2022-12-13 12:52:53 -05:00
|
|
|
GET _cat/templates/<template_name_or_pattern>
|
2021-06-22 02:13:40 -04:00
|
|
|
```
|
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/templates
|
|
|
|
```
|
2023-01-30 17:09:38 -05:00
|
|
|
{% include copy-curl.html %}
|
2021-06-22 02:13:40 -04:00
|
|
|
|
|
|
|
## URL parameters
|
|
|
|
|
2022-10-31 12:21:32 -04:00
|
|
|
All CAT templates URL parameters are optional.
|
2021-06-22 02:13:40 -04:00
|
|
|
|
2023-05-04 14:22:52 -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-06-20 14:53:51 -04: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
|
|
|
|
|
|
|
|
```
|
|
|
|
name | index_patterns order version composed_of
|
2022-06-20 14:53:51 -04:00
|
|
|
tenant_template | [opensearch-dashboards*] | 0 |
|
2021-06-22 02:13:40 -04:00
|
|
|
```
|
|
|
|
|
|
|
|
To learn more about index templates, see [Index templates]({{site.url}}{{site.baseurl}}/opensearch/index-templates).
|