查询历史资产属性值 - AWS IoT SiteWise

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

查询历史资产属性值

您可以使用该 AWS IoT SiteWise APIGetAssetPropertyValueHistory操作来查询资产属性的历史值。

要标识资产属性，请指定以下选项之一：

  • 数据发送到propertyId的资产属性的assetId和。

  • propertyAlias，这是一个数据流别名（例如，/company/windfarm/3/turbine/7/temperature）。要使用此选项，您必须首先设置资产属性的别名。要设置属性别名，请参见将工业数据流映射到资产属性。

传递以下参数以优化结果：

  • startDate— 查询历史数据范围的唯一起始点，以 Unix 纪元时间（以秒为单位）表示。

  • endDate – 查询历史数据范围的结束端，以 Unix 纪元时间（以秒为单位）表示。

  • maxResults – 一个请求中要返回的最大结果数。默认为 20 结果。

  • nextToken – 从此操作的上一次调用返回的分页标记。

  • timeOrdering – 应用于返回值的顺序：ASCENDING 或 DESCENDING。

  • qualities – 筛选结果的质量分为：GOOD、BAD 或 UNCERTAIN。

要查询资产属性的价值历史记录 (AWS CLI)

  1. 运行以下命令以获取资产属性的值历史记录。此命令将查询特定 10 分钟间隔内的属性历史记录。Replace（替换） asset-id 附上资产的 ID 和 property-id 并附上房产的 ID。将日期参数替换为要查询的时间间隔。

    aws iotsitewise get-asset-property-value-history \
  --asset-id asset-id \
  --property-id property-id \
  --start-date 1575216000 \
  --end-date 1575216600

    该操作返回的响应包含该属TQVs性的历史记录，格式如下：

    {
  "assetPropertyValueHistory": [
    {
      "value": {
        "booleanValue": Boolean,
        "doubleValue": Number,
        "integerValue": Number,
        "stringValue": "String"
      },
      "timestamp": {
        "timeInSeconds": Number,
        "offsetInNanos": Number
      },
      "quality": "String"
    }
  ],
  "nextToken": "String"
}

  2. 如果存在更多值条目，则可以将分页令牌从nextToken字段传递给后续的GetAssetPropertyValueHistory操作调用。