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.

• Utilizzo programmatico degli AWS SDK: internamente, sia la console che gli SDK chiamano l'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).

  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.

Argomenti

• Concessione di autorizzazioni per pubblicare messaggi di notifica eventi in una destinazione
• Attivazione e configurazione delle notifiche di eventi tramite la console di Amazon S3
• Configurazione delle notifiche degli eventi a livello di programmazione
• Spiegazione passo per passo: configurare un bucket per le notifiche (argomento SNS o coda SQS)
• Configurazione delle notifiche di eventi mediante il filtro dei nomi delle chiavi oggetto
• Struttura del messaggio di 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.

<NotificationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> 
</NotificationConfiguration>

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.

<NotificationConfiguration>
  <QueueConfiguration>
    <Id>optional-id-string</Id>
    <Queue>sqs-queue-arn</Queue>
    <Event>event-type</Event>
    <Event>event-type</Event>
     ...
  </QueueConfiguration>
   ...
</NotificationConfiguration>

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.

<NotificationConfiguration>
  <TopicConfiguration>
     <Id>optional-id-string</Id>
     <Topic>sns-topic-arn</Topic>
     <Event>event-type</Event>
     <Event>event-type</Event>
      ...
  </TopicConfiguration>
   ...
</NotificationConfiguration>

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.

<NotificationConfiguration>
  <CloudFunctionConfiguration>   
     <Id>optional-id-string</Id>   
     <CloudFunction>cloud-function-arn</CloudFunction>        
     <Event>event-type</Event>      
     <Event>event-type</Event>      
      ...  
  </CloudFunctionConfiguration>
   ...
</NotificationConfiguration>

Per rimuovere tutte le notifiche configurate su un bucket

Per rimuovere tutte le notifiche configurate in un bucket, salva un elemento <NotificationConfiguration/> 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.

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).

• Configurazione delle notifiche di eventi mediante il filtro dei nomi delle chiavi oggetto