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.

# AWS IoT Events
<a name="iotevents-rule-action"></a>

Die Aktion AWS IoT Events (`iotEvents`) sendet Daten von einer MQTT-Nachricht an eine AWS IoT Events Eingabe. 

**Wichtig**  
Wenn die Payload AWS IoT Core ohne den gesendet wird oder wenn sich der `Input attribute Key` Schlüssel nicht in demselben JSON-Pfad befindet, der im Schlüssel angegeben ist, führt dies dazu, dass die IoT-Regel mit dem Fehler `Failed to send message to Iot Events` fehlschlägt.

## Voraussetzungen
<a name="iotevents-rule-action-requirements"></a>

Diese Regelaktion hat die folgenden Anforderungen:
+ Eine IAM-Rolle, die die Ausführung des `iotevents:BatchPutMessage` Vorgangs übernehmen AWS IoT kann. 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.

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

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

`batchMode`  
(Optional) Gibt an, ob die Ereignisaktionen als Batch verarbeitet werden sollen. Der Standardwert ist `false`.  
Wenn dies der `true` Fall `batchMode` ist und die SQL-Anweisung für die Regel ein Array ergibt, wird jedes Array-Element als separate Nachricht behandelt, wenn es durch einen Aufruf [https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchPutMessage.html](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchPutMessage.html)an AWS IoT Events gesendet wird. Das resultierende Array darf nicht mehr als 10 Nachrichten enthalten.  
Wenn `batchMode` `true` ist, können Sie kein `messageId` angeben.   
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Nein

`inputName`  
Der Name der AWS IoT Events Eingabe.  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): API und nur AWS CLI 

`messageId`  
(Optional) Verwenden Sie diese Option, um zu überprüfen, ob nur eine Eingabe (Nachricht) mit einem bestimmten Wert von einem AWS IoT Events Detektor verarbeitet `messageId` wird. Sie können die `${newuuid()}` Ersatzvorlage verwenden, um für jede Anfrage eine eindeutige ID zu generieren.  
Wenn `batchMode` `true` ist, können Sie `messageId` nicht angeben--ein neuer UUID-Wert wird zugewiesen.  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja

`roleArn`  
Die IAM-Rolle, die es ermöglicht AWS IoT , eine Eingabe an einen AWS IoT Events Detektor zu senden. Weitere Informationen finden Sie unter [Voraussetzungen](#iotevents-rule-action-requirements).  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Nein

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

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

```
{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "iotEvents": {
                    "inputName": "MyIoTEventsInput",
                    "messageId": "${newuuid()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_events"
                }
            }
        ]
    }
}
```

## Weitere Informationen finden Sie auch unter
<a name="iotevents-rule-action-see-also"></a>
+ [Was ist AWS IoT Events?](https://docs.aws.amazon.com/iotevents/latest/developerguide/) im *AWS IoT Events Developer Guide*