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

# 配置存储库通知
<a name="how-to-repository-email-create"></a>

您可以通过配置通知来确保存储库用户收到存储库事件的通知。在配置通知时，订阅用户将收到有关您指定的事件的电子邮件，例如在有人对某个提交发表评论时。

通知事件类型分为以下类别：
+ **Pull request update events**：如果您选择此选项，则在以下情况下，用户会收到电子邮件：
  + 创建或关闭拉取请求。
  + 使用代码更改更新拉取请求。
  + 拉取请求的标题或说明发生更改。
+ **Pull request comment events**：如果您选择此选项，则当有人在拉取请求中发表评论或回复评论时，用户会收到电子邮件。
+ **Commit comment events**：如果您选择此选项，则当有人对拉取请求外的提交发表评论时，用户会收到电子邮件。这包括对以下内容的评论：
  + 提交中的代码行。
  + 提交中的文件。
  + 提交本身。

  有关更多信息，请参阅 [评论提交](how-to-commit-comment.md)。

要使用 Amazon CodeCommit 控制台为中的存储库配置通知 CodeCommit，您必须将以下托管策略或等效权限附加到您的 IAM 用户：
+ **CloudWatchEventsFullAccess**
+ **亚马逊SNSFull访问权限**

**注意**  
等效权限包含在 **AWSCodeCommitFullAccess** 策略中，配置存储库通知时需要此策略。如果您已应用此策略，则不需要其他两个策略。如果您应用了自定义策略，则可能需要对其进行修改以包含 CloudWatch 活动和 Amazon SNS 所需的权限。<a name="how-to-repository-email-create-configure-console"></a>

**为存储库配置通知**

1. 在 [https://console.aws.amazon.com/codesuite/codemmit](https://console.amazonaws.cn/codesuite/codecommit/home) /home 打开 CodeCommit 控制台。

1. 在 **Repositories (存储库)** 中，选择要在其中配置通知的存储库的名称。

1. 在导航窗格中，选择**设置**。选择**通知**。

1. 选择**设置**。

1. 选择要包含在存储库 CloudWatch 事件规则中的事件类型。  
![在 CodeCommit 存储库中配置通知](http://docs.amazonaws.cn/codecommit/latest/userguide/images/codecommit-notifications-configuring.png)

1. 在 **SNS 主题**中，从您的 Amazon Web Services 账户的 Amazon SNS 主题列表中选择一个主题，或者创建一个主题以供此存储库使用。
**注意**  
如果您创建一个主题，则可以从 CodeCommit 控制台管理该策略的订阅。如果您使用了现有主题，则无法管理该主题的订阅，除非您有权管理 Amazon SNS 中所有主题的订阅。有关更多信息，请参阅 [Amazon Simple Notification Service 开发人员指南](https://docs.amazonaws.cn/sns/latest/dg/)。

   如果您创建一个主题，请在**主题名称**中，在下划线后输入该主题的名称。（已为您输入主题名称的第一部分。请保留名称的第一部分）。在**显示名称**中，输入可选的短名称。选择**创建**。

1. 要添加存储库用户的电子邮件地址，请在 **Subscribers (订阅者)** 中选择 **Add (添加)**。在**添加电子邮件订阅者**中，输入存储库用户的电子邮件地址，然后选择**保存**。一次只能添加一个电子邮件地址。
**注意**  
当您选择 **Save** 时，将向该地址发送一封确认电子邮件。不过，当您还在 **Manage subscriptions** 中时，订阅状态不会更新。

   在将所有电子邮件地址添加到订阅者列表中后，选择 **Close**。
**提示**  
Amazon SNS 会协调和管理到订阅端点以及电子邮件地址的消息传输和发送。终端节点包括 Web 服务器、电子邮件地址、Amazon 简单队列服务队列和 Amazon Lambda 函数。有关更多信息，请参阅《Amazon SNS 开发人员指南》**中的[什么是 Amazon Simple Notification Service？](https://docs.amazonaws.cn/sns/latest/dg/welcome.html)和[将 Amazon SNS 消息发送到 HTTP/HTTPS 端点](https://docs.amazonaws.cn/sns/latest/dg/SendMessageToHttp.html)。

1. 要完成通知配置，请选择 **Save**。

为存储库配置通知后，您可以查看为存储库自动创建 CloudWatch 的事件规则。

**重要**  
请勿编辑或删除此规则。更改或删除该规则可能会导致操作问题。例如，电子邮件可能不会发送到订阅者，或者您可能无法更改 CodeCommit 中存储库的通知设置。<a name="how-to-repository-email-view-rule"></a>

**查看存储库 CloudWatch 的事件规则**

1. 登录 Amazon Web Services 管理控制台 并打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.amazonaws.cn/cloudwatch/)。

1. 在导航栏中，在 **Events** 下选择 **Rules**。

1. 选择您的存储库的规则。规则名称显示在存储库设置中的 **Notifications** 选项卡上。

1. 查看规则摘要信息。
**重要**  
 请勿编辑、删除或禁用此规则。