SNS - AWS IoT Core
RequisitiParametriEsempiConsulta anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

SNS

L’operazione SNS (sns) invia i dati da un messaggio MQTT come notifica push Amazon Simple Notification Service (Amazon SNS).

È possibile seguire un tutorial che mostra come creare e testare una regola con un'operazione SNS. Per ulteriori informazioni, consulta Tutorial: invio di una SNS notifica Amazon.

Nota

L'operazione SNS non supporta Argomenti Amazon SNS FIFO (First-In-First-Out). Poiché il motore di regole è un servizio completamente distribuito, non vi è alcuna garanzia in merito all'ordine dei messaggi quando viene attivata l'operazione SNS.

Requisiti

Questa operazione della regola presenta i seguenti requisiti:

  • Un ruolo IAM che AWS IoT può assumere per eseguire l'sns:Publishoperazione. Per ulteriori informazioni, consulta Concedere a qualsiasi AWS IoT regola l'accesso richiesto.

    Nella AWS IoT console, puoi scegliere o creare un ruolo che consenta di AWS IoT eseguire questa azione relativa alla regola.

  • Se utilizzi un AWS KMS servizio gestito dal cliente AWS KMS key per crittografare i dati inattivi in Amazon SNS, il servizio deve disporre dell'autorizzazione a utilizzarlo per AWS KMS key conto del chiamante. Per maggiori informazioni, consulta Gestione delle chiavi nel Guida per gli sviluppatori di Amazon Simple Notification Service.

Parametri

Quando crei una AWS IoT regola con questa azione, devi specificare le seguenti informazioni:

targetArn

Argomento SNS o singolo dispositivo a cui viene inviata la notifica push.

Supporta modelli sostitutivi: solo API AWS CLI

messageFormat

(Opzionale) Formato del messaggio. Amazon SNS usa questa impostazione per determinare se il payload deve essere analizzato e se le parti specifiche della piattaforma rilevanti del payload devono essere estratte. Valori validi: JSON, RAW. L'impostazione predefinita è RAW.

Supporta modelli di sostituzione: no

roleArn

Il ruolo IAM che permette l'accesso a SNS. Per ulteriori informazioni, consulta Requisiti.

Supporta modelli di sostituzione: no

Esempi

Il seguente esempio JSON definisce un'azione SNS in una regola. 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"
                }
            }
        ]
    }
}

Il seguente esempio JSON definisce un'azione SNS con modelli di sostituzione in una regola. 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"
                }
            }
        ]
    }
}

Consulta anche