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