Comment les messages d'événement sont générés Activez les événements pour AWS IoT

Messages d'événements

Cette section contient des informations sur les messages publiés AWS IoT lorsque des objets ou des tâches sont mis à jour ou modifiés. Pour plus d'informations sur le AWS IoT Events service qui vous permet de créer des détecteurs pour surveiller les défaillances ou les changements de fonctionnement de vos appareils, et pour déclencher des actions lorsqu'ils se produisent, voir AWS IoT Events.

Comment les messages d'événement sont générés

AWS IoT publie des messages d'événements lorsque certains événements se produisent. Par exemple, le registre génère des événements quand des objets sont ajoutés, mis à jour ou supprimés. Chaque événement génère l'envoi d'un seul message. Les messages d'événements sont publiés sur MQTT avec une charge utile JSON. Le contenu de la charge utile dépend du type d'événement.

Note

Il est garanti que les messages d'événements sont publiés une fois. Ils peuvent être publiés plusieurs fois. L'ordre des messages d'événement n'est pas garanti.

Politique de réception des messages d'événement

Pour recevoir des messages d'événements, votre appareil doit utiliser une politique appropriée lui permettant de se connecter à la passerelle de l' AWS IoT appareil et de s'abonner aux sujets d'événements MQTT. Vous devez aussi vous abonner aux filtres de rubriques appropriés.

Voici un exemple de stratégie requise pour recevoir des événements de cycle de vie :


{
    "Version":"2012-10-17",
    "Statement":[{
        "Effect":"Allow",
        "Action":[
            "iot:Subscribe",
            "iot:Receive"
        ],
        "Resource":[
            "arn:aws:iot:region:account:/$aws/events/*"
        ]
    }]
}

Activez les événements pour AWS IoT

Avant que les abonnés aux rubriques réservées puissent recevoir des messages, vous devez activer les messages d'événement depuis AWS Management Console ou à l'aide de l'API ou de la CLI. Pour plus d'informations sur les messages d'événements gérés par les différentes options, consultez le Tableau des paramètres de configuration des AWS IoT événements.

Pour activer les messages d'événements, accédez à l'onglet Paramètres de la AWS IoT console, puis, dans la section Messages basés sur les événements, choisissez Gérer les événements. Vous pouvez spécifier les événements que vous souhaitez gérer.
Pour contrôler les types d'événements publiés à l'aide de l'API ou de la CLI, appelez l'API UpdateEventConfigurations ou utilisez la commande update-event-configurations CLI. Par exemple :
```
aws iot update-event-configurations --event-configurations "{\"THING\":{\"Enabled\": true}}"
```

Note

L'échappement de tous les guillemets (") est effectué avec des barres obliques inverses (\).

Vous pouvez obtenir la configuration de l'événement actuel en appelant l'API DescribeEventConfigurations ou en utilisant la commande describe-event-configurations CLI. Par exemple : .


aws iot describe-event-configurations

Tableau des paramètres AWS IoT de configuration des événements

Catégorie d'événement (AWS IoT Console : Paramètres : messages basés sur des événements)	Valeur de la clé `eventConfigurations` (AWS CLI/API)	Rubrique du message d'événement
(Ne peut être configuré qu'à l'aide de AWS CLI/API)	`CA_CERTIFICATE`	`$aws/events/certificates/registered/caCertificateId`
(Ne peut être configuré qu'à l'aide de AWS CLI/API)	`CERTIFICATE`	`$aws/events/presence/connected/clientId`
(Ne peut être configuré qu'à l'aide de AWS CLI/API)	`CERTIFICATE`	`$aws/events/presence/disconnected/clientId`
(Ne peut être configuré qu'à l'aide de AWS CLI/API)	`CERTIFICATE`	`$aws/events/subscriptions/subscribed/clientId`
(Ne peut être configuré qu'à l'aide de AWS CLI/API)	`CERTIFICATE`	`$aws/events/subscriptions/unsubscribed/clientId`
Tâche terminée, annulée	`JOB`	`$aws/events/job/jobID/canceled`
Tâche terminée, annulée	`JOB`	`$aws/events/job/jobID/cancellation_in_progress`
Tâche terminée, annulée	`JOB`	`$aws/events/job/jobID/completed`
Tâche terminée, annulée	`JOB`	`$aws/events/job/jobID/deleted`
Tâche terminée, annulée	`JOB`	`$aws/events/job/jobID/deletion_in_progress`
Exécution de tâche : réussite, échec, rejet, annulation, suppression	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/canceled`
Exécution de tâche : réussite, échec, rejet, annulation, suppression	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/deleted`
Exécution de tâche : réussite, échec, rejet, annulation, suppression	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/failed`
Exécution de tâche : réussite, échec, rejet, annulation, suppression	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/rejected`
Exécution de tâche : réussite, échec, rejet, annulation, suppression	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/removed`
Exécution de tâche : réussite, échec, rejet, annulation, suppression	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/succeeded`
Exécution de tâche : réussite, échec, rejet, annulation, suppression	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/timed_out`
Objet : créé, mis à jour, supprimé	`THING`	`$aws/events/thing/thingName/created`
Objet : créé, mis à jour, supprimé	`THING`	`$aws/events/thing/thingName/updated`
Objet : créé, mis à jour, supprimé	`THING`	`$aws/events/thing/thingName/deleted`
Groupe d'objets : ajouté, supprimé	`THING_GROUP`	`$aws/events/thingGroup/thingGroupName/created`
Groupe d'objets : ajouté, supprimé	`THING_GROUP`	`$aws/events/thingGroup/thingGroupName/updated`
Groupe d'objets : ajouté, supprimé	`THING_GROUP`	`$aws/events/thingGroup/thingGroupName/deleted`
Hiérarchie des groupes d'objets : ajouté, supprimé	`THING_GROUP_HIERARCHY`	`$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/added`
Hiérarchie des groupes d'objets : ajouté, supprimé	`THING_GROUP_HIERARCHY`	`$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/removed`
Appartenance à un groupe d'objets : ajouté, supprimé	`THING_GROUP_MEMBERSHIP`	`$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/added`
Appartenance à un groupe d'objets : ajouté, supprimé	`THING_GROUP_MEMBERSHIP`	`$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/removed`
Type d'objet : créé, mis à jour, supprimé	`THING_TYPE`	`$aws/events/thingType/thingTypeName/created`
Type d'objet : créé, mis à jour, supprimé	`THING_TYPE`	`$aws/events/thingType/thingTypeName/updated`
Type d'objet : créé, mis à jour, supprimé	`THING_TYPE`	`$aws/events/thingType/thingTypeName/deleted`
Association de types d'objet : ajouté, supprimé	`THING_TYPE_ASSOCIATION`	`$aws/events/thingTypeAssociation/thing/thingName/thingType/thingTypeName/added` `$aws/events/thingTypeAssociation/thing/thingName/thingType/thingTypeName/removed`

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Solveurs de localisation et charge utile de l'appareil

Événements de registre