Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Verwenden EventBridge
Amazon S3 kann Ereignisse an Amazon senden, EventBridge wenn bestimmte Ereignisse in Ihrem Bucket auftreten. Im Gegensatz zu anderen Zielen müssen Sie nicht auswählen, welche Ereignistypen Sie liefern möchten. Nach EventBridge der Aktivierung werden alle unten aufgeführten Ereignisse an gesendet EventBridge. Sie können EventBridge Regeln verwenden, um Ereignisse an weitere Ziele weiterzuleiten. Im Folgenden sind die Ereignisse aufgeführt, an die Amazon S3 sendet EventBridge.
| Ereignistyp | Description |
| --- | --- |
| *Objekt erstellt* | Ein Objekt wurde erstellt. Das Ursachenfeld in der Ereignisnachrichtenstruktur gibt an, welche S3-API zum Erstellen des Objekts verwendet wurde: [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) oder [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html). |
| *Objekt gelöscht (DeleteObject)* *Objekt gelöscht (Lebenszyklusablauf)* | Ein Objekt wurde gelöscht. Wenn ein Objekt mit einem S3-API-Aufruf gelöscht wird, wird das Ursachenfeld auf DeleteObject festgelegt. Wenn ein Objekt durch eine S3-Lebenszyklus-Ablaufregel gelöscht wird, wird das Grundfeld auf Lebenszyklus-Ablauf gesetzt. Weitere Informationen finden Sie unter [Ablauf von Objekten](lifecycle-expire-general-considerations.md). Wenn ein nicht versioniertes Objekt gelöscht wird oder ein versioniertes Objekt dauerhaft gelöscht wird, wird das Feld für den Löschtyp auf „Permanently Deleted“ gesetzt. Wenn eine Löschmarkierung für ein versioniertes Objekt erstellt wird, wird das Feld für den „`deletion-type`“ auf „Delete Marker Created“ gesetzt. Weitere Informationen finden Sie unter [Löschen von Objekten aus einem versioning-fähigen Bucket](DeletingObjectVersions.md). |
| *Objektwiederherstellung eingeleitet* | Eine Objektwiederherstellung wurde von der Speicherklasse S3 Glacier Flexible Retrieval oder S3 Glacier Deep Archive oder von der Schicht S3 Intelligent-Tiering Archive Access oder Deep Archive Access initiiert. Weitere Informationen finden Sie unter [Arbeiten mit archivierten Objekten](archived-objects.md). |
| *Objektwiederherstellung abgeschlossen* | Eine Objektwiederherstellung wurde abgeschlossen. |
| *Wiederherstellen von Objekten ist abgelaufen* | Die temporäre Kopie eines von S3 Glacier Flexible Retrieval oder S3 Glacier Deep Archive wiederhergestellten Objekts ist abgelaufen und wurde gelöscht. |
| *Objektspeicherklasse geändert* | Ein Objekt wurde auf eine andere Speicherklasse umgestellt. Weitere Informationen finden Sie unter [Übertragen von Objekten mit Amazon-S3-Lebenszyklus](lifecycle-transition-general-considerations.md). |
| *Objektzugriffsebene wurde geändert* | Ein Objekt wurde auf die Stufen S3 Intelligent-Tiering Archive Access oder Deep Archive Access umgestellt. Weitere Informationen finden Sie unter [Mit Amazon S3 Intelligent-Tiering Speicherkosten verwalten](intelligent-tiering.md). |
| *ACL-Objekt aktualisiert* | Die Zugriffssteuerungsliste (ACL) eines Objekts wurde mit `PutObjectAcl` festgelegt. Ein Ereignis wird nicht generiert, wenn eine Anforderung keine Änderung an der ACL eines Objekts zur Folge hat. Weitere Informationen finden Sie unter [Zugriffskontrolllisten (ACL) – Übersicht](acl-overview.md). |
| *Objekt-Tags hinzugefügt* | Mit `PutObjectTagging` wurde einem Objekt ein Satz von Tags hinzugefügt. Weitere Informationen finden Sie unter [Kategorisierung Ihrer Objekte mit Hilfe von Tags](object-tagging.md). |
| *Gelöschte Objekt-Tags* | Alle Tags wurden mit `DeleteObjectTagging` aus einem Objekt entfernt. Weitere Informationen finden Sie unter [Kategorisierung Ihrer Objekte mit Hilfe von Tags](object-tagging.md). |
**Anmerkung**
Weitere Informationen darüber, wie Amazon S3 S3-Ereignistypen EventBridge Ereignistypen zugeordnet werden, finden Sie unter[EventBridge Amazon-Kartierung und Problembehebung](ev-mapping-troubleshooting.md).
Sie können Amazon S3 Event Notifications mit verwenden EventBridge , um Regeln zu schreiben, die Maßnahmen ergreifen, wenn ein Ereignis in Ihrem Bucket eintritt. Sie können sich beispielsweise eine Benachrichtigung senden lassen. Weitere Informationen finden Sie unter [Was ist EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) im * EventBridge Amazon-Benutzerhandbuch*.
Weitere Informationen zu den Aktionen und Datentypen, mit denen Sie über die EventBridge API interagieren können, finden Sie in der [Amazon EventBridge API-Referenz](https://docs.aws.amazon.com/eventbridge/latest/APIReference/Welcome.html) in der *Amazon EventBridge API-Referenz*.
Informationen zu den Preisen finden Sie unter [ EventBridge Amazon-Preise](https://aws.amazon.com/eventbridge/pricing).
**Topics**
+ [EventBridge Amazon-Berechtigungen](ev-permissions.md)
+ [Amazon aktivieren EventBridge](enable-event-notifications-eventbridge.md)
+ [EventBridge Struktur der Ereignisnachricht](ev-events.md)
+ [EventBridge Amazon-Kartierung und Problembehebung](ev-mapping-troubleshooting.md)
# EventBridge Amazon-Berechtigungen
Amazon S3 benötigt keine zusätzlichen Berechtigungen, um Ereignisse an Amazon zu übermitteln EventBridge.
# Amazon aktivieren EventBridge
Sie können Amazon EventBridge mithilfe der S3-Konsole AWS Command Line Interface (AWS CLI) oder der Amazon S3 S3-REST-API aktivieren.
**Anmerkung**
Nach der Aktivierung dauert es etwa fünf Minuten EventBridge, bis die Änderungen wirksam werden.
## Verwenden der S3-Konsole
**Um die EventBridge Ereigniszustellung in der S3-Konsole zu aktivieren.**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon S3 S3-Konsole unter [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Wählen Sie im linken Navigationsbereich **Allzweck-Buckets** aus.
1. Wählen Sie in der Bucket-Liste den Namen des Buckets, für den Sie Ereignisse aktivieren möchten.
1. Wählen Sie **Properties (Eigenschaften)**.
1. Gehen Sie zum Abschnitt **Event-Benachrichtigungen** und suchen Sie den ** EventBridgeAmazon-Unterabschnitt**. Wählen Sie **Bearbeiten** aus.
1. Wählen **Sie unter Benachrichtigungen EventBridge für alle Ereignisse in diesem Bucket an Amazon senden** die Option **An**.
## Verwenden Sie AWS CLI
Im folgenden Beispiel wird eine Bucket-Benachrichtigungskonfiguration für einen Bucket *`amzn-s3-demo-bucket1`* mit EventBridge aktiviertem Amazon erstellt.
```
aws s3api put-bucket-notification-configuration --bucket amzn-s3-demo-bucket1 --notification-configuration='{ "EventBridgeConfiguration": {} }'
```
## Verwenden der REST-API
Sie können Amazon programmgesteuert in einem Bucket aktivieren, indem Sie die EventBridge Amazon S3 S3-REST-API aufrufen. Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotificationConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotificationConfiguration.html) in der *API-Referenz zu Amazon Simple Storage Service*.
Das folgende Beispiel zeigt das XML, das verwendet wurde, um eine Bucket-Benachrichtigungskonfiguration mit EventBridge aktiviertem Amazon zu erstellen.
```
```
## EventBridge Regeln erstellen
Nach der Aktivierung können Sie EventBridge Amazon-Regeln für bestimmte Aufgaben erstellen. Beispielsweise können Sie E-Mail-Benachrichtigungen senden, wenn ein Objekt erstellt wird. Ein vollständiges Tutorial finden Sie unter [Tutorial: Eine Benachrichtigung senden, wenn ein Amazon S3 S3-Objekt erstellt wird](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-s3-object-created-tutorial.html) im * EventBridge Amazon-Benutzerhandbuch*.
# EventBridge Struktur der Ereignisnachricht
Die Benachrichtigung, die Amazon S3 sendet, um ein Ereignis zu veröffentlichen, verwendet das JSON-Format. Wenn Amazon S3 ein Ereignis an Amazon sendet EventBridge, sind die folgenden Felder vorhanden.
+ `version` – Derzeit 0 (Null) für alle Ereignisse.
+ `id` – Eine UUID, die für jedes Ereignis generiert wurde.
+ `detail-type` – Die Art des Ereignisses, das gesendet wird. Eine Liste der Ereignistypen finden Sie unter [Verwenden EventBridge](EventBridge.md).
+ `source` – Identifiziert den Service, aus dem das Ereignis stammt.
+ `account`— Die 12-stellige AWS-Konto ID des Bucket-Besitzers.
+ `time` – Der Zeitpunkt, an dem das Ereignis aufgetreten ist.
+ `region`— Identifiziert die AWS-Region des Buckets.
+ `resources` – Ein JSON-Array, das den Amazon-Ressourcennamen (ARN) des Buckets enthält.
+ `detail` – Ein JSON-Objekt, das Informationen zum Ereignis enthält. Weitere Informationen dazu, was in diesem Feld enthalten sein kann, finden Sie unter [Detailfeld für Ereignismeldung](#ev-events-detail).
## Beispiele für Ereignismeldungen
Im Folgenden finden Sie Beispiele für einige der Amazon S3 S3-Ereignisbenachrichtigungen, die an Amazon gesendet werden können EventBridge.
### Objekt erstellt
```
{
"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"
}
}
```
### Objekt wurde gelöscht (mithilfe von 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"
}
}
```
### Objekt wurde gelöscht (unter Verwendung des Lebenszyklusablaufs)
```
{
"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"
}
}
```
### Objektwiederherstellung abgeschlossen
```
{
"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"
}
}
```
## Detailfeld für Ereignismeldung
Das Detailfeld enthält ein JSON-Objekt mit Informationen über das Ereignis. Die folgenden Felder können im Detailfeld vorhanden sein.
+ `version` – Derzeit 0 (Null) für alle Ereignisse.
+ `bucket` – Informationen zum Amazon S3-Bucket, der an dem Event beteiligt ist.
+ `object` – Informationen über das an dem Ereignis beteiligte Amazon-S3-Objekt.
+ `request-id` – Anforderungs-ID in S3 Antwort.
+ `requester`— AWS-Konto ID oder AWS Dienstprinzipal des Anfragenden.
+ `source-ip-address` – Quell-IP-Adresse der S3-Anforderung. Nur vorhanden für Ereignisse, die durch eine S3-Anfrage ausgelöst werden.
+ `reason` – Bei Ereignissen vom **Typ Object** wird die S3-API verwendet, um das Objekt zu erstellen: [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), oder [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html). Für **Object Deleted**-Ereignisse wird dies auf **DeleteObject** gesetzt, wenn ein Objekt durch einen S3-API-Aufruf gelöscht wird, oder **Lebenszyklusablauf**, wenn ein Objekt durch eine S3-Lebenszyklus-Ablaufregel gelöscht wird. Weitere Informationen finden Sie unter [Ablauf von Objekten](lifecycle-expire-general-considerations.md).
+ `deletion-type` – Wenn ein nicht versioniertes Objekt gelöscht wird oder ein versioniertes Objekt dauerhaft gelöscht wird, wird bei **Object Deleted**-Ereignissen dies auf **Permanently Deleted** festgelegt. Wenn ein Löschmarker für ein versioniertes Objekt erstellt wird, wird dieser auf **Löschmarkierung erstellt** gesetzt. Weitere Informationen finden Sie unter [Löschen von Objekten aus einem versioning-fähigen Bucket](DeletingObjectVersions.md).
**Anmerkung**
Einige Objektattribute (wie `etag` und`size`) sind nur vorhanden, wenn eine Löschmarkierung erstellt wird.
+ `restore-expiry-time` – Bei Ereignissen **Objektwiederherstellung abgeschlossen** der Zeitpunkt, zu dem die temporäre Kopie des Objekts aus S3 gelöscht wird. Weitere Informationen finden Sie unter [Arbeiten mit archivierten Objekten](archived-objects.md).
+ `source-storage-class` – Bei den Ereignissen **Objektwiederherstellung eingeleitet** und **Objektwiederherstellung abgeschlossen** die Speicherklasse des wiederherzustellenden Objekts. Weitere Informationen finden Sie unter [Arbeiten mit archivierten Objekten](archived-objects.md).
+ `destination-storage-class` – Für Ereignisse **Objektspeicherklasse geändert** die neue Speicherklasse des Objekts. Weitere Informationen finden Sie unter [Übertragen von Objekten mit Amazon-S3-Lebenszyklus](lifecycle-transition-general-considerations.md).
+ `destination-access-tier` – Für Ereignisse **Objektzugriffebene geändert** die neue Zugriffebene des Objekts. Weitere Informationen finden Sie unter [Mit Amazon S3 Intelligent-Tiering Speicherkosten verwalten](intelligent-tiering.md).
# EventBridge Amazon-Kartierung und Problembehebung
In der folgenden Tabelle wird beschrieben, wie Amazon S3 S3-Ereignistypen EventBridge Amazon-Ereignistypen zugeordnet werden.
| S3-Ereignistyp | EventBridge Amazon-Detailtyp |
| --- | --- |
| [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) | Objekt erstellt |
| ObjectRemoved:Delete ObjectRemoved:DeleteMarkerCreated LifecycleExpiration:Delete LifecycleExpiration:DeleteMarkerCreated | Objekt gelöscht |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html) | Objektwiederherstellung eingeleitet |
| ObjectRestore:Completed | Objektwiederherstellung abgeschlossen |
| ObjectRestore:Delete | Wiederherstellen von Objekten ist abgelaufen |
| LifecycleTransition | Objektspeicherklasse geändert |
| IntelligentTiering | Objektzugriffsebene wurde geändert |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html) | Objekt-Tags hinzugefügt |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html) | Gelöschte Objekt-Tags |
| [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectAcl.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectAcl.html) | ACL-Objekt aktualisiert |
## EventBridge Amazon-Problembehebung
Informationen zur Fehlerbehebung EventBridge finden Sie unter [Problembehandlung bei Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-troubleshooting.html) im * EventBridge Amazon-Benutzerhandbuch*.