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

# Amazon SES 电子邮件接收通知的内容
<a name="receiving-email-notifications-contents"></a>

所有接收电子邮件的通知都以对象表示法 (JSON) 格式发布到亚马逊简单通知服务 (Amazon SNS) Simple Notification Service 主题 JavaScript 。

有关示例通知，请参阅 [通知示例](receiving-email-notifications-examples.md)

**Contents**
+ [顶级 JSON 对象](#receiving-email-notifications-contents-top-level-json-object)
+ [接收对象](#receiving-email-notifications-contents-receipt-object)
  + [操作对象](#receiving-email-notifications-contents-action-object)
  + [dkimVerdict 对象](#receiving-email-notifications-contents-dkimverdict-object)
  + [dmarcVerdict 对象](#receiving-email-notifications-contents-dmarcverdict-object)
  + [spamVerdict 对象](#receiving-email-notifications-contents-spamverdict-object)
  + [spfVerdict 对象](#receiving-email-notifications-contents-spfverdict-object)
  + [virusVerdict 对象](#receiving-email-notifications-contents-virusverdict-object)
+ [邮件对象](#receiving-email-notifications-contents-mail-object)
  + [commonHeaders 对象](#receiving-email-notifications-contents-mail-object-commonHeaders)

## 顶级 JSON 对象
<a name="receiving-email-notifications-contents-top-level-json-object"></a>

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


| 字段名称 | 说明 | 
| --- | --- | 
|  notificationType  | 通知类型。对于此通知类型，值始终为 `Received`。 | 
| [`receipt`](#receiving-email-notifications-contents-receipt-object) | 包含电子邮件传送信息的对象。 | 
| [`mail`](#receiving-email-notifications-contents-mail-object) | 包含与通知关联的电子邮件的相关信息的对象。 | 
|  content  | 包含原始、未修改电子邮件的字符串，通常是多用途 Internet 邮件扩展（MIME）格式。有关 MIME 格式的更多信息，请参阅 [RFC 2045](https://tools.ietf.org/html/rfc2045)。 仅当通知由 SNS 操作触发时才包含此字段。所有其他操作触发的通知不包含此字段。  | 

## 接收对象
<a name="receiving-email-notifications-contents-receipt-object"></a>

`receipt` 对象包含以下字段。


| 字段名称 | 说明 | 
| --- | --- | 
| [`action`](#receiving-email-notifications-contents-action-object) | 封装已执行操作的信息的对象。有关可能的值的列表，请参阅[操作对象](#receiving-email-notifications-contents-action-object)。 | 
| [`dkimVerdict`](#receiving-email-notifications-contents-dkimverdict-object) | 表示 DomainKeys 已识别邮件 (DKIM) 检查是否通过的对象。有关可能的值的列表，请参阅[dkimVerdict 对象](#receiving-email-notifications-contents-dkimverdict-object)。 | 
| dmarcPolicy | 指示发送域的基于域的邮件身份验证、报告和合规性（DMARC）设置。此字段仅当邮件未通过 DMARC 身份验证时出现。<br />此字段的值可能为：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/ses/latest/dg/receiving-email-notifications-contents.html) | 
| [`dmarcVerdict`](#receiving-email-notifications-contents-dmarcverdict-object) | 用于指示是否已通过基于域的消息身份验证、报告和合规性（DMARC）检查的对象。有关可能的值的列表，请参阅[dmarcVerdict 对象](#receiving-email-notifications-contents-dmarcverdict-object)。 | 
|  processingTimeMillis  | 用于指定从 Amazon SES 收到消息到触发操作所花费的时间（以毫秒为单位）的字符串。 | 
|  recipients  | 符合有效[接收规则](receiving-email-receipt-rules-console-walkthrough.md)的收件人（具体来说，信封 RCPT TO 地址）。此处列出的地址可能不同于 [邮件对象](#receiving-email-notifications-contents-mail-object)中的 `destination` 字段所列出的地址。 | 
| [`spamVerdict`](#receiving-email-notifications-contents-spamverdict-object) | 用于指示消息是否为垃圾邮件的对象。有关可能的值的列表，请参阅[spamVerdict 对象](#receiving-email-notifications-contents-spamverdict-object)。 | 
| [`spfVerdict`](#receiving-email-notifications-contents-spfverdict-object) | 用于指示是否已通过发件人策略框架（SPF）检查的对象。有关可能的值的列表，请参阅[spfVerdict 对象](#receiving-email-notifications-contents-spfverdict-object)。 | 
|  timestamp  | 用于指定触发操作的限定日期和时间（采用 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) 格式）的字符串。 | 
| [virusVerdict](#receiving-email-notifications-contents-virusverdict-object) | 用于指示消息是否包含病毒的对象。有关可能的值的列表，请参阅[virusVerdict 对象](#receiving-email-notifications-contents-virusverdict-object)。 | 

### 操作对象
<a name="receiving-email-notifications-contents-action-object"></a>

`action` 对象包含以下字段。


| 字段名称 | 说明 | 
| --- | --- | 
|  type  | 用于指示已执行的操作类型的字符串。可能的值包括 `S3`、`SNS`、`Bounce`、`Lambda`、`Stop` 和 `WorkMail`。 | 
|  topicArn  | 包含发布通知的 Amazon SNS 主题的 Amazon Resource Name (ARN) 的字符串。 | 
|  bucketName  | 包含发布消息的 Amazon S3 存储桶名称的字符串。仅 S3 操作类型存在此字段。 | 
|  objectKey  | 包含在 Amazon S3 存储桶中唯一标识电子邮件的名称的字符串。它与 [邮件对象](#receiving-email-notifications-contents-mail-object)中的 `messageId` 相同。仅 S3 操作类型存在此字段。 | 
|  smtpReplyCode  | 包含根据 [RFC 5321](https://tools.ietf.org/html/rfc5321) 定义的 SMTP 回复代码的字符串。仅退回邮件操作类型存在此字段。 | 
|  statusCode  | 包含根据 [RFC 3463](https://tools.ietf.org/html/rfc3463) 定义的 SMTP 增强状态代码的字符串。仅退回邮件操作类型存在此字段。 | 
|  message  | 包含退回邮件信息中所包括的用户可读文本的字符串。仅退回邮件操作类型存在此字段。 | 
|  sender  | 包含退回电子邮件的发件人电子邮件地址的字符串。此为发送退回邮件消息的地址。仅退回邮件操作类型存在此字段。 | 
|  functionArn  | 包含已触发的 Lambda 函数的 ARN 的字符串。仅 Lambda 操作类型存在此字段。 | 
|  invocationType  | 包含 Lambda 函数的调用类型的字符串。可能的值为 `RequestResponse` 和 `Event`。仅 Lambda 操作类型存在此字段。 | 
|  organizationArn  | 包含亚马逊 WorkMail组织的 ARN 的字符串。仅适用于 WorkMail 操作类型。 | 

### dkimVerdict 对象
<a name="receiving-email-notifications-contents-dkimverdict-object"></a>

`dkimVerdict` 对象包含以下字段。


| 字段名称 | 说明 | 
| --- | --- | 
|  status  | 包含 DKIM 裁决的字符串。可能的值有：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/ses/latest/dg/receiving-email-notifications-contents.html) | 

### dmarcVerdict 对象
<a name="receiving-email-notifications-contents-dmarcverdict-object"></a>

`dmarcVerdict` 对象包含以下字段。


| 字段名称 | 说明 | 
| --- | --- | 
|  status  | 包含 DMARC 裁决的字符串。可能的值有：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/ses/latest/dg/receiving-email-notifications-contents.html) | 

### spamVerdict 对象
<a name="receiving-email-notifications-contents-spamverdict-object"></a>

`spamVerdict` 对象包含以下字段。


| 字段名称 | 说明 | 
| --- | --- | 
|  status  | 包含垃圾邮件扫描结果的字符串。可能的值有：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/ses/latest/dg/receiving-email-notifications-contents.html) | 

### spfVerdict 对象
<a name="receiving-email-notifications-contents-spfverdict-object"></a>

`spfVerdict` 对象包含以下字段。


| 字段名称 | 说明 | 
| --- | --- | 
|  status  | 包含 SPF 裁决的字符串。可能的值有：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/ses/latest/dg/receiving-email-notifications-contents.html) | 

### virusVerdict 对象
<a name="receiving-email-notifications-contents-virusverdict-object"></a>

`virusVerdict` 对象包含以下字段。


| 字段名称 | 说明 | 
| --- | --- | 
|  status  | 包含病毒扫描结果的字符串。可能的值有：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/ses/latest/dg/receiving-email-notifications-contents.html) | 

## 邮件对象
<a name="receiving-email-notifications-contents-mail-object"></a>

`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`](#receiving-email-notifications-contents-mail-object-commonHeaders) | 所有电子邮件的共有标头。每个标头具有以下字段：`name` 和 `value`。 | 
|  headersTruncated  | 指定通知中的标头是否被截断，如果标头大于 10KB，则会发生截断。可能的值为 `true` 和 `false`。 | 

### commonHeaders 对象
<a name="receiving-email-notifications-contents-mail-object-commonHeaders"></a>

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


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