61 lines
1.7 KiB
Plaintext
61 lines
1.7 KiB
Plaintext
[[cat-allocation]]
|
|
=== cat allocation API
|
|
++++
|
|
<titleabbrev>cat allocation</titleabbrev>
|
|
++++
|
|
|
|
|
|
Provides a snapshot of the number of shards allocated to each data node
|
|
and their disk space.
|
|
|
|
|
|
[[cat-allocation-api-request]]
|
|
==== {api-request-title}
|
|
|
|
`GET /_cat/allocation/<node_id>`
|
|
|
|
[[cat-allocation-api-path-params]]
|
|
==== {api-path-parms-title}
|
|
|
|
include::{docdir}/rest-api/common-parms.asciidoc[tag=node-id]
|
|
|
|
[[cat-allocation-api-query-params]]
|
|
==== {api-query-parms-title}
|
|
|
|
include::{docdir}/rest-api/common-parms.asciidoc[tag=bytes]
|
|
|
|
include::{docdir}/rest-api/common-parms.asciidoc[tag=http-format]
|
|
|
|
include::{docdir}/rest-api/common-parms.asciidoc[tag=local]
|
|
|
|
include::{docdir}/rest-api/common-parms.asciidoc[tag=master-timeout]
|
|
|
|
include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-h]
|
|
|
|
include::{docdir}/rest-api/common-parms.asciidoc[tag=help]
|
|
|
|
include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-s]
|
|
|
|
include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-v]
|
|
|
|
[[cat-allocation-api-example]]
|
|
==== {api-examples-title}
|
|
|
|
[source,console]
|
|
--------------------------------------------------
|
|
GET /_cat/allocation?v
|
|
--------------------------------------------------
|
|
// TEST[s/^/PUT test\n{"settings": {"number_of_replicas": 0}}\n/]
|
|
|
|
The API returns the following response:
|
|
|
|
[source,txt]
|
|
--------------------------------------------------
|
|
shards disk.indices disk.used disk.avail disk.total disk.percent host ip node
|
|
1 260b 47.3gb 43.4gb 100.7gb 46 127.0.0.1 127.0.0.1 CSUXak2
|
|
--------------------------------------------------
|
|
// TESTRESPONSE[s/\d+(\.\d+)?[tgmk]?b/\\d+(\\.\\d+)?[tgmk]?b/ s/46/\\d+/]
|
|
// TESTRESPONSE[s/CSUXak2/.+/ non_json]
|
|
|
|
This response shows a single shard is allocated to the one node available.
|