# Cluster Allocation Explain API **cluster allocation explanation API**?的目的是幫助回答這個問題 “為什么這個分片沒有被分配”。為了說明分片的分配（未分配狀態），發出一個這樣的請求 :? | `$ curl -XGET?``'[http://localhost:9200/_cluster/allocation/explain'](http://localhost:9200/_cluster/allocation/explain')`?`-d'{` `"index"``:?``"myindex"``,` `"shard"``: 0,` `"primary"``:?``false` `}'` | 指定您希望查看的說明的?**index**?和?**shard**?的?**id**，和?**primary**?標記一樣來指出是否?**explain**?一個主或者副本分片。 該響應如下 :? | `{` `"shard"`?`: {` `"index"`?`:?``"myindex"``,` `"index_uuid"`?`:?``"KnW0-zELRs6PK84l0r38ZA"``,` `"id"`?`: 0,` `"primary"`?`:?``false` `},` `"assigned"`?`:?``false``,???????????????????????????? ①` `"shard_state_fetch_pending"``:?``false``,???????????? ②` `"unassigned_info"`?`: {` `"reason"`?`:?``"INDEX_CREATED"``,?????????????????? ③` `"at"`?`:?``"2016-03-22T20:04:23.620Z"` `},` `"allocation_delay_ms"`?`: 0,????????????????????? ④` `"remaining_delay_ms"`?`: 0,?????????????????????? ⑤` `"nodes"`?`: {` `"V-Spi0AyRZ6ZvKbaI3691w"`?`: {` `"node_name"`?`:?``"H5dfFeA"``,` `"node_attributes"`?`: {?????????????????????? ⑥` `"bar"`?`:?``"baz"` `},` `"store"`?`: {` `"shard_copy"`?`:?``"NONE"`?????????????????????`⑦` `},` `"final_decision"`?`:?``"NO"``,??????????????????? ⑧` `"final_explanation"`?`:?``"the shard cannot be assigned because one or more allocation decider returns a 'NO' decision"``,` `"weight"`?`: 0.06666675,????????????????????? ⑨` `"decisions"`?`: [ {?????????????????????????? ⑩` `"decider"`?`:?``"filter"``,` `"decision"`?`:?``"NO"``,` `"explanation"`?`:?``"node does not match index include filters [foo:\"bar\"]"` `} ]` `},` `"Qc6VL8c5RWaw1qXZ0Rg57g"`?`: {` `"node_name"`?`:?``"bGG90GE"``,` `"node_attributes"`?`: {` `"bar"`?`:?``"baz"``,` `"foo"`?`:?``"bar"` `},` `"store"`?`: {` `"shard_copy"`?`:?``"AVAILABLE"` `},` `"final_decision"`?`:?``"NO"``,` `"final_explanation"`?`:?``"the shard cannot be assigned because one or more allocation decider returns a 'NO' decision"``,` `"weight"`?`: -1.3833332,` `"decisions"`?`: [ {` `"decider"`?`:?``"same_shard"``,` `"decision"`?`:?``"NO"``,` `"explanation"`?`:?``"the shard cannot be allocated on the same node id [Qc6VL8c5RWaw1qXZ0Rg57g] on which it already exists"` `} ]` `},` `"PzdyMZGXQdGhqTJHF_hGgA"`?`: {` `"node_name"`?`:?``"DKDM97B"``,` `"node_attributes"`?`: { },` `"store"`?`: {` `"shard_copy"`?`:?``"NONE"` `},` `"final_decision"`?`:?``"NO"``,` `"final_explanation"`?`:?``"the shard cannot be assigned because one or more allocation decider returns a 'NO' decision"``,` `"weight"`?`: 2.3166666,` `"decisions"`?`: [ {` `"decider"`?`:?``"filter"``,` `"decision"`?`:?``"NO"``,` `"explanation"`?`:?``"node does not match index include filters [foo:\"bar\"]"` `} ]` `}` `}` `}` | | 編號 | 描述 | | --- | --- | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-1) | Whether the shard is assigned or unassigned | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-2) | Whether information about the shard is still being fetched | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-3) | Reason for the shard originally becoming unassigned | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-4) | Configured delay before the shard can be allocated | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-5) | Remaining delay before the shard can be allocated | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-6) | User-added attributes the node has | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-7) | The shard copy information for this node and error (if applicable) | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-8) | Final decision and explanation of whether the shard can be allocated to this node | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-9) | Weight for how much the allocator would like to allocate the shard to this node | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-10) | List of node decisions factoring into final decision about the shard | 對于一個已經分配的分片來說，輸出與下面相似 :? | `{` `"shard"`?`: {` `"index"`?`:?``"only-foo"``,` `"index_uuid"`?`:?``"KnW0-zELRs6PK84l0r38ZA"``,` `"id"`?`: 0,` `"primary"`?`:?``true` `},` `"assigned"`?`:?``true``,` `"assigned_node_id"`?`:?``"Qc6VL8c5RWaw1qXZ0Rg57g"``,????? ①` `"shard_state_fetch_pending"``:?``false``,` `"allocation_delay_ms"`?`: 0,` `"remaining_delay_ms"`?`: 0,` `"nodes"`?`: {` `"V-Spi0AyRZ6ZvKbaI3691w"`?`: {` `"node_name"`?`:?``"bGG90GE"``,` `"node_attributes"`?`: {` `"bar"`?`:?``"baz"` `},` `"store"`?`: {` `"shard_copy"`?`:?``"NONE"` `},` `"final_decision"`?`:?``"NO"``,` `"final_explanation"`?`:?``"the shard cannot be assigned because one or more allocation decider returns a 'NO' decision"``,` `"weight"`?`: 1.4499999,` `"decisions"`?`: [ {` `"decider"`?`:?``"filter"``,` `"decision"`?`:?``"NO"``,` `"explanation"`?`:?``"node does not match index include filters [foo:\"bar\"]"` `} ]` `},` `"Qc6VL8c5RWaw1qXZ0Rg57g"`?`: {` `"node_name"`?`:?``"I8hydUG"``,` `"node_attributes"`?`: {` `"bar"`?`:?``"baz"``,` `"foo"`?`:?``"bar"` `},` `"store"`?`: {` `"shard_copy"`?`:?``"AVAILABLE"` `},` `"final_decision"`?`:?``"ALREADY_ASSIGNED"``,??????? ②` `"final_explanation"`?`:?``"the shard is already assigned to this node"``,` `"weight"`?`: 0.0,` `"decisions"`?`: [ {` `"decider"`?`:?``"same_shard"``,` `"decision"`?`:?``"NO"``,` `"explanation"`?`:?``"the shard cannot be allocated on the same node id [Qc6VL8c5RWaw1qXZ0Rg57g] on which it already exists"` `} ]` `},` `"PzdyMZGXQdGhqTJHF_hGgA"`?`: {` `"node_name"`?`:?``"H5dfFeA"``,` `"node_attributes"`?`: { },` `"store"`?`: {` `"shard_copy"`?`:?``"NONE"` `},` `"final_decision"`?`:?``"NO"``,` `"final_explanation"`?`:?``"the shard cannot be assigned because one or more allocation decider returns a 'NO' decision"``,` `"weight"`?`: 3.6999998,` `"decisions"`?`: [ {` `"decider"`?`:?``"filter"``,` `"decision"`?`:?``"NO"``,` `"explanation"`?`:?``"node does not match index include filters [foo:\"bar\"]"` `} ]` `}` `}` `}` | | 編號 | 描述 | | --- | --- | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO139-1) | Node the shard is currently assigned to | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO139-2) | The decision is "ALREADY_ASSIGNED" because the shard is currently assigned to this node | 您也可以讓?**Elasticsearch explain**?第一個未分配分片的分配情況，它可以通過發送一個空的?**body**?來找到，例如 :? | `$ curl -XGET?``'[http://localhost:9200/_cluster/allocation/explain'](http://localhost:9200/_cluster/allocation/explain')` | 如果您想要去包含所有的那些我們考慮到的最終的決策的決定，該***`include_yes_decisions`?***參數將返回所有的決策 :? | `$ curl -XGET?``'[http://localhost:9200/_cluster/allocation/explain?include_yes_decisions=true'](http://localhost:9200/_cluster/allocation/explain?include_yes_decisions=true%27)` | 此外，通過設置?***`include_disk_info`***參數為?***true***，您可以返回通過集群信息服務返回收集到的信息，包括硬盤使用和分配大小。 | `$ curl -XGET?``'[http://localhost:9200/_cluster/allocation/explain?include_disk_info=true'](http://localhost:9200/_cluster/allocation/explain?include_disk_info=true%27)` |