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.
# Verwenden von Benachrichtigungen für den Amazon SNS E-Mail-Empfang
Sie können Amazon SES so konfigurieren, dass ein Amazon-SNS-Thema benachrichtigt wird, wenn Sie Unzustellbarkeitsnachrichten oder Beschwerden erhalten oder wenn E-Mails übermittelt werden. Amazon SNS SNS-Benachrichtigungen sind im Format [JavaScript Object Notation (JSON)](http://www.json.org), sodass Sie sie programmgesteuert verarbeiten können.
Zum Senden von E-Mails mit Amazon SES müssen Sie es so konfigurieren, dass Unzustellbarkeits- und Beschwerdebenachrichtigungen gesendet werden. Verwenden Sie dazu eine der folgenden Methoden:
+ Senden von Benachrichtigungen an ein Amazon-SNS-Thema. Die Schritte zum Einrichten dieser Art von Benachrichtigung sind in diesem Abschnitt enthalten.
+ Aktivieren der Weiterleitung von E-Mail-Feedback. Weitere Informationen finden Sie unter [Verwenden von Benachrichtigungen für den Amazon-SES-E-Mail-Empfang](monitor-sending-activity-using-notifications-email.md).
+ Veröffentlichen von Ereignisbenachrichtigungen. Weitere Informationen finden Sie unter [Überwachen des E-Mail-Versands mithilfe der Amazon SES-Ereignisveröffentlichung](monitor-using-event-publishing.md).
**Wichtig**
Wichtige Informationen zu Benachrichtigungen finden Sie unter [Einrichten von Ereignisbenachrichtigungen für Amazon SES](monitor-sending-activity-using-notifications.md).
**Topics**
+ [Konfigurieren von Amazon-SNS-Benachrichtigungen für Amazon SES](configure-sns-notifications.md)
+ [Amazon-SNS-Benachrichtigungsinhalte für Amazon SES](notification-contents.md)
+ [Amazon-SNS-Benachrichtigungsbeispiele für Amazon SES](notification-examples.md)
# Konfigurieren von Amazon-SNS-Benachrichtigungen für Amazon SES
Amazon SES kann Sie über Unzustellungszustellungen, Beschwerden und Zustellungen über[Amazon Simple Notification Service (Amazon SNS)](https://aws.amazon.com/sns)benachrichtigen.
Sie können die Benachrichtigungen mit der Amazon-SES-Konsole oder mithilfe der Amazon-SES-API konfigurieren.
**Topics**
+ [Voraussetzungen](#configure-feedback-notifications-prerequisites)
+ [Konfigurieren von Benachrichtigungen mit der Amazon-SES-Konsole](#configure-feedback-notifications-console)
+ [Konfigurieren von Benachrichtigungen mit der Amazon-SES-API](#configure-feedback-notifications-api)
+ [Fehlerbehebung bei Feedback-Benachrichtigungen](#configure-feedback-notifications-troubleshooting)
## Voraussetzungen
Führen Sie die folgenden Schritte aus, bevor Sie Amazon-SNS-Benachrichtigungen in Amazon SES einrichten:
1. Erstellen Sie ein Amazon SNS-Thema. Weitere Informationen finden Sie unter [Erstellen eines Themas](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) im *Amazon Simple Notification Service-Entwicklerhandbuch*.
**Wichtig**
Wenn Sie Ihr Thema mit Amazon SNS erstellen, wählen Sie für **Type** (Typ) nur **Standard** (Standard) aus. (SES unterstützt keine FIFO-Typ-Themen.)
Unabhängig davon, ob Sie ein neues SNS-Thema erstellen oder ein vorhandenes auswählen, müssen Sie Zugriff auf SES gewähren, um Benachrichtigungen für das Thema zu veröffentlichen.
Um Amazon SES die Berechtigung zum Veröffentlichen von Benachrichtigungen für das Thema zu erteilen, erweitern Sie auf dem Bildischirm **Edit topic (Thema bearbeiten)** der SNS-Konsole die **Access policy (Zugriffsrichtlinie)** und fügen Sie im **JSON editor (JSON-Editor)** die folgende Berechtigungsrichtlinie hinzu:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "notification-policy",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "ses.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "arn:aws:sns:us-east-1:111122223333:topic_name",
"Condition": {
"StringEquals": {
"AWS:SourceAccount": "111122223333",
"AWS:SourceArn": "arn:aws:ses:topic_region:111122223333:identity/identity_name"
}
}
}
]
}
```
------
Nehmen Sie im vorherigen Beispiel Sie die folgenden Änderungen vor:
+ *topic\$1region*Ersetzen Sie es durch die AWS Region, in der Sie das SNS-Thema erstellt haben.
+ Ersetzen Sie *111122223333* durch Ihre AWS -Konto-ID.
+ *topic\$1name*Ersetzen Sie es durch den Namen Ihres SNS-Themas.
+ Ersetze es durch die verifizierte Identität (E-Mail-Adresse oder Domain), *identity\$1name* mit der du das SNS-Thema abonniert hast.
1. Abonnieren Sie mindestens einen Endpunkt für das Thema. Wenn Sie beispielsweise Benachrichtigungen per Textnachricht erhalten möchten, abonnieren Sie einen SMS-Endpunkt (d. h. eine Mobiltelefonnummer) für das Thema. Um Benachrichtigungen per E-Mail zu erhalten, abonnieren Sie einen E-Mail-Endpunkt (eine E-Mail-Adresse) für das Thema.
Weitere Informationen dazu erhalten Sie unter [Erste Schritte](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) im *Amazon Simple Notification Service Leitfaden*.
1. (Optional) Wenn Ihr Amazon SNS SNS-Thema AWS Key Management Service (AWS KMS) für die serverseitige Verschlüsselung verwendet, müssen Sie der AWS KMS Schlüsselrichtlinie Berechtigungen hinzufügen. Sie können Berechtigungen hinzufügen, indem Sie die folgende Richtlinie an die Schlüsselrichtlinie anhängen: AWS KMS
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowSESToUseKMSKey",
"Effect": "Allow",
"Principal": {
"Service": "ses.amazonaws.com"
},
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": "*"
}
]
}
```
------
## Konfigurieren von Benachrichtigungen mit der Amazon-SES-Konsole
**So konfigurieren Sie Benachrichtigungen mithilfe der Amazon-SES-Konsole**
1. Öffnen Sie die Amazon SES SES-Konsole unter [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).
1. Wählen Sie im Navigationsbereich unter **Konfiguration** die Option **Identitäten** aus.
1. Wählen Sie im Container **Identities** (Identitäten) die bestätigte Identität aus, für die Sie Feedback-Benachrichtigungen erhalten möchten, wenn eine von dieser Identität gesendete Nachricht entweder zu einer Unzustellbarkeit, Beschwerde oder Zustellung führt.
**Wichtig**
Die Benachrichtigungseinstellungen für die verifizierte Domäne gelten für alle E-Mail-Adressen in dieser Domäne, *außer* für E-Mail-Adressen, die auch noch verifiziert sind.
1. Wählen Sie im Detailfenster der ausgewählten bestätigten Identität die Registerkarte **Notification** (Benachrichtigungen) und wählen Sie **Edit** (Bearbeiten) im Container **Feedback notifications** (Feedback-Benachrichtigungen).
1. Erweitern Sie das Listenfeld SNS-Thema jedes Feedback-Typs, für den Sie Benachrichtigungen erhalten möchten, und wählen Sie entweder ein SNS-Thema aus, das Ihnen gehört, **No SNS topic** (Kein SNS-Thema) oder ein **SNS topic you don‘t own** (SNS-Thema, das Ihnen nicht gehört).
1. Wenn Sie ein **SNS-Thema, das Ihnen nicht gehört**, ausgewählt haben, wird das Feld **SNS topic ARN** (SNS-Themen-ARN) angezeigt, in das Sie den SNS-Themen-ARN eingeben müssen, der Ihnen von Ihrem delegierten Sender mitgeteilt wurde. (Nur Ihr delegierter Sender erhält diese Benachrichtigungen, da er das SNS-Thema besitzt. Weitere Informationen zur Sendung finden Sie unter [Übersicht über die Sendeautorisierung](sending-authorization-overview.md).)
**Wichtig**
Die Amazon SNS SNS-Themen, die Sie für Bounce-, Beschwerde- und Lieferbenachrichtigungen verwenden, müssen dieselben sein AWS-Region , in denen Sie Amazon SES verwenden.
Zusätzlich müssen Sie einen oder mehrere Endpunkte für das Thema abonniert haben, um Benachrichtigungen zu erhalten. Beispiel: Wenn Sie möchten, dass Benachrichtigungen an eine E-Mail-Adresse gesendet werden, müssen Sie einen E-Mail-Endpunkt für das Thema abonnieren. Weitere Informationen dazu erhalten Sie unter [Erste Schritte](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) im *Amazon Simple Notification Service Leitfaden*.
1. (Optional) Wenn Sie möchten, dass Ihre Themenachrichtigung die Header der ursprünglichen E-Mail einschließt, aktivieren Sie das Kontrollkästchen **Include original email headers** (Ursprüngliche E-Mail-Header einschließen) direkt unter dem SNS-Themennamen jedes Feedback-Typs. Diese Option ist nur verfügbar, sofern Sie der zugeordneten Benachrichtigungsart ein Amazon-SNS-Thema zugewiesen haben. Weitere Informationen zum Inhalt der ursprünglichen E-Mail-Header finden Sie im Abschnitt zum `mail`-Objekt unter [Benachrichtigungsinhalte](notification-contents.md).
1. Wählen Sie **Änderungen speichern ** aus. Es kann ein paar Minuten dauern, bis die Änderungen an den Benachrichtigungseinstellungen übernommen werden.
1. (Optional) Wenn Sie Amazon-SNS-Themenbenachrichtigungen sowohl für Unzustellbarkeit als auch für Beschwerden ausgewählt haben, können Sie die E-Mail-Benachrichtigungen vollständig deaktivieren, sodass Sie keine doppelten Benachrichtigungen per E-Mail und SNS-Benachrichtigungen erhalten. Um E-Mail-Benachrichtigungen für Unzustellbarkeiten und Beschwerden zu deaktivieren, wählen Sie auf der Registerkarte **Notifications** (Benachrichtigungen) auf dem Detailfenster der bestätigten Identität im Container **E-Mail-Feedback-Weiterleitung** **Edit** (Bearbeiten), deaktivieren Sie das Kontrollkästchen **Enabled** (Aktiviert) und wählen Sie **Save changes** (Änderungen speichern).
Nachdem Sie Ihre Einstellungen konfiguriert haben, werden die Unzustellbarkeits-, Beschwerde- und Zustellungsbenachrichtigungen an Ihre Amazon-SNS-Themen gesendet. Diese Benachrichtigungen sind im Format JavaScript Object Notation (JSON) und folgen der unter beschriebenen Struktur. [Benachrichtigungsinhalte](notification-contents.md)
Für Unzustellbarkeits-, Beschwerde- und Zustellungsbenachrichtigungen werden die Amazon-SNS-Standardgebühren erhoben. Weitere Informationen finden Sie in der [Amazon-SNS-](https://aws.amazon.com/sns/pricing)Preisliste.
**Anmerkung**
Wenn ein Versuch, in Ihrem Amazon SNS SNS-Thema zu veröffentlichen, fehlschlägt, weil das Thema gelöscht wurde oder Sie nicht AWS-Konto mehr über die erforderlichen Berechtigungen verfügen, entfernt Amazon SES die Konfiguration für dieses Thema, sofern es für Bounces oder Beschwerden (nicht für Lieferungen — bei Lieferbenachrichtigungen löscht SES die Konfigurationseinstellung für das SNS-Thema nicht) konfiguriert wurde. Darüber hinaus aktiviert Amazon SES E-Mail-Benachrichtigungen über Unzustellbarkeiten und Beschwerden für die Identität erneut und Sie erhalten per E-Mail eine Benachrichtigung über die Änderung. Wenn mehrere Identitäten für die Verwendung des Themas konfiguriert sind, wird die Themenkonfiguration für jede Identität geändert, wenn bei jeder Identität ein Fehler beim Veröffentlichen des Themas auftritt.
## Konfigurieren von Benachrichtigungen mit der Amazon-SES-API
Sie können Unzustellbarkeits-, Beschwerde- und Zustellungsbenachrichtigungen auch mithilfe der Amazon-SES-API konfigurieren. Verwenden Sie zum Konfigurieren von Benachrichtigungen die folgenden Operationen:
+ [SetIdentityNotificationTopic](https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityNotificationTopic.html)
+ [SetIdentityFeedbackForwardingEnabled](https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityFeedbackForwardingEnabled.html)
+ [GetIdentityNotificationAttributes](https://docs.aws.amazon.com/ses/latest/APIReference/API_GetIdentityNotificationAttributes.html)
+ [SetIdentityHeadersInNotificationsEnabled](https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityHeadersInNotificationsEnabled.html)
Sie können mit diesen API-Aktionen eine benutzerdefinierte Front-End-Anwendung für Benachrichtigungen schreiben. Eine vollständige Beschreibung der API-Aktionen für Benachrichtigungen finden Sie in der [API-Referenz von Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/).
## Fehlerbehebung bei Feedback-Benachrichtigungen
**Benachrichtigungen werden nicht empfangen**
Wenn Sie keine Benachrichtigungen erhalten, stellen Sie sicher, dass Sie einen Endpunkt für das Thema abonniert haben, über das die Benachrichtigungen gesendet werden. Wenn Sie einen E-Mail-Endpunkt für ein Thema abonnieren, erhalten Sie eine E-Mail, in der Sie aufgefordert werden, Ihr Abonnement zu bestätigen. Sie müssen Ihr Abonnement bestätigen, bevor Sie E-Mail-Benachrichtigungen empfangen. Weitere Informationen dazu erhalten Sie unter [Erste Schritte](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) im *Amazon Simple Notification Service Leitfaden*.
**`InvalidParameterValue`-Fehler beim Auswählen eines Themas**
Wenn Sie eine Fehlermeldung erhalten, die besagt, dass ein `InvalidParameterValue`Fehler aufgetreten ist, überprüfen Sie das Amazon-SNS-Thema, um zu sehen, ob es mit AWS KMS verschlüsselt ist. Ist dies der Fall, müssen Sie die Richtlinie für den Schlüssel ändern. AWS KMS Eine Beispielrichtlinie finden Sie unter [Voraussetzungen](#configure-feedback-notifications-prerequisites).
# Amazon-SNS-Benachrichtigungsinhalte für Amazon SES
Bounce-, Beschwerde- und Lieferbenachrichtigungen werden unter [Amazon Simple Notification Service (Amazon SNS)](https://aws.amazon.com/sns) -Themen im Format JavaScript Object Notation (JSON) veröffentlicht. Das JSON-Objekt der obersten Ebene enthält eine `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:
+ [JSON-Objekt der obersten Ebene](#top-level-json-object)
+ [`mail`-Objekt](#mail-object)
+ [`bounce`-Objekt](#bounce-object)
+ [`complaint`-Objekt](#complaint-object)
+ [`delivery`-Objekt](#delivery-object)
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 `headers` und `commonHeaders` des `mail`-Objekts abrufen.
## JSON-Objekt der obersten Ebene
Das JSON-Objekt der obersten Ebene in einer SES-Benachrichtigung enthält die folgenden Felder.
| Feldname | Description |
| --- | --- |
| notificationType | Eine Zeichenfolge, die den Typ der Benachrichtigung enthält, der vom JSON-Objekt dargestellt wird. Die möglichen Werte sind `Bounce`, `Complaint` oder `Delivery`. Wenn Sie [Einrichten der Ereignisveröffentlichung](monitor-sending-using-event-publishing-setup.md) wählen, heißt dieses Feld `eventType`. |
| 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](#mail-object). |
| bounce | Dieses Feld ist nur dann vorhanden, wenn `notificationType` `Bounce` ist, und enthält ein JSON-Objekt mit Informationen über die Unzustellbarkeit. Weitere Informationen finden Sie unter [Bounce-Objekt](#bounce-object). |
| complaint | Dieses Feld ist nur dann vorhanden, wenn `notificationType` `Complaint` ist, und enthält ein JSON-Objekt mit Informationen zur Beschwerde. Weitere Informationen finden Sie unter [Complaint-Objekt](#complaint-object). |
| delivery | Dieses Feld ist nur dann vorhanden, wenn `notificationType` `Delivery` ist, und enthält ein JSON-Objekt mit Informationen zur Zustellung. Weitere Informationen finden Sie unter [Delivery-Objekt](#delivery-object). |
## 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 | Description |
| --- | --- |
| timestamp | Der Zeitpunkt, zu dem die ursprüngliche Nachricht gesendet wurde (im ISO8601 Format). |
| messageId | Eine eindeutige ID, die SES der Nachricht zugewiesen hat. SES hat Ihnen diesen Wert zurückgegeben, als Sie die Nachricht gesendet haben. Diese Nachrichten-ID wurde von SES zugewiesen. Sie finden diese Mitteilungs-ID in der ursprünglichen E-Mail in den Feldern `headers` des `mail`-Objekts. |
| 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 `sourceArn` den ARN der ID an, die – gemäß Autorisierung durch den Identitätsbesitzer – vom stellvertretenden Sender zum Senden der E-Mail verwendet werden soll. Weitere Informationen zur Sendeautorisierung finden Sie unter [E-Mail-AuthentifizierungsmethodenVerwenden der Sendeautorisierung](sending-authorization.md). |
| 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 `sendingAccountId` die Konto-ID des stellvertretenden Senders an. |
| 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 `true` und `false`. |
| 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 `name` und `value`. Jede Nachrichten-ID innerhalb des `headers` Objekts stammt aus der ursprünglichen Nachricht, die Sie an SES übergeben haben. Die Nachrichten-ID, die SES der Nachricht anschließend zugewiesen hat, befindet sich im `messageId` Feld des `mail` Objekts. |
| 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. Bei Ergeinissen ist dies die Nachrichten-ID im Feld `commonHeaders` ist die Nachrichten-ID, die Amazon SES der Nachricht später im Feld `messageId` des Mail-Objekts zugewiesen hat. Benachrichtigungen enthalten die Nachrichten-ID der ursprünglichen E-Mail. |
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\" "
},
{
"name":"To",
"value":"\"Recipient Name\" "
},
{
"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 "
],
"date":"Mon, 08 Oct 2018 14:05:45 +0000",
"to":[
"Recipient Name "
],
"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 | Description |
| --- | --- |
| bounceType | Die Art des Bounces, wie von SES festgelegt. Weitere Informationen finden Sie unter [Unzustellbarkeitstypen](#bounce-types). |
| bounceSubType | Der Subtyp des Bounces, wie von SES bestimmt. Weitere Informationen finden Sie unter [Unzustellbarkeitstypen](#bounce-types). |
| 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](#bounced-recipients). |
| timestamp | Das Datum und die Uhrzeit, zu denen der Bounce gesendet wurde (im ISO8601 Format). 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 | Description |
| --- | --- |
| 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 | Description |
| --- | --- |
| reportingMTA | Der Wert des `Reporting-MTA`-Felds der DSN. Dies ist der Wert der MTA, die versucht hat, die Zustellungs-, Weiterleitungs- oder Gateway-Operation durchzuführen, die in der DSN beschrieben ist. |
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 | Description |
| --- | --- |
| emailAddress | Die E-Mail-Adresse des Empfängers. Ist eine DSN verfügbar, ist dies der Wert des `Final-Recipient`-Felds der DSN. |
Wurde eine DSN an eine Unzustellbarkeitsbenachrichtigung angehängt, sind möglicherweise folgende Felder ebenfalls vorhanden.
| Feldname | Description |
| --- | --- |
| action | Der Wert des `Action`-Felds der DSN. Es zeigt die Aktion an, die von der berichtenden MTA als Reaktion auf die gescheiterte Zustellung der Benachrichtigung an diesen Empfänger ausgeführt wurde. |
| status | Der Wert des `Status`-Felds der DSN. Dies ist der vom Transport unabhängige Statuscode pro Empfänger, der den Zustellstatus der Nachricht anzeigt. |
| diagnosticCode | Der vom berichtenden MTA gemeldete Statuscode. Dies ist der Wert des `Diagnostic-Code`-Felds der DSN. Dieses Feld ist möglicherweise nicht im DSN und daher auch nicht in JSON enthalten. |
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-Typ`Undetermined`, `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](monitor-sending-using-event-publishing-setup.md) und konfigurieren Sie sie so, dass Benachrichtigungen gesendet werden, wenn Zustellungsverzögerungsereignisse auftreten.
| bounceType | bounceSubType | Description |
| --- | --- | --- |
| 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. Wenn 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](sending-email-suppression-list.md). |
| 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 unter[Verwenden der Unterdrückungsliste auf Kontoebene der Amazon-SES-Konsole](sending-email-suppression-list.md). |
| Permanent | OnAccountSuppressionList | SES hat das Senden an diese Adresse unterdrückt, da sie auf der Sperrliste auf [Kontoebene](sending-email-suppression-list.md) 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.](sending-email-list-management.md#configuring-list-management-list-contacts) 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. Es 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](sending-email-list-management.md) 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. Wenn 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`Bounce`, zählt SES bei der Berechnung der Absprungrate für Ihr Konto keine automatischen Antworten. |
| 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 | Description |
| --- | --- |
| 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](#complained-recipients). |
| 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 `complaintSubType` kann entweder null oder `OnAccountSuppressionList` sein. Wenn der Wert lautet`OnAccountSuppressionList`, hat SES die Nachricht akzeptiert, aber nicht versucht, sie zu senden, da sie auf der Sperrliste auf [Kontoebene stand.](sending-email-suppression-list.md) |
Ist zudem ein Feedback-Bericht an die Beschwerde angehängt, sind möglicherweise die folgenden Felder vorhanden.
| Feldname | Description |
| --- | --- |
| userAgent | Der Wert des `User-Agent`-Felds aus dem Feedback-Bericht. Gibt den Namen und die Version des Systems an, das den Bericht generiert hat. |
| complaintFeedbackType | Der Wert des `Feedback-Type`-Felds aus dem Feedback-Bericht, der vom ISP empfangen wurde. Enthält die Art des Feedbacks. |
| arrivalDate | Der Wert des `Received-Date` Felds `Arrival-Date` oder aus dem Feedback-Bericht (im ISO8601 Format). Dieses Feld ist möglicherweise nicht im Bericht und daher auch nicht in JSON enthalten. |
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 | Description |
| --- | --- |
| 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](http://www.iana.org/assignments/marf-parameters/marf-parameters.xml#marf-parameters-2) zugewiesen wurden:
+ `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 | Description |
| --- | --- |
| timestamp | Der Zeitpunkt, zu dem SES die E-Mail an den E-Mail-Server des Empfängers zugestellt hat (im ISO8601 Format). |
| 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 zugestellt 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"
}
```
# Amazon-SNS-Benachrichtigungsbeispiele für Amazon SES
Die folgenden Abschnitte enthalten Beispiele für die drei Arten von Benachrichtigungen:
+ Beispiele für Unzustellbarkeitsbenachrichtigungen finden Sie unter [Beispiele für Amazon-SNS-Unzustellbarkeitsbenachrichtigungen](#notification-examples-bounce).
+ Beispiele für Beschwerdebenachrichtigungen finden Sie unter [Beispiele für Amazon-SNS-Beschwerdebenachrichtigungen](#notification-examples-complaint).
+ Beispiele für Zustellungsbenachrichtigungen finden Sie unter [Beispiel einer Amazon-SNS-Zustellungsbenachrichtigung](#notification-examples-delivery).
## Beispiele für Amazon-SNS-Unzustellbarkeitsbenachrichtigungen
Dieser Abschnitt enthält Beispiele für Unzustellbarkeitsbenachrichtigungen mit und ohne Zustellungsstatusbenachrichtigung, bereitgestellt von dem E-Mail-Empfänger, der das Feedback gesendet hat.
### Unzustellbarkeitsbenachrichtigung mit Zustellungsstatusbenachrichtigung
Es folgt ein Beispiel für eine Unzustellbarkeitsbenachrichtigung, die eine Zustellungsstatusbenachrichtigung und die ursprünglichen E-Mail-Header enthält. Wenn Unzustellbarkeitsbenachrichtigungen nicht so konfiguriert sind, dass sie die ursprünglichen E-Mail-Header enthalten, enthält das `mail`-Objekt innerhalb der Benachrichtigungen die Felder `headersTruncated`, `headers` und `commonHeaders` nicht.
```
{
"notificationType":"Bounce",
"bounce":{
"bounceType":"Permanent",
"reportingMTA":"dns; email.example.com",
"bouncedRecipients":[
{
"emailAddress":"jane@example.com",
"status":"5.1.1",
"action":"failed",
"diagnosticCode":"smtp; 550 5.1.1 ... User"
}
],
"bounceSubType":"General",
"timestamp":"2016-01-27T14:59:38.237Z",
"feedbackId":"00000138111222aa-33322211-cccc-cccc-cccc-ddddaaaa068a-000000",
"remoteMtaIp":"127.0.2.0"
},
"mail":{
"timestamp":"2016-01-27T14:59:38.237Z",
"source":"john@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"callerIdentity": "IAM_user_or_role_name",
"messageId":"00000138111222aa-33322211-cccc-cccc-cccc-ddddaaaa0680-000000",
"destination":[
"jane@example.com",
"mary@example.com",
"richard@example.com"],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"John Doe\" "
},
{
"name":"To",
"value":"\"Jane Doe\" , \"Mary Doe\" , \"Richard Doe\" "
},
{
"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":"Wed, 27 Jan 2016 14:05:45 +0000"
}
],
"commonHeaders":{
"from":[
"John Doe "
],
"date":"Wed, 27 Jan 2016 14:05:45 +0000",
"to":[
"Jane Doe , Mary Doe , Richard Doe "
],
"messageId":"custom-message-ID",
"subject":"Hello"
}
}
}
```
### Unzustellbarkeitsbenachrichtigung ohne Zustellungsstatusbenachrichtigung
Es folgt ein Beispiel für eine Unzustellbarkeitsbenachrichtigung, die die ursprünglichen E-Mail-Header, aber keine Zustellungsstatusbenachrichtigung enthält. Wenn Unzustellbarkeitsbenachrichtigungen nicht so konfiguriert sind, dass sie die ursprünglichen E-Mail-Header enthalten, enthält das `mail`-Objekt innerhalb der Benachrichtigungen die Felder `headersTruncated`, `headers` und `commonHeaders` nicht.
```
{
"notificationType":"Bounce",
"bounce":{
"bounceType":"Permanent",
"bounceSubType": "General",
"bouncedRecipients":[
{
"emailAddress":"jane@example.com"
},
{
"emailAddress":"richard@example.com"
}
],
"timestamp":"2016-01-27T14:59:38.237Z",
"feedbackId":"00000137860315fd-869464a4-8680-4114-98d3-716fe35851f9-000000",
"remoteMtaIp":"127.0.2.0"
},
"mail":{
"timestamp":"2016-01-27T14:59:38.237Z",
"messageId":"00000137860315fd-34208509-5b74-41f3-95c5-22c1edc3c924-000000",
"source":"john@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"callerIdentity": "IAM_user_or_role_name",
"destination":[
"jane@example.com",
"mary@example.com",
"richard@example.com"
],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"John Doe\" "
},
{
"name":"To",
"value":"\"Jane Doe\" , \"Mary Doe\" , \"Richard Doe\" "
},
{
"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":"Wed, 27 Jan 2016 14:05:45 +0000"
}
],
"commonHeaders":{
"from":[
"John Doe "
],
"date":"Wed, 27 Jan 2016 14:05:45 +0000",
"to":[
"Jane Doe , Mary Doe , Richard Doe "
],
"messageId":"custom-message-ID",
"subject":"Hello"
}
}
}
```
## Beispiele für Amazon-SNS-Beschwerdebenachrichtigungen
Dieser Abschnitt enthält Beispiele für Beschwerdebenachrichtigungen mit und ohne Feedbackbericht, bereitgestellt von dem E-Mail-Empfänger, der das Feedback gesendet hat.
### Beschwerdebenachrichtigung mit Feedbackbericht
Es folgt ein Beispiel für eine Beschwerdebenachrichtigungen, die einen Feedbackbericht und die ursprünglichen E-Mail-Header enthält. Wenn Beschwerdebenachrichtigungen nicht so konfiguriert sind, dass sie die ursprünglichen E-Mail-Header enthalten, enthält das `mail`-Objekt innerhalb der Benachrichtigungen die Felder `headersTruncated`, `headers` und `commonHeaders` nicht.
```
{
"notificationType":"Complaint",
"complaint":{
"userAgent":"AnyCompany Feedback Loop (V0.01)",
"complainedRecipients":[
{
"emailAddress":"richard@example.com"
}
],
"complaintFeedbackType":"abuse",
"arrivalDate":"2016-01-27T14:59:38.237Z",
"timestamp":"2016-01-27T14:59:38.237Z",
"feedbackId":"000001378603177f-18c07c78-fa81-4a58-9dd1-fedc3cb8f49a-000000"
},
"mail":{
"timestamp":"2016-01-27T14:59:38.237Z",
"messageId":"000001378603177f-7a5433e7-8edb-42ae-af10-f0181f34d6ee-000000",
"source":"john@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"callerIdentity": "IAM_user_or_role_name",
"destination":[
"jane@example.com",
"mary@example.com",
"richard@example.com"
],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"John Doe\" "
},
{
"name":"To",
"value":"\"Jane Doe\" , \"Mary Doe\" , \"Richard Doe\" "
},
{
"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":"Wed, 27 Jan 2016 14:05:45 +0000"
}
],
"commonHeaders":{
"from":[
"John Doe "
],
"date":"Wed, 27 Jan 2016 14:05:45 +0000",
"to":[
"Jane Doe , Mary Doe , Richard Doe "
],
"messageId":"custom-message-ID",
"subject":"Hello"
}
}
}
```
### Beschwerdebenachrichtigung ohne Feedbackbericht
Es folgt ein Beispiel für eine Beschwerdebenachrichtigung, die die ursprünglichen E-Mail-Header, aber keinen Feedbackbericht enthält. Wenn Beschwerdebenachrichtigungen nicht so konfiguriert sind, dass sie die ursprünglichen E-Mail-Header enthalten, enthält das `mail`-Objekt innerhalb der Benachrichtigungen die Felder `headersTruncated`, `headers` und `commonHeaders` nicht.
```
{
"notificationType":"Complaint",
"complaint":{
"complainedRecipients":[
{
"emailAddress":"richard@example.com"
}
],
"timestamp":"2016-01-27T14:59:38.237Z",
"feedbackId":"0000013786031775-fea503bc-7497-49e1-881b-a0379bb037d3-000000"
},
"mail":{
"timestamp":"2016-01-27T14:59:38.237Z",
"messageId":"0000013786031775-163e3910-53eb-4c8e-a04a-f29debf88a84-000000",
"source":"john@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"callerIdentity": "IAM_user_or_role_name",
"destination":[
"jane@example.com",
"mary@example.com",
"richard@example.com"
],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"John Doe\" "
},
{
"name":"To",
"value":"\"Jane Doe\" , \"Mary Doe\" , \"Richard Doe\" "
},
{
"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":"Wed, 27 Jan 2016 14:05:45 +0000"
}
],
"commonHeaders":{
"from":[
"John Doe "
],
"date":"Wed, 27 Jan 2016 14:05:45 +0000",
"to":[
"Jane Doe , Mary Doe , Richard Doe "
],
"messageId":"custom-message-ID",
"subject":"Hello"
}
}
}
```
## Beispiel einer Amazon-SNS-Zustellungsbenachrichtigung
Es folgt ein Beispiel für eine Zustellungsbenachrichtigung, die die ursprünglichen E-Mail-Header enthält. Wenn Zustellungsbenachrichtigungen nicht so konfiguriert sind, dass sie die ursprünglichen E-Mail-Header enthalten, enthält das `mail`-Objekt innerhalb der Benachrichtigungen die Felder `headersTruncated`, `headers` und `commonHeaders` nicht.
```
{
"notificationType":"Delivery",
"mail":{
"timestamp":"2016-01-27T14:59:38.237Z",
"messageId":"0000014644fe5ef6-9a483358-9170-4cb4-a269-f5dcdf415321-000000",
"source":"john@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"callerIdentity": "IAM_user_or_role_name",
"destination":[
"jane@example.com"
],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"John Doe\" "
},
{
"name":"To",
"value":"\"Jane Doe\" "
},
{
"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":"Wed, 27 Jan 2016 14:58:45 +0000"
}
],
"commonHeaders":{
"from":[
"John Doe "
],
"date":"Wed, 27 Jan 2016 14:58:45 +0000",
"to":[
"Jane Doe "
],
"messageId":"custom-message-ID",
"subject":"Hello"
}
},
"delivery":{
"timestamp":"2016-01-27T14:59:38.237Z",
"recipients":["jane@example.com"],
"processingTimeMillis":546,
"reportingMTA":"a8-70.smtp-out.amazonses.com",
"smtpResponse":"250 ok: Message 64111812 accepted",
"remoteMtaIp":"127.0.2.0"
}
}
```