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. # Événements de registre Le registre peut publier des messages d'événement lorsque des objets, des types d'objets et des groupes d'objets sont créés, mis à jour ou supprimés. Ces événements ne sont cependant pas disponibles par défaut. Pour plus d'informations sur la façon d'activer ces événements, consultez [Activez les événements pour AWS IoT](iot-events.md#iot-events-enable). **Topics** + [Événements de l’objet](#registry-events-thing) + [Événements de types d'objet](#registry-events-thingtype) + [Événements de groupe d'objets](#registry-events-thinggroup) ## Événements de l’objet **Chose Created/Updated/Deleted** Le registre publie les messages d'événement suivants lorsque des objets sont créés, mis à jour ou supprimés : + `$aws/events/thing/thingName/created` + `$aws/events/thing/thingName/updated` + `$aws/events/thing/thingName/deleted` Les messages contiennent l'exemple de charge utile suivant : ``` { "eventType" : "THING_EVENT", "eventId" : "f5ae9b94-8b8e-4d8e-8c8f-b3266dd89853", "timestamp" : 1234567890123, "operation" : "CREATED|UPDATED|DELETED", "accountId" : "123456789012", "thingId" : "b604f69c-aa9a-4d4a-829e-c480e958a0b5", "thingName" : "MyThing", "versionNumber" : 1, "thingTypeName" : null, "attributes": { "attribute3": "value3", "attribute1": "value1", "attribute2": "value2" } } ``` Les charges utiles contiennent les attributs suivants : eventType Défini sur « THING\$1EVENT ». eventId Un ID d'événement unique (chaîne). timestamp L'horodatage UNIX du moment où l'événement s'est produit. fonctionnement L'opération qui a déclenché l'événement. Les valeurs valides sont : + CRÉÉ + MIS À JOUR + SUPPRIMÉ accountId Votre Compte AWS carte d'identité. thingId L'ID de l'objet en cours de création, de mise à jour ou de suppression. thingName Le nom de l'objet en cours de création, de mise à jour ou de suppression. versionNumber La version de l'objet en cours de création, de mise à jour ou de suppression. Cette valeur est définie sur 1 lors de la création d'un objet. Elle augmente de 1 à chaque mise à jour de l'objet. thingTypeName Le type d'objet associé à l'objet, le cas échéant. Sinon la valeur est renvoy, `null`. attributs Un ensemble de paires nom-valeur associées à l'objet. ## Événements de types d'objet **Topics** + [Type d'objet Created/Updated/Deprecated/Undeprecated/Deleted](#registry-events-thingtype-crud) + [Type d'objet associé à un objet/dissocié d'un objet](#registry-events-thingtype-assoc) ### Type d'objet Created/Updated/Deprecated/Undeprecated/Deleted Le registre publie les messages d'événement suivants lorsque des types d'objets sont créés, mis à jour, déconseillés, déconseillés ou supprimés : + `$aws/events/thingType/thingTypeName/created` + `$aws/events/thingType/thingTypeName/updated` + `$aws/events/thingType/thingTypeName/deleted` Le message contient l'exemple de charge utile suivant : ``` { "eventType" : "THING_TYPE_EVENT", "eventId" : "8827376c-4b05-49a3-9b3b-733729df7ed5", "timestamp" : 1234567890123, "operation" : "CREATED|UPDATED|DELETED", "accountId" : "123456789012", "thingTypeId" : "c530ae83-32aa-4592-94d3-da29879d1aac", "thingTypeName" : "MyThingType", "isDeprecated" : false|true, "deprecationDate" : null, "searchableAttributes" : [ "attribute1", "attribute2", "attribute3" ], "propagatingAttributes": [ { "userPropertyKey": "key", "thingAttribute": "model" }, { "userPropertyKey": "key", "connectionAttribute": "iot:ClientId" } ], "description" : "My thing type" } ``` Les charges utiles contiennent les attributs suivants : eventType Défini sur « THING\$1TYPE\$1EVENT ». eventId Un ID d'événement unique (chaîne). timestamp L'horodatage UNIX du moment où l'événement s'est produit. fonctionnement L'opération qui a déclenché l'événement. Les valeurs valides sont : + CRÉÉ + MIS À JOUR + SUPPRIMÉ accountId Votre Compte AWS carte d'identité. thingTypeId L'ID du type d'objet en cours de création, de mise à jour, de dépréciation ou de suppression. thingTypeName Le nom du type d'objet en cours de création, de mise à jour, de dépréciation ou de suppression. isDeprecated `true` si le type d'objet est obsolète. Sinon la valeur est renvoy, `false`. deprecationDate L'horodatage UNIX associé au moment où ce type d'objet est devenu obsolète. searchableAttributes Un ensemble de paires nom-valeur associées au type d'objet qui peut être utilisé pour la recherche. Attributs de propagation Liste des attributs de propagation. Un attribut de propagation peut contenir un attribut d'objet, un attribut de connexion et une clé de propriété utilisateur. Pour plus d'informations, consultez la section [Ajout d'attributs de propagation pour l'enrichissement des messages](https://docs.aws.amazon.com//iot/latest/developerguide/thing-types-propagating-attributes.html). description Une description du type d'objet. ### Type d'objet associé à un objet/dissocié d'un objet Le registre publie les messages d'événement suivants lorsqu'un type d'objet est associé à un objet ou dissocié d'un objet. + `$aws/events/thingTypeAssociation/thing/thingName/thingType/typeName/added` + `$aws/events/thingTypeAssociation/thing/thingName/thingType/typeName/removed` Voici un exemple de charge utile `added`. Les charges utiles pour les messages `removed` sont similaires. ``` { "eventId" : "87f8e095-531c-47b3-aab5-5171364d138d", "eventType" : "THING_TYPE_ASSOCIATION_EVENT", "operation" : "ADDED", "thingId" : "b604f69c-aa9a-4d4a-829e-c480e958a0b5", "thingName": "myThing", "thingTypeName" : "MyThingType", "timestamp" : 1234567890123, } ``` Les charges utiles contiennent les attributs suivants : eventId Un ID d'événement unique (chaîne). eventType Défini sur « THING\$1TYPE\$1ASSOCIATION\$1EVENT ». fonctionnement L'opération qui a déclenché l'événement. Les valeurs valides sont : + AJOUTÉ + SUPPRIMÉ thingId ID de l'objet dont l'association du type a été modifiée. thingName Nom de l'objet dont l'association du type a été modifiée. thingTypeName Type d'objet associé à l'objet ou qui n'est plus associé à l'objet. timestamp L'horodatage UNIX du moment où l'événement s'est produit. ## Événements de groupe d'objets **Topics** + [Groupe d'objets Created/Updated/Deleted](#registry-events-thinggroup-crud) + [Objet ajouté à un groupe d'objets/retiré d'un groupe d'objets](#registry-events-thinggroup-addremove) + [Groupe d'objets ajouté à un groupe d'objets/retiré d'un groupe d'objets](#registry-events-thinggroup-adddelete) ### Groupe d'objets Created/Updated/Deleted Le registre publie les messages d'événement suivants lorsqu'un groupe d'objets est créé, mis à jour ou supprimé. + `$aws/events/thingGroup/groupName/created` + `$aws/events/thingGroup/groupName/updated` + `$aws/events/thingGroup/groupName/deleted` Voici un exemple de charge utile `updated`. Les charges utiles pour `created` et des messages `deleted` sont similaires. ``` { "eventType": "THING_GROUP_EVENT", "eventId": "8b9ea8626aeaa1e42100f3f32b975899", "timestamp": 1603995417409, "operation": "UPDATED", "accountId": "571EXAMPLE833", "thingGroupId": "8757eec8-bb37-4cca-a6fa-403b003d139f", "thingGroupName": "Tg_level5", "versionNumber": 3, "parentGroupName": "Tg_level4", "parentGroupId": "5fce366a-7875-4c0e-870b-79d8d1dce119", "description": "New description for Tg_level5", "rootToParentThingGroups": [ { "groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/TgTopLevel", "groupId": "36aa0482-f80d-4e13-9bff-1c0a75c055f6" }, { "groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level1", "groupId": "bc1643e1-5a85-4eac-b45a-92509cbe2a77" }, { "groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level2", "groupId": "0476f3d2-9beb-48bb-ae2c-ea8bd6458158" }, { "groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level3", "groupId": "1d9d4ffe-a6b0-48d6-9de6-2e54d1eae78f" }, { "groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level4", "groupId": "5fce366a-7875-4c0e-870b-79d8d1dce119" } ], "attributes": { "attribute1": "value1", "attribute3": "value3", "attribute2": "value2" }, "dynamicGroupMappingId": null } ``` Les charges utiles contiennent les attributs suivants : eventType Défini sur « THING\$1GROUP\$1EVENT ». eventId Un ID d'événement unique (chaîne). timestamp L'horodatage UNIX du moment où l'événement s'est produit. fonctionnement L'opération qui a déclenché l'événement. Les valeurs valides sont : + CRÉÉ + MIS À JOUR + SUPPRIMÉ accountId Votre Compte AWS carte d'identité. thingGroupId L'ID du groupe d'objets en cours de création, de mise à jour ou de suppression. thingGroupName Le nom du groupe d'objets en cours de création, de mise à jour ou de suppression. versionNumber Version du groupe d'objets. Cette valeur est définie sur 1 lors de la création d'un groupe d'objets. Elle augmente de 1 à chaque mise à jour du groupe d'objets. parentGroupName Le nom du groupe d'objets parent (le cas échéant). parentGroupId L'ID du groupe d'objets parent (le cas échéant). description La description du groupe d'objets. rootToParentThingGroups Tableau d'informations sur le groupe d'objets parent. Il existe un élément pour chaque groupe d'objets parent, en commençant par le groupe d'objets racine et en continuant jusqu'au parent du groupe d'objets. Chaque entrée contient les groupes d'objets `groupArn` et `groupId`. attributs Un ensemble de paires nom-valeur associées au groupe d'objets. ### Objet ajouté à un groupe d'objets/retiré d'un groupe d'objets Le registre publie les messages d'événement suivants lorsqu'un objet est ajouté à un groupe d'objets ou retiré d'un groupe d'objets. + `$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/added` + `$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/removed` Les messages contiennent l'exemple de charge utile suivant : ``` { "eventType" : "THING_GROUP_MEMBERSHIP_EVENT", "eventId" : "d684bd5f-6f6e-48e1-950c-766ac7f02fd1", "timestamp" : 1234567890123, "operation" : "ADDED|REMOVED", "accountId" : "123456789012", "groupArn" : "arn:aws:iot:ap-northeast-2:123456789012:thinggroup/MyChildThingGroup", "groupId" : "06838589-373f-4312-b1f2-53f2192291c4", "thingArn" : "arn:aws:iot:ap-northeast-2:123456789012:thing/MyThing", "thingId" : "b604f69c-aa9a-4d4a-829e-c480e958a0b5", "membershipId" : "8505ebf8-4d32-4286-80e9-c23a4a16bbd8" } ``` Les charges utiles contiennent les attributs suivants : eventType Défini sur « THING\$1GROUP\$1MEMBERSHIP\$1EVENT ». eventId L'ID d'événement. timestamp L'horodatage UNIX du moment où l'événement s'est produit. fonctionnement `ADDED` lorsqu' un objet est ajouté à un groupe d'objets. `REMOVED` lorsqu'un objet est supprimé d'un groupe d'objets. accountId Votre Compte AWS carte d'identité. groupArn L'ARN du groupe d'objets. groupId L'ID du groupe. thingArn L'ARN de l'objet qui a été ajouté au groupe d'objets ou supprimé de ce groupe. thingId L'ID de l'objet qui a été ajouté au groupe d'objets ou supprimé de ce groupe. membershipId Un ID qui représente la relation entre l'objet et le groupe d'objets. Cette valeur est générée lorsque vous ajoutez un objet à un groupe d'objets. ### Groupe d'objets ajouté à un groupe d'objets/retiré d'un groupe d'objets Le registre publie les messages d'événement suivants lorsqu'un groupe d'objets est ajouté à un autre groupe d'objets ou retiré d'un autre groupe d'objets. + `$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/added` + `$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/removed` Le message contient l'exemple de charge utile suivant : ``` { "eventType" : "THING_GROUP_HIERARCHY_EVENT", "eventId" : "264192c7-b573-46ef-ab7b-489fcd47da41", "timestamp" : 1234567890123, "operation" : "ADDED|REMOVED", "accountId" : "123456789012", "thingGroupId" : "8f82a106-6b1d-4331-8984-a84db5f6f8cb", "thingGroupName" : "MyRootThingGroup", "childGroupId" : "06838589-373f-4312-b1f2-53f2192291c4", "childGroupName" : "MyChildThingGroup" } ``` Les charges utiles contiennent les attributs suivants : eventType Défini sur « THING\$1GROUP\$1HIERARCHY\$1EVENT ». eventId L'ID d'événement. timestamp L'horodatage UNIX du moment où l'événement s'est produit. fonctionnement `ADDED` lorsqu' un objet est ajouté à un groupe d'objets. `REMOVED` lorsqu'un objet est supprimé d'un groupe d'objets. accountId Votre Compte AWS carte d'identité. thingGroupId L'ID du groupe d'objets parent. thingGroupName Le nom du groupe d'objets parent. childGroupId L'ID du groupe d'objets enfant. childGroupName Le nom du groupe d'objets enfant.