API для установки режима обновления

POST _ml/set_upgrade_mode

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

При обновлении кластера в некоторых случаях необходимо перезапустить узлы и переиндексировать индексы машинного обучения. В этих случаях не должно выполняться никаких задач машинного обучения. Можно остановить задачи машинного обучения, выполнить обновление, а затем снова запустить все задачи. В качестве альтернативы можно использовать этот API для временной остановки задач, связанных с заданиями и источниками данных, и предотвращения запуска новых заданий. Этот API также можно использовать во время обновлений, не требующих переиндексации индексов машинного обучения, хотя в этом случае остановка задач не является обязательной.

Дополнительную информацию см. в разделе Обновление Elastic Stack.

При вызове этого API все задачи заданий и источников данных временно приостанавливаются, и новые задания и источники данных не могут запускаться.

Впоследствии можно вызвать API со значением параметра enabled, установленным в false, что приведет к возвращению задач машинного обучения и источников данных в их желаемое состояние.

Текущее значение настройки upgrade_mode можно посмотреть с помощью API получения информации о машинном обучении.

POST _ml/set_upgrade_mode?enabled=true&timeout=10m

При успешном вызове возвращается ответ с подтверждением. Например:

{
  "acknowledged": true
}

Ответ с подтверждением возвращается только после того, как все задачи машинного обучения и источники данных завершат запись в внутренние индексы машинного обучения. Это означает, что переиндексацию этих внутренних индексов можно безопасно выполнить без сбоев. Необходимо дождаться ответа с подтверждением перед переиндексацией, чтобы убедиться в завершении всех записей.

После завершения обновления необходимо установить upgrade_mode в значение false, чтобы задачи машинного обучения снова начали выполняться. Например:

POST _ml/set_upgrade_mode?enabled=false&timeout=10m