› › ›

API управления задачами cat

API управления задачами cat является новым и по-прежнему следует рассматривать как бета-функцию. API может измениться несовместимым образом. Для статуса функций см. #51628.

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

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

Запрос

GET /_cat/tasks

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

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

Описание

API управления задачами cat возвращает информацию о задачах, выполняемых в настоящее время на одном или нескольких узлах кластера. Это более компактный вид JSON API управления задачами.

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

detailed: (Необязательно, булево) Если true, ответ включает подробную информацию о восстановлении фрагментов. По умолчанию false.
format: (Необязательно, строка) Короткая версия заголовка HTTP accept. Допустимые значения включают JSON, YAML и т. д.
h: (Необязательно, строка) Список столбцов, которые нужно отобразить, разделенный запятыми.
help: (Необязательно, булево) Если true, ответ включает справочную информацию. По умолчанию false.
nodes: (Необязательно, строка) Список идентификаторов или имён узлов, разделенных запятыми, используемых для ограничения ответа. Поддерживает подстановку (*) выражений.
parent_task_id: (Необязательно, строка) Идентификатор родительской задачи, используемый для ограничения ответа.
s: (Необязательно, строка) Список имён столбцов или псевдонимов столбцов, разделенных запятыми, используемых для сортировки ответа.
time: (Необязательно, единицы времени) Единица измерения времени.
v: (Необязательно, булево) Если true, ответ включает заголовки столбцов. По умолчанию false.

Коды ответов

404 (Отсутствуют ресурсы): Если <task_id> указан, но не найден, этот код указывает, что нет ресурсов, соответствующих запросу.

Примеры

GET _cat/tasks?v=true

API возвращает следующий ответ:

action                         task_id                    parent_task_id             type      start_time    timestamp running_time ip             node
cluster:monitor/tasks/lists[n] oTUltX4IQMOUUVeiohTt8A:124 oTUltX4IQMOUUVeiohTt8A:123 direct    1458585884904 01:48:24  44.1micros   127.0.0.1:9300 oTUltX4IQMOUUVeiohTt8A
cluster:monitor/tasks/lists    oTUltX4IQMOUUVeiohTt8A:123 -                          transport 1458585884904 01:48:24  186.2micros  127.0.0.1:9300 oTUltX4IQMOUUVeiohTt8A

© 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-tasks.html