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",
    "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 : 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.