add operation to titles to differentiate from the API group acronym (#1750)

* add operation to titles to differentiate from the API group acronym

Signed-off-by: alicejw <alicejw@amazon.com>

* update frontmatter with new page title

Signed-off-by: alicejw <alicejw@amazon.com>

* for updates per issue https://github.com/opensearch-project/documentation-website/issues/1713

Signed-off-by: alicejw <alicejw@amazon.com>

* to rename section title in left nav TOC to remove acronym definition and update each page frontmatter accordingly

Signed-off-by: alicejw <alicejw@amazon.com>

* to update page title per AWS Style Guide suggestion to only spell out the acronym the first time it's used in a sentence, not on the page title

Signed-off-by: alicejw <alicejw@amazon.com>

Signed-off-by: alicejw <alicejw@amazon.com>
This commit is contained in:
Alice Williams 2022-10-31 09:21:32 -07:00 committed by GitHub
parent 5557a80f61
commit fe8d702ca9
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
20 changed files with 107 additions and 114 deletions

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat aliases title: CAT aliases
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 1 nav_order: 1
has_children: false has_children: false
--- ---
# cat aliases # CAT aliases
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat aliases operation lists the mapping of aliases to indices, plus routing and filtering information. The CAT aliases operation lists the mapping of aliases to indices, plus routing and filtering information.
## Example ## Example
@ -41,7 +41,7 @@ GET _cat/aliases
## URL parameters ## URL parameters
All cat aliases URL parameters are optional. All CAT aliases URL parameters are optional.
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters: In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters:
@ -57,7 +57,7 @@ The following response shows that `alias1` refers to a `movies` index and has a
```json ```json
alias | index | filter | routing.index | routing.search | is_write_index alias | index | filter | routing.index | routing.search | is_write_index
alias1 | movies | * | - | - | - alias1 | movies | * | - | - | -
.kibana | .kibana_1 | - | - | - | - .opensearch-dashboards | .opensearch-dashboards_1 | - | - | - | -
``` ```
To learn more about index aliases, see [Index aliases]({{site.url}}{{site.baseurl}}/opensearch/index-alias). To learn more about index aliases, see [Index aliases]({{site.url}}{{site.baseurl}}/opensearch/index-alias).

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat allocation title: CAT allocation
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 5 nav_order: 5
has_children: false has_children: false
--- ---
# cat allocation # CAT allocation
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat allocation operation lists the allocation of disk space for indices and the number of shards on each node. The CAT allocation operation lists the allocation of disk space for indices and the number of shards on each node.
## Example ## Example
@ -40,7 +40,7 @@ GET _cat/allocation/<node_name>
## URL parameters ## URL parameters
All cat allocation URL parameters are optional. All CAT allocation URL parameters are optional.
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters: In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters:
@ -48,10 +48,7 @@ Parameter | Type | Description
:--- | :--- | :--- :--- | :--- | :---
bytes | Byte size | Specify the units for byte size. For example, `7kb` or `6gb`. For more information, see [Supported units]({{site.url}}{{site.baseurl}}/opensearch/units/). bytes | Byte size | Specify the units for byte size. For example, `7kb` or `6gb`. For more information, see [Supported units]({{site.url}}{{site.baseurl}}/opensearch/units/).
local | Boolean | Whether to return information from the local node only instead of from the master node. Default is false. local | Boolean | Whether to return information from the local node only instead of from the master node. Default is false.
master_timeout | Time | The amount of time to wait for a connection to the master node. Default is 30 seconds. cluster_manager_timeout | Time | The amount of time to wait for a connection to the cluster manager node. Default is 30 seconds.
## Response ## Response
The following response shows that 8 shards are allocated to each the two nodes available: The following response shows that 8 shards are allocated to each the two nodes available:

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat cluster manager title: CAT cluster manager
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 30 nav_order: 30
has_children: false has_children: false
--- ---
# cat cluster_manager # CAT cluster_manager
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat cluster manager operation lists information that helps identify the elected cluster manager node. The CAT cluster manager operation lists information that helps identify the elected cluster manager node.
## Example ## Example
@ -27,15 +27,13 @@ GET _cat/cluster_manager
## URL parameters ## URL parameters
All cat cluster manager URL parameters are optional. All CAT cluster manager URL parameters are optional.
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters: In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters:
Parameter | Type | Description Parameter | Type | Description
:--- | :--- | :--- :--- | :--- | :---
cluster_manager_timeout | Time | The amount of time to wait for a connection to the cluster manager node. Default is 30 seconds. cluster_manager_timeout | Time | The amount of time to wait for a connection to the cluster manager node. Default is 30 seconds.
## Response ## Response
```json ```json

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat count title: CAT count
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 10 nav_order: 10
has_children: false has_children: false
--- ---
# cat count # CAT count
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat count operation lists the number of documents in your cluster. The CAT count operation lists the number of documents in your cluster.
## Example ## Example
@ -40,7 +40,7 @@ GET _cat/count/<index>?v
## URL parameters ## URL parameters
All cat count URL parameters are optional. You can specify any of the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index). All CAT count URL parameters are optional. You can specify any of the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index).
## Response ## Response

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat field data title: CAT field data
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 15 nav_order: 15
has_children: false has_children: false
--- ---
# cat fielddata # CAT fielddata
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat fielddata operation lists the memory size used by each field per node. The CAT fielddata operation lists the memory size used by each field per node.
## Example ## Example
@ -40,7 +40,7 @@ GET _cat/fielddata/<field_name>?v
## URL parameters ## URL parameters
All cat fielddata URL parameters are optional. All CAT fielddata URL parameters are optional.
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameter: In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameter:

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat health title: CAT health
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 20 nav_order: 20
has_children: false has_children: false
--- ---
# cat health # CAT health
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat health operation lists the status of the cluster, how long the cluster has been up, the number of nodes, and other useful information that helps you analyze the health of your cluster. The CAT health operation lists the status of the cluster, how long the cluster has been up, the number of nodes, and other useful information that helps you analyze the health of your cluster.
## Example ## Example
@ -27,7 +27,7 @@ GET _cat/health?v
## URL parameters ## URL parameters
All cat health URL parameters are optional. All CAT health URL parameters are optional.
Parameter | Type | Description Parameter | Type | Description
:--- | :--- | :--- :--- | :--- | :---

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat indices title: CAT indices operation
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 25 nav_order: 25
has_children: false has_children: false
--- ---
# cat indices # CAT indices
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat indices operation lists information related to indices—how much disk space they are using, how many shards they have, their health status, and so on. The CAT indices operation lists information related to indices—how much disk space they are using, how many shards they have, their health status, and so on.
## Example ## Example
@ -40,7 +40,7 @@ GET _cat/indices
## URL parameters ## URL parameters
All cat indices URL parameters are optional. All CAT indices URL parameters are optional.
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters: In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters:
@ -49,7 +49,7 @@ Parameter | Type | Description
bytes | Byte size | Specify the units for byte size. For example, `7kb` or `6gb`. For more information, see [Supported units]({{site.url}}{{site.baseurl}}/opensearch/units/). bytes | Byte size | Specify the units for byte size. For example, `7kb` or `6gb`. For more information, see [Supported units]({{site.url}}{{site.baseurl}}/opensearch/units/).
health | String | Limit indices based on their health status. Supported values are `green`, `yellow`, and `red`. health | String | Limit indices based on their health status. Supported values are `green`, `yellow`, and `red`.
include_unloaded_segments | Boolean | Whether to include information from segments not loaded into memory. Default is false. include_unloaded_segments | Boolean | Whether to include information from segments not loaded into memory. Default is false.
master_timeout | Time | The amount of time to wait for a connection to the master node. Default is 30 seconds. cluster_manager_timeout | Time | The amount of time to wait for a connection to the cluster manager node. Default is 30 seconds.
pri | Boolean | Whether to return information only from the primary shards. Default is false. pri | Boolean | Whether to return information only from the primary shards. Default is false.
time | Time | Specify the units for time. For example, `5d` or `7h`. For more information, see [Supported units]({{site.url}}{{site.baseurl}}/opensearch/units/). time | Time | Specify the units for time. For example, `5d` or `7h`. For more information, see [Supported units]({{site.url}}{{site.baseurl}}/opensearch/units/).
expand_wildcards | Enum | Expands wildcard expressions to concrete indices. Combine multiple values with commas. Supported values are `all`, `open`, `closed`, `hidden`, and `none`. Default is `open`. expand_wildcards | Enum | Expands wildcard expressions to concrete indices. Combine multiple values with commas. Supported values are `all`, `open`, `closed`, `hidden`, and `none`. Default is `open`.

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat nodeattrs title: CAT nodeattrs
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 35 nav_order: 35
has_children: false has_children: false
--- ---
# cat nodeattrs # CAT nodeattrs
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat nodeattrs operation lists the attributes of custom nodes. The CAT nodeattrs operation lists the attributes of custom nodes.
## Example ## Example
@ -27,14 +27,14 @@ GET _cat/nodeattrs
## URL parameters ## URL parameters
All cat nodeattrs URL parameters are optional. All CAT nodeattrs URL parameters are optional.
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters: In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters:
Parameter | Type | Description Parameter | Type | Description
:--- | :--- | :--- :--- | :--- | :---
local | Boolean | Whether to return information from the local node only instead of from the master node. Default is false. local | Boolean | Whether to return information from the local node only instead of from the master node. Default is false.
master_timeout | Time | The amount of time to wait for a connection to the master node. Default is 30 seconds. cluster_manager_timeout | Time | The amount of time to wait for a connection to the cluster manager node. Default is 30 seconds.
## Response ## Response

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat nodes title: CAT nodes operation
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 40 nav_order: 40
has_children: false has_children: false
--- ---
# cat nodes # CAT nodes
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat nodes operation lists node-level information, including node roles and load metrics. The CAT nodes operation lists node-level information, including node roles and load metrics.
A few important node metrics are `pid`, `name`, `cluster_manager`, `ip`, `port`, `version`, `build`, `jdk`, along with `disk`, `heap`, `ram`, and `file_desc`. A few important node metrics are `pid`, `name`, `cluster_manager`, `ip`, `port`, `version`, `build`, `jdk`, along with `disk`, `heap`, `ram`, and `file_desc`.
@ -29,7 +29,7 @@ GET _cat/nodes
## URL parameters ## URL parameters
All cat nodes URL parameters are optional. All CAT nodes URL parameters are optional.
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters: In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters:

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat pending tasks title: CAT pending tasks
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 45 nav_order: 45
has_children: false has_children: false
--- ---
# cat pending tasks # CAT pending tasks
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat pending tasks operation lists the progress of all pending tasks, including task priority and time in queue. The CAT pending tasks operation lists the progress of all pending tasks, including task priority and time in queue.
## Example ## Example
@ -27,7 +27,7 @@ GET _cat/pending_tasks
## URL parameters ## URL parameters
All cat nodes URL parameters are optional. All CAT nodes URL parameters are optional.
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters: In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters:
@ -37,7 +37,6 @@ local | Boolean | Whether to return information from the local node only instead
cluster_manager_timeout | Time | The amount of time to wait for a connection to the cluster manager node. Default is 30 seconds. cluster_manager_timeout | Time | The amount of time to wait for a connection to the cluster manager node. Default is 30 seconds.
time | Time | Specify the units for time. For example, `5d` or `7h`. For more information, see [Supported units]({{site.url}}{{site.baseurl}}/opensearch/units/). time | Time | Specify the units for time. For example, `5d` or `7h`. For more information, see [Supported units]({{site.url}}{{site.baseurl}}/opensearch/units/).
## Response ## Response
```json ```json

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat plugins title: CAT plugins
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 50 nav_order: 50
has_children: false has_children: false
--- ---
# cat plugins # CAT plugins
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat plugins operation lists the names, components, and versions of the installed plugins. The CAT plugins operation lists the names, components, and versions of the installed plugins.
## Example ## Example
@ -27,15 +27,14 @@ GET _cat/plugins
## URL parameters ## URL parameters
All cat plugins URL parameters are optional. All CAT plugins URL parameters are optional.
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters: In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters:
Parameter | Type | Description Parameter | Type | Description
:--- | :--- | :--- :--- | :--- | :---
local | Boolean | Whether to return information from the local node only instead of from the master node. Default is false. local | Boolean | Whether to return information from the local node only instead of from the cluster_manager node. Default is false.
master_timeout | Time | The amount of time to wait for a connection to the master node. Default is 30 seconds. cluster_manager_timeout | Time | The amount of time to wait for a connection to the cluster_manager node. Default is 30 seconds.
## Response ## Response

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat recovery title: CAT recovery
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 50 nav_order: 50
has_children: false has_children: false
--- ---
# cat recovery # CAT recovery
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat recovery operation lists all completed and ongoing index and shard recoveries. The CAT recovery operation lists all completed and ongoing index and shard recoveries.
## Example ## Example
@ -39,7 +39,7 @@ GET _cat/recovery
## URL parameters ## URL parameters
All cat recovery URL parameters are optional. All CAT recovery URL parameters are optional.
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters: In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters:

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat repositories title: CAT repositories
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 55 nav_order: 55
has_children: false has_children: false
--- ---
# cat repositories # CAT repositories
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat repositories operation lists all completed and ongoing index and shard recoveries. The CAT repositories operation lists all completed and ongoing index and shard recoveries.
## Example ## Example
@ -27,7 +27,7 @@ GET _cat/repositories
## URL parameters ## URL parameters
All cat repositories URL parameters are optional. All CAT repositories URL parameters are optional.
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters: In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameters:

View File

@ -1,13 +1,13 @@
--- ---
layout: default layout: default
title: cat segments title: CAT segments
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 55 nav_order: 55
has_children: false has_children: false
--- ---
# cat segments # CAT segments
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
@ -39,7 +39,7 @@ GET _cat/segments
## URL parameters ## URL parameters
All cat segments URL parameters are optional. All CAT segments URL parameters are optional.
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameter: In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameter:

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat shards title: CAT shards
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 60 nav_order: 60
has_children: false has_children: false
--- ---
# cat shards # CAT shards
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat shards operation lists the state of all primary and replica shards and how they are distributed. The CAT shards operation lists the state of all primary and replica shards and how they are distributed.
## Example ## Example

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat snapshots title: CAT snapshots
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 65 nav_order: 65
has_children: false has_children: false
--- ---
# cat snapshots # CAT snapshots
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat snapshots operation lists all snapshots for a repository. The CAT snapshots operation lists all snapshots for a repository.
## Example ## Example
@ -27,13 +27,13 @@ GET _cat/snapshots
## URL parameters ## URL parameters
All cat snapshots URL parameters are optional. All CAT snapshots URL parameters are optional.
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameter: In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameter:
Parameter | Type | Description Parameter | Type | Description
:--- | :--- | :--- :--- | :--- | :---
master_timeout | Time | The amount of time to wait for a connection to the master node. Default is 30 seconds. cluster_manager_timeout | Time | The amount of time to wait for a connection to the cluster manager node. Default is 30 seconds.
time | Time | Specify the units for time. For example, `5d` or `7h`. For more information, see [Supported units]({{site.url}}{{site.baseurl}}/opensearch/units/). time | Time | Specify the units for time. For example, `5d` or `7h`. For more information, see [Supported units]({{site.url}}{{site.baseurl}}/opensearch/units/).

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat tasks title: CAT tasks
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 70 nav_order: 70
has_children: false has_children: false
--- ---
# cat tasks # CAT tasks
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat tasks operation lists the progress of all tasks currently running on your cluster. The CAT tasks operation lists the progress of all tasks currently running on your cluster.
## Example ## Example
@ -27,7 +27,7 @@ GET _cat/tasks
## URL parameters ## URL parameters
All cat tasks URL parameters are optional. All CAT tasks URL parameters are optional.
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameter: In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameter:

View File

@ -1,17 +1,17 @@
--- ---
layout: default layout: default
title: cat templates title: CAT templates
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 70 nav_order: 70
has_children: false has_children: false
--- ---
# cat templates # CAT templates
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The cat Templates operation lists the names, patterns, order numbers, and version numbers of index templates. The CAT Templates operation lists the names, patterns, order numbers, and version numbers of index templates.
## Example ## Example
@ -33,7 +33,7 @@ GET _cat/templates
## URL parameters ## URL parameters
All cat templates URL parameters are optional. All CAT templates URL parameters are optional.
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameter: In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameter:

View File

@ -1,16 +1,16 @@
--- ---
layout: default layout: default
title: cat thread pool title: CAT thread pool
parent: Compact and aligned text (CAT) API parent: CAT API
nav_order: 75 nav_order: 75
has_children: false has_children: false
--- ---
# cat thread pool # CAT thread pool
Introduced 1.0 Introduced 1.0
{: .label .label-purple } {: .label .label-purple }
The Cat thread pool operation lists the active, queued, and rejected threads of different thread pools on each node. The CAT thread pool operation lists the active, queued, and rejected threads of different thread pools on each node.
## Example ## Example
@ -32,7 +32,7 @@ GET _cat/thread_pool
## URL parameters ## URL parameters
All cat thread pool URL parameters are optional. All CAT thread pool URL parameters are optional.
In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameter: In addition to the [common URL parameters]({{site.url}}{{site.baseurl}}/api-reference/cat/index), you can specify the following parameter:

View File

@ -1,6 +1,6 @@
--- ---
layout: default layout: default
title: Compact and aligned text (CAT) API title: CAT API
nav_order: 10 nav_order: 10
has_children: true has_children: true
redirect_from: redirect_from:
@ -8,15 +8,15 @@ redirect_from:
- /opensearch/rest-api/cat - /opensearch/rest-api/cat
--- ---
# Compact and aligned text (CAT) API # CAT API
You can get essential statistics about your cluster in an easy-to-understand, tabular format using the compact and aligned text (CAT) API. The Cat API is a human-readable interface that returns plain text instead of traditional JSON. You can get essential statistics about your cluster in an easy-to-understand, tabular format using the compact and aligned text (CAT) API. The CAT API is a human-readable interface that returns plain text instead of traditional JSON.
Using the Cat API, you can answer questions like which node is the elected master, what state is the cluster in, how many documents are in each index, and so on. Using the CAT API, you can answer questions like which node is the elected master, what state is the cluster in, how many documents are in each index, and so on.
## Example ## Example
To see the available operations in the Cat API, use the following command: To see the available operations in the CAT API, use the following command:
``` ```
GET _cat GET _cat
@ -24,7 +24,7 @@ GET _cat
## Optional query parameters ## Optional query parameters
You can use the following query parameters with any Cat API to filter your results. You can use the following query parameters with any CAT API to filter your results.
Parameter | Description Parameter | Description
:--- | :--- | :--- | :--- |
@ -36,7 +36,7 @@ Parameter | Description
### Query parameter usage examples ### Query parameter usage examples
You can specify a query parameter to any Cat operation to obtain more specific results. You can specify a query parameter to any CAT operation to obtain more specific results.
### Get verbose output ### Get verbose output