如何通过HTTP API清理时间线_时间序列数据库 TSDB(TSDB)-阿里云帮助中心

请求路径和方法

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

请求内容

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

请求 JSON 示例

任务： 清除指标为 “cpu”，tag 为 “host: 192.168.0.2”，”appName: hitsdb” 的所有相关时间线。（包括单值模型下的相关时间线和多值模型所有域的相关时间线）

请求：POST/api/delete_meta请求体：

    {
        "metric": "cpu",
        "tags": {
            "host": "192.168.0.2",
            "appName": "hitsdb"
        }
        "deleteData":false
    }

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

    {
        "metric": "cpu.usage",
        "fields": ["usage_system", "usage_idle"],
        "tags": {
            "host": "192.168.0.2",
            "appName": "hitsdb"
        }
    }

响应说明

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