OpenSearch/docs/reference/search
Gordon Brown 5c8b0662df
Deprecate REST access to System Indices (#63274) (Original #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 13:41:40 -06:00
..
search-your-data Support the 'fields' option in inner_hits and top_hits. (#62337) 2020-09-14 11:51:45 -07:00
suggesters [DOCS] Fix typo in suggester docs (#61077) (#61202) 2020-08-17 09:09:34 -04:00
async-search.asciidoc [DOCS] Move search pagination content to one page (#60515) (#60525) 2020-07-31 12:40:40 -04:00
clear-scroll-api.asciidoc [DOCS] Replace `twitter` dataset in search/agg docs (#60667) (#60675) 2020-08-04 14:16:38 -04:00
count.asciidoc Deprecate REST access to System Indices (#63274) (Original #60945) 2020-10-06 13:41:40 -06:00
explain.asciidoc [DOCS] Replace `twitter` dataset in search/agg docs (#60667) (#60675) 2020-08-04 14:16:38 -04:00
field-caps.asciidoc [DOCS] Fix field caps API docs (#62110) (#62116) 2020-09-08 12:19:04 -04:00
multi-search.asciidoc Fix anchor doc for msearch cancellation paragraph 2020-08-24 15:14:17 -04:00
point-in-time-api.asciidoc [7.x] [DOCS] Add PIT to search after docs (#61593) (#62101) 2020-09-14 09:13:23 -04:00
point-in-time.asciidoc Introduce point in time APIs in x-pack basic (#61062) 2020-09-10 19:25:47 -04:00
profile.asciidoc Add more debugging information for cardinality agg (#62317) (#62397) 2020-09-15 13:21:11 -04:00
rank-eval.asciidoc Deprecate REST access to System Indices (#63274) (Original #60945) 2020-10-06 13:41:40 -06:00
scroll-api.asciidoc [7.x] [DOCS] Add PIT to search after docs (#61593) (#62101) 2020-09-14 09:13:23 -04:00
search-shards.asciidoc Deprecate REST access to System Indices (#63274) (Original #60945) 2020-10-06 13:41:40 -06:00
search-template.asciidoc Deprecate REST access to System Indices (#63274) (Original #60945) 2020-10-06 13:41:40 -06:00
search.asciidoc [DOCS] Corrected track_total_hits def (#62830) (#63181) 2020-10-02 09:46:16 -04:00
suggesters.asciidoc [DOCS] Replace `twitter` dataset in search/agg docs (#60667) (#60675) 2020-08-04 14:16:38 -04:00
validate.asciidoc Deprecate REST access to System Indices (#63274) (Original #60945) 2020-10-06 13:41:40 -06:00