Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Amazon-SNS-Benachrichtigungsinhalte für Amazon SES
Bounce-, Beschwerde- und Lieferbenachrichtigungen werden unter Amazon Simple Notification Service (Amazon SNS)notificationType-Zeichenfolge und ein mail-Objekt sowie entweder ein bounce-Objekt, ein complaint-Objekt oder ein delivery-Objekt.
In den folgenden Abschnitten finden Sie Beschreibungen der verschiedenen Objekttypen:
Im Folgenden finden Sie einige wichtige Hinweise zum Inhalt der Amazon-SNS-Benachrichtigungen für Amazon SES::
-
Bei einem angegebenen Benachrichtigungstyp erhalten Sie unter Umständen eine Amazon-SNS-Benachrichtigung für mehrere Empfänger oder aber pro Empfänger eine Amazon-SNS-Benachrichtigung. Ihr Code sollte in der Lage sein, die Amazon SNS-Benachrichtigung zu analysieren und beide Fälle zu behandeln. SES gibt keine Bestell- oder Batching-Garantien für Benachrichtigungen, die über Amazon SNS gesendet werden. Unterschiedliche Amazon-SNS-Benachrichtigungstypen (beispielsweise Unzustellbarkeit und Beschwerden) werden jedoch nicht in einer einzelnen Benachrichtigung zusammengefasst.
-
Sie erhalten möglicherweise verschiedene Amazon-SNS-Benachrichtigungstypen für einen Empfänger. So ist es beispielsweise möglich, dass der empfangende E-Mail-Server die E-Mail akzeptiert (und eine Zustellbenachrichtigung auslöst), nach der Verarbeitung der E-Mail aber feststellt, dass die E-Mail nicht zustellbar ist (und eine Unzustellbarkeitsbenachrichtigung auslöst). Da es sich jedoch um verschiedene Benachrichtigungstypen handelt, werden immer separate Benachrichtigungen gesendet.
-
SES behält sich das Recht vor, den Benachrichtigungen zusätzliche Felder hinzuzufügen. Deshalb müssen Anwendungen, die diese Benachrichtigungen analysieren, in der Lage sein, unbekannte Felder zu verarbeiten.
-
SES überschreibt die Kopfzeilen der Nachricht, wenn es die E-Mail sendet. Sie können die Header der ursprünglichen Nachricht aus den Feldern
headersundcommonHeadersdesmail-Objekts abrufen.
JSON-Objekt der obersten Ebene
Das JSON-Objekt der obersten Ebene in einer SES-Benachrichtigung enthält die folgenden Felder.
| Feldname | Beschreibung |
|---|---|
notificationType |
Eine Zeichenfolge, die den Typ der Benachrichtigung enthält, der vom JSON-Objekt dargestellt wird. Die möglichen Werte sind Wenn Sie Einrichten der Ereignisveröffentlichung wählen, heißt dieses Feld |
mail |
Ein JSON-Objekt, das Informationen zur ursprünglichen E-Mail enthält, auf die sich die Benachrichtigung bezieht. Weitere Informationen finden Sie unter Mail-Objekt. |
bounce |
Dieses Feld ist nur dann vorhanden, wenn |
complaint |
Dieses Feld ist nur dann vorhanden, wenn |
delivery |
Dieses Feld ist nur dann vorhanden, wenn |
Mail-Objekt
Jede Benachrichtigung über eine Unzustellbarkeit, Beschwerde oder Lieferung enthält Informationen über die ursprüngliche E-Mail-Benachrichtigung im mail-Objekt. Das JSON-Objekt enthält Informationen über ein mail-Objekt mit den folgenden Feldern.
| Feldname | Beschreibung |
|---|---|
timestamp
|
Der Zeitpunkt, zu dem die ursprüngliche Nachricht gesendet wurde (im ISO86 01-Format). |
messageId
|
Eine eindeutige ID, die SES der Nachricht zugewiesen hat. SES hat Ihnen diesen Wert zurückgegeben, als Sie die Nachricht gesendet haben. AnmerkungDiese Nachrichten-ID wurde von SES zugewiesen. Sie finden diese Mitteilungs-ID in der ursprünglichen E-Mail in den Feldern |
source
|
Die E-Mail-Adresse, von der die ursprüngliche Nachricht gesendet wurde (die Envelope-MAIL-FROM-Adresse). |
sourceArn
|
Der Amazon-Ressourcenname (ARN) der Identität, die zum Senden der E-Mail verwendet wurde. Im Fall einer Sendeautorisierung gibt |
sourceIp
|
Die ursprüngliche öffentliche IP-Adresse des Clients, der die E-Mail-Versandanfrage an SES ausgeführt hat. |
sendingAccountId
|
Die AWS-Konto ID des Kontos, das zum Senden der E-Mail verwendet wurde. Im Fall einer Sendeautorisierung gibt |
callerIdentity
|
Die IAM-Identität des SES-Benutzers, der die E-Mail gesendet hat. |
destination
|
Eine Liste der E-Mail-Adressen, an die die ursprüngliche E-Mail gesendet wurde. |
headersTruncated
|
Dieses Objekt ist nur vorhanden, wenn Sie die Benachrichtigungseinstellungen so konfiguriert haben, dass die Header der ursprünglichen E-Mail eingeschlossen werden. Gibt an, ob die Kopfzeilen in der Benachrichtigung abgeschnitten werden. SES kürzt die Kopfzeilen in der Benachrichtigung, wenn die Kopfzeilen der ursprünglichen Nachricht mindestens 10 KB groß sind. Mögliche Werte sind |
headers
|
Dieses Objekt ist nur vorhanden, wenn Sie die Benachrichtigungseinstellungen so konfiguriert haben, dass die Header der ursprünglichen E-Mail eingeschlossen werden. Eine Liste der ursprünglichen Header der E-Mail. Jeder Header in der Liste verfügt über die Felder AnmerkungJede Nachrichten-ID innerhalb des |
commonHeaders
|
Dieses Objekt ist nur vorhanden, wenn Sie die Benachrichtigungseinstellungen so konfiguriert haben, dass die Header der ursprünglichen E-Mail eingeschlossen werden. Enthält Informationen über häufig verwendete E-Mail-Header aus der ursprünglichen E-Mail, einschließlich der Felder für den Absender, Empfänger und den Betreff. Innerhalb dieses Objekt ist jeder Header ein Schlüssel. Die Absender- und Empfängerfelder werden durch Arrays repräsentiert, die mehrere Werte enthalten. AnmerkungBei Ergeinissen ist dies die Nachrichten-ID im Feld |
Im Folgenden finden Sie ein Beispiel eines mail-Objekts, das die Header der ursprünglichen E-Mail enthält. Wenn dieser Benachrichtigungstyp nicht so konfiguriert wurde, dass die ursprünglichen E-Mail-Header eingeschlossen werden, enthält das mail-Objekt die Felder headersTruncated, headers und commonHeaders nicht.
{ "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" } }
Bounce-Objekt
Das JSON-Objekt, das Informationen zu Unzustellbarkeiten enthält, weist die folgenden Felder auf.
| Feldname | Beschreibung |
|---|---|
bounceType
|
Die Art des Bounces, wie von SES festgelegt. Weitere Informationen finden Sie unter Unzustellbarkeitstypen. |
bounceSubType
|
Der Subtyp des Bounces, wie von SES bestimmt. Weitere Informationen finden Sie unter Unzustellbarkeitstypen. |
bouncedRecipients
|
Eine Liste mit Informationen über die Empfänger der ursprünglichen E-Mail, an die diese nicht zugestellt werden konnte. Weitere Informationen finden Sie unter Empfänger, an die nicht zugestellt werden konnte. |
timestamp
|
Das Datum und die Uhrzeit, zu denen der Bounce gesendet wurde (im Format ISO86 01). Beachten Sie, dass dies die Uhrzeit ist, zu der die Benachrichtigung vom ISP gesendet wurde, und nicht die Uhrzeit, zu der sie bei SES eingegangen ist. |
feedbackId
|
Eine eindeutige ID für die Unzustellbarkeit. |
Wenn SES in der Lage war, die Remote Message Transfer Authority (MTA) zu kontaktieren, ist das folgende Feld ebenfalls vorhanden.
| Feldname | Beschreibung |
|---|---|
remoteMtaIp
|
Die IP-Adresse des MTA, an den SES versucht hat, die E-Mail zuzustellen. |
Wurde der Unzustellbarkeitsbenachrichtigung eine Zustellungsstatusbenachrichtigung (DSN, Delivery Status Notification) angefügt, ist auch das folgende Feld enthalten.
| Feldname | Beschreibung |
|---|---|
reportingMTA
|
Der Wert des |
Es folgt ein Beispiel für ein bounce-Objekt.
{ "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" }
Empfänger, an die nicht zugestellt werden konnte
Eine Benachrichtigung über die Unzustellbarkeit kann für einen einzelnen Empfänger oder für mehrere Empfänger gelten. Das bouncedRecipients-Feld enthält eine Liste von Objekten – eines pro Empfänger, für den die Benachrichtigung über die Unzustellbarkeit gilt – und weist zusätzlich immer das folgende Feld auf.
| Feldname | Beschreibung |
|---|---|
emailAddress
|
Die E-Mail-Adresse des Empfängers. Ist eine DSN verfügbar, ist dies der Wert des |
Wurde eine DSN an eine Unzustellbarkeitsbenachrichtigung angehängt, sind möglicherweise folgende Felder ebenfalls vorhanden.
| Feldname | Beschreibung |
|---|---|
action
|
Der Wert des |
status
|
Der Wert des |
diagnosticCode
|
Der vom berichtenden MTA gemeldete Statuscode. Dies ist der Wert des |
Das folgende Beispiel zeigt ein Objekt, das möglicherweise in der bouncedRecipients-Liste enthalten ist.
{ "emailAddress": "recipient@example.com", "action": "failed", "status": "5.0.0", "diagnosticCode": "X-Postfix; unknown user" }
Unzustellbarkeitstypen
Das Bounce-Objekt enthält den Bounce-TypUndetermined, Permanent (hart) oder Transient (weich). Die Bounce-Typen Permanent (Hard) und Transient (Soft) können auch einen von mehreren Bounce-Untertypen enthalten.
Wenn Sie eine Bounce-Benachrichtigung mit dem Bounce-Typ Transient (Soft) erhalten, können Sie möglicherweise in future eine E-Mail an diesen Empfänger senden, wenn das Problem, das zum Bounce der Nachricht geführt hat, behoben ist.
Wenn Sie eine Bounce-Benachrichtigung mit dem Bounce-Typ Permanent (schwer) erhalten, ist es unwahrscheinlich, dass Sie in future E-Mails an diesen Empfänger senden können. Aus diesem Grund sollten Sie sofort den Empfänger, dessen Adresse die Unzustellbarkeit erzeugt hat, aus Ihren Mailinglisten entfernen.
Anmerkung
Wenn ein Soft Bounce auftritt (ein Bounce, der auf ein vorübergehendes Problem zurückzuführen ist, z. B. wenn der Posteingang des Empfängers voll ist), versucht SES, die E-Mail für einen bestimmten Zeitraum erneut zuzustellen. Wenn SES die E-Mail am Ende dieses Zeitraums immer noch nicht zustellen kann, wird der Versuch eingestellt.
SES sendet Benachrichtigungen für Hard Bounces und für Soft Bounces, die nicht mehr zugestellt wurden. Wenn Sie jedes Mal eine Benachrichtigung erhalten möchten, wenn eine temporäre Unzustellbarkeit auftritt, aktivieren Sie die Ereignisveröffentlichung und konfigurieren Sie sie so, dass Benachrichtigungen gesendet werden, wenn Zustellungsverzögerungsereignisse auftreten.
| bounceType | bounceSubType | Beschreibung |
|---|---|---|
Undetermined
|
Undetermined
|
Der E-Mail-Anbieter des Empfängers hat eine Unzustellbarkeitsnachricht gesendet. Die Bounce-Nachricht enthielt nicht genügend Informationen, damit SES den Grund für den Bounce ermitteln konnte. Die Unzustellbarkeits-E-Mail, die an die Adresse im Return-Path-Header der E-Mail gesendet wurde, die zur Unzustellbarkeit geführt hat, enthält möglicherweise zusätzliche Informationen zum Problem, das die Unzustellbarkeit der E-Mail verursacht hat. |
Permanent
|
General
|
Der E-Mail-Anbieter des Empfängers hat eine Nachricht mit permanenter Unzustellbarkeit gesendet. WichtigWenn Sie diese Art von Unzustellbarkeitsbenachrichtigung erhalten, sollten Sie die E-Mail-Adresse des Empfängers sofort aus Ihrer Mailingliste entfernen. Das Senden von Nachrichten an Adressen, die permanente Unzustellbarkeiten erzeugen, kann negative Auswirkungen auf Ihren guten Ruf als Absender haben. Wenn Sie weiter E-Mails an Adressen senden, die permanente Unzustellbarkeiten erzeugen, können wir Ihre Fähigkeit, weitere E-Mails zu senden, vorübergehend unterbrechen. Siehe Verwenden der Unterdrückungsliste auf Kontoebene der Amazon-SES-Konsole. |
Permanent
|
NoEmail
|
Es war nicht möglich, die E-Mail-Adresse des Empfängers aus der unzustellbaren Nachricht abzurufen. |
Permanent
|
Suppressed
|
Die E-Mail-Adresse des Empfängers steht auf der SES-Unterdrückungsliste, da sie in jüngster Zeit zu Hard Bounces geführt hat. Informationen zum Überschreiben der globalen Unterdrückungsliste finden Sie unterVerwenden der Unterdrückungsliste auf Kontoebene der Amazon-SES-Konsole. |
Permanent
|
OnAccountSuppressionList
|
SES hat das Senden an diese Adresse unterdrückt, da sie auf der Sperrliste auf Kontoebene steht. Dies zählt nicht für Ihre Unzustellbarkeitsraten-Metrik. |
Permanent
|
UnsubscribedRecipient
|
Dieser Bounce-Typ tritt auf, wenn der Kontakt des Empfängers das Thema abbestellt hat und ihm mithilfe der Listenverwaltungsoptionen eine E-Mail zugesandt wird. SES respektiert die Kontaktpräferenz und versucht nicht, sie zuzustellen. Außerdem wirkt sich diese Zurückweisung nicht auf die Reputation des Absenders aus, da die Zustellung nicht versucht wurde und der Kontakt des Empfängers aufgrund der Zurückweisung auch nicht zu einer Unterdrückungsliste hinzugefügt wurde. TippEs wird empfohlen, UnsubscribedRecipient Ereignisse zu abonnieren, um zu vermeiden, dass weiterhin Nachrichten an Empfänger gesendet werden, die sich nicht angemeldet haben. Überlegen Sie. Verwenden von Listenverwaltung Die Listenverwaltung sollte die Quelle der Wahrheit für Ihre Abonnentenliste sein. Aus Sicht der SES-Durchsetzung haben Sie den Ruf, sich nicht an bewährte Methoden für den E-Mail-Versand zu halten, wenn Sie weiterhin Nachrichten an unterdrückte oder abgemeldete Empfänger versenden. |
Transient
|
General
|
Der E-Mail-Anbieter des Empfängers hat eine allgemeine Unzustellbarkeitsnachricht gesendet. Sie können in Zukunft Nachrichten an denselben Empfänger senden, wenn das Problem, das zur Unzustellbarkeit führte, gelöst ist. AnmerkungWenn Sie eine E-Mail an einen Empfänger senden, der über eine aktive automatische Antwortregel (z. B. eine "außer Haus"-Abwesenheitsnachricht) verfügt, erhalten Sie möglicherweise diese Art von Benachrichtigung. Auch wenn die Antwort den Benachrichtigungstyp hat |
Transient
|
MailboxFull
|
Der E-Mail-Anbieter des Empfängers hat eine Unzustellbarkeitsnachricht gesendet, da der Posteingang des Empfängers voll ist. Sie können in Zukunft Nachrichten an denselben Empfänger senden, sobald das Postfach nicht mehr voll ist. |
Transient
|
MessageTooLarge
|
Der E-Mail-Anbieter des Empfängers hat eine Unzustellbarkeitsnachricht gesendet, da die Nachricht, die Sie gesendet haben, zu groß ist. Sie können Nachrichten an denselben Empfänger senden, wenn Sie die Größe der Nachricht reduzieren. |
Transient
|
ContentRejected
|
Der E-Mail-Anbieter des Empfängers hat eine Unzustellbarkeitsnachricht gesendet, da die von Ihnen gesendete Nachricht Inhalte enthält, die der Anbieter nicht erlaubt. Sie können Nachrichten an denselben Empfänger senden, wenn Sie den Inhalt der Nachricht ändern. |
Transient
|
AttachmentRejected
|
Der E-Mail-Anbieter des Empfängers hat eine Unzustellbarkeitsnachricht gesendet, da die Nachricht einen nicht akzeptablen Anhang enthält. Beispiel: Einige E-Mail-Anbieter können Nachrichten mit Anhängen eines bestimmten Dateityps oder Nachrichten mit sehr großen Anhängen ablehnen. Sie können Nachrichten an denselben Empfänger senden, wenn Sie den Inhalt des Anhangs entfernen oder ändern. |
Complaint-Objekt
Das JSON-Objekt, das Informationen zu Beschwerden enthält, weist die folgenden Felder auf.
| Feldname | Beschreibung |
|---|---|
complainedRecipients
|
Eine Liste mit Informationen zu Empfängern, die möglicherweise für die Beschwerde verantwortlich sind. Weitere Informationen finden Sie unter Empfänger, die sich beschwert haben. |
timestamp
|
Das Datum und der Zeitpunkt, zu dem der ISP die Beschwerdebenachrichtigung gesendet hat, im Format ISO 8601. Das Datum und die Uhrzeit in diesem Feld stimmen möglicherweise nicht mit dem Datum und der Uhrzeit überein, an dem SES die Benachrichtigung erhalten hat. |
feedbackId
|
Eine eindeutige ID, die mit der Beschwerde verknüpft ist. |
complaintSubType
|
Der Wert des Feldes |
Ist zudem ein Feedback-Bericht an die Beschwerde angehängt, sind möglicherweise die folgenden Felder vorhanden.
| Feldname | Beschreibung |
|---|---|
userAgent
|
Der Wert des |
complaintFeedbackType
|
Der Wert des |
arrivalDate
|
Der Wert des |
Es folgt ein Beispiel für ein complaint-Objekt.
{ "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" }
Empfänger, die sich beschwert haben
Das complainedRecipients-Feld enthält eine Liste von Empfängern, die sich möglicherweise beschwert haben. Anhand dieser Informationen sollten Sie ermitteln, welcher Empfänger die Beschwerde eingereicht hat, und diesen Empfänger dann sofort aus Ihren Mailinglisten entfernen.
Wichtig
Die meisten ISPs entfernen die E-Mail-Adresse des Empfängers, der die Beschwerde eingereicht hat, aus ihrer Beschwerdebenachrichtigung. Aus diesem Grund enthält diese Liste Informationen zu Empfängern, die sich beschwert haben könnten. Dabei basiert die Einschätzung auf den Empfängern der ursprünglichen E-Mail und dem ISP, von dem wir die Beschwerde erhalten haben. SES führt eine Suche anhand der ursprünglichen Nachricht durch, um diese Empfängerliste zu ermitteln.
JSON-Objekte in dieser Liste enthalten das folgende Feld.
| Feldname | Beschreibung |
|---|---|
emailAddress
|
Die E-Mail-Adresse des Empfängers. |
Es folgt ein Beispiel für ein Complained-Recipient-Objekt.
{ "emailAddress": "recipient1@example.com" }
Anmerkung
Aufgrund dieses Verhaltens können Sie besser einschätzen, von welchen E-Mail-Adressen Beschwerden über Ihre Nachricht kamen, wenn Sie das Senden auf eine Nachricht pro Empfänger beschränken (und nicht eine Nachricht an 30 verschiedene E-Mail-Adressen im Feld "BCC" senden).
Beschwerdetypen
Sie sehen möglicherweise die folgenden Beschwerdetypen im complaintFeedbackType-Feld, so wie sie vom meldenden ISP entsprechend der Website zu Internet Assigned Numbers Authority
-
abuse– Weist auf eine unerwünschte E-Mail oder eine andere Art von E-Mail-Missbrauch hin. -
auth-failure– Bericht über einen E-Mail-Authentifizierungsfehler. -
fraud– Weist auf einen Betrug oder Phishing hin. -
not-spam– Weist darauf hin, dass die Entität, die den Bericht bereitstellt, die Nachricht nicht als Spam betrachtet. Dies kann verwendet werden, um eine Nachricht zu korrigieren, die fälschlicherweise als Spam gekennzeichnet oder kategorisiert wurde. -
other– Gibt eine andere Art von Feedback an, dass nicht zu den registrierten Typen passt. -
virus– Meldet, dass in der ursprünglichen Nachricht ein Virus entdeckt wurde.
Delivery-Objekt
Das JSON-Objekt, das die Informationen zu Zustellungen enthält, weist immer die folgenden Felder auf.
| Feldname | Beschreibung |
|---|---|
timestamp
|
Der Zeitpunkt, zu dem SES die E-Mail an den E-Mail-Server des Empfängers zugestellt hat (im Format ISO86 01). |
processingTimeMillis
|
Die Zeit in Millisekunden zwischen der Annahme der Anfrage des Absenders durch SES und der Weiterleitung der Nachricht an den E-Mail-Server des Empfängers. |
recipients
|
Eine Liste der beabsichtigten Empfänger der E-Mail, für die die Zustellungsbenachrichtigung gilt. |
smtpResponse
|
Die SMTP-Antwortnachricht des Remote-ISP, der die E-Mail von SES akzeptiert hat. Diese Nachricht variiert je nach E-Mail, empfangendem Mail-Server und empfangendem ISP. |
reportingMTA
|
Der Hostname des SES-Mailservers, der die E-Mail gesendet hat. |
remoteMtaIp
|
Die IP-Adresse des MTA, an den SES die E-Mail gesendet hat. |
Es folgt ein Beispiel für ein delivery-Objekt.
{ "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" }