As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# GitHub eventos de webhook
<a name="github-webhook"></a>

Você pode usar grupos de filtros de webhook para especificar quais eventos de GitHub webhook acionam uma compilação. Por exemplo, é possível especificar que uma compilação seja acionada somente para alterações em ramificações especificadas. 

Você pode criar um ou mais grupos de filtros de webhook para especificar quais eventos de webhook acionam uma compilação. Uma compilação será acionada se algum grupo de filtros for avaliado como verdadeiro, o que ocorre quando todos os filtros no grupo são avaliados como verdadeiros. Ao criar um grupo de filtros, é necessário especificar: 

**Um evento**  
Para GitHub, você pode escolher um ou mais dos seguintes eventos: `PUSH``PULL_REQUEST_CREATED`,`PULL_REQUEST_UPDATED`,`PULL_REQUEST_REOPENED`,`PULL_REQUEST_MERGED`, `PULL_REQUEST_CLOSED``RELEASED`,`PRERELEASED`,, `WORKFLOW_JOB_QUEUED` e. O tipo de evento webhook está no cabeçalho `X-GitHub-Event` na carga webhook. No cabeçalho `X-GitHub-Event`, você pode ver `pull_request` ou `push`. Para obter uma solicitação pull, o tipo de evento está no campo `action` da carga do evento webhook. A tabela a seguir mostra como valores de cabeçalho `X-GitHub-Event` e os valores do campo `action` da carga da solicitação pull webhook são mapeados para os tipos de eventos disponíveis.      
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/github-webhook.html)
 O tipo de `PULL_REQUEST_REOPENED` evento pode ser usado somente com GitHub um GitHub Enterprise Server. O tipo de `PRERELEASED` evento `RELEASED` e GitHub só pode ser usado com. Para obter mais informações sobre `WORKFLOW_JOB_QUEUED`, consulte [Tutorial: Configurar um CodeBuild executor de GitHub ações hospedado](action-runner.md). 

**Um ou mais filtros opcionais**  
Use uma expressão regular para especificar um filtro. Para um evento acionar uma compilação, cada filtro do grupo associado a ele deve ser avaliado como verdadeiro.    
`ACTOR_ACCOUNT_ID` (`ACTOR_ID` no console)  
Um evento de webhook aciona uma compilação quando uma ID de conta GitHub ou do GitHub Enterprise Server corresponde ao padrão de expressão regular. Esse valor é encontrado na propriedade `id` do objeto `sender` na carga webhook.  
`HEAD_REF`  
Um evento de webhook aciona uma compilação quando a referência head corresponde ao padrão da expressão regular (por exemplo, `refs/heads/branch-name` ou `refs/tags/tag-name`). Para um evento push, o nome de referência é encontrado na propriedade `ref` da carga webhook. Para eventos de solicitações pull, o nome da ramificação é encontrado na propriedade `ref` do objeto `head` na carga webhook.   
`BASE_REF`  
Um evento de webhook aciona uma compilação quando a referência base corresponde ao padrão da expressão regular (por exemplo, `refs/heads/branch-name`). Um filtro `BASE_REF` pode ser usado apenas com eventos de solicitação pull. O nome da ramificação é encontrado na propriedade `ref` do objeto `base` na carga webhook.  
`FILE_PATH`  
Um evento de webhook aciona uma compilação quando o caminho de um arquivo alterado corresponde ao padrão das expressões regulares. Um `FILE_PATH` filtro pode ser usado com eventos GitHub push e pull request e eventos push do GitHub Enterprise Server. Ele não pode ser usado com eventos de pull request do GitHub Enterprise Server.   
`COMMIT_MESSAGE`  
Um webhook aciona uma compilação quando a mensagem de confirmação head corresponde à expressão padrão. Um `COMMIT_MESSAGE` filtro pode ser usado com eventos GitHub push e pull request e eventos push do GitHub Enterprise Server. Ele não pode ser usado com eventos de pull request do GitHub Enterprise Server.  
`TAG_NAME`  
Um webhook aciona uma compilação quando o nome da tag da versão corresponde ao padrão de expressão regular. Um `TAG_NAME` filtro pode ser usado com eventos de GitHub solicitação lançados e pré-lançados.  
`RELEASE_NAME`  
Um webhook aciona uma compilação quando o nome da versão corresponde ao padrão da expressão regular. Um `RELEASE_NAME` filtro pode ser usado com eventos de GitHub solicitação lançados e pré-lançados.  
`REPOSITORY_NAME`  
Um webhook aciona uma compilação quando o nome do repositório corresponde ao padrão da expressão regular. Um `REPOSITORY_NAME` filtro só pode ser usado com GitHub webhooks globais ou organizacionais.  
`ORGANIZATION_NAME`  
Um webhook aciona uma compilação quando o nome da organização corresponde ao padrão da expressão regular. Um `ORGANIZATION_NAME` filtro só pode ser usado com GitHub webhooks globais.  
`WORKFLOW_NAME`  
Um webhook aciona uma compilação quando o nome do fluxo de trabalho corresponde ao padrão da expressão regular. Um `WORKFLOW_NAME` filtro pode ser usado com eventos de solicitação em fila de tarefas do fluxo de trabalho do GitHub Actions.

**nota**  
Você pode encontrar a carga útil do webhook nas configurações do webhook do seu repositório. GitHub 

**Topics**
+ [Filtrar eventos de GitHub webhook (console)](github-webhook-events-console.md)
+ [Filtrar eventos de GitHub webhook (SDK)](github-webhook-events-sdk.md)
+ [Filtrar eventos de GitHub webhook ()CloudFormation](github-webhook-events-cfn.md)