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

为 Amazon SES 配置 Amazon SNS 通知

退回邮件、投诉和送达通知均采用 JavaScript 对象表示法（JSON）格式发布到 Amazon Simple Notification Service（Amazon SNS）主题。顶级 JSON 对象包含一个 notificationType 字符串，一个 mail 对象，以及一个 bounce 对象、complaint 对象或 delivery 对象。

有关不同类型对象的描述，请参阅以下部分：

以下是有关 Amazon SES 的 Amazon SNS 通知内容的一些重要说明：

顶级 JSON 对象

Amazon SES 通知中的顶级 JSON 对象包含以下字段。

邮件对象

每个退回邮件、投诉或送达通知均在 mail 对象中包含有关原始电子邮件的信息。包含有关 mail 对象的信息的 JSON 对象具有以下字段。

下面是包含原始电子邮件标头的 mail 对象的示例。当此通知类型未配置为包含原始电子邮件标头时，mail 对象不会包含 headersTruncated、headers 和 commonHeaders 字段。

{
   "timestamp":"2018-10-08T14:05:45 +0000",
   "messageId":"000001378603177f-7a5433e7-8edb-42ae-af10-f0181f34d6ee-000000",
   "source":"sender@example.com",
   "sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
   "sourceIp": "127.0.3.0",
   "sendingAccountId":"123456789012",
   "destination":[
      "recipient@example.com"
   ],
   "headersTruncated":false,
   "headers":[ 
      { 
         "name":"From",
         "value":"\"Sender Name\" <sender@example.com>"
      },
      { 
         "name":"To",
         "value":"\"Recipient Name\" <recipient@example.com>"
      },
      { 
         "name":"Message-ID",
         "value":"custom-message-ID"
      },
      { 
         "name":"Subject",
         "value":"Hello"
      },
      { 
         "name":"Content-Type",
         "value":"text/plain; charset=\"UTF-8\""
      },
      { 
         "name":"Content-Transfer-Encoding",
         "value":"base64"
      },
      { 
         "name":"Date",
         "value":"Mon, 08 Oct 2018 14:05:45 +0000"
      }
   ],
   "commonHeaders":{ 
      "from":[ 
         "Sender Name <sender@example.com>"
      ],
      "date":"Mon, 08 Oct 2018 14:05:45 +0000",
      "to":[ 
         "Recipient Name <recipient@example.com>"
      ],
      "messageId":" custom-message-ID",
      "subject":"Message sent using Amazon SES"
   }
}

退回邮件对象

包含有关退回邮件的信息的 JSON 对象具有以下字段。

如果 Amazon SES 已能够联系远程 Message Transfer Authority（MTA），则以下字段也将显示。

如果退回邮件已附加传输状态通知 (DSN)，则以下字段也可能存在。

以下是 bounce 对象的示例。

{
   "bounceType":"Permanent",
   "bounceSubType": "General",
   "bouncedRecipients":[
      {
         "status":"5.0.0",
         "action":"failed",
         "diagnosticCode":"smtp; 550 user unknown",
         "emailAddress":"recipient1@example.com"
      },
      {
         "status":"4.0.0",
         "action":"delayed",
         "emailAddress":"recipient2@example.com"
      }
   ],
   "reportingMTA": "example.com",
   "timestamp":"2012-05-25T14:59:38.605Z",
   "feedbackId":"000001378603176d-5a4b5ad9-6f30-4198-a8c3-b1eb0c270a1d-000000",
   "remoteMtaIp":"127.0.2.0"
}

退信的收件人

退回邮件通知可能与一个或多个收件人有关。bouncedRecipients 字段包含对象列表 (与退回邮件通知相关的每个收件人均有一个对象) 而且始终包含以下字段。

（可选）如果 DSN 已附加到退信，则以下字段也可能存在。

以下是可能位于 bouncedRecipients 列表中的对象的示例。

{
    "emailAddress": "recipient@example.com",
    "action": "failed",
    "status": "5.0.0",
    "diagnosticCode": "X-Postfix; unknown user"
}

退信类型

退回邮件对象包含的退回邮件类型为 Undetermined、Permanent 或 Transient。Permanent 和 Transient 退回邮件类型也可以包含多种退回邮件子类型之一。

当您收到退回邮件类型为 Transient 的退回邮件通知时，如果解决了导致退回邮件的问题，您也许可在以后将邮件发送给该收件人。

当您收到退回邮件类型为 Permanent 的退回邮件通知时，您以后也可能无法将电子邮件发送给该收件人。因此，您应该立即从邮件列表中删除其地址造成了退回邮件的收件人。

投诉对象

包含有关投诉的信息的 JSON 对象具有以下字段。

此外，如果反馈报告已附加到投诉，则以下字段也可能存在。

以下是 complaint 对象的示例。

{
   "userAgent":"ExampleCorp Feedback Loop (V0.01)",
   "complainedRecipients":[
      {
         "emailAddress":"recipient1@example.com"
      }
   ],
   "complaintFeedbackType":"abuse",
   "arrivalDate":"2009-12-03T04:24:21.000-05:00",
   "timestamp":"2012-05-25T14:59:38.623Z",
   "feedbackId":"000001378603177f-18c07c78-fa81-4a58-9dd1-fedc3cb8f49a-000000"
}
            

已投诉的收件人

complainedRecipients 字段包含可能已提交投诉的收件人的列表。您应使用此信息来确定哪位收件人提交了投诉，然后立即在您的邮件列表中删除该收件人。

此列表中的 JSON 对象包含以下字段。

以下是已投诉收件人对象的示例。

{ "emailAddress": "recipient1@example.com" }

投诉类型

根据complaintFeedbackType互联网编号分配机构网站，您可在由报告 ISP 分配的 字段中看到以下投诉类型：

送达对象

包含送达情况相关信息的 JSON 对象始终具有以下字段。

以下是 delivery 对象的示例。

{
   "timestamp":"2014-05-28T22:41:01.184Z",
   "processingTimeMillis":546,
   "recipients":["success@simulator.amazonses.com"],
   "smtpResponse":"250 ok:  Message 64111812 accepted",
   "reportingMTA":"a8-70.smtp-out.amazonses.com",
   "remoteMtaIp":"127.0.2.0"
}