删除汇总作业 API
编辑删除汇总作业 API编辑
在 8.11.0 中已弃用。
汇总将在未来版本中移除。请使用 降采样 代替。
删除现有的汇总作业。
请求编辑
DELETE _rollup/job/<job_id>
描述编辑
作业必须先 停止 才能删除。如果您尝试删除已启动的作业,则会发生错误。同样,如果您尝试删除不存在的作业,则会发生异常。
删除作业只会删除正在积极监控和汇总数据的进程。它不会删除任何先前汇总的数据。这是设计使然;用户可能希望汇总静态数据集。由于数据集是静态的,一旦它被完全汇总,就没有必要保留索引汇总作业(因为不会有新数据)。因此,可以删除作业,留下汇总数据以供分析。
如果您希望也删除汇总数据,并且汇总索引只包含单个作业的数据,则可以简单地删除整个汇总索引。如果汇总索引存储来自多个作业的数据,则必须发出针对汇总作业 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 }