

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

# Gerenciar modelos de regras de aprovação
<a name="how-to-manage-templates"></a>

Você pode gerenciar os modelos de regras de aprovação em um Região da AWS para ajudar a entender como eles estão sendo usados e para que servem. Por exemplo, é possível editar os nomes e as descrições dos modelos de regras de aprovação para ajudar outras pessoas a entenderem sua finalidade. Você pode listar todos os modelos de regras de aprovação em um Região da AWS e obter informações sobre o conteúdo e a estrutura de um modelo. É possível revisar quais modelos estão associados a um repositório e quais repositórios estão associados a um modelo.

Para obter mais informações sobre políticas e permissões gerenciadas para modelos de regras de aprovação, consulte [Permissões para ações em modelos de regras de aprovação](auth-and-access-control-permissions-reference.md#aa-art) e [AWS políticas gerenciadas para CodeCommit](security-iam-awsmanpol.md).

## Gerenciar modelos de regras de aprovação (console)
<a name="how-to-manage-template-console"></a>

Você pode visualizar e gerenciar seus modelos de regras de aprovação no CodeCommit console.<a name="manage-template-console"></a>

## Como gerenciar modelos de regras de aprovação
<a name="manage-template-console"></a>

1. Abra o CodeCommit console em [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).

1. Escolha **Modelos de regras de aprovação** para ver a lista de modelos de regras de aprovação no Região da AWS local em que você está conectado. 
**nota**  
Os modelos de regras de aprovação só estão disponíveis no Região da AWS local em que foram criados.

1. Se você deseja fazer alterações em um modelo, escolha-o na lista e escolha **Edit (Editar)**.

1. Faça suas alterações e escolha **Salvar**.

## Gerenciar modelos de regras de aprovação (AWS CLI)
<a name="how-to-manage-template-cli"></a>

É possível gerenciar seus modelos de regra de aprovação com os seguintes comandos da AWS CLI :
+ [**list-approval-rule-templates**](#list-templates), para ver uma lista de todos os modelos de regras de aprovação em um Região da AWS
+ [**get-approval-rule-template**](#get-template), para visualizar o conteúdo de um modelo de regra de aprovação
+ [**update-approval-rule-template-content**](#update-template-content), para alterar o conteúdo de um modelo de regra de aprovação
+ [**update-approval-rule-template-name**](#update-template-name), para alterar o nome de um modelo de regra de aprovação
+ [**update-approval-rule-template-description**](#update-template-description), para alterar a descrição de um modelo de regra de aprovação
+ [**list-repositories-for-approval-rule-template**](#list-associated-repositories), para visualizar todos os repositórios associados a um modelo de regra de aprovação
+ [**list-associated-approval-rule-templates-for-repository**](#list-associated-templates), para visualizar todos os modelos de regras de aprovação associados a um repositório<a name="list-templates"></a>

## Para listar todos os modelos de regras de aprovação em um Região da AWS
<a name="list-templates"></a>

1. No terminal ou na linha de comando, execute o comando **list-approval-rule-templates**. Por exemplo, para listar todos os modelos de regras de aprovação na região Leste dos EUA (Ohio):

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

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

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

## Para obter o conteúdo de um modelo de regra de aprovação
<a name="get-template"></a>

1. No terminal ou na linha de comando, execute o comando **get-approval-rule-template**, especificando o nome do modelo de regra de aprovação:

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

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

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

## Para atualizar o conteúdo de um modelo de regra de aprovação
<a name="update-template-content"></a>

1. No terminal ou prompt de comando, execute o comando **update-approval-rule-template-content**, especificando o nome do modelo e o conteúdo alterado. Por exemplo, para alterar o conteúdo de um modelo de regra de aprovação chamado **1-approver-rule** para redefinir o grupo de aprovações para usuários que assumem a função de **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. Se houver êxito, o comando gerará uma saída semelhante à seguinte:

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

## Para atualizar o nome de um modelo de regra de aprovação
<a name="update-template-name"></a>

1. No terminal ou prompt de comando, execute o comando **update-approval-rule-template-name**, especificando o nome atual e o nome para o qual você deseja alterá-lo. Por exemplo, para alterar o nome de um modelo de regra de aprovação de **1-approver-rule** para **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. Se houver êxito, o comando gerará uma saída semelhante à seguinte:

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

## Para atualizar a descrição de um modelo de regra de aprovação
<a name="update-template-description"></a>

1. No terminal ou na linha de comando, execute o comando **update-approval-rule-template-description**, especificando o nome do modelo de regra de aprovação e a nova descrição:

   ```
   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. Se houver êxito, o comando gerará uma saída semelhante à seguinte:

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

## Para listar todos os repositórios associados a um modelo
<a name="list-associated-repositories"></a>

1. Na linha de comando ou terminal, execute o comando **list-repositories-for-approval-rule-template**, especificando o nome do modelo:

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

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

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

## Para listar todos os modelos associados a um repositório
<a name="list-associated-templates"></a>

1. Na linha de comando ou terminal, execute o comando **list-associated-approval-rule-templates-for-repository**, especificando o nome do repositório:

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

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

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