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

# 在中查询历史资产属性值 AWS IoT SiteWise
<a name="historical-values"></a>

您可以使用 AWS IoT SiteWise API [GetAssetPropertyValueHistory](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyValueHistory.html)操作来查询资产属性的历史值。

要标识资产属性，请指定以下项之一：
+ 向其发送数据的资产属性的 `assetId` 和 `propertyId`。
+ `propertyAlias`，这是一个数据流别名（例如，`/company/windfarm/3/turbine/7/temperature`）。要使用此选项，您必须首先设置资产属性的别名。要设置属性别名，请参阅[管理数据流 AWS IoT SiteWise](manage-data-streams.md)。

传递以下参数来优化结果：
+ `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}}"
   }
   ```

1. 如果存在更多值条目，则可以将分页令牌从`nextToken`字段传递给后续的[GetAssetPropertyValueHistory](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyValueHistory.html)操作调用。