Structure des messages d’événements EventBridge - Amazon Simple Storage Service
Exemples de structure de messages d’événementsChamp de détail des messages d’événement

Structure des messages d’événements EventBridge

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 Utilisation d’EventBridge pour obtenir la liste des types d’événements.

  • source : service qui a généré l’événement.

  • account : ID de Compte AWS à 12 chiffres du propriétaire du compartiment.

  • time : heure à laquelle l’événement s’est produit.

  • region : Région AWS du 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

Voici des exemples de messages de notification d’événement 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é (à l’aide de 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 : ID du Compte AWS ou principal du service AWS 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 plus d’informations, consultez 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 plus d’informations, consultez 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 plus d’informations, consultez 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 plus d’informations, consultez 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 plus d’informations, consultez 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 plus d’informations, consultez Gestion des coûts de stockage avec Amazon S3 Intelligent-Tiering.