Ereignis-Benachrichtigungstypen und -ziele

Amazon S3 unterstützt verschiedene Arten von Ereignis-Benachrichtigungen und Ziele, wo die Benachrichtigungen veröffentlicht werden können. Sie können den Ereignistyp und das Ziel angeben, wenn Sie Ihre Ereignis-Benachrichtigungen konfigurieren. Für jede Ereignisbenachrichtigung kann nur ein Ziel angegeben werden. Amazon-S3-Ereignisbenachrichtigungen senden für jede Benachrichtigungsmeldung einen Ereigniseintrag.

Unterstützte Ereignisziele

Amazon S3 kann Ereignis-Benachrichtigungsmeldungen an die folgenden Ziele senden.

• Themen zu Amazon Simple Notification Service (AmazonSNS)

• Warteschlangen von Amazon Simple Queue Service (AmazonSQS)

• AWS Lambda

• Amazon EventBridge

Für jede Ereignisbenachrichtigung kann jedoch nur ein Zieltyp angegeben werden.

Anmerkung

Sie müssen Amazon S3 S3-Berechtigungen erteilen, um Nachrichten an ein SNS Amazon-Thema oder eine SQS Amazon-Warteschlange zu posten. Sie müssen Amazon S3 außerdem die Erlaubnis erteilen, eine AWS Lambda Funktion in Ihrem Namen aufzurufen. Anweisungen zum Erteilen dieser Berechtigungen finden Sie unter Erteilen von Berechtigungen zur Veröffentlichung von Ereignis-Benachrichtigungsmeldungen an einem Ziel.

SNSAmazon-Thema

Amazon SNS ist ein flexibler, vollständig verwalteter Push-Messaging-Dienst. Sie können diesen Dienst verwenden, um Nachrichten an mobile Geräte oder verteilte Services zu senden. Mit SNS können Sie eine Nachricht einmal veröffentlichen und sie ein- oder mehrmals zustellen. Derzeit SNS ist Standard nur als Ziel für S3-Ereignisbenachrichtigungen SNS FIFO zulässig, nicht jedoch.

Amazon koordiniert und verwaltet SNS sowohl den Versand als auch die Zustellung von Nachrichten an abonnierte Endpunkte oder Kunden. Sie können die SNS Amazon-Konsole verwenden, um ein SNS Amazon-Thema zu erstellen, an das Ihre Benachrichtigungen gesendet werden können.

Das Thema muss sich in demselben Bereich AWS-Region wie Ihr Amazon S3 S3-Bucket befinden. Anweisungen zum Erstellen eines SNS Amazon-Themas finden Sie unter Erste Schritte mit Amazon SNS im Amazon Simple Notification Service Developer Guide und im Amazon SNS FAQ.

Bevor Sie das von Ihnen erstellte SNS Amazon-Thema als Ziel für Ereignisbenachrichtigungen verwenden können, benötigen Sie Folgendes:

• Der Amazon-Ressourcenname (ARN) für das SNS Amazon-Thema

• Ein gültiges SNS Amazon-Themenabonnement. Damit werden Themenabonnenten benachrichtigt, wenn eine Nachricht zu Ihrem SNS Amazon-Thema veröffentlicht wird.

SQSAmazon-Warteschlange

Amazon SQS bietet zuverlässige und skalierbare gehostete Warteschlangen zum Speichern von Nachrichten, während sie zwischen Computern übertragen werden. Sie können Amazon verwendenSQS, um beliebige Datenmengen zu übertragen, ohne dass andere Dienste immer verfügbar sein müssen. Sie können die SQS Amazon-Konsole verwenden, um eine SQS Amazon-Warteschlange zu erstellen, an die Ihre Benachrichtigungen gesendet werden können.

Die SQS Amazon-Warteschlange muss sich in derselben Warteschlange befinden AWS-Region wie Ihr Amazon S3-Bucket. Anweisungen zum Erstellen einer SQS Amazon-Warteschlange finden Sie unter Was ist Amazon Simple Queue Service und Erste Schritte mit Amazon SQS im Amazon Simple Queue Service Developer Guide.

Bevor Sie die SQS Amazon-Warteschlange als Ziel für Ereignisbenachrichtigungen verwenden können, benötigen Sie Folgendes:

• Der Amazon-Ressourcenname (ARN) für die SQS Amazon-Warteschlange

Anmerkung

Amazon Simple Queue Service FIFO (First-In-First-Out) -Warteschlangen werden nicht als Ziel für Amazon S3 S3-Ereignisbenachrichtigungen unterstützt. Um eine Benachrichtigung für ein Amazon S3 S3-Ereignis an eine SQS FIFO Amazon-Warteschlange zu senden, können Sie Amazon verwenden EventBridge. Weitere Informationen finden Sie unter Amazon aktivieren EventBridge.

Lambda-Funktion

Sie können AWS Lambda damit andere AWS Services mit benutzerdefinierter Logik erweitern oder Ihr eigenes Backend erstellen, das AWS skalierbar, leistungsstark und sicher arbeitet. Mit Lambda können Sie diskrete ereignisabhängige Anwendungen erstellen, die nur ausgeführt werden, wenn sie benötigt werden. Sie können damit auch diese Anwendungen automatisch von ein paar Anfragen pro Tag auf Tausende pro Sekunde skalieren.

Lambda kann benutzerdefinierten Code in Reaktion auf Amazon-S3-Bucket-Ereignisse ausführen. Sie laden Ihren benutzerdefinierten Code auf Lambda hoch und erstellen eine sogenannte Lambda-Funktion. Wenn Amazon S3 ein Ereignis eines bestimmten Typs erkennt, kann es das Ereignis in Lambda veröffentlichen AWS Lambda und Ihre Funktion in Lambda aufrufen. Lambda führt als Antwort Ihre Funktion aus. Ein Ereignistyp, den er möglicherweise erkennt, ist beispielsweise ein objekterstelltes Ereignis.

Sie können die AWS Lambda Konsole verwenden, um eine Lambda-Funktion zu erstellen, die die AWS Infrastruktur verwendet, um den Code in Ihrem Namen auszuführen. Die Lambda-Funktion muss sich in derselben Region wie Ihr S3-Bucket befinden. Sie müssen auch den Namen oder den ARN einer Lambda-Funktion haben, um die Lambda-Funktion als Ziel für Ereignisbenachrichtigungen einzurichten.

Warnung

Wenn Ihre Benachrichtigung in den selben Bucket schreibt, der die Benachrichtigung auslöst, kann dies zu einer Ausführungsschleife führen. Wenn der Bucket z. B. eine Lambda-Funktion immer dann auslöst, wenn ein Objekt hochgeladen wird, und die Funktion ein Objekt in den Bucket hochlädt, löst sich die Funktion indirekt selbst aus. Um dies zu vermeiden, verwenden Sie zwei Buckets oder konfigurieren Sie den Auslöser so, dass er nur für einen Präfix gilt, der für eingehende Objekte verwendet wird.

Weitere Informationen und ein Beispiel für die Verwendung von Amazon S3-Benachrichtigungen mit AWS Lambda finden Sie unter AWS Lambda Using with Amazon S3 im AWS Lambda Developer Guide.

Amazon EventBridge

Amazon EventBridge ist ein serverloser Event-Bus, der Ereignisse von AWS Diensten empfängt. Sie können Regeln einrichten, um Ereignisse zuzuordnen und sie an Ziele wie einen AWS Service oder einen HTTP Endpunkt weiterzuleiten. Weitere Informationen finden Sie unter Was steht EventBridge im EventBridge Amazon-Benutzerhandbuch.

Im Gegensatz zu anderen Zielen können Sie EventBridge für einen Bucket Ereignisse, an die gesendet werden sollen, entweder aktivieren oder deaktivieren. Wenn Sie die Zustellung aktivieren, werden alle Ereignisse an gesendet EventBridge. Darüber hinaus können Sie EventBridge Regeln verwenden, um Ereignisse an weitere Ziele weiterzuleiten.

Unterstützte Ereignistypen für SQSSNS, und Lambda

Amazon S3 kann Ereignisse der folgenden Typen veröffentlichen. Sie spezifizieren diese Ereignistypen in der Benachrichtigungskonfiguration.

Ereignistypen	Beschreibung
s3:TestEvent	Wenn eine Benachrichtigung aktiviert ist, veröffentlicht Amazon S3 eine Testbenachrichtigung. Damit soll sichergestellt werden, dass das Thema vorhanden ist und dass der Bucket-Eigentümer über die Berechtigung verfügt, das angegebene Thema zu veröffentlichen. Wenn das Aktivieren der Benachrichtigung fehlschlägt, erhalten Sie keine Testbenachrichtigung.
s3:ObjectCreated:* s3:ObjectCreated:Put s3:ObjectCreated:Post s3:ObjectCreated:Copy s3:ObjectCreated:CompleteMultipartUpload	Amazon S3 API S3-Operationen wie PUTPOST, und COPY können ein Objekt erstellen. Mit diesen Ereignistypen können Sie Benachrichtigungen aktivieren, wenn ein Objekt mithilfe eines bestimmten API Vorgangs erstellt wird. Alternativ können Sie den s3:ObjectCreated:* Ereignistyp verwenden, um Benachrichtigungen anzufordern, unabhängig davonAPI, mit welchem Ereignistyp ein Objekt erstellt wurde. s3:ObjectCreated:CompleteMultipartUploadumfasst Objekte, die erstellt wurden mit UploadPartCopyfür Kopiervorgänge.
s3:ObjectRemoved:* s3:ObjectRemoved:Delete s3:ObjectRemoved:DeleteMarkerCreated	Mithilfe der ObjectRemoved Ereignistypen können Sie Benachrichtigungen aktivieren, wenn ein Objekt oder ein Stapel von Objekten aus einem Bucket entfernt wird. Sie können eine Benachrichtigung anfordern, wenn ein Objekt gelöscht wird, oder wenn ein versionsfähiges Objekt permanent gelöscht wird. Dazu wird der Ereignistyp s3:ObjectRemoved:Delete verwendet. Alternativ können Sie eine Benachrichtigung anfordern, wenn eine Löschmarkierung für ein versioniertes Objekt mit s3:ObjectRemoved:DeleteMarkerCreated erstellt wird. Eine entsprechende Anleitung zum Löschen von versionierten Objekten finden Sie unter Löschen von Objekten aus einem versioning-fähigen Bucket. Sie können auch eine Wildcard s3:ObjectRemoved:* verwenden, um bei jedem Löschen eines Objekts eine Benachrichtigung anzufordern. Diese Ereignisbenachrichtigungen warnen Sie nicht vor automatischen Löschungen aufgrund von Lebenszykluskonfigurationen oder fehlgeschlagenen Operationen.
s3:ObjectRestore:* s3:ObjectRestore:Post s3:ObjectRestore:Completed s3:ObjectRestore:Delete	Mithilfe der ObjectRestore Ereignistypen können Sie Benachrichtigungen über die Initiierung und den Abschluss von Ereignissen erhalten, wenn Objekte aus der Speicherklasse S3 Glacier Flexible Retrieval, der Speicherklasse S3 Glacier Deep Archive, der Stufe S3 Intelligent-Tiering Archive Access und der Stufe S3 Intelligent-Tiering Deep Archive Access wiederhergestellt werden. Sie können auch Benachrichtigungen erhalten, wann die wiederhergestellte Kopie eines Objekts abläuft. Der s3:ObjectRestore:Post-Ereignistyp informiert Sie über die Initiierung von Objektwiederherstellungen. Der s3:ObjectRestore:Completed-Ereignistyp informiert Sie über den Abschluss von Wiederherstellungen. Der s3:ObjectRestore:Delete-Ereignistyp benachrichtigt Sie, wenn die temporäre Kopie eines wiederhergestellten Objekts abläuft.
s3:ReducedRedundancyLostObject	Sie erhalten dieses Benachrichtigungsereignis, wenn Amazon S3 feststellt, dass ein Objekt der RRS Speicherklasse verloren gegangen ist.
s3:Replication:* s3:Replication:OperationFailedReplication s3:Replication:OperationMissedThreshold s3:Replication:OperationReplicatedAfterThreshold s3:Replication:OperationNotTracked	Mithilfe der Replication Ereignistypen können Sie Benachrichtigungen für Replikationskonfigurationen erhalten, für die S3-Replikationsmetriken oder S3 Replication Time Control (S3RTC) aktiviert sind. Sie können den minute-by-minute Fortschritt von Replikationsereignissen überwachen, indem Sie ausstehende Byte, ausstehende Vorgänge und die Replikationslatenz verfolgen. Informationen zu Replikationsmetriken finden Sie unter Überwachung der Replikation mit Metriken, Ereignisbenachrichtigungen und Status. Der s3:Replication:OperationFailedReplication-Ereignistyp benachrichtigt Sie, wenn ein Objekt, das für die Replikation berechtigt war, nicht repliziert werden konnte. Der s3:Replication:OperationMissedThreshold Ereignistyp benachrichtigt Sie, wenn ein Objekt, das für die Replikation in Frage kam und S3 verwendet, den 15-minütigen Schwellenwert für die Replikation RTC überschreitet. Der s3:Replication:OperationReplicatedAfterThreshold Ereignistyp benachrichtigt Sie, wenn ein Objekt, das für die Replikation in Frage kam und S3 verwendet, nach dem RTC 15-Minuten-Schwellenwert repliziert wird. Der s3:Replication:OperationNotTracked Ereignistyp benachrichtigt Sie, wenn ein Objekt, das für die Live-Replikation in Frage kam (entweder Replikation in derselben Region [SRR] oder regionsübergreifende Replikation [CRR]), nicht mehr anhand von Replikationsmetriken verfolgt wird.
s3:LifecycleExpiration:* s3:LifecycleExpiration:Delete s3:LifecycleExpiration:DeleteMarkerCreated	Mithilfe der LifecycleExpiration Ereignistypen können Sie eine Benachrichtigung erhalten, wenn Amazon S3 ein Objekt auf der Grundlage Ihrer S3-Lifecycle-Konfiguration löscht. Der Ereignistyp s3:LifecycleExpiration:Delete benachrichtigt Sie, wenn ein Objekt in einem unversionierten Bucket gelöscht wird. Es benachrichtigt Sie auch, wenn eine Objektversion durch eine S3-Lebenszyklus-Konfiguration dauerhaft gelöscht wird. Der Ereignistyp s3:LifecycleExpiration:DeleteMarkerCreated benachrichtigt Sie, wenn S3 Lebenszyklus eine Löschmarke erstellt, wenn eine aktuelle Version eines Objekts im versionierten Bucket gelöscht wird.
s3:LifecycleTransition	Sie erhalten dieses Benachrichtigungsereignis, wenn ein Objekt von einer S3-Lebenszykluskonfiguration in eine andere Amazon-S3-Speicherklasse überführt wird.
s3:IntelligentTiering	Sie erhalten dieses Benachrichtigungsereignis, wenn ein Objekt innerhalb der Speicherklasse S3 Intelligent-Tiering in die Stufe Archive Access oder Deep Archive Access verschoben wird.
s3:ObjectTagging:* s3:ObjectTagging:Put s3:ObjectTagging:Delete	Mithilfe der ObjectTagging Ereignistypen können Sie Benachrichtigungen aktivieren, wenn ein Objekt-Tag hinzugefügt oder aus einem Objekt gelöscht wird. Der s3:ObjectTagging:Put Ereignistyp benachrichtigt Sie, wenn sich ein Tag PUT auf einem Objekt befindet oder wenn ein vorhandenes Tag aktualisiert wird. Der s3:ObjectTagging:Delete-Ereignistyp benachrichtigt Sie, wenn ein Tag aus einem Objekt entfernt wird.
s3:ObjectAcl:Put	Sie erhalten dieses Benachrichtigungsereignis, wenn ACL sich ein Objekt PUT auf einem Objekt befindet oder wenn ein vorhandenes geändert ACL wird. Ein Ereignis wird nicht generiert, wenn eine Anfrage zu keiner Änderung an einem Objekt führtACL.

Unterstützte Ereignistypen für Amazon EventBridge

Eine Liste der Ereignistypen, die Amazon S3 an Amazon sendet EventBridge, finden Sie unterVerwenden EventBridge.

Bestellung von Veranstaltungen und doppelte Ereignisse

Amazon S3 Event Notifications ist so konzipiert, dass Benachrichtigungen mindestens einmal zugestellt werden, aber es kann nicht garantiert werden, dass sie in derselben Reihenfolge ankommen, in der die Ereignisse eingetreten sind. In seltenen Fällen kann der Wiederholungsmechanismus von Amazon S3 zu doppelten S3-Ereignisbenachrichtigungen für dasselbe Objektereignis führen. Weitere Informationen zum Umgang mit doppelten oder nicht in der richtigen Reihenfolge befindlichen Ereignissen finden Sie unter Verwaltung der Bestellung von Veranstaltungen und doppelten Ereignissen mit Amazon S3 S3-Ereignisbenachrichtigungen im AWS Storage-Blog.