

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

# Adicione uma ação de aprovação manual a um pipeline no CodePipeline
<a name="approvals-action-add"></a>

Você pode adicionar uma ação de aprovação a um estágio em um CodePipeline funil no ponto em que você deseja que o funil pare para que alguém possa aprovar ou rejeitar manualmente a ação. 

**nota**  
As ações de aprovação não podem ser adicionadas aos estágios Origem. Os estágios Origem podem conter somente ações de origem. 

Para usar o Amazon SNS para enviar notificações quando uma ação de aprovação estiver pronta para revisão, primeiro você deverá estar em conformidade com estes pré-requisitos: 
+ Conceda permissão à sua função CodePipeline de serviço para acessar os recursos do Amazon SNS. Para mais informações, consulte [Conceda permissões do Amazon SNS para uma função de serviço CodePipeline](approvals-service-role-permissions.md).
+ Conceder permissão a uma ou mais identidades do IAM em sua organização para atualizar o status de uma ação de aprovação. Para mais informações, consulte [Conceda permissões de aprovação a um usuário do IAM no CodePipeline](approvals-iam-permissions.md).

Neste exemplo, você cria um novo estágio de aprovação e adiciona uma ação de aprovação manual ao estágio. Você também pode adicionar uma ação de aprovação manual a um estágio existente que contém outras ações.

## Adicionar uma ação de aprovação manual a um CodePipeline pipeline (console)
<a name="approvals-action-add-console"></a>

Você pode usar o CodePipeline console para adicionar uma ação de aprovação a um CodePipeline pipeline existente. Você deve usar a AWS CLI se quiser adicionar ações de aprovação ao criar um novo pipeline. 

1. Abra o CodePipeline console em [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).

1. Em **Nome**, selecione o pipeline.

1. Na página de detalhes do pipeline, selecione **Editar**.

1. Se você deseja adicionar uma ação de aprovação a um novo estágio, selecione **\$1Add stage (\$1Adicionar estágio)** no ponto do pipeline onde você deseja adicionar uma solicitação de aprovação e insira um nome para o estágio. Na página **Add stage (Adicionar estágio)** em **Stage name (Nome do estágio)**, insira o novo nome de estágio. Por exemplo, adicione um novo estágio e nomeie-o `Manual_Approval`.

   Se você deseja adicionar uma ação de aprovação a um estágio existente, selecione **Edit stage (Editar estágio)**. 

1. No estágio em que você deseja adicionar a ação de aprovação, escolha **\$1 Add action group (Adicionar grupo de ações)**.

1. Na página **Edit action (Editar ação)**, faça o seguinte:

   1. Em **Action name (Nome da ação)**, insira um nome para identificar a ação.

   1. Em **Action provider (Fornecedor de ação)**, em **Approval (Aprovação)**, escolha **Manual approval (Aprovação manual)**.

   1. (Opcional) Em **SNS topic ARN (ARN do tópico do SNS)**, selecione o nome do tópico que é usado para enviar notificações para a ação de aprovação.

   1. (Opcional) Em **URL para revisão**, insira a URL da página ou aplicativo que você deseja que o aprovador examine. Os aprovadores podem acessar essa URL através de um link incluído no console do pipeline. 

   1. (Opcional) Em **Comments (Comentários)**, insira as outras informações que deseja compartilhar com o revisor.

   1. Escolha **Salvar**.

## Adicionar uma ação de aprovação manual a um CodePipeline pipeline (CLI)
<a name="approvals-action-add-cli"></a>

Você pode usar a CLI para adicionar uma ação de aprovação a um pipeline existente ou ao criar um pipeline. Para fazer isso, inclua uma ação de aprovação com o tipo manual em um estágio que você está criando ou editando. 

Para obter mais informações sobre como criar e editar pipelines, consulte [Criar um pipeline, estágios e ações](pipelines-create.md) e [Editar um pipeline no CodePipeline](pipelines-edit.md).

Para adicionar um estágio a um pipeline que inclua somente uma ação de aprovação, você inclui algo semelhante ao exemplo a seguir ao criar ou atualizar o pipeline. 

**nota**  
A seção `configuration` é opcional. Essa é apenas uma parte do arquivo, não a estrutura completa. Para obter mais informações, consulte [CodePipeline referência de estrutura de tubulação](reference-pipeline-structure.md).

```
{
    "name": "MyApprovalStage",
    "actions": [
        {
            "name": "MyApprovalAction",
            "actionTypeId": {
                "category": "Approval",
                "owner": "AWS",
                "version": "1",
                "provider": "Manual"
            },
            "inputArtifacts": [],
            "outputArtifacts": [],
            "configuration": {
                "NotificationArn": "arn:aws:sns:us-east-2:80398EXAMPLE:MyApprovalTopic",
                "ExternalEntityLink": "http://example.com",
                "CustomData": "The latest changes include feedback from Bob."},
            "runOrder": 1
        }
    ]
}
```

Se a ação de aprovação estiver em um estágio em que há outras ações, a seção do arquivo JSON que contém o estágio poderá ser parecido com o exemplo a seguir.

**nota**  
A seção `configuration` é opcional. Essa é apenas uma parte do arquivo, não a estrutura completa. Para obter mais informações, consulte [CodePipeline referência de estrutura de tubulação](reference-pipeline-structure.md).

```
,
{
    "name": "Production",
    "actions": [
        {
            "inputArtifacts": [],
            "name": "MyApprovalAction",
            "actionTypeId": {
                "category": "Approval",
                "owner": "AWS",
                "version": "1",
                "provider": "Manual"
            },
            "outputArtifacts": [],
            "configuration": {
                "NotificationArn": "arn:aws:sns:us-east-2:80398EXAMPLE:MyApprovalTopic",
                "ExternalEntityLink": "http://example.com",
                "CustomData": "The latest changes include feedback from Bob."
            },
            "runOrder": 1
        },
        {
            "inputArtifacts": [
                {
                    "name": "MyApp"
                }
            ],
            "name": "MyDeploymentAction",
            "actionTypeId": {
                "category": "Deploy",
                "owner": "AWS",
                "version": "1",
                "provider": "CodeDeploy"
            },
            "outputArtifacts": [],
            "configuration": {
                "ApplicationName": "MyDemoApplication",
                "DeploymentGroupName": "MyProductionFleet"
            },
            "runOrder": 2
        }
    ]
}
```