SNS - 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.

SNS

Tindakan SNS (sns) mengirimkan data dari pesan MQTT sebagai notifikasi push Amazon Simple Notification Service (Amazon SNS).

Anda dapat mengikuti tutorial yang menunjukkan cara membuat dan menguji aturan dengan tindakan SNS. Untuk informasi selengkapnya, lihat Tutorial: Mengirim notifikasi Amazon SNS.

catatan

Tindakan SNS tidak mendukung topik Amazon SNS FIFO (First-In-First-Out). Karena mesin aturan adalah layanan terdistribusi penuh, tidak ada jaminan pesanan pesan ketika tindakan SNS dipanggil.

Persyaratan

Tindakan aturan ini memiliki persyaratan sebagai berikut:

  • Peran IAM yang AWS IoT dapat diasumsikan untuk melakukan sns:Publish 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 pengelolaan-dikelola AWS KMS pelanggan AWS KMS key untuk mengenkripsi data saat istirahat di Amazon SNS, layanan harus memiliki izin untuk menggunakan AWS KMS key atas nama pemanggil. Untuk informasi selengkapnya, lihat Manajemen kunci di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon.

Parameter

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

targetArn

Topik SNS atau perangkat individual tempat notifikasi push dikirim.

Mendukung template substitusi: API dan hanya AWS CLI

messageFormat

(Opsional) Format pesan. Amazon SNS menggunakan pengaturan ini untuk menentukan apakah payload harus diuraikan dan apakah bagian khusus platform yang relevan dari payload harus diekstraksi. Nilai-nilai yang valid: JSON, RAW. Default ke RAW.

Mendukung template substitusi: Tidak

roleArn

Peran IAM yang memungkinkan akses ke SNS. Untuk informasi selengkapnya, lihat Persyaratan.

Mendukung template substitusi: Tidak

Contoh

Contoh JSON berikut mendefinisikan tindakan SNS dalam aturan. AWS IoT 

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "sns": {
                    "targetArn": "arn:aws:sns:us-east-2:123456789012:my_sns_topic", 
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sns"
                }
            }
        ]
    }
}

Contoh JSON berikut mendefinisikan tindakan SNS dengan template substitusi dalam aturan. AWS IoT 

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "sns": {
                    "targetArn": "arn:aws:sns:us-east-1:123456789012:${topic()}",
                    "messageFormat": "JSON",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sns"
                }
            }
        ]
    }
}

Lihat juga