Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Uso de los eventos AWS AppConfig de despliegue en la extensión Amazon SNS
<a name="working-with-appconfig-extensions-about-predefined-notification-sns"></a>

La `AWS AppConfig deployment events to Amazon SNS` extensión es una AWS extensión creada que le ayuda a supervisar el flujo de trabajo de implementación de la AWS AppConfig configuración y actuar en consecuencia. La extensión publica mensajes en un tema de Amazon SNS siempre que se implementa una configuración. Tras asociar la extensión a una de sus AWS AppConfig aplicaciones, entornos o perfiles de configuración, AWS AppConfig publica un mensaje sobre el tema cada vez que se inicie, finalice y revierta la implementación de la configuración.

Si desea tener más control sobre los puntos de acción que envían las notificaciones de Amazon SNS, puede crear una extensión personalizada e introducir el nombre de recurso de Amazon (ARN) del tema de Amazon SNS en el campo URI. Para obtener información sobre la creación de una extensión, consulte [Tutorial: Creación de extensiones personalizadas AWS AppConfig](working-with-appconfig-extensions-creating-custom.md).

## Uso del paquete de extensión
<a name="working-with-appconfig-extensions-about-predefined-notification-sns-using"></a>

En esta sección, se explica cómo se utiliza la extensión `AWS AppConfig deployment events to Amazon SNS`.

**Paso 1: Configurar AWS AppConfig la publicación de mensajes en un tema**  
Añada una política de control de acceso a su tema de Amazon SNS concediendo permisos de publicación de AWS AppConfig (`appconfig.amazonaws.com`) (`sns:Publish`). Para obtener más información, consulte [Casos de ejemplo para el control de acceso de Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.html).

**Paso 2: Crear una asociación de extensión**  
Adjunta la extensión a uno de tus AWS AppConfig recursos creando una asociación de extensiones. La asociación se crea mediante la AWS AppConfig consola o la acción de la [CreateExtensionAssociation](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateExtensionAssociation.html)API. Al crear la asociación, se especifica el ARN de una AWS AppConfig aplicación, un entorno o un perfil de configuración. Si asocia la extensión a una aplicación o un entorno, se envía una notificación para cualquier perfil de configuración contenido en la aplicación o el entorno especificados. Al crear la asociación, debe introducir un valor para el parámetro `topicArn` que contiene el ARN del tema de Amazon SNS que desee utilizar.

Tras crear la asociación, cuando se implementa una configuración para el AWS AppConfig recurso especificado, AWS AppConfig invoca la extensión y envía las notificaciones en función de los puntos de acción especificados en la extensión.

**nota**  
Esta extensión se invoca mediante los siguientes puntos de acción:  
`ON_DEPLOYMENT_START`
`ON_DEPLOYMENT_COMPLETE`
`ON_DEPLOYMENT_ROLLED_BACK`
No se pueden personalizar los puntos de acción de esta extensión. Para invocar diferentes puntos de acción, puede crear su propia extensión. Para obtener más información, consulte [Tutorial: Creación de extensiones personalizadas AWS AppConfig](working-with-appconfig-extensions-creating-custom.md).

Utilice los siguientes procedimientos para crear una asociación de AWS AppConfig extensiones mediante la AWS Systems Manager consola o el AWS CLI.

**Para crear una extensión de asociación (consola)**

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

1. En el panel de navegación, elija **AWS AppConfig**.

1. En la pestaña **Extensiones**, seleccione **Añadir al recurso**.

1. En la sección de **detalles del recurso de la extensión**, en Tipo de **recurso, elija un AWS AppConfig tipo** de recurso. Según el recurso que elija, AWS AppConfig le solicitará que elija otros recursos.

1. Elija **Crear una asociación al recurso**.

A continuación, se incluye un ejemplo del mensaje que se envía al tema de Amazon SNS cuando se invoca la extensión.

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