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

# 使用 Amazon DocumentDB 事件订阅
<a name="event-subscriptions"></a>

Amazon DocumentDB 使用 Amazon Simple Notification Service (Amazon SNS) 在发生 Amazon DocumentDB 事件时提供通知。这些通知可以采用 Amazon SNS 支持的任何形式 AWS 区域，例如电子邮件、短信或对 HTTP 终端节点的调用。

Amazon DocumentDB 将这些事件分组为您可以订阅的类型，以便您在出现该类事件时收取通知。您可以针对实例、集群、快照、集群快照或参数组订阅事件类别。例如，如果您订阅给定实例的 Backup 类别，那么无论何时出现影响该实例的备份相关事件，您都将收到通知。您还将在事件订阅更改时收到通知。

事件在集群和实例级别发生。所以，如果您针对集群或实例进行订阅，将可收到事件。

事件订阅会发送到您在创建订阅时提供的地址。您可能希望创建多个不同的订阅，如使用一个订阅接收所有事件通知，并使用另一个订阅仅接收针对生产数据库实例的关键事件。您无需删除订阅即可轻松关闭通知。为此，请在 Amazon DocumentDB 控制台中将“**启用**” 单选按钮设置为“**否**”。

**重要**  
Amazon DocumentDB 不保证在事件流中发送的事件的顺序。事件顺序可能会发生变化。

Amazon DocumentDB 使用 Amazon SNS 主题的 Amazon 资源名称 (ARN) 标识每个订阅。Amazon DocumentDB 控制台在您创建订阅时为您创建 ARN。

通过 Amazon SNS 对 Amazon DocumentDB 活动订阅计费。Amazon SNS 费用在使用事件通知时适用。有关更多信息，请参阅 Amazon Simple Notification Service Pricing。除了 Amazon SNS 费用外， Amazon DocumentDB 对活动订阅不计费。

**Topics**
+ [订阅活动](event-subscriptions.subscribe.md)
+ [管理订阅](event-subscriptions.managing.md)
+ [类别和消息](event-subscriptions.categories-messages.md)

# 订阅 Amazon DocumentDB 事件
<a name="event-subscriptions.subscribe"></a>

您可以如下使用 Amazon DocumentDB 控制台订阅活动订阅：

1. 登录到 a AWS 管理控制台 t [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)。

1. 在导航窗格中，选择**事件订阅**。  
![\[Amazon DocumentDB 控制台导航窗格突出显示了“事件订阅”选项。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/event-subs/subscribe-event-subs.png)

1. 在**事件订阅**窗格中，选择**创建事件订阅**。  
![\[“事件订阅”窗格突出显示了右上角的“创建事件订阅”按钮。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/event-subs/subscribe-create.png)

1. 在**创建事件订阅**对话框中，请执行以下操作：
   + 对于**名称**，输入事件通知订阅的名称。  
![\[“创建事件订阅”表单，其中显示了“详细信息”部分和“名称”输入字段。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/event-subs/subscribe-name.png)
   + 对于**目标**，选择您想要发送通知到何处。您可以选择现有 **ARN** 或者选择 “**新建电子邮件主题**”来输入主题的名称和收件人列表。  
![\[“目标”部分包含用于指定将通知发送至何处的选项。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/event-subs/subscribe-target.png)
   + 对于**源**，请选择一种源类型。根据选定源类型的情况，选择您希望接收来自 事件通知的事件类别和源。  
![\[“源”部分用于选择要从中接收事件通知的源类型。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/event-subs/subscribe-source.png)
   + 选择**创建**。  
![\[“源”部分，其中“创建”按钮位于右下角。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/event-subs/subscribe-create-2.png)

# 管理 Amazon DocumentDB 事件通知订阅
<a name="event-subscriptions.managing"></a>

如果您在 Amazon DocumentDB 控制台的导航窗格中选择“**活动订阅**”，则可以查看订阅类别和您当前订阅的列表。您也可以修改或删除特定的订阅。

## 列出当前的 Amazon DocumentDB 事件通知订阅
<a name="event-subscriptions.modify"></a>

1. 登录到 a AWS 管理控制台 t [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)。

1. 在导航窗格中，选择**事件订阅**。**事件订阅**窗格中会显示您的所有事件通知订阅。  
![\[Amazon DocumentDB 控制台导航窗格突出显示了“事件订阅”选项。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/event-subs/modify-event-subs.png)

1. 在**事件订阅**窗格中，选择您要修改的订阅，然后选择**编辑**。  
![\[“事件订阅”窗格，其中显示了所选订阅和“编辑”按钮。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/event-subs/modify-edit.png)

1. 在**目标**或**来源**部分中对订阅进行更改。您可以通过在源部分选择或取消选择源标识符来添加或删除它们。  
![\[“修改事件订阅”表单突出显示了“目标”部分。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/event-subs/modify-target.png)

1. 选择 **Modify**(修改)。Amazon DocumentDB 控制台会表明正在修改订阅。  
![\[“修改事件订阅”表单的末尾突出显示了“修改”按钮。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/event-subs/modify-button.png)

## 删除 Amazon DocumentDB 事件通知订阅
<a name="event-subscriptions.delete"></a>

当您不再需要时，可以删除订阅。该主题的所有用户都将再也不会收到订阅指定的事件通知。

1. 登录到 a AWS 管理控制台 t [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)。

1. 在导航窗格中，选择**事件订阅**。  
![\[Amazon DocumentDB 控制台导航窗格突出显示了“事件订阅”选项。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/event-subs/delete-event-subs.png)

1. 在 **事件订阅**窗格中，选择您希望删除的订阅。  
![\[“事件订阅”窗格，其中显示了所选订阅。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/event-subs/delete-select.png)

1. 选择**删除**。  
![\[“事件订阅”窗格突出显示了“删除”按钮。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/event-subs/delete-delete.png)

1. 将出现一个弹出窗口，询问您是否要永久删除此通知。选择**删除**。  
![\[用于确认删除事件订阅的对话框，其中右下角突出显示了“删除”按钮。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/event-subs/delete-delete-2.png)

# Amazon DocumentDB 事件类别和消息
<a name="event-subscriptions.categories-messages"></a>

Amazon DocumentDB 会在各种类型中生成许多事件，您可以使用 控制台对它们进行订阅。每个类别应用于一种源类型，可以是实例、集群、快照或参数组。

**注意**  
亚马逊 DocumentDB 使用现有的亚马逊 RDS 事件定义和。 IDs

## 源自实例的 Amazon DocumentDB 活动
<a name="event-subscriptions.db-origin"></a>


| 类别 | 说明 | 
| --- | --- | 
| 可用性 | 实例已重启。 | 
| 可用性 | 实例已关闭。 | 
| 配置更改 | 将修改应用于实例类。 | 
| 配置更改 | 已完成将修改应用于实例类。 | 
| 配置更改 | 重置主凭证。 | 
| 创建 | 实例已创建。 | 
| 删除 | 已删除实例 | 
| 失败 | 由于某个不兼容配置或底层存储问题，实例已失败。从 point-in-time-restore实例开始。 | 
| notification | 实例已停止。 | 
| notification | 实例已启动。 | 
| notification | 实例由于它超过最大允许停止的时间而正被启动。 | 
| 恢复 | 已启动实例的还原。恢复时间会随待恢复数据量的变化而变化。 | 
| 恢复 | 实例的恢复已完成。 | 
| 安全修补 | 操作系统更新可用于您的实例。有关应用更新的信息，请参阅[维护 Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html)。 | 

## 源自集群的 Amazon DocumentDB 活动
<a name="event-subscriptions.cluster-origin"></a>


| 类别 | 说明 | 
| --- | --- | 
| 创建 | 已创建集群 | 
| 删除 | 已删除集群。 | 
| 故障转移 | 再次提升之前的主实例。 | 
| 故障转移 | 已完成到实例的失效转移。 | 
| 故障转移 | 已开始失效转移到数据库实例：%s | 
| 故障转移 | 已开始将同一可用区失效转移到实例：%s | 
| 故障转移 | 已开始跨可用区失效转移到实例：%s | 
| maintenance | 集群已修补。 | 
| maintenance | 数据库集群处于无法升级的状态：%s | 
| notification | 已停止集群。 | 
| notification | 已启动库集群。 | 
| notification | 集群停止失败。 | 
| notification | 集群将由于它超过最大允许停止的时间而正被启动。 | 
| notification | 将群集从 %s 重命名为 %s。 | 

## 源自集群快照的 Amazon DocumentDB 活动
<a name="event-subscriptions.snapshot-origin"></a>

下表显示了 Amazon DocumentDB 集群快照为源类型时的事件类别和事件列表。


| 类别 | 说明 | 
| --- | --- | 
| 备份 | 正在创建手动集群快照。 | 
| 备份 | 已创建手动集群快照。 | 
| 备份 | 正在创建自动集群快照。 | 
| 备份 | 已创建自动集群快照。 | 

## 源自参数组的 Amazon DocumentDB 活动
<a name="event-subscriptions.parameter"></a>

下表显示的是参数组为源类型时的事件类型和事件列表。


| 类别 | 说明 | 
| --- | --- | 
| 配置更改 | 借助应用方法 %s 将参数 %s 更新为 %s |