Loading

Index Settings

action: index_settings
description: "Change settings for selected indices"
options:
  index_settings:
    index:
      refresh_interval: 5s
  ignore_unavailable: False
  preserve_existing: False
filters:
- filtertype: ...
Note

Empty values and commented lines will result in the default value, if any, being selected. If a setting is set, but not used by a given action, it will be ignored.

This action updates the specified index settings for the selected indices.

Important

While Elasticsearch allows for either dotted notation of index settings, such as

PUT /indexname/_settings
{
  "index.blocks.read_only": true
}

or in nested structure, like this:

PUT /indexname/_settings
{
  "index": {
    "blocks": {
      "read_only": true
    }
  }
}

In order to appropriately detect static vs. dynamic index settings and to be able to verify configurational integrity in the YAML file, Curator does not support using dotted notation.

Tip

See an example of this action in an actionfile here.