删除数据

更新时间:

请求路径和方法

请求路径 请求方法 描述
/api/delete_data POST 删除数据

请求内容

名称 类型 是否必需 描述 默认值 举例
metric String 待删除数据的 Metric cpu
tags Map 待删除的时间线。该参数不是必选,在没有 tag 的情况下, 所有 metric 相关时间线都将删除 见下面的相关说明
fields List 在 metric 下,要被删除的域数据 usage_system, usage_guest
start Integer 待删除的开始时间戳,单位秒 1499308591
end Integer 待删除的结束时间戳,单位秒 当前时间 1499508591

注意: 如果没有提供 fields 信息,则会删除跟 metric 相关的所有数据,包括单值模型数据和 metric 下所有 fields 的数据。

注意: 只要一个时间线满足请求体中指定的指标,且 tags 中包含了指定的 tags, 即便该时间线的组成还包含其他 tag 时,该时间线也被视为满足条件,其数据也会被删除。

请求 JSON 示例

任务: 清除从 1499308591 到 1499508591 指标为 “cpu” 的所有数据。请求:POST/api/delete_data请求体:

  1. {
  2. "metric": "cpu",
  3. "start": 1499308591,
  4. "end": 1499508591
  5. }

任务: 清除从 1499308591 到 1499508591 指标为 “cpu” , tag 为“host: 192.168.0.2”,”appName: hitsdb”的所有数据线的数据。请求:POST/api/delete_data请求体:

  1. {
  2. "metric": "cpu",
  3. "tags": {
  4. "host": "192.168.0.2",
  5. "appName": "hitsdb"
  6. },
  7. "start": 1499308591,
  8. "end": 1499508591
  9. }

任务: 清除从 1499308591 到 1499508591 “cpu” 指标下 “usage_system” 和 “usage_guest” 域的所有数据。请求:POST/api/delete_data请求体:

  1. {
  2. "metric": "cpu",
  3. "fields": ["usage_system", "usage_guest"],
  4. "start": 1499308591,
  5. "end": 1499508591
  6. }

响应说明

200 表示成功,其他返回码表示失败,错误信息参考公共响应状态码