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

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

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

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

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

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

  • propertyAlias，这是一个数据流别名（例如，/company/windfarm/3/turbine/7/temperature）。要使用此选项，您必须首先设置资产属性的别名。要设置属性别名，请参阅管理数据流 AWS IoT SiteWise。

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

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

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

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

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

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

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

要查询资产属性的值历史记录（AWS CLI），请执行以下步骤：

  1. 运行以下命令以获取资产属性的值历史记录。此命令将查询特定 10 分钟间隔内的属性历史记录。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",
        "nullValue": {
            "valueType": "String"
        }
      },
      "timestamp": {
        "timeInSeconds": Number,
        "offsetInNanos": Number
      },
      "quality": "String"
    }
  ],
  "nextToken": "String"
}

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