Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

La acción AWS IoT Events (`iotEvents`) envía los datos de un mensaje MQTT a una AWS IoT Events entrada. 

**importante**  
Si la carga útil se envía AWS IoT Core sin la`Input attribute Key`, o si la clave no está en la misma ruta JSON especificada en la clave, se producirá un error `Failed to send message to Iot Events` en la regla de IoT.

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

Esta regla tiene los siguientes requisitos:
+ Un rol de IAM que AWS IoT puede asumir para realizar la `iotevents:BatchPutMessage` operación. Para obtener más información, consulte [Otorgar a una AWS IoT regla el acceso que requiere](iot-create-role.md).

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

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

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

`batchMode`  
(Opcional) Si se procesan las acciones de evento como un lote. El valor predeterminado es `false`.  
Cuando `batchMode` es `true` y la sentencia SQL de la regla se evalúa como una matriz, cada elemento de la matriz se trata como un mensaje independiente cuando se envía a AWS IoT Events mediante una llamada [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). La matriz resultante no puede tener más de 10 mensajes.  
Cuando `batchMode` es `true`, no puede especificar un `messageId`.   
Admite [plantillas de sustitución](iot-substitution-templates.md): No

`inputName`  
El nombre de la AWS IoT Events entrada.  
Soporta [plantillas de sustitución](iot-substitution-templates.md): API y AWS CLI únicamente

`messageId`  
(Opcional) Use esto para verificar que un AWS IoT Events detector procese solo una entrada (mensaje) con un dato determinado`messageId`. Puede utilizar la plantilla de sustitución `${newuuid()}` para generar un identificador único para cada solicitud.  
Cuando `batchMode` es `true`, no puede especificar un `messageId`. Se asignará un nuevo valor UUID.  
Admite [plantillas de sustitución](iot-substitution-templates.md): Sí

`roleArn`  
La función de IAM que permite AWS IoT enviar una entrada a un AWS IoT Events detector. Para obtener más información, consulte [Requisitos](#iotevents-rule-action-requirements).  
Admite [plantillas de sustitución](iot-substitution-templates.md): No

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

El siguiente ejemplo JSON define una acción de Eventos IoT en una regla 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"
                }
            }
        ]
    }
}
```

## Véase también
<a name="iotevents-rule-action-see-also"></a>
+ [¿Qué es? AWS IoT Events](https://docs.aws.amazon.com/iotevents/latest/developerguide/) en la *Guía AWS IoT Events para desarrolladores*