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 che Amazon S3 invia per pubblicare un evento è nel JSON formato. Quando Amazon S3 invia un evento ad Amazon EventBridge, sono presenti i seguenti campi.

  • versione — Attualmente 0 (zero) per tutti gli eventi.

  • id: una versione 4 UUID generata per ogni evento.

  • tipo di dettaglio — Il tipo di evento inviato. Per un elenco dei tipi di evento, consulta Usando EventBridge.

  • origine — Identifica il servizio che ha originato l'evento.

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

  • time (Ora): momento in cui si è verificato l'evento.

  • regione — Identifica la Regione AWS del bucket.

  • resources: un JSON array che contiene l'Amazon Resource Name (ARN) del bucket.

  • detail — Un JSON oggetto che contiene 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 di dettaglio contiene un JSON oggetto con informazioni sull'evento. I seguenti campi possono essere presenti nel campo dettagli.

  • versione — Attualmente 0 (zero) per tutti gli eventi.

  • bucket — Informazioni sul bucket Amazon S3 coinvolto nell'evento.

  • oggetto — Informazioni sull'oggetto Amazon S3 coinvolto nell'evento.

  • richiesta id — ID della richiesta nella risposta S3.

  • richiedente: Account AWS ID o principale del AWS servizio del richiedente.

  • source-ip-address— Indirizzo IP di origine della richiesta S3. Presente solo per eventi attivati da una richiesta S3.

  • motivo: per gli eventi Object Created, l'S3 API utilizzato per creare l'oggetto: PutObject, POSTObject CopyObject, o. CompleteMultipartUpload Per gli eventi Object Deleted, questo valore è impostato su DeleteObjectquando un oggetto viene eliminato da una API chiamata S3 o Lifecycle Expiration quando un oggetto viene eliminato da una regola di scadenza del ciclo di vita S3. Per ulteriori informazioni, consulta Oggetti in scadenza.

  • tipo di eliminazione — Per eventi Oggetto eliminato, quando viene eliminato un oggetto senza versione o quando viene eliminato in modo permanente un oggetto con versione, questo è impostato su Eliminato permanentemente. 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 dell'oggetto (come etag esize) sono presenti solo quando viene creato un marker di eliminazione.

  • restore-expiry-time— Per gli eventi Object Restore Completed, l'ora in cui la copia temporanea dell'oggetto verrà eliminata da S3. Per ulteriori informazioni, consulta Utilizzo di oggetti archiviati.

  • source-storage-class— Per gli eventi Object Restore Initiated e Object Restore Completed, la classe di archiviazione dell'oggetto da ripristinare. Per ulteriori informazioni, consulta Utilizzo di oggetti archiviati.

  • destination-storage-class— Per gli eventi Object Storage Class Changed, 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 Object Access Tier Changed, il nuovo livello di accesso dell'oggetto. Per ulteriori informazioni, consulta Gestione dei costi di storage con Amazon S3 Intelligent-Tiering.