cat allocation APIedit

Provides a snapshot of the number of shards allocated to each data node and their disk space.


GET /_cat/allocation/<node_id>

GET /_cat/allocation


  • If the Elasticsearch security features are enabled, you must have the monitor or manage cluster privilege to use this API.

Path parametersedit

(Optional, string) Comma-separated list of node IDs or names used to limit returned information.

Query parametersedit

(Optional, byte size units) Unit used to display byte values.
(Optional, string) Short version of the HTTP accept header. Valid values include JSON, YAML, etc.
(Optional, Boolean) If true, the request retrieves information from the local node only. Defaults to false, which means information is retrieved from the master node.
(Optional, time units) Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. Defaults to 30s.
(Optional, string) Comma-separated list of column names to display.
(Optional, Boolean) If true, the response includes help information. Defaults to false.
(Optional, string) Comma-separated list of column names or column aliases used to sort the response.
(Optional, Boolean) If true, the response includes column headings. Defaults to false.

Response bodyedit

Number of primary and replica shards assigned to the node.

Disk space used by the node’s shards. Does not include disk space for the translog or unassigned shards.

This metric double-counts disk space for hard-linked files, such as those created when shrinking, splitting, or cloning an index.


Total disk space in use. Elasticsearch retrieves this metric from the node’s operating system (OS). The metric includes disk space for:

  • Elasticsearch, including the translog and unassigned shards
  • The node’s OS
  • Any other applications or files on the node

Unlike disk.indices, this metric does not double-count disk space for hard-linked files.

Free disk space available to Elasticsearch. Elasticsearch retrieves this metric from the node’s OS. Disk-based shard allocation uses this metric to assign shards to nodes based on available disk space.
Total disk space for the node, including in-use and available space.
Total percentage of disk space in use. Calculated as disk.used /
Network host for the node. Set using
IP address and port for the node.
Name for the node. Set using


GET /_cat/allocation?v=true

The API returns the following response:

shards disk.indices disk.used disk.avail disk.percent host      ip        node
     1         260b    47.3gb     43.4gb    100.7gb           46 CSUXak2

This response shows a single shard is allocated to the one node available.