アセットプロパティ通知を有効にする (AWS CLI)

デフォルトでは、 AWS IoT SiteWise プロパティ値の更新は公開されません。 AWS Command Line Interface (AWS CLI) を使用してアセットプロパティの通知を有効または無効にできます。

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

UpdateAssetPropertyオペレーションを使用して、アセットプロパティの通知を有効または無効にします。以下のパラメータを指定します。

• assetId - アセットの ID。

• propertyId - アセットプロパティの ID。

• propertyNotificationState - プロパティ値の通知状態: ENABLED または DISABLED。

• propertyAlias - プロパティのエイリアス。通知状態を更新するときに、プロパティの既存のエイリアスを指定します。このパラメータを省略すると、プロパティの既存のエイリアスは削除されます。

アセットプロパティの通知を有効または無効にするには (CLI)

1. 次のコマンドを実行して、アセットプロパティのエイリアスを取得します。asset-id をアセットの ID に置き換え、property-id をプロパティの ID に置き換えます。

   aws iotsitewise describe-asset-property \
     --asset-id asset-id \
     --property-id property-id

   このオペレーションは、アセットプロパティの詳細を含むレスポンスを次の形式で返します。プロパティエイリアスは JSON オブジェクト assetProperty.alias にあります。

   {
     "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
     "assetName": "Wind Turbine 7",
     "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
     "assetProperty": {
       "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
       "name": "Wind Speed",
       "alias": "/company/windfarm/3/turbine/7/windspeed",
       "notification": {
         "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
         "state": "DISABLED"
       },
       "dataType": "DOUBLE",
       "unit": "m/s",
       "type": {
         "measurement": {}
       }
     }
   }

2. アセットプロパティの通知を有効にするには、次のコマンドを実行します。property-alias は、前のコマンドのレスポンスのプロパティエイリアスに置き換えるか、--property-alias を省略して、エイリアスなしでプロパティを更新します。

   aws iotsitewise update-asset-property \
     --asset-id asset-id \
     --property-id property-id \
     --property-notification-state ENABLED \
     --property-alias property-alias

   また、--property-notification-state DISABLED を渡して、アセットプロパティの通知を無効にすることもできます。