elasticsearch/docs/reference/ilm
Lee Hinman 3d5843a236
Allow ILM move-to-step without `action` or `name` (#75435)
* Allow ILM move-to-step without `action` or `name`

This commit enhances ILM's move-to-step API to allow dropping the `name`, or dropping both the
`action` and `name`. For example:

```json
POST /_ilm/move/foo-1
{
  "current_step": {
    "phase": "hot",
    "action": "rollover",
    "name": "check-rollover-ready"
  },
  "next_step": {
    "phase": "warm",
    "action": "forcemerge"
  }
}
```

Will move to the first step in the `forcemerge` action in the `warm` phase (without having to know
the specific step name).

Another example:

```json
POST /_ilm/move/foo-1
{
  "current_step": {
    "phase": "hot",
    "action": "rollover",
    "name": "check-rollover-ready"
  },
  "next_step": {
    "phase": "warm"
  }
}
```

Will move to the first step in the `warm` phase (without having to know the specific action name).

Bear in mind that the execution order is still entirely an implementation detail, so "first" in the
above sentences means the first step that ILM would execute.

Resolves #58128

* Apply Andrei's wording change (thanks!)

Co-authored-by: Andrei Dan <andrei.dan@elastic.co>

* Log index and policy name when the concrete step key can't be resolved

Co-authored-by: Andrei Dan <andrei.dan@elastic.co>
2021-07-19 12:10:25 -04:00
..
actions [DOCS] Note ILM `searchable_snapshot` action requires data tiers (#74706) 2021-06-30 11:03:11 -04:00
apis Allow ILM move-to-step without `action` or `name` (#75435) 2021-07-19 12:10:25 -04:00
error-handling.asciidoc [DOCS] Fix ILM attribute (#62245) 2020-09-10 13:52:37 -04:00
example-index-lifecycle-policy.asciidoc [DOCS] Move ES glossary to Stack docs (#74579) 2021-06-24 19:04:31 -04:00
ilm-actions.asciidoc [DOCS] Remove docs for rollup refactor (#70885) 2021-03-26 09:03:00 -04:00
ilm-and-snapshots.asciidoc [DOCS] Update snapshot/restore and SLM docs for data streams (#58513) 2020-07-13 08:34:42 -04:00
ilm-concepts.asciidoc [DOCS] Rework conceptual info for ILM. (#52181) 2020-04-22 13:53:30 -07:00
ilm-index-lifecycle.asciidoc [DOCS] Fix ILM action order (#74021) 2021-06-10 14:28:44 -04:00
ilm-overview.asciidoc [DOCS] Move ES glossary to Stack docs (#74579) 2021-06-24 19:04:31 -04:00
ilm-skip-rollover.asciidoc [DOCS] Update alias xrefs (#73380) 2021-05-25 16:19:00 -04:00
ilm-tutorial.asciidoc [DOCS] Replace `put` with `create or update` in API names (#70330) 2021-03-15 14:49:44 -04:00
ilm-with-existing-indices.asciidoc [DOCS] Update ILM docs to use composable index templates (#60323) 2020-08-04 12:44:02 -04:00
index-rollover.asciidoc [DOCS] Update alias xrefs (#73380) 2021-05-25 16:19:00 -04:00
index.asciidoc [DOCS] How to migrate to node roles from node attrs. Closes #65855 (#71160) 2021-04-27 14:39:54 -07:00
set-up-lifecycle-policy.asciidoc [DOCS] Document how to switch ILM policies (#73967) 2021-06-28 10:32:01 -04:00
start-stop.asciidoc [DOCS] Update my-index examples (#60132) 2020-07-27 14:46:39 -04:00
update-lifecycle-policy.asciidoc [DOCS] Updating ILM phase language (#68477) 2021-02-03 14:52:38 -05:00