› 推特 ›阿里云技术文档›正文

删除时间线_HTTP API 参考_时序数据库 TSDB_时序时空数据库TSDB

admin 阿里云技术文档 2020-02-11 202 0
阿里云服务器优惠

删除时间线

请求路径和方法

请求路径 请求方法 描述
/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 表示成功，其他返回码表示失败，错误信息参考公共响应状态码。

版权声明

本文仅代表作者观点，不代表本站立场。
本文系作者授权发表，未经许可，不得转载。

评论

-----