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

# AWS IoT Events
<a name="iotevents-rule-action"></a>

Tindakan AWS IoT Events (`iotEvents`) mengirimkan data dari pesan MQTT ke input. AWS IoT Events 

**penting**  
Jika payload dikirim ke AWS IoT Core tanpa`Input attribute Key`, atau jika kunci tidak berada di jalur JSON yang sama yang ditentukan dalam kunci, itu akan menyebabkan aturan IoT gagal dengan kesalahan. `Failed to send message to Iot Events`

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

Tindakan aturan ini memiliki persyaratan sebagai berikut:
+ Peran IAM yang AWS IoT dapat diasumsikan untuk melakukan `iotevents:BatchPutMessage` 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.

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

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

`batchMode`  
(Opsional) Apakah akan memproses tindakan acara sebagai batch. Nilai default-nya adalah `false`.  
`batchMode`Kapan `true` dan pernyataan aturan SQL mengevaluasi ke Array, setiap elemen Array diperlakukan sebagai pesan terpisah ketika dikirim ke AWS IoT Acara dengan memanggil. [https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchPutMessage.html](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchPutMessage.html) Array yang dihasilkan tidak dapat memiliki lebih dari 10 pesan.  
`batchMode`Kapan`true`, Anda tidak dapat menentukan`messageId`.   
Mendukung [template substitusi](iot-substitution-templates.md): Tidak

`inputName`  
Nama AWS IoT Events input.  
Mendukung [template substitusi](iot-substitution-templates.md): API dan hanya AWS CLI 

`messageId`  
(Opsional) Gunakan ini untuk memverifikasi bahwa hanya satu input (pesan) dengan yang `messageId` diberikan diproses oleh AWS IoT Events detektor. Anda dapat menggunakan template `${newuuid()}` substitusi untuk menghasilkan ID unik untuk setiap permintaan.  
Saat `batchMode` adalah `true`, Anda tidak dapat menentukan `messageId`—nilai UUID baru akan diberikan.  
Mendukung [template substitusi](iot-substitution-templates.md): Ya

`roleArn`  
Peran IAM yang memungkinkan AWS IoT untuk mengirim input ke AWS IoT Events detektor. Untuk informasi selengkapnya, lihat [Persyaratan](#iotevents-rule-action-requirements).  
Mendukung [template substitusi](iot-substitution-templates.md): Tidak

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

Contoh JSON berikut mendefinisikan tindakan IoT Events dalam sebuah aturan. AWS IoT 

```
{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "iotEvents": {
                    "inputName": "MyIoTEventsInput",
                    "messageId": "${newuuid()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_events"
                }
            }
        ]
    }
}
```

## Lihat juga
<a name="iotevents-rule-action-see-also"></a>
+ [Apa itu AWS IoT Events?](https://docs.aws.amazon.com/iotevents/latest/developerguide/) di *Panduan AWS IoT Events Pengembang*