

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 EventBridge extensão Amazon
<a name="working-with-appconfig-extensions-about-predefined-notification-eventbridge"></a>

A `AWS AppConfig deployment events to Amazon EventBridge` 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 envia notificações de eventos para o barramento de eventos EventBridge padrão 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 envia notificações de eventos para o barramento de eventos após o início, término e reversão de cada implantação da configuração.

Se você quiser ter mais controle sobre quais pontos de ação enviam EventBridge notificações, você pode criar uma extensão personalizada e inserir o Amazon Resource Name (ARN) do barramento de eventos EventBridge padrão para o 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).

**Importante**  
Essa extensão suporta somente o barramento de eventos EventBridge padrão.

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

Para usar a `AWS AppConfig deployment events to Amazon EventBridge` extensão, primeiro você anexa 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 de evento será enviada para qualquer perfil de configuração contido no aplicativo ou ambiente especificado.

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

Aqui está um exemplo de evento enviado para EventBridge quando a extensão é invocada.

```
{
   "version":"0",
   "id":"c53dbd72-c1a0-2302-9ed6-c076e9128277",
   "detail-type":"On Deployment Complete",
   "source":"aws.appconfig",
   "account":"111122223333",
   "time":"2022-07-09T01:44:15Z",
   "region":"us-east-1",
   "resources":[
      "arn:aws:appconfig:us-east-1:111122223333:extensionassociation/z763ff5"
   ],
   "detail":{
      "InvocationId":"5tfjcig",
       "Parameters":{
         
      },
      "Type":"OnDeploymentComplete",
      "Application":{
         "Id":"ba8toh7",
         "Name":"MyApp"
      },
      "Environment":{
         "Id":"pgil2o7",
         "Name":"MyEnv"
      },
      "ConfigurationProfile":{
         "Id":"ga3tqep",
         "Name":"MyConfigProfile"
      },
      "DeploymentNumber":1,
      "ConfigurationVersion":"1"
   }
}
```