本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon SES 的 Amazon SNS 通知內容

退信、投訴和遞送通知會以 JavaScript 物件標記法 (JSON) 格式發佈到 Amazon Simple Notification Service (Amazon SNS) 主題。最上層 JSON 物件包含一個 notificationType 字串、mail 物件，或者 bounce 物件、complaint 物件或 delivery 物件。

請參閱以下章節以了解不同類型物件的說明：

以下幾點重要備註與 Amazon SES 的 Amazon SNS 通知內容相關：

最上層 JSON 物件

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 SES"
   }
}

退信物件

JSON 物件，其中包含具有以下欄位的退信相關資訊。

如果 SES 能夠聯絡遠端訊息傳輸授權機構 (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 根據 Internet Assigned Numbers Authority website 指派的下列投訴類型：

交付物件

包含遞送相關資訊的 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"
}