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

# Firehouse
<a name="kinesis-firehose-rule-action"></a>

Tindakan Firehose (`firehose`) mengirimkan data dari pesan MQTT ke aliran Amazon Data Firehose. 

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

Tindakan aturan ini memiliki persyaratan sebagai berikut:
+ Peran IAM yang AWS IoT dapat diasumsikan untuk melakukan `firehose:PutRecord` 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 Firehose untuk mengirim data ke bucket Amazon S3, dan Anda menggunakan pelanggan AWS KMS yang AWS KMS key berhasil mengenkripsi data saat istirahat di Amazon S3, Firehose harus memiliki akses ke bucket Anda dan izin untuk menggunakan atas nama pemanggil. AWS KMS key Untuk informasi selengkapnya, lihat [Memberikan akses Firehose ke tujuan Amazon S3](https://docs.aws.amazon.com/firehose/latest/dev/controlling-access.html#using-iam-s3) di Panduan Pengembang *Amazon Data Firehose*.

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

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

`batchMode`  
(Opsional) Apakah akan mengirimkan aliran Firehose sebagai batch dengan menggunakan. [https://docs.aws.amazon.com/firehose/latest/APIReference/API_PutRecordBatch.html](https://docs.aws.amazon.com/firehose/latest/APIReference/API_PutRecordBatch.html) Nilai default-nya adalah `false`.  
`batchMode`Kapan `true` dan pernyataan SQL aturan mengevaluasi ke Array, setiap elemen Array membentuk satu catatan dalam permintaan. `PutRecordBatch` Array yang dihasilkan tidak dapat memiliki lebih dari 500 record.   
Mendukung [template substitusi](iot-substitution-templates.md): Tidak

`deliveryStreamName`  
Aliran Firehose untuk menulis data pesan.  
Mendukung [template substitusi](iot-substitution-templates.md): API dan hanya AWS CLI 

`separator`  
(Opsional) Pemisah karakter yang digunakan untuk memisahkan catatan yang ditulis ke aliran Firehose. Jika Anda menghilangkan parameter ini, aliran tidak menggunakan pemisah. Nilai yang valid: `,` (koma), `\t` (tab), `\n` (baris baru), `\r\n` (baris baru Windows).  
Mendukung [template substitusi](iot-substitution-templates.md): Tidak

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

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

Contoh JSON berikut mendefinisikan tindakan Firehose dalam aturan. AWS IoT 

```
{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "firehose": {
                    "deliveryStreamName": "my_firehose_stream",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_firehose"
                }
            }
        ] 
    }
}
```

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

```
{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "firehose": {
                    "deliveryStreamName": "${topic()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_firehose"
                }
            }
        ]
    }
}
```

## Lihat juga
<a name="kinesis-firehose-rule-action-see-also"></a>
+ [Apa itu Amazon Data Firehose?](https://docs.aws.amazon.com/firehose/latest/dev/) di Panduan *Pengembang Firehose Data Amazon*