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
<a name="iot-events"></a>

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](https://aws.amazon.com/iot-events).

## Comment les messages d'événement sont générés
<a name="iot-events-how"></a>

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
<a name="iot-events-policy"></a>

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:us-east-1:123456789012:/$aws/events/*"
            ]
        }
    ]
}
```

## Activez les événements pour AWS IoT
<a name="iot-events-enable"></a>

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](#iot-events-settings-table).
+ Pour activer les messages d'événements, accédez à l'onglet [Paramètres](https://console.aws.amazon.com//iot/home#/settings) 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'[UpdateEventConfigurations](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateEventConfigurations.html)API 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 (\$1).

Vous pouvez obtenir la configuration actuelle de l'événement en appelant l'[DescribeEventConfigurations](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeEventConfigurations.html)API ou en utilisant la commande **describe-event-configurations** CLI. Par exemple :

```
aws iot describe-event-configurations
```<a name="iot-events-settings-table"></a>

**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`  |