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.
# En utilisant EventBridge
Amazon S3 peut envoyer des événements à Amazon EventBridge chaque fois que certains événements se produisent dans votre compartiment. Contrairement à d’autres destinations, vous n’avez pas besoin de sélectionner les types d’événements que vous souhaitez proposer. Une fois EventBridge activé, tous les événements ci-dessous sont envoyés à EventBridge. Vous pouvez utiliser des EventBridge règles pour acheminer les événements vers des cibles supplémentaires. La liste suivante répertorie les événements auxquels Amazon S3 est envoyé EventBridge.
| Type d’événement | Description |
| --- | --- |
| *Objet créé* | Un objet a été créé. Le champ Motif de la structure du message de notification de l’événement indique l’API S3 utilisée pour créer l’objet : [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html), [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html), [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html) ou [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html). |
| *Objet supprimé (DeleteObject)* *Objet supprimé (expiration du cycle de vie)* | Un objet a été supprimé. Lorsqu’un objet est supprimé à l’aide d’un appel d’API S3, le champ Motif est défini sur DeleteObject. Lorsqu’un objet est supprimé par une règle d’expiration du cycle de vie S3, le champ motif est défini sur Expiration du cycle de vie. Pour de plus amples informations, veuillez consulter [Objets en cours d’expiration](lifecycle-expire-general-considerations.md). Lorsqu’un objet sans gestion des versions active est supprimé ou lorsqu’un objet avec gestion des versions active est supprimé définitivement, le champ deletion-type est défini sur Permanently Deleted. Lorsqu’un marqueur de suppression est créé pour un objet avec gestion des versions active, le champ `deletion-type` est défini sur Delete Marker Created. Pour de plus amples informations, veuillez consulter [Suppression des versions d’objet d’un compartiment activé pour la gestion des versions](DeletingObjectVersions.md). |
| *Restauration d’un objet démarrée* | Une restauration d’objets a été initiée à partir de la classe de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive ou du niveau S3 Intelligent-Tiering Archive Access ou Deep Archive Access. Pour de plus amples informations, veuillez consulter [Utilisation des objets archivés](archived-objects.md). |
| *Restauration d’un objet terminée* | Une restauration d’objets a été terminée. |
| *Restauration d’un objet expiré* | La copie temporaire d’un objet restauré à partir de S3 Glacier Flexible Retrieval ou S3 ¢Glacier Deep Archive a expiré et a été supprimée. |
| *Classe de stockage d’objets modifiée* | Un objet a été transféré vers une classe de stockage différente. Pour plus d’informations, consultez [Transition des objets à l’aide du cycle de vie Amazon S3](lifecycle-transition-general-considerations.md). |
| *Niveau d’accès aux objets modifié* | Un objet a été transféré vers le niveau S3 Intelligent-Tiering Archive Access ou Deep Archive Access. Pour plus d’informations, consultez [Gestion des coûts de stockage avec Amazon S3 Intelligent-Tiering](intelligent-tiering.md). |
| *Liste ACL d’un objet mise à jour* | La liste de contrôle d’accès (ACL) d’un objet a été définie à l’aide de `PutObjectAcl`. Un événement n'est pas généré lorsqu'une demande n'entraîne aucune modification de la liste ACL d'un objet. Pour plus d’informations, consultez [Présentation de la liste de contrôle d’accès (ACL)](acl-overview.md). |
| *Balises d’objets ajoutées* | Un ensemble de balises a été ajouté à un objet à l’aide de `PutObjectTagging`. Pour de plus amples informations, veuillez consulter [Catégorisation de vos objets à l’aide de balises](object-tagging.md). |
| *Balises d’objets supprimées* | Toutes les balises ont été supprimées d’un objet à l’aide de `DeleteObjectTagging`. Pour de plus amples informations, veuillez consulter [Catégorisation de vos objets à l’aide de balises](object-tagging.md). |
**Note**
Pour plus d'informations sur la façon dont les types d'événements Amazon S3 sont mappés aux types d' EventBridge événements, consultez[EventBridge Cartographie et résolution des problèmes sur Amazon](ev-mapping-troubleshooting.md).
Vous pouvez utiliser les notifications d'événements Amazon S3 EventBridge pour écrire des règles qui prennent des mesures lorsqu'un événement se produit dans votre compartiment. Par exemple, vous pouvez faire en sorte qu’il vous envoie une notification. Pour plus d'informations, voir [Qu'est-ce que c'est EventBridge ?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) dans le *guide de EventBridge l'utilisateur Amazon*.
Pour plus d'informations sur les actions et les types de données avec lesquels vous pouvez interagir à l'aide de l' EventBridge API, consultez la [référence d' EventBridge API Amazon](https://docs.aws.amazon.com/eventbridge/latest/APIReference/Welcome.html) dans la *référence EventBridge d'API Amazon*.
Pour plus d'informations sur les tarifs, consultez [ EventBridge les tarifs Amazon](https://aws.amazon.com/eventbridge/pricing).
**Topics**
+ [EventBridge Autorisations Amazon](ev-permissions.md)
+ [Activation d'Amazon EventBridge](enable-event-notifications-eventbridge.md)
+ [EventBridge structure du message d'événement](ev-events.md)
+ [EventBridge Cartographie et résolution des problèmes sur Amazon](ev-mapping-troubleshooting.md)
# EventBridge Autorisations Amazon
Amazon S3 n'a pas besoin d'autorisations supplémentaires pour transmettre des événements à Amazon EventBridge.
# Activation d'Amazon EventBridge
Vous pouvez activer Amazon à EventBridge l'aide de la console S3 AWS Command Line Interface (AWS CLI) ou de l'API REST Amazon S3.
**Note**
Après l'activation EventBridge, il faut environ cinq minutes pour que les modifications prennent effet.
## Utilisation de la console S3
**Pour activer la diffusion d' EventBridge événements dans la console S3.**
1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans le volet de navigation de gauche, choisissez **Compartiments à usage général**.
1. Dans la liste des compartiments, choisissez le nom du compartiment pour lequel vous souhaitez activer les événements.
1. Choisissez **Propriétés**.
1. Accédez à la section **Notifications d'événements** et recherchez la EventBridge sous-section **Amazon**. Choisissez **Modifier**.
1. Sous **Envoyer des notifications à Amazon EventBridge pour tous les événements de ce compartiment**, sélectionnez **Activé**.
## À l'aide du AWS CLI
L'exemple suivant crée une configuration de notification de compartiment pour un compartiment sur *`amzn-s3-demo-bucket1`* lequel Amazon EventBridge est activé.
```
aws s3api put-bucket-notification-configuration --bucket amzn-s3-demo-bucket1 --notification-configuration='{ "EventBridgeConfiguration": {} }'
```
## Utilisation de l'API REST
Vous pouvez activer Amazon par programmation EventBridge sur un bucket en appelant l'API REST Amazon S3. Pour plus d’informations, consultez [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotificationConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotificationConfiguration.html) dans la *Référence d’API Amazon Simple Storage Service*.
L'exemple suivant montre le code XML utilisé pour créer une configuration de notification de compartiment avec Amazon EventBridge activé.
```
```
## Création de EventBridge règles
Une fois activé, vous pouvez créer des EventBridge règles Amazon pour certaines tâches. Par exemple, vous pouvez envoyer des notifications par e-mail lorsqu’un objet est créé. Pour un didacticiel complet, consultez [Tutoriel : Envoyer une notification lors de la création d'un objet Amazon S3](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-s3-object-created-tutorial.html) dans le *guide de EventBridge l'utilisateur Amazon*.
# EventBridge structure du message d'événement
Le message de notification qu’envoie Amazon S3 pour publier un événement est au format JSON. Lorsqu'Amazon S3 envoie un événement à Amazon EventBridge, les champs suivants sont présents.
+ `version` : actuellement 0 (zéro) pour tous les événements.
+ `id` : UUID généré pour chaque événement.
+ `detail-type` : type d’événement envoyé Consultez [En utilisant EventBridge](EventBridge.md) pour obtenir la liste des types d’événements.
+ `source` : service qui a généré l’événement.
+ `account`— L' Compte AWS identifiant à 12 chiffres du propriétaire du bucket.
+ `time` : heure à laquelle l’événement s’est produit.
+ `region`— Identifie Région AWS le compartiment.
+ `resources` : tableau JSON contenant l’Amazon Resource Name (ARN) du compartiment.
+ `detail` : objet JSON qui contient des informations sur l’événement. Pour plus d’informations sur ce qui peut être inclus dans ce champ, consultez [Champ de détail des messages d’événement](#ev-events-detail).
## Exemples de structure de messages d’événements
Vous trouverez ci-dessous des exemples de messages de notification d'événements Amazon S3 qui peuvent être envoyés à Amazon EventBridge.
### Objet créé
```
{
"version": "0",
"id": "17793124-05d4-b198-2fde-7ededc63b103",
"detail-type": "Object Created",
"source": "aws.s3",
"account": "111122223333",
"time": "2021-11-12T00:00:00Z",
"region": "ca-central-1",
"resources": [
"arn:aws:s3:::amzn-s3-demo-bucket1"
],
"detail": {
"version": "0",
"bucket": {
"name": "amzn-s3-demo-bucket1"
},
"object": {
"key": "example-key",
"size": 5,
"etag": "b1946ac92492d2347c6235b4d2611184",
"version-id": "IYV3p45BT0ac8hjHg1houSdS1a.Mro8e",
"sequencer": "617f08299329d189"
},
"request-id": "N4N7GDK58NMKJ12R",
"requester": "123456789012",
"source-ip-address": "1.2.3.4",
"reason": "PutObject"
}
}
```
### Objet supprimé (en utilisant DeleteObject)
```
{
"version": "0",
"id": "2ee9cc15-d022-99ea-1fb8-1b1bac4850f9",
"detail-type": "Object Deleted",
"source": "aws.s3",
"account": "111122223333",
"time": "2021-11-12T00:00:00Z",
"region": "ca-central-1",
"resources": [
"arn:aws:s3:::amzn-s3-demo-bucket1"
],
"detail": {
"version": "0",
"bucket": {
"name": "amzn-s3-demo-bucket1"
},
"object": {
"key": "example-key",
"etag": "d41d8cd98f00b204e9800998ecf8427e",
"version-id": "1QW9g1Z99LUNbvaaYVpW9xDlOLU.qxgF",
"sequencer": "617f0837b476e463"
},
"request-id": "0BH729840619AG5K",
"requester": "123456789012",
"source-ip-address": "1.2.3.4",
"reason": "DeleteObject",
"deletion-type": "Delete Marker Created"
}
}
```
### Objet supprimé (à l’aide de l’expiration du cycle de vie)
```
{
"version": "0",
"id": "ad1de317-e409-eba2-9552-30113f8d88e3",
"detail-type": "Object Deleted",
"source": "aws.s3",
"account": "111122223333",
"time": "2021-11-12T00:00:00Z",
"region": "ca-central-1",
"resources": [
"arn:aws:s3:::amzn-s3-demo-bucket1"
],
"detail": {
"version": "0",
"bucket": {
"name": "amzn-s3-demo-bucket1"
},
"object": {
"key": "example-key",
"etag": "d41d8cd98f00b204e9800998ecf8427e",
"version-id": "mtB0cV.jejK63XkRNceanNMC.qXPWLeK",
"sequencer": "617b398000000000"
},
"request-id": "20EB74C14654DC47",
"requester": "s3.amazonaws.com",
"reason": "Lifecycle Expiration",
"deletion-type": "Delete Marker Created"
}
}
```
### Restauration d’un objet terminée
```
{
"version": "0",
"id": "6924de0d-13e2-6bbf-c0c1-b903b753565e",
"detail-type": "Object Restore Completed",
"source": "aws.s3",
"account": "111122223333",
"time": "2021-11-12T00:00:00Z",
"region": "ca-central-1",
"resources": [
"arn:aws:s3:::amzn-s3-demo-bucket1"
],
"detail": {
"version": "0",
"bucket": {
"name": "amzn-s3-demo-bucket1"
},
"object": {
"key": "example-key",
"size": 5,
"etag": "b1946ac92492d2347c6235b4d2611184",
"version-id": "KKsjUC1.6gIjqtvhfg5AdMI0eCePIiT3"
},
"request-id": "189F19CB7FB1B6A4",
"requester": "s3.amazonaws.com",
"restore-expiry-time": "2021-11-13T00:00:00Z",
"source-storage-class": "GLACIER"
}
}
```
## Champ de détail des messages d’événement
Le champ de détails contient un objet JSON avec des informations sur l’événement. Les champs suivants peuvent être présents dans le champ de détail.
+ `version` : actuellement 0 (zéro) pour tous les événements.
+ `bucket` : informations sur le compartiment Amazon S3 concerné par l’événement.
+ `object` : informations sur l’objet Amazon S3 concerné par l’événement.
+ `request-id` : ID de demande dans la réponse S3.
+ `requester`— Compte AWS Identifiant ou principal de AWS service du demandeur.
+ `source-ip-address` : adresse IP source de la demande S3. Présent uniquement pour les événements déclenchés par une demande S3.
+ `reason` : pour les événements **Objet créé**, API S3 utilisée pour créer l’objet : [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html), [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html), [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html), ou [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html). Pour les événements **Objet supprimé**, ce paramètre est défini sur **DeleteObject** lorsqu’un objet est supprimé par un appel d’API S3, ou sur **Expiration du cycle de vie** lorsqu’un objet est supprimé par une règle d’expiration S3 Lifecycle. Pour de plus amples informations, veuillez consulter [Objets en cours d’expiration](lifecycle-expire-general-considerations.md).
+ `deletion-type` : pour les événements **Objet supprimé**, lorsqu’un objet dont la gestion des versions n’est pas active est supprimé ou lorsqu’un objet dont la gestion des versions est active est supprimé définitivement, ce champ est défini sur **Supprimé définitivement**. Lorsqu’un marqueur de suppression est créé pour un objet versionné, ce champ est défini sur **Supprimer le marqueur créé**. Pour de plus amples informations, veuillez consulter [Suppression des versions d’objet d’un compartiment activé pour la gestion des versions](DeletingObjectVersions.md).
**Note**
Certains attributs d’objet (comme `etag` et `size`) ne sont présents que lorsqu’un marqueur de suppression est créé.
+ `restore-expiry-time` : pour les événements **Restauration d’un objet terminée**, heure à laquelle la copie temporaire de l’objet sera supprimée de S3. Pour de plus amples informations, veuillez consulter [Utilisation des objets archivés](archived-objects.md).
+ `source-storage-class` : pour les événements **Restauration d’objet démarrée** et **Restauration d’un objet terminée**, classe de stockage de l’objet restauré. Pour de plus amples informations, veuillez consulter [Utilisation des objets archivés](archived-objects.md).
+ `destination-storage-class` : pour les événements **Classe de stockage d’objets modifiée**, nouvelle classe de stockage de l’objet. Pour de plus amples informations, veuillez consulter [Transition des objets à l’aide du cycle de vie Amazon S3](lifecycle-transition-general-considerations.md).
+ `destination-access-tier` : pour les événements **Niveau d’accès aux objets modifié**, nouveau niveau d’accès à l’objet. Pour de plus amples informations, veuillez consulter [Gestion des coûts de stockage avec Amazon S3 Intelligent-Tiering](intelligent-tiering.md).
# EventBridge Cartographie et résolution des problèmes sur Amazon
Le tableau suivant décrit comment les types d'événements Amazon S3 sont mappés aux types d' EventBridge événements Amazon.
| Type d’événement S3 | Type de EventBridge détail Amazon |
| --- | --- |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html) [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html) [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html) [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html) | Objet créé |
| ObjectRemoved:Delete ObjectRemoved:DeleteMarkerCreated LifecycleExpiration:Delete LifecycleExpiration:DeleteMarkerCreated | Objet supprimé |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html) | Restauration d’un objet démarrée |
| ObjectRestore:Completed | Restauration d’un objet terminée |
| ObjectRestore:Delete | Restauration d’un objet expiré |
| LifecycleTransition | Classe de stockage d’objets modifiée |
| IntelligentTiering | Niveau d’accès aux objets modifié |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html) | Balises d’objets ajoutées |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html) | Balises d’objets supprimées |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectAcl.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectAcl.html) | Liste ACL d’un objet mise à jour |
## EventBridge Résolution des problèmes liés à Amazon
Pour plus d'informations sur le dépannage EventBridge, consultez la section [Dépannage d'Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-troubleshooting.html) dans le *guide de l' EventBridge utilisateur Amazon*.