Skip to content

Commit 6ec6a4f

Browse files
a03nikkijrodewig
andauthored
[DOCS] Update multi-target syntax page (#62192)
Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
1 parent 2fa5891 commit 6ec6a4f

File tree

1 file changed

+9
-5
lines changed

1 file changed

+9
-5
lines changed

docs/reference/api-conventions.asciidoc

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,14 +18,18 @@ API, unless otherwise specified.
1818
Most APIs that accept a `<data-stream>`, `<index>`, or `<target>` request path
1919
parameter also support _multi-target syntax_.
2020

21-
In multi-target syntax, you can use a comma-separated list to execute a request across multiple resources, such as
22-
data streams, indices, or index aliases: `test1,test2,test3`. You can also use
23-
{wikipedia}/Glob_(programming)[glob-like] wildcard (`*`)
24-
expressions to target any
25-
resources that match the pattern: `test*` or `*test` or `te*t` or `*test*.
21+
In multi-target syntax, you can use a comma-separated list to run a request on
22+
multiple data streams, indices, or index aliases: `test1,test2,test3`. You can
23+
also use {wikipedia}/Glob_(programming)[glob-like] wildcard (`*`) expressions to
24+
target resources that match a pattern: `test*` or `*test` or `te*t` or `*test*`.
2625

2726
You can exclude targets using the `-` character: `test*,-test3`.
2827

28+
IMPORTANT: Index aliases are resolved after wildcard expressions. This can
29+
result in a request that targets an excluded alias. For example, if `test3` is
30+
an index alias, the pattern `test*,-test3` still targets the indices for
31+
`test3`. To avoid this, exclude the concrete indices for the alias instead.
32+
2933
Multi-target APIs that can target indices support the following query
3034
string parameters:
3135

0 commit comments

Comments
 (0)