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

# Criar uma solicitação pull
<a name="how-to-create-pull-request"></a>

A criação de solicitações pull ajuda outros usuários a ver e revisar suas alterações de código antes de mesclá-las em outra ramificação. Primeiro, você cria uma ramificação para suas alterações de código. Ela é chamada de ramificação de origem para uma solicitação pull. Depois de confirmar e enviar alterações para o repositório, você pode criar uma solicitação pull que compara o conteúdo dessa ramificação (a ramificação de origem) com a ramificação em que deseja mesclar suas alterações após a solicitação pull ser fechada (a ramificação de destino). 

Você pode usar o console do AWS CodeCommit ou o AWS CLI para criar solicitações de extração para o repositório. 

**Topics**
+ [Criar uma solicitação pull (console)](#how-to-create-pull-request-console)
+ [Criar uma solicitação pull (AWS CLI)](#how-to-create-pull-request-cli)

## Criar uma solicitação pull (console)
<a name="how-to-create-pull-request-console"></a>

Você pode usar o console do CodeCommit para criar uma solicitação pull em um repositório do CodeCommit. Se o seu repositório estiver [configurado com notificações](how-to-repository-email.md), os usuários inscritos receberão um e-mail quando você criar uma solicitação pull.

1. Abra o console do CodeCommit em [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).

1. Em **Repositories (Repositórios)**, escolha o nome do repositório onde você deseja criar uma solicitação pull. 

1. No painel de navegação, escolha **Pull Requests**.
**dica**  
Você também pode criar solicitações pull em **Branches (Ramificações)** e em **Code (Código)**.

1. Escolha **Create pull request**.   
![\[Criar uma solicitação pull na página Solicitações pull no console do CodeCommit.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-pull-request-view.png)

1. Em **Create pull request**, em **Source**, escolha a ramificação que contém as alterações que deseja revisar. 

1. Em **Destination (Destino)**, escolha a ramificação na qual você pretende mesclar suas alterações de código quando a solicitação pull for fechada. 

1. Escolha **Compare**. Uma comparação é executada nas duas ramificações, e as diferenças entre elas são exibidas. Uma análise também é realizada para determinar se as duas ramificações podem ser mescladas automaticamente quando a solicitação pull é fechada.

1. Analise os detalhes da comparação e as alterações para se certificar de que a solicitação pull contém as alterações e confirmações que você deseja analisar. Caso contrário, ajuste suas escolhas para as ramificações de origem e de destino e escolha **Compare** novamente.

1. Quando estiver satisfeito com os resultados da comparação para a solicitação pull, em **Title (Título)**, forneça um título curto, mas descritivo, para essa revisão. Este é o título que aparece na lista de solicitações pull para o repositório. 

1. (Opcional) Em **Description (Descrição)**, insira os detalhes sobre essa análise e qualquer outra informação útil para os revisores.

1. Escolha **Criar**.  
![\[Criar uma solicitação pull\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-pull-request-create.png)

Sua solicitação pull aparece na lista de solicitações pull para o repositório. Se você [configurou notificações](how-to-repository-email.md), os assinantes do tópico do Amazon SNS receberão um e-mail informando sobre a solicitação pull recém-criada.

## Criar uma solicitação pull (AWS CLI)
<a name="how-to-create-pull-request-cli"></a>

Para usar comandos da AWS CLI com o CodeCommit, instale a AWS CLI. Para obter mais informações, consulte [Referência da linha de comando](cmd-ref.md). 

**Para usar a AWS CLI para criar solicitações pull em um repositório do CodeCommit**
+ Execute o comando **create-pull-request**, especificando:
  + O nome da solicitação pull (com a opção **--title**).
  + A descrição da solicitação pull (com a opção **--description**).
  + Uma lista de destinos para o comando **create-pull-request**, incluindo:
    + O nome do repositório do CodeCommit em que a solicitação pull foi criada (com o atributo **repositoryName**).
    + O nome da ramificação que contém as alterações de código que você deseja analisar, também conhecida como ramificação de origem (com o atributo **sourceReference**).
    + Opcionalmente, o nome da ramificação na qual você pretende mesclar suas alterações de código, também conhecida como a ramificação de destino, se você não quiser mesclar a ramificação padrão (com o atributo **destinationReference**).
  + Um token de idempotência exclusivo gerado pelo cliente (com a opção **--client-request-token**). 

  Este exemplo cria uma solicitação pull chamada *Pronunciation difficulty analyzer (Analisador de dificuldade de pronúncia)* com uma descrição *Please review these changes by Tuesday (Revise essas alterações até terça-feira)* que tem como destino a ramificação de origem *jane-branch*. A solicitação pull deve ser mesclada com a ramificação padrão *principal* em um repositório do CodeCommit chamado `MyDemoRepo`:

  ```
  aws codecommit create-pull-request --title "Pronunciation difficulty analyzer" --description "Please review these changes by Tuesday" --client-request-token 123Example --targets repositoryName=MyDemoRepo,sourceReference=jane-branch 
  ```