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à.
# Notifiche di eventi Amazon S3
Puoi utilizzare la funzionalità Notifiche di eventi Amazon S3 per ricevere le notifiche relative a quando si verificano determinati eventi nel bucket S3. Per abilitare le notifiche, aggiungi una configurazione di notifica che identifichi gli eventi che Amazon S3 deve pubblicare. Assicurati inoltre che identifichi le destinazioni a cui Amazon S3 deve inviare le notifiche. Questa configurazione viene archiviata nella risorsa secondaria *notifica* associata a un bucket. Per ulteriori informazioni, consulta [Opzioni di configurazione dei bucket per uso generico](UsingBucket.md#bucket-config-options-intro). Amazon S3 fornisce un'API per la gestione di questa risorsa secondaria.
**Importante**
Le notifiche degli eventi di Amazon S3 sono progettate per essere distribuite almeno una volta. Le notifiche di eventi in genere vengono distribuite in pochi secondi, ma a volte può essere necessario un minuto o più.
## Panoramica delle notifiche eventi di Amazon S3.
Attualmente, Amazon S3 può pubblicare notifiche per i seguenti eventi:
+ Eventi di creazione nuovo oggetto
+ Eventi di rimozione di oggetti
+ Eventi di ripristino di oggetti
+ Un evento di perdita oggetto Reduced Redundancy Storage (RRS)
+ Eventi di replica
+ Eventi di scadenza del ciclo di vita S3
+ Eventi di transizione del ciclo di vita S3
+ Eventi di archiviazione automatica di S3 Intelligent-Tiering
+ Eventi di assegnazione di tag agli oggetti
+ Eventi di ACL PUT di oggetto
Per una descrizione completa dei tipi di evento, consulta [Tipi di eventi supportati per SQS, SNS e Lambda](notification-how-to-event-types-and-destinations.md#supported-notification-event-types).
Amazon S3 può inviare messaggi di notifica degli eventi alle seguenti destinazioni. Il valore dell'Amazon Resource Name (ARN) di queste destinazioni viene specificato nella configurazione della notifica.
+ Argomenti su Amazon Simple Notification Service (Amazon SNS)
+ Code di Amazon Simple Queue Service (Amazon SQS)
+ AWS Lambda funzione
+ Amazon EventBridge
Per ulteriori informazioni, consulta [Destinazioni eventi supportate](notification-how-to-event-types-and-destinations.md#supported-notification-destinations).
**Nota**
Le code FIFO (First-In-First-Out) di Amazon Simple Queue Service non sono supportate come destinazione delle notifiche degli eventi di Amazon S3. Per inviare una notifica per un evento Amazon S3 a una coda FIFO di Amazon SQS, puoi utilizzare Amazon. EventBridge Per ulteriori informazioni, consulta [Attivazione di Amazon EventBridge](enable-event-notifications-eventbridge.md).
**avvertimento**
Se la notifica scrive nello stesso bucket che attiva la notifica, potrebbe causare un loop di esecuzione. Ad esempio, se il bucket attiva una funzione Lambda ogni volta che un oggetto viene caricato e la funzione carica un oggetto nel bucket, allora la funzione indirettamente lo attiva. Per evitare questo, utilizzare due bucket, oppure configurare il trigger in modo che venga applicato solo a un prefisso utilizzato per gli oggetti in entrata.
*Per ulteriori informazioni e un esempio di utilizzo delle notifiche di Amazon S3 con AWS Lambda, consulta [AWS Lambda Using with Amazon S3](https://docs.aws.amazon.com/lambda/latest/dg/with-s3.html) nella AWS Lambda Developer Guide.*
Per ulteriori informazioni sul numero di configurazioni di notifica degli eventi che è possibile creare per bucket, consulta [Quote di servizio Amazon S3](https://docs.aws.amazon.com/general/latest/gr/s3.html#limits_s3) in *Riferimenti generali di AWS *.
Per ulteriori informazioni sulle notifiche degli eventi, consulta le sezioni seguenti.
**Topics**
+ [
## Panoramica delle notifiche eventi di Amazon S3.
](#notification-how-to-overview)
+ [
# Tipi di notifiche eventi e destinazioni
](notification-how-to-event-types-and-destinations.md)
+ [
# Utilizzo di Amazon SQS, Amazon SNS e Lambda
](how-to-enable-disable-notification-intro.md)
+ [
# Usando EventBridge
](EventBridge.md)
# Tipi di notifiche eventi e destinazioni
Amazon S3 supporta diversi tipi di notifiche di eventi e destinazioni in cui è possibile pubblicare le notifiche. Puoi specificare il tipo di evento e la destinazione durante la configurazione delle notifiche degli eventi. È possibile specificare una sola destinazione per ogni notifica di evento. Le notifiche degli eventi di Amazon S3 inviano una voce di evento per ogni messaggio di notifica.
**Topics**
+ [
## Destinazioni eventi supportate
](#supported-notification-destinations)
+ [
## Tipi di eventi supportati per SQS, SNS e Lambda
](#supported-notification-event-types)
+ [
## Tipi di eventi supportati per Amazon EventBridge
](#supported-notification-event-types-eventbridge)
+ [
## Ordinamento degli eventi e duplicazione degli eventi
](#event-ordering-and-duplicate-events)
## Destinazioni eventi supportate
Amazon S3 può inviare messaggi di notifica degli eventi alle seguenti destinazioni.
+ Argomenti su Amazon Simple Notification Service (Amazon SNS)
+ Code di Amazon Simple Queue Service (Amazon SQS)
+ AWS Lambda
+ Amazon EventBridge
Tuttavia, è possibile specificare un solo tipo di destinazione per ogni notifica di evento.
**Nota**
È necessario concedere ad Amazon S3; le autorizzazioni per pubblicare i messaggi in un argomento Amazon SNS o in una coda Amazon SQS. Devi inoltre concedere ad Amazon S3 l'autorizzazione a richiamare una AWS Lambda funzione per tuo conto. Per istruzioni su come concedere queste autorizzazioni, consulta [Concessione di autorizzazioni per pubblicare messaggi di notifica eventi in una destinazione](grant-destinations-permissions-to-s3.md).
### Argomento Amazon SNS
Amazon SNS è un servizio di messaggistica push completamente gestito e flessibile. Tramite questo servizio, è possibile inviare messaggi push a dispositivi mobili o servizi distribuiti. Con SNS puoi pubblicare un messaggio e inviarlo una o più volte. Al momento, l'SNS standard è consentito solo come destinazione di notifica di eventi S3, mentre l'SNS FIFO non è consentito.
Amazon SNS coordina e gestisce la consegna o l'invio di messaggi agli endpoint o ai client abbonati. È possibile utilizzare la console Amazon SNS per creare un argomento Amazon SNS a cui inviare le notifiche.
L'argomento deve essere nello Regione AWS stesso del bucket Amazon S3. Per informazioni sulla creazione di un argomento Amazon SNS, consulta [Nozioni di base](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) nella *Guida per sviluppatori di Amazon Simple Notification Service* e [Domande frequenti su Amazon SNS](https://aws.amazon.com/sns/faqs/).
Per poter utilizzare l'argomento Amazon SNS creato come destinazione della notifica di eventi, è necessario disporre di quanto segue:
+ L'Amazon Resource Name (ARN) per l'argomento Amazon SNS
+ Un'iscrizione valida a un argomento di Amazon SNS. Con esso, gli iscritti agli argomenti vengono informati quando un messaggio viene pubblicato sul tuo argomento Amazon SNS.
### Coda Amazon SQS
Amazon SQS offre code ospitate affidabili e scalabili per lo storage dei messaggi mentre transitano tra computer. Tramite Amazon SQS è possibile trasmettere qualsiasi volume di dati senza richiedere la disponibilità costante di altri servizi. È possibile utilizzare la console Amazon SQS per creare una coda Amazon SQS a cui inviare le notifiche.
La coda Amazon SQS deve trovarsi nella stessa Regione AWS posizione del bucket Amazon S3. Per informazioni sulla creazione di una coda di Amazon SQS, consulta [Cos'è Amazon Simple Queue Service?](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/welcome.html) e [Nozioni di base su Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-getting-started.html) nella *Guida per sviluppatori di Amazon Simple Queue Service*.
Per poter utilizzare la coda Amazon SQS come destinazione della notifica eventi, devi disporre di quanto segue:
+ L'Amazon Resource Name (ARN) per la coda di Amazon SQS
**Nota**
Le code FIFO (First-In-First-Out) di Amazon Simple Queue Service non sono supportate come destinazione delle notifiche degli eventi di Amazon S3. Per inviare una notifica per un evento Amazon S3 a una coda FIFO di Amazon SQS, puoi utilizzare Amazon. EventBridge Per ulteriori informazioni, consulta [Attivazione di Amazon EventBridge](enable-event-notifications-eventbridge.md).
### funzione Lambda
Puoi utilizzarlo AWS Lambda per estendere altri AWS servizi con una logica personalizzata o creare un backend personalizzato che operi su AWS larga scala, con prestazioni e sicurezza. Con Lambda, è possibile creare applicazioni separate e basate su eventi che vengono eseguite solo quando necessario. È inoltre possibile utilizzarlo per dimensionare automaticamente queste applicazioni da poche richieste al giorno a migliaia al secondo.
Lambda esegue codice personalizzato in risposta agli eventi dei bucket Amazon S3. Il codice personalizzato viene caricato su Lambda e quindi viene creata quella che si chiama funzione Lambda. Quando Amazon S3 rileva un evento di un tipo specifico, può pubblicare l'evento AWS Lambda e richiamare la tua funzione in Lambda. In risposta, Lambda esegue la tua funzione. Un tipo di evento che potrebbe rilevare, ad esempio, è un evento di creazione oggetto.
Puoi usare la AWS Lambda console per creare una funzione Lambda che utilizza l' AWS infrastruttura per eseguire il codice per tuo conto. La funzione Lambda deve trovarsi nella stessa regione del bucket S3. Per impostare la funzione Lambda come destinazione di notifica eventi, è inoltre necessario disporre del nome o dell'ARN di una funzione Lambda.
**avvertimento**
Se la notifica scrive nello stesso bucket che attiva la notifica, potrebbe causare un loop di esecuzione. Ad esempio, se il bucket attiva una funzione Lambda ogni volta che un oggetto viene caricato e la funzione carica un oggetto nel bucket, allora la funzione indirettamente lo attiva. Per evitare questo, utilizzare due bucket, oppure configurare il trigger in modo che venga applicato solo a un prefisso utilizzato per gli oggetti in entrata.
*Per ulteriori informazioni e un esempio di utilizzo delle notifiche di Amazon S3 con AWS Lambda, consulta [AWS Lambda Using with Amazon S3](https://docs.aws.amazon.com/lambda/latest/dg/with-s3.html) nella AWS Lambda Developer Guide.*
### Amazon EventBridge
Amazon EventBridge è un bus di eventi senza server, che riceve eventi dai AWS servizi. Puoi impostare regole per abbinare gli eventi e distribuirli ai target, come ad esempio un servizio AWS o un endpoint HTTP. Per ulteriori informazioni, consulta [Cosa c'è EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) nella *Amazon EventBridge User Guide*.
A differenza di altre destinazioni, puoi abilitare o disabilitare gli eventi a cui inviare eventi EventBridge per un bucket. Se abiliti la consegna, tutti gli eventi vengono inviati a EventBridge. Inoltre, puoi utilizzare EventBridge le regole per indirizzare gli eventi verso destinazioni aggiuntive.
## Tipi di eventi supportati per SQS, SNS e Lambda
Amazon S3 pubblica i tipi di eventi riportati di seguito. Questi tipi di eventi devono essere specificati nella configurazione delle notifiche.
| Tipi di eventi | Description |
| --- | --- |
| `s3:TestEvent` | Quando una notifica è abilitata, Amazon S3 pubblica una notifica di prova. Questo serve a garantire che l'argomento esista e che il proprietario del bucket abbia l'autorizzazione a pubblicare l'argomento specificato. Se l'attivazione della notifica ha esito negativo, non verrà ricevuta alcuna notifica di prova. |
| `s3:ObjectCreated:*` `s3:ObjectCreated:Put` `s3:ObjectCreated:Post` `s3:ObjectCreated:Copy` `s3:ObjectCreated:CompleteMultipartUpload` | Le operazioni API di Amazon S3, come `PUT`, `POST` e `COPY`, possono creare un oggetto. Con questi tipi di eventi, puoi abilitare le notifiche quando un oggetto viene creato tramite un'API specifica. In alternativa, puoi utilizzare il tipo di evento `s3:ObjectCreated:*` per richiedere la notifica indipendentemente dall'API utilizzata per creare un oggetto. `s3:ObjectCreated:CompleteMultipartUpload` include gli oggetti creati con [https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html) per le operazioni di copia. |
| `s3:ObjectRemoved:*` `s3:ObjectRemoved:Delete` `s3:ObjectRemoved:DeleteMarkerCreated` | Utilizzando i tipi di evento `ObjectRemoved`, è possibile attivare la notifica quando un oggetto o un gruppo di oggetti viene rimosso da un bucket. È possibile richiedere una notifica quando viene eliminato un oggetto o quando viene eliminato in modo permanente un oggetto con versione utilizzando il tipo di evento `s3:ObjectRemoved:Delete`. In alternativa, è possibile richiedere una notifica quando viene creato un contrassegno di eliminazione per un oggetto con versione utilizzando `s3:ObjectRemoved:DeleteMarkerCreated`. Per istruzioni su come eliminare gli oggetti con versione, consulta [Eliminazione di versioni di oggetti da un bucket con funzione Controllo delle versioni abilitata](DeletingObjectVersions.md). Inoltre, è possibile utilizzare un carattere jolly `s3:ObjectRemoved:*` per richiedere la notifica ogni volta che viene eliminato un oggetto. Queste notifiche di eventi non provvedono alcun avviso per le eliminazioni automatiche dalle configurazioni del ciclo di vita o dalle operazioni che hanno avuto esito negativo. |
| `s3:ObjectRestore:*` `s3:ObjectRestore:Post` `s3:ObjectRestore:Completed` `s3:ObjectRestore:Delete` | Utilizzando i tipi di evento `ObjectRestore`, è possibile ricevere notifiche per l'avvio e il completamento dell'evento durante il ripristino di oggetti dalla classe di storage Recupero flessibile S3 Glacier, dalla classe di storage S3 Glacier Deep Archive, dal livello di accesso all'archiviazione Piano intelligente S3 e dal livello di accesso all'archiviazione Deep Archive Piano intelligente S3. È inoltre possibile ricevere notifiche per la scadenza della copia ripristinata di un oggetto. Il tipo di evento `s3:ObjectRestore:Post` notifica l'avvio del ripristino degli oggetti. Il tipo di evento `s3:ObjectRestore:Completed` notifica il completamento del ripristino. Il tipo di evento `s3:ObjectRestore:Delete` notifica la scadenza della copia temporanea di un oggetto ripristinato. |
| s3:ReducedRedundancyLostObject | Puoi ricevere questo evento di notifica quando Amazon S3 rileva che un oggetto della classe di archiviazione RRS è andato perso. |
| `s3:Replication:*` `s3:Replication:OperationFailedReplication` `s3:Replication:OperationMissedThreshold` `s3:Replication:OperationReplicatedAfterThreshold` `s3:Replication:OperationNotTracked` | Utilizzando i tipi di evento `Replication`, è possibile ricevere notifiche per le configurazioni di replica con metriche di replica S3 o controllo del tempo di replica di S3 (S3 RTC) abilitate. È possibile monitorare l' minute-by-minuteavanzamento degli eventi di replica tenendo traccia dei byte in sospeso, delle operazioni in sospeso e della latenza di replica. Per informazioni sui parametri di replica, consulta [Monitoraggio della replica con parametri, notifiche di eventi e stati](replication-metrics.md). [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonS3/latest/userguide/notification-how-to-event-types-and-destinations.html) |
| `s3:LifecycleExpiration:*` `s3:LifecycleExpiration:Delete` `s3:LifecycleExpiration:DeleteMarkerCreated` | Utilizzando i tipi di evento `LifecycleExpiration`, è possibile ricevere una notifica quando Amazon S3 elimina un oggetto in base alla configurazione del ciclo di vita S3. Il tipo di evento `s3:LifecycleExpiration:Delete` avvisa quando viene eliminato un oggetto in un bucket senza versione. Notifica inoltre quando una versione dell'oggetto viene eliminata definitivamente da una configurazione del ciclo di vita S3. Il tipo di evento `s3:LifecycleExpiration:DeleteMarkerCreated` notifica quando il ciclo di vita S3 crea un contrassegno di eliminazione quando viene eliminata una versione corrente di un oggetto in un bucket con versione. |
| s3:LifecycleTransition | Puoi ricevere questo evento di notifica quando un oggetto viene trasferito a un'altra classe di archiviazione Amazon S3 mediante una configurazione di S3 Lifecycle. |
| s3:IntelligentTiering | Puoi ricevere questo evento di notifica quando un oggetto all'interno della classe di archiviazione S3 Intelligent-Tiering viene spostato nel livello Archive Access o Deep Archive Access. |
| `s3:ObjectTagging:*` `s3:ObjectTagging:Put` `s3:ObjectTagging:Delete` | Utilizzando i tipi di evento `ObjectTagging`, è possibile attivare la notifica quando un tag oggetto viene aggiunto o eliminato da un oggetto. Il tipo di evento `s3:ObjectTagging:Put` notifica quando un tag viene inserito su un oggetto tramite richiesta PUT o quando viene aggiornato un tag esistente. Il tipo di evento `s3:ObjectTagging:Delete` notifica quando un tag viene rimosso da un oggetto. |
| s3:ObjectAcl:Put | Puoi ricevere questo evento di notifica quando un'ACL viene inserita su un oggetto tramite richiesta PUT o quando viene modificata un'ACL esistente. Un evento non viene generato quando una richiesta non comporta alcuna modifica all'ACL di un oggetto. |
## Tipi di eventi supportati per Amazon EventBridge
Per un elenco dei tipi di eventi che Amazon S3 invierà ad Amazon EventBridge, consulta. [Usando EventBridge](EventBridge.md)
## Ordinamento degli eventi e duplicazione degli eventi
Amazon S3 Event Notifications è progettato per fornire notifiche almeno una volta, ma non è garantito che arrivino nello stesso ordine in cui si sono verificati gli eventi. In rare occasioni, il meccanismo di ripetizione di Amazon S3 potrebbe causare notifiche di eventi S3 duplicate per lo stesso evento oggetto. Per ulteriori informazioni sulla gestione degli eventi duplicati o fuori ordine, consulta la sezione [Gestire l'ordine degli eventi e gli eventi duplicati con le notifiche degli eventi di Amazon S3](https://aws.amazon.com/blogs/storage/manage-event-ordering-and-duplicate-events-with-amazon-s3-event-notifications/) su *AWS Storage Blog*.
# Utilizzo di Amazon SQS, Amazon SNS e Lambda
L'abilitazione delle notifiche è un'operazione a livello di bucket. Le informazioni di configurazione delle notifiche vengono memorizzate nella risorsa secondaria di *notifica* associata a un bucket. Dopo avere creato o modificato la configurazione di notifica del bucket, in genere è necessario attendere 5 minuti affinché le modifiche abbiano effetto. Si verificherà un `s3:TestEvent` quando la notifica viene attivata per la prima volta. Per gestire la configurazione delle notifiche, è possibile utilizzare i metodi indicati di seguito:
+ **Utilizzo della console di Amazon S3** — E' possibile utilizzare l'interfaccia utente della console per impostare una configurazione di notifiche su un bucket senza dover scrivere alcun codice. Per ulteriori informazioni, consulta [Attivazione e configurazione delle notifiche di eventi tramite la console di Amazon S3](enable-event-notifications.md).
+ **Utilizzo programmatico** di AWS SDKs: internamente, sia la console che la SDKs chiamata all'API REST di Amazon S3 per gestire le sottorisorse di *notifica associate* al bucket. Per esempi di configurazione di notifiche che utilizzano gli SDK di AWS , consulta [Spiegazione passo per passo: configurare un bucket per le notifiche (argomento SNS o coda SQS)](ways-to-add-notification-config-to-bucket.md).
**Nota**
Puoi effettuare le chiamate a REST API di Amazon S3 anche direttamente dal codice. Tuttavia, ciò può risultare scomodo in quanto richiede la scrittura di codice per autenticare le richieste.
Indipendentemente dal metodo utilizzato, Amazon S3 archivia la configurazione delle notifiche in formato XML nella risorsa secondaria *notifica* associata a un bucket. Per informazioni sulle risorse secondarie del bucket, consulta la sezione [Opzioni di configurazione dei bucket per uso generico](UsingBucket.md#bucket-config-options-intro).
**Nota**
Se si verificano più notifiche di eventi falliti a causa di destinazioni eliminate, è possibile che si riceva il messaggio **Impossibile convalidare le seguenti configurazioni di destinazione** quando si cerca di eliminarle. È possibile risolvere il problema nella console S3 eliminando contemporaneamente tutte le notifiche non riuscite.
**Topics**
+ [
# Concessione di autorizzazioni per pubblicare messaggi di notifica eventi in una destinazione
](grant-destinations-permissions-to-s3.md)
+ [
# Attivazione e configurazione delle notifiche di eventi tramite la console di Amazon S3
](enable-event-notifications.md)
+ [
## Configurazione delle notifiche degli eventi a livello di programmazione
](#event-notification-configuration)
+ [
# Spiegazione passo per passo: configurare un bucket per le notifiche (argomento SNS o coda SQS)
](ways-to-add-notification-config-to-bucket.md)
+ [
# Configurazione delle notifiche di eventi mediante il filtro dei nomi delle chiavi oggetto
](notification-how-to-filtering.md)
+ [
# Struttura del messaggio di evento
](notification-content-structure.md)
# Concessione di autorizzazioni per pubblicare messaggi di notifica eventi in una destinazione
È necessario concedere al principale di Amazon S3 le autorizzazioni necessarie per richiamare l'API pertinente per pubblicare i messaggi in un argomento SNS, una coda SQS o una funzione Lambda. In questo modo Amazon S3 può pubblicare messaggi di notifica di eventi in una destinazione.
Per risolvere i problemi relativi alla pubblicazione dei messaggi di notifica di eventi su una destinazione, consulta [Risoluzione dei problemi relativi alla pubblicazione delle notifiche di eventi di Amazon S3 in un argomento di Servizio di notifica semplice Amazon](https://repost.aws/knowledge-center/sns-not-receiving-s3-event-notifications).
**Topics**
+ [
## Concessione delle autorizzazioni per richiamare una funzione AWS Lambda
](#grant-lambda-invoke-permission-to-s3)
+ [
## Concessione di autorizzazioni per pubblicare messaggi in un argomento SNS o una coda SQS
](#grant-sns-sqs-permission-for-s3)
## Concessione delle autorizzazioni per richiamare una funzione AWS Lambda
Amazon S3 pubblica messaggi di evento AWS Lambda invocando una funzione Lambda e fornendo il messaggio dell'evento come argomento.
Quando si utilizza la console di Amazon S3 per configurare le notifiche eventi in un bucket di Amazon S3 per una funzione Lambda, la console configura le autorizzazioni necessarie sulla funzione Lambda. In questo modo Amazon S3 dispone delle autorizzazioni per richiamare la funzione dal bucket. Per ulteriori informazioni, consulta [Attivazione e configurazione delle notifiche di eventi tramite la console di Amazon S3](enable-event-notifications.md).
Puoi anche concedere ad Amazon S3 le autorizzazioni AWS Lambda per richiamare la tua funzione Lambda. Per ulteriori informazioni, consulta [Tutorial: Using AWS Lambda with Amazon S3](https://docs.aws.amazon.com/lambda/latest/dg/with-s3-example.html) nella *AWS Lambda Developer* Guide.
## Concessione di autorizzazioni per pubblicare messaggi in un argomento SNS o una coda SQS
Per concedere ad Amazon S3 le autorizzazioni per pubblicare messaggi sull'argomento SNS o sulla coda SQS, allega una policy AWS Identity and Access Management (IAM) all'argomento SNS o alla coda SQS di destinazione.
Per un esempio di come collegare una policy a un argomento SNS o a una coda SQS, consulta la sezione [Spiegazione passo per passo: configurare un bucket per le notifiche (argomento SNS o coda SQS)](ways-to-add-notification-config-to-bucket.md). Per ulteriori informazioni sulle autorizzazioni, consulta i seguenti argomenti:
+ [Casi di esempio per il controllo degli accessi ad Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/AccessPolicyLanguage_UseCases_Sns.html) nella *Guida per sviluppatori di Amazon Simple Notification Service*
+ [Identity and Access Management in Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/UsingIAM.html) nella *Guida per gli sviluppatori di Amazon Simple Queue Service*
### Policy IAM per un argomento SNS di destinazione
Di seguito è riportato un esempio di policy AWS Identity and Access Management (IAM) da allegare all'argomento SNS di destinazione. Per maggiori informazioni su come utilizzare questa policy per configurare un argomento Amazon SNS di destinazione per le notifiche degli eventi, consulta [Spiegazione passo per passo: configurare un bucket per le notifiche (argomento SNS o coda SQS)](ways-to-add-notification-config-to-bucket.md).
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "example-ID",
"Statement": [
{
"Sid": "Example SNS topic policy",
"Effect": "Allow",
"Principal": {
"Service": "s3.amazonaws.com"
},
"Action": [
"SNS:Publish"
],
"Resource": "arn:aws:sns:us-east-1:111122223333:example-sns-topic",
"Condition": {
"ArnEquals": {
"aws:SourceArn": "arn:aws:s3:::amzn-s3-demo-bucket"
},
"StringEquals": {
"aws:SourceAccount": "bucket-owner-123456789012"
}
}
}
]
}
```
------
### Policy IAM per una coda SQS di destinazione
Di seguito è riportato un esempio di policy IAM collegata alla coda SQS di destinazione. Per maggiori informazioni su come utilizzare questa policy per impostare una coda Amazon SQS di destinazione per le notifiche degli eventi, consulta [Spiegazione passo per passo: configurare un bucket per le notifiche (argomento SNS o coda SQS)](ways-to-add-notification-config-to-bucket.md).
Per utilizzare questa politica, devi aggiornare l'ARN della coda Amazon SQS, il nome del bucket e l'ID del proprietario del bucket. Account AWS
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "example-ID",
"Statement": [
{
"Sid": "example-statement-ID",
"Effect": "Allow",
"Principal": {
"Service": "s3.amazonaws.com"
},
"Action": [
"SQS:SendMessage"
],
"Resource": "arn:aws:sqs:us-east-1:111122223333:queue-name",
"Condition": {
"ArnLike": {
"aws:SourceArn": "arn:aws:s3:*:*:amzn-s3-demo-bucket"
},
"StringEquals": {
"aws:SourceAccount": "bucket-owner-123456789012"
}
}
}
]
}
```
------
Per entrambe le policy IAM di Amazon SNS e Amazon SQS, è possibile specificare la condizione `StringLike` nella policy anziché la condizione `ArnLike`.
Quando si utilizza `ArnLike`, le partizioni, il servizio, l’ID dell’account, il tipo di risorsa e l’ID della risorsa parziale dell’ARN devono corrispondere esattamente all’ARN nel contesto della richiesta. La corrispondenza parziale è consentita solo per la Regione e il percorso della risorsa.
Quando al posto di `ArnLike` viene utilizzato `StringLike`, la corrispondenza ignora la struttura dell’ARN e consente una corrispondenza parziale, indipendentemente dalla parte sostituita dal carattere jolly. Per ulteriori informazioni, consulta [Elementi delle policy JSON IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html) nella *Guida per l'utente di IAM*.
```
"Condition": {
"StringLike": { "aws:SourceArn": "arn:aws:s3:*:*:amzn-s3-demo-bucket" }
}
```
### AWS KMS politica chiave
Se la coda SQS o gli argomenti SNS sono crittografati con una chiave gestita dal cliente AWS Key Management Service (AWS KMS), devi concedere al servizio Amazon S3 l'autorizzazione principale per lavorare con gli argomenti o la coda crittografati. Per concedere al servizio Amazon S3 l'autorizzazione principale, aggiungi l'istruzione seguente alla policy delle chiavi per la chiave gestita dal cliente.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "example-ID",
"Statement": [
{
"Sid": "example-statement-ID",
"Effect": "Allow",
"Principal": {
"Service": "s3.amazonaws.com"
},
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": "*"
}
]
}
```
------
*Per ulteriori informazioni sulle politiche AWS KMS chiave, consulta [Using key policy nella AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html) Developer Guide.AWS Key Management Service *
Per ulteriori informazioni sull'utilizzo della crittografia lato server con AWS KMS Amazon SQS e Amazon SNS, consulta quanto segue:
+ [Gestione delle chiavi](https://docs.aws.amazon.com/sns/latest/dg/sns-key-management.html) nella *Guida per sviluppatori di Amazon Simple Notification Service*.
+ [Gestione delle chiavi](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-key-management.html) nella *Guida per sviluppatori di Amazon Simple Queue Service*.
+ [Crittografia dei messaggi pubblicati su Amazon SNS con AWS KMS](https://aws.amazon.com/blogs/compute/encrypting-messages-published-to-amazon-sns-with-aws-kms/) nel *Blog di calcolo di AWS *.
# Attivazione e configurazione delle notifiche di eventi tramite la console di Amazon S3
È possibile abilitare determinati eventi del bucket per uso generico Amazon S3 per inviare un messaggio di notifica a una destinazione ogni volta che si verificano gli eventi. In questa sezione viene descritto come utilizzare la console di Amazon S3 per abilitare le notifiche di evento. Per informazioni su come utilizzare le notifiche di eventi con Amazon S3 REST APIs, consulta. AWS SDKs [Configurazione delle notifiche degli eventi a livello di programmazione](how-to-enable-disable-notification-intro.md#event-notification-configuration)
**Prerequisiti**: prima di abilitare le notifiche di eventi per il bucket, è necessario impostare uno dei tipi di destinazione e quindi configurare le autorizzazioni. Per ulteriori informazioni, consultare [Destinazioni eventi supportate](notification-how-to-event-types-and-destinations.md#supported-notification-destinations) e [Concessione di autorizzazioni per pubblicare messaggi di notifica eventi in una destinazione](grant-destinations-permissions-to-s3.md).
**Nota**
Le code FIFO (First-In-First-Out) di Amazon Simple Queue Service non sono supportate come destinazione delle notifiche degli eventi di Amazon S3. Per inviare una notifica per un evento Amazon S3 a una coda FIFO di Amazon SQS, puoi utilizzare Amazon. EventBridge Per ulteriori informazioni, consulta [Attivazione di Amazon EventBridge](enable-event-notifications-eventbridge.md).
**Topics**
+ [
## Attivazione delle notifiche di Amazon SNS, Amazon SQS o Lambda tramite la console di Amazon S3
](#enable-event-notifications-sns-sqs-lam)
## Attivazione delle notifiche di Amazon SNS, Amazon SQS o Lambda tramite la console di Amazon S3
**Per abilitare e configurare le notifiche di evento per un bucket 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. Passare alla sezione **Event Notifications (Notifiche evento)** e scegliere **Create event notification (Crea notifica evento)**.
1. Nella sezione **General configuration (Configurazione generale)** specificare il nome dell'evento descrittivo per la notifica dell'evento. Facoltativamente, è anche possibile specificare un prefisso e un suffisso per limitare le notifiche agli oggetti con chiavi che terminano con i caratteri specificati.
1. Immettere una descrizione per **Event name (Nome evento)**.
Se non specifichi un nome, viene generato e utilizzato un GUID (Globally Unique Identifier).
1. (Facoltativo) Per filtrare le notifiche degli eventi in base al prefisso, immettere **Prefix**.
Ad esempio, è possibile impostare un filtro prefisso in modo da ricevere notifiche solo quando i file vengono aggiunti a una cartella specifica co, `images/`).
1. (Facoltativo) Per filtrare le notifiche degli eventi in base al suffisso, immettere **Suffix**.
Per ulteriori informazioni, consulta [Configurazione delle notifiche di eventi mediante il filtro dei nomi delle chiavi oggetto](notification-how-to-filtering.md).
1. Nella sezione **Tipi di evento**, selezionare uno o più tipi di evento per i quali si desidera ricevere notifiche.
Per un elenco dei vari tipi di evento, consulta [Tipi di eventi supportati per SQS, SNS e Lambda](notification-how-to-event-types-and-destinations.md#supported-notification-event-types).
1. Nella sezione **Destination (Destinazione)**, scegliere la destinazione della notifica dell'evento.
**Nota**
Prima di poter pubblicare le notifiche di eventi, è necessario concedere al principale di Amazon S3 le autorizzazioni necessarie per richiamare l'API pertinente. In questo modo è possibile pubblicare le notifiche su una funzione Lambda, un argomento SNS o una coda SQS.
1. Selezionare il tipo di destinazione: **Lambda Function (Funzione Lambda)**, **SNS Topic (Argomento SNS)** o **SQS Queue (Coda SQS)**.
1. Dopo aver scelto il tipo di destinazione, scegliere una funzione, un argomento o una coda dall'elenco.
1. In alternativa, se preferisci specificare un Amazon Resource Name (ARN), seleziona **Inserisci ARN** e specifica l'ARN.
Per ulteriori informazioni, consulta [Destinazioni eventi supportate](notification-how-to-event-types-and-destinations.md#supported-notification-destinations).
1. Seleziona **Salva modifiche** e Amazon S3 invia un messaggio di prova alla destinazione della notifica dell'evento.
## Configurazione delle notifiche degli eventi a livello di programmazione
Per impostazione predefinita, le notifiche sono disattivate per tutti i tipi di evento. Pertanto, inizialmente la risorsa secondaria *notifica* archivia una configurazione vuota.
```
```
Per abilitare le notifiche per tipi di eventi specifici, sostituisci il file XML con la configurazione appropriata che identifica i tipi di evento che Amazon S3 deve pubblicare e la destinazione in cui gli eventi devono essere pubblicati. Per ciascuna destinazione, si aggiunge una configurazione XML corrispondente.
**Per pubblicare messaggi di eventi in una coda SQS**
Per impostare una coda SQS come destinazione di notifica per uno o più tipi di evento, aggiungi la `QueueConfiguration`.
```
optional-id-string
sqs-queue-arn
event-type
event-type
...
...
```
**Per pubblicare i messaggi di eventi in un argomento SNS**
Per impostare un argomento SNS come destinazione di notifica per tipi di eventi specifici, aggiungi la `TopicConfiguration`.
```
optional-id-string
sns-topic-arn
event-type
event-type
...
...
```
**Per richiamare la AWS Lambda funzione e fornire un messaggio di evento come argomento**
Per impostare una funzione Lambda come destinazione di notifica per tipi di eventi specifici, aggiungi la `CloudFunctionConfiguration`.
```
optional-id-string
cloud-function-arn
event-type
event-type
...
...
```
**Per rimuovere tutte le notifiche configurate su un bucket**
Per rimuovere tutte le notifiche configurate in un bucket, salva un elemento `` vuoto nella risorsa secondaria di *notifica*.
Quando Amazon S3 rileva un evento di tipo specifico, pubblica un messaggio con le informazioni sull'evento. Per ulteriori informazioni, consulta [Struttura del messaggio di evento](notification-content-structure.md).
Per ulteriori informazioni sulla configurazione delle notifiche di eventi, consulta i seguenti argomenti:
+ [Spiegazione passo per passo: configurare un bucket per le notifiche (argomento SNS o coda SQS)](ways-to-add-notification-config-to-bucket.md).
+ [Configurazione delle notifiche di eventi mediante il filtro dei nomi delle chiavi oggetto](notification-how-to-filtering.md)
# Spiegazione passo per passo: configurare un bucket per le notifiche (argomento SNS o coda SQS)
Puoi ricevere notifiche Amazon S3 utilizzando Amazon Simple Notification Service (Amazon SNS) o Amazon Simple Queue Service (Amazon SQS). Nella spiegazione passo per passo seguente viene aggiunta una configurazione di notifica al bucket utilizzando un argomento Amazon SNS e una coda Amazon SQS.
**Nota**
Le code FIFO (First-In-First-Out) di Amazon Simple Queue Service non sono supportate come destinazione delle notifiche degli eventi di Amazon S3. Per inviare una notifica per un evento Amazon S3 a una coda FIFO di Amazon SQS, puoi utilizzare Amazon. EventBridge Per ulteriori informazioni, consulta [Attivazione di Amazon EventBridge](enable-event-notifications-eventbridge.md).
**Topics**
+ [
## Riepilogo della spiegazione passo per passo
](#notification-walkthrough-summary)
+ [
## Fase 1: creare una coda Amazon SQS
](#step1-create-sqs-queue-for-notification)
+ [
## Fase 2: creare un argomento Amazon SNS
](#step1-create-sns-topic-for-notification)
+ [
## Fase 3: aggiungere una configurazione delle notifiche al bucket
](#step2-enable-notification)
+ [
## Fase 4: eseguire il test della configurazione
](#notification-walkthrough-1-test)
## Riepilogo della spiegazione passo per passo
Questa spiegazione passo per passo aiuta a completare le seguenti operazioni:
+ Pubblicare eventi di tipo `s3:ObjectCreated:*` in una coda Amazon SQS.
+ Pubblicare eventi di tipo `s3:ReducedRedundancyLostObject` in un argomento Amazon SNS.
Per informazioni sulla configurazione delle notifiche, consulta [Utilizzo di Amazon SQS, Amazon SNS e Lambda](how-to-enable-disable-notification-intro.md).
È possibile eseguire tutte queste fasi utilizzando la console, senza scrivere alcun codice. Inoltre, vengono forniti anche esempi di codice utilizzati AWS SDKs per Java e.NET per aiutarti ad aggiungere configurazioni di notifica a livello di codice.
La procedura include le seguenti fasi:
1. Creare una coda Amazon SQS.
Attraverso la console di Amazon SQS, crea una coda SQS. È possibile accedere a qualsiasi messaggio che Amazon S3 invia alla coda in modo programmatico. Tuttavia, per questa procedura guidata, i messaggi di notifica si verificano nella console.
Collega una policy di accesso all'argomento per concedere ad Amazon S3 l'autorizzazione a pubblicare messaggi.
1. Creare un argomento Amazon SNS.
Utilizzando la console di Amazon SNS, crea un argomento SNS e iscriviti all'argomento. In questo modo, riceverai tutti gli eventi pubblicati. Si specifica l'e-mail come protocollo di comunicazione. Dopo aver creato un argomento, Amazon SNS invia un'e-mail. È necessario utilizzare il collegamento nell'e-mail per confermare la sottoscrizione all'argomento.
Collega una policy di accesso all'argomento per concedere ad Amazon S3 l'autorizzazione a pubblicare messaggi.
1. Aggiungere una configurazione delle notifiche a un bucket.
## Fase 1: creare una coda Amazon SQS
Segui le fasi per creare una coda Amazon Simple Queue Service (Amazon SQS) ed effettuarvi la sottoscrizione.
1. Utilizzando la console di Amazon SQS, creare una coda. Per istruzioni, consulta la sezione [Nozioni di base su Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-getting-started.html) nella *Guida per gli sviluppatori di Amazon Simple Queue Service*.
1. Sostituire la policy di accesso allegata alla coda con la policy riportata di seguito.
1. Nella console di Amazon SQS, nell'elenco **Code**, seleziona il nome della coda.
1. Nella scheda **Policy di accesso**, seleziona **Modifica**.
1. Sostituire la policy di accesso allegata alla coda. Fornisci l'ARN di Amazon SQS, il nome del bucket di origine e l'ID dell'account del proprietario del bucket.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "example-ID",
"Statement": [
{
"Sid": "example-statement-ID",
"Effect": "Allow",
"Principal": {
"Service": "s3.amazonaws.com"
},
"Action": [
"SQS:SendMessage"
],
"Resource": "arn:aws:sqs:us-west-2:111122223333:s3-notification-queue",
"Condition": {
"ArnLike": {
"aws:SourceArn": "arn:aws:s3:*:*:awsexamplebucket1"
},
"StringEquals": {
"aws:SourceAccount": "bucket-owner-123456789012"
}
}
}
]
}
```
------
1. Scegli **Save** (Salva).
1. (Facoltativo) Se la coda Amazon SQS o l'argomento Amazon SNS è la crittografia lato server abilitata con AWS Key Management Service (AWS KMS), aggiungi la seguente policy alla chiave di crittografia simmetrica associata gestita dal cliente.
Devi aggiungere la policy a una chiave gestita dal cliente perché non è possibile modificare la chiave gestita da AWS per Amazon SQS o Amazon SNS.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "example-ID",
"Statement": [
{
"Sid": "example-statement-ID",
"Effect": "Allow",
"Principal": {
"Service": "s3.amazonaws.com"
},
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": "*"
}
]
}
```
------
Per ulteriori informazioni sull'utilizzo di SSE per Amazon SQS e Amazon SNS AWS KMS con, consulta quanto segue:
+ [Gestione delle chiavi](https://docs.aws.amazon.com/sns/latest/dg/sns-key-management.html) nella *Guida per sviluppatori di Amazon Simple Notification Service*.
+ [Gestione delle chiavi](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-key-management.html) nella *Guida per sviluppatori di Amazon Simple Queue Service*.
1. Prendere nota dell'ARN della coda.
La coda SQS creata è un'altra risorsa nel tuo Account AWS. Dispone di un Amazon Resource Name (ARN) univoco. Il presente ARN è necessario nella fase successiva. Il nome ARN presenta il formato seguente:
```
arn:aws:sqs:aws-region:account-id:queue-name
```
## Fase 2: creare un argomento Amazon SNS
Completa la procedura per creare e sottoscrivere un argomento Amazon SNS.
1. Utilizzando la console di Amazon SNS, crea un argomento. Per le istruzioni, consulta la sezione [Creazione di un argomento Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) nella *Guida per gli sviluppatori di Amazon Simple Notification Service*.
1. Effettuare la sottoscrizione all'argomento. Per questo esercizio, utilizzare l'e-mail come protocollo di comunicazione. Per le istruzioni, consulta la sezione [Sottoscrizione a un argomento di Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-create-subscribe-endpoint-to-topic.html) nella *Guida per gli sviluppatori di Amazon Simple Notification Service*.
Si riceverà un'e-mail in cui è richiesto di confermare la sottoscrizione all'argomento. Confermare la sottoscrizione.
1. Sostituire la policy di accesso collegata all'argomento con la policy riportata di seguito. Fornisci l'ARN dell'argomento SNS, il nome del bucket e l'ID dell'account del proprietario del bucket.
1. Prendere nota dell'ARN dell'argomento.
L'argomento SNS che hai creato è un'altra tua Account AWS risorsa e ha un ARN unico. L'ARN è necessario nella fase successiva. L'ARN ha il formato seguente:
```
arn:aws:sns:aws-region:account-id:topic-name
```
## Fase 3: aggiungere una configurazione delle notifiche al bucket
Puoi abilitare le notifiche bucket utilizzando la console Amazon S3 o a livello di codice utilizzando. AWS SDKs Scegliere una delle opzioni per configurare le notifiche nel bucket. Questa sezione fornisce esempi di codice che utilizzano AWS SDKs for Java e.NET.
### Opzione A: abilitare le notifiche in un bucket utilizzando la console
Utilizzando la console di Amazon S3, aggiungi una configurazione di notifica che richiede ad Amazon S3 di:
+ Pubblicare gli eventi di tipo **Tutti gli eventi di creazione dell'oggetto** nella coda Amazon SQS.
+ Pubblica gli eventi di tipo **Oggetto perso in RRS** sul tuo argomento Amazon SNS.
Una volta salvata la configurazione delle notifiche, Amazon S3 pubblica un messaggio di testo che viene inviato tramite e-mail.
Per istruzioni, consulta [Attivazione e configurazione delle notifiche di eventi tramite la console di Amazon S3](enable-event-notifications.md).
### Opzione B: abilita le notifiche su un bucket utilizzando AWS SDKs
------
#### [ .NET ]
L'esempio di codice C\$1 riportato di seguito include il codice completo che aggiunge una configurazione delle notifiche in un bucket. Occorre aggiornare il codice e fornire il nome del bucket e l'ARN dell'argomento SNS. Per informazioni sulla configurazione e l'esecuzione degli esempi di codice, consulta [Getting Started with the AWS SDK for .NET nella AWS SDK for](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-setup.html) .NET *Developer Guide*.
```
using Amazon;
using Amazon.S3;
using Amazon.S3.Model;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
namespace Amazon.DocSamples.S3
{
class EnableNotificationsTest
{
private const string bucketName = "*** bucket name ***";
private const string snsTopic = "*** SNS topic ARN ***";
private const string sqsQueue = "*** SQS topic ARN ***";
// Specify your bucket region (an example region is shown).
private static readonly RegionEndpoint bucketRegion = RegionEndpoint.USWest2;
private static IAmazonS3 client;
public static void Main()
{
client = new AmazonS3Client(bucketRegion);
EnableNotificationAsync().Wait();
}
static async Task EnableNotificationAsync()
{
try
{
PutBucketNotificationRequest request = new PutBucketNotificationRequest
{
BucketName = bucketName
};
TopicConfiguration c = new TopicConfiguration
{
Events = new List { EventType.ObjectCreatedCopy },
Topic = snsTopic
};
request.TopicConfigurations = new List();
request.TopicConfigurations.Add(c);
request.QueueConfigurations = new List();
request.QueueConfigurations.Add(new QueueConfiguration()
{
Events = new List { EventType.ObjectCreatedPut },
Queue = sqsQueue
});
PutBucketNotificationResponse response = await client.PutBucketNotificationAsync(request);
}
catch (AmazonS3Exception e)
{
Console.WriteLine("Error encountered on server. Message:'{0}' ", e.Message);
}
catch (Exception e)
{
Console.WriteLine("Unknown error encountered on server. Message:'{0}' ", e.Message);
}
}
}
}
```
------
#### [ Java ]
Per esempi di come configurare le notifiche bucket con l' AWS SDK for Java, [consulta Process S3 event notification in Amazon *S3*](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_Scenario_ProcessS3EventNotification_section.html) API Reference.
------
## Fase 4: eseguire il test della configurazione
Ora è possibile testare la configurazione caricando un oggetto nel bucket e verificando la notifica di eventi nella console di Amazon SQS. Per istruzioni, consulta la sezione [Ricezione di un messaggio](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-getting-started.htmlReceiveMessage.html) nella sezione *"Nozioni di base" della Guida per gli sviluppatori di Amazon Simple Queue Service*.
# Configurazione delle notifiche di eventi mediante il filtro dei nomi delle chiavi oggetto
Quando configuri una notifica di eventi di Amazon S3, devi specificare quali tipi di eventi di Amazon S3 supportati fanno sì che Amazon S3 invii la notifica. Se nel bucket S3 si verifica un tipo di evento che non hai specificato, Amazon S3 non invia la notifica.
È possibile configurare le notifiche in modo da essere filtrate in base al prefisso e al suffisso del nome della chiave degli oggetti, Ad esempio, è possibile impostare una configurazione per ricevere una notifica solo quando i file di immagini con l'estensione del nome file "`.jpg`" vengono aggiunti a un bucket. In alternativa, puoi avere una configurazione che invia una notifica a un argomento di Amazon SNS quando un oggetto con il prefisso "`images/`" viene aggiunto al bucket, mentre le notifiche per gli oggetti con un prefisso "`logs/`" nello stesso bucket vengono inviate a una funzione. AWS Lambda
**Nota**
Un carattere jolly ("\$1") non può essere utilizzato nei filtri come prefisso o suffisso. Se il prefisso o il suffisso contiene uno spazio, è necessario sostituirlo con il carattere "\$1". Se utilizzi altri caratteri speciali nel valore del prefisso o del suffisso, dovrai immetterli nel [formato con codifica URL (codificato in percentuale)](https://en.wikipedia.org/wiki/Percent-encoding). Per un elenco completo dei caratteri speciali che devono essere convertiti in formato con codifica URL se utilizzati in un prefisso o in un suffisso per le notifiche di eventi, consulta [Caratteri sicuri](object-keys.md#object-key-guidelines-safe-characters).
È possibile impostare configurazioni delle notifiche che utilizzano il filtraggio del nome della chiave oggetto nella console di Amazon S3. Puoi farlo utilizzando Amazon S3 APIs tramite AWS SDKs o direttamente REST APIs . Per informazioni sull'utilizzo dell'interfaccia utente della console per impostare una configurazione di notifica in un bucket, consulta la sezione [Attivazione e configurazione delle notifiche di eventi tramite la console di Amazon S3](enable-event-notifications.md).
Amazon S3 archivia la configurazione delle notifiche in formato XML nella risorsa secondaria *notification* associata a un bucket, come descritto in [Utilizzo di Amazon SQS, Amazon SNS e Lambda](how-to-enable-disable-notification-intro.md). Si utilizza la struttura XML `Filter` per definire le regole per filtrare le notifiche in base al prefisso o al suffisso del nome della chiave oggetto. Per informazioni sulla struttura XML `Filter`, consulta [notifica PUT Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTnotification.html) nella *Documentazione di riferimento delle API di Amazon Simple Storage Service*.
Le configurazioni delle notifiche che utilizzano `Filter` non possono definire regole di filtri con prefissi che si sovrappongono, suffissi che si sovrappongono o prefisso e suffisso che si sovrappongono. Nelle sezioni seguenti sono riportati esempi di configurazioni delle notifiche valide con il filtro del nome della chiave dell'oggetto. Contengono anche esempi di configurazioni delle notifiche non valide a causa della sovrapposizione di prefisso/suffisso.
**Topics**
+ [
## Esempi di configurazioni di notifiche valide con il filtro del nome della chiave dell'oggetto
](#notification-how-to-filtering-example-valid)
+ [
## Esempi di configurazioni di notifiche con sovrapposizione di prefisso/suffisso non valida
](#notification-how-to-filtering-examples-invalid)
## Esempi di configurazioni di notifiche valide con il filtro del nome della chiave dell'oggetto
La configurazione delle notifiche seguente contiene una configurazione della coda che identifica una coda Amazon SQS dove Amazon S3 deve pubblicare gli eventi di tipo `s3:ObjectCreated:Put`. Gli eventi vengono pubblicati ogni volta che un oggetto con prefisso `images/` e suffisso `jpg` viene aggiunto a un bucket tramite richiesta PUT.
```
1
prefix
images/
suffix
jpg
arn:aws:sqs:us-west-2:444455556666:s3notificationqueue
s3:ObjectCreated:Put
```
La configurazione delle notifiche riportata di seguito include diversi prefissi che non si sovrappongono. La configurazione stabilisce che le notifiche delle richieste PUT nella cartella `images/` vanno nella coda A (queue-A) mentre le notifiche delle richieste PUT nella cartella `logs/` vanno nella coda B (queue-B).
```
1
prefix
images/
arn:aws:sqs:us-west-2:444455556666:sqs-queue-A
s3:ObjectCreated:Put
2
prefix
logs/
arn:aws:sqs:us-west-2:444455556666:sqs-queue-B
s3:ObjectCreated:Put
```
La configurazione delle notifiche riportata di seguito include diversi suffissi che non si sovrappongono. La configurazione definisce che tutte le `.jpg` immagini appena aggiunte al bucket vengono elaborate da cloud-function-A Lambda e tutte le immagini appena `.png` aggiunte vengono elaborate da. cloud-function-B I `.jpg` suffissi `.png` and non si sovrappongono anche se hanno la stessa ultima lettera. I due suffissi si considerano sovrapposti se una determinata stringa può terminare con entrambi. Una stringa non può terminare sia con `.png` che con `.jpg`, pertanto i suffissi nella configurazione di esempio non si sovrappongono.
```
1
suffix
.jpg
arn:aws:lambda:us-west-2:444455556666:cloud-function-A
s3:ObjectCreated:Put
2
suffix
.png
arn:aws:lambda:us-west-2:444455556666:cloud-function-B
s3:ObjectCreated:Put
```
Le configurazioni delle notifiche che utilizzano `Filter` non possono definire regole per filtrare i prefissi che si sovrappongono nello stesso tipo di evento. Possono farlo solo se i prefissi sovrapposti sono utilizzati con suffissi che non si sovrappongono. L'esempio di configurazione seguente mostra in che modo gli oggetti creati con un prefisso comune ma con suffissi che non si sovrappongono possono essere distribuiti in diverse destinazioni.
```
1
prefix
images
suffix
.jpg
arn:aws:lambda:us-west-2:444455556666:cloud-function-A
s3:ObjectCreated:Put
2
prefix
images
suffix
.png
arn:aws:lambda:us-west-2:444455556666:cloud-function-B
s3:ObjectCreated:Put
```
## Esempi di configurazioni di notifiche con sovrapposizione di prefisso/suffisso non valida
La maggior parte delle configurazioni delle notifiche che utilizzano `Filter` non possono definire regole per filtrare i prefissi che si sovrappongono, i suffissi che si sovrappongono o le combinazioni di prefissi e suffissi che si sovrappongono per gli stessi tipi di eventi. È possibile avere prefissi che si sovrappongono a condizione che non si sovrappongano i suffissi. Per vedere un esempio, consulta [Configurazione delle notifiche di eventi mediante il filtro dei nomi delle chiavi oggetto](#notification-how-to-filtering).
È possibile utilizzare filtri di nomi delle chiavi degli oggetti che si sovrappongono con diversi tipi di eventi. Ad esempio, si potrebbe creare una configurazione delle notifiche che utilizza il prefisso `image/` per il tipo di evento `ObjectCreated:Put` e il prefisso `image/` per il tipo di evento `ObjectRemoved:*`.
Se cerchi di salvare una configurazione delle notifiche con filtri di nomi non validi che si sovrappongono per gli stessi tipi di eventi, durante l'utilizzo dell'API o della console di Amazon S3, si verifica un errore. Questa sezione mostra esempi di configurazioni delle notifiche non valide a causa della sovrapposizione dei filtri dei nomi.
Si presuppone che qualsiasi regola di configurazione delle notifiche esistente abbia prefisso e suffisso predefiniti che corrispondano rispettivamente a qualsiasi altro prefisso e suffisso. La configurazione delle notifiche riportata di seguito non è valida poiché include prefissi che si sovrappongono. In particolare, il prefisso root si sovrappone con qualsiasi altro prefisso. Lo stesso vale nel caso in cui in questo esempio si utilizzi un suffisso anziché il prefisso. Il suffisso root si sovrappone a qualsiasi altro suffisso.
```
arn:aws:sns:us-west-2:444455556666:sns-notification-one
s3:ObjectCreated:*
arn:aws:sns:us-west-2:444455556666:sns-notification-two
s3:ObjectCreated:*
prefix
images
```
La configurazione delle notifiche riportata di seguito non è valida in quanto include suffissi che si sovrappongono. I due suffissi si considerano sovrapposti se una determinata stringa può terminare con entrambi. Una stringa può terminare con `jpg` e `pg`. Quindi, i suffissi si sovrappongono. Lo stesso vale per i prefissi. Due prefissi sono considerati sovrapposti se una determinata stringa può iniziare con entrambi i prefissi.
```
arn:aws:sns:us-west-2:444455556666:sns-topic-one
s3:ObjectCreated:*
suffix
jpg
arn:aws:sns:us-west-2:444455556666:sns-topic-two
s3:ObjectCreated:Put
suffix
pg
arn:aws:sns:us-west-2:444455556666:sns-topic-one
s3:ObjectCreated:*
prefix
images
suffix
jpg
arn:aws:sns:us-west-2:444455556666:sns-topic-two
s3:ObjectCreated:Put
suffix
jpg
```
# Struttura del messaggio di evento
Il messaggio di notifica inviato da Amazon S3 per pubblicare un evento è in formato JSON.
Per una panoramica generale e istruzioni sulla configurazione delle notifiche degli eventi, consulta [Notifiche di eventi Amazon S3](EventNotifications.md).
Questo esempio mostra la *versione 2.1 della struttura JSON* di notifica degli eventi. Amazon S3 utilizza le *versioni 2.1*, *2.2* e *2.3* di questa struttura di eventi. Amazon S3 utilizza la versione 2.2 per le notifiche di eventi di replica tra Regioni. Utilizza la versione 2.3 per S3 Lifecycle, S3 Intelligent-Tiering, ACL di oggetti, assegnazione di tag di oggetti e ripristino oggetti per gli eventi di eliminazione. Queste versioni contengono informazioni aggiuntive specifiche per queste operazioni. Le versioni 2.2 e 2.3 sono altrimenti compatibili con la versione 2.1 che Amazon S3 utilizza attualmente per altri tipi di notifiche di eventi.
```
{
"Records":[
{
"eventVersion":"2.1",
"eventSource":"aws:s3",
"awsRegion":"us-west-2",
"eventTime":"The time, in ISO-8601 format (for example, 1970-01-01T00:00:00.000Z) when Amazon S3 finished processing the request",
"eventName":"The event type",
"userIdentity":{
"principalId":"The unique ID of the IAM resource that caused the event"
},
"requestParameters":{
"sourceIPAddress":"The IP address where the request came from"
},
"responseElements":{
"x-amz-request-id":"The Amazon S3 generated request ID",
"x-amz-id-2":"The Amazon S3 host that processed the request"
},
"s3":{
"s3SchemaVersion":"1.0",
"configurationId":"The ID found in the bucket notification configuration",
"bucket":{
"name":"The name of the bucket, for example, amzn-s3-demo-bucket",
"ownerIdentity":{
"principalId":"The Amazon retail customer ID of the bucket owner"
},
"arn":"The bucket Amazon Resource Name (ARN)"
},
"object":{
"key":"The object key name",
"size":"The object size in bytes (as a number)",
"eTag":"The object entity tag (ETag)",
"versionId":"The object version if the bucket is versioning-enabled; null or not present if the bucket isn't versioning-enabled",
"sequencer": "A string representation of a hexadecimal value used to determine event sequence; only used with PUT and DELETE requests"
}
},
"glacierEventData": {
"restoreEventData": {
"lifecycleRestorationExpiryTime": "The time, in ISO-8601 format (for example, 1970-01-01T00:00:00.000Z), when the temporary copy of the restored object expires",
"lifecycleRestoreStorageClass": "The source storage class for restored objects"
}
}
}
]
}
```
Notare quanto segue sulla struttura dei messaggi di evento:
+ Il valore della chiave `eventVersion` contiene una versione maggiore e minore nel formato `major`.`minor`.
La versione principale viene incrementata se Amazon S3 apporta una modifica alla struttura dell'evento che non è compatibile con le versioni precedenti. Questo include la rimozione di un campo JSON che è già presente o la modifica del modo in cui i contenuti di un campo vengono rappresentati (ad esempio, un formato di data).
La versione secondaria viene incrementata se Amazon S3 aggiunge nuovi campi alla struttura dell'evento. Questo può succedere se vengono fornite nuove informazioni per alcuni o tutti gli eventi esistenti. Questo può succedere anche se vengono fornite nuove informazioni solo per i tipi di eventi appena introdotti. Per mantenere la compatibilità con le nuove versioni secondarie della struttura degli eventi, è consigliabile che le applicazioni ignorino i nuovi campi.
Se vengono introdotti nuovi tipi di eventi ma la struttura dell’evento rimane invariata, la versione dell’evento non cambia.
Per fare in modo che le applicazioni analizzino correttamente la struttura dell'evento, è consigliabile eseguire un confronto "uguale a" sul numero della versione maggiore. Per garantire che i campi previsti dall'applicazione siano presenti, consigliamo anche di eseguire un confronto greater-than-or-equal -to sulla versione secondaria.
+ Il valore di chiave `eventName` fa riferimento all’elenco dei [tipi di notifiche degli eventi](https://docs.aws.amazon.com/AmazonS3/latest/userguide/notification-how-to-event-types-and-destinations.html) ma non contiene il prefisso `s3:`.
+ Il valore `userIdentity` chiave fa riferimento all'ID univoco della risorsa AWS Identity and Access Management (IAM) (utente, ruolo, gruppo e così via) che ha causato l'evento. Per la definizione di ciascun prefisso di identificazione IAM (ad esempio AIDA, AROA, AGPA) e per informazioni su come ottenere l’identificatore univoco, consulta [Identificatori univoci](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html##identifiers-unique-ids) nella *Guida per l’utente IAM*.
+ Il valore della `responseElements` chiave è utile se si desidera tracciare una richiesta dando seguito a Supporto AWS. Sia `x-amz-request-id` sia `x-amz-id-2` aiutano Amazon S3 a tenere traccia di una singola richiesta. Questi valori corrispondono a quelli che Amazon S3 restituisce nella risposta alla richiesta che avvia gli eventi. Pertanto, è possibile utilizzare questi valori per abbinare l’evento alla richiesta.
+ Il valore di chiave `s3` fornisce informazioni sul bucket e sull’oggetto coinvolto nell’evento. Il valore del nome della chiave dell'oggetto ha la codifica URL. Ad esempio `red flower.jpg` diventa `red+flower.jpg`. Amazon S3 restituisce “`application/x-www-form-urlencoded`” come tipo di contenuto nella risposta.
Il valore di chiave `ownerIdentity` corrisponde all’ID del cliente di vendita al dettaglio Amazon (Amazon.com) del proprietario del bucket. Questo valore di ID non viene più utilizzato e viene mantenuto solo per motivi di compatibilità con le versioni precedenti.
+ Il valore di chiave `sequencer` fornisce un modo per stabilire la sequenza degli eventi. Non è garantito che le notifiche di eventi arrivino nello stesso ordine in cui avvengono gli eventi. Tuttavia, notifiche di eventi che creano oggetti (richieste `PUT`) ed eliminano oggetti contengono un `sequencer`. È possibile utilizzare questo valore per determinare l’ordine degli eventi per una specifica chiave dell’oggetto.
Se si confrontano le stringhe `sequencer` da due notifiche eventi nella stessa chiave dell'oggetto, la notifica evento con il valore esadecimale `sequencer` più elevato è l'evento che è avvenuto per ultimo. Se si utilizzano notifiche di eventi per mantenere un database o un indice separato degli oggetti Amazon S3, è consigliabile confrontare e archiviare i valori `sequencer` man mano che la notifica di ciascun evento viene elaborata.
Tenere presente quanto segue:
+ Il valore di chiave `sequencer` non può essere utilizzato per determinare l’ordine degli eventi su diverse chiavi degli oggetti.
+ Le stringhe `sequencer` possono essere di diversa lunghezza. Quindi, per confrontare questi valori, per prima cosa aggiungi gli zeri al valore più breve e poi esegui un confronto lessicografico.
+ Il valore di chiave `glacierEventData` è visibile solo per gli eventi `s3:ObjectRestore:Completed`.
+ Il valore di chiave `restoreEventData` contiene attributi correlati alla richiesta di ripristino.
+ Il valore di chiave `replicationEventData` è visibile solo per gli eventi di replica.
+ Il valore di chiave `intelligentTieringEventData` è visibile solo per gli eventi Piano intelligente S3.
+ Il valore di chiave `lifecycleEventData` è visibile solo per gli eventi di transizione del ciclo di vita S3.
## Messaggi di esempio
Di seguito sono riportati alcuni esempi di messaggi di notifica degli eventi Amazon S3.
**Messaggio di prova Amazon S3**
Quando configuri una notifica di eventi in un bucket, Amazon S3 invia il messaggio di prova riportato di seguito.
```
1. {
2. "Service":"Amazon S3",
3. "Event":"s3:TestEvent",
4. "Time":"2014-10-13T15:57:02.089Z",
5. "Bucket":"amzn-s3-demo-bucket",
6. "RequestId":"5582815E1AEA5ADF",
7. "HostId":"8cLeGAmw098X5cv4Zkwcmo8vvZa3eH3eKxsPzbB9wrR+YstdA6Knx4Ip8EXAMPLE"
8. }
```
**Nota**
Il messaggio `s3:TestEvent` utilizza un formato diverso rispetto alle normali notifiche degli eventi S3. A differenza di altre notifiche degli eventi che utilizzano la struttura dell’array `Records` mostrata in precedenza, l’evento di test utilizza un formato semplificato con campi diretti. Quando si implementa la gestione degli eventi, è necessario assicurarsi che il codice sia in grado di distinguere e gestire correttamente entrambi i formati di messaggio.
**Messaggio di esempio quando un oggetto viene creato utilizzando una richiesta `PUT`**
Quello che segue è un esempio di un messaggio inviato da Amazon S3 per pubblicare un evento `s3:ObjectCreated:Put`.
```
1. {
2. "Records":[
3. {
4. "eventVersion":"2.1",
5. "eventSource":"aws:s3",
6. "awsRegion":"us-west-2",
7. "eventTime":"1970-01-01T00:00:00.000Z",
8. "eventName":"ObjectCreated:Put",
9. "userIdentity":{
10. "principalId":"AIDAJDPLRKLG7UEXAMPLE"
11. },
12. "requestParameters":{
13. "sourceIPAddress":"172.16.0.1"
14. },
15. "responseElements":{
16. "x-amz-request-id":"C3D13FE58DE4C810",
17. "x-amz-id-2":"FMyUVURIY8/IgAtTv8xRjskZQpcIZ9KG4V5Wp6S7S/JRWeUWerMUE5JgHvANOjpD"
18. },
19. "s3":{
20. "s3SchemaVersion":"1.0",
21. "configurationId":"testConfigRule",
22. "bucket":{
23. "name":"amzn-s3-demo-bucket",
24. "ownerIdentity":{
25. "principalId":"A3NL1KOZZKExample"
26. },
27. "arn":"arn:aws:s3:::amzn-s3-demo-bucket"
28. },
29. "object":{
30. "key":"HappyFace.jpg",
31. "size":1024,
32. "eTag":"d41d8cd98f00b204e9800998ecf8427e",
33. "versionId":"096fKKXTRTtl3on89fVO.nfljtsv6qko",
34. "sequencer":"0055AED6DCD90281E5"
35. }
36. }
37. }
38. ]
39. }
```
# 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*.