Skip to content

Commit 24387ca

Browse files
committed
fixup
1 parent 2660a58 commit 24387ca

File tree

1 file changed

+19
-7
lines changed

1 file changed

+19
-7
lines changed

manage-data/lifecycle/data-stream/tutorial-update-existing-data-stream.md

Lines changed: 19 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ To update the lifecycle of an existing data stream you need to perform the follo
1818

1919
## Set a data stream’s lifecycle [set-lifecycle]
2020

21-
To add or to change the retention period of your data stream you can use **Index Management** in {{kib}} or the {{es}} [PUT lifecycle API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-data-lifecycle).
21+
To add or to change the retention period of your data stream you can use the **Index Management** tools in {{kib}} or the {{es}} [PUT lifecycle API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-data-lifecycle).
2222

2323

2424
:::::{tab-set}
@@ -32,9 +32,14 @@ To change the data retention settings for a data stream:
3232
1. Use the search tool to find the data stream you're looking for.
3333
1. Select the data stream to view details.
3434
1. In the data stream details pane, select **Manage > Edit data retention** to adjust the settings. You can do any of the following:
35-
. Select the duration that your data should be retained, in days, hours, minutes, or seconds.
36-
. Choose to **Keep data indefinitely**, so that your data will not be deleted.
37-
. Disable **Enable data retention** to turn off data stream lifecycle management for your data stream.
35+
36+
- Select the duration that your data should be retained, in days, hours, minutes, or seconds.
37+
- Choose to **Keep data indefinitely**, so that your data will not be deleted. Your data stream is still managed but the data will never be deleted. Managing a time series data stream such as for logs or metrics enables {{es}} to better store your data even if you do not use a retention period.
38+
- Disable **Enable data retention** to turn off data stream lifecycle management for your data stream.
39+
40+
Note that if the data stream is already managed by [{{ilm-init}}](/manage-data/lifecycle/index-lifecycle-management.md), to edit the data retention settings you must edit the associated {{ilm-init}} policy.
41+
42+
3843
:::
3944

4045
:::{tab-item} API
@@ -49,7 +54,7 @@ To change the data retention settings for a data stream:
4954
{ } <1>
5055
```
5156

52-
1. An empty payload means that your data stream is still managed but the data will never be deleted. Managing a time series data stream such as logs or metrics enables {{es}} to better store your data even if you do not use a retention period.
57+
1. An empty payload means that your data stream is still managed but the data will never be deleted. Managing a time series data stream such as for logs or metrics enables {{es}} to better store your data even if you do not use a retention period.
5358

5459
* Or you can set the retention period of your choice. For example:
5560

@@ -139,26 +144,33 @@ The response will look like:
139144

140145
## Remove lifecycle for a data stream [delete-lifecycle]
141146

142-
To remove the lifecycle of a data stream you can use in {{kib}} or the {{es}} [delete lifecycle API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-delete-data-lifecycle).
147+
To remove the lifecycle of a data stream you can use the **Index Management** tools in {{kib}} or the {{es}} [delete lifecycle API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-delete-data-lifecycle).
143148

144149

145150
:::::{tab-set}
146151
:group: kibana-api
147152
:::{tab-item} {{kib}}
148153
:sync: kibana
154+
155+
To remove a data stream's lifecycle:
156+
149157
1. Go to **Stack Management > Index Management** and open the **Data Streams** tab.
150158
1. Use the search tool to find the data stream you're looking for.
151159
1. Select the data stream to view details.
152160
1. In the data stream details pane, select **Manage > Edit data retention**.
153161
1. Turn off the **Enable data retention** option and save your changes. The maintenance operations that were applied by the lifecycle will no longer be applied to the data stream and all of its backing indices.
154-
You can confirm your changes by reopening the data stream pane. The **Effective data retention** will show a **Disabled** status.
162+
163+
You can confirm your changes by reopening the data stream pane. The **Effective data retention** will show a **Disabled** status.
155164

156165
![Index lifecycle status is disabled](/manage-data/images/elasticsearch-reference-lifecycle-disabled.png "")
157166

158167
:::
159168

160169
:::{tab-item} API
161170
:sync: api
171+
172+
To remove a data stream's lifecycle:
173+
162174
```console
163175
DELETE _data_stream/my-data-stream/_lifecycle
164176
```

0 commit comments

Comments
 (0)