SNS - AWS IoT Core
RequisitosParâmetrosExemplosConsulte também

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

SNS

A ação SNS (sns) envia os dados de uma mensagem MQTT como uma notificação push do Amazon Simple Notification Service (Amazon SNS)

Você pode seguir um tutorial que mostra como criar e testar uma regra com uma ação do SNS. Para ter mais informações, consulte Tutorial:r Como enviar uma notificação do Amazon SNS.

nota

A ação do SNS não oferece suporte a tópicos FIFO (First-In-First-Out) do Amazon SNS. Como o mecanismo de regras é um serviço totalmente distribuído, não há garantia da ordem das mensagens quando a ação do SNS é invocada.

Requisitos

Esta ação de regra tem os seguintes requisitos:

  • Uma função do IAM que AWS IoT você pode assumir para realizar a sns:Publish operação. Para ter mais informações, consulte Conceder a uma AWS IoT regra o acesso que ela exige.

    No AWS IoT console, você pode escolher ou criar uma função para permitir AWS IoT a execução dessa ação de regra.

  • Se você usa um serviço gerenciado pelo AWS KMS cliente AWS KMS key para criptografar dados em repouso no Amazon SNS, o serviço deve ter permissão para usar o AWS KMS key em nome do chamador. Para obter mais informações, consulte Gerenciamento de chaves no Guia do desenvolvedor do Amazon Simple Notification Service.

Parâmetros

Ao criar uma AWS IoT regra com essa ação, você deve especificar as seguintes informações:

targetArn

O tópico do SNS ou o dispositivo individual para o qual a notificação por push é enviada.

Suporta modelos de substituição: API e somente AWS CLI

messageFormat

(Opcional) O formato da mensagem. O Amazon SNS usa essa configuração para determinar se a carga deve ser analisada e se partes relevantes específicas da plataforma da carga devem ser extraídas. Valores válidos: JSON, RAW. Padronizado como RAW.

Compatível com modelos de substituição: Não

roleArn

O perfil do IAM; que permite o acesso ao SNS. Para ter mais informações, consulte Requisitos.

Compatível com modelos de substituição: Não

Exemplos

O exemplo de JSON a seguir define uma ação do SNS em uma AWS IoT regra.

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

O exemplo de JSON a seguir define uma ação do SNS com modelos de substituição em uma regra. AWS IoT 

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

Consulte também