Skip to content

Commit 5e48811

Browse files
committed
[DOCS] Document CCS-supported APIs (#52708)
Explicitly notes the Elasticsearch API endpoints that support CCS. This should deter users from attempting to use CCS with other API endpoints, such as `GET <index>/_doc/<_id>`.
1 parent 7dc41a3 commit 5e48811

File tree

1 file changed

+18
-8
lines changed

1 file changed

+18
-8
lines changed

docs/reference/modules/cross-cluster-search.asciidoc

+18-8
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,17 @@ filter and analyze log data stored on clusters in different data centers.
88

99
IMPORTANT: {ccs-cap} requires <<modules-remote-clusters, remote clusters>>.
1010

11+
[float]
12+
[[ccs-supported-apis]]
13+
== Supported APIs
14+
15+
The following APIs support {ccs}:
16+
17+
* <<search-search,Search>>
18+
* <<search-multi-search,Multi search>>
19+
* <<search-template,Search template>>
20+
* <<multi-search-template,Multi search template>>
21+
1122
[float]
1223
[[ccs-example]]
1324
== {ccs-cap} examples
@@ -55,7 +66,7 @@ PUT _cluster/settings
5566
[[ccs-search-remote-cluster]]
5667
=== Search a single remote cluster
5768

58-
The following <<search,search>> API request searches the
69+
The following <<search-search,search>> API request searches the
5970
`twitter` index on a single remote cluster, `cluster_one`.
6071

6172
[source,console]
@@ -284,13 +295,12 @@ including a <<request-body-search-scroll, scroll>> or
284295
+
285296
See <<ccs-min-roundtrips>> to learn how this option works.
286297

287-
<<ccs-unmin-roundtrips, Don't minimize network roundtrips>>::
288-
For search requests that include a scroll or inner hits, {es} sends multiple
289-
outgoing and ingoing requests to each remote cluster. You can also choose this
290-
option by setting the <<search,search>> API's
291-
<<ccs-minimize-roundtrips,`ccs_minimize_roundtrips`>> parameter to `false`.
292-
While typically slower, this approach may work well for networks with low
293-
latency.
298+
<<ccs-unmin-roundtrips, Don't minimize network roundtrips>>:: For search
299+
requests that include a scroll or inner hits, {es} sends multiple outgoing and
300+
ingoing requests to each remote cluster. You can also choose this option by
301+
setting the <<ccs-minimize-roundtrips,`ccs_minimize_roundtrips`>> parameter to
302+
`false`. While typically slower, this approach may work well for networks with
303+
low latency.
294304
+
295305
See <<ccs-unmin-roundtrips>> to learn how this option works.
296306

0 commit comments

Comments
 (0)