Skip to content

Commit 91d1515

Browse files
committed
Fix warning about managed templates; add link to tutorial
1 parent 1f3f91e commit 91d1515

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

manage-data/lifecycle/index-lifecycle-management/policy-updates.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,10 @@ When you apply a different policy to a managed index, the index completes the cu
3636

3737
You can update a lifecycle policy that is currently associated with one or more indices.
3838

39+
:::{warning}
40+
Avoid changing any managed policies that are shipped with {{es}}, such as `logs@lifecycle` or `metrics@lifecycle`. Instead, create a new, [custom ILM policy](/manage-data/lifecycle/index-lifecycle-management/tutorial-customize-built-in-policies.md) and associate it with the intended index template or indices.
41+
:::
42+
3943
::::{tab-set}
4044
:group: kibana-api
4145
:::{tab-item} {{kib}}
@@ -94,13 +98,9 @@ The specified policy will be replaced and the policy version is incremented.
9498
You can change an index to be managed by a different {{ilm-init}} policy.
9599

96100
:::::{warning}
97-
Note the following restrictions when switching the policy for an index:
98-
99-
* Avoid changing any managed policies that are shipped with {{es}}, such as `logs@lifecycle` or `metrics@lifecycle`. Instead, create a new ILM policy and associate it with the intended index template or indices.
100-
101-
* When you remove an ILM policy, all {{ilm-init}} metadata is removed from the managed index without consideration of the index’s lifecycle status. This can leave indices in an undesired state.
101+
\When you remove an ILM policy, all {{ilm-init}} metadata is removed from the managed index without consideration of the index’s lifecycle status. This can leave indices in an undesired state.
102102

103-
For example, in certain cases the [`forcemerge`](elasticsearch://reference/elasticsearch/index-lifecycle-actions/ilm-forcemerge.md) action temporarily closes an index before reopening it. Removing an index’s {{ilm-init}} policy during a `forcemerge` can leave the index closed indefinitely.
103+
For example, in certain cases the [`forcemerge`](elasticsearch://reference/elasticsearch/index-lifecycle-actions/ilm-forcemerge.md) action temporarily closes an index before reopening it. Removing an index’s {{ilm-init}} policy during a `forcemerge` can leave the index closed indefinitely.
104104
:::::
105105

106106
::::{tab-set}

0 commit comments

Comments
 (0)