mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-06-28 17:34:17 -04:00
33a71e3289
* Remove `es-test-dir` book-scoped variable * Remove `plugins-examples-dir` book-scoped variable * Remove `:dependencies-dir:` and `:xes-repo-dir:` book-scoped variables - In `index.asciidoc`, two variables (`:dependencies-dir:` and `:xes-repo-dir:`) were removed. - In `sql/index.asciidoc`, the `:sql-tests:` path was updated to fuller path - In `esql/index.asciidoc`, the `:esql-tests:` path was updated idem * Replace `es-repo-dir` with `es-ref-dir` * Move `:include-xpack: true` to few files that use it, remove from index.asciidoc
109 lines
2.6 KiB
Text
109 lines
2.6 KiB
Text
[[cat-alias]]
|
|
=== cat aliases API
|
|
++++
|
|
<titleabbrev>cat aliases</titleabbrev>
|
|
++++
|
|
|
|
[IMPORTANT]
|
|
====
|
|
cat APIs are only intended for human consumption using the command line or the
|
|
{kib} console. They are _not_ intended for use by applications. For application
|
|
consumption, use the <<aliases,aliases API>>.
|
|
====
|
|
|
|
Retrieves the cluster's <<aliases,index aliases>>, including filter and routing
|
|
information. The API does not return data stream aliases.
|
|
|
|
[[cat-alias-api-request]]
|
|
==== {api-request-title}
|
|
|
|
`GET _cat/aliases/<alias>`
|
|
|
|
`GET _cat/aliases`
|
|
|
|
[[cat-alias-api-prereqs]]
|
|
==== {api-prereq-title}
|
|
|
|
* If the {es} {security-features} are enabled, you must have the
|
|
`view_index_metadata` or `manage` <<privileges-list-indices,index privilege>>
|
|
for any alias you retrieve.
|
|
|
|
[[cat-alias-api-path-params]]
|
|
==== {api-path-parms-title}
|
|
|
|
`<alias>`::
|
|
(Optional, string) Comma-separated list of aliases to retrieve. Supports
|
|
wildcards (`*`). To retrieve all aliases, omit this parameter or use `*` or
|
|
`_all`.
|
|
|
|
[[cat-alias-api-query-params]]
|
|
==== {api-query-parms-title}
|
|
|
|
include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=http-format]
|
|
|
|
include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=cat-h]
|
|
|
|
include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=help]
|
|
|
|
include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=local]
|
|
|
|
include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=cat-s]
|
|
|
|
include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=cat-v]
|
|
|
|
include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=expand-wildcards]
|
|
|
|
[[cat-alias-api-example]]
|
|
==== {api-examples-title}
|
|
|
|
////
|
|
Hidden setup for example:
|
|
[source,console,id=cat-aliases-example]
|
|
----
|
|
PUT test1
|
|
{
|
|
"aliases": {
|
|
"alias1": {},
|
|
"alias2": {
|
|
"filter": {
|
|
"match": {
|
|
"user.id": "kimchy"
|
|
}
|
|
}
|
|
},
|
|
"alias3": {
|
|
"routing": "1"
|
|
},
|
|
"alias4": {
|
|
"index_routing": "2",
|
|
"search_routing": "1,2"
|
|
}
|
|
}
|
|
}
|
|
----
|
|
////
|
|
|
|
[source,console]
|
|
----
|
|
GET _cat/aliases?v=true
|
|
----
|
|
// TEST[continued]
|
|
|
|
The API returns the following response:
|
|
|
|
[source,txt]
|
|
----
|
|
alias index filter routing.index routing.search is_write_index
|
|
alias1 test1 - - - -
|
|
alias2 test1 * - - -
|
|
alias3 test1 - 1 1 -
|
|
alias4 test1 - 2 1,2 -
|
|
----
|
|
// TESTRESPONSE[s/[*]/[*]/ non_json]
|
|
|
|
This response shows that `alias2` has configured a filter, and specific routing
|
|
configurations in `alias3` and `alias4`.
|
|
|
|
If you only want to get information about specific aliases, you can specify
|
|
the aliases in comma-delimited format as a URL parameter, e.g.,
|
|
/_cat/aliases/alias1,alias2.
|