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à.
# Usando EventBridge
Amazon S3 può inviare eventi ad Amazon EventBridge ogni volta che si verificano determinati eventi nel tuo bucket. A differenza di altre destinazioni, non è necessario selezionare i tipi di eventi che si desidera inviare. Dopo averlo EventBridge abilitato, tutti gli eventi seguenti vengono inviati a. EventBridge È possibile utilizzare EventBridge le regole per indirizzare gli eventi verso destinazioni aggiuntive. Di seguito sono elencati gli eventi a cui invia Amazon S3. EventBridge
| Tipo di evento | Description |
| --- | --- |
| *Oggetto creato* | Un oggetto è stato creato. Il campo motivo nella struttura dei messaggi di evento indica quale API S3 è stata utilizzata per creare l’oggetto: [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html), [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html), [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html) o [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html). |
| *Oggetto eliminato () DeleteObject* *Oggetto eliminato (scadenza del ciclo di vita)* | Un oggetto è stato eliminato. Quando un oggetto viene eliminato utilizzando una chiamata API S3, il campo del motivo è impostato su DeleteObject. Quando un oggetto viene eliminato da una regola di scadenza del ciclo di vita S3, il campo motivo è impostato su Scadenza ciclo di vita. Per ulteriori informazioni, consulta [Oggetti in scadenza](lifecycle-expire-general-considerations.md). Quando viene eliminato un oggetto senza controllo delle versioni o quando viene eliminato in modo permanente un oggetto con controllo delle versioni, il campo del tipo di eliminazione è impostato su Permanently Deleted. Quando viene creato un indicatore di eliminazione per un oggetto con controllo delle versioni, il campo `deletion-type` è impostato su Delete Marker Created. Per ulteriori informazioni, consulta [Eliminazione di versioni di oggetti da un bucket con funzione Controllo delle versioni abilitata](DeletingObjectVersions.md). |
| *Ripristino oggetti avviato* | È stato avviato un ripristino dell’oggetto dalla classe di archiviazione S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive oppure dal livello Accesso archivio o Accesso archivio approfondito di Piano intelligente S3. Per ulteriori informazioni, consulta [Utilizzo di oggetti archiviati](archived-objects.md). |
| *Ripristino oggetti completato* | È stato completato un ripristino di oggetti. |
| *Ripristino oggetti scaduto* | La copia temporanea di un oggetto ripristinato da S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive è scaduta ed è stata eliminata. |
| *Classe di archiviazione di oggetti modificata* | Un oggetto è stato trasferito a una classe di archiviazione diversa. Per ulteriori informazioni, consulta [Trasferimento degli oggetti utilizzando il ciclo di vita Amazon S3](lifecycle-transition-general-considerations.md). |
| *Livello di accesso agli oggetti modificato* | Un oggetto è stato trasferito al livello S3 Intelligent-Tiering Archive Access o Deep Archive Access. Per ulteriori informazioni, consulta [Gestione dei costi di storage con il Piano intelligente Amazon S3](intelligent-tiering.md). |
| *Aggiornamento dell'ACL dell'oggetto* | La lista di controllo degli accessi (ACL) di un oggetto è stata impostata utilizzando `PutObjectAcl`. Un evento non viene generato quando una richiesta non comporta alcuna modifica all'ACL di un oggetto. Per ulteriori informazioni, consulta [Panoramica delle liste di controllo accessi (ACL)](acl-overview.md). |
| *Aggiunti tag degli oggetti* | Un set di tag è stato aggiunto a un oggetto utilizzando `PutObjectTagging`. Per ulteriori informazioni, consulta [Classificazione degli oggetti utilizzando i tag](object-tagging.md). |
| *Eliminazione di tag degli oggetti* | Tutti i tag sono stati rimossi da un oggetto utilizzando `DeleteObjectTagging`. Per ulteriori informazioni, consulta [Classificazione degli oggetti utilizzando i tag](object-tagging.md). |
**Nota**
Per ulteriori informazioni su come i tipi di eventi di Amazon S3 vengono mappati ai tipi di EventBridge eventi, consulta. [EventBridge Mappatura e risoluzione dei problemi di Amazon](ev-mapping-troubleshooting.md)
Puoi utilizzare Amazon S3 Event Notifications con EventBridge per scrivere regole che intraprendano azioni quando si verifica un evento nel tuo bucket. Ad esempio, è possibile scegliere di ricevere una notifica. Per ulteriori informazioni, consulta [Cos'è? EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) nella *Amazon EventBridge User Guide*.
Per ulteriori informazioni sulle azioni e sui tipi di dati con cui puoi interagire utilizzando l' EventBridge API, consulta l'[Amazon EventBridge API Reference](https://docs.aws.amazon.com/eventbridge/latest/APIReference/Welcome.html) nell'*Amazon EventBridge API Reference*.
Per informazioni sui prezzi, consulta la pagina [ EventBridge dei prezzi di Amazon](https://aws.amazon.com/eventbridge/pricing).
**Topics**
+ [EventBridge Autorizzazioni Amazon](ev-permissions.md)
+ [Attivazione di Amazon EventBridge](enable-event-notifications-eventbridge.md)
+ [EventBridge struttura dei messaggi di evento](ev-events.md)
+ [EventBridge Mappatura e risoluzione dei problemi di Amazon](ev-mapping-troubleshooting.md)
# EventBridge Autorizzazioni Amazon
Amazon S3 non richiede autorizzazioni aggiuntive per fornire eventi ad Amazon. EventBridge
# Attivazione di Amazon EventBridge
Puoi abilitare Amazon EventBridge utilizzando la console S3, AWS Command Line Interface (AWS CLI) o l'API REST di Amazon S3.
**Nota**
Dopo l'attivazione EventBridge, occorrono circa cinque minuti prima che le modifiche abbiano effetto.
## Utilizzo della console S3
**Per abilitare la consegna EventBridge degli eventi nella console S3.**
1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nel riquadro di navigazione sinistro, scegli **Bucket per uso generico**.
1. Nell’elenco dei bucket scegli il nome del bucket per il quale desideri abilitare gli eventi.
1. Scegliere **Properties (Proprietà)**.
1. Vai alla sezione **Notifiche eventi** e trova la EventBridge sottosezione **Amazon**. Scegli **Modifica**.
1. In **Invia notifiche ad Amazon EventBridge per tutti gli eventi in questo bucket scegli **Attiva****.
## Usando il AWS CLI
L'esempio seguente crea una configurazione di notifica bucket per bucket con *`amzn-s3-demo-bucket1`* Amazon EventBridge abilitato.
```
aws s3api put-bucket-notification-configuration --bucket amzn-s3-demo-bucket1 --notification-configuration='{ "EventBridgeConfiguration": {} }'
```
## Utilizzo della REST API
Puoi abilitare Amazon EventBridge su un bucket a livello di codice chiamando l'API REST di Amazon S3. Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotificationConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotificationConfiguration.html) in *Amazon Simple Storage Service API Reference* (Guida di riferimento per l'API di Amazon Simple Storage Service).
L'esempio seguente mostra l'XML utilizzato per creare una configurazione di notifica bucket con Amazon EventBridge abilitato.
```
```
## Creazione di regole EventBridge
Una volta abilitato, puoi creare EventBridge regole Amazon per determinate attività. Ad esempio, è possibile inviare notifiche via e-mail quando viene creato un oggetto. Per un tutorial completo, consulta [Tutorial: Inviare una notifica quando viene creato un oggetto Amazon S3](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-s3-object-created-tutorial.html) nella *Amazon EventBridge User* Guide.
# 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](EventBridge.md).
+ `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](#ev-events-detail).
## 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: [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html), [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html), [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html) o [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html). 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](lifecycle-expire-general-considerations.md).
+ `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](DeletingObjectVersions.md).
**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](archived-objects.md).
+ `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](archived-objects.md).
+ `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](lifecycle-transition-general-considerations.md).
+ `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](intelligent-tiering.md).
# EventBridge Mappatura e risoluzione dei problemi di Amazon
La tabella seguente descrive come i tipi di eventi Amazon S3 vengono mappati ai tipi di eventi Amazon EventBridge .
| Tipo di evento S3 | Tipo di EventBridge dettaglio Amazon |
| --- | --- |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html) [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html) [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html) [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html) | Oggetto creato |
| ObjectRemoved:Delete ObjectRemoved:DeleteMarkerCreated LifecycleExpiration:Delete LifecycleExpiration:DeleteMarkerCreated | Oggetto eliminato |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html) | Ripristino oggetti avviato |
| ObjectRestore:Completed | Ripristino oggetti completato |
| ObjectRestore:Delete | Ripristino oggetti scaduto |
| LifecycleTransition | Classe di archiviazione di oggetti modificata |
| IntelligentTiering | Livello di accesso agli oggetti modificato |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html) | Aggiunti tag degli oggetti |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html) | Eliminazione di tag degli oggetti |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectAcl.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectAcl.html) | Aggiornamento dell'ACL dell'oggetto |
## EventBridge Risoluzione dei problemi di Amazon
Per informazioni su come risolvere i problemi EventBridge, consulta Troubleshooting [Amazon EventBridge nella Amazon EventBridge ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-troubleshooting.html) *User Guide*.