Firehose

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

Voraussetzungen

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.

  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 im Amazon Data Firehose Developer Guide.

Parameter

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 PutRecordBatch 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: Nein

deliveryStreamName

Der Firehose-Stream, in den die Nachrichtendaten geschrieben werden sollen.

Unterstützt Ersatzvorlagen: 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: Nein

roleArn

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

Unterstützt Ersatzvorlagen: Nein

Beispiele

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

• Was ist Amazon Data Firehose? im Amazon Data Firehose Developer Guide