E-Mail-Vorlagen verwalten - Amazon Simple Email Service

E-Mail-Vorlagen verwalten

Zusätzlich zum Erstellen von E-Mail-Vorlagen können Sie die Amazon-SES-API auch verwenden, um vorhandene Vorlagen zu aktualisieren oder zu löschen, alle vorhandenen Vorlagen aufzulisten oder den Inhalt einer Vorlage anzuzeigen.

Dieser Abschnitt enthält Verfahren zur Verwendung des AWS CLI, um Aufgaben im Zusammenhang mit Amazon SES Vorlagen auszuführen.

Anmerkung

Bei diesen Verfahren wird vorausgesetzt, dass Sie die AWS CLI bereits installiert und konfiguriert haben. Weitere Informationen zum Installieren und Konfigurieren der AWS CLI finden Sie im AWS Command Line Interface-Benutzerhandbuch.

Anzeigen einer Liste von E-Mail-Vorlagen

Sie können die ListTemplates-Operation in der Amazon-SES-API verwenden, um eine Liste aller vorhandenen E-Mail-Vorlagen anzuzeigen.

So zeigen Sie eine Liste von E-Mail-Vorlagen an
  • Geben Sie in der Befehlszeile folgenden Befehl ein:

    aws ses list-templates

    Wenn in Ihrem Amazon-SES-Konto in der aktuellen Region E-Mail-Vorlagen vorhanden sind, gibt dieser Befehl eine Antwort zurück, die dem folgenden Beispiel ähnelt:

    { "TemplatesMetadata": [ { "Name": "SpecialOffers", "CreatedTimestamp": "2020-08-05T16:04:12.640Z" }, { "Name": "NewsAndUpdates", "CreatedTimestamp": "2019-10-03T20:03:34.574Z" } ] }

    Wenn Sie keine Vorlagen erstellt haben, gibt der Befehl ein TemplatesMetadata-Objekt ohne Member zurück.

Anzeigen des Inhalts einer bestimmten E-Mail-Vorlage

Sie können die GetTemplate-Operation in der Amazon-SES-API verwenden, um den Inhalt einer bestimmten E-Mail-Vorlage anzuzeigen.

So zeigen Sie den Inhalt einer E-Mail-Vorlage an
  • Geben Sie in der Befehlszeile folgenden Befehl ein:

    aws ses get-template --template-name MyTemplate

    Ersetzen Sie im Befehl oben die Option MyTemplate mit dem Namen der Vorlage, die Sie anzeigen möchten.

    Wenn der von Ihnen angegebene Vorlagenname mit einer Vorlage übereinstimmt, die in Ihrem Amazon SES Konto vorhanden ist, gibt dieser Befehl eine Antwort zurück, die dem folgenden Beispiel ähnelt:

    { "Template": { "TemplateName": "TestMessage", "SubjectPart": "Amazon SES Test Message", "TextPart": "Hello! This is the text part of the message.", "HtmlPart": "<html>\n<body>\n<h2>Hello!</h2>\n<p>This is the HTML part of the message.</p></body>\n</html>" } }

    Wenn der von Ihnen angegebene Vorlagenname nicht mit einer Vorlage übereinstimmt, die in Ihrem Amazon-SES-Konto vorhanden ist, gibt der Befehl einen TemplateDoesNotExist-Fehler zurück.

Löschen einer E-Mail-Vorlage

Sie können die DeleteTemplate-Operation in der Amazon-SES-API verwenden, um eine bestimmte E-Mail-Vorlage zu löschen.

Löschen einer E-Mail-Vorlage
  • Geben Sie in der Befehlszeile folgenden Befehl ein:

    aws ses delete-template --template-name MyTemplate

    Ersetzen Sie im vorherigen Befehl MyTemplate durch den Namen der Vorlage, die Sie löschen möchten.

    Dieser Befehl liefert keine Ausgabe. Sie können überprüfen, ob die Vorlage gelöscht wurde, indem Sie den GetTemplate-Vorgang verwenden.

Aktualisieren einer E-Mail-Vorlage

Sie können die UpdateTemplate-Operation in der Amazon-SES-API verwenden, um eine vorhandene E-Mail-Vorlage zu aktualisieren. Dieser Vorgang ist beispielsweise hilfreich, wenn Sie die Betreffzeile der E-Mail-Vorlage ändern möchten oder wenn Sie den Nachrichtentext selbst ändern müssen.

Aktualisieren einer E-Mail-Vorlage
  1. Verwenden Sie den GetTemplate-Befehl, um die vorhandene Vorlage abzurufen, indem Sie den folgenden Befehl in der Befehlszeile eingeben:

    aws ses get-template --template-name MyTemplate

    Ersetzen Sie im vorherigen Befehl MyTemplate durch den Namen der Vorlage, die Sie aktualisieren möchten.

    Wenn der von Ihnen angegebene Vorlagenname mit einer Vorlage übereinstimmt, die in Ihrem Amazon SES Konto vorhanden ist, gibt dieser Befehl eine Antwort zurück, die dem folgenden Beispiel ähnelt:

    { "Template": { "TemplateName": "TestMessage", "SubjectPart": "Amazon SES Test Message", "TextPart": "Hello! This is the text part of the message.", "HtmlPart": "<html>\n<body>\n<h2>Hello!</h2>\n<p>This is the HTML part of the message.</p></body>\n</html>" } }
  2. Erstellen Sie in einem Texteditor eine neue Datei. Fügen Sie die Ausgabe des vorherigen Befehls in die Datei ein.

  3. Ändern Sie die Vorlage nach Bedarf. Alle Zeilen, die Sie auslassen, werden aus der Vorlage entfernt. Wenn Sie beispielsweise nur SubjectPart der Vorlage ändern möchten, müssen Sie dennoch die TextPart und HtmlPart-Eigenschaften einschließen.

    Wenn Sie fertig sind, speichern Sie die Datei unter update_template.json.

  4. Geben Sie in der Befehlszeile folgenden Befehl ein:

    aws ses update-template --cli-input-json file://path/to/update_template.json

    Ersetzen Sie im voranstehenden Befehl path/to/createConfigurationSet.json durch den Pfad zu der update_template.json-Datei, die Sie im vorherigen Schritt erstellt haben.

    Wenn die Vorlage erfolgreich aktualisiert wurde, liefert dieser Befehl keine Ausgabe. Sie können überprüfen, ob die Vorlage aktualisiert wurde, indem Sie die GetTemplate verwenden.

    Wenn die angegebene Vorlage nicht vorhanden ist, gibt dieser Befehl einen TemplateDoesNotExist-Fehler zurück. Wenn die Vorlage weder die Eigenschaft TextPart oder HtmlPart (weder beides) enthält, gibt dieser Befehl einen InvalidParameterValue-Fehler zurück.