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

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

EventBridge struttura dei messaggi di evento

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

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

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

  • account— L' Account AWS ID a 12 cifre del proprietario del bucket.

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

  • region— Identifica il bucket. Regione AWS

  • 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 esempi di alcuni messaggi di notifica degli eventi di Amazon S3 che possono essere inviati 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— Account AWS ID o principale del AWS servizio 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.