View a markdown version of this page

SNS - AWS IoT Core
VoraussetzungenParametersBeispieleWeitere Informationen finden Sie auch unter

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

SNS

Die Aktion SNS (sns) sendet die Daten aus einer MQTT-Nachricht als Amazon Simple Notification Service (Amazon SNS) Push-Nachricht.

Sie können einem Tutorial folgen, das Ihnen veranschaulicht, wie Sie eine Regel mit einer SNS-Aktion erstellen und testen. Weitere Informationen finden Sie unter Tutorial: Senden einer Amazon SNS-Benachrichtigung.

Anmerkung

Die SNS-Aktion unterstützt keine Amazon SNS-FIFO () -Themen. First-In-First-Out Da die Regeln-Engine ein vollständig verteilter Dienst ist, gibt es keine Garantie für die Reihenfolge der Nachrichten, wenn die SNS-Aktion aufgerufen wird.

Voraussetzungen

Diese Regelaktion hat die folgenden Anforderungen:

  • Eine IAM-Rolle, die die Ausführung des AWS IoT Vorgangs übernehmen kann. sns:Publish Weitere Informationen finden Sie unter Gewährung einer AWS IoT regeln Sie den Zugriff, den es benötigt.

    In der AWS IoT Konsole können Sie eine Rolle auswählen oder erstellen, die AWS IoT die Ausführung dieser Regelaktion ermöglicht.

  • Wenn Sie einen vom AWS KMS Kunden verwalteten Dienst verwenden AWS KMS key , um Daten im Ruhezustand in Amazon SNS zu verschlüsseln, muss der Dienst die Erlaubnis haben, dies im Namen des Anrufers AWS KMS key zu verwenden. Weitere Informationen dazu erhalten Sie unter Schlüsselverwaltung im Entwicklerhandbuch für Amazon Simple Notification Service.

Parameters

Wenn Sie eine AWS IoT Regel mit dieser Aktion erstellen, müssen Sie die folgenden Informationen angeben:

targetArn

Das SNS-Thema oder das individuelle Gerät, an das die Pushbenachrichtigung gesendet wird

Unterstützt Substitutionsvorlagen: API und nur AWS CLI

messageFormat

(Optional) Das Nachrichtenformat. Amazon SNS verwendet diese Einstellung, um zu bestimmen, ob die Nutzlast analysiert werden soll und ob die relevanten plattformspezifischen Teile der Nutzlast extrahiert werden. Zulässige Werte: JSON, RAW. Standardeinstellung: RAW.

Unterstützt Ersatzvorlagen: Nein

roleArn

Die IAM-Rolle, die den Zugriff auf SNS ermöglicht. Weitere Informationen finden Sie unter Voraussetzungen.

Unterstützt Ersatzvorlagen: Nein

Beispiele

Das folgende JSON-Beispiel definiert eine SNS-Aktion in einer AWS IoT Regel.

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

Das folgende JSON-Beispiel definiert eine SNS-Aktion mit Substitutionsvorlagen in einer Regel. 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"
                }
            }
        ]
    }
}

Weitere Informationen finden Sie auch unter