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

# Usando os eventos AWS AppConfig de implantação na extensão Amazon SNS
<a name="working-with-appconfig-extensions-about-predefined-notification-sns"></a>

A `AWS AppConfig deployment events to Amazon SNS` extensão é uma extensão AWS criada que ajuda você a monitorar e agir no fluxo de trabalho de implantação da AWS AppConfig configuração. A extensão publica mensagens em um tópico do Amazon SNS sempre que uma configuração é implantada. Depois de associar a extensão a um de seus AWS AppConfig aplicativos, ambientes ou perfis de configuração, AWS AppConfig publica uma mensagem no tópico após cada início, término e reversão da implantação da configuração.

Se quiser ter mais controle sobre quais pontos de ação enviam notificações do Amazon SNS, você poderá criar uma extensão personalizada e inserir o nome do recurso da Amazon (ARN) de um tópico do Amazon SNS no campo URI. Para obter mais informações sobre como criar uma extensão, consulte [Passo a passo: Criação de extensões personalizadas AWS AppConfig](working-with-appconfig-extensions-creating-custom.md).

## Como usar a extensão
<a name="working-with-appconfig-extensions-about-predefined-notification-sns-using"></a>

Esta seção descreve como usar a extensão `AWS AppConfig deployment events to Amazon SNS`.

**Etapa 1: Configurar AWS AppConfig para publicar mensagens em um tópico**  
Adicione uma política de controle de acesso ao seu tópico do Amazon SNS concedendo ao AWS AppConfig (`appconfig.amazonaws.com`) permissões de publicação (`sns:Publish`). Para obter mais informações, consulte [Casos de exemplo para controle de acesso do Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.html).

**Etapa 2: crie uma associação de extensão**  
Anexe a extensão a um de seus AWS AppConfig recursos criando uma associação de extensão. Você cria a associação usando o AWS AppConfig console ou a ação [CreateExtensionAssociation](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateExtensionAssociation.html)da API. Ao criar a associação, você especifica o ARN de um AWS AppConfig aplicativo, ambiente ou perfil de configuração. Se você associar a extensão a um aplicativo ou ambiente, uma notificação será enviada para qualquer perfil de configuração contido no aplicativo ou ambiente especificado. Ao criar a associação, você deve inserir um valor para o parâmetro `topicArn` que contém o ARN do tópico do Amazon SNS que você deseja usar.

Depois de criar a associação, quando uma configuração para o AWS AppConfig recurso especificado é implantada, AWS AppConfig invoca a extensão e envia notificações de acordo com os pontos de ação especificados na extensão.

**nota**  
Esta extensão é invocada pelos seguintes pontos de ação:  
`ON_DEPLOYMENT_START`
`ON_DEPLOYMENT_COMPLETE`
`ON_DEPLOYMENT_ROLLED_BACK`
Não é possível personalizar os pontos de ação desta extensão. Para invocar pontos de ação diferentes, você pode criar sua própria extensão. Para obter mais informações, consulte [Passo a passo: Criação de extensões personalizadas AWS AppConfig](working-with-appconfig-extensions-creating-custom.md).

Use os procedimentos a seguir para criar uma associação de AWS AppConfig extensão usando o AWS Systems Manager console ou AWS CLI o.

**Para criar uma associação de extensão (console)**

1. Abra o AWS Systems Manager console em [https://console.aws.amazon.com/systems-manager/appconfig/](https://console.aws.amazon.com/systems-manager/appconfig/).

1. No painel de navegação, escolha **AWS AppConfig**.

1. Na guia **Extensões**, escolha **Adicionar ao recurso**.

1. Na seção **Detalhes do recurso de extensão**, em **Tipo de recurso**, escolha um tipo de AWS AppConfig recurso. Dependendo do recurso escolhido, AWS AppConfig solicita que você escolha outros recursos.

1. Escolha **Criar associação ao recurso**.

Veja uma amostra da mensagem enviada para o tópico do Amazon SNS quando a extensão é invocada.

```
{
    "Type": "Notification",
    "MessageId": "ae9d702f-9a66-51b3-8586-2b17932a9f28",
    "TopicArn": "arn:aws:sns:us-east-1:111122223333:MySNSTopic",
    "Message": {
        "InvocationId": "7itcaxp",
        "Parameters": {
            "topicArn": "arn:aws:sns:us-east-1:111122223333:MySNSTopic"
        },
        "Application": {
            "Id": "1a2b3c4d",
            "Name": MyApp
        },
        "Environment": {
            "Id": "1a2b3c4d",
            "Name": MyEnv
        },
        "ConfigurationProfile": {
            "Id": "1a2b3c4d",
            "Name": "MyConfigProfile"
        },
        "Description": null,
        "DeploymentNumber": "3",
        "ConfigurationVersion": "1",
        "Type": "OnDeploymentComplete"
    },
    "Timestamp": "2022-06-30T20:26:52.067Z",
    "SignatureVersion": "1",
    "Signature": "<...>",
    "SigningCertURL": "<...>",
    "UnsubscribeURL": "<...>",
    "MessageAttributes": {
        "MessageType": {
            "Type": "String",
            "Value": "OnDeploymentStart"
        }
    }
}
```