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'azione SNS (sns) invia i dati da un MQTT messaggio come notifica push di Amazon Simple Notification Service (AmazonSNS).

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

Nota

L'SNSazione non supporta gli argomenti di Amazon SNS FIFO (First-In-First-Out). Poiché il motore delle regole è un servizio completamente distribuito, non è garantito l'ordine dei messaggi quando l'SNSazione viene richiamata.

Requisiti

Questa operazione della regola presenta i seguenti requisiti:

  • Un IAM ruolo 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, è possibile scegliere o creare un ruolo per consentire l'esecuzione di questa azione relativa AWS IoT alla regola.

  • Se utilizzi un servizio gestito AWS KMS dal cliente AWS KMS key per crittografare i dati archiviati in AmazonSNS, il servizio deve avere l'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

L'SNSargomento o il singolo dispositivo a cui viene inviata la notifica push.

Supporta modelli sostitutivi: API e solo AWS CLI

messageFormat

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

Supporta modelli di sostituzione: no

roleArn

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

Supporta modelli di sostituzione: no

Esempi

L'JSONesempio seguente definisce un'SNSazione in una AWS IoT regola.

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

L'JSONesempio seguente definisce un'SNSazione con modelli di sostituzione in una AWS IoT regola.

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