SNS - AWS IoT Core
VoraussetzungenParameterBeispieleWeitere 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 (AmazonSNS) -Push-Benachrichtigung.

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

Anmerkung

Die SNS Aktion unterstützt keine Amazon-Themen SNS FIFO (First-In-First-Out). Da es sich bei der Regel-Engine um einen vollständig verteilten Service handelt, 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 sns:Publish Vorgangs übernehmen AWS IoT kann. Weitere Informationen finden Sie unter Gewähren Sie einer AWS IoT Regel den Zugriff, den sie benötigt.

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

  • Wenn Sie einen vom AWS KMS Kunden verwalteten Dienst AWS KMS key zur Verschlüsselung ruhender Daten bei Amazon verwendenSNS, muss der Service über die Erlaubnis verfügen, den im Namen des AWS KMS key Anrufers zu verwenden. Weitere Informationen dazu erhalten Sie unter Schlüsselverwaltung im Entwicklerhandbuch für Amazon Simple Notification Service.

Parameter

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

targetArn

Das SNS Thema oder das einzelne Gerät, an das die Push-Benachrichtigung gesendet wird.

Unterstützt Ersatzvorlagen: API und nur AWS CLI

messageFormat

(Optional) Das Nachrichtenformat. Amazon SNS verwendet diese Einstellung, um zu bestimmen, ob die Payload analysiert werden soll und ob relevante plattformspezifische Teile der Payload extrahiert werden sollen. 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 Aktion in einer SNS Regel. 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"
                }
            }
        ]
    }
}

Das folgende JSON Beispiel definiert eine SNS Aktion mit Ersatzvorlagen 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-1:123456789012:${topic()}",
                    "messageFormat": "JSON",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sns"
                }
            }
        ]
    }
}

Weitere Informationen finden Sie auch unter