Habilitar las notificaciones de propiedades de los activos (AWS CLI)

De forma predeterminada, AWS IoT SiteWise no publica las actualizaciones del valor de la propiedad. Puede utilizar el AWS Command Line Interface (AWS CLI) para activar o desactivar las notificaciones de una propiedad de un activo.

Debe conocer los assetId de sus activos y los propertyId de las propiedades para completar este procedimiento. También puede utilizar el identificador externo. Si has creado un activo y no lo sabesassetId, usa la ListAssetsAPI para enumerar todos los activos de un modelo específico. Utilice la DescribeAssetoperación para ver las propiedades de su activo, incluidos los identificadores de propiedad.

Utilice la UpdateAssetPropertyoperación para activar o desactivar las notificaciones de una propiedad de un activo. Especifique los siguientes parámetros:

• assetId: el ID del activo.

• propertyId: el ID de la propiedad del activo.

• propertyNotificationState: el estado de notificación del valor de la propiedad, ENABLED o DISABLED.

• propertyAlias: el alias de la propiedad. Especifique el alias existente de la propiedad cuando actualice el estado de notificación. Si omite este parámetro, se elimina el alias existente de la propiedad.

Para habilitar o desactivar las notificaciones de la propiedad de un activo (CLI)

1. Ejecute el siguiente comando para recuperar el alias de la propiedad del activo. Reemplace asset-id por el ID del activo y property-id por el ID de la propiedad.

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

   La operación devuelve una respuesta que contiene detalles de la propiedad del activo en el siguiente formato. El alias de propiedad se encuentra en assetProperty.alias en el objeto JSON.

   {
     "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. Ejecute el siguiente comando para habilitar las notificaciones de la propiedad del activo. Reemplace property-alias por el alias de propiedad de la respuesta del comando anterior u omita --property-alias para actualizar la propiedad sin un alias.

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

   También puede pasar --property-notification-state DISABLED para desactivar las notificaciones de la propiedad del activo.