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á.
# Criar uma regra de notificação
É possível usar regras de notificação para notificar os usuários sobre alterações importantes, como quando uma solicitação pull é criada em um repositório. As regras de notificação especificam os eventos e o tópico do Amazon SNS usados para enviar notificações. Para obter mais informações, consulte [O que são notificações?](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/welcome.html)
**nota**
Esse atributo não está disponível na região Europa (Milão). Para saber como configurar notificações na experiência disponível nessa região, consulte [Configurar notificações do repositório](https://github.com/awsdocs/aws-codecommit-user-guide/blob/master/doc_source/how-to-repository-email-create.2.md).
Você pode usar o console ou o AWS CLI para criar regras de notificação para AWS CodeCommit.
# Como criar uma regra de notificação (console)
1. Faça login no Console de gerenciamento da AWS e abra o CodeCommit console em [https://console.aws.amazon.com/codecommit/](https://console.aws.amazon.com/codecommit/).
1. Selecione **Repositories (Repositórios)** e escolha um repositório no qual você deseja adicionar regras de notificação.
1. Na página do repositório, selecione **Notify (Notificar)** e **Create notification rule (Criar regra de notificação)**. Também é possível acessar a página **Settings (Configurações)** do repositório e selecionar **Create notification rule (Criar regra de notificação)**.
1. Em **Notification name (Nome da notificação)**, insira um nome para a regra.
1. Em **Tipo de detalhe**, escolha **Básico** se quiser que somente as informações fornecidas à Amazon sejam EventBridge incluídas na notificação. Escolha **Completo** se quiser incluir informações fornecidas à Amazon EventBridge e informações que possam ser fornecidas pelo gerenciador de notificações CodeCommit ou pelo gerenciador de notificações.
Para obter mais informações, consulte [Noções básicas sobre o conteúdo e a segurança de notificações](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/security.html#security-notifications).
1. Em **Events that trigger notifications (Eventos que acionam notificações)**, selecione os eventos para os quais você deseja enviar notificações. Para obter mais informações, consulte [Eventos para regras de notificação em repositórios](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/concepts.html#events-ref-repositories).
1. Em **Targets (Destinos)**, siga um destes procedimentos:
+ Se você já tiver configurado um recurso a ser usado com notificações, em **Escolher tipo de destino**, escolha **Amazon Q Developer em aplicações de chat (Slack)** ou **Tópico do SNS**. Em **Escolher destino**, escolha o nome do cliente (para um cliente do Slack configurado no Amazon Q Developer em aplicações de chat) ou o nome do recurso da Amazon (ARN) do tópico do Amazon SNS (para tópicos do Amazon SNS já configurados com a política necessária para notificações).
+ Se você não configurou um recurso para usar com notificações, escolha **Create target (Criar destino)** e selecione **SNS topic (Tópico do SNS)**. Forneça um nome para o tópico após **codestar-notifications-** e escolha **Create (Criar)**.
**nota**
Ao criar o tópico do Amazon SNS como parte da criação da regra de notificação, a política que permite ao recurso publicar eventos no tópico é aplicada para você. O uso de um tópico criado para regras de notificação ajuda a garantir que você inscreva somente os usuários para os quais deseja enviar notificações sobre esse recurso.
Você não pode criar um Amazon Q Developer no cliente de aplicações de chat como parte da criação de uma regra de notificação. Se escolher o Amazon Q Developer em aplicações de chat (Slack), você verá um botão direcionando para configurar um cliente no Amazon Q Developer em aplicações de chat. A escolha dessa opção abre o Amazon Q Developer no console de aplicações de chat. Para obter mais informações, consulte [Configurar integrações entre notificações e o Amazon Q Developer em aplicações de chat](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notifications-chatbot.html).
Se quiser usar um tópico do Amazon SNS existente como destino, você deverá adicionar a política necessária para o AWS CodeStar Notifications, além de quaisquer outras políticas que possam existir para esse tópico. Para obter mais informações, consulte [Configurar tópicos do Amazon SNS existentes para notificações](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/set-up-sns.html) e [Noções básicas sobre conteúdos de notificações e segurança](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/security.html#security-notifications).
1. Para concluir a criação da regra, escolha **Submit (Enviar)**.
1. Você precisa inscrever os usuários no tópico do Amazon SNS para a regra antes que eles possam receber notificações. Para obter mais informações, consulte [Inscrever usuários em tópicos do Amazon SNS que são destinos](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/subscribe-users-sns.html). Também é possível configurar a integração entre as notificações e o Amazon Q Developer em aplicações de chat para enviar notificações a salas de chat do Amazon Chime. Consulte mais informações em [Configurar integrações entre notificações e o Amazon Q Developer em aplicações de chat](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notifications-chatbot.html).
# Criar uma regra de notificação (AWS CLI)
1. Em um terminal ou prompt de comando, execute o comando **create-notification rule** para gerar o esqueleto JSON:
```
aws codestar-notifications create-notification-rule --generate-cli-skeleton > rule.json
```
É possível nomear o arquivo como você quiser. Neste exemplo, o nome do arquivo é *rule.json*.
1. Abra o arquivo JSON em um editor de texto simples e edite-o para incluir o recurso, os tipos de evento e o destino que você deseja para a regra. O exemplo a seguir mostra uma regra de notificação com **MyNotificationRule** o nome de um repositório nomeado *MyDemoRepo* em uma AWS conta com o ID. *123456789012* As notificações com o tipo de detalhe completo são enviadas para um tópico do Amazon SNS chamado *MyNotificationTopic* quando ramificações e tags são criadas:
```
{
"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"
}
```
Salve o arquivo.
1. Usando o arquivo que você acabou de editar, no terminal ou na linha de comando, execute o comando **create-notification-rule** novamente para criar a regra de notificação:
```
aws codestar-notifications create-notification-rule --cli-input-json file://rule.json
```
1. Se for bem-sucedido, o comando retornará o ARN da regra de notificação, semelhante ao seguinte:
```
{
"Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
}
```