View a markdown version of this page

SQS - 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.

SQS

Die SQS (sqs) Aktion sendet Daten von einer MQTT-Nachricht an eine Amazon Simple Queue Service (Amazon SQS) Warteschlange.

Anmerkung

Die SQS-Aktion unterstützt keine Amazon SQS FIFO () -Warteschlangen. First-In-First-Out Da die Regeln-Engine ein vollständig verteilter Service ist, gibt es keine Garantie für die Nachrichtenreihenfolge, wenn die SQS-Aktion ausgelöst wird.

Voraussetzungen

Diese Regelaktion hat die folgenden Anforderungen:

  • Eine IAM-Rolle, die die Ausführung des Vorgangs übernehmen AWS IoT kann. sqs:SendMessage 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 einen AWS KMS Kunden verwenden AWS KMS key , der Daten im Ruhezustand in Amazon SQS verschlüsseln kann, muss der Service die Erlaubnis haben, dies im Namen des AWS KMS key Anrufers zu verwenden. Weitere Informationen finden Sie unter Schlüsselverwaltung im Amazon Simple Queue Service Entwicklerhandbuch.

Parameters

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

queueUrl

Die URL der Amazon SQS-Warteschlange, in die die Daten geschrieben werden Die Region in dieser URL muss nicht mit Ihrer AWS-Region AWS IoT Regel übereinstimmen.

Anmerkung

Für die Datenübertragung AWS-Regionen unter Verwendung der SQS-Regelaktion können zusätzliche Gebühren anfallen. Weitere Informationen finden Sie unter Amazon SQS-Preise.

Unterstützt Substitutionsvorlagen: API und nur AWS CLI

useBase64

Setzen Sie diesen Parameter auf true, um die Regelaktion so zu konfigurieren, dass sie die Nachrichtendaten Base64-kodiert, bevor sie in die Amazon SQS-Warteschlange geschrieben werden. Standardeinstellung: false.

Unterstützt Ersatzvorlagen: Nein

roleArn

Die IAM-Rolle, die den Zugriff auf die Amazon SQS-Warteschlange ermöglicht. Weitere Informationen finden Sie unter Voraussetzungen.

Unterstützt Ersatzvorlagen: Nein

Beispiele

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

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "sqs": {
                    "queueUrl": "https://sqs.us-east-2.amazonaws.com/123456789012/my_sqs_queue", 
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sqs"
                }
            }
        ]
    }
}

Das folgende JSON-Beispiel definiert eine SQS-Aktion mit Substitutionsvorlagen in einer Regel. AWS IoT 

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "sqs": {
                    "queueUrl": "https://sqs.us-east-2.amazonaws.com/123456789012/${topic()}",
                    "useBase64": true,
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sqs"
                }
            }
        ]
    }
}

Weitere Informationen finden Sie auch unter