Skip to content

Commit c0a893d

Browse files
author
Adam Locke
authored
[DOCS] Add system indices deprecation (#80095)
* [DOCS] Add system indices deprecation * Clarify impact on deprecation log
1 parent 8b7f8ee commit c0a893d

File tree

1 file changed

+27
-2
lines changed

1 file changed

+27
-2
lines changed

docs/reference/migration/migrate_7_16.asciidoc

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,10 +10,12 @@ your application to {es} 7.16.
1010
See also <<release-highlights>> and <<es-release-notes>>.
1111

1212
* <<breaking_716_settings_changes>>
13+
* <<breaking_716_tls_changes>>
1314
* <<breaking_716_ilm_changes>>
1415
* <<breaking_716_monitoring_changes>>
15-
1616
* <<breaking_716_settings_deprecations>>
17+
* <<breaking_716_indices_deprecations>>
18+
* <<breaking_716_cluster_deprecations>>
1719

1820
//NOTE: The notable-breaking-changes tagged regions are re-used in the
1921
//Installation and Upgrade Guide
@@ -296,6 +298,29 @@ your cluster settings through the `PUT _cluster/settings` REST API. When modifyi
296298
use only persistent settings.
297299
====
298300

301+
[discrete]
302+
[[breaking_716_indices_deprecations]]
303+
==== Indices deprecations
304+
305+
[[deprecation-system-indices]]
306+
.Direct access to system indices is deprecated.
307+
[%collapsible]
308+
====
309+
*Details* +
310+
Directly accessing system indices is deprecated. In {es} 8.0, you must add the
311+
`allow_restricted_indices` permission set to `true` on a user role to access
312+
system indices. Refer to
313+
{ref}/defining-roles.html#roles-indices-priv[indices privileges] for
314+
information on adding this permission to an index privilege.
315+
316+
*Impact* +
317+
Accessing system indices directly results in warnings in the header of API
318+
responses and in the deprecation logs. Use {kib} or the associated feature's
319+
{es} APIs to manage the data that you want to access. While it's still possible
320+
to access system indices in {es} 7.16, they are reserved only for internal use
321+
by Elastic products and should not be accessed directly.
322+
====
323+
299324
[discrete]
300325
[[breaking_716_cluster_deprecations]]
301326
==== Cluster deprecations
@@ -322,7 +347,7 @@ parameter `?return_200_for_cluster_health_timeout` in your request.
322347
====
323348

324349
[[script-context-cache-deprecated]]
325-
.The script context cache is deprecated
350+
.The script context cache is deprecated.
326351
[%collapsible]
327352
====
328353
*Details* +

0 commit comments

Comments
 (0)