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 SQS
<a name="working-with-appconfig-extensions-about-predefined-notification-sqs"></a>

A `AWS AppConfig deployment events to Amazon SQS` 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 enfileira as mensagens em sua fila do Amazon Simple Queue Service (Amazon SQS) 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, coloca uma mensagem na AWS AppConfig fila após cada início, término e reversão de implantação da configuração.

Se quiser ter mais controle sobre quais pontos de ação enviam notificações do Amazon SQS, você pode criar uma extensão personalizada e inserir um nome do recurso da Amazon (ARN) da fila do Amazon SQS 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-sqs-using"></a>

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

**Etapa 1: Configurar AWS AppConfig para enfileirar mensagens**  
Adicione uma política do Amazon SQS à sua fila do Amazon SQS concedendo ao AWS AppConfig (`appconfig.amazonaws.com`) permissões de envio de mensagens (`sqs:SendMessage`). Para obter mais informações, consulte [Exemplos básicos de políticas do Amazon SQS.](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-basic-examples-of-sqs-policies.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 parâmetro `Here` que contenha o ARN da fila do Amazon SQS que você deseja usar.

Depois de criar a associação, quando uma configuração para o AWS AppConfig recurso especificado é criada ou 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 um exemplo da mensagem enviada para a fila do Amazon SQS quando a extensão é invocada.

```
{
   "InvocationId":"7itcaxp",
   "Parameters":{
      "queueArn":"arn:aws:sqs:us-east-1:111122223333:MySQSQueue"
   },
   "Application":{
      "Id":"1a2b3c4d",
      "Name":MyApp
   },
   "Environment":{
      "Id":"1a2b3c4d",
      "Name":MyEnv
   },
   "ConfigurationProfile":{
      "Id":"1a2b3c4d",
      "Name":"MyConfigProfile"
   },
   "Description":null,
   "DeploymentNumber":"3",
   "ConfigurationVersion":"1",
   "Type":"OnDeploymentComplete"
}
```