の履歴アセットプロパティ値をクエリする 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 - 1 回のリクエストで返す結果の最大数。デフォルトは 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

    オペレーションは、プロパティの履歴 TQV を含むレスポンスを次の形式で返します。

    {
  "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 オペレーションへの後続の呼び出しに渡します。