本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 中查詢歷史資產屬性值 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) 操作來查詢資產屬性的歷史值。

若要識別資產屬性，請指定下列其中一項：
+ 資料傳送到的資產屬性`propertyId`的 `assetId`和 。
+ `propertyAlias`，這是資料串流別名 （例如 `/company/windfarm/3/turbine/7/temperature`)。若要使用這個選項，您必須先設定您的資產屬性別名。若要設定屬性別名，請參閱 [管理 的資料串流 AWS IoT SiteWise](manage-data-streams.md)。

傳遞下列參數以精簡您的結果：
+ `startDate` – 查詢歷史資料範圍的專屬起點，以秒為單位，以 Unix epoch 時間表示。
+ `endDate` – 查詢歷史資料範圍的包含端點，以秒為單位，以 Unix epoch 時間表示。
+ `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) 操作的後續呼叫。