Amazon SES 电子邮件接收通知的内容

所有电子邮件接收通知均采用 JavaScript 对象表示法（JSON）格式发布到 Amazon Simple Notification Service (Amazon SNS) 主题。

有关示例通知，请参阅 通知示例。

目录

• 顶级 JSON 对象
• 接收对象
  • 操作对象
  • dkimVerdict 对象
  • dmarcVerdict 对象
  • spamVerdict 对象
  • spfVerdict 对象
  • virusVerdict 对象
• 邮件对象
  • commonHeaders 对象

顶级 JSON 对象

顶级 JSON 对象包含以下字段。

字段名称	描述
notificationType	通知类型。对于此通知类型，值始终为 Received。
receipt	包含电子邮件传送信息的对象。
mail	包含与通知关联的电子邮件的相关信息的对象。
content	包含原始、未修改电子邮件的字符串，通常是多用途 Internet 邮件扩展（MIME）格式。有关 MIME 格式的更多信息，请参阅 RFC 2045。 注意 仅当通知由 SNS 操作触发时才包含此字段。所有其他操作触发的通知不包含此字段。

接收对象

receipt 对象包含以下字段。

字段名称	描述
action	封装已执行操作的信息的对象。有关可能的值的列表，请参阅操作对象。
dkimVerdict	用于指示是否已通过域名密钥识别邮件（DKIM）检查的对象。有关可能的值的列表，请参阅dkimVerdict 对象。
dmarcPolicy	指示发送域的基于域的邮件身份验证、报告和合规性（DMARC）设置。此字段仅当邮件未通过 DMARC 身份验证时出现。 此字段的值可能为： none：发送域的所有者请求不对未通过 DMARC 身份验证的邮件执行任何特定操作。 quarantine：发送域的所有者请求接收方将未通过 DMARC 身份验证的邮件视为可疑邮件。 reject：发送域的所有者请求拒绝未通过 DMARC 身份验证的邮件。
dmarcVerdict	用于指示是否已通过基于域的消息身份验证、报告和合规性（DMARC）检查的对象。有关可能的值的列表，请参阅dmarcVerdict 对象。
processingTimeMillis	用于指定从 Amazon SES 收到消息到触发操作所花费的时间（以毫秒为单位）的字符串。
recipients	符合有效接收规则的收件人（具体来说，信封 RCPT TO 地址）。此处列出的地址可能不同于 邮件对象中的 destination 字段所列出的地址。
spamVerdict	用于指示消息是否为垃圾邮件的对象。有关可能的值的列表，请参阅spamVerdict 对象。
spfVerdict	用于指示是否已通过发件人策略框架（SPF）检查的对象。有关可能的值的列表，请参阅spfVerdict 对象。
timestamp	用于指定触发操作的限定日期和时间（采用 ISO 8601 格式）的字符串。
virusVerdict	用于指示消息是否包含病毒的对象。有关可能的值的列表，请参阅virusVerdict 对象。

操作对象

action 对象包含以下字段。

字段名称	描述
type	用于指示已执行的操作类型的字符串。可能的值包括 S3、SNS、Bounce、Lambda、Stop 和 WorkMail。
topicArn	包含发布通知的 Amazon SNS 主题的 Amazon Resource Name (ARN) 的字符串。
bucketName	包含发布消息的 Amazon S3 存储桶名称的字符串。仅 S3 操作类型存在此字段。
objectKey	包含在 Amazon S3 存储桶中唯一标识电子邮件的名称的字符串。它与 邮件对象中的 messageId 相同。仅 S3 操作类型存在此字段。
smtpReplyCode	包含根据 RFC 5321 定义的 SMTP 回复代码的字符串。仅退回邮件操作类型存在此字段。
statusCode	包含根据 RFC 3463 定义的 SMTP 增强状态代码的字符串。仅退回邮件操作类型存在此字段。
message	包含退回邮件信息中所包括的用户可读文本的字符串。仅退回邮件操作类型存在此字段。
sender	包含退回电子邮件的发件人电子邮件地址的字符串。此为发送退回邮件消息的地址。仅退回邮件操作类型存在此字段。
functionArn	包含已触发的 Lambda 函数的 ARN 的字符串。仅 Lambda 操作类型存在此字段。
invocationType	包含 Lambda 函数的调用类型的字符串。可能的值为 RequestResponse 和 Event。仅 Lambda 操作类型存在此字段。
organizationArn	包含 Amazon WorkMail 组织的 ARN 的字符串。仅 WorkMail 操作类型存在此字段。

dkimVerdict 对象

dkimVerdict 对象包含以下字段。

字段名称	描述
status	包含 DKIM 裁决的字符串。可能的值有： PASS：邮件已通过 DKIM 身份验证。 FAIL：邮件未通过 DKIM 身份验证。 GRAY：邮件未经 DKIM 签名，或者发件人域和 DKIM 签名域不匹配。 PROCESSING_FAILED：出现了阻止 Amazon SES 检查 DKIM 签名的问题。例如，DNS 查询失败或 DKIM 签名标头格式不正确。

dmarcVerdict 对象

dmarcVerdict 对象包含以下字段。

字段名称	描述
status	包含 DMARC 裁决的字符串。可能的值有： PASS：邮件已通过 DMARC 身份验证。 FAIL：邮件未通过 DMARC 身份验证。 GRAY：至少有一个 SPF 或 DKIM 通过身份验证，但发送域没有 DMARC 策略或使用 p=none 策略。 PROCESSING_FAILED：出现了阻止 Amazon SES 提供 DMARC 裁决的问题。

spamVerdict 对象

spamVerdict 对象包含以下字段。

字段名称	描述
status	包含垃圾邮件扫描结果的字符串。可能的值有： PASS：垃圾邮件扫描确定邮件不太可能包含垃圾邮件。 FAIL：垃圾邮件扫描确定邮件可能包含垃圾邮件。 GRAY：Amazon SES 已扫描电子邮件，但没把握确定它是否为垃圾邮件。 PROCESSING_FAILED：Amazon SES 无法扫描电子邮件。例如，电子邮件不是有效的 MIME 消息。

spfVerdict 对象

spfVerdict 对象包含以下字段。

字段名称	描述
status	包含 SPF 裁决的字符串。可能的值有： PASS：邮件已通过 SPF 身份验证。 FAIL：邮件未通过 SPF 身份验证。 GRAY：SPF 结果为 none、softfail 或 neutral。 PROCESSING_FAILED：出现了阻止 Amazon SES 检查 SPF 记录的问题。例如，DNS 查询失败。

virusVerdict 对象

virusVerdict 对象包含以下字段。

字段名称	描述
status	包含病毒扫描结果的字符串。可能的值有： PASS：邮件不含病毒。 FAIL：邮件包含病毒。 GRAY：Amazon SES 已扫描电子邮件，但没把握确定它是否包含病毒。 PROCESSING_FAILED：Amazon SES 无法扫描电子邮件的内容。例如，电子邮件不是有效的 MIME 消息。

邮件对象

mail 对象包含以下字段。

字段名称	描述
destination	传入电子邮件的 MIME 标头中的所有收件人地址（包括 To: (收件人:) 和 CC: (抄送:) 收件人）的完整列表。
messageId	包含 Amazon SES 分配给该电子邮件的唯一 ID 的字符串。如果电子邮件已送达 Amazon S3，则消息 ID 同时也是用于向 Amazon S3 存储桶写入消息的 Amazon S3 对象键。
source	包含发送电子邮件的电子邮件地址 (具体来说，信封 MAIL FROM 地址) 的字符串。
timestamp	包含电子邮件收件时间的字符串，采用 ISO8601 格式。
headers	Amazon SES 标头和自定义的标头。每个标头具有以下字段：name 和 value。
commonHeaders	所有电子邮件的共有标头。每个标头具有以下字段：name 和 value。
headersTruncated	指定通知中的标头是否被截断，如果标头大于 10KB，则会发生截断。可能的值为 true 和 false。

commonHeaders 对象

commonHeaders 对象可以包含下表中显示的字段。此对象中存在的字段取决于传入电子邮件中存在的字段。

字段名称	描述
messageId	原始邮件的 ID。
date	Amazon SES 收到此邮件的日期和时间。
to	电子邮件的 To 标头。
cc	电子邮件的 CC 标头。
bcc	电子邮件的 BCC 标头。
from	电子邮件的 From 标头。
sender	电子邮件的 Sender 标头。
returnPath	电子邮件的 Return-Path 标头。
replyTo	电子邮件的 Reply-To 标头。
subject	电子邮件的 Subject 标头。