mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-06-28 09:28:55 -04:00
79 lines
2.3 KiB
Text
79 lines
2.3 KiB
Text
[[cluster-remote-info]]
|
|
=== Remote cluster info API
|
|
++++
|
|
<titleabbrev>Remote cluster info</titleabbrev>
|
|
++++
|
|
|
|
..New API reference
|
|
[sidebar]
|
|
--
|
|
For the most up-to-date API details, refer to {api-es}/group/endpoint-cluster[Cluster APIs].
|
|
--
|
|
|
|
Returns configured remote cluster information.
|
|
|
|
[[cluster-remote-info-api-request]]
|
|
==== {api-request-title}
|
|
|
|
`GET /_remote/info`
|
|
|
|
[[cluster-remote-info-api-prereqs]]
|
|
==== {api-prereq-title}
|
|
|
|
* If the {es} {security-features} are enabled, you must have the `monitor` or
|
|
`manage` <<privileges-list-cluster,cluster privilege>> to use this API.
|
|
|
|
[[cluster-remote-info-api-desc]]
|
|
==== {api-description-title}
|
|
|
|
The cluster remote info API allows you to retrieve all of the configured
|
|
remote cluster information. It returns connection and endpoint information keyed
|
|
by the configured remote cluster alias.
|
|
|
|
|
|
[[cluster-remote-info-api-response-body]]
|
|
==== {api-response-body-title}
|
|
|
|
`mode`::
|
|
Connection mode for the remote cluster. Returned values are `sniff` and
|
|
`proxy`.
|
|
|
|
`connected`::
|
|
True if there is at least one connection to the remote cluster.
|
|
|
|
`initial_connect_timeout`::
|
|
The initial connect timeout for remote cluster connections.
|
|
|
|
[[skip-unavailable]]
|
|
`skip_unavailable`::
|
|
Whether a {ccs} skips the remote cluster if its nodes are unavailable during the
|
|
search. If `true`, a {ccs} also ignores errors returned by the remote cluster.
|
|
Refer to <<skip-unavailable-clusters>>.
|
|
|
|
`seeds`::
|
|
Initial seed transport addresses of the remote cluster when sniff mode is
|
|
configured.
|
|
|
|
`num_nodes_connected`::
|
|
Number of connected nodes in the remote cluster when sniff mode is
|
|
configured.
|
|
|
|
`max_connections_per_cluster`::
|
|
Maximum number of connections maintained for the remote cluster when sniff
|
|
mode is configured.
|
|
|
|
`proxy_address`::
|
|
Address for remote connections when proxy mode is configured.
|
|
|
|
`num_proxy_sockets_connected`::
|
|
Number of open socket connections to the remote cluster when proxy mode
|
|
is configured.
|
|
|
|
`max_proxy_socket_connections`::
|
|
The maximum number of socket connections to the remote cluster when proxy
|
|
mode is configured.
|
|
|
|
`cluster_credentials`::
|
|
This field presents and has value of `::es_redacted::` only when the
|
|
<<remote-clusters-api-key,remote cluster is configured with the API key based model>>.
|
|
Otherwise, the field is not present.
|