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.

# Firehose
<a name="kinesis-firehose-rule-action"></a>

Die Aktion Firehose (`firehose`) sendet Daten aus einer MQTT-Nachricht an einen Amazon Data Firehose-Stream. 

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

Diese Regelaktion hat die folgenden Anforderungen:
+ Eine IAM-Rolle, die die Ausführung des AWS IoT Vorgangs übernehmen kann. `firehose:PutRecord` 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 Firehose verwenden, um Daten an einen Amazon S3-Bucket zu senden, und Sie einen AWS KMS Kunden verwenden, der es geschafft hat, ruhende Daten in Amazon S3 AWS KMS key zu verschlüsseln, muss Firehose Zugriff auf Ihren Bucket und die Erlaubnis haben, diesen im Namen des AWS KMS key Anrufers zu verwenden. Weitere Informationen finden Sie unter [Grant Firehose access to a Amazon S3 destination](https://docs.aws.amazon.com/firehose/latest/dev/controlling-access.html#using-iam-s3) im *Amazon Data Firehose Developer Guide*.

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

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

`batchMode`  
(Optional) Ob der Firehose-Stream als Batch bereitgestellt werden soll, indem [https://docs.aws.amazon.com/firehose/latest/APIReference/API_PutRecordBatch.html](https://docs.aws.amazon.com/firehose/latest/APIReference/API_PutRecordBatch.html) Der Standardwert ist `false`.  
Wenn `batchMode` `true` ist und die SQL-Anweisung der Regel zu einem Array ausgewertet wird, bildet jedes Array-Element einen Datensatz in der `PutRecordBatch`-Anforderung. Das resultierende Array darf nicht mehr als 500 Datensätze enthalten.   
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Nein

`deliveryStreamName`  
Der Firehose-Stream, in den die Nachrichtendaten geschrieben werden sollen.  
Unterstützt [Ersatzvorlagen:](iot-substitution-templates.md) API und nur AWS CLI 

`separator`  
(Optional) Ein Zeichentrennzeichen, das verwendet wird, um Datensätze zu trennen, die in den Firehose geschrieben wurden. Wenn Sie diesen Parameter auslassen, verwendet der Stream kein Trennzeichen. Gültige Werte: `,` (Komma), `\t` (Tab), `\n` (Newline), `\r\n` (Windows Newline).  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Nein

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

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

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

```
{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "firehose": {
                    "deliveryStreamName": "my_firehose_stream",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_firehose"
                }
            }
        ] 
    }
}
```

Das folgende JSON-Beispiel definiert eine Firehose-Aktion mit Ersatzvorlagen in einer AWS IoT Regel.

```
{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "firehose": {
                    "deliveryStreamName": "${topic()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_firehose"
                }
            }
        ]
    }
}
```

## Weitere Informationen finden Sie auch unter
<a name="kinesis-firehose-rule-action-see-also"></a>
+ [Was ist Amazon Data Firehose?](https://docs.aws.amazon.com/firehose/latest/dev/) im *Amazon Data Firehose Developer Guide*