升级模型快照 API
编辑升级模型快照 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" }