Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
SNS
La acción SNS (sns
) envía los datos de un mensaje MQTT como una notificación push de Amazon Simple Notification Service (Amazon SNS).
Puede seguir un tutorial que le muestra cómo crear y probar una regla con una acción SNS. Para obtener más información, consulte Tutorial: Envío de una notificación de Amazon SNS.
nota
La acción SNS no es compatible con los temas FIFO (First-In-First-Out) de Amazon SNS. Dado que el motor de reglas es un servicio totalmente distribuido, no se garantiza el orden de los mensajes cuando se invoca la acción SNS.
Requisitos
Esta regla tiene los siguientes requisitos:
-
Un rol de IAM que AWS IoT puede asumir para realizar la operación.
sns:Publish
Para obtener más información, consulte Otorgar a una AWS IoT regla el acceso que requiere.En la AWS IoT consola, puede elegir o crear un rol que permita AWS IoT realizar esta acción de regla.
-
Si utilizas un AWS KMS servicio gestionado por el cliente AWS KMS key para cifrar los datos en reposo en Amazon SNS, el servicio debe tener permiso para utilizarlos AWS KMS key en nombre de la persona que llama. Para obtener más información, consulte Gestión de claves en la Guía para desarrolladores de Amazon Simple Notification Service.
Parámetros
Al crear una AWS IoT regla con esta acción, debe especificar la siguiente información:
targetArn
-
El tema de SNS o el dispositivo individual al que se enviará la notificación de inserción.
Admite plantillas de sustitución: API y AWS CLI únicamente
messageFormat
-
(Opcional) El formato del mensaje. Amazon SNS utiliza esta configuración para determinar si la carga debe analizarse y las partes pertinentes de la carga específicas de la plataforma deben extraerse. Valores válidos:
JSON
,RAW
. El valor predeterminado esRAW
.Admite plantillas de sustitución: No
roleArn
-
El rol de IAM que permite obtener acceso a SNS. Para obtener más información, consulte Requisitos.
Admite plantillas de sustitución: No
Ejemplos
El siguiente ejemplo de JSON define una acción de SNS en una AWS IoT regla.
{ "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-east-2:123456789012:my_sns_topic", "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sns" } } ] } }
El siguiente ejemplo de JSON define una acción de SNS con plantillas de sustitución en una AWS IoT regla.
{ "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-east-1:123456789012:${topic()}", "messageFormat": "JSON", "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sns" } } ] } }
Véase también
-
¿Qué es Amazon Simple Notification Service? en la Guía para desarrolladores de Amazon Simple Notification Service