diff --git a/docs/reference/api-conventions.asciidoc b/docs/reference/api-conventions.asciidoc index 0e639ff071518..9e377fa354c44 100644 --- a/docs/reference/api-conventions.asciidoc +++ b/docs/reference/api-conventions.asciidoc @@ -19,17 +19,17 @@ Most APIs that accept a ``, ``, or `` request path parameter also support _multi-target syntax_. In multi-target syntax, you can use a comma-separated list to run a request on -multiple resources, such as data streams, indices, or index aliases: +multiple resources, such as data streams, indices, or aliases: `test1,test2,test3`. You can also use {wikipedia}/Glob_(programming)[glob-like] wildcard (`*`) expressions to target resources that match a pattern: `test*` or `*test` or `te*t` or `*test*`. You can exclude targets using the `-` character: `test*,-test3`. -IMPORTANT: Index aliases are resolved after wildcard expressions. This can -result in a request that targets an excluded alias. For example, if `test3` is -an index alias, the pattern `test*,-test3` still targets the indices for -`test3`. To avoid this, exclude the concrete indices for the alias instead. +IMPORTANT: Aliases are resolved after wildcard expressions. This can result in a +request that targets an excluded alias. For example, if `test3` is an index +alias, the pattern `test*,-test3` still targets the indices for `test3`. To +avoid this, exclude the concrete indices for the alias instead. Multi-target APIs that can target indices support the following query string parameters: diff --git a/docs/reference/cat/count.asciidoc b/docs/reference/cat/count.asciidoc index 39f3ab1bdaf66..ce206be308308 100644 --- a/docs/reference/cat/count.asciidoc +++ b/docs/reference/cat/count.asciidoc @@ -22,19 +22,16 @@ which have not yet been removed by the merge process. ==== {api-prereq-title} * If the {es} {security-features} are enabled, you must have the `read` -<> for any data stream, index, or index -alias you retrieve. +<> for any data stream, index, or alias +you retrieve. [[cat-count-api-path-params]] ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[cat-count-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/cat/indices.asciidoc b/docs/reference/cat/indices.asciidoc index 9e82db03c6792..97396bc6c591c 100644 --- a/docs/reference/cat/indices.asciidoc +++ b/docs/reference/cat/indices.asciidoc @@ -21,7 +21,7 @@ indices for data streams. * If the {es} {security-features} are enabled, you must have the `monitor` or `manage` <> to use this API. You must also have the `monitor` or `manage` <> -for any data stream, index, or index alias you retrieve. +for any data stream, index, or alias you retrieve. [[cat-indices-api-desc]] ==== {api-description-title} @@ -48,12 +48,9 @@ To get an accurate count of {es} documents, use the <> or ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[cat-indices-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/cat/recovery.asciidoc b/docs/reference/cat/recovery.asciidoc index 6c91b313cac6b..3962aeefe8581 100644 --- a/docs/reference/cat/recovery.asciidoc +++ b/docs/reference/cat/recovery.asciidoc @@ -24,7 +24,7 @@ indices. * If the {es} {security-features} are enabled, you must have the `monitor` or `manage` <> to use this API. You must also have the `monitor` or `manage` <> -for any data stream, index, or index alias you retrieve. +for any data stream, index, or alias you retrieve. [[cat-recovery-api-desc]] ==== {api-description-title} @@ -40,13 +40,9 @@ include::{es-repo-dir}/indices/recovery.asciidoc[tag=shard-recovery-desc] ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. - +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[cat-recovery-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/cat/segments.asciidoc b/docs/reference/cat/segments.asciidoc index 7bc38e0077731..d9949068d75ad 100644 --- a/docs/reference/cat/segments.asciidoc +++ b/docs/reference/cat/segments.asciidoc @@ -24,18 +24,15 @@ indices. * If the {es} {security-features} are enabled, you must have the `monitor` or `manage` <> to use this API. You must also have the `monitor` or `manage` <> -for any data stream, index, or index alias you retrieve. +for any data stream, index, or alias you retrieve. [[cat-segments-path-params]] ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[cat-segments-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/cat/shards.asciidoc b/docs/reference/cat/shards.asciidoc index 0aaa1c0c7d0cb..b0ec8f0674fbb 100644 --- a/docs/reference/cat/shards.asciidoc +++ b/docs/reference/cat/shards.asciidoc @@ -25,18 +25,15 @@ indices. * If the {es} {security-features} are enabled, you must have the `monitor` or `manage` <> to use this API. You must also have the `monitor` or `manage` <> -for any data stream, index, or index alias you retrieve. +for any data stream, index, or alias you retrieve. [[cat-shards-path-params]] ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[cat-shards-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/cluster/state.asciidoc b/docs/reference/cluster/state.asciidoc index 81e0ce9bc7a19..9dfd71b263f2b 100644 --- a/docs/reference/cluster/state.asciidoc +++ b/docs/reference/cluster/state.asciidoc @@ -93,13 +93,9 @@ you can request only the part of the cluster state that you need: -- ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. - +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[cluster-state-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/data-streams/change-mappings-and-settings.asciidoc b/docs/reference/data-streams/change-mappings-and-settings.asciidoc index 0136b9d224be8..7f6f8cc9b1342 100644 --- a/docs/reference/data-streams/change-mappings-and-settings.asciidoc +++ b/docs/reference/data-streams/change-mappings-and-settings.asciidoc @@ -386,10 +386,10 @@ Follow these steps: stream will contain data from your existing stream. + You can use the resolve index API to check if the name or pattern matches any -existing indices, index aliases, or data streams. If so, you should consider -using another name or pattern. +existing indices, aliases, or data streams. If so, you should consider using +another name or pattern. -- -The following resolve index API request checks for any existing indices, index +The following resolve index API request checks for any existing indices, aliases, or data streams that start with `new-data-stream`. If not, the `new-data-stream*` index pattern can be used to create a new data stream. diff --git a/docs/reference/data-streams/use-a-data-stream.asciidoc b/docs/reference/data-streams/use-a-data-stream.asciidoc index 47447f9bb906f..b6fbd5ff1d99f 100644 --- a/docs/reference/data-streams/use-a-data-stream.asciidoc +++ b/docs/reference/data-streams/use-a-data-stream.asciidoc @@ -154,8 +154,8 @@ POST /my-data-stream/_open/ [[reindex-with-a-data-stream]] === Reindex with a data stream -Use the <> to copy documents from an -existing index, index alias, or data stream to a data stream. Because data streams are +Use the <> to copy documents from an existing index, +alias, or data stream to a data stream. Because data streams are <>, a reindex into a data stream must use an `op_type` of `create`. A reindex cannot update existing documents in a data stream. diff --git a/docs/reference/docs/delete-by-query.asciidoc b/docs/reference/docs/delete-by-query.asciidoc index 67fdc7f5f85ed..80de31090bb68 100644 --- a/docs/reference/docs/delete-by-query.asciidoc +++ b/docs/reference/docs/delete-by-query.asciidoc @@ -54,7 +54,7 @@ POST /my-index-000001/_delete_by_query * If the {es} {security-features} are enabled, you must have the following <> for the target data stream, index, -or index alias: +or alias: ** `read` ** `delete` or `write` @@ -168,12 +168,9 @@ documents being reindexed and cluster resources. ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases to search. -Wildcard (`*`) expressions are supported. -+ -To search all data streams or indices in a cluster, omit this parameter or use -`_all` or `*`. +(Optional, string) Comma-separated list of data streams, indices, and aliases to +search. Supports wildcards (`*`). To search all data streams or indices, omit +this parameter or use `* or `_all`. [[docs-delete-by-query-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/docs/reindex.asciidoc b/docs/reference/docs/reindex.asciidoc index 64be39b3e77af..c524a0fcd57e8 100644 --- a/docs/reference/docs/reindex.asciidoc +++ b/docs/reference/docs/reindex.asciidoc @@ -75,18 +75,18 @@ POST _reindex security privileges: ** The `read` <> for the source data -stream, index, or index alias. +stream, index, or alias. ** The `write` index privilege for the destination data stream, index, or index alias. ** To automatically create a data stream or index with an reindex API request, you must have the `auto_configure`, `create_index`, or `manage` index -privilege for the destination data stream, index, or index alias. +privilege for the destination data stream, index, or alias. ** If reindexing from a remote cluster, the `source.remote.user` must have the `monitor` <> and the `read` index -privilege for the source data stream, index, or index alias. +privilege for the source data stream, index, or alias. * If reindexing from a remote cluster, you must explicitly allow the remote host in the `reindex.remote.whitelist` setting of `elasticsearch.yml`. See @@ -507,8 +507,8 @@ Defaults to `abort`. `source`:: `index`::: -(Required, string) The name of the data stream, index, or index alias you are copying _from_. -Also accepts a comma-separated list to reindex from multiple sources. +(Required, string) The name of the data stream, index, or alias you are copying +_from_. Also accepts a comma-separated list to reindex from multiple sources. `max_docs`::: (Optional, integer) The maximum number of documents to reindex. If <> is equal to diff --git a/docs/reference/docs/update-by-query.asciidoc b/docs/reference/docs/update-by-query.asciidoc index de00d8e3cb188..fa68f219ff075 100644 --- a/docs/reference/docs/update-by-query.asciidoc +++ b/docs/reference/docs/update-by-query.asciidoc @@ -51,7 +51,7 @@ POST my-index-000001/_update_by_query?conflicts=proceed * If the {es} {security-features} are enabled, you must have the following <> for the target data stream, index, -or index alias: +or alias: ** `read` ** `index` or `write` @@ -162,12 +162,9 @@ documents being reindexed and cluster resources. ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases to search. -Wildcard (`*`) expressions are supported. -+ -To search all data streams or indices in a cluster, omit this parameter or use -`_all` or `*`. +(Optional, string) Comma-separated list of data streams, indices, and aliases to +search. Supports wildcards (`*`). To search all data streams or indices, omit +this parameter or use `*` or `_all`. [[docs-update-by-query-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/eql/eql-search-api.asciidoc b/docs/reference/eql/eql-search-api.asciidoc index 8b223ff7bdef1..3e77158ec8d0b 100644 --- a/docs/reference/eql/eql-search-api.asciidoc +++ b/docs/reference/eql/eql-search-api.asciidoc @@ -44,7 +44,7 @@ GET /my-data-stream/_eql/search * If the {es} {security-features} are enabled, you must have the `read` <> for the target data stream, index, -or index alias. +or alias. * See <>. diff --git a/docs/reference/ilm/apis/explain.asciidoc b/docs/reference/ilm/apis/explain.asciidoc index 003d10af6c0c7..6185ba0849bfb 100644 --- a/docs/reference/ilm/apis/explain.asciidoc +++ b/docs/reference/ilm/apis/explain.asciidoc @@ -34,11 +34,9 @@ about any failures. ==== {api-path-parms-title} ``:: -(Required, string) -Comma-separated list of data streams, indices, and index aliases to target. -Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, use `_all` or `*`. +(Required, string) Comma-separated list of data streams, indices, and aliases to +target. Supports wildcards (`*`).To target all data streams and indices, use `*` +or `_all`. [[ilm-explain-lifecycle-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/ilm/apis/remove-policy-from-index.asciidoc b/docs/reference/ilm/apis/remove-policy-from-index.asciidoc index 1826dc1e6f50d..c682038fb264e 100644 --- a/docs/reference/ilm/apis/remove-policy-from-index.asciidoc +++ b/docs/reference/ilm/apis/remove-policy-from-index.asciidoc @@ -34,11 +34,9 @@ the stream's backing indices and stops managing the indices. ==== {api-path-parms-title} ``:: -(Required, string) -Comma-separated list of data streams, indices, and index aliases to target. -Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, use `_all` or `*`. +(Required, string) Comma-separated list of data streams, indices, and aliases to +target. Supports wildcards (`*`). To target all data streams and indices, use +`*` or `_all`. [[ilm-remove-policy-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/indices/apis/reload-analyzers.asciidoc b/docs/reference/indices/apis/reload-analyzers.asciidoc index 5e56953a41c20..8daa393c22c3b 100644 --- a/docs/reference/indices/apis/reload-analyzers.asciidoc +++ b/docs/reference/indices/apis/reload-analyzers.asciidoc @@ -35,7 +35,7 @@ IMPORTANT: After reloading the search analyzers you should clear the request * If the {es} {security-features} are enabled, you must have the `manage` <> for the target data stream, index, -or index alias. +or alias. [discrete] [[indices-reload-analyzers-api-desc]] @@ -78,12 +78,9 @@ in the future. === {api-path-parms-title} ``:: -(Required, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, use `_all` or `*`. - +(Required, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, use `*` or `_all`. [discrete] [[indices-reload-analyzers-api-query-params]] diff --git a/docs/reference/indices/clearcache.asciidoc b/docs/reference/indices/clearcache.asciidoc index 8011c2cd3aa89..10b590fce0976 100644 --- a/docs/reference/indices/clearcache.asciidoc +++ b/docs/reference/indices/clearcache.asciidoc @@ -26,19 +26,15 @@ POST /my-index-000001/_cache/clear * If the {es} {security-features} are enabled, you must have the `manage` <> for the target data stream, index, -or index alias. +or alias. [[clear-cache-api-path-params]] ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. - +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[clear-cache-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/indices/flush.asciidoc b/docs/reference/indices/flush.asciidoc index a5b20aa251a3c..180f63f6adaab 100644 --- a/docs/reference/indices/flush.asciidoc +++ b/docs/reference/indices/flush.asciidoc @@ -29,7 +29,7 @@ POST /my-index-000001/_flush * If the {es} {security-features} are enabled, you must have the `maintenance` or `manage` <> for the target data -stream, index, or index alias. +stream, index, or alias. [[flush-api-desc]] ==== {api-description-title} @@ -60,13 +60,9 @@ flush API was called. ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases to flush. -Wildcard expressions (`*`) are supported. -+ -To flush all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. - +(Optional, string) Comma-separated list of data streams, indices, and aliases to +flush. Supports wildcards (`*`). To flush all data streams and indices, omit +this parameter or use `*` or `_all`. [[flush-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/indices/forcemerge.asciidoc b/docs/reference/indices/forcemerge.asciidoc index 743546b14c51a..8a2dd1a464190 100644 --- a/docs/reference/indices/forcemerge.asciidoc +++ b/docs/reference/indices/forcemerge.asciidoc @@ -27,7 +27,7 @@ POST /my-index-000001/_forcemerge * If the {es} {security-features} are enabled, you must have the `maintenance` or `manage` <> for the target data -stream, index, or index alias. +stream, index, or alias. [[forcemerge-api-desc]] ==== {api-description-title} @@ -65,7 +65,7 @@ You can force merge multiple indices with a single request by targeting: * One or more data streams that contain multiple backing indices * Multiple indices -* One or more index aliases that point to multiple indices +* One or more aliases * All data streams and indices in a cluster Each targeted shard is force-merged separately using <`:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. - +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[forcemerge-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/indices/get-field-mapping.asciidoc b/docs/reference/indices/get-field-mapping.asciidoc index 8448370cf53fa..c4fcb33de921f 100644 --- a/docs/reference/indices/get-field-mapping.asciidoc +++ b/docs/reference/indices/get-field-mapping.asciidoc @@ -29,17 +29,15 @@ GET /my-index-000001/_mapping/field/user * If the {es} {security-features} are enabled, you must have the `view_index_metadata` or `manage` <> -for the target data stream, index, or index alias. +for the target data stream, index, or alias. [[get-field-mapping-api-path-params]] ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard (`*`) expressions are supported. -+ -To target all indices in a cluster, omit this parameter or use `_all` or `*`. +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. ``:: (Optional, string) Comma-separated list or wildcard expression of fields used to diff --git a/docs/reference/indices/get-index.asciidoc b/docs/reference/indices/get-index.asciidoc index ce98f9db91eca..327b677affd2a 100644 --- a/docs/reference/indices/get-index.asciidoc +++ b/docs/reference/indices/get-index.asciidoc @@ -28,19 +28,15 @@ through the parameter include_type_name. For more details, please see <> -for the target data stream, index, or index alias. +for the target data stream, index, or alias. [[get-index-api-path-params]] ==== {api-path-parms-title} ``:: -(Required, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. - +(Required, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[get-index-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/indices/get-mapping.asciidoc b/docs/reference/indices/get-mapping.asciidoc index 44f82f7761318..6049267dbc9d7 100644 --- a/docs/reference/indices/get-mapping.asciidoc +++ b/docs/reference/indices/get-mapping.asciidoc @@ -30,19 +30,15 @@ through the parameter `include_type_name`. For more details, please see <> -for the target data stream, index, or index alias. +for the target data stream, index, or alias. [[get-mapping-api-path-params]] ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. - +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[get-mapping-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/indices/get-settings.asciidoc b/docs/reference/indices/get-settings.asciidoc index 04c11a82b5a15..3512e9f8eb922 100644 --- a/docs/reference/indices/get-settings.asciidoc +++ b/docs/reference/indices/get-settings.asciidoc @@ -26,18 +26,15 @@ GET /my-index-000001/_settings * If the {es} {security-features} are enabled, you must have the `view_index_metadata`, `monitor`, or `manage` <> for the target data stream, index, or index alias. +privilege>> for the target data stream, index, or alias. [[get-index-settings-api-path-params]] ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. ``:: (Optional, string) Comma-separated list or wildcard expression of setting names diff --git a/docs/reference/indices/index-mgmt.asciidoc b/docs/reference/indices/index-mgmt.asciidoc index 1b5cc2638980d..0cda6dbe7ab09 100644 --- a/docs/reference/indices/index-mgmt.asciidoc +++ b/docs/reference/indices/index-mgmt.asciidoc @@ -125,14 +125,14 @@ with that index pattern. . Leave *Data Stream*, *Priority*, *Version*, and *_meta field* blank or as-is. -*Step 2. Add settings, mappings, and index aliases* +*Step 2. Add settings, mappings, and aliases* . Add <> to your index template. + Component templates are pre-configured sets of mappings, index settings, and -index aliases you can reuse across multiple index templates. Badges indicate +aliases you can reuse across multiple index templates. Badges indicate whether a component template contains mappings (*M*), index settings (*S*), -index aliases (*A*), or a combination of the three. +aliases (*A*), or a combination of the three. + Component templates are optional. For this tutorial, do not add any component templates. @@ -171,7 +171,7 @@ You can create additional mapping configurations in the *Dynamic templates* and *Advanced options* tabs. For this tutorial, do not create any additional mappings. -. Define an index alias named `my-index`: +. Define an alias named `my-index`: + [source,js] ---- diff --git a/docs/reference/indices/open-close.asciidoc b/docs/reference/indices/open-close.asciidoc index 24669d5b871dd..bb0b305eb7ce8 100644 --- a/docs/reference/indices/open-close.asciidoc +++ b/docs/reference/indices/open-close.asciidoc @@ -25,7 +25,7 @@ POST /my-index-000001/_open * If the {es} {security-features} are enabled, you must have the `manage` <> for the target data stream, index, -or index alias. +or alias. [[open-index-api-desc]] ==== {api-description-title} @@ -85,17 +85,14 @@ index creation applies to the `_open` and `_close` index actions as well. ``:: (Optional, string) -Comma-separated list or wildcard (`*`) expression of data streams, indices, and -index aliases used to limit the request. -+ -To target all data streams and indices, use `_all` or `*`. +Comma-separated list of data streams, indices, and aliases used to limit +the request. Supports wildcards (`*`). + To disallow use of `_all` or wildcard expressions, change the `action.destructive_requires_name` cluster setting to `true`. You can update this setting in the `elasticsearch.yml` file or using the <> API. - [[open-index-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/indices/put-mapping.asciidoc b/docs/reference/indices/put-mapping.asciidoc index 3579b535dee16..f5c7764cb4b2f 100644 --- a/docs/reference/indices/put-mapping.asciidoc +++ b/docs/reference/indices/put-mapping.asciidoc @@ -38,7 +38,7 @@ please see <>. * If the {es} {security-features} are enabled, you must have the `manage` <> for the target data stream, index, -or index alias. +or alias. + deprecated:[7.9] If the request targets an index or index alias, you can also update its mapping with the `create`, `create_doc`, `index`, or `write` index @@ -49,13 +49,9 @@ privilege. ==== {api-path-parms-title} ``:: -(Required, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. - +(Required, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[put-mapping-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/indices/recovery.asciidoc b/docs/reference/indices/recovery.asciidoc index 5c231e345eee2..270d77c5b3133 100644 --- a/docs/reference/indices/recovery.asciidoc +++ b/docs/reference/indices/recovery.asciidoc @@ -28,7 +28,7 @@ GET /my-index-000001/_recovery * If the {es} {security-features} are enabled, you must have the `monitor` or `manage` <> for the target data stream, -index, or index alias. +index, or alias. [[index-recovery-api-desc]] ==== {api-description-title} @@ -56,13 +56,9 @@ Recovery automatically occurs during the following processes: ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. - +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[index-recovery-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/indices/refresh.asciidoc b/docs/reference/indices/refresh.asciidoc index da10d4d6ce36a..1d6a56ce2a406 100644 --- a/docs/reference/indices/refresh.asciidoc +++ b/docs/reference/indices/refresh.asciidoc @@ -30,7 +30,7 @@ POST /my-index-000001/_refresh * If the {es} {security-features} are enabled, you must have the `maintenance` or `manage` <> for the target data -stream, index, or index alias. +stream, index, or alias. [[refresh-api-desc]] ==== {api-description-title} @@ -72,12 +72,11 @@ before running the search. [[refresh-api-path-params]] ==== {api-path-parms-title} -include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=index] -+ -To refresh all indices in the cluster, -omit this parameter -or use a value of `_all` or `*`. - +``:: +(Optional, string) +Comma-separated list of data streams, indices, and aliases used to limit +the request. Supports wildcards (`*`). To target all data streams and indices, +omit this parameter or use `*` or `_all`. [[refresh-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/indices/resolve.asciidoc b/docs/reference/indices/resolve.asciidoc index 0b62cb154382d..0ffffae769c06 100644 --- a/docs/reference/indices/resolve.asciidoc +++ b/docs/reference/indices/resolve.asciidoc @@ -4,9 +4,8 @@ Resolve index ++++ -Resolves the specified name(s) and/or index patterns for indices, index -aliases, and data streams. Multiple patterns and remote clusters are -supported. +Resolves the specified name(s) and/or index patterns for indices, aliases, and +data streams. Multiple patterns and remote clusters are supported. //// [source,console] @@ -70,7 +69,7 @@ for the target data stream, index, or index alias. + -- (Required, string) Comma-separated name(s) or index pattern(s) of the -indices, index aliases, and data streams to resolve. Resources on +indices, aliases, and data streams to resolve. Resources on <> can be specified using the `:` syntax. -- diff --git a/docs/reference/indices/segments.asciidoc b/docs/reference/indices/segments.asciidoc index bcef2ab178593..f45ac13e1a069 100644 --- a/docs/reference/indices/segments.asciidoc +++ b/docs/reference/indices/segments.asciidoc @@ -27,19 +27,15 @@ GET /my-index-000001/_segments * If the {es} {security-features} are enabled, you must have the `monitor` or `manage` <> for the target data stream, -index, or index alias. +index, or alias. [[index-segments-api-path-params]] ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. - +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[index-segments-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/indices/shard-stores.asciidoc b/docs/reference/indices/shard-stores.asciidoc index fff82789a03cc..f014d686b3cbd 100644 --- a/docs/reference/indices/shard-stores.asciidoc +++ b/docs/reference/indices/shard-stores.asciidoc @@ -28,7 +28,7 @@ GET /my-index-000001/_shard_stores * If the {es} {security-features} are enabled, you must have the `monitor` or `manage` <> for the target data stream, -index, or index alias. +index, or alias. [[index-shard-stores-api-desc]] ==== {api-description-title} @@ -51,13 +51,9 @@ or have one or more unassigned replica shards. ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. - +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[index-shard-stores-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/indices/stats.asciidoc b/docs/reference/indices/stats.asciidoc index 302461f5ce1e7..41b213b7a5b22 100644 --- a/docs/reference/indices/stats.asciidoc +++ b/docs/reference/indices/stats.asciidoc @@ -28,7 +28,7 @@ GET /my-index-000001/_stats * If the {es} {security-features} are enabled, you must have the `monitor` or `manage` <> for the target data stream, -index, or index alias. +index, or alias. [[index-stats-api-desc]] ==== {api-description-title} @@ -60,12 +60,9 @@ to which the shard contributed. ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=index-metric] diff --git a/docs/reference/indices/update-settings.asciidoc b/docs/reference/indices/update-settings.asciidoc index 52672067fd70b..c1793c1198a03 100644 --- a/docs/reference/indices/update-settings.asciidoc +++ b/docs/reference/indices/update-settings.asciidoc @@ -31,19 +31,15 @@ PUT /my-index-000001/_settings * If the {es} {security-features} are enabled, you must have the `manage` <> for the target data stream, index, -or index alias. +or alias. [[update-index-settings-api-path-params]] ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. - +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[update-index-settings-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/search/count.asciidoc b/docs/reference/search/count.asciidoc index 7210ac809421d..dd96702a6390c 100644 --- a/docs/reference/search/count.asciidoc +++ b/docs/reference/search/count.asciidoc @@ -26,7 +26,7 @@ the <> works. * If the {es} {security-features} are enabled, you must have the `read` <> for the target data stream, index, -or index alias. +or alias. [[search-count-api-desc]] @@ -49,13 +49,9 @@ scalability of count. ==== {api-path-parms-title} ``:: - -(Optional, string) -Comma-separated list of data streams, indices, and index aliases to search. -Wildcard (`*`) expressions are supported. -+ -To search all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. +(Optional, string) Comma-separated list of data streams, indices, and aliases to +search. Supports wildcards (`*`). To search all data streams and indices, omit +this parameter or use `*` or `_all`. [[search-count-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/search/field-caps.asciidoc b/docs/reference/search/field-caps.asciidoc index 3238421166252..80ee6bfc24788 100644 --- a/docs/reference/search/field-caps.asciidoc +++ b/docs/reference/search/field-caps.asciidoc @@ -31,7 +31,7 @@ GET /_field_caps?fields=rating * If the {es} {security-features} are enabled, you must have the `view_index_metadata`, `read`, or `manage` <> for the target data stream, index, or index alias. +privilege>> for the target data stream, index, or alias. [[search-field-caps-api-desc]] ==== {api-description-title} @@ -49,13 +49,9 @@ other field. For example, a runtime field with a type of ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard expressions (`*`) are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. - +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[search-field-caps-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/search/multi-search.asciidoc b/docs/reference/search/multi-search.asciidoc index 9f6e20680487e..b69f0fe4123bc 100644 --- a/docs/reference/search/multi-search.asciidoc +++ b/docs/reference/search/multi-search.asciidoc @@ -26,7 +26,7 @@ GET my-index-000001/_msearch * If the {es} {security-features} are enabled, you must have the `read` <> for the target data stream, index, -or index alias. For cross-cluster search, see <>. +or alias. For cross-cluster search, see <>. [[search-multi-search-api-desc]] ==== {api-description-title} @@ -61,7 +61,7 @@ this endpoint the `Content-Type` header should be set to `application/x-ndjson`. ``:: (Optional, string) -Comma-separated list of data streams, indices, and index aliases to search. +Comma-separated list of data streams, indices, and aliases to search. + This list acts as a fallback if a search in the request body does not specify an `index` target. @@ -183,7 +183,7 @@ line. If `true`, the request does *not* return an error if a wildcard expression or `_all` value retrieves only missing or closed indices. + -This parameter also applies to <> that point to a missing +This parameter also applies to <> that point to a missing or closed index. include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=expand-wildcards] @@ -196,8 +196,8 @@ included in the response. Defaults to `false`. `index`:: (Optional, string or array of strings) -Data streams, indices, and index aliases to search. Wildcard (`*`) expressions -are supported. You can specify multiple targets as an array. +Data streams, indices, and aliases to search. Supports wildcards (`*`). Specify +multiple targets as an array. + If this parameter is not specified, the `` request path parameter is used as a fallback. @@ -274,10 +274,10 @@ Number of hits to return. Defaults to `10`. [[search-multi-search-api-example]] ==== {api-examples-title} -The header part includes which data streams, indices, and index aliases to -search. The header also indicates the `search_type`, -`preference`, and `routing`. The body includes the typical search body request -(including the `query`, `aggregations`, `from`, `size`, and so on). +The header includes the data streams, indices, and aliases to search. The header +also indicates the `search_type`, `preference`, and `routing`. The body includes +the typical search body request (including the `query`, `aggregations`, `from`, +`size`, and so on). [source,js] -------------------------------------------------- @@ -305,7 +305,7 @@ Note, the above includes an example of an empty header (can also be just without any content) which is supported as well. -The endpoint also allows you to search against data streams, indices, and index +The endpoint also allows you to search against data streams, indices, and aliases in the request path. In this case, it will be used as the default target unless explicitly specified in the header's `index` parameter. For example: diff --git a/docs/reference/search/point-in-time-api.asciidoc b/docs/reference/search/point-in-time-api.asciidoc index 5091d650594a0..048a36d1803b7 100644 --- a/docs/reference/search/point-in-time-api.asciidoc +++ b/docs/reference/search/point-in-time-api.asciidoc @@ -17,10 +17,10 @@ changes happening between searches are only visible to the more recent point in * If the {es} {security-features} are enabled, you must have the `read` <> for the target data stream, index, -or index alias. +or alias. + -To search a <> for an index alias, you -must have the `read` index privilege for the alias's concrete indices. +To search a <> for an alias, you +must have the `read` index privilege for the alias's data streams or indices. [[point-in-time-api-example]] ==== {api-examples-title} diff --git a/docs/reference/search/rank-eval.asciidoc b/docs/reference/search/rank-eval.asciidoc index af9020d9bcd8a..b7a41d3f376a5 100644 --- a/docs/reference/search/rank-eval.asciidoc +++ b/docs/reference/search/rank-eval.asciidoc @@ -19,7 +19,7 @@ typical search queries. * If the {es} {security-features} are enabled, you must have the `read` <> for the target data stream, index, -or index alias. +or alias. [[search-rank-eval-api-desc]] ==== {api-description-title} @@ -71,12 +71,9 @@ generation in your application. ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases used to limit -the request. Wildcard (`*`) expressions are supported. -+ -To target all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. +(Optional, string) Comma-separated list of data streams, indices, and aliases +used to limit the request. Supports wildcards (`*`). To target all data streams +and indices, omit this parameter or use `*` or `_all`. [[search-rank-eval-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/search/scroll-api.asciidoc b/docs/reference/search/scroll-api.asciidoc index cbb846bef6d1e..e3b4123ddff68 100644 --- a/docs/reference/search/scroll-api.asciidoc +++ b/docs/reference/search/scroll-api.asciidoc @@ -53,7 +53,7 @@ deprecated:[7.0.0] * If the {es} {security-features} are enabled, you must have the `read` <> for the target data stream, index, -or index alias. +or alias. [[scroll-api-desc]] ==== {api-description-title} diff --git a/docs/reference/search/search-shards.asciidoc b/docs/reference/search/search-shards.asciidoc index ae78dd403d370..87a265bf5c8e3 100644 --- a/docs/reference/search/search-shards.asciidoc +++ b/docs/reference/search/search-shards.asciidoc @@ -23,7 +23,7 @@ GET /my-index-000001/_search_shards * If the {es} {security-features} are enabled, you must have the `view_index_metadata` or `manage` <> -for the target data stream, index, or index alias. +for the target data stream, index, or alias. [[search-shards-api-desc]] ==== {api-description-title} @@ -38,13 +38,9 @@ are used, the filter is returned as part of the `indices` section. ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases to search. -Wildcard (`*`) expressions are supported. -+ -To search all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. - +(Optional, string) Comma-separated list of data streams, indices, and aliases to +search. Supports wildcards (`*`). To search all data streams and indices, omit +this parameter or use `*` or `_all`. [[search-shards-api-query-params]] ==== {api-query-parms-title} diff --git a/docs/reference/search/search-template.asciidoc b/docs/reference/search/search-template.asciidoc index 400f5f0d682e2..cdc0e37e18cf8 100644 --- a/docs/reference/search/search-template.asciidoc +++ b/docs/reference/search/search-template.asciidoc @@ -33,7 +33,7 @@ GET _search/template * If the {es} {security-features} are enabled, you must have the `read` <> for the target data stream, index, -or index alias. For cross-cluster search, see <>. +or alias. For cross-cluster search, see <>. [[search-template-api-desc]] ==== {api-description-title} @@ -671,7 +671,7 @@ Allows to execute several search template requests. * If the {es} {security-features} are enabled, you must have the `read` <> for the target data stream, index, -or index alias. For cross-cluster search, see <>. +or alias. For cross-cluster search, see <>. [[multi-search-template-api-desc]] ==== {api-description-title} diff --git a/docs/reference/search/search-your-data/search-multiple-indices.asciidoc b/docs/reference/search/search-your-data/search-multiple-indices.asciidoc index 473028b0decd0..c257de0af96e8 100644 --- a/docs/reference/search/search-your-data/search-multiple-indices.asciidoc +++ b/docs/reference/search/search-your-data/search-multiple-indices.asciidoc @@ -98,7 +98,7 @@ GET /_search -------------------------------------------------- // TEST[s/^/PUT my-index-000001\nPUT my-index-000002\n/] -Index aliases and index patterns can also be used: +Aliases and index patterns can also be used: [source,console] -------------------------------------------------- diff --git a/docs/reference/search/search.asciidoc b/docs/reference/search/search.asciidoc index 73b755f7e9160..3e6290301f804 100644 --- a/docs/reference/search/search.asciidoc +++ b/docs/reference/search/search.asciidoc @@ -28,10 +28,10 @@ GET /my-index-000001/_search * If the {es} {security-features} are enabled, you must have the `read` <> for the target data stream, index, -or index alias. For cross-cluster search, see <>. +or alias. For cross-cluster search, see <>. + -To search a <> for an index alias, you -must have the `read` index privilege for the alias's concrete indices. +To search a <> for an alias, you +must have the `read` index privilege for the alias's data streams or indices. [[search-search-api-desc]] ==== {api-description-title} @@ -44,12 +44,9 @@ query string parameter>> or <>. ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases to search. -Wildcard (`*`) expressions are supported. -+ -To search all data streams and indices in a cluster, omit this parameter or use -`_all` or `*`. +(Optional, string) Comma-separated list of data streams, indices, and aliases to +search. Supports wildcards (`*`). To search all data streams and indices, omit +this parameter or use `*` or `_all`. [role="child_attributes"] [[search-search-api-query-params]] diff --git a/docs/reference/search/terms-enum.asciidoc b/docs/reference/search/terms-enum.asciidoc index 30cf3ae065834..4fc997ecdbdd1 100644 --- a/docs/reference/search/terms-enum.asciidoc +++ b/docs/reference/search/terms-enum.asciidoc @@ -55,12 +55,9 @@ string. It is designed for low-latency look-ups used in auto-complete scenarios. ==== {api-path-parms-title} ``:: -(Mandatory, string) -Comma-separated list of data streams, indices, and index aliases to search. -Wildcard (`*`) expressions are supported. -+ -To search all data streams or indices in a cluster, omit this parameter or use -`_all` or `*`. +(Required, string) Comma-separated list of data streams, indices, and aliases +to search. Supports wildcards (`*`). To search all data streams or indices, omit +this parameter or use `*` or `_all`. [[search-terms-enum-api-request-body]] ==== {api-request-body-title} diff --git a/docs/reference/search/validate.asciidoc b/docs/reference/search/validate.asciidoc index 5dde3bc6a956e..528e24151c47c 100644 --- a/docs/reference/search/validate.asciidoc +++ b/docs/reference/search/validate.asciidoc @@ -23,7 +23,7 @@ GET my-index-000001/_validate/query?q=user.id:kimchy * If the {es} {security-features} are enabled, you must have the `read` <> for the target data stream, index, -or index alias. +or alias. [[search-validate-api-desc]] ==== {api-description-title} @@ -37,12 +37,9 @@ request body. ==== {api-path-parms-title} ``:: -(Optional, string) -Comma-separated list of data streams, indices, and index aliases to search. -Wildcard (`*`) expressions are supported. -+ -To search all data streams or indices in a cluster, omit this parameter or use -`_all` or `*`. +(Optional, string) Comma-separated list of data streams, indices, and aliases to +search. Supports wildcards (`*`). To search all data streams or indices, omit +this parameter or use `*` or `_all`. include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=query] diff --git a/docs/reference/searchable-snapshots/apis/clear-cache.asciidoc b/docs/reference/searchable-snapshots/apis/clear-cache.asciidoc index 97484fb43a4b3..bc86e13282027 100644 --- a/docs/reference/searchable-snapshots/apis/clear-cache.asciidoc +++ b/docs/reference/searchable-snapshots/apis/clear-cache.asciidoc @@ -24,16 +24,15 @@ Clears indices and data streams from the shared cache for If the {es} {security-features} are enabled, you must have the `manage` <> to use this API. You must also have the `manage` <> for the target -data stream, index, or index alias. +data stream, index, or alias. [[searchable-snapshots-api-clear-cache-path-params]] ==== {api-path-parms-title} ``:: (Optional, string) -Comma-separated list of data streams, indices, and index aliases to clear from the cache. -To clear the entire cache, omit this parameter. Supports wildcards (`*`). - +Comma-separated list of data streams, indices, and aliases to clear from the +cache. Supports wildcards (`*`). To clear the entire cache, omit this parameter. [[searchable-snapshots-api-clear-cache-example]] ==== {api-examples-title}