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
Você pode usar o console Developer Tools ou o AWS CLI para criar regras de notificação. É possível criar um tópico do Amazon SNS para usar como destino para uma regra de notificação como parte da criação da regra. Se quiser usar um cliente do AWS Chatbot como alvo, você deve criar esse cliente antes de criar a regra. Para obter mais informações, consulte [Configurar um cliente AWS Chatbot para um canal do Slack](notifications-chatbot.md#notifications-chatbot-configure-client).
# Como criar uma regra de notificação (console)
1. Abra o console do AWS Developer Tools em [https://console.aws.amazon.com/codesuite/configurações/notificações](https://console.aws.amazon.com/codesuite/settings/notifications/).
1. Use a barra de navegação para navegar até o recurso.
+ Para CodeBuild, escolha **Construir**, escolha **Construir projetos** e escolha um projeto de construção.
+ Para CodeCommit, escolha **Fonte**, escolha **Repositórios** e escolha um repositório.
+ Para CodeDeploy, escolha **Aplicativos** e escolha um aplicativo.
+ Para CodePipeline, escolha **Pipeline**, escolha **Pipelines** e escolha um pipeline.
1. Na página do recurso, escolha **Notify (Notificar)** e **Create notification rule (Criar regra de notificação)**. Você também pode acessar a página **Settings (Configurações)** do recurso, acessar **Notifications (Notificações)** ou **Notification rules (Regras de notificação)** e escolher **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 serviço de recursos ou pelo gerenciador de notificações.
Para obter mais informações, consulte [Noções básicas do conteúdo e da segurança das notificações](security.md#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 saber os tipos de evento para um recurso, consulte o seguinte:
+ CodeBuild: [Eventos para regras de notificação em projetos de compilação](concepts.md#events-ref-buildproject)
+ CodeCommit: [Eventos para regras de notificação em repositórios](concepts.md#events-ref-repositories)
+ CodeDeploy: [Eventos de regras de notificação em aplicações de implantação](concepts.md#events-ref-deployapplication)
+ CodePipeline: [Eventos para regras de notificação em pipelines](concepts.md#events-ref-pipeline)
1. Em **Targets (Destinos)**, siga um destes procedimentos:
+ Se você já tiver configurado um recurso para usar com notificações, em **Escolher tipo de destino**, selecione **AWS Chatbot (Slack)**, **AWS Chatbot (Microsoft Teams)** ou **Tópico do SNS**. Em **Escolher destino**, escolha o nome do cliente (para um cliente Slack ou Microsoft Teams configurado no AWS Chatbot) ou o Nome de 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 cliente AWS Chatbot como parte da criação de uma regra de notificação. Se você escolher AWS Chatbot (Slack) ou Chatbot AWS (Microsoft Teams), você verá um botão direcionando você a configurar um cliente no Chatbot. AWS Escolher essa opção abre o console do AWS Chatbot. Para obter mais informações, consulte [Configurar um cliente AWS Chatbot para um canal do Slack](notifications-chatbot.md#notifications-chatbot-configure-client).
Se você quiser usar um tópico existente do Amazon SNS como alvo, você deve adicionar a política necessária para AWS CodeStar Notificações, 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 para notificações](set-up-sns.md) e [Noções básicas do conteúdo e da segurança das notificações](security.md#security-notifications).
1. Escolha **Submit (Enviar)** e revise a regra de notificação.
**nota**
Os usuários devem se inscrever e confirmar assinaturas do tópico do Amazon SNS que você especificou como destino da regra antes de receberem notificações. Para obter mais informações, consulte [Para inscrever usuários em um tópico do Amazon SNS usado para notificações](subscribe-users-sns.md#set-up-sns-subscribe).
# 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 do Amazon SNS 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 houver êxito, 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"
}
```
# Como listar tipos de evento para regras de notificação (AWS CLI)
1. Em um terminal ou prompt de comando, execute o comando **list-event-types**. É possível usar a opção `--filters` para limitar a resposta a um tipo de recurso específico ou a outro atributo. Por exemplo, o seguinte retorna uma lista de tipos de eventos para CodeDeploy aplicativos.
```
aws codestar-notifications list-event-types --filters Name=SERVICE_NAME,Value=CodeDeploy
```
1. O comando gerará uma saída semelhante à seguinte:
```
{
"EventTypes": [
{
"EventTypeId": "codedeploy-application-deployment-succeeded",
"ServiceName": "CodeDeploy",
"EventTypeName": "Deployment: Succeeded",
"ResourceType": "Application"
},
{
"EventTypeId": "codedeploy-application-deployment-failed",
"ServiceName": "CodeDeploy",
"EventTypeName": "Deployment: Failed",
"ResourceType": "Application"
},
{
"EventTypeId": "codedeploy-application-deployment-started",
"ServiceName": "CodeDeploy",
"EventTypeName": "Deployment: Started",
"ResourceType": "Application"
}
]
}
```
# Como adicionar uma tag a uma regra de notificação (AWS CLI)
1. Em um terminal ou prompt de comando, execute o comando **tag-resource**. Por exemplo, use o comando a seguir para adicionar um par de chave-valor de tag que tenha o nome *Team* e o valor. *Li\$1Juan*
```
aws codestar-notifications tag-resource --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/fe1efd35-EXAMPLE --tags Team=Li_Juan
```
1. O comando gerará uma saída semelhante à seguinte:
```
{
"Tags": {
"Team": "Li_Juan"
}
}
```