View a markdown version of this page

S3 - AWS IoT Core
PersyaratanParameterContohLihat 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 Pemberian AWS IoT mengatur akses yang dibutuhkannya.

    Di AWS IoT konsol, Anda dapat memilih atau membuat peran AWS IoT untuk memungkinkan melakukan tindakan aturan ini.

  • Jika Anda menggunakan AWS KMS customermanaged AWS KMS key untuk mengenkripsi data saat diam di Amazon S3, layanan harus memiliki izin untuk menggunakannya AWS KMS key atas nama penelepon. Untuk informasi selengkapnya, lihat AWS dikelola AWS KMS keys dan dikelola pelanggan AWS KMS keys di Panduan Pengembang Layanan Penyimpanan Sederhana Amazon.

Parameter

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

bucket

Bucket Amazon S3 untuk menulis data.

Men dukung template substitusi: API dan AWS CLI hanya

cannedacl

(Opsional) ACL otomatis Amazon S3 yang mengontrol akses ke objek yang diidentifikasi oleh kunci objek. Untuk informasi selengkapnya, termasuk nilai yang diizinkan, lihat C anned ACL.

Mendukung template substitusi: Tidak

key

Jalur ke file tempat data ditulis.

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

catatan

Jika Anda menggunakan kunci statis, AWS IoT ganti satu file setiap kali aturan dipanggil. Sebaiknya gunakan stempel waktu pesan atau pengidentifikasi pesan unik lainnya agar 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 JSON berikut mendefinisikan tindakan S3 dalam AWS IoT aturan.

{
    "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