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.

# GitHub Webhook-Ereignisse
<a name="github-webhook"></a>

Sie können Webhook-Filtergruppen verwenden, um anzugeben, welche GitHub Webhook-Ereignisse einen Build auslösen. Sie können beispielsweise angeben, dass ein Build nur bei Änderungen an bestimmten Branches ausgelöst wird. 

Sie können eine oder mehrere Webhook-Filtergruppen erstellen, um anzugeben, welche Webhook-Ereignisse einen Build auslösen. Ein Build wird ausgelöst, wenn eine Filtergruppe als wahr ausgewertet wird. Dies ist der Fall, wenn alle Filter in der Gruppe den Wert true ergeben. Wenn Sie eine Filtergruppe erstellen, geben Sie Folgendes an: 

**Ein Ereignis**  
Für GitHub können Sie eines oder mehrere der folgenden Ereignisse auswählen:`PUSH`,`PULL_REQUEST_CREATED`,`PULL_REQUEST_UPDATED`,`PULL_REQUEST_REOPENED`,`PULL_REQUEST_MERGED`, `PULL_REQUEST_CLOSED``RELEASED`,`PRERELEASED`, und`WORKFLOW_JOB_QUEUED`. Der Webhook-Ereignistyp ist im `X-GitHub-Event`-Header in der Webhook-Nutzlast zu finden. Im `X-GitHub-Event`-Header befindet sich möglicherweise `pull_request` oder `push`. Bei einem Pull-Anforderungstyp befindet sich der Typ im Feld `action` der Webhook-Ereignisnutzlast. Aus der folgenden Tabelle geht die Zuordnung der `X-GitHub-Event`-Header-Werte und der Werte im Feld `action` der Webhook-Pull-Anforderungsnutzlast zu den verfügbaren Ereignistypen hervor.      
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/codebuild/latest/userguide/github-webhook.html)
 Der `PULL_REQUEST_REOPENED` Ereignistyp kann nur mit GitHub GitHub Enterprise Server verwendet werden. Der `PRERELEASED` Ereignistyp `RELEASED` und kann GitHub nur mit verwendet werden. Weitere Informationen zu `WORKFLOW_JOB_QUEUED` finden Sie unter [Tutorial: Einen CodeBuild -gehosteten GitHub Actions-Runner konfigurieren](action-runner.md). 

**Ein oder mehrere optionale Filter**  
Verwenden Sie einen regulären Ausdruck, um einen Filter anzugeben. Damit ein Ereignis einen Build auslöst, muss jeder Filter innerhalb der Gruppe, die diesem Ereignis zugeordnet ist, als wahr ausgewertet werden.    
`ACTOR_ACCOUNT_ID`(`ACTOR_ID`in der Konsole)  
Ein Webhook-Ereignis löst einen Build aus, wenn eine GitHub oder GitHub Enterprise Server-Konto-ID dem regulären Ausdrucksmuster entspricht. Dieser Wert befindet sich in der Eigenschaft `id` des Objekts `sender` in der Webhook-Nutzlast.  
`HEAD_REF`  
Ein Webhook-Ereignis löst einen Build aus, wenn die Hauptreferenz mit dem Muster eines regulären Ausdrucks übereinstimmt (z. B. `refs/heads/branch-name` oder`refs/tags/tag-name`). Bei einem Push-Ereignis ist der Referenzname in der Eigenschaft `ref` in der Webhook-Nutzlast zu finden. Bei Pull-Anforderungsereignissen befindet sich der Branch-Name in der Eigenschaft `ref` des Objekts `head` in der Webhook-Nutzlast.   
`BASE_REF`  
Ein Webhook-Ereignis löst einen Build aus, wenn die Basisreferenz mit dem Muster eines regulären Ausdrucks übereinstimmt (z. B.`refs/heads/branch-name`). Ein `BASE_REF`-Filter kann nur für Pull-Anforderungsereignisse verwendet werden. Der Branch-Name befindet sich in der Eigenschaft `ref` des Objekts `base` in der Webhook-Nutzlast.  
`FILE_PATH`  
Ein Webhook löst einen Build aus, wenn der Pfad einer geänderten Datei dem Muster regulärer Ausdrücke entspricht. Ein `FILE_PATH` Filter kann für GitHub Push- und Pull-Request-Ereignisse sowie für GitHub Enterprise Server-Push-Ereignisse verwendet werden. Er kann nicht mit GitHub Enterprise Server-Pull-Request-Ereignissen verwendet werden.   
`COMMIT_MESSAGE`  
Ein Webhook löst einen Build aus, wenn die Head-Commit-Nachricht dem Muster eines regulären Ausdrucks entspricht. Ein `COMMIT_MESSAGE` Filter kann für GitHub Push- und Pull-Request-Ereignisse sowie für GitHub Enterprise Server-Push-Ereignisse verwendet werden. Er kann nicht mit GitHub Enterprise Server-Pull-Request-Ereignissen verwendet werden.  
`TAG_NAME`  
Ein Webhook löst einen Build aus, wenn der Tag-Name der Version mit dem Muster des regulären Ausdrucks übereinstimmt. Ein `TAG_NAME` Filter kann für GitHub veröffentlichte und vorab veröffentlichte Anforderungsereignisse verwendet werden.  
`RELEASE_NAME`  
Ein Webhook löst einen Build aus, wenn der Versionsname mit dem Muster eines regulären Ausdrucks übereinstimmt. Ein `RELEASE_NAME` Filter kann für GitHub veröffentlichte und vorab veröffentlichte Anforderungsereignisse verwendet werden.  
`REPOSITORY_NAME`  
Ein Webhook löst einen Build aus, wenn der Name des Repositorys dem Muster eines regulären Ausdrucks entspricht. Ein `REPOSITORY_NAME` Filter kann nur mit GitHub globalen oder organisatorischen Webhooks verwendet werden.  
`ORGANIZATION_NAME`  
Ein Webhook löst einen Build aus, wenn der Name der Organisation dem Muster eines regulären Ausdrucks entspricht. Ein `ORGANIZATION_NAME` Filter kann nur mit GitHub globalen Webhooks verwendet werden.  
`WORKFLOW_NAME`  
Ein Webhook löst einen Build aus, wenn der Workflow-Name mit dem Muster des regulären Ausdrucks übereinstimmt. Ein `WORKFLOW_NAME` Filter kann für Ereignisse in der Warteschlange von Aufträgen im GitHub Aktionsworkflow verwendet werden.

**Anmerkung**  
Sie finden die Webhook-Payload in den Webhook-Einstellungen Ihres Repositorys. GitHub 

**Topics**
+ [

# GitHub Webhook-Ereignisse filtern (Konsole)
](github-webhook-events-console.md)
+ [

# GitHub Webhook-Ereignisse filtern (SDK)
](github-webhook-events-sdk.md)
+ [

# GitHub Webhook-Ereignisse filtern ()CloudFormation
](github-webhook-events-cfn.md)

# GitHub Webhook-Ereignisse filtern (Konsole)
<a name="github-webhook-events-console"></a>

Verwenden Sie die folgenden Anweisungen, um GitHub Webhook-Ereignisse mithilfe von zu filtern. AWS-Managementkonsole Weitere Hinweise zu GitHub Webhook-Ereignissen finden Sie unter. [GitHub Webhook-Ereignisse](github-webhook.md)

Wählen Sie unter **Primäre Webhook-Ereignisse** die folgenden Optionen aus. Dieser Abschnitt ist nur verfügbar, wenn Sie **in Mein GitHub Konto für das Quell-Repository** die Option Repository ausgewählt haben.

1. Wählen Sie beim Erstellen Ihres Projekts **Rebuild every time a code change is pushed to this repository (Erneut erstellen, wenn eine Codeänderung an dieses Repository übergeben wird)** aus. 

1. Wählen Sie unter **Event type (Ereignistyp)** eines oder mehrere Ereignisse aus. 

1. Wenn Sie Fälle filtern möchten, in denen ein Ereignis einen Build auslöst, fügen Sie unter **Start a build under these conditions (Unter diesen Bedingungen Build starten)** einen oder mehrere optionale Filter hinzu. 

1. Wenn Sie Fälle filtern möchten, in denen kein Ereignis ausgelöst wird, fügen Sie unter **Don't start a build under these conditions (Unter diesen Bedingungen keinen Build starten)** einen oder mehrere optionale Filter hinzu. 

1. Wählen **Sie Filtergruppe** hinzufügen, um bei Bedarf eine weitere Filtergruppe hinzuzufügen. 

 Weitere Informationen finden Sie unter [Erstellen Sie ein Build-Projekt (Konsole)](create-project.md#create-project-console) und [WebhookFilter](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_WebhookFilter.html) in der *AWS CodeBuild -API-Referenz*. 

In diesem Beispiel löst eine Webhook-Filtergruppe nur für Pull-Anfragen einen Build aus:

![\[Eine Webhook-Filtergruppe, die einen Build nur für Pull-Requests auslöst.\]](http://docs.aws.amazon.com/de_de/codebuild/latest/userguide/images/pull-request-webhook-filter.png)


Bei Verwendung eines Beispiels mit zwei Webhook-Filtergruppen wird ein Build ausgelöst, wenn mindestens eine Gruppe als wahr ausgewertet wird:
+ Die erste Filtergruppe gibt Pull-Anfragen an, die in Verzweigungen mit Git-Referenznamen, die dem regulären Ausdruck `^refs/heads/main$` entsprechen, und mit Kopfreferenzen, die `^refs/heads/branch1$` entsprechen, erstellt, aktualisiert oder erneut geöffnet werden. 
+ Die zweite Filtergruppe gibt Push-Anfragen in Verzweigungen mit Git-Referenznamen an, die dem regulären Ausdruck `^refs/heads/branch1$` entsprechen. 

![\[Ein Beispiel für zwei Filtergruppen.\]](http://docs.aws.amazon.com/de_de/codebuild/latest/userguide/images/pull-request-webhook-filter-head-base-regexes.png)


In diesem Beispiel löst eine Webhook-Filtergruppe einen Build für alle Anfragen mit Ausnahme von Tag-Ereignissen aus. 

![\[Eine Webhook-Filtergruppe, die einen Build für alle Anfragen außer Tag-Ereignissen auslöst.\]](http://docs.aws.amazon.com/de_de/codebuild/latest/userguide/images/pull-request-webhook-filter-exclude.png)


In diesem Beispiel löst eine Webhook-Filtergruppe nur einen Build aus, wenn Dateien geändert werden, deren Namen dem regulären Ausdruck `^buildspec.*` entsprechen. 

![\[Eine Webhook-Filtergruppe, die nur dann einen Build auslöst, wenn Dateien mit Namen angegeben sind, die dem regulären Ausdruck entsprechen.\]](http://docs.aws.amazon.com/de_de/codebuild/latest/userguide/images/pull-request-webhook-filter-file-name-regex.png)


In diesem Beispiel löst eine Webhook-Filtergruppe nur dann einen Build aus, wenn Dateien in Ordnern `src` oder `test` geändert werden.

![\[Eine Webhook-Filtergruppe, die einen Build nur auslöst, wenn Dateien in bestimmten Ordnern geändert werden.\]](http://docs.aws.amazon.com/de_de/codebuild/latest/userguide/images/pull-request-webhook-filter-file-name-combined-regex.png)


In diesem Beispiel löst eine Webhook-Filtergruppe einen Build nur dann aus, wenn eine Änderung von einem bestimmten Benutzer GitHub oder einem GitHub Enterprise Server-Benutzer mit einer Konto-ID vorgenommen wird, die dem regulären Ausdruck entspricht. `actor-account-id` 

**Anmerkung**  
 Informationen darüber, wie Sie Ihre GitHub Konto-ID finden https://api.github.com/users/*user-name*, finden Sie unter Wo *user-name* ist Ihr GitHub Benutzername. 

![\[Eine Webhook-Filtergruppe, die nur dann einen Build auslöst, wenn eine Änderung von einem angegebenen GitHub Benutzer mit einer Konto-ID vorgenommen wird, die dem regulären Ausdruck entspricht.\]](http://docs.aws.amazon.com/de_de/codebuild/latest/userguide/images/pull-request-webhook-filter-actor.png)


In diesem Beispiel löst eine Webhook-Filtergruppe einen Build für ein Push-Ereignis aus, wenn die Head-Commit-Nachricht mit dem regulären Ausdruck `\[CodeBuild\]` übereinstimmt. 

![\[Eine Webhook-Filtergruppe, die einen Build für ein Push-Ereignis auslöst, wenn die Head-Commit-Nachricht mit dem regulären Ausdruck übereinstimmt.\]](http://docs.aws.amazon.com/de_de/codebuild/latest/userguide/images/pull-request-webhook-filter-commit-message.png)


In diesem Beispiel löst eine Webhook-Filtergruppe einen Build nur für GitHub Aktions-Workflow-Auftragsereignisse aus.

**Anmerkung**  
CodeBuild verarbeitet GitHub Aktions-Workflow-Jobs nur, wenn ein Webhook Filtergruppen enthält, die den **WORKFLOW\$1JOB\$1QUEUED-Ereignisfilter** enthalten.

![\[Eine Webhook-Filtergruppe löst einen Build nur für Aktions-Workflow-Auftragsereignisse aus. GitHub\]](http://docs.aws.amazon.com/de_de/codebuild/latest/userguide/images/github-actions-workflow-job-queued-no-highlight.png)


In diesem Beispiel löst eine Webhook-Filtergruppe einen Build für einen Workflow-Namen aus, der dem regulären Ausdruck entspricht. `CI-CodeBuild` 

![\[Eine Webhook-Filtergruppe löst einen Build für einen Workflow-Namen aus, der dem regulären Ausdruck entspricht.\]](http://docs.aws.amazon.com/de_de/codebuild/latest/userguide/images/github-actions-workflow-job-specific.png)


# GitHub Webhook-Ereignisse filtern (SDK)
<a name="github-webhook-events-sdk"></a>

Um das AWS CodeBuild SDK zum Filtern von Webhook-Ereignissen zu verwenden, verwenden Sie das `filterGroups` Feld in der Anforderungssyntax der `CreateWebhook` `UpdateWebhook` API-Methoden oder. Weitere Informationen finden Sie unter [WebhookFilter](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_WebhookFilter.html) in der *CodeBuild -API-Referenz*. 

Weitere Informationen zu GitHub Webhook-Ereignissen finden Sie unter. [GitHub Webhook-Ereignisse](github-webhook.md)

 Um einen Webhook-Filter zu erstellen, der nur für Pull-Anfragen einen Build auslöst, fügen Sie Folgendes in die Anfragesyntax ein: 

```
"filterGroups": [
   [
        {
            "type": "EVENT", 
            "pattern": "PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED, PULL_REQUEST_REOPENED, PULL_REQUEST_MERGED, PULL_REQUEST_CLOSED"
        }
    ]
]
```

 Um einen Webhook-Filter zu erstellen, der nur für die angegebenen Verzweigungen einen Build auslöst, verwenden Sie den Parameter `pattern`, um einen regulären Ausdruck zum Filtern von Verzweigungsnamen anzugeben. Bei Verwendung eines Beispiels mit zwei Filtergruppen wird ein Build ausgelöst, wenn mindestens eine Gruppe als wahr ausgewertet wird:
+ Die erste Filtergruppe gibt Pull-Anfragen an, die in Verzweigungen mit Git-Referenznamen, die dem regulären Ausdruck `^refs/heads/main$` entsprechen, und mit Kopfreferenzen, die `^refs/heads/myBranch$` entsprechen, erstellt, aktualisiert oder erneut geöffnet werden. 
+ Die zweite Filtergruppe gibt Push-Anfragen in Verzweigungen mit Git-Referenznamen an, die dem regulären Ausdruck `^refs/heads/myBranch$` entsprechen. 

```
"filterGroups": [
    [
        {
            "type": "EVENT", 
            "pattern": "PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED, PULL_REQUEST_REOPENED"
        },
        {
            "type": "HEAD_REF", 
            "pattern": "^refs/heads/myBranch$"
        },
        {
            "type": "BASE_REF", 
            "pattern": "^refs/heads/main$"
        }
    ],
    [
        {
            "type": "EVENT", 
            "pattern": "PUSH"
        },
        {
            "type": "HEAD_REF", 
            "pattern": "^refs/heads/myBranch$"
        }
    ]
]
```

 Sie können den Parameter `excludeMatchedPattern` verwenden, um anzugeben, welche Ereignisse keinen Build auslösen. In diesem Beispiel etwa wird für alle Anfragen mit Ausnahme von Tag-Ereignissen ein Build ausgelöst. 

```
"filterGroups": [
    [
        {
            "type": "EVENT", 
            "pattern": "PUSH, PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED, PULL_REQUEST_REOPENED, PULL_REQUEST_MERGED, PULL_REQUEST_CLOSED"
        },
        {
            "type": "HEAD_REF", 
            "pattern": "^refs/tags/.*", 
            "excludeMatchedPattern": true
        }
    ]
]
```

Sie können einen Filter erstellen, der nur einen Build auslöst, wenn Dateien geändert werden, deren Namen dem regulären Ausdruck in dem Argument `pattern` entsprechen. In diesem Beispiel gibt die Filtergruppe an, dass nur ein Build ausgelöst wird, wenn Dateien geändert werden, deren Name dem regulären Ausdruck `^buildspec.*` entspricht. 

```
"filterGroups": [
    [
        {
            "type": "EVENT", 
            "pattern": "PUSH"
        },
        {
            "type": "FILE_PATH", 
            "pattern": "^buildspec.*"
        }
    ]
]
```

In diesem Beispiel gibt die Filtergruppe an, dass ein Build nur ausgelöst wird, wenn Dateien in `test` Ordnern `src` oder geändert werden.

```
"filterGroups": [
    [
        {
            "type": "EVENT", 
            "pattern": "PUSH"
        },
        {
            "type": "FILE_PATH", 
            "pattern": "^src/.+|^test/.+"
        }
    ]
]
```

Sie können einen Filter erstellen, der einen Build nur auslöst, wenn eine Änderung von einem bestimmten Benutzer GitHub oder einem GitHub Enterprise Server-Benutzer mit Konto-ID vorgenommen wird`actor-account-id`. 

**Anmerkung**  
 Informationen darüber, wie Sie Ihre GitHub Konto-ID finden https://api.github.com/users/*user-name*, finden Sie unter Wo *user-name* ist Ihr GitHub Benutzername. 

```
"filterGroups": [
    [
        {
            "type": "EVENT", 
            "pattern": "PUSH, PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED, PULL_REQUEST_REOPENED, PULL_REQUEST_MERGED, PULL_REQUEST_CLOSED"
        },
        {
            "type": "ACTOR_ACCOUNT_ID", 
            "pattern": "actor-account-id"
        }
    ]
]
```

Sie können einen Filter erstellen, der einen Build nur dann auslöst, wenn die Head-Commit-Nachricht mit dem regulären Ausdruck im Musterargument übereinstimmt. In diesem Beispiel gibt die Filtergruppe an, dass ein Build nur dann ausgelöst wird, wenn die Head-Commit-Nachricht des Push-Ereignisses mit dem regulären Ausdruck `\[CodeBuild\]` übereinstimmt. 

```
"filterGroups": [
    [
        {
            "type": "EVENT",
            "pattern": "PUSH"
        },
        {
            "type": "COMMIT_MESSAGE",
            "pattern": "\[CodeBuild\]"
        }
    ]
]
```

Um einen Webhook-Filter zu erstellen, der einen Build nur für Workflow-Jobs für GitHub Aktionen auslöst, fügen Sie Folgendes in die Anforderungssyntax ein:

```
"filterGroups": [
   [
        {
            "type": "EVENT", 
            "pattern": "WORKFLOW_JOB_QUEUED"
        }
    ]
]
```

# GitHub Webhook-Ereignisse filtern ()CloudFormation
<a name="github-webhook-events-cfn"></a>

 Um eine CloudFormation Vorlage zum Filtern von Webhook-Ereignissen zu verwenden, verwenden Sie die Eigenschaft des AWS CodeBuild `FilterGroups` Projekts.

Weitere Informationen zu GitHub Webhook-Ereignissen finden Sie unter. [GitHub Webhook-Ereignisse](github-webhook.md)

Mit dem folgenden in YAML formatierten Teil einer CloudFormation -Vorlage werden zwei Filtergruppen erstellt. Diese lösen zusammen einen Build aus, wenn mindestens eine Gruppe als wahr ausgewertet wird. 
+  Die erste Filtergruppe gibt an, dass Pull-Requests für Branches mit Git-Referenznamen, die dem regulären Ausdruck entsprechen, `^refs/heads/main$` von einem GitHub Benutzer, der keine Konto-ID hat, erstellt oder aktualisiert `12345` werden. 
+  Die zweite Filtergruppe gibt an, dass Push-Anfragen für Dateien, deren Namen dem regulären Ausdruck `READ_ME` entsprechen, in Verzweigungen mit Git-Referenznamen, die dem regulären Ausdruck `^refs/heads/.*` entsprechen, erstellt werden. 
+ Die dritte Filtergruppe gibt eine Push-Anforderung mit einer Head Commit-Nachricht an, die dem regulären Ausdruck `\[CodeBuild\]` entspricht.
+ Die vierte Filtergruppe spezifiziert eine Workflow-Auftragsanforderung für GitHub Aktionen mit einem Workflow-Namen, der dem regulären Ausdruck entspricht`\[CI-CodeBuild\]`.

```
CodeBuildProject:
  Type: AWS::CodeBuild::Project
  Properties:
    Name: MyProject
    ServiceRole: service-role
    Artifacts:
      Type: NO_ARTIFACTS
    Environment:
      Type: LINUX_CONTAINER
      ComputeType: BUILD_GENERAL1_SMALL
      Image: aws/codebuild/standard:5.0
    Source:
      Type: GITHUB
      Location: source-location
    Triggers:
      Webhook: true
      FilterGroups:
        - - Type: EVENT
            Pattern: PULL_REQUEST_CREATED,PULL_REQUEST_UPDATED
          - Type: BASE_REF
            Pattern: ^refs/heads/main$
            ExcludeMatchedPattern: false
          - Type: ACTOR_ACCOUNT_ID
            Pattern: 12345
            ExcludeMatchedPattern: true
        - - Type: EVENT
            Pattern: PUSH
          - Type: HEAD_REF
            Pattern: ^refs/heads/.*
          - Type: FILE_PATH
            Pattern: READ_ME
            ExcludeMatchedPattern: true
        - - Type: EVENT
            Pattern: PUSH
          - Type: COMMIT_MESSAGE
            Pattern: \[CodeBuild\]
          - Type: FILE_PATH
            Pattern: ^src/.+|^test/.+
        - - Type: EVENT
            Pattern: WORKFLOW_JOB_QUEUED
          - Type: WORKFLOW_NAME
            Pattern: \[CI-CodeBuild\]
```