阿里云首页 时序数据库 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表示只清除时间线。注意:在删除时间线的同时清除数据比较耗费资源,只删除时间线耗时较短,默认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请求体:

    {
        "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 表示成功,其他返回码表示失败,错误信息参考公共响应状态码