本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在中打开资产属性通知 AWS IoT SiteWise
<a name="property-notifications"></a>

您可以启用属性通知以向其发布资产数据更新 AWS IoT Core，然后对您的数据进行查询。通过资产属性通知， AWS IoT SiteWise 提供了一个可用于将 AWS IoT SiteWise 数据导出到 Amazon S3 的 CloudFormation 模板。

**注意**  
资产数据在 AWS IoT Core 每次收到时都会发送到 AWS IoT SiteWise，无论其值是否发生变化。

**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/zh_cn/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)操作查看资产的属性，包括财产 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` 以禁用资产属性的通知。