redirects.asciidoc 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605
  1. ["appendix",role="exclude",id="redirects"]
  2. = Deleted pages
  3. The following pages have moved or been deleted.
  4. [role="exclude",id="cluster-nodes-shutdown"]
  5. === Nodes shutdown
  6. The `_shutdown` API has been removed. Instead, setup Elasticsearch to run as
  7. a service (see <<rpm>>, <<deb>>, or <<windows>>) or use the `-p`
  8. command line option to <<setup-installation-daemon,write the PID to a file>>.
  9. [role="exclude",id="indices-upgrade"]
  10. === Upgrade API
  11. The `_upgrade` API is no longer useful and will be removed. Instead, see
  12. <<reindex-upgrade>>.
  13. [role="exclude",id="migration-api-assistance"]
  14. === Migration Assistance API
  15. The Migration Assistance API has been replaced with the
  16. <<migration-api-deprecation, Deprecation Info API>>.
  17. [role="exclude",id="migration-api-upgrade"]
  18. === Migration Upgrade API
  19. The Migration Upgrade API has been removed. Use the
  20. {kibana-ref}/upgrade-assistant.html[{kib} Upgrade Assistant] or
  21. <<reindex-upgrade,Reindex manually>> instead.
  22. [role="exclude",id="docs-bulk-udp"]
  23. === Bulk UDP API
  24. The Bulk UDP services has been removed. Use the standard <<docs-bulk>> instead.
  25. [role="exclude",id="indices-delete-mapping"]
  26. === Delete Mapping
  27. It is no longer possible to delete the mapping for a type. Instead you should
  28. <<indices-delete-index,delete the index>> and recreate it with the new mappings.
  29. [role="exclude",id="indices-status"]
  30. === Index Status
  31. The index `_status` API has been replaced with the <<indices-stats>> and
  32. <<indices-recovery>> APIs.
  33. [role="exclude",id="mapping-analyzer-field"]
  34. === `_analyzer`
  35. The `_analyzer` field in type mappings is no longer supported and will be
  36. automatically removed from mappings when upgrading to 2.x.
  37. [role="exclude",id="mapping-boost-field"]
  38. === `_boost`
  39. The `_boost` field in type mappings is no longer supported and will be
  40. automatically removed from mappings when upgrading to 2.x.
  41. [role="exclude",id="mapping-conf-mappings"]
  42. === Config mappings
  43. It is no longer possible to specify mappings in files in the `config`
  44. directory. Instead, mappings should be created using the API with:
  45. * <<indices-create-index>>
  46. * <<indices-put-mapping>>
  47. * <<indices-templates>>
  48. [role="exclude",id="mapping-parent-field"]
  49. === `_parent` field
  50. The `_parent` field has been removed in favour of the <<parent-join,`join` field>>.
  51. [role="exclude",id="mapping-uid-field"]
  52. === `_uid` field
  53. The `_uid` field has been removed in favour of the <<mapping-id-field,`_id` field>>.
  54. [role="exclude",id="modules-memcached"]
  55. === memcached
  56. The `memcached` transport is no longer supported. Instead use the REST
  57. interface over <<modules-http,HTTP>> or the
  58. {javaclient}/index.html[Java API].
  59. [role="exclude",id="modules-thrift"]
  60. === Thrift
  61. The `thrift` transport is no longer supported. Instead use the REST
  62. interface over <<modules-http,HTTP>> or the
  63. {javaclient}/index.html[Java API].
  64. // QUERY DSL
  65. [role="exclude",id="query-dsl-queries"]
  66. === Queries
  67. Queries and filters have been merged. Any query clause can now be used as a query
  68. in ``query context'' and as a filter in ``filter context'' (see <<query-dsl>>).
  69. [role="exclude",id="query-dsl-filters"]
  70. === Filters
  71. Queries and filters have been merged. Any query clause can now be used as a query
  72. in ``query context'' and as a filter in ``filter context'' (see <<query-dsl>>).
  73. [role="exclude",id="query-dsl-not-filter"]
  74. === Not Filter
  75. The `not` query has been replaced by using a `must_not` clause in a `bool` query (see <<query-dsl-bool-query>>).
  76. [role="exclude",id="query-dsl-bool-filter"]
  77. === Bool Filter
  78. The `bool` filter has been replaced by the <<query-dsl-bool-query>>. It behaves
  79. as a query in ``query context'' and as a filter in ``filter context'' (see
  80. <<query-dsl>>).
  81. [role="exclude",id="query-dsl-exists-filter"]
  82. === Exists Filter
  83. The `exists` filter has been replaced by the <<query-dsl-exists-query>>. It behaves
  84. as a query in ``query context'' and as a filter in ``filter context'' (see
  85. <<query-dsl>>).
  86. [role="exclude",id="query-dsl-geo-bounding-box-filter"]
  87. === Geo Bounding Box Filter
  88. The `geo_bounding_box` filter has been replaced by the <<query-dsl-geo-bounding-box-query>>.
  89. It behaves as a query in ``query context'' and as a filter in ``filter
  90. context'' (see <<query-dsl>>).
  91. [role="exclude",id="query-dsl-geo-distance-filter"]
  92. === Geo Distance Filter
  93. The `geo_distance` filter has been replaced by the <<query-dsl-geo-distance-query>>.
  94. It behaves as a query in ``query context'' and as a filter in ``filter
  95. context'' (see <<query-dsl>>).
  96. [role="exclude",id="query-dsl-geo-distance-range-filter"]
  97. === Geo Distance Range Filter
  98. The `geo_distance_range` filter has been replaced by the <<query-dsl-geo-distance-range-query>>.
  99. It behaves as a query in ``query context'' and as a filter in ``filter
  100. context'' (see <<query-dsl>>).
  101. [role="exclude",id="query-dsl-geo-polygon-filter"]
  102. === Geo Polygon Filter
  103. The `geo_polygon` filter has been replaced by the <<query-dsl-geo-polygon-query>>.
  104. It behaves as a query in ``query context'' and as a filter in ``filter
  105. context'' (see <<query-dsl>>).
  106. [role="exclude",id="query-dsl-geo-shape-filter"]
  107. === Geo Shape Filter
  108. The `geo_shape` filter has been replaced by the <<query-dsl-geo-shape-query>>.
  109. It behaves as a query in ``query context'' and as a filter in ``filter
  110. context'' (see <<query-dsl>>).
  111. [role="exclude",id="query-dsl-has-child-filter"]
  112. === Has Child Filter
  113. The `has_child` filter has been replaced by the <<query-dsl-has-child-query>>. It behaves
  114. as a query in ``query context'' and as a filter in ``filter context'' (see
  115. <<query-dsl>>).
  116. [role="exclude",id="query-dsl-has-parent-filter"]
  117. === Has Parent Filter
  118. The `has_parent` filter has been replaced by the <<query-dsl-has-parent-query>>. It behaves
  119. as a query in ``query context'' and as a filter in ``filter context'' (see
  120. <<query-dsl>>).
  121. [role="exclude",id="query-dsl-top-children-query"]
  122. === Top Children Query
  123. The `top_children` query has been removed. Use the <<query-dsl-has-child-query>> instead.
  124. [role="exclude",id="query-dsl-ids-filter"]
  125. === IDs Filter
  126. The `ids` filter has been replaced by the <<query-dsl-ids-query>>. It behaves
  127. as a query in ``query context'' and as a filter in ``filter context'' (see
  128. <<query-dsl>>).
  129. [role="exclude",id="query-dsl-match-all-filter"]
  130. === Match All Filter
  131. The `match_all` filter has been replaced by the <<query-dsl-match-all-query>>. It behaves
  132. as a query in ``query context'' and as a filter in ``filter context'' (see
  133. <<query-dsl>>).
  134. [role="exclude",id="query-dsl-nested-filter"]
  135. === Nested Filter
  136. The `nested` filter has been replaced by the <<query-dsl-nested-query>>. It behaves
  137. as a query in ``query context'' and as a filter in ``filter context'' (see
  138. <<query-dsl>>).
  139. [role="exclude",id="query-dsl-prefix-filter"]
  140. === Prefix Filter
  141. The `prefix` filter has been replaced by the <<query-dsl-prefix-query>>. It behaves
  142. as a query in ``query context'' and as a filter in ``filter context'' (see
  143. <<query-dsl>>).
  144. [role="exclude",id="query-dsl-query-filter"]
  145. === Query Filter
  146. The `query` filter has been removed as queries and filters have been merged (see
  147. <<query-dsl>>).
  148. [role="exclude",id="query-dsl-range-filter"]
  149. === Range Filter
  150. The `range` filter has been replaced by the <<query-dsl-range-query>>. It behaves
  151. as a query in ``query context'' and as a filter in ``filter context'' (see
  152. <<query-dsl>>).
  153. [role="exclude",id="query-dsl-regexp-filter"]
  154. === Regexp Filter
  155. The `regexp` filter has been replaced by the <<query-dsl-regexp-query>>. It behaves
  156. as a query in ``query context'' and as a filter in ``filter context'' (see
  157. <<query-dsl>>).
  158. [role="exclude",id="query-dsl-script-filter"]
  159. === Script Filter
  160. The `script` filter has been replaced by the <<query-dsl-script-query>>. It behaves
  161. as a query in ``query context'' and as a filter in ``filter context'' (see
  162. <<query-dsl>>).
  163. [role="exclude",id="query-dsl-term-filter"]
  164. === Term Filter
  165. The `term` filter has been replaced by the <<query-dsl-term-query>>. It behaves
  166. as a query in ``query context'' and as a filter in ``filter context'' (see
  167. <<query-dsl>>).
  168. [role="exclude",id="query-dsl-terms-filter"]
  169. === Terms Filter
  170. The `terms` filter has been replaced by the <<query-dsl-terms-query>>. It behaves
  171. as a query in ``query context'' and as a filter in ``filter context'' (see
  172. <<query-dsl>>).
  173. [role="exclude",id="query-dsl-flt-query"]
  174. === Fuzzy Like This Query
  175. The `fuzzy_like_this`, alternatively known as `flt`, query has been removed. Instead use either
  176. the <<query-dsl-match-query-fuzziness,`fuzziness`>> parameter with the
  177. <<query-dsl-match-query,`match` query>> or the <<query-dsl-mlt-query>>.
  178. [role="exclude",id="query-dsl-flt-field-query"]
  179. === Fuzzy Like This Field Query
  180. The `fuzzy_like_this_field` or `flt_field` query has been removed. Instead use
  181. the <<query-dsl-match-query-fuzziness,`fuzziness`>> parameter with the
  182. <<query-dsl-match-query,`match` query>> or the <<query-dsl-mlt-query>>.
  183. [role="exclude",id="query-dsl-geo-distance-range-query"]
  184. === Geo distance range Query
  185. The `geo_distance_range` query has been removed. Instead use the
  186. <<query-dsl-geo-distance-query, Geo Distance Query>> with pagination
  187. or the
  188. <<search-aggregations-bucket-geodistance-aggregation, Geo Distance Aggregation>>
  189. depending on your needs.
  190. [role="exclude",id="query-dsl-geohash-cell-query"]
  191. === Geohash Cell Query
  192. The `geohash_cell` query has been removed. Instead use the
  193. <<query-dsl-geo-bounding-box-query, Geo Bounding Box Query>>.
  194. [role="exclude",id="search-more-like-this"]
  195. === More Like This API
  196. The More Like This API has been removed. Instead, use the <<query-dsl-mlt-query>>.
  197. // FACETS
  198. [role="exclude",id="search-facets"]
  199. === Facets
  200. Faceted search refers to a way to explore large amounts of data by displaying
  201. summaries about various partitions of the data and later allowing to narrow
  202. the navigation to a specific partition.
  203. In Elasticsearch, `facets` are also the name of a feature that allowed to
  204. compute these summaries. `facets` have been replaced by
  205. <<search-aggregations, aggregations>> in Elasticsearch 1.0, which are a superset
  206. of facets.
  207. [role="exclude",id="search-facets-filter-facet"]
  208. === Filter Facet
  209. Facets have been removed. Use the
  210. <<search-aggregations-bucket-filter-aggregation,`filter` aggregation>> or
  211. <<search-aggregations-bucket-filters-aggregation,`filters` aggregation>> instead.
  212. [role="exclude",id="search-facets-query-facet"]
  213. === Query Facet
  214. Facets have been removed. Use the
  215. <<search-aggregations-bucket-filter-aggregation,`filter` aggregation>> or
  216. <<search-aggregations-bucket-filters-aggregation,`filters` aggregation>> instead.
  217. [role="exclude",id="search-facets-geo-distance-facet"]
  218. === Geo Distance Facet
  219. Facets have been removed. Use the
  220. <<search-aggregations-bucket-geodistance-aggregation,`geo_distance` aggregation>> instead.
  221. [role="exclude",id="search-facets-histogram-facet"]
  222. === Histogram Facet
  223. Facets have been removed. Use the
  224. <<search-aggregations-bucket-histogram-aggregation,`histogram` aggregation>> instead.
  225. [role="exclude",id="search-facets-date-histogram-facet"]
  226. === Date Histogram Facet
  227. Facets have been removed. Use the
  228. <<search-aggregations-bucket-datehistogram-aggregation,`date_histogram` aggregation>> instead.
  229. [role="exclude",id="search-facets-range-facet"]
  230. === Range Facet
  231. Facets have been removed. Use the
  232. <<search-aggregations-bucket-range-aggregation,`range` aggregation>> instead.
  233. [role="exclude",id="search-facets-terms-facet"]
  234. === Terms Facet
  235. Facets have been removed. Use the
  236. <<search-aggregations-bucket-terms-aggregation,`terms` aggregation>> instead.
  237. [role="exclude",id="search-facets-terms-statistical-facet"]
  238. === Terms Stats Facet
  239. Facets have been removed. Use the
  240. <<search-aggregations-bucket-terms-aggregation,`terms` aggregation>>
  241. with the <<search-aggregations-metrics-stats-aggregation,`stats` aggregation>>
  242. or the <<search-aggregations-metrics-extendedstats-aggregation,`extended_stats` aggregation>>
  243. instead.
  244. [role="exclude",id="search-facets-statistical-facet"]
  245. === Statistical Facet
  246. Facets have been removed. Use the
  247. <<search-aggregations-metrics-stats-aggregation,`stats` aggregation>>
  248. or the <<search-aggregations-metrics-extendedstats-aggregation,`extended_stats` aggregation>> instead.
  249. [role="exclude",id="search-facets-migrating-to-aggs"]
  250. === Migrating from facets to aggregations
  251. Facets have been removed. Use <<search-aggregations>> instead.
  252. // CACHES
  253. [role="exclude",id="shard-query-cache"]
  254. === Shard request cache
  255. The shard query cache has been renamed <<shard-request-cache>>.
  256. [role="exclude",id="filter-cache"]
  257. === Query cache
  258. The filter cache has been renamed <<query-cache>>.
  259. [role="exclude",id="query-dsl-filtered-query"]
  260. === Filtered query
  261. The `filtered` query is replaced by the <<query-dsl-bool-query,bool>> query. Instead of
  262. the following:
  263. [source,js]
  264. -------------------------
  265. ## INCORRECT - DEPRECATED SYNTAX, DO NOT USE
  266. GET _search
  267. {
  268. "query": {
  269. "filtered": {
  270. "query": {
  271. "match": {
  272. "text": "quick brown fox"
  273. }
  274. },
  275. "filter": {
  276. "term": {
  277. "status": "published"
  278. }
  279. }
  280. }
  281. }
  282. }
  283. -------------------------
  284. // NOTCONSOLE
  285. move the query and filter to the `must` and `filter` parameters in the `bool`
  286. query:
  287. [source,js]
  288. -------------------------
  289. GET _search
  290. {
  291. "query": {
  292. "bool": {
  293. "must": {
  294. "match": {
  295. "text": "quick brown fox"
  296. }
  297. },
  298. "filter": {
  299. "term": {
  300. "status": "published"
  301. }
  302. }
  303. }
  304. }
  305. }
  306. -------------------------
  307. // CONSOLE
  308. [role="exclude",id="query-dsl-or-query"]
  309. === Or query
  310. The `or` query is replaced in favour of the <<query-dsl-bool-query,bool>> query.
  311. [role="exclude",id="query-dsl-or-filter"]
  312. === Or filter
  313. The `or` filter is replaced in favour of the <<query-dsl-bool-query,bool>> query.
  314. [role="exclude",id="query-dsl-and-query"]
  315. === And query
  316. The `and` query is replaced in favour of the <<query-dsl-bool-query,bool>> query.
  317. [role="exclude",id="query-dsl-and-filter"]
  318. === And filter
  319. The `and` filter is replaced in favour of the <<query-dsl-bool-query,bool>> query.
  320. [role="exclude",id="query-dsl-limit-query"]
  321. === Limit query
  322. The `limit` query is replaced in favour of the <<search-request-body,terminate_after>>
  323. parameter of search requests.
  324. [role="exclude",id="query-dsl-limit-filter"]
  325. === Limit filter
  326. The `limit` filter is replaced in favour of the <<search-request-body,terminate_after>>
  327. parameter of search requests.
  328. [role="exclude",id="query-dsl-not-query"]
  329. === Not query
  330. The `not` query has been replaced by using a `mustNot` clause in a Boolean query.
  331. [role="exclude",id="mapping-nested-type"]
  332. === Nested type
  333. The docs for the `nested` field datatype have moved to <<nested>>.
  334. [role="exclude",id="indices-warmers"]
  335. === Warmers
  336. Warmers have been removed. There have been significant improvements to the
  337. index that make warmers not necessary anymore.
  338. [role="exclude",id="index-boost"]
  339. === Index time boosting
  340. The index time boost mapping has been replaced with query time boost (see <<mapping-boost>>).
  341. [role="exclude",id="modules-scripting-native"]
  342. === Native scripting
  343. Native scripts have been replaced with writing custom `ScriptEngine` backends (see <<modules-scripting-engine>>).
  344. [role="exclude",id="modules-advanced-scripting"]
  345. === Advanced scripting
  346. Using `_index` in scripts has been replaced with writing `ScriptEngine` backends (see <<modules-scripting-engine>>).
  347. [role="exclude",id="modules-scripting-painless-syntax"]
  348. === Painless Syntax
  349. See the
  350. {painless}/painless-lang-spec.html[Painless Language Specification]
  351. in the guide to the {painless}/index.html[Painless Scripting Language].
  352. [role="exclude",id="modules-scripting-painless-debugging"]
  353. === Painless Debugging
  354. See {painless}/painless-debugging.html[Painless Debugging] in the
  355. guide to the {painless}/index.html[Painless Scripting Language].
  356. [role="exclude",id="painless-api-reference"]
  357. === Painless Contexts API Reference
  358. See the {painless}/painless-api-reference.html[Painless Contexts API Reference]
  359. in the guide to the {painless}/index.html[Painless Scripting Language].
  360. [role="exclude", id="security-api-roles"]
  361. === Role management APIs
  362. You can use the following APIs to add, remove, and retrieve roles in the native realm:
  363. * <<security-api-put-role,Create role>>, <<security-api-delete-role,Delete role>>
  364. * <<security-api-clear-role-cache,Clear roles cache>>
  365. * <<security-api-get-role,Get roles>>
  366. [role="exclude",id="security-api-tokens"]
  367. === Token management APIs
  368. You can use the following APIs to create and invalidate bearer tokens for access
  369. without requiring basic authentication:
  370. * <<security-api-get-token,Get token>>, <<security-api-invalidate-token,Invalidate token>>
  371. [role="exclude",id="security-api-users"]
  372. === User Management APIs
  373. You can use the following APIs to create, read, update, and delete users from the
  374. native realm:
  375. * <<security-api-put-user,Create users>>, <<security-api-delete-user,Delete users>>
  376. * <<security-api-enable-user,Enable users>>, <<security-api-disable-user,Disable users>>
  377. * <<security-api-change-password,Change passwords>>
  378. * <<security-api-get-user,Get users>>
  379. [role="exclude",id="security-api-role-mapping"]
  380. === Role mapping APIs
  381. You can use the following APIs to add, remove, and retrieve role mappings:
  382. * <<security-api-put-role-mapping,Add role mappings>>, <<security-api-delete-role-mapping,Delete role mappings>>
  383. * <<security-api-get-role-mapping,Get role mappings>>
  384. [role="exclude",id="security-api-privileges"]
  385. === Privilege APIs
  386. See <<security-api-has-privileges>>.
  387. [role="exclude",id="xpack-commands"]
  388. === X-Pack commands
  389. See <<commands>>.
  390. [role="exclude",id="ml-api-definitions"]
  391. === Machine learning API definitions
  392. See <<api-definitions>>.
  393. [role="exclude",id="analysis-standard-tokenfilter"]
  394. === Standard filter removed
  395. The standard token filter has been removed.
  396. [role="exclude",id="modules-discovery-azure-classic"]
  397. See <<azure-classic-hosts-provider>>.
  398. [role="exclude",id="modules-discovery-ec2"]
  399. See <<ec2-hosts-provider>>.
  400. [role="exclude",id="modules-discovery-gce"]
  401. See <<gce-hosts-provider>>.
  402. [role="exclude",id="modules-discovery-zen"]
  403. Zen discovery is replaced by the <<modules-discovery,discovery and cluster
  404. formation module>>.
  405. [role="exclude",id="settings-xpack"]
  406. === {xpack} settings in {es}
  407. include::{asciidoc-dir}/../../shared/settings.asciidoc[]
  408. [role="exclude",id="_faster_phrase_queries_with_literal_index_phrases_literal"]
  409. See <<faster-phrase-queries>>.
  410. [role="exclude",id="_faster_prefix_queries_with_literal_index_prefixes_literal.html"]
  411. See <<faster-prefix-queries>>.
  412. [role="exclude",id="setup-xpack"]
  413. === Set up {xpack}
  414. {xpack} is an Elastic Stack extension that provides security, alerting,
  415. monitoring, reporting, machine learning, and many other capabilities. By default,
  416. when you install {es}, {xpack} is installed.