Kinesis Data Streams

La acción Kinesis Data Streams (kinesis) escribe datos de un mensaje MQTT en Amazon Kinesis Data Streams.

Requisitos

Esta regla tiene los siguientes requisitos:

• Una función de IAM que AWS IoT puede asumir para realizar la operación. kinesis:PutRecord Para obtener más información, consulte Otorgar a una AWS IoT regla el acceso que requiere.

  En la AWS IoT consola, puede elegir o crear un rol que permita AWS IoT realizar esta acción de regla.

• Si utiliza una clave KMS AWS KMS administrada por el cliente AWS KMS key para cifrar los datos en reposo en Kinesis Data Streams, el servicio debe tener permiso para utilizarla en nombre de AWS KMS key la persona que llama. Para obtener más información, consulte Permisos de uso generados por el usuario AWS KMS keys en la guía para desarrolladores de Amazon Kinesis Data Streams.

Parámetros

Al crear una AWS IoT regla con esta acción, debe especificar la siguiente información:

stream

El flujo de datos Kinesis en el que escribir los datos.

Admite plantillas de sustitución: API y AWS CLI únicamente

partitionKey

La clave de partición utilizada para determinar en qué fragmento se escriben los datos. La clave de partición suele estar compuesta por una expresión (por ejemplo, ${topic()} o ${timestamp()}).

Admite plantillas de sustitución: Sí

roleArn

El ARN del rol de IAM que concede el AWS IoT permiso para acceder a la transmisión de datos de Kinesis. Para obtener más información, consulte Requisitos.

Admite plantillas de sustitución: No

Ejemplos

El siguiente ejemplo de JSON define una acción de Kinesis Data Streams en AWS IoT una regla.

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

El siguiente ejemplo de JSON define una acción de Kinesis con plantillas de sustitución en una AWS IoT regla.

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

Véase también

• ¿Qué es Amazon Kinesis Data Streams? en la Guía para desarrolladores de Amazon Kinesis Data Streams.