API を使用してデータを取り込む AWS IoT SiteWise - AWS IoT SiteWise

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

API を使用してデータを取り込む AWS IoT SiteWise

AWS IoT SiteWise API を使用して、タイムスタンプ付きの産業データをアセットの属性および測定プロパティに送信します。API は timestamp-quality-value (TQV) 構造を含むペイロードを受け入れます。

BatchPutAssetPropertyValueオペレーションを使用してデータをアップロードします。この操作では、複数のデータエントリを一度にアップロードして複数のデバイスからデータを収集し、そのすべてを 1 回のリクエストで送信できます。

重要

BatchPutAssetPropertyValueこの操作には以下のクォータが適用されます。

  • 1 リクエストあたりのエントリ数: 最大 10。

  • 1 エントリあたりのプロパティ値 (TQV データポイント) 数: 最大 10。

  • AWS IoT SiteWise 過去 7 日以上、またはfuture の 10 分を超えるタイムスタンプのデータはすべて拒否されます。

これらのクォータの詳細については、API BatchPutAssetPropertyValueリファレンスのを参照してください。AWS IoT SiteWise

アセットプロパティを識別するには、次のいずれかを指定します。

  • データの送信先となるアセットプロパティの AND。assetId propertyId

  • データストリームのエイリアスである propertyAlias (例えば、/company/windfarm/3/turbine/7/temperature)。このオプションを使用するには、最初にアセットプロパティのエイリアスを設定する必要があります。プロパティエイリアスを設定するには、を参照してくださいアセットプロパティへの産業データストリームのマッピング

次の例は、JSON ファイルに格納されているペイロードから風力タービンの温度と 1 分あたりの回転数 (RPM) の読み取り値を送信する方法を示しています。

aws iotsitewise batch-put-asset-property-value --cli-input-json file://batch-put-payload.json

batch-put-payload.json のペイロードの例には、次のコンテンツが含まれています。

{ "entries": [ { "entryId": "unique entry ID", "propertyAlias": "/company/windfarm/3/turbine/7/temperature", "propertyValues": [ { "value": { "integerValue": 38 }, "timestamp": { "timeInSeconds": 1575691200 } } ] }, { "entryId": "unique entry ID", "propertyAlias": "/company/windfarm/3/turbine/7/rpm", "propertyValues": [ { "value": { "doubleValue": 15.09 }, "timestamp": { "timeInSeconds": 1575691200 }, "quality": "GOOD" } ] } ] }

ペイロードの各エントリには、一意の文字列として定義できる entryId が含まれています。リクエストのエントリが失敗した場合、各エラーには、対応するリクエストの entryId が含まれるため、再試行するリクエストを確認できます。

リスト内の各構造体は、a、a timestamp、およびオプションで a value を含む timestamp-quality-value (TQV) propertyValues 構造です。quality

  • value - 設定中のプロパティの型に応じて、次のいずれかのフィールドを含む構造。

    • booleanValue

    • doubleValue

    • integerValue

    • stringValue

  • timestamp エポック時間からの現在の UNIX エポック時刻 (秒単位) を含む構造。timeInSeconds時間的に正確なデータがある場合は、offsetInNanostimestamp構造にキーを設定することもできます。 AWS IoT SiteWise 過去 7 日以上経過した、またはfuture の 10 分を超えるタイムスタンプのデータポイントをすべて拒否します。

  • quality -(オプション) 次の品質の文字列のいずれか。

    • GOOD - (デフォルト) データはいずれの問題による影響も受けません。

    • BAD - データはセンサーの障害などの問題による影響を受けます。

    • UNCERTAIN - データはセンサーの不正確さなどの問題による影響を受けます。

    AWS IoT SiteWise 計算におけるデータ品質の処理方法の詳細については、「数式におけるデータ品質」を参照してください。