删除汇总作业 API

编辑

在 8.11.0 版本中已弃用。

汇总将在未来版本中删除。请改用降采样

删除现有的汇总作业。

请求

编辑

DELETE _rollup/job/<job_id>

先决条件

编辑
  • 如果启用了 Elasticsearch 安全功能,您必须具有 managemanage_rollup 集群权限才能使用此 API。有关更多信息,请参阅安全权限

描述

编辑

作业必须首先停止才能删除。如果您尝试删除已启动的作业,则会发生错误。同样,如果您尝试删除不存在的作业,则会发生异常。

删除作业时,只会删除正在主动监视和汇总数据的进程。它不会删除任何先前汇总的数据。这是有意为之的;用户可能希望汇总一个静态数据集。因为数据集是静态的,所以一旦它被完全汇总,就没有必要保留索引汇总作业(因为不会有新数据)。因此,可以删除该作业,留下汇总的数据以供分析。

如果您还想删除汇总数据,并且汇总索引仅包含单个作业的数据,您可以直接删除整个汇总索引。如果汇总索引存储来自多个作业的数据,则必须发出一个 delete-by-query,该查询以汇总索引中的汇总作业 ID 为目标。

POST my_rollup_index/_delete_by_query
{
  "query": {
    "term": {
      "_rollup.id": "the_rollup_job_id"
    }
  }
}

路径参数

编辑
<job_id>
(必需,字符串)作业的标识符。

响应代码

编辑
404(缺少资源)
此代码表示没有与请求匹配的资源。如果您尝试删除不存在的作业,则会发生此情况。

示例

编辑

如果我们有一个名为 sensor 的汇总作业,则可以使用以下命令删除它

resp = client.rollup.delete_job(
    id="sensor",
)
print(resp)
response = client.rollup.delete_job(
  id: 'sensor'
)
puts response
const response = await client.rollup.deleteJob({
  id: "sensor",
});
console.log(response);
DELETE _rollup/job/sensor

这将返回响应

{
  "acknowledged": true
}