Provides a snapshot of the number of shards allocated to each data node and their disk space
IMPORTANT: cat APIs are only intended for human consumption using the command line or Kibana console. They are not intended for use by applications.
Query parameters
-
bytes string
The unit used to display byte values.
Values are
b
,kb
,mb
,gb
,tb
, orpb
. -
local boolean
If
true
, the request computes the list of selected nodes from the local cluster state. Iffalse
the list of selected nodes are computed from the cluster state of the master node. In both cases the coordinating node will send requests for further information to each selected node. -
master_timeout string
Period to wait for a connection to the master node.
GET
/_cat/allocation
curl \
-X GET http://api.example.com/_cat/allocation
Response examples (200)
[
{
"shards": "string",
"shards.undesired": "string",
"": "string",
"host": "string",
"ip": "string",
"node": "string",
"node.role": "string"
}
]