---
type: api
title: Cluster
description: The cluster APIs enable you to retrieve information about your infrastructure on cluster, node, or shard level. You can manage cluster settings and voting configuration exceptions, collect node statistics and retrieve node information.
url: https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-cluster
resource: https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-cluster
products:
  - Elasticsearch
---

# Cluster

`cluster`

The cluster APIs enable you to retrieve information about your infrastructure on cluster, node, or shard level. You can manage cluster settings and voting configuration exceptions, collect node statistics and retrieve node information.

[Learn more about the cluster state.](https://www.elastic.co/docs/deploy-manage/distributed-architecture/discovery-cluster-formation/cluster-state-overview)

- [Ping the cluster](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ping): `HEAD` `/`
- [Explain the shard allocations](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-allocation-explain): `POST` (also `GET`) `/_cluster/allocation/explain`
- [Get the cluster health status](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-health): `GET` `/_cluster/health/{index}`, `GET` `/_cluster/health`
- [Get the pending cluster tasks](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-pending-tasks): `GET` `/_cluster/pending_tasks`
- [Reroute the cluster](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-reroute): `POST` `/_cluster/reroute`
- [Get cluster-wide settings](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-get-settings): `GET` `/_cluster/settings`
- [Update the cluster settings](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-put-settings): `PUT` `/_cluster/settings`
- [Get the cluster state](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-state): `GET` `/_cluster/state/{metric}/{index}`, `GET` `/_cluster/state/{metric}`, `GET` `/_cluster/state`
- [Get cluster statistics](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-stats): `GET` `/_cluster/stats/nodes/{node_id}`, `GET` `/_cluster/stats`
- [Update voting configuration exclusions](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-post-voting-config-exclusions): `POST` `/_cluster/voting_config_exclusions`
- [Clear cluster voting config exclusions](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-delete-voting-config-exclusions): `DELETE` `/_cluster/voting_config_exclusions`
- [Get cluster subsystem info](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-info): `GET` `/_info/{target}`
- [Get cluster repositories metering](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-nodes-get-repositories-metering-info): `GET` `/_nodes/{node_id}/_repositories_metering`
- [Clear the archived repositories metering](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-nodes-clear-repositories-metering-archive): `DELETE` `/_nodes/{node_id}/_repositories_metering/{max_archive_version}`
- [Get the hot threads for nodes](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-nodes-hot-threads): `GET` `/_nodes/{node_id}/hot_threads`, `GET` `/_nodes/hot_threads`
- [Reload the keystore on nodes in the cluster](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-nodes-reload-secure-settings): `POST` `/_nodes/{node_id}/reload_secure_settings`, `POST` `/_nodes/reload_secure_settings`
- [Get node statistics](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-nodes-stats): `GET` `/_nodes/{node_id}/stats/{metric}/{index_metric}`, `GET` `/_nodes/stats/{metric}/{index_metric}`, `GET` `/_nodes/{node_id}/stats/{metric}`, `GET` `/_nodes/{node_id}/stats`, `GET` `/_nodes/stats/{metric}`, `GET` `/_nodes/stats`
- [Get feature usage information](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-nodes-usage): `GET` `/_nodes/{node_id}/usage/{metric}`, `GET` `/_nodes/{node_id}/usage`, `GET` `/_nodes/usage/{metric}`, `GET` `/_nodes/usage`
- [Get node information](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-nodes-info): `GET` `/_nodes/{node_id}/{metric}`, `GET` `/_nodes/{node_id}`, `GET` `/_nodes/{metric}`, `GET` `/_nodes`
- [Get remote cluster information](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-remote-info): `GET` `/_remote/info`