Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Création d'une règle de notification
Vous pouvez utiliser des règles de notification pour informer les utilisateurs de modifications importantes, par exemple, quand une demande d'extraction est créée dans un référentiel. Les règles de notification spécifient à la fois les événements et le sujet Amazon SNS utilisé pour envoyer des notifications. Pour plus d'informations, consultez [Que sont les notifications ?](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/welcome.html)
**Note**
Cette fonctionnalité n'est pas disponible dans la région Europe (Milan). Pour savoir comment configurer les notifications dans l'expérience disponible dans cette région, voir [Configurer les notifications du référentiel](https://github.com/awsdocs/aws-codecommit-user-guide/blob/master/doc_source/how-to-repository-email-create.2.md).
Vous pouvez utiliser la console ou le AWS CLI pour créer des règles de notification pour AWS CodeCommit.
# Pour créer une règle de notification (console)
1. Connectez-vous à la CodeCommit console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/codecommit/](https://console.aws.amazon.com/codecommit/).
1. Choisissez **Repositories (Référentiels)**, puis sélectionnez un référentiel dans lequel vous souhaitez ajouter des règles de notification.
1. Sur la page du référentiel, choisissez **Notify (Notifier)**, puis **Create notification rule (Créer une règle de notification)**. Vous pouvez également accéder à la page **Settings (Paramètres)** du référentiel et choisir **Create notification rule (Créer une règle de notification)**.
1. Dans **Notification name (Nom de la notification)**, saisissez le nom de la règle.
1. Dans **Type de détail**, choisissez **Basic** si vous souhaitez que seules les informations fournies à Amazon soient EventBridge incluses dans la notification. Choisissez **Complet** si vous souhaitez inclure les informations fournies à Amazon EventBridge et les informations susceptibles d'être fournies par le CodeCommit ou le gestionnaire de notifications.
Pour plus d'informations, consultez [Présentation du contenu des notifications et de la sécurité](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/security.html#security-notifications).
1. Dans **Événements qui déclenchent des notifications**, sélectionnez les événements pour lesquels vous souhaitez envoyer des notifications. Pour plus d'informations, consultez [ Événements pour les règles de notification sur les référentiels](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/concepts.html#events-ref-repositories).
1. Dans **Targets (Cibles)**, effectuez l'une des actions suivantes :
+ Si vous avez déjà configuré une ressource à utiliser avec les notifications, dans **Choisir le type de cible**, sélectionnez **Amazon Q Developer dans les applications de chat (Slack)** ou le sujet **SNS**. Dans **Choisir une cible**, choisissez le nom du client (pour un client Slack configuré dans Amazon Q Developer dans les applications de chat) ou le nom de ressource Amazon (ARN) du sujet Amazon SNS (pour les sujets Amazon SNS déjà configurés avec la politique requise pour les notifications).
+ Si vous n'avez pas configuré de ressource à utiliser avec les notifications, choisissez **Create target (Créer une cible)**, puis **SNS topic (Rubrique SNS)**. Donnez un nom à la rubrique après **codestar-notifications-**, puis choisissez **Create (Créer)**.
**Note**
Si vous créez la rubrique Amazon SNS dans le cadre de la création de la règle de notification, la stratégie qui permet à la fonctionnalité de notifications de publier des événements dans la rubrique est appliquée automatiquement. L'utilisation d'une rubrique créée pour les règles de notification vous permet de vous assurer que vous n'abonnez que les utilisateurs qui doivent recevoir des notifications sur ce référentiel.
Vous ne pouvez pas créer un client Amazon Q Developer dans les applications de chat dans le cadre de la création d'une règle de notification. Si vous choisissez Amazon Q Developer dans les applications de chat (Slack), vous verrez un bouton vous demandant de configurer un client dans Amazon Q Developer dans les applications de chat. Le choix de cette option ouvre la console Amazon Q Developer dans les applications de chat. Pour plus d'informations, consultez [Configurer les intégrations entre les notifications et Amazon Q Developer dans les applications de chat](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notifications-chatbot.html).
Si vous souhaitez utiliser une rubrique Amazon SNS existante comme cible, vous devez ajouter la politique requise pour les AWS CodeStar notifications en plus de toute autre politique susceptible d'exister pour cette rubrique. Pour de plus amples informations, veuillez consulter [Configurer les rubriques Amazon SNS existantes pour les notifications](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/set-up-sns.html) et [Présentation du contenu des notifications et de la sécurité](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/security.html#security-notifications).
1. Pour terminer la création de la règle, choisissez **Submit (Soumettre)**.
1. Vous devez inscrire les utilisateurs à la rubrique Amazon SNS relative à la règle pour qu'ils puissent recevoir des notifications. Pour plus d'informations, consultez [Abonner des utilisateurs aux rubriques Amazon SNS qui sont](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/subscribe-users-sns.html) des cibles. Vous pouvez également configurer l'intégration entre les notifications et Amazon Q Developer dans les applications de chat afin d'envoyer des notifications aux forums de discussion Amazon Chime. Pour plus d'informations, consultez [Configurer l'intégration entre les notifications et Amazon Q Developer dans les applications de chat](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notifications-chatbot.html).
# Pour créer une règle de notification (AWS CLI)
1. Dans un terminal ou une invite de commandes, exécutez la commande **create-notification rule** pour générer le squelette JSON :
```
aws codestar-notifications create-notification-rule --generate-cli-skeleton > rule.json
```
Vous pouvez donner au fichier le nom de votre choix. Dans cet exemple, le fichier est nommé *rule.json*.
1. Ouvrez le fichier JSON dans un éditeur de texte brut et modifiez-le pour y inclure la ressource, les types d'événements et la cible que vous souhaitez pour la règle. L'exemple suivant montre une règle de notification nommée **MyNotificationRule** d'après un référentiel nommé *MyDemoRepo* dans un AWS compte avec cet ID*123456789012*. Les notifications avec le type de détail complet sont envoyées à une rubrique Amazon SNS nommée *MyNotificationTopic* lorsque les branches et les balises sont créées :
```
{
"Name": "MyNotificationRule",
"EventTypeIds": [
"codecommit-repository-branches-and-tags-created"
],
"Resource": "arn:aws:codecommit:us-east-1:123456789012:MyDemoRepo",
"Targets": [
{
"TargetType": "SNS",
"TargetAddress": "arn:aws:sns:us-east-1:123456789012:MyNotificationTopic"
}
],
"Status": "ENABLED",
"DetailType": "FULL"
}
```
Enregistrez le fichier.
1. À l'aide du fichier que vous venez de modifier, à partir du terminal ou de la ligne de commande, exécutez à nouveau la commande **create-notification-rule** pour créer la règle de notification :
```
aws codestar-notifications create-notification-rule --cli-input-json file://rule.json
```
1. En cas de réussite, la commande renvoie l'ARN de la règle de notification, comme suit :
```
{
"Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
}
```