---
title: stack es indices rollover cli command
description: Roll over to a new index. 
url: https://www.elastic.co/elastic/docs-builder/docs/4118/reference/elastic-cli/cli/stack/es/indices/rollover
applies_to:
  - Elastic Cloud Serverless: Preview
  - Elastic Stack: Preview
---

# stack es indices rollover cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic stack es indices rollover --alias <alias> [options]
```

Roll over to a new index.

## Options

<definitions>
  <definition term="--alias string required">
    Name of the data stream or index alias to roll over.
  </definition>
  <definition term="--dry-run">
    If `true`, checks whether the current index satisfies the specified conditions but does not perform a rollover.
  </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="--wait-for-active-shards string">
    The number of shard copies that must be active before proceeding with the operation.
    Set to all or any positive integer up to the total number of shards in the index (`number_of_replicas+1`).
  </definition>
  <definition term="--lazy">
    If set to true, the rollover action will only mark a data stream to signal that it needs to be rolled over at the next write.
    Only allowed on data streams.
  </definition>
  <definition term="--aliases string">
    Aliases for the target index.
    Data streams do not support this parameter.
  </definition>
  <definition term="--conditions string">
    Conditions for the rollover.
    If specified, Elasticsearch only performs the rollover if the current index satisfies these conditions.
    If this parameter is not specified, Elasticsearch performs the rollover unconditionally.
    If conditions are specified, at least one of them must be a `max_*` condition.
    The index will rollover if any `max_*` condition is satisfied and all `min_*` conditions are satisfied.
  </definition>
  <definition term="--mappings string">
    Mapping for fields in the index.
    If specified, this mapping can include field names, field data types, and mapping paramaters.
  </definition>
  <definition term="--settings string">
    Configuration options for the index.
    Data streams do not support this parameter.
  </definition>
  <definition term="--new-index string">
    Name of the index to create.
    Supports date math.
    Data streams do not support this parameter.
  </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>