Skip to content

Commit b3e6f57

Browse files
committed
Provide use cases for manually applying a policy to an index
1 parent 804ae38 commit b3e6f57

File tree

2 files changed

+8
-3
lines changed

2 files changed

+8
-3
lines changed

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
navigation_title: Configure a policy
2+
navigation_title: Configure a lifecycle policy
33
mapped_pages:
44
- https://www.elastic.co/guide/en/elasticsearch/reference/current/set-up-lifecycle-policy.html
55
applies_to:

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

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,14 @@ products:
88

99
# Manually apply a lifecycle policy to an index [apply-policy-manually]
1010

11-
When you create new {{es}} index you can use an index template to apply the lifecycle policy by which the index will be managed. This process is described in [Configure a lifecycle policy](/manage-data/lifecycle/index-lifecycle-management/configure-lifecycle-policy.md).
11+
When you create a new {{es}} index, if the index name matches an index pattern configured in an [index template](/manage-data/data-store/templates.md#index-templates), the new index automatically inherits any settings, mappings, and aliases that are defined in the index template or in any component templates that the index template references. If the template specifies a lifecycle policy, that policy is applied automatically to the newly created index. This process is described in detail in [Configure a lifecycle policy](/manage-data/lifecycle/index-lifecycle-management/configure-lifecycle-policy.md).
1212

13-
You can also manually apply a lifecycle policy to an existing index, as described on this page. If an index is currently managed by an ILM policy you must first remove that policy before applying a new one. Refer to [Switch to a different lifecycle policy](/manage-data/lifecycle/index-lifecycle-management/policy-updates.md#switch-lifecycle-policies) for details.
13+
You can also apply a lifecycle policy manually to existing indices, as described on this page. This is useful if you want to:
14+
* Configure the indices to move through different [data tiers](/manage-data/lifecycle/data-tiers.md) as they age.
15+
* Perform [lifecycle actions](elasticsearch://reference/elasticsearch/index-lifecycle-actions/index.md) such as downsampling or shrinking.
16+
* Delete the indices when they reach a certain age.
17+
18+
If an index is currently managed by an ILM policy you must first remove that policy before applying a new one. Refer to [Switch to a different lifecycle policy](/manage-data/lifecycle/index-lifecycle-management/policy-updates.md#switch-lifecycle-policies) for details.
1419

1520
You can do this procedure in {{kib}} or using the {{es}} API.
1621

0 commit comments

Comments
 (0)