› › ›

API для запуска данных

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

Запрос

POST _ml/datafeeds/<feed_id>/_start

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

Перед запуском потока данных работа по обнаружению аномалий должна быть открыта. В противном случае произойдет ошибка.
Требуется привилегия кластера manage_ml. Эта привилегия включена в встроенную роль machine_learning_admin.

Описание

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

Если вы перезапускаете остановленный поток данных, по умолчанию он продолжает обработку входных данных с миллисекунды, следующей за моментом остановки. Если новые данные были индексированы в эту самую миллисекунду между остановкой и запуском, они будут проигнорированы.

При включенных функциях безопасности Elasticsearch поток данных запоминает роли последнего пользователя, создавшего или обновившего его в момент создания/обновления, и выполняет запрос с использованием тех же ролей. Если при создании или обновлении потока данных были предоставлены заголовки вторичной авторизации, эти учетные данные будут использоваться вместо этого.

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

<feed_id>: (Обязательно, строка) Числовая строка, уникально идентифицирующая поток данных. Этот идентификатор может содержать строчные буквенно-цифровые символы (a-z и 0-9), дефисы и подчеркивания. Он должен начинаться и заканчиваться буквенно-цифровыми символами.

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

end

(Необязательно, строка) Время, по которому поток данных должен закончиться, которое может быть указано с использованием одного из следующих форматов:

Формат ISO 8601 с миллисекундами, например 2017-01-22T06:00:00.000Z
Формат ISO 8601 без миллисекунд, например 2017-01-22T06:00:00+00:00
Миллисекунды с момента эпохи, например 1485061200000

Аргументы даты и времени, использующие любой из форматов ISO 8601, должны иметь обозначение часового пояса, где Z принимается как аббревиатура для UTC.

При ожидании URL (например, в браузерах) +, используемый в обозначениях часовых поясов, необходимо закодировать как %2B.

Это значение является исключительным. Если вы не указываете время завершения, поток данных работает непрерывно.

start

(Необязательно, строка) Время, с которого должен начаться поток данных, которое может быть указано с помощью тех же форматов, что и параметр end. Это значение является включительным.

Если вы не указываете время начала и поток данных связан с новой задачей обнаружения аномалий, анализ начнется с самого раннего времени, для которого доступны данные.

Если вы перезапускаете остановленный поток данных и указываете значение start, которое раньше отметки времени последней обработанной записи, поток данных продолжится с миллисекунды, следующей за отметкой времени последней обработанной записи.

timeout

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

Тело запроса

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

Тело ответа

node: (строка) Идентификатор узла, на котором был запущен поток данных. Если поток данных разрешено открывать в режиме отложенного исполнения и ему еще не назначен узел, это значение является пустой строкой.
started: (Булево) Для успешного ответа это значение всегда true. При ошибке вместо этого возвращается исключение.

Примеры

resp = client.ml.start_datafeed(
    datafeed_id="datafeed-low_request_rate",
    start="2019-04-07T18:22:16Z",
)
print(resp)

const response = await client.ml.startDatafeed({
  datafeed_id: "datafeed-low_request_rate",
  start: "2019-04-07T18:22:16Z",
});
console.log(response);

POST _ml/datafeeds/datafeed-low_request_rate/_start
{
  "start": "2019-04-07T18:22:16Z"
}

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

{
  "started" : true,
  "node" : "node-1"
}

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