Kinesis Data Streams

Die Aktion Kinesis Data Streams (kinesis) schreibt Daten aus einer MQTT-Nachricht in Amazon Kinesis Data Streams.

Voraussetzungen

Diese Regelaktion hat die folgenden Anforderungen:

• Eine IAM-Rolle, die die Ausführung des AWS IoT Vorgangs übernehmen kann. kinesis: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 einen AWS KMS vom Kunden verwalteten AWS KMS key (KMS-Schlüssel) verwenden, um ruhende Daten in Kinesis Data Streams zu verschlüsseln, muss der Service über die Erlaubnis verfügen, den im Namen des AWS KMS key Anrufers zu verwenden. Weitere Informationen finden Sie unter Berechtigungen zur Verwendung von benutzergenerierten AWS KMS keys im Amazon Kinesis Data Streams Entwicklerhandbuch.

Parameter

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

stream

Der Kinesis Data Stream, in den die Daten geschrieben werden

Unterstützt Ersatzvorlagen: API und nur AWS CLI

partitionKey

Der Partitionsschlüssel, mit dem bestimmt wird, in welchen Shard die Daten geschrieben werden. Der Partitionsschlüssel besteht in der Regel aus einem Ausdruck (z. B. ${topic()} oder ${timestamp()}).

Unterstützt Ersatzvorlagen: Ja

roleArn

Der ARN der IAM-Rolle, die die AWS IoT Berechtigung zum Zugriff auf den Kinesis-Datenstream gewährt. Weitere Informationen finden Sie unter Voraussetzungen.

Unterstützt Ersatzvorlagen: Nein

Beispiele

Das folgende JSON-Beispiel definiert eine Kinesis Data Streams Streams-Aktion in einer AWS IoT Regel.

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "kinesis": {
                    "streamName": "my_kinesis_stream", 
                    "partitionKey": "${topic()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_kinesis"
                }
            }
        ] 
    }
}

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

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "kinesis": {
                    "streamName": "${topic()}",
                    "partitionKey": "${timestamp()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_kinesis"
                }
            }
        ]
    }
}

Weitere Informationen finden Sie auch unter

• Was ist Amazon Kinesis Data Streams? im Entwicklerhandbuch für Amazon Kinesis Data Streams