AWS IoT Events

L'action AWS IoT Events (iotEvents) envoie les données d'un message MQTT à une AWS IoT Events entrée.

Important

Si la charge utile est envoyée AWS IoT Core sans leInput attribute Key, ou si la clé ne se trouve pas dans le même chemin JSON spécifié dans la clé, la règle IoT échouera avec l'erreurFailed to send message to Iot Events.

Prérequis

Cette action réglementaire est assortie des exigences suivantes :

• Rôle IAM qui AWS IoT peut assumer la réalisation de l'iotevents:BatchPutMessageopération. Pour plus d’informations, consultez Accorder à une AWS IoT règle l'accès dont elle a besoin.

  Dans la AWS IoT console, vous pouvez choisir ou créer un rôle pour autoriser l'exécution AWS IoT de cette action de règle.

Paramètres

Lorsque vous créez une AWS IoT règle avec cette action, vous devez spécifier les informations suivantes :

batchMode

(Optionnal) traiter ou non l'action d'événement en tant que lot. La valeur par défaut est false.

Quand batchMode est true et que l'instruction SQL de la règle est évaluée dans un tableau, chaque élément du tableau est traité comme un message distinct lorsqu'il est envoyé à AWS IoT Events en appelant BatchPutMessage. Le tableau résultant ne peut pas contenir plus de 10 messages.

Quand batchMode est true, vous ne pouvez pas spécifier un messageId.

Prend en charge les modèles de substitution : Non

inputName

Le nom de l' AWS IoT Events entrée.

Supporte les modèles de substitution : API et AWS CLI uniquement

messageId

(Facultatif) Utilisez-le pour vérifier qu'une seule entrée (message) contenant une donnée messageId est traitée par un AWS IoT Events détecteur. Vous pouvez utiliser le modèle de ${newuuid()} substitution pour générer un identifiant unique pour chaque demande.

Quand batchMode équivaut à true, vous ne pouvez pas spécifier de valeur messageId ; une nouvelle valeur UUID sera attribuée.

Prend en charge les modèles de substitution : Oui

roleArn

Rôle IAM qui permet d' AWS IoT envoyer une entrée à un AWS IoT Events détecteur. Pour plus d’informations, consultez Prérequis.

Prend en charge les modèles de substitution : Non

Exemples

L'exemple JSON suivant montre comment définir une action IoT Events dans une AWS IoT règle  :

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

Consultez aussi

• Qu'est-ce que c'est AWS IoT Events ? dans le guide AWS IoT Events du développeur