› › ›

API cat master

API cat предназначены только для использования человеком через командную строку или консоль Kibana. Они не предназначены для использования приложениями. Для использования в приложениях используйте API nodes info.

Возвращает информацию о мастер-узле, включая его ID, IP-адрес и имя.

Запрос

GET /_cat/master

Предварительные условия

Если включены функции безопасности Elasticsearch, вам необходимо иметь monitor или manage привилегию кластера для использования этого API.

Параметры запроса

format: (Необязательно, строка) Сокращенная версия заголовка HTTP Accept. Допустимые значения включают 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

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/cat-master.html