Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

Tindakan S3 (`s3`) menulis data dari pesan MQTT ke bucket Amazon Simple Storage Service (Amazon S3). 

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

Tindakan aturan ini memiliki persyaratan sebagai berikut:
+ Peran IAM yang AWS IoT dapat diasumsikan untuk melakukan `s3:PutObject` operasi. Untuk informasi selengkapnya, lihat [Memberikan AWS IoT aturan akses yang dibutuhkannya](iot-create-role.md).

  Di AWS IoT konsol, Anda dapat memilih atau membuat peran untuk memungkinkan AWS IoT untuk melakukan tindakan aturan ini.
+ Jika Anda menggunakan AWS KMS customermanaged AWS KMS key untuk mengenkripsi data saat istirahat di Amazon S3, layanan harus memiliki izin untuk menggunakan AWS KMS key atas nama pemanggil. Untuk informasi selengkapnya, lihat [AWS dikelola AWS KMS keys dan dikelola pelanggan AWS KMS keys](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html#aws-managed-customer-managed-cmks) di *Panduan Pengembang Layanan Penyimpanan Sederhana Amazon*.

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

Saat Anda membuat AWS IoT aturan dengan tindakan ini, Anda harus menentukan informasi berikut:

`bucket`  
Bucket Amazon S3 untuk menulis data.  
Mendukung [template substitusi](iot-substitution-templates.md): API dan hanya AWS CLI 

`cannedacl`  
(Opsional) Amazon S3 memasukkan ACL yang mengontrol akses ke objek yang diidentifikasi oleh kunci objek. Untuk informasi selengkapnya, termasuk nilai yang diizinkan, lihat [ACL Kalengan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#canned-acl).   
Mendukung [template substitusi](iot-substitution-templates.md): Tidak

`key`  
Jalur ke file tempat data ditulis.  
Pertimbangkan contoh di mana parameter ini berada `${topic()}/${timestamp()}` dan aturan menerima pesan di mana topiknya berada`some/topic`. Jika stempel waktu saat ini`1460685389`, maka tindakan ini menulis data ke file yang dipanggil `1460685389` di `some/topic` folder bucket S3.  
Jika Anda menggunakan kunci statis, AWS IoT timpa satu file setiap kali aturan dipanggil. Kami menyarankan Anda menggunakan stempel waktu pesan atau pengenal pesan unik lainnya sehingga file baru disimpan di Amazon S3 untuk setiap pesan yang diterima.
Mendukung [template substitusi](iot-substitution-templates.md): Ya

`roleArn`  
Peran IAM yang memungkinkan akses ke bucket Amazon S3. Untuk informasi selengkapnya, lihat [Persyaratan](#s3-rule-action-requirements).  
Mendukung [template substitusi](iot-substitution-templates.md): Tidak

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

Contoh JSON berikut mendefinisikan tindakan S3 dalam aturan. AWS IoT 

```
{
    "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"
                }
            }
        ]
    }
}
```

## Lihat juga
<a name="s3-rule-action-see-also"></a>
+ [Apa itu Amazon S3?](https://docs.aws.amazon.com/AmazonS3/latest/userguide/) di *Panduan Pengguna Layanan Penyimpanan Sederhana Amazon*