Class CfnProject.WebhookFilterProperty.Builder
- All Implemented Interfaces:
software.amazon.jsii.Builder<CfnProject.WebhookFilterProperty>
- Enclosing interface:
CfnProject.WebhookFilterProperty
CfnProject.WebhookFilterProperty
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionbuild()
Builds the configured instance.excludeMatchedPattern
(Boolean excludeMatchedPattern) Sets the value ofCfnProject.WebhookFilterProperty.getExcludeMatchedPattern()
excludeMatchedPattern
(IResolvable excludeMatchedPattern) Sets the value ofCfnProject.WebhookFilterProperty.getExcludeMatchedPattern()
Sets the value ofCfnProject.WebhookFilterProperty.getPattern()
Sets the value ofCfnProject.WebhookFilterProperty.getType()
-
Constructor Details
-
Builder
public Builder()
-
-
Method Details
-
pattern
Sets the value ofCfnProject.WebhookFilterProperty.getPattern()
- Parameters:
pattern
- For aWebHookFilter
that usesEVENT
type, a comma-separated string that specifies one or more events. This parameter is required. For example, the webhook filterPUSH, 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, aWebHookFilter
that usesHEAD_REF
for itstype
and the pattern^refs/heads/
triggers a build when the head reference is a branch with a reference namerefs/heads/branch-name
.- Returns:
this
-
type
Sets the value ofCfnProject.WebhookFilterProperty.getType()
- Parameters:
type
- The type of webhook filter. This parameter is required. There are nine webhook filter types:EVENT
,ACTOR_ACCOUNT_ID
,HEAD_REF
,BASE_REF
,FILE_PATH
,COMMIT_MESSAGE
,TAG_NAME
,RELEASE_NAME
, andWORKFLOW_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
, andWORKFLOW_JOB_QUEUED
. TheEVENT
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
andWORKFLOW_JOB_QUEUED
work with GitHub and GitHub Enterprise only. TypesRELEASED
andPRERELEASED
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
andrefs/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 GitHub and Bitbucket events push and pull requests events. Also works with GitHub Enterprise push events, but does not work with GitHub Enterprise pull request events.
- COMMIT_MESSAGE
- A webhook triggers a build when the head commit message matches the regular expression
pattern
.
Works with GitHub and Bitbucket events push and pull requests events. Also works with GitHub Enterprise push events, but does not work with GitHub Enterprise pull request events.
- TAG_NAME
- A webhook triggers a build when the tag name of the release matches the regular expression
pattern
.
Works with
RELEASED
andPRERELEASED
events only.- RELEASE_NAME
- A webhook triggers a build when the release name matches the regular expression
pattern
.
Works with
RELEASED
andPRERELEASED
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.
- WORKFLOW_NAME
- A webhook triggers a build when the workflow name matches the regular expression
pattern
.
Works with
WORKFLOW_JOB_QUEUED
events only.- Returns:
this
-
excludeMatchedPattern
@Stability(Stable) public CfnProject.WebhookFilterProperty.Builder excludeMatchedPattern(Boolean excludeMatchedPattern) Sets the value ofCfnProject.WebhookFilterProperty.getExcludeMatchedPattern()
- Parameters:
excludeMatchedPattern
- Used to indicate that thepattern
determines which webhook events do not trigger a build. If true, then a webhook event that does not match thepattern
triggers a build. If false, then a webhook event that matches thepattern
triggers a build.- Returns:
this
-
excludeMatchedPattern
@Stability(Stable) public CfnProject.WebhookFilterProperty.Builder excludeMatchedPattern(IResolvable excludeMatchedPattern) Sets the value ofCfnProject.WebhookFilterProperty.getExcludeMatchedPattern()
- Parameters:
excludeMatchedPattern
- Used to indicate that thepattern
determines which webhook events do not trigger a build. If true, then a webhook event that does not match thepattern
triggers a build. If false, then a webhook event that matches thepattern
triggers a build.- Returns:
this
-
build
Builds the configured instance.- Specified by:
build
in interfacesoftware.amazon.jsii.Builder<CfnProject.WebhookFilterProperty>
- Returns:
- a new instance of
CfnProject.WebhookFilterProperty
- Throws:
NullPointerException
- if any required attribute was not provided
-