API обновления снимков моделей
Обновляет снимок модели обнаружения аномалий до последней основной версии.
Начиная с Elasticsearch 8.10.0, для отслеживания изменений конфигурации и состояния плагина машинного обучения используется новый номер версии. Этот новый номер версии отделён от версии продукта и будет увеличиваться независимо.
Запрос
POST _ml/anomaly_detectors/<job_id>/model_snapshots/<snapshot_id>/_upgrade
Предварительные условия
- Требуется привилегия кластера
manage_ml. Эта привилегия включена в встроенную рольmachine_learning_admin. - Обновляемый снимок должен иметь версию, соответствующую предыдущей основной версии.
- Обновляемый снимок НЕ должен быть текущим снимком задачи обнаружения аномалий.
Описание
Со временем устаревают и удаляются старые форматы снимков. Задачи обнаружения аномалий поддерживают только снимки текущей или предыдущей основной версии.
Этот API предоставляет способ обновления снимка до текущей основной версии. Это помогает подготовить кластер к обновлению до следующей основной версии.
Одновременно можно обновить только один снимок на задачу обнаружения аномалий, и обновляемый снимок не может быть текущим снимком задачи обнаружения аномалий.
Параметры пути
-
<job_id> - (Обязательно, строка) Идентификатор задачи обнаружения аномалий.
-
<snapshot_id> - (Обязательно, строка) Идентификатор снимка модели.
Параметры запроса
-
timeout - (Необязательно, время) Управляет временем ожидания завершения запроса. Значение по умолчанию — 30 минут.
-
wait_for_completion - (Необязательно, логическое значение) Если значение равно true, API не ответит, пока обновление не будет завершено. В противном случае, он отвечает сразу после назначения задачи обновления узлу. Значение по умолчанию — false.
Тело ответа
-
node - (строка) Идентификатор назначенного узла для задачи обновления, если она всё ещё выполняется.
-
completed - (логическое значение) Если значение равно true, это означает, что задача завершена. Если значение равно false, она всё ещё выполняется.
Примеры
resp = client.ml.upgrade_job_snapshot(
job_id="low_request_rate",
snapshot_id="1828371",
timeout="45m",
wait_for_completion=True,
)
print(resp) const response = await client.ml.upgradeJobSnapshot({
job_id: "low_request_rate",
snapshot_id: 1828371,
timeout: "45m",
wait_for_completion: "true",
});
console.log(response); POST _ml/anomaly_detectors/low_request_rate/model_snapshots/1828371/_upgrade?timeout=45m&wait_for_completion=true
При запуске обновления снимка вы получите следующие результаты:
{
"completed" : false,
"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-upgrade-job-model-snapshot.html
