IMPORTANT: No additional bug fixes or documentation updates
will be released for this version. For the latest information, see the
current release documentation.
Upgrade model snapshots API
editUpgrade model snapshots API
editUpgrades an anomaly detection model snapshot to the latest major version.
Request
editPOST _ml/anomaly_detectors/<job_id>/model_snapshots/<snapshot_id>/_upgrade
Prerequisites
edit-
Requires the
manage_ml
cluster privilege. This privilege is included in themachine_learning_admin
built-in role. - The upgraded snapshot must have a version matching the previous major version.
- The upgraded snapshot must NOT be the current anomaly detection job snapshot.
Description
editOver time, older snapshot formats are deprecated and removed. Anomaly detection jobs support only snapshots that are from the current or previous major version.
This API provides a means to upgrade a snapshot to the current major version. This aids in preparing the cluster for an upgrade to the next major version.
Only one snapshot per anomaly detection job can be upgraded at a time and the upgraded snapshot cannot be the current snapshot of the anomaly detection job.
Path parameters
edit-
<job_id>
- (Required, string) Identifier for the anomaly detection job.
-
<snapshot_id>
- (Required, string) A numerical character string that uniquely identifies the model snapshot.
Query parameters
edit-
timeout
- (Optional, time) Controls the time to wait for the request to complete. The default value is 30 minutes.
-
wait_for_completion
- (Optional, boolean) When true, the API won’t respond until the upgrade is complete. Otherwise, it responds as soon as the upgrade task is assigned to a node. Default is false.
Response body
edit-
node
- (string) The ID of the assigned node for the upgrade task if it is still running.
-
completed
- (boolean) When true, this means the task is complete. When false, it is still running.
Examples
editPOST _ml/anomaly_detectors/low_request_rate/model_snapshots/1828371/_upgrade?timeout=45m&wait_for_completion=true
When the snapshot upgrade starts, you receive the following results:
{ "completed" : false, "node" : "node-1" }