Skip to content

Commit 13bc6c2

Browse files
author
Adam Locke
authored
[DOCS] Add deprecation notice for system indices (#83688) (#83692)
* [DOCS] Add deprecation notice for system indices * Fix spacing issue
1 parent 6ee87f7 commit 13bc6c2

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

docs/reference/migration/migrate_8_0/index-setting-changes.asciidoc

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,24 @@
66
//Installation and Upgrade Guide
77

88
//tag::notable-breaking-changes[]
9+
[[deprecation-system-indices]]
10+
.Direct access to system indices is deprecated.
11+
[%collapsible]
12+
====
13+
*Details* +
14+
Directly accessing system indices is deprecated, and may be prevented in a
15+
future version. If you must access a system index, create a security role with
16+
an index permission that targets the specific index and set the
17+
`allow_restricted_indices` permission to `true`. Refer to
18+
{ref}/defining-roles.html#roles-indices-priv[indices privileges] for
19+
information on adding this permission to an index privilege.
20+
21+
*Impact* +
22+
Accessing system indices directly results in warnings in the header of API
23+
responses. If available, use {kib} or the associated feature's {es} APIs to
24+
manage the data that you want to access.
25+
====
26+
927
[[deprecate-max-merge-at-once-explicit-setting]]
1028
.`index.merge.policy.max_merge_at_once_explicit` is deprecated and has no effect.
1129
[%collapsible]

0 commit comments

Comments
 (0)