查詢歷史資產性質值 - 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— 篩選結果的品質：GOODBAD、或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. 如果存在更多值項目，您可以將分頁 Token 從nextToken欄位傳遞至後續呼叫GetAssetPropertyValueHistory作業。