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.

# Creación de una regla de notificación
<a name="notification-rule-create"></a>

Puede utilizar reglas de notificación para notificar a los usuarios cuando hay cambios en las aplicaciones de implementación, como éxitos y errores de implementación. Las reglas de notificación especifican tanto los eventos como el tema de Amazon SNS que se utiliza para enviar notificaciones. Para obtener más información, consulte [¿Qué son las notificaciones?](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/welcome.html)

Puede usar la consola o la AWS CLI para crear reglas de notificación para AWS CodeDeploy. <a name="notification-rule-create-console"></a>

# Para crear una regla de notificación (consola)
<a name="notification-rule-create-console"></a>

1. Inicie sesión en Consola de administración de AWS y abra la CodeDeploy consola en [https://console.aws.amazon.com/codedeploy/](https://console.aws.amazon.com/codedeploy/).

1. Elija **Application (Aplicación)** y, a continuación, elija una aplicación donde desea agregar notificaciones.

1. En la página de la aplicación, elija **Notify (Notificar)** y, a continuación, elija **Create notification rule (Crear regla de notificación)**. También puede ir a la página **Settings (Configuración)** para la aplicación y elegir **Create notification rule (Crear regla de notificación)**.

1. En **Nombre de la notificación**, introduzca un nombre para la regla.

1. En **Tipo de detalle**, selecciona **Básico** si quieres que solo se EventBridge incluya en la notificación la información proporcionada a Amazon. Selecciona **Completa** si deseas incluir la información proporcionada a Amazon EventBridge y la información que pueda proporcionar el administrador de notificaciones CodeDeploy o el administrador de notificaciones.

   Para obtener más información, consulte [Descripción del contenido y la seguridad de las notificaciones](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/security.html#security-notifications).

1.  En **Eventos que activan notificaciones**, seleccione los eventos para los que desea enviar notificaciones.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/codedeploy/latest/userguide/notification-rule-create.html)

1. En **Targets (Destinos)**, elija **Create SNS topic (Crear tema SNS)**.
**nota**  
Al crear el tema, se aplicará la política que CodeDeploy permite publicar eventos sobre el tema. El uso de un tema creado específicamente para CodeDeploy las notificaciones también ayuda a garantizar que solo añada usuarios a la lista de suscripciones de ese tema para los que desee ver las notificaciones sobre esta aplicación de despliegue.

   Después del prefijo **codestar-notifications-** escriba un nombre para el tema y, a continuación, elija **Submit (Enviar)**.
**nota**  
Si desea utilizar un tema de Amazon SNS existente en lugar de crear uno nuevo, en **Targets** (Destinos), elija su ARN. Asegúrese de que el tema tiene la directiva de acceso adecuada y de que la lista de suscriptores contiene salo aquellos usuarios a los que se permite ver información sobre la aplicación de implementación. Para obtener más información, consulte [Configuración de temas existentes de Amazon SNS para notificaciones](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/set-up-sns.html) y [Descripción del contenido y la seguridad de las notificaciones](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/security.html#security-notifications). 

1. Para terminar de crear la regla, elija **Enviar**.

1. Debe suscribir a los usuarios al tema de Amazon SNS de la regla antes de que puedan recibir notificaciones. Para obtener más información, consulte [Suscribir usuarios a temas de Amazon SNS que son destinos](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/subscribe-users-sns.html). También puede configurar la integración entre las notificaciones y Amazon Q Developer en aplicaciones de chat para enviar notificaciones a salas de chat de Amazon Chime o canales de Slack. Para obtener más información, consulte [Configuración de la integración entre notificaciones y Amazon Q Developer en aplicaciones de chat](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notifications-chatbot.html).<a name="notification-rule-create-cli"></a>

# Para crear una regla de notificación (AWS CLI)
<a name="notification-rule-create-cli"></a>

1. En un terminal o símbolo del sistema, ejecute el comando **create-notification rule** para generar el esqueleto JSON:

   ```
   aws codestar-notifications create-notification-rule --generate-cli-skeleton > rule.json
   ```

   Puede asignar al archivo el nombre que desee. En este ejemplo, el archivo se denomina *rule.json*.

1. Abra el archivo JSON en un editor de texto sin formato y edítelo para incluir el recurso, los tipos de eventos y el destino de Amazon SNS que desea para la regla. En el siguiente ejemplo, se muestra una regla de notificación con el nombre de una aplicación nombrada *MyDeploymentApplication* en AWS una cuenta con el ID*123456789012*. **MyNotificationRule** Las notificaciones se envían con todos los detalles a un tema de Amazon SNS denominado *codestar-notifications-MyNotificationTopic* Cuando las implementaciones se realizan correctamente:

   ```
   {
       "Name": "MyNotificationRule",
       "EventTypeIds": [
           "codedeploy-application-deployment-succeeded"
       ],
       "Resource": "arn:aws:codebuild:us-east-2:123456789012:MyDeploymentApplication",
       "Targets": [
           {
               "TargetType": "SNS",
               "TargetAddress": "arn:aws:sns:us-east-2:123456789012:codestar-notifications-MyNotificationTopic"
           }
       ],
       "Status": "ENABLED",
       "DetailType": "FULL"
   }
   ```

   Guarde el archivo.

1. Mediante el archivo que acaba de modificar, en el terminal o línea de comandos, vuelva a ejecutar el comando **create-notification-rule** para crear la regla de notificación:

   ```
   aws codestar-notifications create-notification-rule --cli-input-json  file://rule.json
   ```

1. Si se ejecuta correctamente, el comando devuelve el ARN de la regla de notificación, similar a lo siguiente:

   ```
   {
       "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
   }
   ```