# 订阅 Amazon RDS 事件通知
<a name="USER_Events.Subscribing"></a>

最简单的订阅创建方法是使用 RDS 控制台。如果您选择使用 CLI 或 API 创建事件通知，则必须创建 Amazon Simple Notification Service 主题并订阅有关 Amazon SNS 控制台或 Amazon SNS API 的主题。您还必须保留该主题的 Amazon Resource Name (ARN)，因为在提交 CLI 命令或者 API 操作时会用到。有关创建和订阅 SNS 主题的信息，请参阅 *Amazon Simple Notification Service 开发人员指南*中的 [Amazon SNS 入门](https://docs.aws.amazon.com/sns/latest/dg/GettingStarted.html)。

您可以指定希望收取其通知的源类型以及触发该事件的 Amazon RDS 源：

**Source type**（源类型）  
源类型。例如，**Source type**（源类型）可能是 **Instances**（实例）。必须选择一种源类型。

***Resources* to include**（要包含的资源）  
生成事件的 Amazon RDS 资源。例如，您可以选择 **Select specific instances**（选择特定实例），然后选择 **myDBInstance1**。

下表说明了指定或不指定 ***Resources* to include**（要包含的资源）时的结果。


|  要包含的资源  |  描述  |  示例  | 
| --- | --- | --- | 
|  指定  |  RDS 仅向您通知指定资源的所有事件。  | 如果 Source type（源类型）为 Instances（实例），资源为 myDBInstance1，则 RDS 仅向您通知 myDBInstance1 的所有事件。 | 
|  未指定  |  RDS 会向您通知所有 Amazon RDS 资源的指定源类型的事件。  |  如果 **Source type**（源类型）是 **Instances**（实例），RDS 会向您通知您的账户中所有与实例相关的事件。  | 

原定设置情况下，Amazon SNS 主题订阅用户会收到发布到该主题的每条消息。要仅接收一部分消息，订阅用户必须将筛选策略分配给主题订阅。有关更多信息，请参阅《Amazon Simple Notification Service 开发人员指南》**中的 [Amazon SNS 消息筛选](https://docs.aws.amazon.com/sns/latest/dg/sns-message-filtering.html)。

## 控制台
<a name="USER_Events.Subscribing.Console"></a>

**订阅 RDS 事件通知**

1. 登录 AWS 管理控制台 并通过以下网址打开 Amazon RDS 控制台：[https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)。

1. 在导航窗格中，选择**事件订阅**。

1. 在**事件订阅**窗格中，选择**创建事件订阅**。

1. 输入您的订阅详情，如下所示：

   1. 对于**名称**，输入事件通知订阅的名称。

   1. 对于 **Send notifications to**（发送通知到），执行以下操作之一：
      + 选择 **New email topic**（新建电子邮件主题）。输入电子邮件主题的名称和收件人列表。我们建议您将事件订阅配置为与主要账户联系人相同的电子邮件地址。建议、服务事件和个人健康信息是通过不同的渠道发送的。订阅同一个电子邮件地址可确保将所有邮件合并到一个位置。
      + 选择 **Amazon Resource Name (ARN)** [Amazon 资源名称（ARN）]。然后，为 Amazon SNS 主题选择现有的 Amazon SNS ARN。

        如果您想使用已启用服务器端加密 (SSE) 的主题，请向 Amazon RDS 授予访问 AWS KMS key 的必需权限。有关更多信息，请参阅《Amazon Simple Notification Service 开发人员指南》中的[实现 AWS 服务中的事件源与加密主题之间的兼容性](https://docs.aws.amazon.com/sns/latest/dg/sns-key-management.html#compatibility-with-aws-services)。

   1. 对于**源类型**，请选择一种源类型。例如，选择 **Instances**（实例）或 **Parameter groups**（参数组）。

   1. 选择要接收事件通知的事件类别和资源。

      以下示例为名为 `testinst` 的数据库实例配置事件通知。  
![\[输入源类型\]](http://docs.aws.amazon.com/zh_cn/AmazonRDS/latest/UserGuide/images/event-source.png)

   1. 选择**创建**。

Amazon RDS 控制台会表明正在创建订阅。

![\[列出数据库事件通知订阅\]](http://docs.aws.amazon.com/zh_cn/AmazonRDS/latest/UserGuide/images/EventNotification-Create2.png)


## AWS CLI
<a name="USER_Events.Subscribing.CLI"></a>

要订阅 RDS 事件通知，请使用 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/create-event-subscription.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-event-subscription.html) 命令。包括以下必需参数：
+ `--subscription-name`
+ `--sns-topic-arn`

**Example**  
对于 Linux、macOS 或 Unix：  

```
aws rds create-event-subscription \
    --subscription-name myeventsubscription \
    --sns-topic-arn arn:aws:sns:us-east-1:123456789012:myawsuser-RDS \
    --enabled
```
对于 Windows：  

```
aws rds create-event-subscription ^
    --subscription-name myeventsubscription ^
    --sns-topic-arn arn:aws:sns:us-east-1:123456789012:myawsuser-RDS ^
    --enabled
```

## API
<a name="USER_Events.Subscribing.API"></a>

要订阅 Amazon RDS 事件通知，请调用 Amazon RDS API 函数 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateEventSubscription.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateEventSubscription.html)。包括以下必需参数：
+ `SubscriptionName`
+ `SnsTopicArn`