Messages d'événements - AWS IoT Core

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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'UpdateEventConfigurationsAPI 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 actuelle de l'événement en appelant l'DescribeEventConfigurationsAPI 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