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.
# Introducción a las notificaciones
La forma más sencilla de comenzar con las notificaciones es configurar una regla de notificación en uno de sus proyectos de compilación, aplicaciones de implementación, canalizaciones o repositorios.
**nota**
La primera vez que crea una regla de notificación, se crea un rol vinculado al servicio en su cuenta. Para obtener más información, consulte [Uso de funciones vinculadas a servicios para las notificaciones AWS CodeStar](using-service-linked-roles.md).
**Topics**
+ [Requisitos previos](#getting-started-prerequisites)
+ [Creación de una regla de notificación para un repositorio](getting-started-repository.md)
+ [Creación de una regla de notificación para un proyecto de compilación](getting-started-build.md)
+ [Creación de una regla de notificación para una aplicación de implementación](getting-started-deploy.md)
+ [Creación de una regla de notificación para una canalización](getting-started-pipeline.md)
## Requisitos previos
Realice los pasos que se indican en [Configuración](setting-up.md). También necesita un recurso para el que crear una regla de notificación.
+ [Cree un proyecto de](https://docs.aws.amazon.com/codebuild/latest/userguide/create-project.html) construcción CodeBuild o utilice uno existente.
+ [Cree una aplicación](https://docs.aws.amazon.com/codedeploy/latest/userguide/applications-create.html) o utilice una aplicación de implementación ya existente.
+ [Cree una canalización CodePipeline](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-create.html) o utilice una existente.
+ [Cree un AWS CodeCommit repositorio](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-create-repository.html) o utilice uno existente.
# Creación de una regla de notificación para un repositorio
Puede crear reglas de notificación para enviar notificaciones sobre eventos del repositorio que son importantes para usted. En los siguientes pasos se muestra cómo configurar una regla de notificación en un único evento de repositorio. Estos pasos se escriben partiendo del supuesto de que tienes un repositorio configurado en tu AWS cuenta.
**importante**
Si configuraste las notificaciones CodeCommit antes del 5 de noviembre de 2019, los temas de Amazon SNS utilizados para esas notificaciones contendrán una política que permite CodeCommit publicar en ellas y que contiene permisos diferentes a los necesarios para AWS CodeStar las notificaciones. No se recomienda usar estos temas. Si desea utilizar una creada para esa experiencia, debe añadir la política necesaria para AWS CodeStar las notificaciones además de la que ya existe. Para obtener más información, consulte [Configuración de los temas de Amazon SNS para las notificaciones](set-up-sns.md) y [Descripción del contenido y la seguridad de las notificaciones](security.md#security-notifications).
1. Abre la CodeCommit consola en [https://console.aws.amazon.com/codecommit/](https://console.aws.amazon.com/codecommit/).
1. Elija un repositorio de la lista y ábralo.
1. Elija **Notify (Notificar)** y, a continuación, elija **Create notification rule (Crear regla de notificación)**. También puede elegir **Settings (Configuración)**, elegir **Notifications (Notificaciones)** y, a continuación, 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 podría proporcionar el servicio de recursos o el administrador de notificaciones.
Para obtener más información, consulte [Descripción del contenido y la seguridad de las notificaciones](security.md#security-notifications).
1. En **Events that trigger notifications (Eventos que activan notificaciones)**, en **Branches and tags (Ramas y etiquetas)**, selecciona **Created (Creado)**.
1. En **Targets (Destinos)**, elija **Create SNS topic (Crear tema SNS)**.
**nota**
Cuando crees el tema como parte de la creación de la regla de notificación, se te aplicará la política que permite CodeCommit publicar eventos en el tema. El uso de un tema creado para las reglas de notificación ayuda a garantizar que sólo suscriba a los usuarios que desea recibir notificaciones sobre este repositorio.
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 política de acceso adecuada y de que la lista de suscriptores contiene solo aquellos usuarios que tienen permiso para ver información sobre el recurso. Si el tema Amazon SNS es un tema que se utilizó para CodeCommit las notificaciones antes del 5 de noviembre de 2019, contendrá una política que permite CodeCommit publicar en él y que contiene permisos diferentes a los necesarios para AWS CodeStar las notificaciones. No se recomienda usar estos temas. Si quieres usar uno creado para esa experiencia, debes añadir la política necesaria para AWS CodeStar las notificaciones además de la que ya existe. Para obtener más información, consulte [Configuración de los temas de Amazon SNS para las notificaciones](set-up-sns.md) y [Descripción del contenido y la seguridad de las notificaciones](security.md#security-notifications).
1. Elija **Submit (Enviar)** y, a continuación, revise la regla de notificación.
1. Suscriba su dirección de email al tema de Amazon SNS que acaba de crear. Para obtener más información, consulte [Para suscribir a los usuarios a un tema de Amazon SNS utilizado para las notificaciones](subscribe-users-sns.md#set-up-sns-subscribe).
1. Vaya hasta el repositorio y cree una rama de prueba desde la rama predeterminada.
1. Después de crear la rama, la regla de notificación envía una notificación a todos los suscriptores del tema con información sobre ese evento.
# Creación de una regla de notificación para un proyecto de compilación
Puede crear reglas de notificación para enviar notificaciones sobre los eventos del proyecto de compilación que son importantes para usted. En los siguientes pasos se muestra cómo configurar una regla de notificación en un único evento de proyecto de compilación. Estos pasos se escriben partiendo del supuesto de que tiene un proyecto de compilación configurado en su AWS cuenta.
1. Abre la CodeBuild consola en [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Elija un proyecto de compilación de la lista y ábralo.
1. Elija **Notify (Notificar)** y, a continuación, elija **Create notification rule (Crear regla de notificación)**. También puede elegir **Settings (Configuración)**, y, a continuación, 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 podría proporcionar el servicio de recursos o el administrador de notificaciones.
Para obtener más información, consulte [Descripción del contenido y la seguridad de las notificaciones](security.md#security-notifications).
1. En **Events that trigger notifications (Eventos que activan notificaciones)**, en **Build phase (Fase de compilación)**, seleccione **Success (Correcto)**.
1. En **Targets (Destinos)**, elija **Create SNS topic (Crear tema SNS)**.
**nota**
Cuando crees el tema como parte de la creación de la regla de notificación, se te aplicará la política que permite CodeBuild publicar eventos en el tema. El uso de un tema creado para reglas de notificación ayuda a garantizar que sólo suscriba a los usuarios que desee que reciban notificaciones sobre este proyecto de compilación.
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 política de acceso adecuada y de que la lista de suscriptores contiene solo aquellos usuarios que tienen permiso para ver información sobre el recurso. Si el tema Amazon SNS es un tema que se utilizó para CodeCommit las notificaciones antes del 5 de noviembre de 2019, contendrá una política que permite CodeCommit publicar en él y que contiene permisos diferentes a los necesarios para AWS CodeStar las notificaciones. No se recomienda usar estos temas. Si quieres usar uno creado para esa experiencia, debes añadir la política necesaria para AWS CodeStar las notificaciones además de la que ya existe. Para obtener más información, consulte [Configuración de los temas de Amazon SNS para las notificaciones](set-up-sns.md) y [Descripción del contenido y la seguridad de las notificaciones](security.md#security-notifications).
1. Elija **Submit (Enviar)** y, a continuación, revise la regla de notificación.
1. Suscriba su dirección de email al tema de Amazon SNS que acaba de crear. Para obtener más información, consulte [Para suscribir a los usuarios a un tema de Amazon SNS utilizado para las notificaciones](subscribe-users-sns.md#set-up-sns-subscribe).
1. Vaya al proyecto de compilación e inicie una compilación.
1. Una vez completada correctamente la fase de compilación, la regla de notificación envía a todos los suscriptores del tema una notificación con información sobre ese evento.
# Creación de una regla de notificación para una aplicación de implementación
Puede crear reglas de notificación para enviar notificaciones sobre los eventos en la aplicación de implementación que son importantes para usted. En los siguientes pasos se muestra cómo configurar una regla de notificación en un único evento de proyecto de compilación. Estos pasos se escriben dando por hecho que tiene una aplicación de implementación configurada en su cuenta de AWS .
1. Abre la CodeDeploy consola en [https://console.aws.amazon.com/codedeploy/](https://console.aws.amazon.com/codedeploy/).
1. Elija una aplicación de la lista y ábrala.
1. Elija **Notify (Notificar)** y, a continuación, elija **Create notification rule (Crear regla de notificación)**. También puede elegir **Settings (Configuración)**, y, a continuación, 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 podría proporcionar el servicio de recursos o el administrador de notificaciones.
Para obtener más información, consulte [Descripción del contenido y la seguridad de las notificaciones](security.md#security-notifications).
1. En **Events that trigger notifications (Eventos que desencadenan notificaciones)**, en **Deployment (Implementación)**, seleccione **Succeeded (Correcto)**.
1. En **Targets (Destinos)**, elija **Create SNS topic (Crear tema SNS)**.
**nota**
Cuando crees el tema como parte de la creación de la regla de notificación, se te aplicará la política que permite CodeDeploy publicar eventos en el tema. El uso de un tema creado para las reglas de notificación ayuda a garantizar que sólo suscriba a los usuarios que quiere que reciban notificaciones sobre esta aplicación de implementación.
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 política de acceso adecuada y de que la lista de suscriptores contiene solo aquellos usuarios que tienen permiso para ver información sobre el recurso. Si el tema Amazon SNS es un tema que se utilizó para CodeCommit las notificaciones antes del 5 de noviembre de 2019, contendrá una política que permite CodeCommit publicar en él y que contiene permisos diferentes a los necesarios para AWS CodeStar las notificaciones. No se recomienda usar estos temas. Si quieres usar uno creado para esa experiencia, debes añadir la política necesaria para AWS CodeStar las notificaciones además de la que ya existe. Para obtener más información, consulte [Configuración de los temas de Amazon SNS para las notificaciones](set-up-sns.md) y [Descripción del contenido y la seguridad de las notificaciones](security.md#security-notifications).
1. Elija **Submit (Enviar)** y, a continuación, revise la regla de notificación.
1. Suscriba su dirección de email al tema de Amazon SNS que acaba de crear. Para obtener más información, consulte [Para suscribir a los usuarios a un tema de Amazon SNS utilizado para las notificaciones](subscribe-users-sns.md#set-up-sns-subscribe).
1. Desplácese hasta la aplicación de implementación e inicie una implementación.
1. Una vez que la implementación se realiza correctamente, la regla de notificación envía una notificación a todos los suscriptores del tema con información sobre el evento.
# Creación de una regla de notificación para una canalización
Puede crear reglas de notificación para enviar notificaciones sobre los eventos de la canalización que son importantes para usted. En los siguientes pasos se muestra cómo configurar una regla de notificación en un único evento de canalización. Estos pasos se escriben partiendo del supuesto de que tienes una canalización configurada en tu AWS cuenta.
1. Abre la CodePipeline consola en [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).
1. Elija una canalización de la lista y ábrala.
1. Elija **Notify (Notificar)** y, a continuación, elija **Create notification rule (Crear regla de notificación)**. También puede elegir **Settings (Configuración)**, y, a continuación, 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 podría proporcionar el servicio de recursos o el administrador de notificaciones.
Para obtener más información, consulte [Descripción del contenido y la seguridad de las notificaciones](security.md#security-notifications).
1. En **Events that trigger notifications (Eventos que activan notificaciones)**, en **Action execution (Ejecución de acciones)**, seleccione **Started (Iniciado)**.
1. En **Targets (Destinos)**, elija **Create SNS topic (Crear tema SNS)**.
**nota**
Cuando crees el tema como parte de la creación de la regla de notificación, se te aplicará la política que permite CodePipeline publicar eventos en el tema. El uso de un tema creado para reglas de notificación ayuda a garantizar que sólo suscribe a los usuarios que quiere que reciban notificaciones sobre esta canalización.
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 política de acceso adecuada y de que la lista de suscriptores contiene solo aquellos usuarios que tienen permiso para ver información sobre el recurso. Si el tema Amazon SNS es un tema que se utilizó para CodeCommit las notificaciones antes del 5 de noviembre de 2019, contendrá una política que permite CodeCommit publicar en él y que contiene permisos diferentes a los necesarios para AWS CodeStar las notificaciones. No se recomienda usar estos temas. Si quieres usar uno creado para esa experiencia, debes añadir la política necesaria para AWS CodeStar las notificaciones además de la que ya existe. Para obtener más información, consulte [Configuración de los temas de Amazon SNS para las notificaciones](set-up-sns.md) y [Descripción del contenido y la seguridad de las notificaciones](security.md#security-notifications).
1. Elija **Submit (Enviar)** y, a continuación, revise la regla de notificación.
1. Suscriba su dirección de email al tema de Amazon SNS que acaba de crear. Para obtener más información, consulte [Para suscribir a los usuarios a un tema de Amazon SNS utilizado para las notificaciones](subscribe-users-sns.md#set-up-sns-subscribe).
1. Vaya a la canalización y, a continuación, elija **Release change (Cambio de versión)**.
1. Cuando se inicia la acción, la regla de notificación envía una notificación a todos los suscriptores del tema con información sobre el evento.