翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon SES の Amazon SNS 通知コンテンツ

バウンス、苦情、および配信の通知は、JavaScript Object Notation (JSON) 形式で、Amazon Simple Notification Service (Amazon SNS) トピックに発行されます。トップレベル JSON オブジェクトには、notificationType 文字列と mail オブジェクトに加え、bounce オブジェクト、complaint オブジェクト、または delivery オブジェクトのいずれかが含まれます。

オブジェクトのタイプごとの詳細については以下のセクションを参照してください。

以下は、Amazon SES の Amazon SNS 通知の内容に関する重要な注意事項です。

トップレベル JSON オブジェクト

Amazon SES 通知のトップレベル JSON オブジェクトには、以下のフィールドが含まれています。

Mail オブジェクト

バウンス、苦情、または配信の通知にはそれぞれ、mail オブジェクト内の元の E メールについての情報が含まれます。mail オブジェクトについての情報を含む JSON オブジェクトには次のフィールドが含まれます。

以下は、元の E メールヘッダーを含む mail オブジェクトの例です。この通知タイプが元の E メールヘッダーを含めるように設定されていない場合は、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"
   }
}

Bounce オブジェクト

バウンスに関する情報を含む 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"
}

バウンスとなった受取人

バウンスの通知には、1 人の受信者に関するものと複数の受信者に関するものがあります。bouncedRecipients フィールドはオブジェクトのリスト (バウンスの通知が関係する受取人ごとに 1 つのオブジェクト) を保持し、常に次のフィールドが含まれます。

オプションで、DSN がバウンスに添付されている場合、以下のフィールドも表示される場合があります。

以下は、bouncedRecipients のリストに示されるオブジェクトの例です。

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

バウンスのタイプ

バウンスオブジェクトには、バウンスタイプとして Undetermined、Permanent、または Transient が含まれます。Permanent バウンスタイプと Transient バランスタイプには、複数のバウンスサブタイプのいずれかも含まれます。

バウンスタイプが Transient のバウンス通知を受信した場合は、メッセージのバウンスを起こした問題が解決されたときに、この受取人に対して将来 E メールを送信できる可能性があります。

バウンスタイプが Permanent のバウンス通知を受信した場合、この受取人に将来 E メールを送信できる可能性はありません。このため、バウンスを生じたアドレスを持つ受取人はメーリングリストから即座に削除してください。

苦情のオブジェクト

苦情に関する情報を含む 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 フィールドには以下の苦情のタイプが示されます (Internet Assigned Numbers Authority ウェブサイト に基づいて、報告する 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"
}