AWS IoT Events

L'azione AWS IoT Events (iotEvents) invia i dati da un messaggio MQTT a un AWS IoT Events input.

Importante

Se il payload viene inviato AWS IoT Core senza o se la chiave non si trova nello stesso percorso JSON specificato nella chiave, la regola IoT non funzionerà con l'errore. Input attribute Key Failed to send message to Iot Events

Requisiti

Questa operazione della regola presenta i seguenti requisiti:

• Un ruolo IAM che AWS IoT può assumere di eseguire l'iotevents:BatchPutMessageoperazione. Per ulteriori informazioni, consulta Concedere a qualsiasi AWS IoT regola l'accesso richiesto.

  Nella AWS IoT console, puoi scegliere o creare un ruolo che consenta di AWS IoT eseguire questa azione relativa alla regola.

Parametri

Quando si crea una AWS IoT regola con questa azione, è necessario specificare le seguenti informazioni:

batchMode

(Facoltativo) Indica se elaborare le azioni evento come batch. Il valore predefinito è false.

Quando batchMode è true e l'istruzione SQL regola restituisce un array, ogni elemento dell’array viene considerato come un messaggio separato quando viene inviato a AWS IoT Events chiamando BatchPutMessage. L'array risultante non può avere più di 10 messaggi.

Quando batchMode è true, non è possibile specificare un messageId.

Supporta modelli di sostituzione: no

inputName

Il nome dell' AWS IoT Events input.

Supporta modelli sostitutivi: solo API AWS CLI

messageId

(Facoltativo) Utilizzatelo per verificare che un solo input (messaggio) con un dato dato messageId venga elaborato da un AWS IoT Events rilevatore. Puoi utilizzare il modello di sostituzione ${newuuid()} per generare un ID univoco per ogni richiesta.

Quando batchMode è true, non è possibile specificare un valore messageId: verrà assegnato un nuovo valore UUID.

Supporta modelli di sostituzione: sì

roleArn

Il ruolo IAM che consente di AWS IoT inviare un input a un AWS IoT Events rilevatore. Per ulteriori informazioni, consulta Requisiti.

Supporta modelli di sostituzione: no

Esempi

L'esempio JSON seguente illustra come definire un'operazione Eventi IoT in una regola 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"
                }
            }
        ]
    }
}

Consulta anche

• Che cos'è AWS IoT Events? nella Guida per gli AWS IoT Events sviluppatori