SNS - AWS IoT Core
RequisitosParámetrosEjemplosVéase también

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 MQTT mensaje como una notificación push de Amazon Simple Notification Service (AmazonSNS).

Puedes seguir un tutorial que te muestra cómo crear y probar una regla con una SNS acción. Para obtener más información, consulte Tutorial: Envío de una notificación de Amazon SNS.

nota

La SNS acción no admite temas de Amazon SNS FIFO (primero en entrar, primero en salir). Como el motor de reglas es un servicio totalmente distribuido, no se garantiza el orden de los mensajes cuando se invoca la SNS acción.

Requisitos

Esta regla tiene los siguientes requisitos:

  • Un IAM rol que AWS IoT se puede asumir para realizar la sns:Publish operación. 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 AmazonSNS, 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, debes especificar la siguiente información:

targetArn

El SNS tema o el dispositivo individual al que se envía la notificación push.

Admite plantillas de sustitución: API y AWS CLI solo

messageFormat

(Opcional) El formato del mensaje. Amazon SNS usa esta configuración para determinar si la carga útil debe analizarse y si deben extraerse las partes relevantes de la carga específica de la plataforma. 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 JSON ejemplo define una acción en una regla. SNS AWS IoT 

{
    "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"
                }
            }
        ]
    }
}

En el siguiente JSON ejemplo, se define una SNS acción 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