mirror of
https://github.com/iSharkFly-Docs/opensearch-docs-cn
synced 2025-03-03 03:09:05 +00:00
fe8d702ca9
* 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>
45 lines
1.1 KiB
Markdown
45 lines
1.1 KiB
Markdown
---
|
|
layout: default
|
|
title: CAT health
|
|
parent: CAT API
|
|
|
|
nav_order: 20
|
|
has_children: false
|
|
---
|
|
|
|
# CAT health
|
|
Introduced 1.0
|
|
{: .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.
|
|
|
|
## Example
|
|
|
|
```json
|
|
GET _cat/health?v
|
|
```
|
|
|
|
## Path and HTTP methods
|
|
|
|
```
|
|
GET _cat/health?v
|
|
```
|
|
|
|
## URL parameters
|
|
|
|
All CAT health URL parameters are optional.
|
|
|
|
Parameter | Type | Description
|
|
:--- | :--- | :---
|
|
time | Time | Specify the units for time. For example, `5d` or `7h`. For more information, see [Supported units]({{site.url}}{{site.baseurl}}/opensearch/units/).
|
|
ts | Boolean | If true, returns HH:MM:SS and Unix epoch timestamps. Default is true.
|
|
|
|
## Response
|
|
|
|
```json
|
|
GET _cat/health?v&time=5d
|
|
|
|
epoch | timestamp | cluster | status | node.total | node.data | shards | pri | relo | init | unassign | pending_tasks | max_task_wait_time | active_shards_percent
|
|
1624248112 | 04:01:52 | odfe-cluster | green | 2 | 2 | 16 | 8 | 0 | 0 | 0 | 0 | - | 100.0%
|
|
```
|