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

# 教學課程：使用 Amazon EventBridge 發生事件時傳送電子郵件
<a name="eb-s3-object-created-tutorial"></a>

當使用 Amazon EventBridge 和 [Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/welcome.html) 建立 [Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) 物件時，您可以傳送電子郵件通知。在本教學課程中，您將建立 SNS 主題和訂閱。然後，您將在 EventBridge 主控台中建立[規則](eb-rules.md)，該規則會在收到 Amazon S3 `Object Created` 事件時將[事件](eb-events.md)傳送至該主題。

**Topics**
+ [先決條件](#eb-s3-object-created-tutorial-prerequisite)
+ [步驟 1：建立 Amazon SNS 主題](#eb-s3-object-created-tutorial-create-topic)
+ [步驟 2：建立 Amazon SNS 訂閱](#eb-s3-object-created-tutorial-create-sns)
+ [步驟 3：建立規則](#eb-s3-object-created-tutorial-create-rule)
+ [步驟 4：測試規則](#eb-s3-object-created-tutorial-test-rule)
+ [步驟 5：清除您的資源](#cleanup)

## 先決條件
<a name="eb-s3-object-created-tutorial-prerequisite"></a>

若要在 EventBridge 接收 Amazon S3 事件，您必須在 Amazon S3 主控台中啟用 EventBridge。本教學課程假設 EventBridge 已啟用。如需詳細資訊，請參閱 [S3 主控台中啟用 Amazon EventBridge](https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-event-notifications-eventbridge.html)。

## 步驟 1：建立 Amazon SNS 主題
<a name="eb-s3-object-created-tutorial-create-topic"></a>

建立主題以接收來自 EventBridge 的事件。

**若要建立主題**

1. 在 [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home) 開啟 Amazon SNS 主控台。

1. 在導覽窗格中，選擇**主題**。

1. 請選擇**建立主題**。

1. 針對**類型**，選擇**標準**。

1. 輸入 **eventbridge-test**，作為主題的名稱。

1. 請選擇**建立主題**。

## 步驟 2：建立 Amazon SNS 訂閱
<a name="eb-s3-object-created-tutorial-create-sns"></a>

建立訂閱以在主題收到事件時從 Amazon S3 取得電子郵件通知。

**若要建立訂閱**

1. 在 [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home) 開啟 Amazon SNS 主控台。

1. 在導覽窗格中，選擇**訂閱**。

1. 選擇**建立訂閱**。

1. 在**主題 ARN** 中，選擇您在步驟 1 建立的主題。在本教學課程中，選擇 **eventbridge-test**。

1. 對於**通訊協定**，選擇**電子郵件**。

1. 針對 **Endpoint (端點)**，輸入電子郵件地址。

1. 選擇**建立訂閱**。

1. 透過從 AWS 通知收到的電子郵件中選擇**確認訂閱**，以確認訂閱。

## 步驟 3：建立規則
<a name="eb-s3-object-created-tutorial-create-rule"></a>

建立 Amazon S3 物件時，建立將事件傳送至您的主題的規則。

**建立規則**

1. 前往 [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) 開啟 Amazon EventBridge 主控台。

1. 在導覽窗格中，選擇**規則**。

1. 選擇**建立規則**。

1. 輸入規則的名稱和描述。例如，命名規則 `s3-test`

1. 針對**事件匯流排**，選取**預設值**。

1. 針對**規則類型**，選擇**具有事件模式的規則**。

1. 選擇**下一步**。

1. 在**事件來源**欄位中，選擇 **AWS 事件或 EventBridge 合作夥伴事件**。

1. 針對**建立方法**，選取**使用模式表單**。

1. 針對**事件模式**，請執行下列動作：

   1. 針對**事件來源**，請從下拉式清單中選取 **AWS 服務**。

   1. 針對 **AWS 服務**，請從下拉式清單中選取 **Simple Storage Service (S3)**。

   1. 針對**事件類型**，請從下拉式清單中選擇 **Amazon S3 事件通知**。

   1. 選擇**特定事件**並從下拉式清單中選擇**建立物件**。

   1. 選擇**任何儲存貯體**。

1. 選擇**下一步**。

1. 在**目標類型**欄位中，選擇 **AWS 服務**。

1. 針對**選取目標**，從下拉式清單中選擇 **SNS 主題**。

1. 針對**主題**，選取您在**步驟 1：建立 SNS 主題**區段中建立的 Amazon SNS 主題。在此範例中，選取 `eventbridge-test`。

1. 選擇**下一步**。

1. 選擇**下一步**。

1. 檢閱規則的詳細資訊，然後選擇**建立規則**。

## 步驟 4：測試規則
<a name="eb-s3-object-created-tutorial-test-rule"></a>

若要測試您的規則，請將檔案上傳到啟用 EventBridge 的儲存貯體，以建立 Amazon S3 物件。然後，請稍待幾分鐘並確認您是否收到來自 AWS 通知的電子郵件。

## 步驟 5：清除您的資源
<a name="cleanup"></a>

除非您想要保留為此教學課程建立的資源，否則您現在便可刪除。透過刪除您不再使用 AWS 的資源，您可以避免 AWS 帳戶產生不必要的費用。

**刪除 SNS 主題**

1. 開啟 SNS 主控台的[主題頁面](https://console.aws.amazon.com/sns/v3/home#/topics)。

1. 選取您建立的主題。

1. 選擇**刪除**。

1. 輸入 **delete me**。

1. 選擇**刪除**。

**刪除 SNS 訂閱**

1. 在 SNS 主控台開啟[訂閱頁面](https://console.aws.amazon.com/sns/v3/home#/subscriptions)。

1. 選取您建立的訂閱。

1. 選擇**刪除**。

1. 選擇**刪除**。

**刪除 EventBridge 規則**

1. 開啟 EventBridge 主控台的[規則頁面](https://console.aws.amazon.com/events/home#/rules)。

1. 選取您建立的規則。

1. 選擇**刪除**。

1. 選擇**刪除**。