S3

Die S3 (s3) Aktion 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 Ersatzvorlagen: API und nur AWS CLI

cannedacl

(Optional) Die vordefinierte Amazon S3-ACL, der den Zugriff auf das Objekt steuert, das vom Objektschlüssel identifiziert wurde. Weitere Informationen, einschließlich der zulässigen Werte, finden Sie unter Vordefinierter 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-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": "my-bucket", 
                    "cannedacl": "public-read",
                    "key": "${topic()}/${timestamp()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_s3"
                }
            }
        ]
    }
}

Weitere Informationen finden Sie auch unter

• Was ist Amazon S3? im Entwicklerhandbuch für Amazon Simple Storage Service