API для закрытия задач обнаружения аномалий
Закрывает одну или несколько задач обнаружения аномалий.
Запрос
POST _ml/anomaly_detectors/<job_id>/_close
POST _ml/anomaly_detectors/<job_id>,<job_id>/_close
POST _ml/anomaly_detectors/_all/_close
Предварительные условия
- Требуется привилегия кластера
manage_ml. Эта привилегия включена в встроенную рольmachine_learning_admin.
Описание
Задача может быть открыта и закрыта несколько раз на протяжении всего жизненного цикла.
Закрытая задача не может получать данные или выполнять операции анализа, но вы всё ещё можете исследовать и просматривать результаты.
Если вы закрываете задачу обнаружения аномалий, чья задача подачи данных работает, запрос сначала пытается остановить подачу данных. Это поведение эквивалентно вызову API остановки подачи данных с теми же параметрами timeout и force, что и в запросе закрытия задачи.
При закрытии задачи она выполняет задачи обслуживания, такие как обрезка истории модели, сброс буферов, вычисление конечных результатов и сохранение моментальных снимков модели. В зависимости от размера задачи, её закрытие может занять несколько минут, а время повторного открытия - эквивалентно.
После закрытия задача имеет минимальную нагрузку на кластер, за исключением поддержки метаданных. Поэтому рекомендуется закрывать задачи, которые больше не требуются для обработки данных.
Когда задача подачи данных, у которой указана конечная дата, останавливается, она автоматически закрывает связанную задачу.
Если вы используете параметр запроса force, запрос возвращается без выполнения связанных действий, таких как сброс буферов и сохранение моментальных снимков модели. Поэтому не используйте этот параметр, если вы хотите, чтобы задача была в согласованном состоянии после возвращения API закрытия задачи. Параметр запроса force следует использовать только в ситуациях, когда задача уже завершилась неудачно или когда вы не заинтересованы в результатах, которые задача могла недавно произвести или могла произвести в будущем.
Параметры пути
-
<job_id> -
(Обязательно, строка) Идентификатор задачи обнаружения аномалий. Это может быть идентификатор задачи, имя группы или выражение с подстановкой.
Вы можете закрыть все задачи, используя
_allили указав*в качестве идентификатора задачи.
Параметры запроса
-
allow_no_jobs - (Необязательно, логическое значение) [7.10] Устарело в версии 7.10. Используйте
allow_no_matchвместо этого. -
allow_no_match -
(Необязательно, логическое значение) Определяет, что делать, когда запрос:
- Содержит подстановочные выражения и нет задач, которые соответствуют им.
- Содержит строку
_allили нет идентификаторов, и нет совпадений. - Содержит подстановочные выражения и есть только частичные совпадения.
Значение по умолчанию -
true, которое возвращает пустой массивjobs, когда нет совпадений, и подмножество результатов, когда есть частичные совпадения. Если этот параметр равенfalse, запрос возвращает код состояния404, если нет совпадений или только частичные совпадения. -
force - (Необязательно, логическое значение) Используется для закрытия неудачной задачи или для принудительного закрытия задачи, которая не ответила на первоначальный запрос закрытия.
-
timeout - (Необязательно, единицы измерения времени) Управляет временем ожидания закрытия задачи. Значение по умолчанию - 30 минут.
Тело запроса
Вы также можете указать параметры запроса (например, allow_no_match и force) в теле запроса.
Коды ответов
-
404(Отсутствующие ресурсы) - Если
allow_no_matchимеет значениеfalse, этот код указывает на то, что нет ресурсов, соответствующих запросу, или только частичные совпадения для запроса.
Примеры
POST _ml/anomaly_detectors/low_request_rate/_close
При закрытии задачи вы получаете следующие результаты:
{
"closed": 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-close-job.html