elasticsearch/docs/reference/rest-api
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
..
common-parms.asciidoc Deprecate REST access to System Indices (#60945) 2020-10-06 11:13:48 -06:00
cron-expressions.asciidoc [DOCS] Fix link to quartz crontrigger tutorial (#61531) 2020-08-25 10:49:24 -04:00
defs.asciidoc [DOCS] Fine-tunes data frame analytics API docs formatting. (#50799) 2020-01-09 16:21:01 +01:00
index.asciidoc Remove REST APIs documentation for experimental Searchable Snapshot APIs (#62217) 2020-09-10 15:46:41 +02:00
info.asciidoc Add telemetry for data tiers (#63031) 2020-10-01 08:35:10 -06:00
usage.asciidoc Add telemetry for data tiers (#63031) 2020-10-01 08:35:10 -06:00