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 es RAW.

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

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