AWS IoT Events - AWS IoT Core
RequisitosParâmetrosExemplosConsulte também

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

AWS IoT Events

A ação AWS IoT Events (iotEvents) envia dados de uma mensagem MQTT para uma AWS IoT Events entrada.

Importante

Se a carga for enviada AWS IoT Core sem oInput attribute Key, ou se a chave não estiver no mesmo caminho JSON especificado na chave, isso fará com que a regra de IoT falhe com o erro. Failed to send message to Iot Events

Requisitos

Esta ação de regra tem os seguintes requisitos:

  • Uma função do IAM que AWS IoT você pode assumir para realizar a iotevents:BatchPutMessage operação. Para obter mais informações, consulte Conceder a uma AWS IoT regra o acesso necessário.

    No AWS IoT console, você pode escolher ou criar uma função para permitir AWS IoT a execução dessa ação de regra.

Parâmetros

Ao criar uma AWS IoT regra com essa ação, você deve especificar as seguintes informações:

batchMode

(Opcional) Se as ações do evento devem ser processadas em lote. O valor padrão é false.

Quando batchMode é true e a regra a instrução SQL é avaliada como uma matriz, cada elemento da matriz é tratado como uma mensagem separada quando é enviado para AWS IoT Eventos por meio de uma chamada BatchPutMessage. A matriz resultante não pode ter mais de 10 mensagens.

Quando batchMode é true, não é possível especificar um messageId.

Compatível com modelos de substituição: Não

inputName

O nome da AWS IoT Events entrada.

Suporta modelos de substituição: API e somente AWS CLI

messageId

(Opcional) Use isso para verificar se somente uma entrada (mensagem) com uma determinada messageId é processada por um AWS IoT Events detector. Você pode usar o ${newuuid()} modelo de substituição para gerar uma ID exclusiva para cada solicitação.

Quando batchMode estiver true, você não poderá especificar um messageId—um novo valor de UUID será atribuído.

Compatível com modelos de substituição: Sim

roleArn

A função do IAM que AWS IoT permite enviar uma entrada para um AWS IoT Events detector. Para obter mais informações, consulte Requisitos.

Compatível com modelos de substituição: Não

Exemplos

O exemplo JSON a seguir define uma ação do IoT Events em uma AWS IoT regra.

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

Consulte também