redirects.asciidoc 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596
  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-type-filter"]
  174. === Type Filter
  175. The `type` filter has been replaced by the <<query-dsl-type-query>>. It behaves
  176. as a query in ``query context'' and as a filter in ``filter context'' (see
  177. <<query-dsl>>).
  178. [role="exclude",id="query-dsl-flt-query"]
  179. === Fuzzy Like This Query
  180. The `fuzzy_like_this`, alternatively known as `flt`, query has been removed. Instead use either
  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-flt-field-query"]
  184. === Fuzzy Like This Field Query
  185. The `fuzzy_like_this_field` or `flt_field` query has been removed. Instead use
  186. the <<query-dsl-match-query-fuzziness,`fuzziness`>> parameter with the
  187. <<query-dsl-match-query,`match` query>> or the <<query-dsl-mlt-query>>.
  188. [role="exclude",id="query-dsl-geo-distance-range-query"]
  189. === Geo distance range Query
  190. The `geo_distance_range` query has been removed. Instead use the
  191. <<query-dsl-geo-distance-query, Geo Distance Query>> with pagination
  192. or the
  193. <<search-aggregations-bucket-geodistance-aggregation, Geo Distance Aggregation>>
  194. depending on your needs.
  195. [role="exclude",id="query-dsl-geohash-cell-query"]
  196. === Geohash Cell Query
  197. The `geohash_cell` query has been removed. Instead use the
  198. <<query-dsl-geo-bounding-box-query, Geo Bounding Box Query>>.
  199. [role="exclude",id="search-more-like-this"]
  200. === More Like This API
  201. The More Like This API has been removed. Instead, use the <<query-dsl-mlt-query>>.
  202. // FACETS
  203. [role="exclude",id="search-facets"]
  204. === Facets
  205. Faceted search refers to a way to explore large amounts of data by displaying
  206. summaries about various partitions of the data and later allowing to narrow
  207. the navigation to a specific partition.
  208. In Elasticsearch, `facets` are also the name of a feature that allowed to
  209. compute these summaries. `facets` have been replaced by
  210. <<search-aggregations, aggregations>> in Elasticsearch 1.0, which are a superset
  211. of facets.
  212. [role="exclude",id="search-facets-filter-facet"]
  213. === Filter 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-query-facet"]
  218. === Query Facet
  219. Facets have been removed. Use the
  220. <<search-aggregations-bucket-filter-aggregation,`filter` aggregation>> or
  221. <<search-aggregations-bucket-filters-aggregation,`filters` aggregation>> instead.
  222. [role="exclude",id="search-facets-geo-distance-facet"]
  223. === Geo Distance Facet
  224. Facets have been removed. Use the
  225. <<search-aggregations-bucket-geodistance-aggregation,`geo_distance` aggregation>> instead.
  226. [role="exclude",id="search-facets-histogram-facet"]
  227. === Histogram Facet
  228. Facets have been removed. Use the
  229. <<search-aggregations-bucket-histogram-aggregation,`histogram` aggregation>> instead.
  230. [role="exclude",id="search-facets-date-histogram-facet"]
  231. === Date Histogram Facet
  232. Facets have been removed. Use the
  233. <<search-aggregations-bucket-datehistogram-aggregation,`date_histogram` aggregation>> instead.
  234. [role="exclude",id="search-facets-range-facet"]
  235. === Range Facet
  236. Facets have been removed. Use the
  237. <<search-aggregations-bucket-range-aggregation,`range` aggregation>> instead.
  238. [role="exclude",id="search-facets-terms-facet"]
  239. === Terms Facet
  240. Facets have been removed. Use the
  241. <<search-aggregations-bucket-terms-aggregation,`terms` aggregation>> instead.
  242. [role="exclude",id="search-facets-terms-statistical-facet"]
  243. === Terms Stats Facet
  244. Facets have been removed. Use the
  245. <<search-aggregations-bucket-terms-aggregation,`terms` aggregation>>
  246. with the <<search-aggregations-metrics-stats-aggregation,`stats` aggregation>>
  247. or the <<search-aggregations-metrics-extendedstats-aggregation,`extended_stats` aggregation>>
  248. instead.
  249. [role="exclude",id="search-facets-statistical-facet"]
  250. === Statistical Facet
  251. Facets have been removed. Use the
  252. <<search-aggregations-metrics-stats-aggregation,`stats` aggregation>>
  253. or the <<search-aggregations-metrics-extendedstats-aggregation,`extended_stats` aggregation>> instead.
  254. [role="exclude",id="search-facets-migrating-to-aggs"]
  255. === Migrating from facets to aggregations
  256. Facets have been removed. Use <<search-aggregations>> instead.
  257. // CACHES
  258. [role="exclude",id="shard-query-cache"]
  259. === Shard request cache
  260. The shard query cache has been renamed <<shard-request-cache>>.
  261. [role="exclude",id="filter-cache"]
  262. === Query cache
  263. The filter cache has been renamed <<query-cache>>.
  264. [role="exclude",id="query-dsl-filtered-query"]
  265. === Filtered query
  266. The `filtered` query is replaced by the <<query-dsl-bool-query,bool>> query. Instead of
  267. the following:
  268. [source,js]
  269. -------------------------
  270. ## INCORRECT - DEPRECATED SYNTAX, DO NOT USE
  271. GET _search
  272. {
  273. "query": {
  274. "filtered": {
  275. "query": {
  276. "match": {
  277. "text": "quick brown fox"
  278. }
  279. },
  280. "filter": {
  281. "term": {
  282. "status": "published"
  283. }
  284. }
  285. }
  286. }
  287. }
  288. -------------------------
  289. // NOTCONSOLE
  290. move the query and filter to the `must` and `filter` parameters in the `bool`
  291. query:
  292. [source,js]
  293. -------------------------
  294. GET _search
  295. {
  296. "query": {
  297. "bool": {
  298. "must": {
  299. "match": {
  300. "text": "quick brown fox"
  301. }
  302. },
  303. "filter": {
  304. "term": {
  305. "status": "published"
  306. }
  307. }
  308. }
  309. }
  310. }
  311. -------------------------
  312. // CONSOLE
  313. [role="exclude",id="query-dsl-or-query"]
  314. === Or query
  315. The `or` query is replaced in favour of the <<query-dsl-bool-query,bool>> query.
  316. [role="exclude",id="query-dsl-or-filter"]
  317. === Or filter
  318. The `or` filter is replaced in favour of the <<query-dsl-bool-query,bool>> query.
  319. [role="exclude",id="query-dsl-and-query"]
  320. === And query
  321. The `and` query is replaced in favour of the <<query-dsl-bool-query,bool>> query.
  322. [role="exclude",id="query-dsl-and-filter"]
  323. === And filter
  324. The `and` filter is replaced in favour of the <<query-dsl-bool-query,bool>> query.
  325. [role="exclude",id="query-dsl-limit-query"]
  326. === Limit query
  327. The `limit` query is replaced in favour of the <<search-request-body,terminate_after>>
  328. parameter of search requests.
  329. [role="exclude",id="query-dsl-limit-filter"]
  330. === Limit filter
  331. The `limit` filter is replaced in favour of the <<search-request-body,terminate_after>>
  332. parameter of search requests.
  333. [role="exclude",id="query-dsl-not-query"]
  334. === Not query
  335. The `not` query has been replaced by using a `mustNot` clause in a Boolean query.
  336. [role="exclude",id="mapping-nested-type"]
  337. === Nested type
  338. The docs for the `nested` field datatype have moved to <<nested>>.
  339. [role="exclude",id="indices-warmers"]
  340. === Warmers
  341. Warmers have been removed. There have been significant improvements to the
  342. index that make warmers not necessary anymore.
  343. [role="exclude",id="index-boost"]
  344. === Index time boosting
  345. The index time boost mapping has been replaced with query time boost (see <<mapping-boost>>).
  346. [role="exclude",id="modules-scripting-native"]
  347. === Native scripting
  348. Native scripts have been replaced with writing custom `ScriptEngine` backends (see <<modules-scripting-engine>>).
  349. [role="exclude",id="modules-advanced-scripting"]
  350. === Advanced scripting
  351. Using `_index` in scripts has been replaced with writing `ScriptEngine` backends (see <<modules-scripting-engine>>).
  352. [role="exclude",id="modules-scripting-painless-syntax"]
  353. === Painless Syntax
  354. See the
  355. {painless}/painless-lang-spec.html[Painless Language Specification]
  356. in the guide to the {painless}/index.html[Painless Scripting Language].
  357. [role="exclude",id="modules-scripting-painless-debugging"]
  358. === Painless Debugging
  359. See {painless}/painless-debugging.html[Painless Debugging] in the
  360. guide to the {painless}/index.html[Painless Scripting Language].
  361. [role="exclude",id="painless-api-reference"]
  362. === Painless API Reference
  363. See the {painless}/painless-api-reference.html[Painless API Reference] in
  364. the guide to the {painless}/index.html[Painless Scripting Language].
  365. [role="exclude", id="security-api-roles"]
  366. === Role management APIs
  367. You can use the following APIs to add, remove, and retrieve roles in the native realm:
  368. * <<security-api-put-role,Create role>>, <<security-api-delete-role,Delete role>>
  369. * <<security-api-clear-role-cache,Clear roles cache>>
  370. * <<security-api-get-role,Get roles>>
  371. [role="exclude",id="security-api-tokens"]
  372. === Token management APIs
  373. You can use the following APIs to create and invalidate bearer tokens for access
  374. without requiring basic authentication:
  375. * <<security-api-get-token,Get token>>, <<security-api-invalidate-token,Invalidate token>>
  376. [role="exclude",id="security-api-users"]
  377. === User Management APIs
  378. You can use the following APIs to create, read, update, and delete users from the
  379. native realm:
  380. * <<security-api-put-user,Create users>>, <<security-api-delete-user,Delete users>>
  381. * <<security-api-enable-user,Enable users>>, <<security-api-disable-user,Disable users>>
  382. * <<security-api-change-password,Change passwords>>
  383. * <<security-api-get-user,Get users>>
  384. [role="exclude",id="security-api-role-mapping"]
  385. === Role mapping APIs
  386. You can use the following APIs to add, remove, and retrieve role mappings:
  387. * <<security-api-put-role-mapping,Add role mappings>>, <<security-api-delete-role-mapping,Delete role mappings>>
  388. * <<security-api-get-role-mapping,Get role mappings>>
  389. [role="exclude",id="security-api-privileges"]
  390. === Privilege APIs
  391. See <<security-api-has-privileges>>.
  392. [role="exclude",id="xpack-commands"]
  393. === X-Pack commands
  394. See <<commands>>.
  395. [role="exclude",id="ml-api-definitions"]
  396. === Machine learning API definitions
  397. See <<api-definitions>>.
  398. [role="exclude",id="analysis-standard-tokenfilter"]
  399. === Standard filter removed
  400. The standard token filter has been removed.
  401. [role="exclude",id="modules-discovery-azure-classic"]
  402. See <<azure-classic-hosts-provider>>.
  403. [role="exclude",id="modules-discovery-ec2"]
  404. See <<ec2-hosts-provider>>.
  405. [role="exclude",id="modules-discovery-gce"]
  406. See <<gce-hosts-provider>>.
  407. [role="exclude",id="modules-discovery-zen"]
  408. Zen discovery is replaced by the <<modules-discovery,discovery and cluster
  409. formation module>>.
  410. [role="exclude",id="settings-xpack"]
  411. === {xpack} settings in {es}
  412. include::{asciidoc-dir}/../../shared/settings.asciidoc[]