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.
Einträge in der Mandantenunterdrückungsliste verwalten
Sie verwalten Einträge in der Unterdrückungsliste eines Mandanten, indem Sie dieselben Amazon Simple Email Service (SES) API-Operationen verwenden, die Sie für die Unterdrückungsliste auf Kontoebene verwenden. Wenn Sie auf die Liste eines bestimmten Mandanten abzielen möchten, fügen Sie den --tenant-name Parameter in jede Anfrage ein. Wenn Sie diesen Parameter weglassen, zielen die Operationen auf die Liste auf Kontoebene ab. Verwenden Sie den, AWS CLI um unterdrückte Adressen für einen bestimmten Mandanten hinzuzufügen, zu überprüfen, zu entfernen und aufzulisten.
Wichtig
E-Mail-Adressen auf der Unterdrückungsliste werden unter Wahrung der Groß- und Kleinschreibung gespeichert. Während die E-Mail-Versandfunktion Adressen mit unterschiedlichen Groß- und Kleinschreibung als identisch behandelt, erfordern API-Aufrufe zur Verwaltung der Unterdrückungsliste eine genaue Übereinstimmung zwischen Groß- und Kleinschreibung. Achten Sie darauf, dass Sie beim Hinzufügen, Markieren oder Entfernen von Einträgen die genaue Groß- und Kleinschreibung der E-Mail-Adresse verwenden, so wie sie in der Unterdrückungsliste erscheint.
Voraussetzungen
Bevor Sie Einträge in der Mandantenunterdrückungsliste verwalten, stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen:
-
Tenant-level Die Unterdrückung ist für den Mandanten aktiviert. Weitere Informationen finden Sie unter Konfiguration der Unterdrückung auf Mandantenebene.
-
AWS CLI Version 2 ist mit den entsprechenden Berechtigungen installiert und konfiguriert. Weitere Informationen finden Sie im AWS Command Line Interface -Benutzerhandbuch.
-
Der Mandant ist in Ihrem SES-Konto vorhanden.
Eine Adresse zur Unterdrückungsliste eines Mandanten hinzufügen
Verwenden Sie den PutSuppressedDestination API-Vorgang mit dem --tenant-name Parameter, um der Unterdrückungsliste eines Mandanten eine E-Mail-Adresse hinzuzufügen.
Um eine Adresse zur Unterdrückungsliste eines Mandanten hinzuzufügen, verwenden Sie AWS CLI
-
Geben Sie in der Befehlszeile folgenden Befehl ein:
Im vorherigen Beispiel
recipient@example.comersetzen Sie es durch die E-Mail-Adresse, die Sie hinzufügen möchten,BOUNCEdurch den Grund für die Unterdrückung (zulässige Werte sindBOUNCEundCOMPLAINT) undMyTenantdurch den Namen Ihres Mandanten.
Der Befehl erzeugt bei Erfolg keine Ausgabe (HTTP 200). Die Adresse steht jetzt auf der Unterdrückungsliste des Mandanten.
Anmerkung
Der --reason Parameter akzeptiert BOUNCE oderCOMPLAINT. Sie können dieselbe Adresse aus unterschiedlichen Gründen hinzufügen.
Prüft, ob eine Adresse auf der Unterdrückungsliste eines Mandanten steht
Verwenden Sie den GetSuppressedDestination API-Vorgang mit dem --tenant-name Parameter, um zu überprüfen, ob eine E-Mail-Adresse auf der Unterdrückungsliste eines Mandanten steht.
Um zu überprüfen, ob eine Adresse auf der Unterdrückungsliste eines Mandanten steht, verwenden Sie AWS CLI
-
Geben Sie in der Befehlszeile folgenden Befehl ein:
Ersetzen Sie es im vorherigen Beispiel
recipient@example.comdurch die E-Mail-Adresse, die überprüft werden soll, undMyTenantdurch den Namen Ihres Mandanten.
Wenn die Adresse auf der Unterdrückungsliste des Mandanten steht, gibt der Befehl eine Ausgabe zurück, die dem folgenden Beispiel ähnelt:
{ "SuppressedDestination": { "EmailAddress": "recipient@example.com", "Reason": "BOUNCE", "LastUpdateTime": "2026-03-15T10:30:00.000Z", "Attributes": { "MessageId": "0100018e1234abcd-12345678-abcd-1234-abcd-123456789012-000000", "FeedbackId": "0100018e1234abce-12345678-abcd-1234-abcd-123456789012-000000" } } }
Die Antwort umfasst die folgenden Felder:
-
EmailAddress— Die unterdrückte E-Mail-Adresse. -
Reason— Warum wurde die Adresse unterdrückt (BOUNCEoderCOMPLAINT). -
LastUpdateTime— Wann der Eintrag zuletzt aktualisiert wurde. -
Attributes— EnthältMessageIdundFeedbackIdstammt aus dem Ereignis, das zur Unterdrückung geführt hat. Diese Felder sind für automatisch unterdrückte Adressen vorhanden und für manuell hinzugefügte Einträge nicht.
Anmerkung
Wenn die Adresse nicht auf der Unterdrückungsliste des Mandanten steht, gibt die API a NotFoundException zurück.
Eine Adresse aus der Unterdrückungsliste eines Mandanten entfernen
Verwenden Sie den DeleteSuppressedDestination API-Vorgang mit dem --tenant-name Parameter, um eine E-Mail-Adresse aus der Unterdrückungsliste eines Mandanten zu entfernen.
Um eine Adresse aus der Unterdrückungsliste eines Mandanten zu entfernen, verwenden Sie AWS CLI
-
Geben Sie in der Befehlszeile folgenden Befehl ein:
Ersetzen Sie es im vorherigen Beispiel
recipient@example.comdurch die E-Mail-Adresse, die entfernt werden soll, undMyTenantdurch den Namen Ihres Mandanten.
Der Befehl erzeugt bei Erfolg keine Ausgabe (HTTP 200). Die Adresse wird aus der Unterdrückungsliste des Mandanten entfernt.
Wichtig
Wenn Sie eine Adresse aus der Unterdrückungsliste eines Mandanten entfernen, wird sie nicht aus der globalen Unterdrückungsliste oder der Unterdrückungsliste auf Kontoebene entfernt. Jede Liste wird unabhängig verwaltet.
Adressen auf der Unterdrückungsliste eines Mandanten auflisten
Verwenden Sie den ListSuppressedDestinations API-Vorgang mit dem --tenant-name Parameter, um alle unterdrückten Adressen für einen bestimmten Mandanten abzurufen.
Um alle Adressen auf der Unterdrückungsliste eines Mandanten aufzulisten, verwenden Sie AWS CLI
-
Geben Sie in der Befehlszeile folgenden Befehl ein:
Im vorherigen Beispiel
MyTenantersetzen Sie es durch den Namen Ihres Mandanten.
Die folgende Beispielausgabe zeigt zwei unterdrückte Adressen:
{ "SuppressedDestinationSummaries": [ { "EmailAddress": "bounce@example.com", "Reason": "BOUNCE", "LastUpdateTime": "2026-03-10T08:15:00.000Z" }, { "EmailAddress": "complaint@example.com", "Reason": "COMPLAINT", "LastUpdateTime": "2026-03-12T14:30:00.000Z" } ] }
Filterung der Ergebnisse
Sie können die Ergebnisse nach Grund, Datumsbereich oder beidem filtern.
Der folgende Befehl filtert nach Grund:
Der folgende Befehl filtert nach Datumsbereich:
Wenn die Antwort einen NextToken Wert enthält, verwenden Sie ihn in einer nachfolgenden Anforderung, um weitere Ergebnisse abzurufen. Verwenden Sie den --page-size Parameter, um die Anzahl der Ergebnisse pro Seite zu steuern.
Anmerkung
Bei der Listenoperation werden nur zusammenfassende Informationen zurückgegeben. Um vollständige InformationenAttributes, einschließlich, zu erhalten, verwenden Sie GetSuppressedDestination die Option für einzelne Adressen.
Automatische Unterdrückung von Einträgen
SES verwaltet die Unterdrückungseinträge automatisch auf der Grundlage der Unterdrückungskonfiguration des Mandanten. Für automatische Einträge müssen Sie keine Maßnahmen ergreifen. Sie werden in der Unterdrückungsliste des Mandanten zusammen mit manuell hinzugefügten Einträgen angezeigt.
SES fügt in den folgenden Fällen automatisch Einträge hinzu:
-
Ein Hard Bounce tritt auf, wenn die Bounce-Unterdrückung für den Mandanten aktiviert ist.
-
Eine Beschwerde geht ein, wenn die Beschwerdeunterdrückung für den Mieter aktiviert ist.
SES entfernt in den folgenden Fällen automatisch Einträge:
-
Für eine Adresse, deren Beschwerde unterdrückt wurde, geht ein Bericht ein, dass es sich nicht um Spam handelt.
