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 envoyé par Amazon S3 pour publier un événement est au JSON format suivant. 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 — Une version 4 UUID générée pour chaque événement.

  • detail-type – Type d'événement qui est envoyé. Consultez En utilisant EventBridge pour obtenir la liste des types d'événements.

  • source – Identifie le service à l'origine de l'événement.

  • account (compte) – ID de Compte AWS à 12 chiffres du propriétaire du compartiment.

  • time (heure) – Heure à laquelle l'événement s'est produit.

  • region (Région) – Identifie la Région AWS du compartiment.

  • resources — JSON Tableau contenant le nom de ressource Amazon (ARN) du compartiment.

  • détail — JSON Objet contenant 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étail contient un JSON objet contenant 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 (compartiment) – Informations relatives au compartiment Amazon S3 impliqué dans l'événement.

  • object (objet) – Informations relatives à l'objet Amazon S3 impliqué dans l'événement.

  • request-id – ID de demande dans la réponse S3.

  • demandeur — Compte AWS ID ou principal AWS de service du demandeur.

  • source-ip-address— Adresse IP source de la requête S3. Présent uniquement pour les événements déclenchés par une demande S3.

  • reason — Pour les événements Object Created, le S3 API utilisé pour créer l'objet : PutObject, POSTObject CopyObject, ou CompleteMultipartUpload. Pour les événements Object Deleted, ce paramètre est défini sur DeleteObjectlorsqu'un objet est supprimé par un API appel S3, ou sur Expiration du cycle de vie lorsqu'un objet est supprimé par une règle d'expiration du cycle de vie S3. Pour plus d’informations, consultez Objets en cours d’expiration.

  • deletion-type – Pour les événements Objet supprimé, lorsqu'un objet non versionné est supprimé ou lorsqu'un objet versionné 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 plus d’informations, consultez Suppression des versions d'objet d'un compartiment activé pour la gestion des versions.

    Note

    Certains attributs d'objet (tels que etag etsize) ne sont présents que lorsqu'un marqueur de suppression est créé.

  • restore-expiry-time— Pour les événements Object Restore Completed, heure à laquelle la copie temporaire de l'objet sera supprimée de S3. Pour plus d’informations, consultez Utilisation des objets archivés.

  • source-storage-class— Pour les événements Object Restore Initiated et Object Restore Completed, classe de stockage de l'objet en cours de restauration. Pour plus d’informations, consultez Utilisation des objets archivés.

  • destination-storage-class— Pour les événements Object Storage Class Changed, nouvelle classe de stockage de l'objet. Pour plus d’informations, consultez Transition des objets à l'aide du cycle de vie Amazon S3.

  • destination-access-tier— Pour les événements Object Access Tier Changed, nouveau niveau d'accès de l'objet. Pour plus d’informations, consultez Amazon S3 Intelligent Tiering.