原英文版地址: https://www.elastic.co/guide/en/elasticsearch/reference/7.7/ml-delete-job.html, 原文档版权归 www.elastic.co 所有
本地英文版地址: ../en/ml-delete-job.html
本地英文版地址: ../en/ml-delete-job.html
重要: 此版本不会发布额外的bug修复或文档更新。最新信息请参考 当前版本文档。
Delete anomaly detection jobs APIedit
Deletes an existing anomaly detection job.
Requestedit
DELETE _ml/anomaly_detectors/<job_id>
Prerequisitesedit
-
If Elasticsearch security features are enabled, you must have
manage_mlormanagecluster privileges to use this API. See Security privileges. - Before you can delete a job, you must delete the datafeeds that are associated with it. See Delete datafeeds.
-
Before you can delete a job, you must close it (unless you specify the
forceparameter). See Close jobs.
Descriptionedit
All job configuration, model state and results are deleted.
Deleting an anomaly detection job must be done via this API only. Do not
delete the job directly from the .ml-* indices using the Elasticsearch delete document
API. When Elasticsearch security features are enabled, make sure no write privileges
are granted to anyone over the .ml-* indices.
It is not currently possible to delete multiple jobs using wildcards or a comma separated list.
Path parametersedit
-
<job_id> - (Required, string) Identifier for the anomaly detection job.
Query parametersedit
-
force - (Optional, boolean) Use to forcefully delete an opened job; this method is quicker than closing and deleting the job.
-
wait_for_completion -
(Optional, boolean) Specifies whether the request should return immediately or
wait until the job deletion completes. Defaults to
true.
Examplesedit
DELETE _ml/anomaly_detectors/total-requests
When the job is deleted, you receive the following results:
{
"acknowledged": true
}
In the next example we delete the total-requests job asynchronously:
DELETE _ml/anomaly_detectors/total-requests?wait_for_completion=false
When wait_for_completion is set to false, the response contains the id
of the job deletion task:
{
"task": "oTUltX4IQMOUUVeiohTt8A:39"
}