View a markdown version of this page

Firehose - AWS IoT Core
VoraussetzungenParametersBeispieleWeitere 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.

Firehose

Die Firehose (firehose) -Aktion 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ährung einer AWS IoT regeln Sie den Zugriff, den es benötigt.

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

  • Wenn Sie Firehose verwenden, um Daten an einen Amazon S3-Bucket AWS KMS key zu senden, und Sie einen AWS KMS Kunden verwenden, der die Verschlüsselung ruhender Daten in Amazon S3 verwaltet, muss Firehose Zugriff auf Ihren Bucket haben und die Erlaubnis haben, ihn im Namen des AWS KMS key Anrufers zu verwenden. Weitere Informationen finden Sie im Amazon Data Firehose Developer Guide unter Firehose Zugriff auf ein Amazon S3-Ziel https://docs.aws.amazon.com/firehose/latest/dev/controlling-access.html#using-iam-s3 gewähren.

Parameters

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 Sie verwenden 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 Substitutionsvorlagen: API und nur AWS CLI

separator

(Optional) Ein Zeichentrennzeichen, das verwendet wird, um Datensätze zu trennen, die in den Firehose-Stream 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 Regel. AWS IoT 

{
    "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 Substitutionsvorlagen in einer Regel. AWS IoT 

{
    "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