Tutorial: Envío de una notificación de Amazon SNS

Cree un tema de Amazon SNS.

1. Inicie sesión en la consola de Amazon SNS.

2. En el panel de navegación izquierdo, elija Topics (Temas).

3. En la página Temas, elija Crear tema.

4. En Detalles, elija el tipo Estándar. De forma predeterminada, la consola crea un tema FIFO.

5. En Nombre, introduzca el nombre del tema de SNS. En este tutorial, escriba high_temp_notice.

6. Desplácese hasta el final de la página y elija Crear tema.

   En la consola se abre la página Details (Detalles) del nuevo tema.

Crear un una suscripción de Amazon SNS.

1. En la página de detalles del tema high_temp_notice, seleccione Crear suscripción.

2. En Crear suscripción, en la sección Detalles, en la lista de protocolos, selecciona SMS.

3. En punto de conexión, introduzca el número de teléfono que puede recibir mensajes de texto. Asegúrese de escribirlo de forma que comience con +, incluya el código de país y área y no incluya ningún otro carácter de puntuación.

4. Seleccione Crear una suscripción.

Pruebe la notificación de Amazon SNS.

1. En la consola de Amazon SNS, en el panel de navegación izquierdo, seleccione Temas.

2. Para abrir la página de detalles del tema, en Temas, en la lista de temas, elija high_temp_notice.

3. Para abrir la página Publicar mensaje en un tema, en la página de detalles de high_temp_notice, seleccione Publicar mensaje.

4. En Publicar mensaje en un tema, en la sección Cuerpo del mensaje, en Cuerpo del mensaje para enviar al punto de conexión, introduzca un mensaje corto.

5. Desplácese a la parte inferior de la página y seleccione Publicar mensaje.

6. En el teléfono con el número que utilizó anteriormente al crear la suscripción, confirme que ha recibido el mensaje.

Si no ha recibido el mensaje de prueba, vuelva a comprobar el número de teléfono y la configuración de su teléfono.

Asegúrese de poder publicar los mensajes de prueba desde la consola de Amazon SNS antes de continuar con el tutorial.

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

Si esta es su primera regla, elija Crear o Crear una regla.

En Crear una regla:

1. En Name (Nombre), escriba temp_limit_notify.

   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 topic(2) as device_id, 
       temperature as reported_temperature, 
       30 as max_temperature 
     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 y lo asigna al campo device_id.

   • Selecciona el campo temperature de valor de 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.

Para abrir la lista de acciones de la regla para esta regla, en Establecer una o más acciones, seleccione Añadir acción.

En Seleccionar una acción, elija Enviar un mensaje como una notificación push SNS.

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 el objetivo SNS, elija Seleccionar, busque su tema SNS llamado high_temp_notice y elija Seleccionar.

2. En Formato del mensaje, elija RAW.

3. En Elija o cree un rol para conceder acceso a AWS IoT para que realice esta acción, elija Crear rol.

4. En Crear un nuevo rol, en Nombre, escriba un nombre único para el nuevo rol. Para este tutorial, escriba sns_rule_role.

5. Elija Crear rol.

Si va a repetir este tutorial o a reutilizar un rol existente, elija Actualizar rol antes de continuar. Esto actualiza el documento de política del rol para que funcione con el objetivo de SNS.

Seleccione Añadir acción y vuelva a la página Crear una regla.

En el icono de la nueva acción, debajo de Enviar un mensaje como notificación push de SNS, puede ver el tema de SNS al que se referirá su regla.

Esta es la única acción de regla que añadirá a esta regla.

Para crear la regla y completar este paso, en Crear una regla, desplácese hasta la parte inferior y 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. Elija Publicar en tema para publicar su mensaje MQTT.

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_id":"32","reported_temperature":38,"max_temperature":30}

   Observe que el valor device_id es una cadena entre comillas y el valor temperature es numérico. Esto se debe a que la función topic() extrajo la cadena del nombre del tema del mensaje de entrada, mientras que el valor temperature utiliza el valor numérico de la carga útil del mensaje de entrada.

   Si desea convertir el valor device_id en un valor numérico, sustituya topic(2) en la declaración de consulta de reglas por:

   cast(topic(2) AS DECIMAL)

   Tenga en cuenta que la conversión del valor topic(2) a un valor numérico DECIMAL solo funcionará si esa parte del tema 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.