From 7e240379e1b99299dc70eab6bb50af3f08eb0149 Mon Sep 17 00:00:00 2001 From: Liam Thompson <32779855+leemthompo@users.noreply.github.com> Date: Tue, 22 Apr 2025 10:22:26 +0200 Subject: [PATCH 1/3] Update CCS subpage Fix heading, add link to API doc, minor language cleanup --- ...cluster-endpoint-before-cross-cluster-search.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/solutions/search/using-resolve-cluster-endpoint-before-cross-cluster-search.md b/solutions/search/using-resolve-cluster-endpoint-before-cross-cluster-search.md index 6a22f9538d..29e652f61c 100644 --- a/solutions/search/using-resolve-cluster-endpoint-before-cross-cluster-search.md +++ b/solutions/search/using-resolve-cluster-endpoint-before-cross-cluster-search.md @@ -3,17 +3,19 @@ mapped_pages: - https://www.elastic.co/guide/en/elasticsearch/reference/current/_advantages_of_using_this_endpoint_before_a_cross_cluster_search.html applies_to: stack: - serverless: + serverless: unavailable --- -# Advantages of using this endpoint before a {{ccs}} [_advantages_of_using_this_endpoint_before_a_ccs] +# Resolve a cluster before {{ccs}} [_advantages_of_using_this_endpoint_before_a_ccs] + +You can use the [`_resolve/cluster](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-resolve-cluster) endpoint before cross-cluster search to determine which remote clusters to include. This helps you identify clusters or indices that should be excluded from your search. You may want to exclude a cluster or index from a search when: -1. A remote cluster could not be connected to and is configured with `skip_unavailable`=`false`. Executing a {{ccs}} under those conditions will cause [the entire search to fail](/solutions/search/cross-cluster-search.md#cross-cluster-search-failures). -2. A cluster has no matching indices, aliases or data streams for the index expression (or your user does not have permissions to search them). For example, suppose your index expression is `logs*,remote1:logs*` and the `remote1` cluster has no indices, aliases or data streams that match `logs*`. In that case, that cluster will return no results from that cluster if you include it in a {{ccs}}. -3. The index expression (combined with any query parameters you specify) will likely cause an exception to be thrown when you do the search. In these cases, the "error" field in the `_resolve/cluster` response will be present. (This is also where security/permission errors will be shown.) -4. A remote cluster is an older version that does not support the feature you want to use in your search. +1. A remote cluster is unavailable and configured with `skip_unavailable`=`false`. Executing a {{ccs}} under those conditions will cause [the entire search to fail](/solutions/search/cross-cluster-search.md#cross-cluster-search-failures). +2. A cluster has no matching indices, aliases or data streams for the index expression, or your user does not have permissions to search them. For example, if your index expression is `logs*,remote1:logs*` and the `remote1` cluster has no matching indices, that cluster will return no results if included in a {{ccs}}. +3. The index expression, combined with any query parameters you specify, might trigger exceptions. In these cases, the "error" field in the `_resolve/cluster` response will be present. This is also where security/permission errors will be shown. +4. A remote cluster is running an older version that does not support features needed for your search. ## {{api-examples-title}} [resolve-cluster-api-example] From f365b757a0897b3a3ece4849c13ece45db0227e9 Mon Sep 17 00:00:00 2001 From: Liam Thompson <32779855+leemthompo@users.noreply.github.com> Date: Tue, 22 Apr 2025 10:26:55 +0200 Subject: [PATCH 2/3] Backticks back --- ...sing-resolve-cluster-endpoint-before-cross-cluster-search.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/solutions/search/using-resolve-cluster-endpoint-before-cross-cluster-search.md b/solutions/search/using-resolve-cluster-endpoint-before-cross-cluster-search.md index 29e652f61c..9b332d15f9 100644 --- a/solutions/search/using-resolve-cluster-endpoint-before-cross-cluster-search.md +++ b/solutions/search/using-resolve-cluster-endpoint-before-cross-cluster-search.md @@ -8,7 +8,7 @@ applies_to: # Resolve a cluster before {{ccs}} [_advantages_of_using_this_endpoint_before_a_ccs] -You can use the [`_resolve/cluster](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-resolve-cluster) endpoint before cross-cluster search to determine which remote clusters to include. This helps you identify clusters or indices that should be excluded from your search. +You can use the [`_resolve/cluster`](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-resolve-cluster) endpoint before cross-cluster search to determine which remote clusters to include. This helps you identify clusters or indices that should be excluded from your search. You may want to exclude a cluster or index from a search when: From 36f4e202db0965a8b35713233e36cff66e2ae85e Mon Sep 17 00:00:00 2001 From: Liam Thompson <32779855+leemthompo@users.noreply.github.com> Date: Tue, 22 Apr 2025 17:36:30 +0200 Subject: [PATCH 3/3] simplify --- ...sing-resolve-cluster-endpoint-before-cross-cluster-search.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/solutions/search/using-resolve-cluster-endpoint-before-cross-cluster-search.md b/solutions/search/using-resolve-cluster-endpoint-before-cross-cluster-search.md index 9b332d15f9..047e8290c3 100644 --- a/solutions/search/using-resolve-cluster-endpoint-before-cross-cluster-search.md +++ b/solutions/search/using-resolve-cluster-endpoint-before-cross-cluster-search.md @@ -8,7 +8,7 @@ applies_to: # Resolve a cluster before {{ccs}} [_advantages_of_using_this_endpoint_before_a_ccs] -You can use the [`_resolve/cluster`](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-resolve-cluster) endpoint before cross-cluster search to determine which remote clusters to include. This helps you identify clusters or indices that should be excluded from your search. +You can use the [`_resolve/cluster`](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-resolve-cluster) endpoint before cross-cluster search to identify clusters or indices to exclude from your search. You may want to exclude a cluster or index from a search when: