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
<a name="sns-rule-action"></a>

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](iot-sns-rule.md).

**Anmerkung**  
Die SNS-Aktion unterstützt keine [Amazon SNS-FIFO-Themen (First-In-First-Out)](https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html). 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
<a name="sns-rule-action-requirements"></a>

Diese Regelaktion hat die folgenden Anforderungen:
+ Eine IAM-Rolle, die die Ausführung des Vorgangs übernehmen AWS IoT kann. `sns:Publish` Weitere Informationen finden Sie unter [Gewähren Sie einer AWS IoT Regel den Zugriff, den sie benötigt](iot-create-role.md).

  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 in Amazon SNS verwenden, muss der Service über die Erlaubnis verfügen, den im Namen des Anrufers AWS KMS key zu verwenden. Weitere Informationen dazu erhalten Sie unter [Schlüsselverwaltung](https://docs.aws.amazon.com/sns/latest/dg/sns-key-management.html) im *Entwicklerhandbuch für Amazon Simple Notification Service*.

## Parameters
<a name="sns-rule-action-parameters"></a>

Wenn Sie mit dieser Aktion eine AWS IoT Regel 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 [Ersatzvorlagen](iot-substitution-templates.md): 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](iot-substitution-templates.md): Nein

`roleArn`  
Die IAM-Rolle, die den Zugriff auf SNS ermöglicht. Weitere Informationen finden Sie unter [Voraussetzungen](#sns-rule-action-requirements).  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Nein

## Beispiele
<a name="sns-rule-action-examples"></a>

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 Ersatzvorlagen 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
<a name="sns-rule-action-see-also"></a>
+ [Was ist Amazon Simple Notification Service?](https://docs.aws.amazon.com/sns/latest/dg/) im *Amazon Simple Notification Service-Entwicklerhandbuch*
+ [Tutorial: Senden einer Amazon SNS-Benachrichtigung](iot-sns-rule.md)