

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

# でアセットプロパティ通知を有効にする AWS IoT SiteWise
<a name="property-notifications"></a>

プロパティ通知を有効にしてアセットデータの更新を に発行し AWS IoT Core、データに対してクエリを実行できます。アセットプロパティ通知を使用すると、 は Amazon S3 に AWS IoT SiteWise データをエクスポートするために使用できる CloudFormation テンプレート AWS IoT SiteWise を提供します。

**注記**  
アセットデータは、値が変更されたかどうかにかかわらず AWS IoT SiteWise、 によって受信される AWS IoT Core たびに に送信されます。

**Topics**
+ [アセットプロパティ通知を有効化 (コンソール)](#enable-property-notifications-console)
+ [アセットプロパティ通知を有効化 (AWS CLI)](#enable-property-notifications-cli)

## アセットプロパティ通知を有効化 (コンソール)
<a name="enable-property-notifications-console"></a>

デフォルトでは、 AWS IoT SiteWise はプロパティ値の更新を発行しません。 AWS IoT SiteWise コンソールを使用して、アセットプロパティの通知を有効にできます。

**アセットプロパティの通知を有効または無効にするには (コンソール)**

1. <a name="sitewise-open-console"></a>[AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。

1. <a name="sitewise-choose-assets"></a>ナビゲーションペインで [**アセット**] を選択します。

1. アセットを選択して、プロパティの通知を有効にします。
**ヒント**  <a name="sitewise-expand-asset-hierarchy"></a>
矢印アイコンを選択して、アセット階層を展開してアセットを検索できます。

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

1. アセットプロパティの [**通知ステータス**] で、[**有効**] を選択します。  
![\[AWS IoT SiteWise 「通知ステータス」が強調表示された「アセットの編集」ページのスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/iot-sitewise/latest/userguide/images/sitewise-enable-property-notifications-console.png)

   また、[**無効**] を選択して、アセットプロパティの通知を無効にすることもできます。

1. **[保存]** を選択します。

## アセットプロパティ通知を有効化 (AWS CLI)
<a name="enable-property-notifications-cli"></a>

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

この手順を完了するには、アセットの `assetId` とプロパティの `propertyId` を知っている必要があります。外部 ID を使用することもできます。アセットを作成したが、その `assetId` がわからない場合は、[ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html) API を使用して、特定のモデルのすべてのアセットを一覧表示します。[DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) オペレーションを使用して、プロパティ ID を含むアセットのプロパティを表示します。

[UpdateAssetProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetProperty.html) オペレーションを使用して、アセットプロパティの通知を有効または無効にします。以下のパラメータを指定します。
+ `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": {}
       }
     }
   }
   ```

1. アセットプロパティの通知を有効にするには、次のコマンドを実行します。*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` を渡して、アセットプロパティの通知を無効にすることもできます。