Skip to content

[DOCS] Add system indices deprecation #80095

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 27 additions & 2 deletions docs/reference/migration/migrate_7_16.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,12 @@ your application to {es} 7.16.
See also <<release-highlights>> and <<es-release-notes>>.

* <<breaking_716_settings_changes>>
* <<breaking_716_tls_changes>>
* <<breaking_716_ilm_changes>>
* <<breaking_716_monitoring_changes>>

* <<breaking_716_settings_deprecations>>
* <<breaking_716_indices_deprecations>>
* <<breaking_716_cluster_deprecations>>

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

[discrete]
[[breaking_716_indices_deprecations]]
==== Indices deprecations

[[deprecation-system-indices]]
.Direct access to system indices is deprecated.
[%collapsible]
====
*Details* +
Directly accessing system indices is deprecated. In {es} 8.0, you must add the
`allow_restricted_indices` permission set to `true` on a user role to access
system indices. Refer to
{ref}/defining-roles.html#roles-indices-priv[indices privileges] for
information on adding this permission to an index privilege.

*Impact* +
Accessing system indices directly results in warnings in the header of API
responses and in the deprecation logs. Use {kib} or the associated feature's
{es} APIs to manage the data that you want to access. While it's still possible
to access system indices in {es} 7.16, they are reserved only for internal use
by Elastic products and should not be accessed directly.
====

[discrete]
[[breaking_716_cluster_deprecations]]
==== Cluster deprecations
Expand All @@ -322,7 +347,7 @@ parameter `?return_200_for_cluster_health_timeout` in your request.
====

[[script-context-cache-deprecated]]
.The script context cache is deprecated
.The script context cache is deprecated.
[%collapsible]
====
*Details* +
Expand Down