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"
}

SDK 示例¶

你可以在 Github 上获取 TSDB 数据服务的 Java SDK 示例。