获取已配置的远程集群的信息,包括连接状态、连接模式、代理地址等配置详情。
API #
GET /_cluster/remote/info
GET /_remote/info
API 的作用 #
该 API 用于获取已配置的远程集群的信息。返回每个已配置远程集群的连接详情,包括:
- 连接状态(connected):是否已连接
- 连接模式(mode):
proxy(代理模式)或sniff(嗅探模式) - 超时设置:初始连接超时时间
- 可用性跳过:是否跳过不可用的集群
- 模式特定信息:根据连接模式返回不同的额外信息
Proxy 模式额外信息 #
| 字段 | 描述 |
|---|---|
proxy_address | 代理地址 |
server_name | 服务器名称 |
max_proxy_socket_connections | 最大代理套接字连接数 |
num_proxy_sockets_connected | 已连接的代理套接字数量 |
Sniff 模式额外信息 #
| 字段 | 描述 |
|---|---|
seeds | 种子节点地址列表 |
max_connections_per_cluster | 每个集群的最大连接数 |
num_nodes_connected | 已连接的节点数量 |
API 的参数 #
该 API 不支持任何路由参数或 Query String 参数。
示例 #
获取所有远程集群信息 #
GET /_cluster/remote/info
或
GET /_remote/info
响应示例:
{
"cluster_one": {
"connected": true,
"mode": "proxy",
"initial_connect_timeout": "30s",
"skip_unavailable": false,
"proxy_address": "192.168.1.100:9400",
"server_name": "cluster_one",
"max_proxy_socket_connections": 100,
"num_proxy_sockets_connected": 50
},
"cluster_two": {
"connected": true,
"mode": "sniff",
"initial_connect_timeout": "30s",
"skip_unavailable": true,
"seeds": [
"192.168.1.101:9300",
"192.168.1.102:9300"
],
"max_connections_per_cluster": 100,
"num_nodes_connected": 5
}
}
连接状态说明 #
| 状态 | 描述 |
|---|---|
true | 远程集群已成功连接 |
false | 远程集群未连接或连接失败 |
连接模式说明 #
| 模式 | 描述 |
|---|---|
proxy | 代理模式:通过指定的代理地址连接远程集群 |
sniff | 嗅探模式:通过种子节点发现并连接远程集群的所有节点 |
skip_unavailable 参数说明 #
| 值 | 描述 |
|---|---|
true | 当远程集群不可用时跳过,不影响本地操作 |
false | 当远程集群不可用时操作会失败 |





