Check Dead Data¶

检测指定设备的测点数据是否为死数，同时返回测点的最后变更数据。

测点数据是否为死数判断条件：

测点最后变更数据的时间戳与系统当前时间相比大于指定的时间间隔（interval）。
若指定测点的数据不存在，不返回数据。

请求格式¶

POST https://{apigw-address}/tsdb-service/v2.1/data/latest/check-dead

请求参数（URI）¶

名称	位置（Path/Query）	必需/可选	数据类型	描述
orgId	Query	必需	String	资产所属的 OU ID。如何获取 orgId 信息 >>

请求参数（Body）¶

名称	必需/可选	数据类型	描述
payload	必需	List<JSONObject>	请求体，包含资产 ID、测点 ID、时间间隔等查询条件。详见 payload 结构体 >>

payload¶

名称	必需/可选	数据类型	描述
assetId	必需	String	资产 ID。如何获取 Asset ID 信息 >>
pointId	必需	String	资产测点 ID。如何获取 pointId 信息 >>
interval	必需	Integer	指定测点最后变更数据的时间戳与系统当前时间相比较的时间间隔，单位为毫秒。

响应参数¶

名称	数据类型	描述
items	List<JSONObject>	测点数据是否为死数检测结果。详见 items

items¶

名称	数据类型	描述
assetId	String	资产 ID。
pointId	String	资产测点 ID。
duration	Integer	测点数据未变更的持续时长。
judgeResult	Boolean	判断结果。`true` 表示测点数据为死数，`false` 表示测点数据不是死数。
lastChangedValue	Double	测点的最后变更数据。
lastChangedTimestamp	Long	测点最后变更数据时间戳，UNIX 时间，精确到毫秒。

示例¶

请求示例¶

url: https://{apigw-address}/tsdb-service/v2.1/data/latest/check-dead?orgId=yourOrgId

method: POST

Content-Type: application/json

requestBody:
{
  "payload": [
    {
      "assetId": "yourAssetId",
      "pointId": "yourPointId",
      "interval": 864000000
    }
  ]
}

返回示例¶

{
  "msg": "OK",
  "code": 0,
  "data": {
    "items": [
      {
        "assetId": "yourAssetId",
        "pointId": "yourPointId",
        "duration": 1076897472,
        "judgeResult": true,
        "lastChangedValue": "1",
        "lastChangedTimestamp": 1610667000000
      },
      {
        "assetId": "yourAssetId",
        "pointId": "yourPointId",
        "duration": 1106897472,
        "judgeResult": true,
        "lastChangedValue": "1",
        "lastChangedTimestamp": 1610637000000
      },
      {
        "assetId": "yourAnotherAssetId",
        "pointId": "yourPointId",
        "duration": 1105757472,
        "judgeResult": true,
        "lastChangedValue": "29",
        "lastChangedTimestamp": 1610638140000
      }
    ]
  },
  "submsg": ""
}

SDK 示例¶

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