管理核准規則範本

您可以在中管理核准規則範本，AWS 區域以協助瞭解它們的使用方式及其用途。例如，您可以編輯核准規則範本的名稱和描述，以協助其他人瞭解其用途。您可以在中列出所有核准規則範本AWS 區域，並取得範本內容和結構的相關資訊。您可以檢閱哪些範本與儲存庫相關聯，以及哪些儲存庫與範本相關聯。

如需有關核准規則範本的受管理原則和權限的詳細資訊，請參閱核准規則範本上動作的許可和AWS CodeCommit 的 受管政策。

管理核准規則範本 (主控台)

您可以在 CodeCommit 主控台檢視和管理核准規則範本。

管理核准規則範本

1. 請在以下位置開啟CodeCommit主控台。 https://console.aws.amazon.com/codesuite/codecommit/home

2. 選擇「核准規則範本」，以檢視您登入之AWS 區域處的核准規則範本清單。

   注意

   核准規則範本 (核准規則範本)。AWS 區域

3. 如果您要變更範本，請從清單中選擇範本，然後選擇 Edit (編輯)。

4. 進行變更，然後選擇 Save (儲存變更)。

管理核准規則範本 (AWS CLI)

您可以使用下列 AWS CLI 命令來管理核准規則範本：

• list-approval-rule-templates，檢視所有核准規則範本 (AWS 區域

• get-approval-rule-template，檢視核准規則範本的內容

• update-approval-rule-template-content，變更核准規則範本的內容

• update-approval-rule-template-name，變更核准規則範本的名稱

• update-approval-rule-template-description，變更核准規則範本的描述

• list-repositories-for-approval-rule-template，檢視與核准規則範本相關聯的所有儲存庫

• list-associated-approval-rule-templates-for-repository，檢視與儲存庫相關聯的所有核准規則範本

列出所有核准規則範本 (AWS 區域

1. 在終端機或命令列上執行 list-approval-rule-templates 命令。例如，列出美國東部 (俄亥俄) 區域中所有核准規則範本 (俄亥俄) 區域：

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

2. 如果此命令成功執行，您會看到類似如下的輸出傳回：

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

取得核准規則範本的內容

1. 在終端機或命令列，執行 get-approval-rule-template 命令，並指定核准規則範本的名稱：

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

2. 如果此命令成功執行，您會看到類似如下的輸出傳回：

   {
       "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."
       }
   }

更新核准規則範本的內容

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/*\"]}]}"

2. 如果此命令成功執行，您會看到類似如下的輸出傳回：

   {
       "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"
       }
   }

更新核准規則範本的名稱

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"

2. 如果此命令成功執行，您會看到類似如下的輸出傳回：

   {
       "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"
       }
   }

更新核准規則範本的描述

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" 

2. 如果此命令成功執行，您會看到類似如下的輸出產生：

   {
       "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"
       }
   }

列出與範本相關聯的所有儲存庫

1. 在命令列或終端機，執行 list-repositories-for-approval-rule-template 命令，並指定範本的名稱：

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

2. 如果此命令成功執行，您會看到類似如下的輸出傳回：

   {
       "repositoryNames": [
           "MyDemoRepo",
           "MyClonedRepo"
       ]
   }

列出與儲存庫相關聯的所有範本

1. 在命令列或終端機，執行 list-associated-approval-rule-templates-for-repository 命令，並指定儲存庫的名稱：

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

2. 如果此命令成功執行，您會看到類似如下的輸出傳回：

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