升级模型快照 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
(字符串) 如果升级任务仍在运行,则为分配给它的节点的 ID。
completed
(布尔值) 为 true 时,表示任务已完成。为 false 时,表示任务仍在运行。

示例编辑

POST _ml/anomaly_detectors/low_request_rate/model_snapshots/1828371/_upgrade?timeout=45m&wait_for_completion=true

当快照升级开始时,您将收到以下结果

{
  "completed" : false,
  "node" : "node-1"
}