› › ›

cat master API

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

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

Запрос

GET /_cat/master

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

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

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

format: (Необязательно, строка) Короткая версия заголовка HTTP accept. Допустимые значения включают JSON, YAML и т. д.
h: (Необязательно, строка) Список столбцов для отображения, разделенных запятыми.
help: (Необязательно, логическое значение) Если true, ответ включает справочную информацию. По умолчанию false.
local: (Необязательно, логическое значение) Если true, запрос получает информацию только с локального узла. По умолчанию false, что означает извлечение информации с мастер-узла.
master_timeout: (Необязательно, единицы измерения времени) Время ожидания соединения с мастер-узлом. Если ответ не получен до истечения таймаута, запрос завершается с ошибкой. По умолчанию 30s.
s: (Необязательно, строка) Список столбцов или алиасов столбцов, используемых для сортировки ответа, разделенные запятыми.
v: (Необязательно, логическое значение) Если true, ответ включает заголовки столбцов. По умолчанию false.

Примеры

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/7.17/cat-master.html