本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
步骤 3:在发送电子邮件时指定配置集
在创建配置集和添加事件目标后,事件发布的最后一步是发送您的电子邮件。
要发布与电子邮件相关联的事件,您必须提供配置集名称以便与电子邮件相关联。您还可以选择性地提供邮件标签以对电子邮件进行分类。
您可以以电子邮件发送 API 的参数、特定于 Amazon SES 的电子邮件标头或 MIME 邮件中的自定义标头的形式向 Amazon SES 提供这些信息。您选择的方法取决于所使用的电子邮件发送接口,如下表所示。
电子邮件发送接口 | 发布事件的方式 |
---|---|
|
API 参数 |
|
API 参数 |
|
API 参数 |
|
API 参数 |
|
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 将删除标头,然后再发送电子邮件。下表显示了要使用的标头的名称。
事件发布信息 | 标题 |
---|---|
配置集 |
|
邮件标签 |
|
以下示例显示了在提交至 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。