

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

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

Você pode usar o AWS CodeCommit console para revisar as alterações incluídas em uma pull request. Você pode adicionar comentários à solicitação, aos arquivos e a linhas de código individuais. Você também pode responder aos comentários feitos por outros usuários. Se o seu repositório estiver [configurado com notificações](how-to-repository-email.md), você receberá e-mails quando os usuários responderem aos seus comentários ou quando eles comentarem em uma solicitação pull.

Você pode usar o AWS CLI para comentar em uma pull request e responder aos comentários. Para revisar as alterações, você deve usar o CodeCommit console, o **git diff** comando ou uma ferramenta de comparação.

**Topics**
+ [Revisar uma solicitação pull (console)](#how-to-review-pull-request-console)
+ [Revisar solicitações pull (AWS CLI)](#how-to-review-pull-request-cli)

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

Você pode usar o CodeCommit console para revisar uma pull request em um CodeCommit repositório. 

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. 

1. No painel de navegação, escolha **Pull Requests (Solicitações pull)**.

1. Por padrão, é exibida uma lista de todas as solicitações de extração abertas. Escolha a solicitação pull aberta que você deseja analisar.   
![\[Abra as pull requests exibidas no CodeCommit console.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-pull-request-view-list.png)
**nota**  
É possível comentar sobre uma solicitação pull fechada ou mesclada, mas não mesclá-la ou reabri-la.

1. Na solicitação pull, escolha **Changes**.

1. Execute um destes procedimentos:
   + Para adicionar um comentário geral para toda a solicitação pull, em **Comments on changes (Comentários sobre alterações)**, escolha **New comment (Novo comentário)**, insira um comentário e escolha **Save (Salvar)**. Você pode usar [Markdown](https://docs.aws.amazon.com/general/latest/gr/aws-markdown.html) ou inserir seu comentário em texto simples.  
![\[Um comentário geral sobre as alterações em uma solicitação pull.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-commenting-changecomment.png)
   + Para adicionar um comentário a um arquivo na confirmação, em **Changes**, encontre o nome do arquivo. Escolha o ícone de comentário ![\[The comment bubble icon that that indicates that you can leave a comment on that line of code.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-commentbubble.png) que é exibido ao lado do nome do arquivo, insira um comentário e escolha **Save (Salvar)**.   
![\[Adicionar um comentário em um arquivo em uma solicitação pull.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-commenting-addfilecomment.png)
   + Para adicionar um comentário a uma linha alterada na solicitação pull, em **Changes**, vá até a linha na qual deseja comentar. Escolha o ícone de comentário ![\[The comment bubble icon that that indicates that you can leave a comment on that line of code.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-commentbubble.png) que é exibido para essa linha, insira um comentário e escolha **Save (Salvar)**.   
![\[Adicionar um comentário em um linha em uma solicitação pull.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-pull-request-comment.png)

1. Para responder a comentários em uma confirmação, em **Changes** ou **Activity**, escolha **Reply**. Você pode responder com texto e emojis.   
![\[Adicionar respostas e reações de emoji a um comentário.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-commenting-commenttab.png)

   Você pode ver os nomes das pessoas que responderam com uma reação de emoji específica selecionando essa reação. Para ver todas as reações de emojis e informações sobre quem respondeu com quais emojis, escolha **Exibir todas as reações**. Se você respondeu com um emoji a um comentário, sua resposta é mostrada no ícone do botão de reação de emoji.
**nota**  
As contagens de reações exibidas no console são precisas no momento em que a página foi carregada. Para obter as informações mais atuais sobre a contagem de reações de emojis, atualize a página ou selecione **Exibir todas as reações**.  
![\[Visualização de informações sobre usuários que responderam a um comentário com uma reação de emoji.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-comment-view-reaction.png)

1. (Opcional) Para responder a uma recomendação criada pelo Amazon CodeGuru Reviewer, incluindo fornecer feedback sobre a qualidade da recomendação, escolha **Responder**. Use os botões de reação para fornecer informações gerais sobre se você aprova ou não a recomendação. Use o campo de comentário para fornecer mais detalhes sobre sua reação.
**nota**  
O Amazon CodeGuru Reviewer é um serviço automatizado de revisão de código que usa análise de programas e aprendizado de máquina para detectar problemas comuns e recomendar correções em seu código Java ou Python.  
Você só vê os comentários do Amazon CodeGuru Reviewer se tiver associado o repositório ao Amazon CodeGuru Reviewer, se a análise estiver completa e se o código na pull request for código Java ou Python. Para obter mais informações, consulte [Associar ou desassociar um AWS CodeCommit repositório com o Amazon Reviewer CodeGuru](how-to-amazon-codeguru-reviewer.md).
Os comentários do Amazon CodeGuru Reviewer só aparecem na guia **Alterações** se tiverem sido feitos na revisão mais recente do pull request. Eles sempre aparecem na guia **Atividade**.
Embora você possa responder com qualquer uma das reações de emoji disponíveis às recomendações do Amazon CodeGuru Reviewer, somente as reações de emoji de polegar para cima e de polegar para baixo são usadas para avaliar a utilidade da recomendação.   
![\[Uma recomendação criada pelo Amazon CodeGuru Reviewer com um trabalho de revisão em andamento.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-pull-request-reply-bot.png)

1. Para aprovar as alterações feitas em uma solicitação pull, escolha **Approve (Aprovar)**. 
**nota**  
Não é possível aprovar uma solicitação pull que você criou.

   É possível exibir aprovações, regras de aprovação e uma solicitação pull e regras de aprovação criadas por modelos de regra de aprovação em **Approvals (Aprovações)**. Se você decidir que não deseja aprovar a solicitação pull, será possível escolher **Revoke approval (Revogar aprovação)**.
**nota**  
É possível aprovar ou revogar a aprovação somente em uma solicitação pull aberta. Não é possível aprovar ou revogar a aprovação em uma solicitação pull cujo status seja mesclado ou fechado.  
![\[Aprovações e regras de aprovação em uma solicitação pull.\]](http://docs.aws.amazon.com/pt_br/codecommit/latest/userguide/images/codecommit-approval-rule-met.png)

## Revisar solicitações pull (AWS CLI)
<a name="how-to-review-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). 

Você pode revisar as pull requests com os seguintes AWS CLI comandos:
+ [**post-comment-for-pull-request**](#post-comment-reply), para adicionar comentários a uma solicitação pull
+ [**get-comments-for-pull-request**](#get-comments-for-pull-request), para ver os comentários deixados em uma solicitação pull
+ [**update-pull-request-approval-state**](#update-pull-request-approval-state), para aprovar ou revogar a aprovação de uma solicitação pull
+ [**post-comment-reply**](#post-comment-reply), para responder a um comentário em uma solicitação pull

Você também pode usar emojis com comentários em uma solicitação pull com os seguintes comandos: 
+ Para responder a um comentário com um emoji, execute [**put-comment-reaction**](how-to-commit-comment.md#how-to-commit-comment-cli-commit-reply-emoji).
+ Para ver as reações de emoji a um comentário, execute [**get-comment-reactions**](how-to-commit-comment.md#how-to-commit-comment-cli-commit-emoji-view).

**Para usar o AWS CLI para revisar pull requests em um CodeCommit repositório**

1. Para adicionar um comentário a uma solicitação pull em um repositório, execute o comando **post-comment-for-pull-request**, especificando:
   + O ID da solicitação pull (com a opção **--pull-request-id**).
   + O nome do repositório que contém a solicitação pull (com a opção **--repository-name**).
   + O ID de confirmação completo da confirmação na ramificação de destino onde a solicitação de extração é mesclada (com a opção **--before-commit-id**).
   + O ID de confirmação completo da confirmação na ramificação de origem que é a ponta atual da ramificação atual para a solicitação pull quando você publica o comentário (com a opção **--after-commit-id**).
   + Um token de idempotência exclusivo gerado pelo cliente (com a opção **--client-request-token**).
   + O conteúdo do seu comentário (com a opção **--content**).
   + Uma lista de informações de localização sobre onde colocar o comentário, incluindo:
     + O nome do arquivo que está sendo comparado, incluindo sua extensão e subdiretório, se houver (com o atributo **filePath**).
     + O número da linha da alteração em um arquivo comparado (com o atributo **filePosition**).
     + Se o comentário sobre a alteração estiver "antes" ou "depois" na comparação entre as ramificações de origem e destino (com o atributo **relativeFileVersion**).

   Por exemplo, use esse comando para adicionar o comentário *"These don't appear to be used anywhere. Can we remove them?"* sobre a alteração no *ahs\$1count.py* arquivo em uma pull request com o ID de *47* em um repositório chamado*MyDemoRepo*.

   ```
   aws codecommit post-comment-for-pull-request --pull-request-id "47" --repository-name MyDemoRepo --before-commit-id 317f8570EXAMPLE --after-commit-id 5d036259EXAMPLE --client-request-token 123Example --content "These don't appear to be used anywhere. Can we remove them?" --location filePath=ahs_count.py,filePosition=367,relativeFileVersion=AFTER   
   ```

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

   ```
   { 
            "afterBlobId": "1f330709EXAMPLE",
            "afterCommitId": "5d036259EXAMPLE",
            "beforeBlobId": "80906a4cEXAMPLE",
            "beforeCommitId": "317f8570EXAMPLE",
            "comment": {
                  "authorArn": "arn:aws:iam::111111111111:user/Saanvi_Sarkar",
                  "clientRequestToken": "123Example",
                  "commentId": "abcd1234EXAMPLEb5678efgh",
                  "content": "These don't appear to be used anywhere. Can we remove them?",
                  "creationDate": 1508369622.123,
                  "deleted": false,
                  "lastModifiedDate": 1508369622.123,
                  "callerReactions": [],
                  "reactionCounts": []
               }
                "location": { 
                  "filePath": "ahs_count.py",
                  "filePosition": 367,
                  "relativeFileVersion": "AFTER"
                },
            "repositoryName": "MyDemoRepo",
            "pullRequestId": "47"
    }
   ```

1. Para exibir comentários de uma solicitação de pull, execute o comando **get-comments-for-pull-request**, especificando:
   + O nome do CodeCommit repositório (com a `--repository-name` opção).
   + O ID gerado pelo sistema da solicitação pull (com a opção `--pull-request-id`).
   + (Opcional) Um token de enumeração para retornar o lote seguintes de resultados (com a opção `--next-token`).
   + (Opcional) Um inteiro não negativo no número de resultados retornados (com a opção `--max-results`).

   Por exemplo, use esse comando para visualizar comentários de uma solicitação pull com um ID 42.

   ```
   aws codecommit get-comments-for-pull-request --pull-request-id 42
   ```

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

   ```
   {
      "commentsForPullRequestData": [ 
         { 
            "afterBlobId": "1f330709EXAMPLE",
            "afterCommitId": "5d036259EXAMPLE",
            "beforeBlobId": "80906a4cEXAMPLE",
            "beforeCommitId": "317f8570EXAMPLE",
            "comments": [ 
               { 
                  "authorArn": "arn:aws:iam::111111111111:user/Saanvi_Sarkar",
                  "clientRequestToken": "",
                  "commentId": "abcd1234EXAMPLEb5678efgh",
                  "content": "These don't appear to be used anywhere. Can we remove them?",
                  "creationDate": 1508369622.123,
                  "deleted": false,
                  "lastModifiedDate": 1508369622.123,
                  "callerReactions": [],
                  "reactionCounts": 
                   {
                     "THUMBSUP" : 6,
                     "CONFUSED" : 1
                   }
               },
               {
                  "authorArn": "arn:aws:iam::111111111111:user/Li_Juan",
                  "clientRequestToken": "",
                  "commentId": "442b498bEXAMPLE5756813",
                  "content": "Good catch. I'll remove them.",
                  "creationDate": 1508369829.104,
                  "deleted": false,
                  "lastModifiedDate": 150836912.273,
                  "callerReactions": ["THUMBSUP"]
                  "reactionCounts": 
                   {
                     "THUMBSUP" : 14
                   }
                }
            ],
            "location": { 
               "filePath": "ahs_count.py",
               "filePosition": 367,
               "relativeFileVersion": "AFTER"
            },
            "repositoryName": "MyDemoRepo",
            "pullRequestId": "42"
         }
      ],
      "nextToken": "exampleToken"
   }
   ```

1. <a name="update-pull-request-approval-state"></a>Para aprovar ou revogar a aprovação de uma solicitação pull, execute o comando **update-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](how-to-view-pull-request.md#get-pull-request).
   + O estado de aprovação que você deseja aplicar (usando a opção **--approval-state**). Os estados de aprovação válidos incluem `APPROVE` e `REVOKE`.

   Por exemplo, use esse comando para aprovar uma pull request com o ID de *27* e um ID de revisão de*9f29d167EXAMPLE*.

   ```
   aws codecommit update-pull-request-approval-state --pull-request-id 27 --revision-id 9f29d167EXAMPLE --approval-state "APPROVE"
   ```

   Se houver êxito, o comando não retornará nada.

1. Para enviar uma resposta a um comentário em uma solicitação pull, execute o comando **post-comment-reply**, especificando:
   + O ID gerado pelo sistema do comentário ao qual você deseja responder (com a opção **--in-reply-to**).
   + Um token de idempotência exclusivo gerado pelo cliente (com a opção **--client-request-token**).
   + O conteúdo do sua resposta (com a opção **--content**). 

    Por exemplo, use esse comando para adicionar a resposta *"Good catch. I'll remove them."* ao comentário com o ID gerado pelo sistema de. *abcd1234EXAMPLEb5678efgh* 

   ```
   aws codecommit post-comment-reply --in-reply-to abcd1234EXAMPLEb5678efgh --content "Good catch. I'll remove them." --client-request-token 123Example
   ```

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

   ```
   { 
       "comment": {
           "authorArn": "arn:aws:iam::111111111111:user/Li_Juan",
           "clientRequestToken": "123Example",
           "commentId": "442b498bEXAMPLE5756813",
           "content": "Good catch. I'll remove them.",
           "creationDate": 1508369829.136,
           "deleted": false,
           "lastModifiedDate": 150836912.221,
           "callerReactions": [],
           "reactionCounts": []
       }
    }
   ```