

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

# 承認ルールテンプレートの管理
<a name="how-to-manage-templates"></a>

の承認ルールテンプレートは、 で管理 AWS リージョン して、その使用方法と目的を理解するのに役立ちます。たとえば、承認ルールテンプレートの名前と説明を編集して、他のユーザーがその目的を理解しやすくすることができます。内のすべての承認ルールテンプレートを に一覧表示し AWS リージョン、テンプレートの内容と構造に関する情報を取得できます。どのテンプレートがリポジトリに関連付けられているか、およびどのリポジトリがテンプレートに関連付けられているかを確認できます。

承認ルールテンプレートのマネージドポリシーと許可の詳細については、「[承認ルールテンプレートに対するアクションのアクセス許可](auth-and-access-control-permissions-reference.md#aa-art) および [AWS CodeCommit の マネージドポリシー](security-iam-awsmanpol.md)」を参照してください。

## 承認ルールテンプレートを管理する (コンソール)
<a name="how-to-manage-template-console"></a>

承認ルールテンプレートは、CodeCommit コンソールで表示および管理できます。<a name="manage-template-console"></a>

## 承認ルールテンプレートを管理するには
<a name="manage-template-console"></a>

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

1. **承認ルールテンプレート**を選択すると、サインイン AWS リージョン している の承認ルールテンプレートのリストが表示されます。
**注記**  
承認ルールテンプレートは、作成された AWS リージョン でのみ使用できます。

1. テンプレートを変更する場合は、リストからテンプレートを選択し、[**Edit (編集)**] を選択します。

1. 変更を行ってから、[**Save**] を選択します。

## 承認ルールテンプレートを管理する (AWS CLI)
<a name="how-to-manage-template-cli"></a>

承認ルールテンプレートは、次の AWS CLI コマンドで管理できます。
+ [**list-approval-rule-templates**](#list-templates)、 内のすべての承認ルールテンプレートのリストを表示するには AWS リージョン
+ [**get-approval-rule-template**](#get-template)、承認ルールテンプレートのコンテンツを表示します。
+ [**update-approval-rule-template-content**](#update-template-content)、承認ルールテンプレートのコンテンツを変更します。
+ [**update-approval-rule-template-name**](#update-template-name)、承認ルールテンプレートの名前を変更します。
+ [**update-approval-rule-template-description**](#update-template-description)、承認ルールテンプレートの説明を変更します。
+ [**list-repositories-for-approval-rule-template**](#list-associated-repositories)、承認ルールテンプレートに関連付けられているすべてのリポジトリを表示します。
+ [**list-associated-approval-rule-templates-for-repository**](#list-associated-templates)、リポジトリに関連付けられたすべての承認ルールテンプレートが表示されます。<a name="list-templates"></a>

## 内のすべての承認ルールテンプレートを一覧表示するには AWS リージョン
<a name="list-templates"></a>

1. ターミナルまたはコマンドラインで、**list-approval-rule-templates** コマンドを実行します。例えば、米国東部 (オハイオ) リージョンのすべての承認ルールテンプレートを一覧表示するには、次のようにします。

   ```
   aws codecommit list-approval-rule-templates --region us-east-2
   ```

1. 成功すると、このコマンドは以下のような出力を返します。

   ```
   {
       "approvalRuleTemplateNames": [
           "2-approver-rule-for-main",
           "1-approver-rule-for-all-pull-requests"
       ]
   }
   ```<a name="get-template"></a>

## 承認ルールテンプレートのコンテンツを取得するには
<a name="get-template"></a>

1. ターミナルまたはコマンドラインで、承認ルールテンプレートの名前を指定して、**get-approval-rule-template** コマンドを実行します。

   ```
   aws codecommit get-approval-rule-template --approval-rule-template-name 1-approver-rule-for-all-pull-requests
   ```

1. 成功すると、このコマンドは以下のような出力を返します。

   ```
   {
       "approvalRuleTemplate": {
           "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
           "ruleContentSha256": "621181bbEXAMPLE",
           "lastModifiedDate": 1571356106.936,
           "creationDate": 1571356106.936,
           "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests",
           "lastModifiedUser": "arn:aws:iam::123456789012:user/Li_Juan",
           "approvalRuleTemplateId": "a29abb15-EXAMPLE",
           "approvalRuleTemplateDescription": "All pull requests must be approved by one developer on the team."
       }
   }
   ```<a name="update-template-content"></a>

## 承認ルールテンプレートのコンテンツを更新するには
<a name="update-template-content"></a>

1. ターミナルまたはコマンドプロンプトで、テンプレートの名前と変更されたコンテンツを指定して、**update-approval-rule-template-content** コマンドを実行します。例えば、**1-approver-rule** という名前の承認ルールテンプレートの内容を変更して、**CodeCommitReview** のロールを引き受けるユーザーに承認プールを再定義するには、次のようにします。

   ```
   aws codecommit update-approval-rule-template-content --approval-rule-template-name 1-approver-rule --new-rule-content "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}"
   ```

1. 成功すると、このコマンドは以下のような出力を返します。

   ```
   {
       "approvalRuleTemplate": {
           "creationDate": 1571352720.773,
           "approvalRuleTemplateDescription": "Requires 1 approval for all pull requests from the CodeCommitReview pool",
           "lastModifiedDate": 1571358728.41,
           "approvalRuleTemplateId": "41de97b7-EXAMPLE",
           "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
           "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests",
           "ruleContentSha256": "2f6c21a5EXAMPLE",
           "lastModifiedUser": "arn:aws:iam::123456789012:user/Li_Juan"
       }
   }
   ```<a name="update-template-name"></a>

## 承認ルールテンプレートの名前を更新するには
<a name="update-template-name"></a>

1. ターミナルまたはコマンドプロンプトで、現在の名前と変更先の名前を指定して、**update-approval-rule-template-name** コマンドを実行します。たとえば、承認ルールテンプレートの名前を **1-approver-rule** から **1-approver-rule-for-all-pull-requests** に変更するには、次のようにします。

   ```
   aws codecommit update-approval-rule-template-name --old-approval-rule-template-name "1-approver-rule" --new-approval-rule-template-name "1-approver-rule-for-all-pull-requests"
   ```

1. 成功すると、このコマンドは以下のような出力を返します。

   ```
   {
       "approvalRuleTemplate": {
           "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests",
           "lastModifiedDate": 1571358241.619,
           "approvalRuleTemplateId": "41de97b7-EXAMPLE",
           "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
           "creationDate": 1571352720.773,
           "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major",
           "approvalRuleTemplateDescription": "All pull requests must be approved by one developer on the team.",
           "ruleContentSha256": "2f6c21a5cEXAMPLE"
       }
   }
   ```<a name="update-template-description"></a>

## 承認ルールテンプレートの説明を更新するには
<a name="update-template-description"></a>

1. ターミナルまたはコマンドラインで、承認ルールテンプレートの名前と新しい説明を指定して、**update-approval-rule-template-description** コマンドを実行します。

   ```
   aws codecommit update-approval-rule-template-description --approval-rule-template-name "1-approver-rule-for-all-pull-requests" --approval-rule-template-description "Requires 1 approval for all pull requests from the CodeCommitReview pool" 
   ```

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

   ```
   {
       "approvalRuleTemplate": {
           "creationDate": 1571352720.773,
           "approvalRuleTemplateDescription": "Requires 1 approval for all pull requests from the CodeCommitReview pool",
           "lastModifiedDate": 1571358728.41,
           "approvalRuleTemplateId": "41de97b7-EXAMPLE",
           "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
           "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests",
           "ruleContentSha256": "2f6c21a5EXAMPLE",
           "lastModifiedUser": "arn:aws:iam::123456789012:user/Li_Juan"
       }
   }
   ```<a name="list-associated-repositories"></a>

## テンプレートに関連付けられているすべてのリポジトリを一覧表示するには
<a name="list-associated-repositories"></a>

1. コマンドラインまたはターミナルで、テンプレートの名前を指定して、**list-repositories-for-approval-rule-template** コマンドを実行します。

   ```
   aws codecommit list-repositories-for-approval-rule-template --approval-rule-template-name 2-approver-rule-for-main
   ```

1. 成功すると、このコマンドは以下のような出力を返します。

   ```
   {
       "repositoryNames": [
           "MyDemoRepo",
           "MyClonedRepo"
       ]
   }
   ```<a name="list-associated-templates"></a>

## リポジトリに関連付けられているすべてのテンプレートを一覧表示するには
<a name="list-associated-templates"></a>

1. コマンドラインまたはターミナルで、リポジトリの名前を指定して、**list-associated-approval-rule-templates-for-repository** コマンドを実行します。

   ```
   aws codecommit list-associated-approval-rule-templates-for-repository --repository-name MyDemoRepo
   ```

1. 成功すると、このコマンドは以下のような出力を返します。

   ```
   {
       "approvalRuleTemplateNames": [
           "2-approver-rule-for-main",
           "1-approver-rule-for-all-pull-requests"
       ]
   }
   ```