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
<a name="s3-rule-action"></a>

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

## Voraussetzungen
<a name="s3-rule-action-requirements"></a>

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](iot-create-role.md).

  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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html#aws-managed-customer-managed-cmks) im *Amazon Simple Storage Service Developer Guide*.

## Parameters
<a name="s3-rule-action-parameters"></a>

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](iot-substitution-templates.md): 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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#canned-acl).   
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): 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.  
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](iot-substitution-templates.md): Ja

`roleArn`  
Die IAM-Rolle, die den Zugriff auf den Amazon S3-Bucket ermöglicht. Weitere Informationen finden Sie unter [Voraussetzungen](#s3-rule-action-requirements).  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Nein

## Beispiele
<a name="s3-rule-action-examples"></a>

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
<a name="s3-rule-action-see-also"></a>
+ [Was ist Amazon S3?](https://docs.aws.amazon.com/AmazonS3/latest/userguide/) im *Entwicklerhandbuch für Amazon Simple Storage Service*