

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.

# Erstellen Sie eine EventBridge Regel für eine Amazon S3-Quelle (Konsole)
<a name="create-cloudtrail-S3-source-console"></a>

Bevor Sie eine Regel einrichten EventBridge, müssen Sie einen AWS CloudTrail Trail erstellen. Weitere Informationen finden Sie unter [Erstellen eines Trails in der Konsole](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-a-trail-using-the-console-first-time.html).

**Wichtig**  
Wenn Sie die Konsole verwenden, um Ihre Pipeline zu erstellen oder zu bearbeiten, werden Ihre EventBridge Regel und Ihr AWS CloudTrail Trail für Sie erstellt.

**So erstellen Sie einen Trail**

1. Öffnen Sie die AWS CloudTrail Konsole.

1. Wählen Sie im Navigationsbereich **Trails** aus.

1. Wählen Sie **Create Trail (Trail erstellen)** aus. Geben Sie unter **Trail name (Trail-Name)** einen Namen für Ihren Trail ein.

1. Erstellen oder geben Sie unter **Storage location** (Speicherort) den Bucket an, der zum Speichern der Protokolldateien verwendet werden soll. Standardmäßig werden Amazon-S3-Buckets und -Objekte als privat eingestuft. Nur der Ressourcenbesitzer (das AWS Konto, das den Bucket erstellt hat) kann auf den Bucket und seine Objekte zugreifen. Der Bucket muss über eine Ressourcenrichtlinie verfügen, die AWS CloudTrail Berechtigungen für den Zugriff auf die Objekte im Bucket gewährt.

1. Geben Sie unter ** Trail-Log-Bucket und -Ordner ** einen Amazon S3-Bucket und das Objektpräfix (Ordnername) an, um Datenereignisse für alle Objekte im Ordner zu protokollieren. Sie können jedem Trail 250 Amazon S3-Objekte hinzufügen. Geben Sie die erforderlichen Informationen zum Verschlüsselungsschlüssel ein und wählen Sie ** Weiter**.

1. Wählen Sie als ** Ereignistyp ** die Option ** Verwaltungsereignisse aus**.

1. Wählen Sie für ** Management-Ereignisse ** die Option ** Write aus**. Der Trail zeichnet die Amazon S3-API-Aktivität auf Objektebene (z. B. `GetObject` und`PutObject`) für den angegebenen Bucket und das angegebene Präfix auf.

1. Wählen Sie **Write (Schreiben)** aus. 

1. Wenn Sie mit dem Trail zufrieden sind, wählen Sie ** Create trail. **

**Um eine EventBridge Regel zu erstellen, die auf Ihre Pipeline mit einer Amazon S3-Quelle abzielt**

1. Öffnen Sie die EventBridge Amazon-Konsole unter [ https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Wählen Sie im Navigationsbereich **Regeln** aus. Lassen Sie den Standardbus ausgewählt oder wählen Sie einen Event-Bus. Wählen Sie **Regel erstellen** aus.

1. Geben Sie im ** Feld Name einen Namen für Ihre Regel ein. **

1. Wählen Sie unter ** Regeltyp ** die Option ** Regel mit einem Ereignismuster aus**. Wählen Sie **Weiter** aus.

1. Wählen Sie unter ** Ereignisquelle ** **AWS Ereignisse oder EventBridge Partnerereignisse aus**.

1. Wählen Sie unter ** Beispielereignistyp ** die Option **AWS Ereignisse aus**.

1. Geben Sie im Feld ** Beispielereignisse S3 als Schlüsselwort ein**, nach dem gefiltert werden soll. Wählen Sie **AWS API-Aufruf über CloudTrail**.

1. Wählen Sie unter ** Erstellungsmethode ** die Option ** Kundenmuster (JSON-Editor) aus**.

   Fügen Sie das unten angegebene Event-Muster ein. Stellen Sie sicher, dass Sie den Bucket-Namen und den S3-Objektschlüssel (oder Schlüsselnamen) hinzufügen, der das Objekt im Bucket eindeutig als identifiziert`requestParameters`. In diesem Beispiel wird eine Regel für einen Bucket mit dem Namen `amzn-s3-demo-source-bucket` und dem Objektschlüssel von erstellt`my-files.zip`. Wenn Sie das Fenster **Edit (Bearbeiten)** zum Angeben von Ressourcen verwenden, wird Ihre Regel für die Verwendung eines benutzerdefinierten Ereignismusters aktualisiert.

   Im Folgenden finden Sie ein Beispiel-Ereignismuster, das Sie kopieren und einfügen können:

   ```
   {
       "source": [
           "aws.s3"
       ],
       "detail-type": [
           "AWS API Call via CloudTrail"
       ],
       "detail": {
           "eventSource": [
               "s3.amazonaws.com"
           ],
           "eventName": [
               "CopyObject",
               "CompleteMultipartUpload",
               "PutObject"
           ],
           "requestParameters": {
               "bucketName": [
                   "amzn-s3-demo-source-bucket"
               ],
               "key": [
                   "my-files.zip"
               ]
           }
       }
   }
   ```

1. Wählen Sie **Weiter** aus.

1. Wählen Sie ** unter Zieltypen ** die Option **AWS Service aus**.

1. **Wählen Sie unter Ziel auswählen ** die Option ** CodePipeline**. Geben Sie im Feld ** Pipeline-ARN ** den Pipeline-ARN für die Pipeline ein, die nach dieser Regel gestartet werden soll.
**Anmerkung**  
Um den Pipeline-ARN zu erhalten, führen Sie den Befehl **get-pipeline** aus. Der Pipeline-ARN wird in der Ausgabe angezeigt. Er wird in folgendem Format erstellt:   
arn:aws:codepipeline:: {{region}} {{account}} {{pipeline-name}}  
Pipeline-Beispiel-ARN:  
arn: aws: codepipeline: us-east- 2:80398 EXAMPLE:MyFirstPipeline 

1. So erstellen oder spezifizieren Sie eine IAM-Servicerolle, die EventBridge Berechtigungen zum Aufrufen des mit Ihrer Regel verknüpften Ziels gewährt (in diesem Fall lautet das Ziel): EventBridge CodePipeline 
   + Wählen Sie Neue Rolle für diese spezifische Ressource ** erstellen aus, um eine Servicerolle ** zu erstellen, die Ihnen EventBridge Berechtigungen zum Starten Ihrer Pipeline-Ausführungen gewährt.
   + Wählen Sie Bestehende Rolle ** verwenden aus**, um eine Servicerolle einzugeben, die Ihnen EventBridge Berechtigungen zum Starten Ihrer Pipeline-Ausführungen erteilt.

1. (Optional) Um Quellüberschreibungen mit einer bestimmten Bild-ID anzugeben, verwenden Sie den Eingangstransformator, um die Daten als JSON-Parameter zu übergeben. Sie können den Eingangstransformator auch verwenden, um Pipeline-Variablen zu übergeben.
   + Erweitern Sie **Additional settings** (Zusätzliche Einstellungen).

     Wählen ** Sie unter Zieleingang konfigurieren ** die Option Eingangstransformator ** konfigurieren aus**.

     Wählen Sie im Dialogfenster die Option Eigenen ** eingeben**. **Geben Sie in das ** Feld Eingabepfad die folgenden Schlüssel-Wert-Paare ein.

     ```
     {"revisionValue": "$.detail.object.version-id"}
     ```
   + Geben Sie in das ** Feld ** Vorlage die folgenden Schlüssel-Wert-Paare ein.

     ```
                                     
                                     {
         "sourceRevisions": [
             {
                 "actionName": "{{Source}}",
                 "revisionType": "S3_OBJECT_VERSION_ID",
                 "revisionValue": "<{{revisionValue}}>"
             }
         ],
          "variables": [
             {
                 "name": "{{Variable_Name}}",
                 "value": "{{Variable_Value}}"
             }
         ]
     }
     ```
   + Wählen Sie **Bestätigen** aus.

1. Wählen Sie **Weiter** aus.

1. Wählen Sie auf der ** Seite „**Tags“ die Option Weiter aus**. **

1. **Überprüfen Sie auf der ** Seite Überprüfen und erstellen die Regelkonfiguration. Wenn Sie mit der Regel zufrieden sind, klicken Sie auf **Create rule (Regel erstellen)**.