Tutorial: Formatear una notificación mediante una función AWS Lambda

Crear una nueva función de AWS Lambda.

1. En la consola de AWS Lambda, elija Create function (Crear función).

2. En Crear función, seleccione Usar un esquema.

   Busque y seleccione el esquema hello-world-python y, a continuación, elija Configurar

3. En Información básica:

   1. En Nombre de la función, escriba el nombre de esta función, format-high-temp-notification.

   2. En Rol de ejecución, seleccione Crear un nuevo rol a partir de plantillas de políticas AWS.

   3. En Nombre del rol, introduzca el nombre del nuevo rol, format-high-temp-notification-role.

   4. En Plantillas de políticas (opcional), busque y seleccione la política de publicación de Amazon SNS.

   5. Elija Crear función.

Modifique el código del esquema para formatear y enviar una notificación de Amazon SNS.

1. Tras crear la función, debería ver la página de detalles sobre el format-high-temp-notification. Si no lo hace, ábrala desde la página de Funciones de Lambda.

2. En la página de detalles de format-high-temp-notification, seleccione la pestaña Configuración y desplácese hasta el panel de códigos de funciones.

3. En la ventana Código de función, en el panel Entorno, elija el archivo Python, lambda_function.py.

4. En la ventana de códigos de funciones, elimine todo el código original del programa del esquema y sustitúyalo por este código.

   import boto3
   #
   #   expects event parameter to contain:
   #   {
   #       "device_id": "32",
   #       "reported_temperature": 38,
   #       "max_temperature": 30,
   #       "notify_topic_arn": "arn:aws:sns:us-east-1:57EXAMPLE833:high_temp_notice"
   #   }
   # 
   #   sends a plain text string to be used in a text message
   #
   #      "Device {0} reports a temperature of {1}, which exceeds the limit of {2}."
   #   
   #   where:
   #       {0} is the device_id value
   #       {1} is the reported_temperature value
   #       {2} is the max_temperature value
   #
   def lambda_handler(event, context):
   
       # Create an SNS client to send notification
       sns = boto3.client('sns')
   
       # Format text message from data
       message_text = "Device {0} reports a temperature of {1}, which exceeds the limit of {2}.".format(
               str(event['device_id']),
               str(event['reported_temperature']),
               str(event['max_temperature'])
           )
   
       # Publish the formatted message
       response = sns.publish(
               TopicArn = event['notify_topic_arn'],
               Message = message_text
           )
   
       return response

5. Elija Implementar.

En una ventana nueva, busque el nombre de recurso de Amazon (ARN) del tema de Amazon SNS del tutorial sobre cómo Tutorial: Envío de una notificación de Amazon SNS

1. En una nueva ventana, abra la página Temas de la consola Amazon SNS.

2. En la página de temas, busque el tema de notificación high_temp_notice en la lista de temas de Amazon SNS.

3. Busque el ARN del tema de notificación high_temp_notice para usarlo en el siguiente paso.

Cree un caso de prueba para la función de Lambda.

1. En la página Funciones de Lambda de la consola, en la página de detalles de format-high-temp-notification, elija Seleccionar un evento de prueba en la esquina superior derecha de la página (aunque parezca deshabilitado) y, a continuación, elija Configurar eventos de prueba.

2. En Configurar evento de prueba, seleccione Crear nuevo evento de prueba.

3. En Nombre del evento, escriba SampleRuleOutput.

4. En el editor de JSON, debajo del nombre del evento, pegue este ejemplo de documento JSON. Este es un ejemplo de lo que la regla AWS IoT enviará a la función de Lambda.

   {
     "device_id": "32",
     "reported_temperature": 38,
     "max_temperature": 30,
     "notify_topic_arn": "arn:aws:sns:us-east-1:57EXAMPLE833:high_temp_notice"
   }

5. Consulte la ventana que contiene el ARN del tema de notificación high_temp_notice y copie el valor del ARN.

6. Sustituya el valor notify_topic_arn del editor JSON por el ARN del tema de notificaciones.

   Mantenga esta ventana abierta para poder volver a utilizar este valor de ARN al crear la regla AWS IoT.

7. Seleccione Crear.

Pruebe la función con datos de ejemplo.

1. En la página de detalles format-high-temp-notification, en la esquina superior derecha de la página, confirme que aparece SampleRuleOutput junto al botón Probar. Si no es así, selecciónelo de la lista de eventos de prueba disponibles.

2. Para enviar el ejemplo de mensaje de salida de la regla a su función, elija Probar.

Abra el centro de reglas de la consola de AWS IoT.

Para empezar a crear su nueva regla en Reglas, seleccione Crear.

En la parte superior de Crear una regla:

1. En Nombre, introduzca el nombre de la regla, wx_friendly_text

   Recuerde que el nombre de una regla debe ser único en su Cuenta de AWS y región, y no puede tener espacios. Hemos utilizado un carácter de subrayado en este nombre para separar las dos palabras del nombre de la regla.

2. En Descripción, describa la regla.

   Una descripción significativa hace que sea más fácil recordar lo que hace esta regla y por qué la creó. La descripción puede ser tan larga como sea necesario, por lo que debe ser lo más detallada posible.

En Declaración de consulta de la regla de Crear una regla:

1. En la versión Uso de SQL, seleccione 2016-03-23.

2. En el cuadro de edición de la declaración de consulta de reglas, introduzca la siguiente declaración:

   SELECT 
     cast(topic(2) AS DECIMAL) as device_id, 
     temperature as reported_temperature,
     30 as max_temperature,
     'arn:aws:sns:us-east-1:57EXAMPLE833:high_temp_notice' as notify_topic_arn
   FROM 'device/+/data' WHERE temperature > 30

   Esta declaración:

   • Escucha los mensajes MQTT con un tema que coincida con el filtro de temas device/+/data y que tengan un valor temperature superior a 30.

   • Selecciona el segundo elemento de la cadena de temas, lo convierte en un número decimal y lo asigna al campo device_id.

   • Selecciona el valor del campo temperaturede la carga útil del mensaje y lo asigna al campo reported_temperature.

   • Crea un valor constante, 30, para representar el valor límite y lo asigna al campo max_temperature.

   • Crea un valor constante para el campo notify_topic_arn.

3. Consulte la ventana que contiene el ARN del tema de notificación high_temp_notice y copie el valor del ARN.

4. Sustituya el valor del ARN (arn:aws:sns:us-east- 1:57 Example833:HIGH_TEMP_NOTICE) en el editor de sentencias de consulta de reglas por el ARN del tema de notificación.

En Establecer una o más acciones:

1. Para abrir la lista de acciones de regla para esta regla, seleccione Añadir acción.

2. En Seleccionar una acción, elija Enviar un mensaje a una función de Lambda.

3. Para abrir la página de configuración de la acción seleccionada, en la parte inferior de la lista de acciones, seleccione Configurar acción.

En Acciones de configuración:

1. En Nombre de la función, elija Seleccionar.

2. Elija el formato de notificación de alta temperatura.

3. En la parte inferior de Configurar acción, seleccione Añadir acción.

4. Para crear la regla, en la parte inferior de Crear una regla, seleccione Crear regla.

En el cliente MQTT de la consola de AWS IoT, suscríbase a los temas de entrada, en este caso, device/+/data.

1. En el cliente MQTT, en Suscripciones, seleccione Suscribirse a un tema.

2. En el tema de suscripción, introduzca el tema del filtro de temas de entrada, device/+/data.

3. No cambie el resto de los valores predeterminados de los demás ajustes.

4. Elija Suscribirse al tema.

   En la columna Suscripciones, aparece device/+/data en Publicar en un tema.

Publique un mensaje en el tema de entrada con un identificador de dispositivo específico, device/32/data No puede publicar en MQTT temas que contengan caracteres comodín.

1. En el cliente MQTT, en Suscripciones, seleccione Publicar en tema.

2. En el campo Publicar, introduzca el nombre del tema de entrada,. device/32/data

3. Copie los datos de ejemplo que se muestran aquí y, en el cuadro de edición situado debajo del nombre del tema, péguelos.

   {
     "temperature": 38,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

4. Para publicar su mensaje MQTT, elija Publicar en tema.

Confirme que se envió el mensaje de texto.

1. En el cliente de MQTT, en Suscripciones, hay un punto verde junto al tema al que se ha suscrito anteriormente.

   El punto verdes indica que se han recibido uno o más mensajes nuevos desde la última vez que los consultó.

2. En Suscripciones, seleccione device/+/data para comprobar que la carga útil de los mensajes coincide con la que acaba de publicar y tiene este aspecto:

   {
     "temperature": 38,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

3. Compruebe el teléfono que utilizó para suscribirse al tema SNS y confirme que el contenido de la carga útil del mensaje tiene este aspecto:

   Device 32 reports a temperature of 38, which exceeds the limit of 30.

   Si cambia el elemento ID del tema en el tema del mensaje, recuerde que la conversión del valor topic(2) a un valor numérico sólo funcionará si ese elemento en el tema del mensaje sólo contiene caracteres numéricos.

Intente enviar un mensaje MQTT en el que la temperatura no supere el límite.

1. En el cliente MQTT, en Suscripciones, seleccione Publicar en tema.

2. En el campo Publicar, introduzca el nombre del tema de entrada,. device/33/data

3. Copie los datos de ejemplo que se muestran aquí y, en el cuadro de edición situado debajo del nombre del tema, péguelos.

   {
     "temperature": 28,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

4. Para enviar su mensaje MQTT, seleccione Publicar en tema.

Debería ver el mensaje que envió en la suscripción device/+/data; sin embargo, como el valor de la temperatura está por debajo de la temperatura máxima en la sentencia de consulta de la regla, no debería recibir un mensaje de texto.

Si no observa el comportamiento correcto, consulte los consejos para la solución de problemas.