View a markdown version of this page

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

catatan

Tindakan SNS tidak mendukung topik Amazon SNS FIFO ()First-In-First-Out. Karena mesin aturan adalah layanan terdistribusi sepenuhnya, tidak ada jaminan urutan 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 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 pengel AWS KMS olaan pelanggan AWS KMS key untuk mengenkripsi data diam di Amazon SNS, layanan harus memiliki izin untuk menggunakannya atas nama pen AWS KMS key elepon. 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 pemberitahuan push dikirim.

Men dukung template substitusi: API dan AWS CLI hanya

messageFormat

(Opsional) Format pesan. Amazon SNS menggunakan pengaturan ini untuk menentukan apakah payload harus diurai dan apakah bagian muatan khusus platform yang relevan 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 AWS IoT aturan.

{
    "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 AWS IoT aturan.

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