全部产品
云市场

删除时间线

更新时间:2019-04-12 10:30:02

请求路径和方法

请求路径 请求方法 描述
/api/delete_meta POST 删除时间线

请求内容

名称 类型 是否必需 描述 举例
metric String 待删除的时间线的 metric cpu
fields List 待删除的时间线的域名称,该参数不是必选,在没有 fields 的情况下, metric 下单值模型和多值模型时间线都会被清除 usage_system, usage_guest
tags Map 待删除的时间线。该参数不是必选,在没有 tag 的情况下, 所有 metric 相关时间线都将删除 见下面的相关说明
deleteData Boolean 是否删除时间线关联的数据,true表示清除关联数据,false表示只清除时间线。注意:在删除时间线的同时清除数据比较耗费资源,只删除时间线耗时较短,默认true false
recursive Boolean 对于用户指定tagKV,指示是否要精准匹配指定的tagKV。
true: 只要目标时间线的Tag 包含了删除条件指定的tagKV,则会被删除;
false: 目标时间线的TagKV 有且只有指定的TagKV,才会被删除。默认值为true
比如数据库中存在2条时间线:
时间线1:TagK1=TagV1 ,TagK2=TagV2,
时间线2: Tagk1=TagV1
删除条件的tags指定为TagK1=TagV1。若recursive=ture, 则时间线1和时间线2都会被删除; 若recursive=false,则只有时间线2会被删除,时间线1则不会被删除
false

请求 JSON 示例

任务: 清除指标为 “cpu”,tag 为 “host: 192.168.0.2”,”appName: hitsdb” 的所有相关时间线。(包括单值模型下的相关时间线和多值模型所有域的相关时间线)请求:POST/api/delete_meta请求体:

  1. {
  2. "metric": "cpu",
  3. "tags": {
  4. "host": "192.168.0.2",
  5. "appName": "hitsdb"
  6. }
  7. "deleteData":false
  8. }

任务: 清除指标 “cpu” 下 “usage_system” 和 “usage_idle” 域,tag 为 “host: 192.168.0.2”,”appName: hitsdb” 的时间线。请求:POST/api/delete_meta请求体:

  1. {
  2. "metric": "cpu.usage",
  3. "fields": ["usage_system", "usage_idle"],
  4. "tags": {
  5. "host": "192.168.0.2",
  6. "appName": "hitsdb"
  7. }
  8. }

响应说明

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