WARNING: Version 6.2 of Elasticsearch has passed its EOL date.
This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.
The cluster state API allows to get a comprehensive state information of the whole cluster.
The response provides the cluster name, the total compressed size of the cluster state (its size when serialized for transmission over the network), and the cluster state itself, which can be filtered to only retrieve the parts of interest, as described below.
By default, the cluster state request is routed to the master node, to
ensure that the latest cluster state is returned.
For debugging purposes, you can retrieve the cluster state local to a
particular node by adding
local=true to the query string.
As the cluster state can grow (depending on the number of shards and indices, your mapping, templates), it is possible to filter the cluster state response specifying the parts in the URL.
metrics can be a comma-separated list of
- Shows the cluster state version.
Shows the elected
master_nodepart of the response
nodespart of the response
routing_tablepart of the response. If you supply a comma separated list of indices, the returned output will only contain the indices listed.
metadatapart of the response. If you supply a comma separated list of indices, the returned output will only contain the indices listed.
blockspart of the response
The following example returns only
routing_table data for the
The next example returns everything for the
And this example return only