查询主节点

此 API 用于返回 Easysearch 集群主节点（Master Node）的详细信息。

API #

GET /_cat/master

API 的作用 #

显示当前集群中主节点的详细信息，包括：

• 节点 ID：主节点的唯一标识符
• 主机名：主节点所在的主机名
• IP 地址：主节点的 IP 地址
• 节点名称：主节点的名称

主节点负责管理集群范围的操作，如创建索引、分配分片、维护集群状态等。当没有主节点时（如主节点故障），所有字段会显示 “-"。

API 的参数 #

此 API 没有路由参数。

查询字符串参数 #

返回的字段信息 #

请求示例 #

# 查询主节点信息
GET /_cat/master

# 显示列头
GET /_cat/master?v

# 使用 JSON 格式
GET /_cat/master?format=json

# 只显示特定列
GET /_cat/master?h=id,ip,node

# 显示帮助信息
GET /_cat/master?help

响应示例 #

文本格式（默认） #

id                                   host      ip           node
uYWZ7pSNRS-O4oLMP8N_mw                 node1     10.0.1.10    master-node

文本格式（带列头） #

id                                   host      ip           node
uYWZ7pSNRS-O4oLMP8N_mw                 node1     10.0.1.10    master-node

JSON 格式 #

[
  {
    "id": "uYWZ7pSNRS-O4oLMP8N_mw",
    "host": "node1",
    "ip": "10.0.1.10",
    "node": "master-node"
  }
]

无主节点时的响应 #

当集群没有主节点时（如集群初始化中或主节点故障）：

id   host   ip   node
-    -      -    -

帮助信息 #

id    |      | node id
host  | h    | host name
ip    |      | ip address
node  | n    | node name

使用场景 #

1. 集群管理：确认当前主节点的身份
2. 故障排查：检查主节点是否正常
3. 运维操作：在进行集群级操作前确认主节点
4. 高可用验证：验证主节点切换是否正常

主节点相关概念 #

主节点职责 #

• 管理集群状态
• 创建/删除索引
• 分配分片到节点
• 处理节点加入/离开

主节点选举 #

• 集群中的 master-eligible 节点可以参与主节点选举
• 当主节点故障时，会自动选举新的主节点
• 通过 discovery.zen.minimum_master_nodes 配置防止脑裂

专用主节点 #

在大规模集群中，建议配置专用主节点（master-only nodes）：

• 只负责集群管理，不存储数据
• 减轻主节点负担，提高集群稳定性

注意事项 #

1. 此 API 只支持 GET 方法
2. 当没有主节点时，所有字段显示 “-”
3. local=true 时可能返回过时信息，但响应更快
4. 主节点信息可能会在节点故障时自动切换

相关文档 #

• 查询节点
• 查询集群健康
• 获取集群状态
• 获取节点信息