---
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/elastic/docs-builder/docs/4371/api/doc/elasticsearch/group/endpoint-cluster
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/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)

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