步骤 3：在发送电子邮件时指定配置集 - Amazon Simple Email Service
使用 Amazon SES API 参数使用特定于 Amazon SES 的电子邮件标头使用自定义电子邮件标头

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

步骤 3：在发送电子邮件时指定配置集

在创建配置集和添加事件目标后，事件发布的最后一步是发送您的电子邮件。

要发布与电子邮件相关联的事件，您必须提供配置集名称以便与电子邮件相关联。您还可以选择性地提供邮件标签以对电子邮件进行分类。

您可以以电子邮件发送 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 参数指定配置集和邮件标签。

注意

还可以选择性地在电子邮件标头中包含邮件标签。邮件标签可以包含数字 0-9、字母 A-Z（大写和小写字母）、连字符（-）和下划线（_）。

使用 Amazon SES API 参数

要将 SendEmail、SendTemplatedEmail、SendBulkTemplatedEmail、SendCustomVerificationEmail 或 SendRawEmail 与事件发布结合使用，可通过将名为 ConfigurationSet 和 MessageTag 的数据结构传递给 API 调用来指定配置集和邮件标签。

有关使用 Amazon SES API 的更多信息，请参阅 Amazon Simple Email Service API 参考。

使用特定于 Amazon SES 的电子邮件标头

在使用 SendRawEmail 或 SMTP 接口时，您可以通过将特定于 Amazon SES 的标头添加到电子邮件来指定配置集和邮件标签。Amazon SES 将删除标头，然后再发送电子邮件。下表显示了要使用的标头的名称。

事件发布信息 标头

配置集

X-SES-CONFIGURATION-SET

邮件标签

X-SES-MESSAGE-TAGS

以下示例显示了在提交至 Amazon SES 的原始电子邮件中标头的具体形式。

X-SES-MESSAGE-TAGS: tagName1=tagValue1, tagName2=tagValue2
X-SES-CONFIGURATION-SET: myConfigurationSet
From: sender@example.com
To: recipient@example.com
Subject: Subject
Content-Type: multipart/alternative;
	boundary="----=_boundary"

------=_boundary
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit

body
------=_boundary
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: 7bit

body
------=_boundary--

使用自定义电子邮件标头

尽管您必须使用特定于 Amazon SES 的标头 X-SES-CONFIGURATION-SET 指定配置集名称，但您可以使用自己的 MIME 标头指定邮件标签。

注意

Amazon SES 事件发布使用的标头名称和值必须是 ASCII 码。如果您为 Amazon SES 事件发布指定非 ASCII 标头名称或值，电子邮件发送调用仍将成功，但事件指标不会发到 Amazon CloudWatch。