Schritt 3: Festlegen eines Konfigurationssatzes für das Senden von E-Mail - Amazon Simple Email Service

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.

Schritt 3: Festlegen eines Konfigurationssatzes für das Senden von E-Mail

Nach dem Erstellen eines Konfigurationssatzes und dem Hinzufügen eines Ereignisziels besteht der letzte Schritt zur Ereignisveröffentlichung im Senden von E-Mails.

Damit Ereignisse im Zusammenhang mit einer E-Mail veröffentlicht werden, müssen Sie den Namen des Konfigurationssatzes angeben, der mit der E-Mail- verknüpft werden soll. Optional können Sie Tags zur Kategorisierung der E-Mail-Nachricht bereitstellen.

Diese Informationen stellen Sie Amazon SES entweder als Parameter an die E-Mail sendende API, als -spezifischer E-Mail-Header oder als benutzerdefinierter Header in Ihrer MIME-Nachricht bereit. Welche Methode Sie wählen, hängt von der Schnittstelle ab, mit der Sie E-Mails senden. Sehen Sie sich dazu die folgende Tabelle an.

Schnittstelle zum Senden von E-Mails Möglichkeiten zum Veröffentlichen von Events

SendEmail

API-Parameter

SendTemplatedEmail

API-Parameter

SendBulkTemplatedEmail

API-Parameter

SendCustomVerificationEmail

API-Parameter

SendRawEmail

API-Parameter, Amazon SES-spezifische E-Mail-Header oder benutzerdefinierte MIME-Header

Wichtig

Wenn Sie Nachrichten-Tags sowohl mit Headern als auch mit API-Parametern angeben, verwendet Amazon SES nur die durch API-Parameter bereitgestellten Nachricht Tags. Amazon SES verknüpft keine Nachrichten-Tags, die durch API-Parameter und Header angegeben werden.

SMTP-Schnittstelle

Amazon SES-spezifische E-Mail-Header

In den folgenden Abschnitten wird beschrieben, wie Sie Konfigurationssätze und Nachrichten-Tags mithilfe von Headern und mithilfe von API-Parametern festlegen.

Anmerkung

Optional können Sie Nachrichten-Tags in den Kopfzeilen Ihrer E-Mails einschließen. Nachrichten-Tags können die Zahlen 0-9, die Buchstaben A-Z (Groß- und Kleinbuchstaben), Bindestriche (-) und Unterstriche (_) enthalten.

Verwenden von Amazon SES-API-Parametern

Wenn Sie SendEmail, SendTemplatedEmail, SendBulkTemplatedEmail, SendCustomVerificationEmail oder SendRawEmail mit der Ereignisveröffentlichung verwenden möchten, geben Sie den Konfigurationssatz und die Nachrichten-Tags an, indem Sie Datenstrukturen mit dem Namen ConfigurationSet und MessageTag an den API-Aufruf weitergeben.

Weitere Informationen zur Verwendung der Amazon SES API finden Sie unter Referenz zu Amazon Simple Email Service API.

Verwenden von Amazon SES-spezifischen E-Mail-Headern

Wenn Sie SendRawEmail oder die SMTP-Schnittstelle verwenden, können Sie den Konfigurationssatz und die Nachrichten-Tags angeben, indem Sie der E-Mail Amazon SES-spezifische Header hinzufügen. Vor dem Senden der E-Mail entfernt Amazon SES die Header. In der folgenden Tabelle sind die Namen der zu verwendenden Header aufgeführt.

Informationen der Ereignisveröffentlichung Header

Konfigurationssatz

X-SES-CONFIGURATION-SET

Nachrichten-Tags

X-SES-MESSAGE-TAGS

Das folgende Beispiel zeigt, wie die Header in einer Raw-E-Mail aussehen können, die Sie an Amazon SES senden.

X-SES-MESSAGE-TAGS: tagName1=tagValue1, tagName2=tagValue2 X-SES-CONFIGURATION-SET: myConfigurationSet From: sender@example.com To: recipient@example.com Subject: Subject Content-Type: multipart/alternative; boundary="----=_boundary" ------=_boundary Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit body ------=_boundary Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: 7bit body ------=_boundary--

Verwenden von benutzerdefinierten E-Mail-Headern

Sie müssen zwar den Namen des Konfigurationssatzes mit dem Amazon SES-spezifischen Header X-SES-CONFIGURATION-SET angeben, aber Sie können die Nachrichten-Tags mithilfe eigener MIME-Header festlegen.

Anmerkung

Die für die Amazon SES-Ereignisveröffentlichung verwendeten Header-Namen und -Werte müssen das ASCII-Format aufweisen. Wenn Sie Header-Namen oder -Werte für die Amazon SES-Ereignisveröffentlichung nicht im ASCII-Format angeben, wird der Aufruf zum Senden von E-Mails weiterhin erfolgreich ausgeführt, die Ereignismetriken werden jedoch nicht an Amazon CloudWatch ausgegeben.