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 che viene 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 la parte Regione AWS del bucket.

  • resources— Un array JSON che contiene l'Amazon Resource Name (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— Indirizzo IP di origine della richiesta S3. Presente solo per eventi attivati da una richiesta S3.

  • reason— Per gli eventi Object Created, l'API S3 utilizzata per creare l'oggetto: PutObject, POST ObjectCopyObject, o. CompleteMultipartUpload Per gli eventi Object Deleted, è impostato su DeleteObjectquando un oggetto viene eliminato da una chiamata API S3 o Lifecycle Explosion quando un oggetto viene eliminato da una regola di scadenza S3 Lifecycle. Per ulteriori informazioni, consulta Oggetti in scadenza.

  • deletion-type— Per gli eventi Object Deleted, quando un oggetto senza versione viene eliminato o un oggetto con versione viene eliminato definitivamente, questa opzione è impostata 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 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 il Piano intelligente Amazon S3.