翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon が Amazon SES に発行するイベントデータの内容 SNS
Amazon SES は、E メール送信イベントレコードを JSON形式で Amazon Simple Notification Service に発行します。
これらのすべての通知タイプのレコード例については、「Amazon SES が Amazon SNS に発行するイベントデータの例」を参照してください。
このセクションのトピック:
最上位JSONオブジェクト
E メール送信イベントレコードの最上位JSONオブジェクトには、次のフィールドが含まれます。他にどのオブジェクトが存在するのかは、イベントタイプによって決まります。
フィールド名 | 説明 |
---|---|
|
イベントのタイプを説明する文字列。可能な値: もしイベント発行のセットアップをしなかった場合は、このフィールドは |
|
イベントを生成した E メールに関する情報を含むJSONオブジェクト。 |
|
このフィールドは、 |
|
このフィールドは、 |
|
このフィールドは、 |
|
このフィールドは、 |
|
このフィールドは、 |
|
このフィールドは、 |
|
このフィールドは、 |
|
このフィールドは、 |
|
このフィールドは、 |
|
このフィールドは、 |
Mail オブジェクト
各メール送信イベントレコードには、mail
オブジェクトの元のメールに関する情報が含まれています。JSON オブジェクトに関する情報を含むmail
オブジェクトには、次のフィールドがあります。
フィールド名 | 説明 |
---|---|
|
メッセージが送信された ISO8601 形式 (YYYY-MM-DDThh:mm:ss.sZ) の日時。 |
|
Amazon がメッセージにSES割り当てた一意の ID。Amazon は、メッセージを送信したときにこの値をSES返しました。 注記このメッセージ ID は Amazon によって割り当てられましたSES。元の E メールのメッセージ ID は、 |
|
メッセージが送信された E メールアドレス (エンベロープMAILFROMアドレス)。 |
|
E メールの送信に使用された ID の Amazon リソースネーム (ARN)。送信承認の場合、 |
|
E メールの送信に使用された AWS アカウントのアカウント ID。送信承認の場合、 |
|
元のメールの受取人の E メールアドレスのリスト。 |
|
通知でヘッダーが切り捨てられたかどうかを示す文字列。切り捨ては、ヘッダーが 10 KB を超える場合に発生します。指定できる値は |
|
E メールの元のヘッダーの一覧。リスト内の各ヘッダーには、 注記
|
|
E メールの元の一般的に使用されるヘッダーのマッピング。 注記
|
|
E メールに関連付けられたタグのリストです。 |
Bounce オブジェクト
Bounce
イベントに関する情報を含むJSONオブジェクトには、次のフィールドがあります。
フィールド名 | 説明 |
---|---|
|
Amazon によって決定されるバウンスのタイプSES。 |
|
Amazon によって決定されるバウンスのサブタイプSES。 |
|
バウンスとなった元のメールの受取人についての情報を含むリスト。 |
|
がバウンス通知ISPを送信したときの ISO8601 形式 (YYYY-MM-DDThh:mm:ss.sZ) の日付と時刻。 |
|
バウンスの一意の ID。 |
|
からの 注記このフィールドは、配信ステータス通知 (DSN) がバウンスにアタッチされた場合にのみ表示されます。 |
バウンスとなった受取人
バウンスイベントには、1 人の受信者に関するものと複数の受信者に関するものがあります。bouncedRecipients
フィールドにはオブジェクトのリストが含まれ (バウンスを作成した E メールアドレスの受信者ごとに 1 つのオブジェクト)、以下のフィールドが含まれています。
フィールド名 | 説明 |
---|---|
|
受取人の E メールアドレス。DSN が使用可能な場合、これは からの |
オプションで、 DSNがバウンスにアタッチされている場合、次のフィールドも存在する可能性があります。
フィールド名 | 説明 |
---|---|
|
からの |
|
からの |
|
レポート によって発行されたステータスコードMTA。これは、 の |
バウンスのタイプ
各バウンスイベントは、以下の表に示すいずれかのタイプになります。
イベント発行システムは、Amazon によって再試行されなくなったハードバウンスとソフトバウンスのみを公開しますSES。とマークされたバウンスを受け取ったらPermanent
、対応する E メールアドレスをメーリングリストから削除する必要があります。今後送信することはできません。 Transient
バウンスは、メッセージのソフトバウンスが複数回発生し、Amazon SESが再配信を停止したときに送信されます。最初は Transient
バウンスとして返されても、将来的には同じアドレスに正常に再送できる場合があります。
bounceType | bounceSubType | 説明 |
---|---|---|
|
|
Amazon SES は特定のバウンス理由を特定できませんでした。 |
|
|
Amazon は一般的なハードバウンスSESを受け取りました。このタイプのバウンスを受信した場合は、メーリングリストからこの受信者のメールアドレスを削除する必要があります。 |
|
|
ターゲット E メールアドレスが存在しないため、Amazon は永続的なハードバウンスSESを受け取りました。このタイプのバウンスを受信した場合は、メーリングリストからこの受信者のメールアドレスを削除する必要があります。 |
|
|
Amazon SES は、無効なアドレスとしてバウンスした最近の履歴があるため、このアドレスへの送信を抑制しました。グローバルサプレッションリストを上書きするには、「Amazon SESアカウントレベルのサプレッションリストの使用」を参照してください。 |
Permanent |
OnAccountSuppressionList |
Amazon SES は、アカウントレベルのサプレッションリスト に含まれているため、このアドレスへの送信を抑制しました。これは、バウンス率のメトリクスに対してはカウントされません。 |
|
|
Amazon は一般的なバウンスSESを受け取りました。今後、この受信者に正常に再送できる可能性があります。 |
|
|
Amazon はメールボックスのフルバウンスSESを受信しました。今後、この受信者に正常に再送できる可能性があります。 |
|
|
Amazon がSESメッセージのバウンスが大きすぎました。メッセージサイズを小さくすることで、この受信者に正常に再送できる可能性があります。 |
|
|
Amazon はコンテンツ拒否バウンスSESを受信しました。メッセージのコンテンツを変更することで、この受信者に正常に再送できる可能性があります。 |
|
|
Amazon は、バウンスを拒否された添付ファイルSESを受信しました。添付ファイルを削除または変更することで、この受信者に正常に再送できる可能性があります。 |
苦情のオブジェクト
Complaint
イベントに関する情報を含むJSONオブジェクトには、次のフィールドがあります。
フィールド名 | 説明 |
---|---|
|
苦情を送信した可能性がある受取人に関する情報を含むリスト。 |
|
が苦情通知ISPを送信したときの ISO8601 形式 (YYYY-MM-DDThh:mm:ss.sZ) の日付と時刻。 |
|
苦情の一意の ID。 |
|
Amazon によって決定される苦情のサブタイプSES。 |
また、フィードバックレポートが苦情に添付されている場合、以下のフィールドが示される場合があります。
フィールド名 | 説明 |
---|---|
|
フィードバックレポートの |
|
から受信したフィードバックレポートの |
|
フィードバックレポートの |
苦情を申告した受取人
complainedRecipients
フィールドには、苦情の送信元と思われる受信者のリストが含まれます。
重要
ほとんどの は、苦情を送信した受信者の E メールアドレスISPsを編集します。このため、complainedRecipients
フィールドには、苦情通知を発行したドメインにアドレスが含まれていて、E メールが送信された全員のリストが含まれます。
JSON このリスト内の オブジェクトには、次のフィールドが含まれます。
フィールド名 | 説明 |
---|---|
|
受取人の E メールアドレス。 |
苦情のタイプ
Internet Assigned Numbers Authority のウェブサイトcomplaintFeedbackType
フィールドに次の苦情タイプが表示されることがあります。
フィールド名 | 説明 |
---|---|
|
迷惑メールまたはその他のメール不正使用。 |
|
E メールの認証障害レポート |
|
なんらかの詐欺またはフィッシング行為を示します。 |
|
レポートの提供者がこのメッセージをスパムではないと見なしていることを示します。このタイプは、誤ってスパムとしてタグ付けまたは分類されたメッセージを修正するために使用される場合があります。 |
|
その他の登録されたタイプに該当しないフィードバックを示します。 |
|
元のメッセージでウイルスが見つかったことを示します。 |
苦情のサブタイプ
complaintSubType
フィールドの値は、null または OnAccountSuppressionList
のいずれかになります。値が の場合OnAccountSuppressionList
、Amazon はメッセージSESを受け入れましたが、アカウントレベルのサプレッションリスト にあったため、送信を試みませんでした。
配信オブジェクト
Delivery
イベントに関する情報を含むJSONオブジェクトには、次のフィールドがあります。
フィールド名 | 説明 |
---|---|
|
Amazon が E メールを受信者のメールサーバーにSES配信した日時を ISO8601 形式 (YYYY-MM-DDThh:mm:ss.sZ) で表します。 |
|
Amazon が送信者からのリクエストをSES承諾してから、Amazon が受信者のメールサーバーにメッセージをSES渡したまでの時間をミリ秒単位で表します。 |
|
配信イベントの適用対象となる受信者のリスト。 |
|
Amazon からの E メールを受け入れISPたリモートのSMTP応答メッセージSES。このメッセージは、E メール、メールサーバー、および の受信によって異なりますISP。 |
|
メールを送信した Amazon SESメールサーバーのホスト名。 |
Send オブジェクト
send
イベントに関する情報を含むJSONオブジェクトは常に空です。
Reject オブジェクト
Reject
イベントに関する情報を含むJSONオブジェクトには、次のフィールドがあります。
フィールド名 | 説明 |
---|---|
|
メールが拒否された理由。指定できる値は のみです。つまり |
Open オブジェクト
Open
イベントに関する情報を含むJSONオブジェクトには、次のフィールドがあります。
フィールド名 | 説明 |
---|---|
|
受信側の IP アドレス |
|
オープンイベントが ISO8601 形式で発生した日時 (YYYY-MM-DDThh:mm:ss.sZ)。 |
|
受取人がメールを開くために使用したしたデバイスまたは E メールクライアントのユーザーエージェント。 |
Click オブジェクト
Click
イベントに関する情報を含むJSONオブジェクトには、次のフィールドがあります。
フィールド名 | 説明 |
---|---|
|
受信側の IP アドレス |
|
クリックイベントが ISO8601 形式で発生した日時 (YYYY-MM-DDThh:mm:ss.sZ)。 |
|
受信者が E メールのリンクをクリックするために使用したクライアントのユーザーエージェント。 |
|
受信者がクリックしたリンクURLの 。 |
|
|
レンダリング失敗オブジェクト
Rendering Failure
イベントに関する情報を含むJSONオブジェクトには、次のフィールドがあります。
フィールド名 | 説明 |
---|---|
|
E メールの送信に使用されるテンプレートの名前。 |
|
レンダリング失敗に関する詳細情報を提供するメッセージ。 |
DeliveryDelay オブジェクト
DeliveryDelay
イベントに関する情報を含むJSONオブジェクトには、次のフィールドがあります。
フィールド名 | 説明 |
---|---|
|
遅延のタイプ。可能な値は以下のとおりです。
|
|
E メールの受取人に関する情報を含むオブジェクト。 |
|
Amazon SESがメッセージの配信を停止する日時。この値は 8601 ISO 形式で表示されます。 |
|
遅延を報告したメッセージ転送エージェント (MTA) の IP アドレス。 |
|
遅延が発生した日時。8601 ISO 形式で表示されます。 |
遅延受取人
delayedRecipients
オブジェクトには、以下の値が含まれています。
フィールド名 | 説明 |
---|---|
|
メッセージの配信が遅れる原因となった E メールアドレス。 |
|
配信遅延に関連付けられたSMTPステータスコード。 |
|
受信側の Message Transfer Agent () によって提供される診断コードMTA。 |
サブスクリプションオブジェクト
Subscription
イベントに関する情報を含むJSONオブジェクトには、次のフィールドがあります。
フィールド名 | 説明 |
---|---|
|
連絡先が含まれているリストの名前。 |
|
がサブスクリプション通知ISPを送信したときの ISO8601 形式 (YYYY-MM-DDThh:mm:ss.sZ) の日付と時刻。 |
|
メッセージが送信された E メールアドレス (エンベロープMAILFROMアドレス)。 |
|
連絡先リスト内のすべてのトピックのサブスクリプションステータスを指定するJSONデータ構造 (マップ)。変更後のステータスを示します (連絡先がサブスクライブまたはサブスクライブ解除)。 |
|
連絡先リスト内のすべてのトピックのサブスクリプションステータスを指定するJSONデータ構造 (マップ)。変更前のステータス (連絡先がサブスクライブまたはサブスクライブ解除) を示します。 |
新旧トピックの設定
newTopicPreferences
および oldTopicPreferences
オブジェクトには、以下の値が含まれています。
フィールド名 | 説明 |
---|---|
|
連絡先リストのすべてのトピックから、連絡先がサブスクライブ解除されているかどうかを指定します。 |
|
指定されたイベントタイプの から通知を受信するように現在サブスクライブされているかどうかを示す |
|
イベント送信先に追加された新しいトピックがデフォルトでサブスクライブされるか、サブスクライブ解除されるかを決定する |