Delete Point Metadata

删除 TSDB Schema 中不需要的 Measurement。

备注

如需使用该 API,确保当前环境中已安装 2.3 CU 2。有关 2.3 CU 2 的功能变更列表,参见 2.3 CU 2

操作权限

需授权的资源

所需操作权限

资产

Write

有关各资源及其对应的权限,参考 策略,角色,与权限>>

请求格式

POST https://{apigw-address}/tsdb-service/v2.1/data/meta-delete

请求参数(URI)

名称

位置(Path/Query)

必需/可选

数据类型

描述

orgId

Query

必需

String

资产所属的组织 ID。如何获取orgId信息>>

请求参数(Body)

名称

必需/可选

数据类型

描述

modelId

必需

String

模型 ID,非空 如何获取modelId信息>>

pointId

必需

String

待删除测点,非空 如何获取pointId信息>>

错误码

有关错误码的描述,参见 通用错误码

示例

请求示例

url: https://{apigw-address}/tsdb-service/v2.1/data/meta-delete?orgId=yourOrgId

method: POST

Content-type: application/json

requestBody:
{
    "modelId":"yourModelId",
    "pointId":"yourPointId"
}

返回示例

{
    "code": 0,
    "msg": "OK",
    "submsg": "success",
    "data": 428587615112032256
}

备注

  • Measurement 对应的历史数据需要用户进行删除操作,否则重新创建该测点后可能查询到旧数据或者出现查询失败的情况。

  • 需确认该 Measurement 没有数据继续上送,否则会导致删除失败。

  • 调用该 API 后会校验测点的存储策略是否取消,因此需确认测点存储策略已取消。

  • Open API 通过调用异步任务进行删除,因此不可保证时效性。