AWS IoT Events

L'action AWS IoT Events (iotEvents) envoie les données d'un MQTT message à 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 JSON chemin que celui indiqué 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 :

• IAMRôle qui AWS IoT peut assumer la réalisation de l'iotevents:BatchPutMessageopération. Pour de plus amples informations, veuillez consulter 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.

Lorsque batchMode c'est le cas true et que l'SQLinstruction de règle est évaluée à un tableau, chaque élément du tableau est traité comme un message distinct lorsqu'il est envoyé à AWS IoT Events par appel 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.

Dans batchMode ce castrue, vous ne pouvez pas spécifier de messageId --une nouvelle UUID valeur sera attribuée.

Prend en charge les modèles de substitution : Oui

roleArn

Le IAM rôle qui permet AWS IoT d'envoyer une entrée à un AWS IoT Events détecteur. Pour de plus amples informations, veuillez consulter Prérequis.

Prend en charge les modèles de substitution : Non

Exemples

L'JSONexemple suivant définit 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