elasticsearch/docs/reference/search
Gordon Brown 91f4b58bf7
Deprecate REST access to System Indices (#60945)
This PR adds deprecation warnings when accessing System Indices via the REST layer. At this time, these warnings are only enabled for Snapshot builds by default, to allow projects external to Elasticsearch additional time to adjust their access patterns.

Deprecation warnings will be triggered by all REST requests which access registered System Indices, except for purpose-specific APIs which access System Indices as an implementation detail a few specific APIs which will continue to allow access to system indices by default:

- `GET _cluster/health`
- `GET {index}/_recovery`
- `GET _cluster/allocation/explain`
- `GET _cluster/state`
- `POST _cluster/reroute`
- `GET {index}/_stats`
- `GET {index}/_segments`
- `GET {index}/_shard_stores`
- `GET _cat/[indices,aliases,health,recovery,shards,segments]`

Deprecation warnings for accessing system indices take the form:
```
this request accesses system indices: [.some_system_index], but in a future major version, direct access to system indices will be prevented by default
```
2020-10-06 11:13:48 -06:00
..
search-your-data Support the 'fields' option in inner_hits and top_hits. (#62259) 2020-09-14 10:08:58 -07:00
suggesters [DOCS] Fix typo in suggester docs (#61077) (#61204) 2020-08-17 09:14:37 -04:00
async-search.asciidoc [DOCS] Move search pagination content to one page (#60515) 2020-07-31 11:43:06 -04:00
clear-scroll-api.asciidoc [DOCS] Replace twitter dataset in search/agg docs (#60667) 2020-08-04 13:31:52 -04:00
count.asciidoc Deprecate REST access to System Indices (#60945) 2020-10-06 11:13:48 -06:00
explain.asciidoc [DOCS] Replace twitter dataset in search/agg docs (#60667) 2020-08-04 13:31:52 -04:00
field-caps.asciidoc [DOCS] Fix field caps API docs (#62110) 2020-09-08 11:56:29 -04:00
multi-search.asciidoc Fix anchor doc for msearch cancellation paragraph 2020-08-21 12:11:00 -04:00
point-in-time-api.asciidoc [DOCS] Display point in time API docs (#61527) 2020-08-25 11:03:41 -04:00
profile.asciidoc Add more debugging information for cardinality agg (#62317) 2020-09-15 08:49:13 -04:00
rank-eval.asciidoc Deprecate REST access to System Indices (#60945) 2020-10-06 11:13:48 -06:00
scroll-api.asciidoc [DOCS] Add PIT to search after docs (#61593) 2020-09-08 09:53:21 -04:00
search-shards.asciidoc Deprecate REST access to System Indices (#60945) 2020-10-06 11:13:48 -06:00
search-template.asciidoc Deprecate REST access to System Indices (#60945) 2020-10-06 11:13:48 -06:00
search.asciidoc [DOCS] Corrected track_total_hits def (#62830) (#63180) 2020-10-02 09:46:09 -04:00
suggesters.asciidoc [DOCS] Replace twitter dataset in search/agg docs (#60667) 2020-08-04 13:31:52 -04:00
validate.asciidoc Deprecate REST access to System Indices (#60945) 2020-10-06 11:13:48 -06:00