› › ›

API остановки потоков данных

Останавливает один или несколько потоков данных.

Запрос

POST _ml/datafeeds/<feed_id>/_stop

POST _ml/datafeeds/<feed_id>,<feed_id>/_stop

POST _ml/datafeeds/_all/_stop

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

Требуется привилегия кластера manage_ml. Эта привилегия включена в встроенную роль machine_learning_admin.

Описание

Поток данных, который остановлен, прекращает извлекать данные из Elasticsearch. Поток данных может быть запущен и остановлен несколько раз на протяжении всего его жизненного цикла.

Параметры пути

<feed_id>: (Обязательный, строка) Идентификатор потока данных. Вы можете остановить несколько потоков данных в одном запросе API, используя список потоков данных, разделенных запятыми, или выражение с подстановкой. Вы можете закрыть все потоки данных, используя _all или указав * в качестве идентификатора.

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

allow_no_datafeeds

(Необязательно, логическое значение) [7.10] Устарело в 7.10. Используйте allow_no_match вместо этого.

allow_no_match

(Необязательно, логическое значение) Указывает, что делать, когда запрос:

Содержит выражения с подстановкой, и нет потоков данных, которые соответствуют.
Содержит строку _all или не содержит идентификаторов, и нет соответствий.
Содержит выражения с подстановкой, и есть только частичные совпадения.

Значение по умолчанию — true, которое возвращает пустой массив datafeeds, когда нет совпадений, и подмножество результатов при частичных совпадениях. Если этот параметр равен false, запрос возвращает код состояния 404, если нет совпадений или только частичные совпадения.

force

(Необязательно, логическое значение) Если true, поток данных останавливается принудительно.

timeout

(Необязательно, время) Указывает время ожидания остановки потока данных. Значение по умолчанию — 20 секунд.

Тело запроса

Вы также можете указать параметры запроса (такие как allow_no_match и force) в теле запроса.

Коды ответов

404 (Недостающие ресурсы): Если allow_no_match равно false, этот код указывает, что ресурсов, соответствующих запросу, нет, или есть только частичные соответствия запросу.

Примеры

POST _ml/datafeeds/datafeed-total-requests/_stop
{
  "timeout": "30s"
}

Когда поток данных останавливается, вы получаете следующие результаты:

{
  "stopped": true
}

© 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/ml-stop-datafeed.html