Turn on asset property notifications in Amazon IoT SiteWise - Amazon IoT SiteWise
Turn on asset property notifications (console)Turn on asset property notifications (Amazon CLI)
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Turn on asset property notifications in Amazon IoT SiteWise

You can enable property notifications to publish asset data updates to Amazon IoT Core, and then run queries on the your data. With asset property notifications, Amazon IoT SiteWise provides an Amazon CloudFormation template that you can use to export Amazon IoT SiteWise data to Amazon S3.

Note

Asset data is sent to Amazon IoT Core every time it's received by Amazon IoT SiteWise, regardless of if the value has changed.

Turn on asset property notifications (console)

By default, Amazon IoT SiteWise doesn't publish property value updates. You can use the Amazon IoT SiteWise console to enable notifications for an asset property.

To enable or disable notifications for an asset property (console)

  1. Navigate to the Amazon IoT SiteWise console.

  2. In the navigation pane, choose Assets.

  3. Choose the asset to enable a property's notifications.

    Tip

    You can choose the arrow icon to expand an asset hierarchy to find your asset.

  4. Choose Edit.

  5. For the asset property's Notification status, choose ENABLED.

    Amazon IoT SiteWise "Edit asset" page screenshot with "Notification status" highlighted.

    You can also choose DISABLED to disable notifications for the asset property.

  6. Choose Save.

Turn on asset property notifications (Amazon CLI)

By default, Amazon IoT SiteWise doesn't publish property value updates. You can use the Amazon Command Line Interface (Amazon CLI) to enable or disable notifications for an asset property.

You must know your asset's assetId and property's propertyId to complete this procedure. You can also use the external ID. If you created an asset and don't know its assetId, use the ListAssets API to list all the assets for a specific model. Use the DescribeAsset operation to view your asset's properties including property IDs.

Use the UpdateAssetProperty operation to enable or disable notifications for an asset property. Specify the following parameters:

  • assetId – The asset's ID.

  • propertyId – The asset property's ID.

  • propertyNotificationState – The property value notification state: ENABLED or DISABLED.

  • propertyAlias – The alias of the property. Specify the property's existing alias when you update the notification state. If you omit this parameter, the property's existing alias is removed.

To enable or disable notifications for an asset property (CLI)

  1. Run the following command to retrieve the asset property's alias. Replace asset-id with the ID of the asset and property-id with the ID of the property.

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

    The operation returns a response that contains the asset property's details in the following format. The property alias is in assetProperty.alias in the JSON object.

    {
  "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. Run the following command to enable notifications for the asset property. Replace property-alias with the property alias from the previous command's response, or omit --property-alias to update the property without an alias.

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

    You can also pass --property-notification-state DISABLED to disable notifications for the asset property.