NOTE: You are looking at documentation for an older release. For the latest information, see the current release documentation.

« API Conventions Date math support in index names »
Elastic Docs ›Elasticsearch Guide [6.8] ›API Conventions

Multiple Indices

edit
IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

Multiple Indices

edit

Most APIs that refer to an index parameter support execution across multiple indices, using simple test1,test2,test3 notation (or _all for all indices). It also supports wildcards, for example: test* or *test or te*t or *test*, and the ability to "exclude" (-), for example: test*,-test3.

All multi indices APIs support the following url query string parameters:

ignore_unavailable

Controls whether to ignore if any specified indices are unavailable, including indices that don’t exist or closed indices. Either true or false can be specified.

allow_no_indices

Controls whether to fail if a wildcard indices expression results in no concrete indices. Either true or false can be specified. For example if the wildcard expression foo* is specified and no indices are available that start with foo, then depending on this setting the request will fail. This setting is also applicable when _all, *, or no index has been specified. This settings also applies for aliases, in case an alias points to a closed index.

expand_wildcards

Controls what kind of concrete indices that wildcard indices expressions can expand to. If open is specified then the wildcard expression is expanded to only open indices. If closed is specified then the wildcard expression is expanded only to closed indices. Also both values (open,closed) can be specified to expand to all indices.

If none is specified then wildcard expansion will be disabled. If all is specified, wildcard expressions will expand to all indices (this is equivalent to specifying open,closed).

The defaults settings for the above parameters depend on the API being used.

Single index APIs such as the Document APIs and the single-index alias APIs do not support multiple indices.

« API Conventions Date math support in index names »