本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 訂閱 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** (執行個體)。您必須選擇來源類型。

**要包含的*資源***  
正在產生事件的 Amazon RDS 資源。例如，您可以選擇 **Select specific instances** (選取特定執行個體) 然後選擇 **myDBInstane1**。

下表說明了指定或不指定**要包含的*資源***時的結果。


|  要包含的資源  |  描述  |  範例  | 
| --- | --- | --- | 
|  指定  |  RDS 只會通知您指定資源的所有資料庫執行個體事件。  | 如果您的 Source type (來源類型) 是 Instances (執行個體)，您的資源是 myDBInstance1，RDS 只會通知您有關 myDBInstance1。 | 
|  未指定  |  您會收到所有 Amazon RDS 資源中指定來源類型事件的通知。  |  如果您的 **Source type** (來源類型) 是 **Instances** (執行個體)，RDS 會通知您帳戶中所有與執行個體相關的事件。  | 

根據預設，Amazon SNS 主題訂閱者會接收發佈到主題的每個訊息。若要僅接收一部分的訊息，訂閱者必須將篩選政策指派給主題訂閱。如需有關 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 管理主控台，開啟位於 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) 的 Amazon RDS 主控台。

1. 在導覽窗格中，選擇 **Event subscriptions** (事件訂閱)。

1. 在 **Event subscriptions (事件訂閱)** 窗格中，選擇 **Create event subscription (建立事件訂閱)**。

1. 輸入您的訂閱詳細資訊，如下所示：

   1. 在 **Name (名稱)** 中，輸入事件通知訂閱的名稱。

   1. 對於 **Send notification to:** (傳送通知給：)，執行以下其中一項：
      + 選擇 **New email topic** (新的電子郵件主題)。輸入電子郵件主題的名稱和收件者清單。建議您將事件訂閱設定為與主要帳戶聯絡人相同的電子郵件地址。建議、服務事件和個人健康訊息會使用不同的通道傳送。訂閱相同電子郵件地址可確保所有郵件都合併在一個位置。
      + 選擇 **Amazon Resource Name (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. 在 **Source type (來源類型)** 中選擇來源類型。例如，選擇 **Instances** (執行個體) 或 **Parameter groups** (參數群組)。

   1. 選擇您要接收通知的事件類型和資源。

      下列範例設定名為 `testinst` 之資料庫執行個體的事件通知。  
![\[輸入來源類型\]](http://docs.aws.amazon.com/zh_tw/AmazonRDS/latest/UserGuide/images/event-source.png)

   1. 選擇 **Create** (建立)。

Amazon RDS 主控台顯示正在建立訂閱。

![\[列出資料庫事件通知訂閱\]](http://docs.aws.amazon.com/zh_tw/AmazonRDS/latest/UserGuide/images/EventNotification-Create2.png)


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

使用 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) 命令來訂閱 RDS 事件通知。包含下列必要參數：
+ `--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`