Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

L'action Kinesis Data Streams `kinesis` () écrit les données d'un message MQTT dans Amazon Kinesis Data Streams. 

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

Cette action réglementaire est assortie des exigences suivantes :
+ Rôle IAM qui AWS IoT peut assumer la réalisation de l'`kinesis:PutRecord`opération. Pour de plus amples informations, veuillez consulter [Accorder à une AWS IoT règle l'accès dont elle a besoin](iot-create-role.md).

  Dans la AWS IoT console, vous pouvez choisir ou créer un rôle pour autoriser l'exécution AWS IoT de cette action de règle.
+ Si vous utilisez une clé KMS AWS KMS gérée par le client AWS KMS key pour chiffrer des données inactives dans Kinesis Data Streams, le service doit être autorisé à l'utiliser au nom de AWS KMS key l'appelant. Pour de plus amples informations, veuillez consulter [Permissions to use user-generated AWS KMS keys](https://docs.aws.amazon.com/streams/latest/dev/permissions-user-key-KMS.html) dans le Amazon Kinesis Data Streams Developer Guide.

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

Lorsque vous créez une AWS IoT règle avec cette action, vous devez spécifier les informations suivantes :

`stream`  
Le Flux de donnees Kinesis dans lequel écrire les données.  
Supporte les [modèles de substitution](iot-substitution-templates.md) : API et AWS CLI uniquement

`partitionKey`  
Clé de partition utilisée pour déterminer dans quelle partition les données sont écrites. La clé de partition est généralement composée d'une expression (par exemple, `${topic()}` ou `${timestamp()}`).  
Prend en charge les [modèles de substitution](iot-substitution-templates.md) : Oui

`roleArn`  
L'ARN du rôle IAM qui accorde l' AWS IoT autorisation d'accéder au flux de données Kinesis. Pour de plus amples informations, veuillez consulter [Exigences](#kinesis-rule-action-requirements).  
Prend en charge les [modèles de substitution](iot-substitution-templates.md) : Non

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

L'exemple JSON suivant définit une action Kinesis Data Streams dans AWS IoT une règle.

```
{
    "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"
                }
            }
        ] 
    }
}
```

L'exemple JSON suivant définit une action Kinesis avec des modèles de substitution dans une AWS IoT règle.

```
{
    "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"
                }
            }
        ]
    }
}
```

## Consultez aussi
<a name="kinesis-rule-action-see-also"></a>
+ [Qu'est-ce que Amazon Kinesis Data Streams ?](https://docs.aws.amazon.com/streams/latest/dev/) dans le *Guide du développeur Amazon Kinesis Data Streams*