集群重新路由 API

POST /_cluster/reroute?metric=none

重新路由命令允许手动更改集群中单个分片的分配。例如，可以将分片从一个节点显式移动到另一个节点，可以取消分配，并且可以将未分配的分片显式分配给特定节点。

重要的是要注意，在处理任何重新路由命令后，Elasticsearch 将正常执行重新平衡（遵守诸如 cluster.routing.rebalance.enable 之类的设置值），以保持平衡状态。例如，如果请求的分配包括将分片从 node1 移动到 node2，则这可能会导致分片从 node2 移回 node1 以实现平衡。

可以使用 cluster.routing.allocation.enable 设置将集群设置为禁用分配。如果禁用了分配，则将执行的唯一分配是使用 reroute 命令给出的显式分配，以及由于重新平衡而产生的后续分配。

可以通过使用 ?dry_run URI 查询参数，或者在请求正文中传递 "dry_run": true，以“模拟运行”模式运行 reroute 命令。这将计算将命令应用于当前集群状态的结果，并在应用命令（和重新平衡）后返回生成的集群状态，但实际上不会执行请求的更改。

如果包含 ?explain URI 查询参数，则响应中将包含有关为什么可以或不能执行命令的详细说明。

集群将尝试连续分配一个分片最多 index.allocation.max_retries 次（默认为 5），然后再放弃并使分片处于未分配状态。这种情况可能是由结构性问题引起的，例如具有引用并非在所有节点上都存在的停用词文件的分析器。

一旦问题得到纠正，可以通过使用 ?retry_failed URI 查询参数调用 reroute API 手动重试分配，这将尝试对这些分片进行单次重试。

这是一个简单的重新路由 API 调用的简短示例

POST /_cluster/reroute?metric=none
{
  "commands": [
    {
      "move": {
        "index": "test", "shard": 0,
        "from_node": "node1", "to_node": "node2"
      }
    },
    {
      "allocate_replica": {
        "index": "test", "shard": 1,
        "node": "node3"
      }
    }
  ]
}