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

# SNS
<a name="sns-rule-action"></a>

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](iot-sns-rule.md).

**catatan**  
Tindakan SNS tidak mendukung topik [Amazon SNS FIFO (First-In-First-Out)](https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html). Karena mesin aturan adalah layanan terdistribusi penuh, tidak ada jaminan pesanan pesan ketika tindakan SNS dipanggil.

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

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](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 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](https://docs.aws.amazon.com/sns/latest/dg/sns-key-management.html) di *Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon*.

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

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](iot-substitution-templates.md): 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](iot-substitution-templates.md): Tidak

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

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

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
<a name="sns-rule-action-see-also"></a>
+ [Apakah Amazon Simple Notification Service?](https://docs.aws.amazon.com/sns/latest/dg/) dalam *Panduan Developer Amazon Simple Notification Service*
+ [Tutorial: Mengirim notifikasi Amazon SNS](iot-sns-rule.md)