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

# 使用 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 Resource Name (ARN) 來識別每個訂閱。Amazon DocumentDB 主控台會在您建立訂閱時為您建立 ARN。

Amazon DocumentDB 事件訂閱的計費是透過 Amazon SNS。使用事件通知需要支付 Amazon SNS 費用。如需詳細資訊，請參閱 Amazon Simple Notification Service 定價。除了 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. 在 登入 AWS 管理主控台 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)。

1. 在導覽窗格中，選擇 **Event subscriptions** (事件訂閱)。  
![\[反白顯示事件訂閱選項的 Amazon DocumentDB 主控台導覽窗格。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/event-subs/subscribe-event-subs.png)

1. 在 **Event subscriptions (事件訂閱)** 窗格中，選擇 **Create event subscription (建立事件訂閱)**。  
![\[事件訂閱窗格反白顯示右上角的建立事件訂閱按鈕。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/event-subs/subscribe-create.png)

1. 在 **Create event subscription** (建立事件訂閱) 對話方塊中，執行下列動作：
   + 在 **Name (名稱)** 中，輸入事件通知訂閱的名稱。  
![\[顯示詳細資訊區段和名稱輸入欄位的建立事件訂閱表單。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/event-subs/subscribe-name.png)
   + 針對**目標**，選擇您要傳送通知的目標。您可以選擇現有的 **ARN** 或選擇**新增電子郵件主題**，以輸入主題的名稱和收件人清單。  
![\[目標區段，包含可指定通知傳送目的地的選項。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/event-subs/subscribe-target.png)
   + 針對**來源**，選擇來源類型。根據您選擇的來源類型，選擇事件類別以及您要從中接收事件通知的來源。  
![\[要選取要接收事件通知的來源類型來源區段。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/event-subs/subscribe-source.png)
   + 選擇**建立**。  
![\[來源區段，加上右下角的建立按鈕。\]](http://docs.aws.amazon.com/zh_tw/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. 在 登入 AWS 管理主控台 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)。

1. 在導覽窗格中，選擇 **Event subscriptions** (事件訂閱)。**Event subscriptions (事件訂閱)** 窗格顯示所有事件通知訂閱。  
![\[反白顯示事件訂閱選項的 Amazon DocumentDB 主控台導覽窗格。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/event-subs/modify-event-subs.png)

1. 在 **Event subscriptions (事件訂閱)** 窗格中，選擇您要修改的訂閱，然後選擇 **Edit (編輯)**。  
![\[事件訂閱窗格顯示選取的訂閱和編輯按鈕。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/event-subs/modify-edit.png)

1. 在 **Target (目標)** 或 **Source (來源)** 區段中，對訂閱進行變更。您可以新增或移除來源識別符，方法是在來源區段中選取或取消選取它們。  
![\[反白目標區段的修改事件訂閱表單。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/event-subs/modify-target.png)

1. 選擇 **Modify** (修改)。Amazon DocumentDB 主控台指出正在修改訂閱。  
![\[修改事件訂閱表單結尾，並反白顯示修改按鈕。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/event-subs/modify-button.png)

## 刪除 Amazon DocumentDB 事件通知訂閱
<a name="event-subscriptions.delete"></a>

您可以刪除不再需要的訂閱。該主題的所有訂閱者將不會再收到該訂閱指定的事件通知。

1. 在 登入 AWS 管理主控台 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)。

1. 在導覽窗格中，選擇 **Event subscriptions** (事件訂閱)。  
![\[反白顯示事件訂閱選項的 Amazon DocumentDB 主控台導覽窗格。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/event-subs/delete-event-subs.png)

1. 在**事件訂閱**窗格中，選擇您要刪除的訂閱。  
![\[事件訂閱窗格顯示選取的訂閱。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/event-subs/delete-select.png)

1. 選擇 **刪除**。  
![\[事件訂閱窗格反白顯示刪除按鈕。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/event-subs/delete-delete.png)

1. 隨即出現快顯視窗，詢問您是否要永久刪除此通知。選擇 **刪除**。  
![\[確認刪除事件訂閱的對話方塊，並在右下角反白顯示刪除按鈕。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/event-subs/delete-delete-2.png)

# Amazon DocumentDB 事件類別和訊息
<a name="event-subscriptions.categories-messages"></a>

Amazon DocumentDB 在您可以使用主控台訂閱的類別中產生大量事件。每個類別都適用於來源類型，可以是執行個體、叢集、快照或參數群組。

**注意**  
Amazon DocumentDB 使用現有的 Amazon 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 | 
| 容錯移轉 | 已啟動相同的 AZ 容錯移轉至資料庫執行個體：%s | 
| 容錯移轉 | 已開始跨可用區容錯移轉至資料庫執行個體：%s | 
| 維護 | 叢集已修補。 | 
| 維護 | 資料庫叢集處於無法升級的狀態：%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 |