---
title: stack es indices put-data-lifecycle cli command
description: Update data stream lifecycles. Behaviour flags: --dry-run — validate all inputs and exit without performing any action 
url: https://www.elastic.co/elastic/docs-builder/docs/4120/reference/elastic-cli/cli/stack/es/indices/put-data-lifecycle
applies_to:
  - Elastic Cloud Serverless: Preview
  - Elastic Stack: Preview
---

# stack es indices put-data-lifecycle cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic stack es indices put-data-lifecycle --name <name> [options]
```

Update data stream lifecycles.
**Behaviour flags:**
`--dry-run` — validate all inputs and exit without performing any action

## Options

<definitions>
  <definition term="--name string required">
    Comma-separated list of data streams used to limit the request.
    Supports wildcards (`*`).
    To target all data streams use `*` or `_all`.
    **Repeatable:** pass `--name` multiple times to supply more than one value
  </definition>
  <definition term="--expand-wildcards enum">
    Type of data stream that wildcard patterns can match.
    Supports comma-separated values, such as `open,hidden`.
    **Values:** all, open, closed, hidden, none
    **Repeatable:** pass `--expand-wildcards` multiple times to supply more than one value
  </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="--data-retention string">
    If defined, every document added to this data stream will be stored at least for this time frame.
    Any time after this duration the document could be deleted.
    When empty, every document in this data stream will be stored indefinitely.
  </definition>
  <definition term="--downsampling string[]">
    The downsampling configuration to execute for the managed backing index after rollover.
    **Repeatable:** pass `--downsampling` multiple times to supply more than one value
  </definition>
  <definition term="--downsampling-method enum">
    The method used to downsample the data. There are two options `aggregate` and `last_value`. It requires
    `downsampling` to be defined. Defaults to `aggregate`.
    **Values:** aggregate, last_value
  </definition>
  <definition term="--enabled">
    If defined, it turns data stream lifecycle on/off (`true`/`false`) for this data stream. A data stream lifecycle
    that's disabled (enabled: `false`) will have no effect on the data stream.
  </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>
  <definition term="--dry-run">
    validate all inputs and exit without performing any action (preview changes without applying them)
  </definition>
</definitions>


## Global Options

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