Struttura del messaggio di evento EventBridge - Amazon Simple Storage Service
Esempi di struttura dei messaggi di eventoCampo dei dettagli del messaggio di evento

Struttura del messaggio di evento EventBridge

Il messaggio di notifica inviato da Amazon S3 per pubblicare un evento è in formato JSON. Quando Amazon S3 invia un evento ad Amazon EventBridge, sono presenti i campi seguenti.

  • version: attualmente 0 (zero) per tutti gli eventi.

  • id: un UUID generato per ogni evento.

  • detail-type: il tipo di evento inviato. Per un elenco dei tipi di evento, consulta Utilizzo di EventBridge.

  • source: identifica il servizio che ha generato l’evento.

  • account: l’ID a 12 cifre dell’Account AWS del proprietario del bucket.

  • time: l’ora in cui si è verificato l’evento.

  • region: identifica la Regione AWS del bucket.

  • resources: un array JSON che contiene il nome della risorsa Amazon (ARN) del bucket.

  • detail – Un oggetto JSON contenente informazioni sull'evento. Per ulteriori informazioni su ciò che può essere incluso in questo campo, consulta Campo dei dettagli del messaggio di evento.

Esempi di struttura dei messaggi di evento

Di seguito sono riportati alcuni dei messaggi di notifica degli eventi Amazon S3 che è possibile inviare ad Amazon EventBridge.

Oggetto creato

{
  "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"
  }
}

Oggetto eliminato (utilizzando 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"
  }
}

Oggetto eliminato (utilizzando la scadenza del ciclo di vita)

{
  "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"
  }
}

Ripristino oggetti completato

{
  "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"
  }
}

Campo dei dettagli del messaggio di evento

Il campo dei dettagli contiene un oggetto JSON con informazioni sull'evento. I seguenti campi possono essere presenti nel campo dettagli.

  • version: attualmente 0 (zero) per tutti gli eventi.

  • bucket: informazioni sul bucket Amazon S3 coinvolto nell’evento.

  • object: informazioni sull’oggetto Amazon S3 coinvolto nell’evento.

  • request-id: ID della richiesta nella risposta S3.

  • requester: ID dell’Account AWS o principale del servizio AWS del richiedente.

  • source-ip-address: l’indirizzo IP di origine della richiesta S3. Presente solo per eventi attivati da una richiesta S3.

  • reason: per gli eventi Oggetto creato, l’API S3 utilizzata per creare l’oggetto: PutObject, POST Object, CopyObject o CompleteMultipartUpload. Per gli eventi Oggetto eliminato, questo campo è impostato su DeleteObject quando un oggetto viene eliminato da una chiamata API S3, oppure su Scadenza del ciclo di vita quando un oggetto viene eliminato da una regola di scadenza del ciclo di vita S3. Per ulteriori informazioni, consulta Oggetti in scadenza.

  • deletion-type: per gli eventi Oggetto eliminato, quando viene eliminato un oggetto senza controllo delle versioni o quando viene eliminato in modo permanente un oggetto con controllo delle versioni, questo campo è impostato su Eliminato definitivamente. Quando viene creato un contrassegno di eliminazione per un oggetto con versione, verrà impostato su Contrassegno di eliminazione creato. Per ulteriori informazioni, consulta Eliminazione di versioni di oggetti da un bucket con funzione Controllo delle versioni abilitata.

    Nota

    Alcuni attributi degli oggetti (come etag e size) sono presenti solo quando viene creato un marcatore di cancellazione.

  • restore-expiry-time: per gli eventi Ripristino oggetto completato, il momento in cui la copia temporanea dell’oggetto viene eliminata da S3. Per ulteriori informazioni, consulta Utilizzo di oggetti archiviati.

  • source-storage-class: per gli eventi Ripristino oggetto avviato e Ripristino oggetto completato, la classe di archiviazione dell’oggetto in fase di ripristino. Per ulteriori informazioni, consulta Utilizzo di oggetti archiviati.

  • destination-storage-class: per gli eventi Classe di archiviazione di oggetti modificata, la nuova classe di archiviazione dell’oggetto. Per ulteriori informazioni, consulta Trasferimento degli oggetti utilizzando il ciclo di vita Amazon S3.

  • destination-access-tier: per gli eventi Livello di accesso agli oggetti modificato, il nuovo livello di accesso dell’oggetto. Per ulteriori informazioni, consulta Gestione dei costi di storage con il Piano intelligente Amazon S3.