cat master API

编辑

cat API 仅供人使用命令行或 Kibana 控制台进行消费。它们适用于应用程序使用。对于应用程序消费,请使用 节点信息 API

返回有关主节点的信息,包括 ID、绑定的 IP 地址和名称。

请求

编辑

GET /_cat/master

先决条件

编辑
  • 如果启用了 Elasticsearch 安全功能,您必须具有 monitormanage 集群权限才能使用此 API。

查询参数

编辑
format
(可选,字符串) HTTP accept header 的简短版本。有效值包括 JSON、YAML 等。
h
(可选,字符串) 要显示的列名的逗号分隔列表。
help
(可选,布尔值) 如果为 true,则响应包含帮助信息。默认为 false
local
(可选,布尔值) 如果为 true,则请求仅从本地节点检索信息。默认为 false,这意味着从主节点检索信息。
master_timeout
(可选,时间单位) 等待主节点的时间段。如果主节点在超时到期之前不可用,则请求失败并返回错误。默认为 30s。也可以设置为 -1,表示请求永远不应超时。
s
(可选,字符串) 用于对响应进行排序的列名或列别名的逗号分隔列表。
v
(可选,布尔值) 如果为 true,则响应包含列标题。默认为 false

示例

编辑
resp = client.cat.master(
    v=True,
)
print(resp)
response = client.cat.master(
  v: true
)
puts response
const response = await client.cat.master({
  v: "true",
});
console.log(response);
GET /_cat/master?v=true

该 API 返回以下响应

id                     host      ip        node
YzWoH_2BT-6UjVGDyPdqYg 127.0.0.1 127.0.0.1 YzWoH_2

此信息也可通过 nodes 命令获得,但是,例如,当您只想验证所有节点是否在主节点上达成一致时,此命令稍微简洁一些

% pssh -i -h list.of.cluster.hosts curl -s localhost:9200/_cat/master
[1] 19:16:37 [SUCCESS] es3.vm
Ntgn2DcuTjGuXlhKDUD4vA 192.168.56.30 H5dfFeA
[2] 19:16:37 [SUCCESS] es2.vm
Ntgn2DcuTjGuXlhKDUD4vA 192.168.56.30 H5dfFeA
[3] 19:16:37 [SUCCESS] es1.vm
Ntgn2DcuTjGuXlhKDUD4vA 192.168.56.30 H5dfFeA