S3 - AWS IoT Core
VoraussetzungenParameterBeispieleWeitere 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.

S3

Die Aktion S3 (s3) schreibt die Daten aus einer MQTT Nachricht in einen Amazon Simple Storage Service (Amazon S3) -Bucket.

Voraussetzungen

Diese Regelaktion hat die folgenden Anforderungen:

  • Eine IAM Rolle, die die Ausführung des s3:PutObject Vorgangs übernehmen AWS IoT kann. 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 Kunden verwenden, der AWS KMS key zur Verschlüsselung ruhender Daten in Amazon S3 verwaltet wird, muss der Service über die Erlaubnis verfügen, den im Namen des AWS KMS key Anrufers zu verwenden. Weitere Informationen finden Sie unter AWS Verwaltet AWS KMS keys und vom Kunden verwaltet AWS KMS keys im Amazon Simple Storage Service Developer Guide.

Parameter

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

bucket

Der Amazon S3-Bucket, in den die Daten geschrieben werden

Unterstützt Substitutionsvorlagen: API und nur AWS CLI

cannedacl

(Optional) Der Amazon S3 S3-ScannerACL, der den Zugriff auf das durch den Objektschlüssel identifizierte Objekt steuert. Weitere Informationen, einschließlich zulässiger Werte, finden Sie unter Canned ACL.

Unterstützt Ersatzvorlagen: Nein

key

Der Pfad zur Datei, in die die Daten geschrieben werden.

Nehmen wir ein Beispiel, bei dem dieser Parameter ${topic()}/${timestamp()} ist und die Regel eine Nachricht mit dem Thema some/topic empfängt. Wenn der aktuelle Zeitstempel 1460685389 ist, dann schreibt diese Aktion die Daten in eine Datei namens 1460685389 im Ordner some/topic des S3-Buckets.

Anmerkung

Wenn Sie einen statischen Schlüssel verwenden, wird bei jedem Aufruf der Regel eine einzelne Datei AWS IoT überschrieben. Wir empfehlen Ihnen, den Zeitstempel der Nachricht oder einen anderen eindeutigen Nachrichtenbezeichner zu verwenden, damit für jede empfangene Nachricht eine neue Datei in Amazon S3 gespeichert wird.

Unterstützt Ersatzvorlagen: Ja

roleArn

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

Unterstützt Ersatzvorlagen: Nein

Beispiele

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

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "s3": {
                    "bucketName": "amzn-s3-demo-bucket", 
                    "cannedacl": "public-read",
                    "key": "${topic()}/${timestamp()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_s3"
                }
            }
        ]
    }
}

Weitere Informationen finden Sie auch unter