

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

# Exibir pull requests em um AWS CodeCommit repositório
<a name="how-to-view-pull-request"></a>

Você pode usar o AWS CodeCommit console ou o AWS CLI para visualizar pull requests para seu repositório. Por padrão, você vê somente solicitações de extração em aberto, mas pode alterar o filtro para exibir todas as solicitações de extração, somente as solicitações fechadas, somente as solicitações de extração que você criou e mais. 

**Topics**
+ [Visualização de solicitações pull (console)](#how-to-view-pull-request-console)
+ [Visualizar solicitações pull (AWS CLI)](#how-to-view-pull-request-cli)

## Visualização de solicitações pull (console)
<a name="how-to-view-pull-request-console"></a>

Você pode usar o AWS CodeCommit console para ver uma lista de pull requests em um CodeCommit repositório. Ao alterar o filtro, você pode alterar a exibição em lista para mostrar apenas um determinado conjunto de solicitações de extração. Por exemplo, você pode exibir uma lista de solicitações de extração que você criou com status de **Open** ou pode escolher um filtro diferente e exibir solicitações de extração que você criou com status de **Closed**.

1. Abra o CodeCommit console 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 visualizar solicitações de extração. 

1. No painel de navegação, escolha **Pull Requests**.

1. Por padrão, é exibida uma lista de todas as solicitações de extração abertas.   
![\[Solicitações pull exibidas no AWS CodeCommit console.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-pull-request-view-list.png)

1. Para alterar o filtro de exibição, escolha na lista de filtros disponíveis:
   + **All open requests (Todas as solicitações em aberto)** (padrão): exibe todas as solicitações de extração com status de **Open (Em aberto)**.
   + **All pull requests (Todas as solicitações de extração)**: exibe todas as solicitações de extração.
   + **All closed requests (Todas as solicitações fechadas)**: exibe todas as solicitações de extração com status de **Closed (Fechadas)**.
   + **My pull requests (Minhas solicitações de extração)**: exibe todas as solicitações de extração que você criou, independentemente do status. Ela não mostra revisões nas quais você comentou ou das quais participou.
   + **My open requests (Minhas solicitações em aberto)**: exibe todas as solicitações de extração que você criou cujo status é **Open (Aberto)**.
   + **My closed requests (Minhas solicitações fechadas)**: exibe todas as solicitações de extração que você criou cujo status é **Closed (Fechado)**.

1. Quando você encontrar uma solicitação pull na lista exibida que gostaria de exibir, escolha-a.

## Visualizar solicitações pull (AWS CLI)
<a name="how-to-view-pull-request-cli"></a>

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

Siga estas etapas para usar o AWS CLI para visualizar pull requests em um CodeCommit repositório.

1. Para visualizar uma lista de solicitações de extração em um repositório, execute o comando **list-pull-requests** especificando:
   + O nome do CodeCommit repositório em que você deseja visualizar pull requests (com a **--repository-name** opção).
   + (Opcional) O status da solicitação pull (com a opção **--pull-request-status**).
   + (Opcional) O nome do recurso da Amazon (ARN) do usuário do IAM que criou a solicitação pull (com a opção **--author-arn**).
   + (Opcional) Um token de enumeração que pode ser usado para retornar lotes de resultados (com a opção **--next-token**) 
   + (Opcional) Um limite no número de resultados retornados por solicitação (com a opção **--max-results**).

   Por exemplo, para listar pull requests criadas por um usuário do IAM com o ARN *arn:aws:iam::111111111111:user/Li\$1Juan* e o status de *CLOSED* em um CodeCommit repositório chamado: `MyDemoRepo`

   ```
   aws codecommit list-pull-requests --author-arn arn:aws:iam::111111111111:user/Li_Juan --pull-request-status CLOSED --repository-name MyDemoRepo 
   ```

   Se houver êxito, o comando gerará uma saída semelhante à seguinte:

   ```
   {
      "nextToken": "",
      "pullRequestIds": ["2","12","16","22","23","35","30","39","47"]
   }
   ```

    IDs As solicitações pull são exibidas na ordem da atividade mais recente.

1. Para visualizar detalhes de uma solicitação pull específica, execute o comando **get-pull-request** com a opção **--pull-request-id** especificando o ID da solicitação pull. Por exemplo, para visualizar informações sobre uma pull request com o ID de*27*:

   ```
   aws codecommit get-pull-request --pull-request-id 27
   ```

   Se houver êxito, o comando gerará uma saída semelhante à seguinte:

   ```
   {
       "pullRequest": {
           "approvalRules": [
               {
                   "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
                   "approvalRuleId": "dd8b17fe-EXAMPLE",
                   "approvalRuleName": "2-approver-rule-for-main",
                   "creationDate": 1571356106.936,
                   "lastModifiedDate": 571356106.936,
                   "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major",
                   "ruleContentSha256": "4711b576EXAMPLE"
               }
           ],
           "lastActivityDate": 1562619583.565,
           "pullRequestTargets": [
               {
                   "sourceCommit": "ca45e279EXAMPLE",
                   "sourceReference": "refs/heads/bugfix-1234",
                   "mergeBase": "a99f5ddbEXAMPLE",
                   "destinationReference": "refs/heads/main",
                   "mergeMetadata": {
                       "isMerged": false
                   },
                   "destinationCommit": "2abfc6beEXAMPLE",
                   "repositoryName": "MyDemoRepo"
               }
           ],
           "revisionId": "e47def21EXAMPLE",
           "title": "Quick fix for bug 1234",
           "authorArn": "arn:aws:iam::123456789012:user/Nikhil_Jayashankar",
           "clientRequestToken": "d8d7612e-EXAMPLE",
           "creationDate": 1562619583.565,
           "pullRequestId": "27",
           "pullRequestStatus": "OPEN"
       }
   }
   ```

1. <a name="get-pull-request-approval-state"></a>Para visualizar aprovações em uma solicitação pull, execute o comando **get-pull-request-approval-state**, especificando:
   + O ID da solicitação pull (usando a opção **--pull-request-id**).
   + O ID de revisão da solicitação pull (usando a **--revision-id option)**. É possível obter o ID de revisão atual para uma solicitação pull usando o comando [get-pull-request](#get-pull-request).

   Por exemplo, para ver as aprovações em uma pull request com um ID de *8* e um ID de revisão de*9f29d167EXAMPLE*:

   ```
   aws codecommit get-pull-request-approval-state --pull-request-id 8 --revision-id 9f29d167EXAMPLE
   ```

   Se houver êxito, o comando gerará uma saída semelhante à seguinte:

   ```
   {
       "approvals": [
           {
               "userArn": "arn:aws:iam::123456789012:user/Mary_Major",
               "approvalState": "APPROVE"
           }
       ]
   }
   ```

1. Para visualizar eventos de uma solicitação pull específica, execute o comando **describe-pull-request-events** com a opção **--pull-request-id** especificando o ID da solicitação pull. Por exemplo, para visualizar os eventos de uma pull request com o ID de*8*:

   ```
   aws codecommit describe-pull-request-events --pull-request-id 8
   ```

   Se houver êxito, o comando gerará uma saída semelhante à seguinte:

   ```
   {
       "pullRequestEvents": [
           {
               "pullRequestId": "8",
               "pullRequestEventType": "PULL_REQUEST_CREATED",
               "eventDate": 1510341779.53,
               "actor": "arn:aws:iam::111111111111:user/Zhang_Wei"
           },
           {
               "pullRequestStatusChangedEventMetadata": {
                   "pullRequestStatus": "CLOSED"
               },
               "pullRequestId": "8",
               "pullRequestEventType": "PULL_REQUEST_STATUS_CHANGED",
               "eventDate": 1510341930.72,
               "actor": "arn:aws:iam::111111111111:user/Jane_Doe"
           }
       ]
   }
   ```

1. Para visualizar se há conflitos de mesclagem para uma solicitação pull, execute o comando **get-merge-conflicts** especificando:
   + O nome do CodeCommit repositório (com a **--repository-name** opção).
   + A ramificação, tag, HEAD ou outra referência totalmente qualificada para a origem das alterações a serem usadas na avaliação da mesclagem (com a opção **--source-commit-specifier**).
   + A ramificação, tag, HEAD ou outra referência totalmente qualificada para o destino das alterações a serem usadas na avaliação da mesclagem (com a opção **--destination-commit-specifier**).
   + A opção de mesclagem a ser usada (com a opção **--merge-option**) 

   Por exemplo, para ver se há algum conflito de mesclagem entre a ponta de uma ramificação de origem chamada *my-feature-branch* e uma ramificação de destino nomeada *main* em um repositório chamado: `MyDemoRepo`

   ```
   aws codecommit get-merge-conflicts --repository-name MyDemoRepo --source-commit-specifier my-feature-branch --destination-commit-specifier main --merge-option FAST_FORWARD_MERGE
   ```

   Se houver êxito, o comando gerará uma saída semelhante à seguinte:

   ```
   {
       "destinationCommitId": "fac04518EXAMPLE",
       "mergeable": false,
       "sourceCommitId": "16d097f03EXAMPLE"
   }
   ```