› › ›

cat master API

编辑

cat master API编辑

cat API 仅供使用命令行或 Kibana 控制台的人类使用。它们**不**适合应用程序使用。对于应用程序使用，请使用节点信息 API。

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

请求编辑

GET /_cat/master

先决条件编辑

如果启用了 Elasticsearch 安全功能，则必须具有monitor 或 manage 集群权限才能使用此 API。

查询参数编辑

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

示例编辑

response = client.cat.master(
  v: true
)
puts 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

« cat indices API cat nodeattrs API »