本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 为存储库创建通知规则
<a name="getting-started-repository"></a>

您可以创建通知规则，以发送有关对您很重要的存储库事件的通知。以下步骤显示如何在单个存储库事件上设置通知规则。这些步骤是在假设您的 AWS 账户中配置了存储库的情况下编写的。

**重要**  
如果您在 2019 年 11 月 5 日 CodeCommit 之前设置了通知，则用于这些通知的 Amazon SNS 主题将包含一项允许 CodeCommit 向其发布的策略，该策略包含的权限与通知所需的 AWS CodeStar 权限不同。建议不使用这些主题。如果要使用为该体验创建的策略，则除了已有的 AWS CodeStar 通知策略外，还必须添加所需的通知策略。有关更多信息，请参阅[配置通知的 Amazon SNS 主题](set-up-sns.md)和[了解通知内容和安全性](security.md#security-notifications)。

1. 打开 CodeCommit 控制台，网址为[https://console.aws.amazon.com/codecommit/](https://console.aws.amazon.com/codecommit/)。

1. 从列表中选择一个存储库并将其打开。

1. 选择 **Notify (通知)**，然后选择 **Create notification rule (创建通知规则)**。您也可以依次选择 **Settings (设置)**、**Notifications (通知)** 和 **Create notification rule (创建通知规则)**。

1. 在 **Notification name（通知名称）**中，输入规则的名称。

1. 如果您只想在通知中 EventBridge 包含提供给 Amazon 的信息，请在 “**详情类型**” 中选择 “**基本**”。如果您想包括提供给 Amazon 的信息 EventBridge 以及可能由资源服务或通知管理器提供的信息，请选择 “**完整**”。

   有关更多信息，请参阅 [了解通知内容和安全性](security.md#security-notifications)。

1. 在 **Events that trigger notifications (触发通知的事件)** 中的 **Branches and tags (分支和标签)** 下，选择 **Created (已创建)**。

1. 在 **Targets（目标）**中，选择 **Create SNS topic（创建 SNS 主题）**。
**注意**  
当您在创建通知规则的过程中创建主题时，将应用允许 CodeCommit 向该主题发布事件的策略。使用为通知规则创建的主题有助于确保您仅订阅要接收有关此存储库的通知的那些用户。

   在 **codestar-notifications-** 前缀后面，输入主题的名称，然后选择 **Submit（提交）**。
**注意**  
如果要使用现有 Amazon SNS 主题而不是创建新主题，请在 **Targets (目标)** 中选择其 ARN。请确保主题具有适当的访问策略，并且订阅者列表仅包含允许查看有关资源的信息的用户。如果 Amazon SNS 主题是在 2019 年 11 月 5 日之前用于 CodeCommit 通知的主题，则该主题将包含一项允许 CodeCommit 向其发布的政策，该策略包含的权限与通知所需的 AWS CodeStar 权限不同。建议不使用这些主题。如果要使用为该体验创建的策略，则除了已有的 AWS CodeStar 通知策略外，还必须添加所需的通知策略。有关更多信息，请参阅[配置通知的 Amazon SNS 主题](set-up-sns.md)和[了解通知内容和安全性](security.md#security-notifications)。

1. 选择 **Submit (提交)**，然后查看通知规则。

1. 以您的电子邮件地址订阅您刚创建的 Amazon SNS 主题。有关更多信息，请参阅 [为用户订阅用于通知的 Amazon SNS 主题](subscribe-users-sns.md#set-up-sns-subscribe)。

1. 导航到您的存储库并从原定设置分支创建测试分支。

1. 创建分支后，通知规则会向所有主题订阅者发送通知，其中包含有关事件的信息。