AWS IoT Events - AWS IoT Core
RequisitosParámetrosEjemplosVéase también

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

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 laInput 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

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.

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

Parámetros

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 instrucción de SQL de regla se evalúa como una matriz, cada elemento de la matriz se trata como un mensaje separado cuando se envía a AWS IoT mediante una llamada a BatchPutMessage. 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: No

inputName

El nombre de la AWS IoT Events entrada.

Admite plantillas de sustitución: 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 determinadomessageId. 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: 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.

Admite plantillas de sustitución: No

Ejemplos

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