用於 Amazon SES 電子郵件接收的通知內容 - Amazon Simple Email Service
最上層 JSON 物件接收物件郵件物件

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

用於 Amazon SES 電子郵件接收的通知內容

所有電子郵件接收的通知，都會以 JavaScript 物件標記法 (JSON) 格式發佈到 Amazon Simple Notification Service (Amazon SNS) 主題。

如需範例通知，請參閱 通知範例。

最上層 JSON 物件

最上層 JSON 物件包含下列欄位。

欄位名稱 描述
notificationType

通知類型。針對這一類通知，值一律為 Received。

receipt

包含有關電子郵件傳遞資訊的物件。

mail

包含與通知建立關聯之電子郵件資訊的物件。
content

包含原始、未修改的電子郵件之字串，通常是以多用途網際網路郵件延伸 (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

由作用中接收規則匹配的收件人 (特別是信封收件人地址)。此處列出的地址可能與 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

包含 SMTP 回覆程式碼的字串，如 RFC 5321 中所定義。只會為退信動作類型顯示。
statusCode

包含 SMTP 強化狀態程式碼的字串，如 RFC 3463 中所定義。只會為退信動作類型顯示。
message

包含人物的字串 - 可讀文字，包含在退信訊息中。只會為退信動作類型顯示。
sender

其中包含的遭退信的電子郵件之寄件者電子郵件的地址字串。此為送出退信訊息的地址。只會為退信動作類型顯示。
functionArn

此字串中包含被觸發的 Lambda 函數之 ARN。只會為 Lambda 動作類型顯示。
invocationType

此字串中包含 Lambda 函數的叫用類型。可能值為 RequestResponse 和 Event。只會為 Lambda 動作類型顯示。
organizationArn

其中包含 Amazon WorkMail 組織 ARN 的字串。只會為 WorkMail 動作類型顯示。

dkimVerdict 物件

dkimVerdict 物件包含以下欄位。

欄位名稱 描述
status

包含 DKIM verdict 的字串。可能值為：

  • PASS：訊息已通過 DKIM 驗證。

  • FAIL：訊息未通過 DKIM 驗證。

  • GRAY：訊息未經 DKIM 簽署或來自網域，且 DKIM 簽章網域不相符。

  • PROCESSING_FAILED：發生阻擋 Amazon SES 檢查 DKIM 簽章的問題。例如，DNS 查詢失敗或 DKIM 簽章標題格式不正確。

dmarcVerdict 物件

dmarcVerdict 物件包含以下欄位。

欄位名稱 描述
status

包含 DMARC verdict 的字串。可能值為：

  • PASS：訊息已通過 DMARC 驗證。

  • FAIL：訊息未通過 DMARC 驗證。

  • GRAY：至少有一個 SPF 或 DKIM 通過身分驗證，但傳送網域沒有 DMARC 政策，或使用 p=none 政策。

  • PROCESSING_FAILED：發生阻擋 Amazon SES 提供 DMARC verdict 的問題。

spamVerdict 物件

spamVerdict 物件包含以下欄位。

欄位名稱 描述
status

其中包含垃圾郵件掃描結果的字串。可能值為：

  • PASS：垃圾郵件掃描判定訊息中未包含垃圾內容。

  • FAIL：垃圾郵件掃描判定訊息中可能包含垃圾內容。

  • GRAY：Amazon SES 已掃描電子郵件，但未能確切判定是否為垃圾郵件。

  • PROCESSING_FAILED：Amazon SES 無法掃描電子郵件。例如，電子郵件不是有效的 MIME 電子郵件訊息。

spfVerdict 物件

spfVerdict 物件包含以下欄位。

欄位名稱 描述
status

包含 SPF verdict 的字串。可能值為：

  • 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 標題之所有收件人地址的完整清單 (包括「收件人：」與「副本：」收件人)。
messageId

此字串中包含 Amazon SES 指派給電子郵件的唯一 ID。如果電子郵件是遞送至 Amazon S3，訊息 ID 同時也是用來將訊息寫入 Amazon S3 儲存貯體的 Amazon S3 物件金鑰。
source

包含寄出電子郵件的電子郵件地址字串 (特別是信封的寄件人地址)。
timestamp

其中包含收到電子郵件時間的字串，以 ISO8601 格式顯示。
headers

Amazon SES 標頭和您的自訂標頭。每個標頭包含以下欄位：name 和 value。

commonHeaders

所有電子郵件常用的標頭。每個標頭包含以下欄位：name 和 value。
headersTruncated

此字串說明通知中的標頭是否被截斷，會在標頭大於 10 KB 時顯示。可能值為 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 標頭。