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

# Kinesis Data Streams
<a name="kinesis-rule-action"></a>

Tindakan Kinesis Data `kinesis` Streams () menulis data dari pesan MQTT ke Amazon Kinesis Data Streams. 

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

Tindakan aturan ini memiliki persyaratan sebagai berikut:
+ Peran IAM yang AWS IoT dapat diasumsikan untuk melakukan `kinesis: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 kunci AWS KMS key KMS yang AWS KMS dikelola pelanggan untuk mengenkripsi data saat istirahat di Kinesis Data Streams, layanan harus memiliki izin untuk menggunakan atas nama pemanggil. AWS KMS key Untuk informasi selengkapnya, lihat [Izin untuk menggunakan buatan pengguna AWS KMS keys di Panduan Pengembang](https://docs.aws.amazon.com/streams/latest/dev/permissions-user-key-KMS.html) *Amazon Kinesis Data Streams*.

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

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

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

`partitionKey`  
Kunci partisi yang digunakan untuk menentukan pecahan data mana yang ditulis. Kunci partisi biasanya terdiri dari ekspresi (misalnya, `${topic()}` atau`${timestamp()}`).  
Mendukung [template substitusi](iot-substitution-templates.md): Ya

`roleArn`  
ARN dari peran IAM yang memberikan AWS IoT izin untuk mengakses aliran data Kinesis. Untuk informasi selengkapnya, lihat [Persyaratan](#kinesis-rule-action-requirements).  
Mendukung [template substitusi](iot-substitution-templates.md): Tidak

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

Contoh JSON berikut mendefinisikan tindakan Kinesis Data Streams dalam sebuah aturan. AWS IoT 

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

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

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

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