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á.

# GitLab eventos de webhook
<a name="gitlab-webhook"></a>

Você pode usar grupos de filtros de webhook para especificar quais eventos de GitLab 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 GitLab, você pode escolher um ou mais dos seguintes eventos: `PUSH``PULL_REQUEST_CREATED`,`PULL_REQUEST_UPDATED`,`PULL_REQUEST_MERGED`, `PULL_REQUEST_REOPENED``PULL_REQUEST_CLOSED`,`RELEASED`,, `WORKFLOW_JOB_QUEUED` e.  
O tipo de evento do webhook está em seu cabeçalho no campos `X-GitLab-Event`. A tabela a seguir mostra como valores de cabeçalho `X-GitLab-Event` são mapeados para os tipos de eventos. Para o evento de webhook `Merge Request Hook`, a `object_atttributes.action` da carga útil conterá informações adicionais sobre o tipo de solicitação de mesclagem.      
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/gitlab-webhook.html)
Para `PULL_REQUEST_MERGED`, se uma solicitação pull for mesclada com a estratégia squash e a ramificação da solicitação pull for fechada, a confirmação original da solicitação pull deixará de existir. Nesse caso, a variável de ambiente `CODEBUILD_WEBHOOK_MERGE_COMMIT` contém o identificador da confirmação de mesclagem comprimida.

**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 o ID da GitLab conta corresponde ao padrão de expressão regular. Esse valor é exibido na propriedade `account_id` do objeto `actor` na carga de filtro 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` e `refs/tags/tag-name`). Um filtro `HEAD_REF` avalia o nome de referência do Git para a ramificação ou tag. O nome de ramificação ou de tag é exibido no campo `name` do objeto `new` no objeto `push` da carga webhook. Para eventos de solicitação pull, o nome da ramificação é exibido no campo `name` no objeto `branch` do objeto `source` 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. Um filtro `BASE_REF` funciona apenas com eventos de solicitação pull (por exemplo, `refs/heads/branch-name`). Um filtro `BASE_REF` avalia o nome de referência do Git para a ramificação. O nome da ramificação é exibido no campo `name` do objeto `branch` no objeto `destination` na carga webhook.  
`FILE_PATH`  
Um evento de webhook aciona uma compilação quando o caminho de um arquivo alterado corresponde ao padrão da expressão regular.  
`COMMIT_MESSAGE`  
Um webhook aciona uma compilação quando a mensagem de confirmação head corresponde à expressão padrão.  
`WORKFLOW_NAME`  
Um webhook aciona uma compilação quando o nome do fluxo de trabalho corresponde ao padrão da expressão regular.

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

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