Get Data Deletion Details¶
通过指定模型ID或者测点ID,获取数据清理任务运行详情。
操作权限¶
需授权的资源 |
所需操作权限 |
---|---|
资产 |
Read |
有关各资源及其对应的权限,参考 策略,角色,与权限>>
请求格式¶
GET https://{apigw-address}/tsdb-service/v2.1/data/delete-detail
请求参数(URI)¶
名称 |
位置(Path/Query) |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|---|
orgId |
Query |
必需 |
String |
资产所属的组织ID。如何获取orgId信息>> |
queryId |
Query |
可选 |
String |
模型ID或者测点ID。如不指定,则返回组织内所有已提交的数据清理任务运行详情。 |
pageNo |
Query |
可选 |
Integer |
请求页数,从1开始。 |
pageSize |
Query |
可选 |
Integer |
每页返回记录数,必须大于0。 |
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
total |
Integer |
返回查询结果的总记录数。 |
pageNum |
Integer |
当前页数。 |
pageSize |
Integer |
每页返回记录数。 |
list |
List<JSONObject> |
数据清理任务运行结果。详见 list |
list¶
示例¶
{
"id": "290537323067711488",
"status": 2,
"modelId": "yourModelId",
"assetIds": "yourAssetIds",
"measurement": "yourPointId",
"startTime": "1615444301240",
"endTime": "1615444301240",
"launchTime": "2021-03-12T09:32:16.442+0000",
"finishTime": "2021-03-12T09:32:46.418+0000",
"operator": "user.name"
}
参数¶
名称 |
数据类型 |
描述 |
---|---|---|
id |
String |
数据清理任务ID。 |
status |
Integer |
数据清理任务运行状态。0:任务已提交;1:任务执行中;2:任务已完成;3:任务已暂停;4:任务已取消;5:任务执行失败。 |
modelId |
String |
删除数据所属的模型。 |
assetIds |
String |
删除数据所属的资产。 |
measurement |
String |
删除数据所属的测点。 |
startTime |
String |
指定的删除数据的时间范围(起始时间)。 |
endTime |
String |
指定的删除数据的时间范围(结束时间)。 |
launchTime |
Long |
数据清理任务开始运行的时间。 |
finishTime |
Long |
数据清理任务结束运行的时间。 |
operator |
String |
数据清理任务的操作人。 |
错误码¶
有关错误码的描述,参见 通用错误码。
示例¶
请求示例¶
url: https://{apigw-address}/tsdb-service/v2.1/data/delete-detail?orgId=yourOrgId&queryId=yourModelID&pageSize=10&pageNo=1
method: GET
返回示例¶
{
"msg": "OK",
"code": 0,
"data": {
"list": [
{
"id": "302037106667073536",
"status": 2,
"endTime": " 1615530701240",
"modelId": "yourModelId",
"assetIds": "yourAssetIds",
"operator": "user.name",
"startTime": "1615444301240",
"finishTime": "2021-03-12T10:37:46.353+0000",
"launchTime": "2021-03-12T10:37:16.383+0000",
"measurement": "yourPointIds"
}
],
"total": 2,
"pageNum": 1,
"pageSize": 10
},
"submsg": "success"
}