View a markdown version of this page

EventBridge structure du message d'événement - Amazon Simple Storage Service
Exemples de structure de messages d’événementsChamp de détail des messages d’événement

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.

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 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.

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",
    "event-version": "1.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",
    "event-version": "1.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",
    "event-version": "1.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",
    "event-version": "1.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"
  }
}

Annotation d'objet créée

{
  "version": "0",
  "id": "8c2bfa57-4a67-b2ea-c4e0-6d420ea3b3a6",
  "detail-type": "Object Annotation Created",
  "source": "aws.s3",
  "account": "111122223333",
  "time": "2025-03-15T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:s3:::amzn-s3-demo-bucket1"
  ],
  "detail": {
    "version": "0",
    "event-version": "2.4",
    "bucket": {
      "name": "amzn-s3-demo-bucket1"
    },
    "object": {
      "key": "example-key",
      "etag": "b1946ac92492d2347c6235b4d2611184",
      "version-id": "IYV3p45BT0ac8hjHg1houSdS1a.Mro8e",
      "sequencer": "617f08299329d189"
    },
    "request-id": "4B4NGD358NMKJ12R",
    "requester": "123456789012",
    "source-ip-address": "1.2.3.4",
    "reason": "PutObjectAnnotation",
    "object-annotation": {
      "name": "my-annotation",
      "size": 24,
      "etag": "05df351ea190dffc26f55c74425b9d7a"
    }
  }
}

Annotation d'objet supprimée

{
  "version": "0",
  "id": "a3d1bc94-5f82-c7e1-d290-7e531fb4c5b8",
  "detail-type": "Object Annotation Removed",
  "source": "aws.s3",
  "account": "111122223333",
  "time": "2025-03-15T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:s3:::amzn-s3-demo-bucket1"
  ],
  "detail": {
    "version": "0",
    "event-version": "2.4",
    "bucket": {
      "name": "amzn-s3-demo-bucket1"
    },
    "object": {
      "key": "example-key",
      "etag": "b1946ac92492d2347c6235b4d2611184",
      "version-id": "IYV3p45BT0ac8hjHg1houSdS1a.Mro8e",
      "sequencer": "617f08299329d190"
    },
    "request-id": "7C5NGD358NMKJ34S",
    "requester": "123456789012",
    "source-ip-address": "1.2.3.4",
    "reason": "DeleteObjectAnnotation",
    "object-annotation": {
      "name": "my-annotation"
    }
  }
}

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.

  • event-version— La version du schéma d'événement dans le formulaire major.minor (par exemple,1.0).

    La version majeure est incrémentée si Amazon S3 apporte à la structure de l’événement une modification qui n’est pas rétrocompatible. Cela inclut la suppression d’un champ JSON déjà présent ou la modification de la représentation du contenu d’un champ (par exemple, un format de date).

    La version mineure est incrémentée si Amazon S3 apporte une modification rétrocompatible à la structure de l'événement. Cela inclut l'ajout de nouveaux champs à la structure de l'événement ou l'introduction de nouveaux types d'événements. À des fins de compatibilité avec les nouvelles versions mineures de la structure des événements, nous vous recommandons d’ignorer les nouveaux champs dans vos applications.

    Pour vous assurer que vos applications puissent analyser correctement la structure de l’événement, nous vous recommandons d’effectuer une comparaison égal à sur le numéro de version majeure. Pour vous assurer que les champs qui sont attendus par votre application sont présents, nous vous recommandons également d’effectuer une comparaison « supérieur ou égal à » sur le numéro de version mineure.

  • 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 : PutObject, POST Object, CopyObject, ou CompleteMultipartUpload. 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.

  • 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.

    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.

  • 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.

  • 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.

  • 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.

  • object-annotation— Pour les événements Object Annotation Created et Object Annotation Removed, le detail champ inclut un object-annotation champ contenant des informations sur l'annotation.

  • has-object-annotation— Pour les événements créés par un objet avec raisonCopyObject, le object bloc inclut un champ has-object-annotation booléen qui indique si l'objet copié comporte des annotations.