---
title: stack es cluster reroute cli command
description: Reroute the cluster. 
url: https://www.elastic.co/elastic/docs-builder/docs/4116/reference/elastic-cli/cli/stack/es/cluster/reroute
applies_to:
  - Elastic Cloud Serverless: Preview
  - Elastic Stack: Preview
---

# stack es cluster reroute cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic stack es cluster reroute [options]
```

Reroute the cluster.

## Options

<definitions>
  <definition term="--dry-run">
    If true, then the request simulates the operation.
    It will calculate the result of applying the commands to the current cluster state and return the resulting cluster state after the commands (and rebalancing) have been applied; it will not actually perform the requested changes.
  </definition>
  <definition term="--explain">
    If true, then the response contains an explanation of why the commands can or cannot run.
  </definition>
  <definition term="--metric string">
    Limits the information returned to the specified metrics.
    **Repeatable:** pass `--metric` multiple times to supply more than one value
  </definition>
  <definition term="--retry-failed">
    If true, then retries allocation of shards that are blocked due to too many subsequent allocation failures.
  </definition>
  <definition term="--master-timeout string">
    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.
  </definition>
  <definition term="--timeout string">
    Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.
  </definition>
  <definition term="--commands string[]">
    Defines the commands to perform.
    **Repeatable:** pass `--commands` multiple times to supply more than one value
  </definition>
  <definition term="--error-trace">
    When set to `true` Elasticsearch will include the full stack trace of errors
    when they occur.
  </definition>
  <definition term="--filter-path string">
    Comma-separated list of filters in dot notation which reduce the response
    returned by Elasticsearch.
    **Repeatable:** pass `--filter-path` multiple times to supply more than one value
  </definition>
  <definition term="--human">
    When set to `true` will return statistics in a format suitable for humans.
    For example `"exists_time": "1h"` for humans and
    `"exists_time_in_millis": 3600000` for computers. When disabled the human
    readable values will be omitted. This makes sense for responses being consumed
    only by machines.
  </definition>
  <definition term="--pretty">
    If set to `true` the returned JSON will be "pretty-formatted". Only use
    this option for debugging only.
  </definition>
  <definition term="--input-file string">
    path to a JSON file to use as command input
  </definition>
</definitions>


## Global Options

<definitions>
  <definition term="--json">
    output as JSON
  </definition>
</definitions>