属性値を更新する

アセットは、属性のデフォルト値を含むアセットモデルの属性を継承します。場合によっては、アセットメーカーのプロパティなど、アセットモデルのデフォルト属性をそのままにしておくこともできます。また、アセットの緯度と経度など、継承された属性を更新することもできます。

Updating an attribute value (console)

AWS IoT SiteWise コンソールを使用して、属性アセットプロパティの値を更新できます。

属性の値を更新するには (コンソール)

1. AWS IoT SiteWise コンソールに移動します。

2. ナビゲーションペインで [Assets (アセット) ] を選択します。

3. 属性を更新するアセットを選択します。

   ヒント

   矢印アイコンを選択して、アセット階層を展開してアセットを検索できます。

4. [編集] を選択します。

5. 更新する属性を検索し、新しい値を入力します。

   

6. [Save] を選択します。

Updating an attribute value (AWS CLI)

AWS Command Line Interface （AWS CLI) を使用して属性値を更新できます。

この手順を完了するには、アセットの assetId とプロパティの propertyId を知っている必要があります。外部 ID を使用することもできます。アセットを作成し、その がわからない場合はassetId、 を使用して特定のモデルのすべてのアセットをListAssetsAPI一覧表示します。DescribeAsset オペレーションを使用して、プロパティ を含むアセットのプロパティを表示しますIDs。

BatchPutAssetPropertyValue オペレーションを使用して、属性値をアセットに割り当てます。このオペレーションを使用すると、複数の属性を一度に設定できます。このオペレーションのペイロードにはエントリのリストが含まれ、各エントリにはアセット ID、プロパティ ID、属性値が含まれます。

属性の値を更新するには (AWS CLI）

1. という名前のファイルbatch-put-payload.jsonを作成し、次のJSONオブジェクトを ファイルにコピーします。このペイロードの例は、風力タービンの緯度と経度を設定する方法を示しています。IDs、値、タイムスタンプを更新して、ユースケースのペイロードを変更します。

   {
     "entries": [
       {
         "entryId": "windfarm3-turbine7-latitude",
         "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
         "propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
         "propertyValues": [
           {
             "value": {
               "doubleValue": 47.6204
             },
             "timestamp": {
               "timeInSeconds": 1575691200
             }
           }
         ]
       },
       {
         "entryId": "windfarm3-turbine7-longitude",
         "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
         "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE",
         "propertyValues": [
           {
             "value": {
               "doubleValue": 122.3491
             },
             "timestamp": {
               "timeInSeconds": 1575691200
             }
           }
         ]
       }
     ]
   }

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

   • 属性値を設定するには、各属性プロパティpropertyValuesの のリストに 1 つの timestamp-quality-value （TQV) 構造を含めることができます。この構造には、新しい value および現在の timestamp を含める必要があります。

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

       • booleanValue

       • doubleValue

       • integerValue

       • stringValue

     • timestamp – 現在の Unix エポック時間を秒単位で含む構造timeInSeconds。. AWS IoT SiteWise は、過去 7 日以上または今後 5 分より新しいタイムスタンプを持つデータポイントを拒否します。

   のペイロードを準備する方法の詳細については、BatchPutAssetPropertyValue「」を参照してくださいを使用してデータを取り込む AWS IoT SiteWise API。

2. 次のコマンドを実行して、属性値を に送信します AWS IoT SiteWise。

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