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 通过调用异步任务进行删除,因此不可保证时效性。