

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# プルリクエストのレビュー
<a name="how-to-review-pull-request"></a>

 AWS CodeCommit コンソールを使用して、プルリクエストに含まれる変更を確認できます。コメントは、リクエスト、ファイル、個別のコード行に追加できます。他のユーザーのコメントに返信することもできます。リポジトリが [configured with notifications](how-to-repository-email.md) と設定されている場合、ユーザーがコメントに返信するとき、またはプルリクエストにユーザーがコメントするときに E メールで通知が送信されます。

を使用してプルリクエストに AWS CLI コメントし、コメントに返信できます。変更を確認するには、CodeCommit コンソール、**git diff** コマンドまたは diff ツールを使用する必要があります。

**Topics**
+ [プルリクエストを確認する (コンソール)](#how-to-review-pull-request-console)
+ [プルリクエストを確認する (AWS CLI)](#how-to-review-pull-request-cli)

## プルリクエストを確認する (コンソール)
<a name="how-to-review-pull-request-console"></a>

CodeCommit コンソールを使用して、CodeCommit リポジトリ内のプルリクエストを確認できます。

1. [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home) で CodeCommit コンソールを開きます。

1. **リポジトリ**で、リポジトリの名前を選択します。

1. ナビゲーションペインで、[**プルリクエスト**] を選択します。

1. デフォルトでは、すべてのオープンプルリクエストが一覧表示されます。確認したいオープンプルリクエストを選択します。  
![\[CodeCommit コンソールでオープンプルリクエストを表示します。\]](http://docs.aws.amazon.com/ja_jp/codecommit/latest/userguide/images/codecommit-pull-request-view-list.png)
**注記**  
クローズまたはマージされたプルリクエストにコメントすることはできますが、マージまたは再度開くことはできません。

1. プルリクエストで、[**Changes**] を選択します。

1. 次のいずれかを行ってください。
   + プルリクエスト全体に全般的なコメントを追加するには、[**Comments on changes (変更に関するコメント)**] や [**New comment (新規コメント)**] にコメントを入力して、[**Save (保存)**] を選択します。[マークダウン](https://docs.aws.amazon.com/general/latest/gr/aws-markdown.html)を使用するか、プレーンテキスト形式でコメントを入力します。  
![\[プルリクエストの変更に対する全般的なコメント。\]](http://docs.aws.amazon.com/ja_jp/codecommit/latest/userguide/images/codecommit-commenting-changecomment.png)
   + コミット内のファイルにコメントを追加するには、[**Changes**] でファイルの名前を見つけます。ファイル名の横に表示されるコメント用アイコン (![\[The comment bubble icon that that indicates that you can leave a comment on that line of code.\]](http://docs.aws.amazon.com/ja_jp/codecommit/latest/userguide/images/codecommit-commentbubble.png)) を選択し、コメントを入力して [**保存**] を選択します。  
![\[プルリクエスト内のファイルに対するコメントの追加。\]](http://docs.aws.amazon.com/ja_jp/codecommit/latest/userguide/images/codecommit-commenting-addfilecomment.png)
   + プルリクエスト内の変更された行にコメントを追加するには、[**Changes**] でコメントする行に移動します。その行の横に表示されるコメント用アイコン (![\[The comment bubble icon that that indicates that you can leave a comment on that line of code.\]](http://docs.aws.amazon.com/ja_jp/codecommit/latest/userguide/images/codecommit-commentbubble.png)) を選択し、コメントを入力して [**保存**] を選択します。  
![\[プルリクエスト内の行に対するコメントの追加。\]](http://docs.aws.amazon.com/ja_jp/codecommit/latest/userguide/images/codecommit-pull-request-comment.png)

1. コミットのコメントに返信するには、[**Changes**] または [**Activity**] で、[**Reply**] を選択します。テキストと絵文字を使用して返信できます。  
![\[コメントへの返信や絵文字リアクションの追加。\]](http://docs.aws.amazon.com/ja_jp/codecommit/latest/userguide/images/codecommit-commenting-commenttab.png)

   特定の絵文字リアクションを使用して応答したユーザーの名前を、その絵文字リアクションを選択して表示できます。すべての絵文字リアクションと、特定の絵文字を使用して応答したユーザーに関する情報を表示するには、[**View all reactions (すべてのリアクションを表示)**」を選択します。コメントに絵文字で応答した場合、その応答は絵文字リアクションボタンのアイコンに表示されます。
**注記**  
コンソールに表示されるリアクション数は、ページが読み込まれた時点で正確です。絵文字のリアクション数に関する最新情報を表示するには、ページを更新するか、[**View all reactions (すべてのリアクションを表示)**] を選択します。  
![\[絵文字リアクションを使用してコメントに応答したユーザーに関する情報の表示。\]](http://docs.aws.amazon.com/ja_jp/codecommit/latest/userguide/images/codecommit-comment-view-reaction.png)

1. (オプション) Amazon CodeGuru Reviewer によって作成された推奨事項に返信し、推奨事項の品質に関するフィードバックを提供する場合は、[**Reply**] (返信) を選択します。リアクションボタンを使用して、推奨事項を承認するかどうかに関する一般的な情報を提供します。コメントフィールドを使用して、リアクションの詳細を入力します。
**注記**  
Amazon CodeGuru Reviewer は、プログラム分析と機械学習を使用して一般的な問題を検出し、Java または Python コードにおける修正点を提案する自動化されたコードレビューサービスです。  
Amazon CodeGuru Reviewer コメントが表示されるのは、リポジトリを Amazon CodeGuru Reviewer に関連付けている場合、分析が完了している場合、およびプルリクエストのコードが Java または Python コードである場合のみです。詳細については、「[AWS CodeCommit リポジトリと Amazon CodeGuru Reviewer の関連付けまたは関連付け解除](how-to-amazon-codeguru-reviewer.md)」を参照してください。
Amazon CodeGuru Reviewer コメントが [**Changes**] (変更) タブに表示されるのは、最新リビジョンのプルリクエストに対してコメントを作成した場合のみです。[**アクティビティ**] タブには、コメントが常に表示されます。
Amazon CodeGuru Reviewer の推奨事項に対する応答には使用可能な絵文字リアクションのいずれでも使用できますが、推奨事項の有用性を評価する場合は、親指を上げた手と親指を下げた手の絵文字アクションのみを使用します。  
![\[Amazon CodeGuru Reviewer によって、推奨事項が作成されました。レビュージョブが進行中です。\]](http://docs.aws.amazon.com/ja_jp/codecommit/latest/userguide/images/codecommit-pull-request-reply-bot.png)

1. プルリクエストで行われた変更を承認するには、[**Approve (承認)**] を選択します。
**注記**  
自分で作成したプルリクエストを自分で承認することはできません。

   承認、プルリクエストの承認ルール、および承認ルールテンプレートによって作成された承認ルールを [**Approvals (承認)**] で表示できます。プルリクエストを承認しない場合は、[**Revoke approval (承認の取り消し)**] を選択できます。
**注記**  
承認または取り消すことができるのは、オープンプルリクエストの承認のみです。ステータスが「マージ済」または「クローズ」のプルリクエストでは、承認を承認または取り消すことはできません。  
![\[プルリクエストの承認と承認ルール。\]](http://docs.aws.amazon.com/ja_jp/codecommit/latest/userguide/images/codecommit-approval-rule-met.png)

## プルリクエストを確認する (AWS CLI)
<a name="how-to-review-pull-request-cli"></a>

CodeCommit で AWS CLI コマンドを使用するには、 をインストールします AWS CLI。詳細については、「[コマンドラインリファレンス](cmd-ref.md)」を参照してください。

プルリクエストは、次の AWS CLI コマンドを使用して確認できます。
+ [**post-comment-for-pull-request**](#post-comment-reply) (プルリクエストにコメントを追加する)
+ [**get-comments-for-pull-request**](#get-comments-for-pull-request) (プルリクエストに残されたコメントを表示する)
+ [**update-pull-request-approval-state**](#update-pull-request-approval-state) (プルリクエストを承認するか承認を取り消す)
+ [**post-comment-reply**](#post-comment-reply) (プルリクエスト内のコメントに返信する)

次のコマンドを使用して、プルリクエストでコメントに絵文字を付けることもできます。
+ 絵文字を使用してコメントに返信するには、[**put-comment-reaction**](how-to-commit-comment.md#how-to-commit-comment-cli-commit-reply-emoji) を実行します。
+ コメントへの絵文字リアクションを表示するには、[**get-comment-reactions**](how-to-commit-comment.md#how-to-commit-comment-cli-commit-emoji-view) を実行します。

**を使用して CodeCommit リポジトリのプルリクエスト AWS CLI を確認するには**

1. リポジトリのプルリクエストにコメントを追加するには、**post-comment-for-pull-request** コマンドを実行し、以下を指定します。
   + プルリクエストの ID (**--pull-request-id** オプションを指定)。
   + プルリクエストが含まれているリポジトリの名前 (**--repository-name** オプションで指定)。
   + プルリクエストのマージ先である送信先ブランチのコミットの完全なコミット ID (**--before-commit-id** オプションで指定)。
   + コメントの投稿時にプルリクエストでブランチの現在の先端となっている送信元ブランチのコミットの完全なコミット ID (**--after-commit-id** オプションで指定)。
   + 冪等性の一意、クライアントで生成されたトークン (**--client-request-token** オプションを指定)。
   + コメントのコンテンツ (**--content** オプションを指定)。
   + コメントの配置場所に関する場所情報のリストには、以下を含みます。
     + 拡張子やサブディレクトリなど、比較されているファイルの名前 (ある場合) (**filePath** 属性を指定)。
     + 比較ファイル内の変更の行番号 (**filePosition** 属性を指定)。
     + 送信元ブランチと送信先ブランチの比較で、変更のコメントが「前」か「後」か (**relativeFileVersion** 属性を指定)。

   たとえば、このコマンドを使用して、*「これらは、どこでも使用されていないようです。削除できますか。」* というコメントを、リポジトリ名が *MyDemoRepo* で、プルリクエスト ID が *47*、ファイルが* ahs\$1count.py *の変更に追加する場合。

   ```
   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   
   ```

   このコマンドが正常に実行されると、次のような出力が生成されます。

   ```
   { 
            "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. プルリクエストのコメントを表示するには、**get-comments-for-pull-request** コマンドを実行し、以下を指定します。
   + CodeCommit リポジトリの名前 (`--repository-name` オプション)。
   + プルリクエストのシステム生成の ID （`--pull-request-id` オプション付き）。
   + (オプション) 結果の次のバッチを返す列挙トークン (`--next-token` オプションを使用)。
   + (オプション) 返される結果の数を制限する負でない整数 (`--max-results` オプションを使用)。

   たとえば、ID が 42 のプルリクエストのコメントを表示するには、このコマンドを使用します。

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

   このコマンドが正常に実行されると、次のような出力が生成されます。

   ```
   {
      "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>プルリクエストを承認するか取り消すには、次を指定して、**update-pull-request-approval-state** コマンドを実行します。
   + プルリクエストの ID （**--pull-request-id** オプションを指定）。
   + プルリクエストのリビジョン ID （**--revision-id option)** を使用。プルリクエストの現在のリビジョン ID を取得するには、[get-pull-request](how-to-view-pull-request.md#get-pull-request) コマンドを使用します。
   + 適用する承認状態（**--approval-state** を使用）。有効な承認状態には、`APPROVE` および `REVOKE` があります。

   たとえば、ID が *27* で、リビジョン ID が *9f29d167EXAMPLE* のプルリクエストを承認するには、このコマンドを使用します。

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

   成功すると、このコマンドは何も返しません。

1. プルリクエストのコメントに返答するには、**post-comment-reply** コマンドを実行して、次のように指定します。
   + 返信したいコメントのシステム生成 ID (**--in-reply-to** オプションを指定)。
   + 冪等性の一意、クライアントで生成されたトークン (**--client-request-token** オプションを指定)。
   + 返答のコンテンツ (**--content** オプションを指定)。

    たとえば、このコマンドを使用して、*「よく見つけましたね。削除します。」* という返答を、システムによって生成された ID が* abcd1234EXAMPLEb5678efgh *のコメントに追加する場合。

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

   このコマンドが正常に実行されると、次のような出力が生成されます。

   ```
   { 
       "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": []
       }
    }
   ```