本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 設定 Amazon SES 事件發佈 本節說明設定 Amazon SES 將電子郵件傳送事件發佈至下列 AWS 服務時需要執行的動作： + Amazon CloudWatch + Amazon Data Firehose + Amazon Pinpoint + Amazon Simple Notification Service (Amazon SNS) 下列主題涵蓋設定事件發佈所需的下列步驟： 1. 您必須使用 Amazon SES 主控台或 API 來建立*組態集*。 1. 將一或多個*事件目的地* (CloudWatch、Firehose、Pinpoint 或 SNS) 新增至組態設定，並設定事件目的地唯一的參數。 1. 在傳送電子郵件時指定使用包含事件目的地的組態集。 **Topics** + [步驟 1：建立組態設定](event-publishing-create-configuration-set.md) + [步驟 2：新增事件目的地](event-publishing-add-event-destination.md) + [步驟 3：在傳送電子郵件時指定您的組態設定](event-publishing-send-email.md) # 步驟 1：建立組態設定 您必須先有組態集，才能設定事件發佈。如果您還沒有組態集，或想要建立新組態集，請參閱 [在 SES 中建立組態集](creating-configuration-sets.md) 您也可以使用 Amazon SES API V2 或 Amazon SES CLI v2 中的 [CreateConfigurationSet](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateConfigurationSet.html) 作業來建立組態集，請參閱 [建立組態集 (AWS CLI)](creating-configuration-sets.md#config-sets-create-cli)。 # 步驟 2：新增事件目的地 事件目的地是您發佈 Amazon SES 事件的地方。您所設定的每個事件目的地皆僅屬於一個且是唯一的組態設定。當您使用 Amazon SES 設定事件目的地時，您可以選擇 AWS 服務目的地，並指定與該目的地相關聯的參數。 設定事件目的地時，您可以選擇將事件傳送至下列其中一個 AWS 服務： + Amazon CloudWatch + Amazon Data Firehose + Amazon EventBridge + Amazon Pinpoint + Amazon Simple Notification Service (Amazon SNS) 您選擇的事件目的地取決於您所需的事件相關詳細資訊程度，以及您想要接收事件資訊的方法。如果您只想要每種事件的計算加總 (例如，可用於設定總數過高時的警示)，可以使用 CloudWatch。 如果您想要可以輸出到其他服務的詳細事件記錄，例如 Amazon OpenSearch Service 或 Amazon Redshift 進行分析，您可以使用 Firehose。 如果您想要在特定事件發生時收到通知，可以使用 Amazon SNS。 **Topics** + [設定事件發佈的 CloudWatch 事件目的地](event-publishing-add-event-destination-cloudwatch.md) + [為 Amazon SES 事件發佈設定 Data Firehose 事件目的地](event-publishing-add-event-destination-firehose.md) + [設定事件發佈的 Amazon EventBridge 目的地](event-publishing-add-event-destination-eventbridge.md) + [為事件發佈設定 Amazon Pinpoint 事件目的地](event-publishing-add-event-destination-pinpoint.md) + [為事件發佈設定 Amazon SNS 事件目的地](event-publishing-add-event-destination-sns.md) # 設定事件發佈的 CloudWatch 事件目的地 有 [Amazon CloudWatch 指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)，您可以使用事件目的地將 Amazon SES 電子郵件傳送事件發佈到 CloudWatch。由於 CloudWatch 事件目的地只能在組態集中設定，您必須先[建立組態集](event-publishing-create-configuration-set.md)，然後將事件目的地新增至組態集。 當您新增 CloudWatch 事件目的地到組態集時，必須選擇一或多個 CloudWatch *維度*，以對應到您傳送電子郵件時使用的訊息標籤。與訊息標籤相同，CloudWatch 維度是一組用來唯一辨識指標的名稱/值組。 例如，您可能有一個訊稱為 `campaign` 的訊息標籤與維度，用於識別您的電子郵件行銷活動。將電子郵件傳送事件發佈到 CloudWatch 時，選擇您的訊息標籤和維度非常重要，因為這些選項將影響 CloudWatch 計費，並決定您可如何在 CloudWatch 中篩選電子郵件傳送事件資料。 此章節提供的資訊可協助您選擇維度，然後說明如何新增 CloudWatch 事件目的地到組態集。 **Topics** + [新增 CloudWatch 事件目的地](#event-publishing-add-event-destination-cloudwatch-add) + [選擇 CloudWatch 維度](#event-publishing-add-event-destination-cloudwatch-dimensions) ## 新增 CloudWatch 事件目的地 本節中的程序說明如何新增 CloudWatch 事件目的地詳細資訊到組態集，並假設您已完成 [建立事件目的地](event-destinations-manage.md#event-destination-add) 中的步驟 1 至 6。 您也可以使用 Amazon SES API V2 中的 [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html) 作業來建立和修改事件目的地。 **若要使用主控台將 CloudWatch 事件目的地詳細資訊新增到組態集** 1. 以下是有關選擇 CloudWatch 作為您的事件目的地類型的詳細說明，請參閱 [步驟 7](event-destinations-manage.md#specify-event-dest-step)，並假定您已完成 [建立事件目的地](event-destinations-manage.md#event-destination-add) 中的先前步驟。選取 CloudWatch **目的地類型**、輸入目的地**名稱**並啟用**事件發佈**後，會顯示 **Amazon CloudWatch 維度**窗格，其欄位會在下列步驟中處理。*（需支付額外費用，請參閱 [ CloudWatch 的每個指標價格](#cw-add-pricing)。)* 1. 針對 **Value Source (值來源)**，指定 Amazon SES 如何取得要傳遞給 CloudWatch 的資料。可使用以下值來源： + **Message Tag (訊息標籤)** - Amazon SES 會從您使用 `X-SES-MESSAGE-TAGS` 標頭或 `EmailTags` API 參數指定的標籤中擷取維度名稱與值。如需如何使用訊息標籤的詳細資訊，請參閱[步驟 3：在傳送電子郵件時指定您的組態設定](event-publishing-send-email.md)。 **注意** 訊息標籤可以包含數字 0-9、字母 A-Z (包括大小寫)、連字號 (-) 和底線 (\$1)。 您也可以使用 **Message Tag (訊息標籤)** 值來源，依據 Amazon SES 自動標籤來建立維度。若要使用自動標籤，請輸入自動標籤的完整名稱以做為 **Dimension Name (維度名稱)**。例如，若要根據組態集自動標籤來建立維度，請使用 `ses:configuration-set` 做為 **Dimension Name (維度名稱)**，並使用組態集的名稱做為 **Default Value (預設值)**。如需自動標籤的完整清單，請參閱[事件發佈如何與組態集和訊息標籤搭配使用](monitor-using-event-publishing.md#event-publishing-how-works)。 + **Email Header (電子郵件標頭)** - Amazon SES 從電子郵件的標頭擷取維度名稱和值。 **注意** 您無法使用下列任何電子郵件標頭做為 **Dimension Name (維度名稱)**：`Received`、`To`、`From`、`DKIM-Signature`、`CC`、`message-id` 或 `Return-Path`。 + **Link Tag (連結標籤)** - Amazon SES 從您在連結中指定的標籤擷取維度名稱和值。如需有關新增標籤至連結的詳細資訊，請參閱 [我可以使用獨特的識別碼來標籤連結嗎？](faqs-metrics.md#sending-metric-faqs-clicks-q5)。 1. 針對 **Dimension Name (維度名稱)**，輸入您要傳遞給 CloudWatch 的維度名稱。 **注意** 維度名稱只能包含 ASCII 字母 (a-z、A-Z)、數字 (0-9)、底線 (\$1) 和破折號 (-)。不可使用空格、重音字元、非 Latin 字元和其他特殊字元。 1. 針對 **Default Value (預設值)**，輸入維度的值。 **注意** 維度值只能包含 ASCII 字母 (a-z、A-Z)、數字 (0-9)、底線 (\$1)、破折號 (-)、@ 符號 (@) 和句號 (.)。不可使用空格、重音字元、非 Latin 字元和其他特殊字元。 1. 如果您希望新增更多維度，請選擇 **Add Dimension (新增維度)**。否則請選擇 **Next (下一步)**。/ 1. 在審核畫面上，如果您對定義活動目的地的方式感到滿意，請選擇 **Add destination (新增目的地)**。 ## 選擇 CloudWatch 維度 當您選擇名稱和值做為 CloudWatch 維度使用時，請考慮以下因素： + **每個指標的價格** - 您可以在 CloudWatch 中免費檢視基本 Amazon SES 指標。不過，當您使用事件發佈收集指標時，會產生 [CloudWatch 詳細監控](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-metrics-basic-detailed.html)成本。事件類型、維度名稱和維度值的每個唯一組合都會在 CloudWatch 中建立不同的指標。當您使用 CloudWatch、詳細監控時，您需要支付每個指標的費用。因此，您可能想要避免選擇可能需要許多不同值的維度。舉例來說，除非您非常有興趣追蹤「寄件人」網域的電子郵件傳送事件，否則不建議您定義 Amazon SES 自動標籤 `ses:from-domain` 的維度，因為它可能需要許多不同的值。如需詳細資訊，請參閱 [CloudWatch 定價](https://aws.amazon.com/cloudwatch/pricing)。 + **指標篩選** - 如果指標包含多個維度，您無法根據個別維度來存取 CloudWatch 中的指標。因此，為單一 CloudWatch 事件的目的地新增一個以上的維度前請謹慎思考。例如，如果您希望取得 `campaign` 以及 `campaign` 和 `genre` 組合的指標，您需要新增兩個事件目的地：一個只有 `campaign` 做為維度，而另一個使用 `campaign` 和 `genre` 做為維度。 + **維度值來源** - 除了使用 Amazon SES 專用標頭或傳入 API 的參數來指定您的維度外，也可以選擇讓 Amazon SES 從您自己的 MIME 訊息標頭取得維度值。若您已使用自訂標題且不想要變更電子郵件或對電子郵件傳送 API 的呼叫來根據標題值收集指標，便可使用此選項。如果您使用自己的 MIME 訊息標頭進行 Amazon SES 事件發佈，您用於 Amazon SES 事件發佈的標頭名稱和值，僅可包含字母 A 到 Z、數字 0 到 9、底線 (\$1)、@ 符號、連字號 (-) 和句號 (.)。如果您指定的標頭名稱或數值包含其他字元，電子郵件傳送呼叫仍會成功執行，但事件指標不會傳送至 Amazon CloudWatch。 如需 CloudWatch 概念的詳細資訊，請參閱 [Amazon CloudWatch 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html)中的 *Amazon CloudWatch 概念*。 # 為 Amazon SES 事件發佈設定 Data Firehose 事件目的地 Amazon Data Firehose 事件目的地代表將特定 Amazon SES 電子郵件傳送事件發佈至 Firehose 的實體。由於 Firehose 事件目的地只能在組態設定中設定，因此您必須先[建立組態設定](event-publishing-create-configuration-set.md)。接下來，您可以將事件目的地新增至該組態設定。 本節中的程序說明如何將 Firehose 事件目的地詳細資訊新增至組態設定，並假設您已完成 中的步驟 1 到 6[建立事件目的地](event-destinations-manage.md#event-destination-add)。 您也可以使用 Amazon SES API V2 中的 [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html) 作業來建立和更新事件目的地。 **使用主控台將 Firehose 事件目的地詳細資訊新增至組態設定** 1. 以下是在[步驟 7](event-destinations-manage.md#specify-event-dest-step) 中選取 Firehose 作為事件目的地類型的詳細說明，並假設您已完成 中的所有先前步驟[建立事件目的地](event-destinations-manage.md#event-destination-add)。選取 Firehose **目的地類型**、輸入目的地**名稱**並啟用**事件發佈**後，會顯示 **Amazon Data Firehose 交付串流**窗格，其欄位會在下列步驟中處理。 1. 針對**交付串流**，選擇現有的 Firehose 交付串流，或選擇**建立新串流**，以使用 Firehose 主控台建立新的串流。 如需有關使用 Firehose 主控台建立串流的資訊，請參閱[《Amazon Data Firehose 開發人員指南》中的建立 Amazon Kinesis Firehose 交付串流](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html)。 ** 1. 針對 **Identity and Access Management (IAM) 角色**，選擇 Amazon SES 有權代表您發佈至 Firehose 的 IAM 角色。您可以選擇現有的角色、由 Amazon SES 為您建立角色，或建立自己的角色。 如果您選擇現有角色或建立自己的角色，則必須手動修改角色的政策，以授予角色存取 Firehose 交付串流的許可，並授予 Amazon SES 擔任該角色的許可。如需範例政策，請參閱 [授予 Amazon SES 發佈至 Firehose 交付串流的許可](#event-publishing-add-event-destination-firehose-role)。 1. 選擇**下一步**。 1. 在審核畫面上，如果您對定義活動目的地的方式感到滿意，請選擇 **Add destination (新增目的地)**。 如需如何使用 `UpdateConfigurationSetEventDestination` API 新增 Firehose 事件目的地的詳細資訊，請參閱 [Amazon Simple Email Service API 參考](https://docs.aws.amazon.com/ses/latest/APIReference/API_UpdateConfigurationSetEventDestination.html)。 ## 授予 Amazon SES 發佈至 Firehose 交付串流的許可 若要讓 Amazon SES 將記錄發佈到您的 Firehose 交付串流，您必須使用 AWS Identity and Access Management (IAM) [角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)，並連接或修改角色的許可政策和信任政策。許可政策可讓角色將記錄發佈到您的 Firehose 交付串流，而信任政策可讓 Amazon SES 擔任該角色。 本節將提供兩項政策的範例。如需將政策連接至 IAM 角色的詳細資訊，請參閱 [IAM 使用者指南](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html)中的*修改角色*。 ### 許可政策 下列許可政策可讓 角色將資料記錄發佈到您的 Firehose 交付串流。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Action": [ "firehose:PutRecordBatch" ], "Resource": [ "arn:aws:firehose:us-east-1:111122223333:deliverystream/delivery-stream-name" ] } ] } ``` ------ 在上述範例政策中進行下列變更： + 將*交付區域*取代為您建立 Firehose 交付串流 AWS 的區域。 + 將 *111122223333* 取代為您的 AWS 帳戶 ID。 + 將 *delivery-stream-name* 取代為 Firehose 交付串流的名稱。 ### 信任政策 以下信任政策允許 Amazon SES 擔任此角色。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "AWS:SourceAccount": "111122223333", "AWS:SourceArn": "arn:aws:ses:delivery-region:111122223333:configuration-set/configuration-set-name" } } } ] } ``` ------ 在上述範例政策中進行下列變更： + 將*交付區域*取代為您建立 Firehose 交付串流 AWS 的區域。 + 將 *111122223333* 取代為您的 AWS 帳戶 ID。 + 將 *configuration-set-name* 取代為與 Firehose 交付串流相關聯的組態集名稱。 # 設定事件發佈的 Amazon EventBridge 目的地 Amazon EventBridge 事件目的地會通知您在組態設定中指定的電子郵件傳送事件。SES 會產生並傳送您在建立事件目的地時定義的電子郵件傳送事件至 EventBridge 預設事件匯流排。[事件匯流排](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html)是接收事件的路由器，可以將其交付到多個目的地。您可以在 中進一步了解如何整合電子郵件傳送事件與 Amazon EventBridge[使用 Amazon EventBridge 監控 SES 事件](monitoring-eventbridge.md)。由於 EventBridge 事件目的地只能在組態集中設定，您必須先[建立組態集](event-publishing-create-configuration-set.md)，才能將事件目的地新增至組態集。 本節中的程序說明如何將 EventBridge 事件目的地詳細資訊新增至組態設定，並假設您已完成 中的步驟 1 到 6[建立事件目的地](event-destinations-manage.md#event-destination-add)。 您也可以使用 Amazon SES API V2 中的 [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html) 作業來建立和修改事件目的地。 **使用主控台將 EventBridge 事件目的地詳細資訊新增至組態設定** 1. 以下是在[步驟 7](event-destinations-manage.md#specify-event-dest-step) 中選取 EventBridge 作為事件目的地類型的詳細說明，並假設您已完成 中的所有先前步驟[建立事件目的地](event-destinations-manage.md#event-destination-add)。選取 *Amazon EventBridge* **目的地類型**、輸入目的地**名稱**並啟用**事件發佈**後，會顯示 **Amazon EventBridge 事件匯流排**資訊窗格。 1. 選擇**下一步**。 1. 在審核畫面上，如果您對定義活動目的地的方式感到滿意，請選擇 **Add destination (新增目的地)**。這會開啟活動目的地的摘要頁面，其中的成功橫幅將確認您的活動目的地是否已成功建立或修改。 # 為事件發佈設定 Amazon Pinpoint 事件目的地 Amazon Pinpoint 事件目的地會通知您有關在組態設定中指定的電子郵件傳送事件。由於 Amazon Pinpoint 事件目的地只能在組態集中設定，您必須先[建立組態集](event-publishing-create-configuration-set.md)，才能將事件目的地新增至組態集。 本節中的程序說明如何新增 Amazon Pinpoint 事件目的地詳細資訊到組態集，並假設您已在 [建立事件目的地](event-destinations-manage.md#event-destination-add) 當中完成步驟 1 到 6。 您也可以使用 Amazon SES API V2 中的 [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html) 作業來建立和修改事件目的地。 您需要為在 Amazon Pinpoint 專案中設定的頻道類型支付額外費用。如需詳細資訊，請參閱 [Amazon Pinpoint 定價](https://aws.amazon.com/pinpoint/pricing/)。 **若要使用主控台新增 Amazon Pinpoint 事件目的地詳細資訊到組態設定** 1. 以下是有關選擇 Amazon Pinpoint 作為您的活動目的地類型的詳細說明，請參閱[步驟 7](event-destinations-manage.md#specify-event-dest-step)，並假設您已在 [建立事件目的地](event-destinations-manage.md#event-destination-add) 當中完成所有先前的步驟。 **注意** Amazon Pinpoint 不支援事件類型 **Delivery delays** (交付延遲) 或 **Subscriptions** (訂閱)。 選取 Amazon Pinpoint **目的地類型**、輸入目的地**名稱**並啟用**事件發佈**後，會顯示 **Amazon Pinpoint 專案詳細資訊**窗格，其欄位會在下列步驟中處理。 1. 對於 **Project** (專案)，請選擇現有的 Amazon Pinpoint 專案，或選擇**Create a new project in Amazon Pinpoint** (在 Amazon Pinpoint 中建立新專案) 建立新的專案。 如需有關建立專案的資訊，請參閱 *Amazon Pinpoint 使用者指南*中的[建立專案](https://docs.aws.amazon.com/pinpoint/latest/userguide/gettingstarted-create-project.html)。 1. 選擇**下一步**。 1. 在審核畫面上，如果您對定義活動目的地的方式感到滿意，請選擇 **Add destination (新增目的地)**。這會開啟活動目的地的摘要頁面，其中的成功橫幅將確認您的活動目的地是否已成功建立或修改。 # 為事件發佈設定 Amazon SNS 事件目的地 Amazon SNS 事件目的地會通知您有關在組態設定中指定的電子郵件傳送事件。由於 Amazon SNS 事件目的地只能在組態集中設定，您必須先[建立組態集](event-publishing-create-configuration-set.md)，才能將事件目的地新增至組態集。 本節中的程序說明如何新增 Amazon SNS 事件目的地詳細資訊到組態集，並假設您已在 [建立事件目的地](event-destinations-manage.md#event-destination-add) 當中完成步驟 1 到 6。 您也可以使用 Amazon SES API V2 中的 [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html) 作業來建立和修改事件目的地。 **注意** 還可以透過 Amazon SNS 為任何通過驗證的傳送身分，設定退信、投訴和遞送的意見回饋通知。如需詳細資訊，請參閱 [設定 Amazon SES 的 Amazon SNS 通知](configure-sns-notifications.md)。 傳送郵件至訂閱 Amazon SNS 主題的端點需支付額外的費用。如需詳細資訊，請參閱 [Amazon SNS 定價](https://aws.amazon.com/sns/pricing/)。 **若要使用主控台新增 Amazon SNS 事件目的地詳細資訊到組態設定** 1. 以下是有關選擇 Amazon SNS 作為您的活動目的地類型的詳細說明，請參閱 [步驟 7](event-destinations-manage.md#specify-event-dest-step)，並假設您已在 [建立事件目的地](event-destinations-manage.md#event-destination-add) 當中完成所有先前的步驟。選取 Amazon SNS **目的地類型**、輸入目的地**名稱**並啟用**事件發佈**後，會顯示 **Amazon Simple Notification Service (SNS) 主題**窗格，其欄位會在下列步驟中處理。 1. 針對 **SNS topic (SNS 主題)**，選擇現有的 Amazon SNS 主題，或選擇 **Create SNS topic (建立 SNS 主題)** 來建立新主題。 如需建立主題的詳細資訊，請參閱 *Amazon Simple Notification Service 開發人員指南*中的[建立主題](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html)。 **重要** 使用 Amazon SNS 建立主題時，針對 **Type (類型)**，請只選擇 **Standard (標準)**。(SES 不支援 FIFO 類型的主題。) 1. 選擇**下一步**。 1. 在審核畫面上，如果您對定義活動目的地的方式感到滿意，請選擇 **Add destination (新增目的地)**。這會開啟活動目的地的摘要頁面，其中的成功橫幅將確認您的活動目的地是否已成功建立或修改。 1. 無論您建立新的 SNS 主題還是選取現有主題，都必須授予 SES 的存取權，才能將通知發佈至主題。在上一步的事件目的地摘要頁面上，從 **Destination type** (目的地類型) 一欄中選擇 **Amazon SNS** - 您將前往 Amazon Simple Notification Service 主控台中的 **Topics** (主題) 清單 - *從 Amazon SNS 主控台執行下列步驟：* 1. 選取您在上一步建立或修改的 SNS 主題名稱。 1. 在主題的詳細資訊畫面中，選擇 **Edit** (編輯)。 1. 若要授予 SES 將通知發佈到主題的許可，請在 SNS 主控台的 **Edit topic** (編輯主題) 畫面中，展開 **Access policy** (存取政策)，並在 **JSON editor** (JSON 編輯器) 中新增下列許可政策： ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Id": "notification-policy", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "sns:Publish", "Resource": "arn:aws:sns:us-east-1:111122223333:topic_name", "Condition": { "StringEquals": { "AWS:SourceAccount": "111122223333", "AWS:SourceArn": "arn:aws:ses:topic_region:111122223333:configuration-set/configuration-set-name" } } } ] } ``` ------ 在上述範例政策中進行下列變更： + 將 *topic\$1region* 取代為您建立 SNS 主題的 AWS 區域。 + 將 *111122223333* 取代為 AWS 您的帳戶 ID。 + 將 *topic\$1name* 取代為您的 SNS 主題。 + 將 *configuration-set-name* 取代為與 SNS 事件目的地相關聯的組態集名稱。 1. 選擇**儲存變更**。 # 步驟 3：在傳送電子郵件時指定您的組態設定 在您[ 建立設定集](event-publishing-create-configuration-set.md)並[新增事件目的地](event-publishing-add-event-destination.md)後，最後一個步驟是傳送您的電子郵件，即可完成事件發佈。 若要發佈與電子郵件相關的事件名稱，您必須提供的組態設定名稱以連結電子郵件。或者，您也可以提供訊息標籤來分類電子郵件。 您可以將此資訊做為電子郵件傳送 API 的參數、Amazon SES 專屬電子郵件標頭或在 MIME 訊息中的自訂標頭，來提供給 Amazon SES。您選擇的方法取決於您所使用的電子郵件傳送界面，如下表所示。 **** | 電子郵件傳送界面 | 發佈事件的方式 | | --- | --- | | `SendEmail` | API 參數 | | `SendTemplatedEmail` | API 參數 | | `SendBulkTemplatedEmail` | API 參數 | | `SendCustomVerificationEmail` | API 參數 | | `SendRawEmail` | API 參數、Amazon SES 專屬電子郵件標頭或自訂 MIME 標頭 如果您同時使用標頭與 API 參數，Amazon SES 只會使用 API 參數提供的訊息標籤。Amazon SES 不會加入 API 參數與標頭所指定的訊息標籤。 | | SMTP 界面 | Amazon SES 專屬電子郵件標頭 | 下節說明如何使用標題與 API 參數來指定組態設定與訊息標籤。 + [使用 Amazon SES API 參數](#event-publishing-using-ses-parameters) + [使用 Amazon SES 專屬電子郵件標頭](#event-publishing-using-ses-headers) + [使用自訂電子郵件標題](#event-publishing-using-custom-headers) **注意** 您可以選擇在電子郵件的標頭中包含訊息標籤。訊息標籤可以包含數字 0-9、字母 A-Z (包括大小寫)、連字號 (-) 和底線 (\$1)。 ## 使用 Amazon SES API 參數 若要使用 [SendEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendEmail.html)、[SendTemplatedEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html)、[SendBulkTemplatedEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html)、[SendCustomVerificationEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendCustomVerificationEmail.html) 或 [SendRawEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendRawEmail.html) 搭配事件發佈，請將稱為 [ConfigurationSet](https://docs.aws.amazon.com/ses/latest/APIReference/API_ConfigurationSet.html) 與 [MessageTag](https://docs.aws.amazon.com/ses/latest/APIReference/API_MessageTag.html) 的資料結構傳遞至 API 呼叫，以指定組態集與訊息標籤。 如需使用 Amazon SES API 的詳細資訊，請參閱 [Amazon Simple Email Service API 參考資料](https://docs.aws.amazon.com/ses/latest/APIReference/)。 ## 使用 Amazon SES 專屬電子郵件標頭 使用 `SendRawEmail` 或 SMTP 界面時，可將 Amazon SES 專屬標頭新增到電子郵件以指定組態集和訊息標籤。Amazon SES 會在傳送電子郵件前移除標頭。下表顯示可使用的標題名稱。 | 事件發佈資訊 | 標頭 | | --- | --- | | 組態集 | `X-SES-CONFIGURATION-SET` | | 訊息標籤 | `X-SES-MESSAGE-TAGS` | 以下範例呈現可能在提交至 Amazon SES 的電子郵件原始碼中看到的標頭樣式。 ``` 1. X-SES-MESSAGE-TAGS: tagName1=tagValue1, tagName2=tagValue2 2. X-SES-CONFIGURATION-SET: myConfigurationSet 3. From: sender@example.com 4. To: recipient@example.com 5. Subject: Subject 6. Content-Type: multipart/alternative; 7. boundary="----=_boundary" 8. 9. ------=_boundary 10. Content-Type: text/plain; charset=UTF-8 11. Content-Transfer-Encoding: 7bit 12. 13. body 14. ------=_boundary 15. Content-Type: text/html; charset=UTF-8 16. Content-Transfer-Encoding: 7bit 17. 18. body 19. ------=_boundary-- ``` ## 使用自訂電子郵件標題 雖然您必須指定使用 Amazon SES 專屬標頭 `X-SES-CONFIGURATION-SET` 來指定組態集名稱，您仍可使用自己的 MIME 標頭來指定訊息標籤。 **注意** 您用於 Amazon SES 事件發佈的標頭名稱與數值須為 ASCII 格式。如果您為 Amazon SES 事件發佈指定非 ASCII 的標頭名稱或值，電子郵件傳送呼叫仍會成功執行，但事件指標將不會發送至 Amazon CloudWatch。