删除汇总作业 API编辑

在 8.11.0 中已弃用。

汇总将在未来版本中移除。请使用 降采样 代替。

删除现有的汇总作业。

请求编辑

DELETE _rollup/job/<job_id>

先决条件编辑

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

描述编辑

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

删除作业只会删除正在积极监控和汇总数据的进程。它不会删除任何先前汇总的数据。这是设计使然;用户可能希望汇总静态数据集。由于数据集是静态的,一旦它被完全汇总,就没有必要保留索引汇总作业(因为不会有新数据)。因此,可以删除作业,留下汇总数据以供分析。

如果您希望也删除汇总数据,并且汇总索引只包含单个作业的数据,则可以简单地删除整个汇总索引。如果汇总索引存储来自多个作业的数据,则必须发出针对汇总作业 ID 的删除查询,该查询位于汇总索引中。

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

路径参数编辑

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

响应代码编辑

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

示例编辑

如果我们有一个名为 sensor 的汇总作业,它可以通过以下方式删除

response = client.rollup.delete_job(
  id: 'sensor'
)
puts response
DELETE _rollup/job/sensor

这将返回响应

{
  "acknowledged": true
}