S3 - AWS IoT Core
PersyaratanParameter-parameterContoh-contohLihat juga

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

S3

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

Persyaratan

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.

    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 di Panduan Pengembang Layanan Penyimpanan Sederhana Amazon.

Parameter-parameter

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

bucket

Bucket Amazon S3 untuk menulis data.

Mendukung template substitusi: 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.

Mendukung template substitusi: Tidak

key

Jalur ke file tempat data ditulis.

Pertimbangkan contoh di mana parameter ini berada ${topic()}/${timestamp()} dan aturan menerima pesan di mana topiknya beradasome/topic. Jika stempel waktu saat ini1460685389, maka tindakan ini menulis data ke file yang dipanggil 1460685389 di some/topic folder bucket S3.

catatan

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: Ya

roleArn

Peran IAM yang memungkinkan akses ke bucket Amazon S3. Untuk informasi selengkapnya, lihat Persyaratan.

Mendukung template substitusi: Tidak

Contoh-contoh

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": "my-bucket", 
                    "cannedacl": "public-read",
                    "key": "${topic()}/${timestamp()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_s3"
                }
            }
        ]
    }
}

Lihat juga