Tipi di notifiche eventi e destinazioni - Amazon Simple Storage Service
Destinazioni eventi supportateTipi di eventi supportati per SQSSNS, e LambdaTipi di eventi supportati per Amazon EventBridgeOrdinamento degli eventi ed eventi duplicati

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

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.

Destinazioni eventi supportate

Amazon S3 può inviare messaggi di notifica degli eventi alle seguenti destinazioni.

  • Argomenti di Amazon Simple Notification Service (AmazonSNS)

  • Code di Amazon Simple Queue Service (AmazonSQS)

  • 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 messaggi su un SNS argomento Amazon o su una coda Amazon. SQS È inoltre necessario concedere ad Amazon S3 l'autorizzazione a richiamare un AWS Lambda agire per tuo conto. Per istruzioni su come concedere queste autorizzazioni, consulta Concessione di autorizzazioni per pubblicare messaggi di notifica eventi in una destinazione.

SNSArgomento Amazon

Amazon SNS è un servizio di messaggistica push flessibile e completamente gestito. Tramite questo servizio, è possibile inviare messaggi push a dispositivi mobili o servizi distribuiti. ConSNS, puoi pubblicare un messaggio una volta e consegnarlo una o più volte. Attualmente, Standard SNS è consentito solo come destinazione di notifica di eventi S3, mentre non SNS FIFO è consentito.

Amazon coordina SNS e gestisce l'invio e la consegna di messaggi agli endpoint o ai clienti abbonati. Puoi utilizzare la SNS console Amazon per creare un SNS argomento Amazon a cui inviare le tue notifiche.

L'argomento deve essere nello stesso Regione AWS come bucket Amazon S3. Per istruzioni su come creare un SNS argomento Amazon, consulta la sezione Guida introduttiva ad Amazon SNS nella Amazon Simple Notification Service Developer Guide e in Amazon SNS FAQ.

Prima di poter utilizzare l'SNSargomento Amazon creato come destinazione di notifica degli eventi, è necessario quanto segue:

  • Il nome della risorsa Amazon (ARN) per l'SNSargomento Amazon

  • Un abbonamento valido per SNS argomenti Amazon. Con esso, gli abbonati all'argomento ricevono una notifica quando viene pubblicato un messaggio sul tuo SNS argomento Amazon.

SQSCoda Amazon

Amazon SQS offre code ospitate affidabili e scalabili per l'archiviazione dei messaggi mentre viaggiano tra computer. Puoi utilizzare Amazon SQS per trasmettere qualsiasi volume di dati senza richiedere che altri servizi siano sempre disponibili. Puoi utilizzare la SQS console Amazon per creare una SQS coda Amazon a cui inviare le notifiche.

La SQS coda Amazon deve essere nella stessa Regione AWS come bucket Amazon S3. Per istruzioni su come creare una SQS coda Amazon, consulta What is Amazon Simple Queue Service e Getting started with Amazon SQS nella Amazon Simple Queue Service Developer Guide.

Prima di poter utilizzare la SQS coda Amazon come destinazione di notifica degli eventi, è necessario quanto segue:

  • Amazon Resource Name (ARN) per la SQS coda Amazon

Nota

Le code di Amazon Simple Queue Service FIFO (First-In-First-Out) non sono supportate come destinazione di notifica degli eventi di Amazon S3. Per inviare una notifica per un evento Amazon S3 a una SQS FIFO coda Amazon, puoi utilizzare Amazon. EventBridge Per ulteriori informazioni, consulta Attivazione di Amazon EventBridge.

Funzione Lambda

È possibile utilizzare… AWS Lambda per estenderne altri AWS servizi con logica personalizzata o crea il tuo backend che opera su AWS scalabilità, 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 su AWS Lambda e richiama 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 utilizzare il plugin AWS Lambda console per creare una funzione Lambda che utilizza il AWS infrastruttura per eseguire il codice per tuo conto. La funzione Lambda deve trovarsi nella stessa regione del bucket S3. È inoltre necessario disporre del nome o del nome ARN di una funzione Lambda per configurare la funzione Lambda come destinazione di notifica degli eventi.

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 Usare AWS Lambda con Amazon S3 nel AWS Lambda Guida per gli sviluppatori.

Amazon EventBridge

Amazon EventBridge è un bus di eventi senza server, che riceve eventi da AWS servizi. È possibile impostare regole per abbinare gli eventi e distribuirli a obiettivi, ad esempio AWS servizio o HTTP endpoint. Per ulteriori informazioni, consulta Cosa c'è EventBridge 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 SQSSNS, 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 Descrizione

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

APIOperazioni di Amazon S3 come PUTPOST, e COPY possono creare un oggetto. Con questi tipi di eventi, puoi abilitare le notifiche quando un oggetto viene creato utilizzando un'APIoperazione specifica. In alternativa, è possibile utilizzare il tipo di s3:ObjectCreated:* evento per richiedere una notifica indipendentemente da API quello utilizzato per creare un oggetto.

s3:ObjectCreated:CompleteMultipartUploadinclude oggetti creati utilizzando UploadPartCopyper le operazioni di copia.

s3:ObjectRemoved:*

s3:ObjectRemoved:Delete

s3:ObjectRemoved:DeleteMarkerCreated

Utilizzando i tipi di ObjectRemoved eventi, è possibile abilitare la notifica quando un oggetto o un batch 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. 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 ObjectRestore eventi, è possibile ricevere notifiche per l'avvio e il completamento dell'evento durante il ripristino di oggetti dalla classe di storage S3 Glacier Flexible Retrieval, dalla classe di storage S3 Glacier Deep Archive, dal livello S3 Intelligent-Tiering Archive Access e dal livello S3 Intelligent-Tiering Deep Archive Access. È 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 Ricevi questo evento di notifica quando Amazon S3 rileva che un oggetto della classe di RRS storage è andato perso.

s3:Replication:*

s3:Replication:OperationFailedReplication

s3:Replication:OperationMissedThreshold

s3:Replication:OperationReplicatedAfterThreshold

s3:Replication:OperationNotTracked

Utilizzando i tipi di Replication eventi, puoi ricevere notifiche per le configurazioni di replica con metriche S3 Replication o S3 Replication Time Control (S3) abilitati. RTC È possibile monitorare l' minute-by-minute avanzamento 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 metriche, notifiche di eventi e stati.

  • Il tipo di evento s3:Replication:OperationFailedReplication notifica quando un oggetto idoneo per la replica non è stato replicato.

  • Il tipo di s3:Replication:OperationMissedThreshold evento avvisa quando un oggetto idoneo alla replica che utilizza S3 supera la soglia dei 15 minuti per la replica. RTC

  • Il tipo di s3:Replication:OperationReplicatedAfterThreshold evento ti avvisa quando un oggetto idoneo alla replica che utilizza S3 viene replicato dopo la soglia dei 15 minuti. RTC

  • Il tipo di s3:Replication:OperationNotTracked evento notifica all'utente quando un oggetto idoneo per la replica in tempo reale (replica a regione singola [SRR] o replica tra regioni []) non viene più tracciato dai parametri di replica. CRR

s3:LifecycleExpiration:*

s3:LifecycleExpiration:Delete

s3:LifecycleExpiration:DeleteMarkerCreated

Utilizzando i tipi di LifecycleExpiration eventi, puoi ricevere una notifica quando Amazon S3 elimina un oggetto in base alla tua 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 ObjectTagging eventi, puoi abilitare la notifica quando un tag di oggetto viene aggiunto o eliminato da un oggetto.

Il tipo di s3:ObjectTagging:Put evento ti avvisa quando un tag si trova PUT su un oggetto o viene aggiornato un tag esistente. Il tipo di evento s3:ObjectTagging:Delete notifica quando un tag viene rimosso da un oggetto.
s3:ObjectAcl:Put Si riceve questo evento di notifica quando un si ACL trova PUT su un oggetto o quando un esistente ACL viene modificato. Un evento non viene generato quando una richiesta non comporta alcuna modifica a un oggettoACL.

Tipi di eventi supportati per Amazon EventBridge

Per un elenco dei tipi di eventi che Amazon S3 invierà ad Amazon EventBridge, consulta. Usando EventBridge

Ordinamento degli eventi ed eventi duplicati

Amazon S3 Event Notifications è progettato per inviare 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 riprova 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 servizio, consulta Gestire gli ordini di eventi e gli eventi duplicati con le notifiche degli eventi di Amazon S3 sul AWS Blog sullo storage.