# WebhookFilterProperty

`WebhookFilter` is a structure of the `FilterGroups` property on the [AWS CodeBuild Project ProjectTriggers](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codebuild-project-projecttriggers.html) property type that specifies which webhooks trigger an AWS CodeBuild build.

> The Webhook feature isn't available in AWS CloudFormation for GitHub Enterprise projects. Use the AWS CLI or AWS CodeBuild console to create the webhook.

- Source: Generated at build time
- Type last changed: v2.93.0 · 23 Aug 2023

## Example

TypeScript:

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_codebuild as codebuild } from 'aws-cdk-lib';
const webhookFilterProperty: codebuild.CfnProject.WebhookFilterProperty = {
  pattern: 'pattern',
  type: 'type',

  // the properties below are optional
  excludeMatchedPattern: false,
};
```

Python:

```python
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_codebuild as codebuild

webhook_filter_property = codebuild.CfnProject.WebhookFilterProperty(
    pattern="pattern",
    type="type",

    # the properties below are optional
    exclude_matched_pattern=False
)
```

Java:

```java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.codebuild.*;

WebhookFilterProperty webhookFilterProperty = WebhookFilterProperty.builder()
        .pattern("pattern")
        .type("type")

        // the properties below are optional
        .excludeMatchedPattern(false)
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.CodeBuild;

var webhookFilterProperty = new WebhookFilterProperty {
    Pattern = "pattern",
    Type = "type",

    // the properties below are optional
    ExcludeMatchedPattern = false
};
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import "github.com/aws/aws-cdk-go/awscdk"

webhookFilterProperty := &WebhookFilterProperty{
	Pattern: jsii.String("pattern"),
	Type: jsii.String("type"),

	// the properties below are optional
	ExcludeMatchedPattern: jsii.Boolean(false),
}
```

## Properties

- `excludeMatchedPattern`: boolean | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) — Used to indicate that the `pattern` determines which webhook events do not trigger a build.

  If true, then a webhook event that does not match the `pattern` triggers a build. If false, then a webhook event that matches the `pattern` triggers a build.

- `pattern`: string (required) — For a `WebHookFilter` that uses `EVENT` type, a comma-separated string that specifies one or more events.

  For example, the webhook filter `PUSH, PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED` allows all push, pull request created, and pull request updated events to trigger a build.

  For a `WebHookFilter` that uses any of the other filter types, a regular expression pattern. For example, a `WebHookFilter` that uses `HEAD_REF` for its `type` and the pattern `^refs/heads/` triggers a build when the head reference is a branch with a reference name `refs/heads/branch-name` .

- `type`: string (required) — The type of webhook filter.

  There are 11 webhook filter types: `EVENT` , `ACTOR_ACCOUNT_ID` , `HEAD_REF` , `BASE_REF` , `FILE_PATH` , `COMMIT_MESSAGE` , `TAG_NAME` , `RELEASE_NAME` , `REPOSITORY_NAME` , `ORGANIZATION_NAME` , and `WORKFLOW_NAME` .

  - EVENT

  - A webhook event triggers a build when the provided `pattern` matches one of nine event types: `PUSH` , `PULL_REQUEST_CREATED` , `PULL_REQUEST_UPDATED` , `PULL_REQUEST_CLOSED` , `PULL_REQUEST_REOPENED` , `PULL_REQUEST_MERGED` , `RELEASED` , `PRERELEASED` , and `WORKFLOW_JOB_QUEUED` . The `EVENT` patterns are specified as a comma-separated string. For example, `PUSH, PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED` filters all push, pull request created, and pull request updated events.

  > Types `PULL_REQUEST_REOPENED` and `WORKFLOW_JOB_QUEUED` work with GitHub and GitHub Enterprise only. Types `RELEASED` and `PRERELEASED` work with GitHub only.
  - ACTOR_ACCOUNT_ID

  - A webhook event triggers a build when a GitHub, GitHub Enterprise, or Bitbucket account ID matches the regular expression `pattern` .
  - HEAD_REF

  - A webhook event triggers a build when the head reference matches the regular expression `pattern` . For example, `refs/heads/branch-name` and `refs/tags/tag-name` .

  > Works with GitHub and GitHub Enterprise push, GitHub and GitHub Enterprise pull request, Bitbucket push, and Bitbucket pull request events.
  - BASE_REF

  - A webhook event triggers a build when the base reference matches the regular expression `pattern` . For example, `refs/heads/branch-name` .

  > Works with pull request events only.
  - FILE_PATH

  - A webhook triggers a build when the path of a changed file matches the regular expression `pattern` .

  > Works with push and pull request events only.
  - COMMIT_MESSAGE

  - A webhook triggers a build when the head commit message matches the regular expression `pattern` .

  > Works with push and pull request events only.
  - TAG_NAME

  - A webhook triggers a build when the tag name of the release matches the regular expression `pattern` .

  > Works with `RELEASED` and `PRERELEASED` events only.
  - RELEASE_NAME

  - A webhook triggers a build when the release name matches the regular expression `pattern` .

  > Works with `RELEASED` and `PRERELEASED` events only.
  - REPOSITORY_NAME

  - A webhook triggers a build when the repository name matches the regular expression `pattern` .

  > Works with GitHub global or organization webhooks only.
  - ORGANIZATION_NAME

  - A webhook triggers a build when the organization name matches the regular expression `pattern` .

  > Works with GitHub global webhooks only.
  - WORKFLOW_NAME

  - A webhook triggers a build when the workflow name matches the regular expression `pattern` .

  > Works with `WORKFLOW_JOB_QUEUED` events only. > For CodeBuild-hosted Buildkite runner builds, WORKFLOW_NAME filters will filter by pipeline name.
