本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 中開啟資產屬性通知 AWS IoT SiteWise
<a name="property-notifications"></a>

您可以啟用屬性通知以發佈資產資料更新至 AWS IoT Core，然後對資料執行查詢。透過資產屬性通知， AWS IoT SiteWise 提供 CloudFormation 範本，可用來將 AWS IoT SiteWise 資料匯出至 Amazon S3。

**注意**  
無論值是否已變更 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>在導覽窗格中，選擇 **Assets (資產)**。

1. 選擇要啟用屬性通知的資產。
**提示**  <a name="sitewise-expand-asset-hierarchy"></a>
您可以選擇箭頭圖示來展開資產階層，以尋找您的資產。

1. 選擇**編輯**。

1. 針對資產屬性的 **Notification status (通知狀態)**，選擇 **ENABLED (已啟用)**。  
![\[AWS IoT SiteWise 「編輯資產」頁面螢幕擷取畫面，反白顯示「通知狀態」。\]](http://docs.aws.amazon.com/zh_tw/iot-sitewise/latest/userguide/images/sitewise-enable-property-notifications-console.png)

   您也可以選擇 **DISABLED (已停用)** 以停用資產屬性的通知。

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) 操作來檢視資產的屬性，包括屬性 IDs。

使用 [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` 以停用資產屬性的通知。