

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 Unterdrückungslisten auf Mandantenebene in Amazon SES
<a name="sending-email-suppression-list-tenant-level"></a>

Wenn Sie Amazon Simple Email Service (SES) Multi-Tenancy verwenden, um E-Mails im Namen mehrerer Mandanten zu versenden, können Sie jedem Mandanten eine eigene Unterdrückungsliste zuweisen. Tenant-level Durch die Unterdrückung werden zurückgesendete Nachrichten und Beschwerden isoliert, sodass sie nur den Mandanten betreffen, der die E-Mail gesendet hat. Ohne diese Funktion teilen sich alle Mandanten die Unterdrückungsliste auf Kontoebene. Wenn ein Empfänger die E-Mail-Adresse eines Mandanten zurückweist oder sich darüber beschwert, wird diese Adresse für jeden Mandanten im Konto ausgeblendet. Tenant-level Die Unterdrückung verhindert diese mandantenübergreifende Verunreinigung, indem für jeden Mandanten eine separate Liste mit unterdrückten Adressen geführt wird.

## So funktioniert die Unterdrückung auf Mandantenebene
<a name="sending-email-suppression-list-tenant-level-how-it-works"></a>

Zwei Einstellungen steuern das Verhalten der Unterdrückung für jeden Mandanten: *Umfang der Unterdrückung* und *Unterdrückungsgründe*. Sie konfigurieren beide Einstellungen zusammen, indem Sie den `PutTenantSuppressionAttributes` API-Vorgang verwenden oder indem Sie angeben, `SuppressionAttributes` wann Sie einen Mandanten mit dem `CreateTenant` API-Vorgang erstellen.

**Der Umfang der Unterdrückung** bestimmt, welche Unterdrückungsliste SES für den Mandanten verwendet:
+ `TENANT`— Verwenden Sie die eigene Unterdrückungsliste des Mandanten.
+ `ACCOUNT`— Verwenden Sie die Unterdrückungsliste auf Kontoebene. Dies ist die Standardeinstellung für bestehende und neue Mandanten.

**Unterdrückte Gründe** bestimmen, welche Ereignisse SES veranlassen, Adressen zur Unterdrückungsliste hinzuzufügen:
+ `BOUNCE`— Fügen Sie Adressen hinzu, die zu Hardbounces führen.
+ `COMPLAINT`— Fügen Sie Adressen hinzu, die zu Beschwerden führen.
+ `BOUNCE`und `COMPLAINT` — Fügen Sie Adressen hinzu, die zu einem der beiden Ereignisse führen.
+ Leer — Nicht überprüfen oder in eine Unterdrückungsliste aufnehmen.

**Anmerkung**  
Sie müssen `SuppressionScope` und `SuppressedReasons` zusammen angeben oder beide auf Null setzen. Wenn Sie beide auf Null setzen, werden die Unterdrückungseinstellungen des Mandanten gelöscht und der Mandant wird auf das Standardverhalten im `ACCOUNT` Bereich zurückgesetzt.

### Unterdrückungsverhalten je nach Konfiguration
<a name="sending-email-suppression-list-tenant-level-behavior-by-config"></a>

In der folgenden Tabelle werden die Sendezeit und das Aufzeichnungsverhalten für jede Kombination aus Unterdrückungsbereich und Unterdrückungsgründen beschrieben.


| Scope | Gründe | Send-time Verhalten | Verhalten aufzeichnen | 
| --- | --- | --- | --- | 
| TENANT | BOUNCE, COMPLAINT | Überprüft die Mieterliste auf Anfragen und Beschwerden | Zeichnet beide auf die Mieterliste auf | 
| TENANT | BOUNCE | Überprüft die Mandantenliste nur auf Bounces | Datensätze werden nur an die Mandantenliste weitergeleitet | 
| TENANT | COMPLAINT | Überprüft die Mieterliste nur auf Beschwerden | Zeichnet Beschwerden nur in der Mieterliste auf | 
| TENANT | Leer | Keine Überprüfung der Unterdrückung | Keine Aufnahme | 
| ACCOUNT | BOUNCE, COMPLAINT | Überprüft die Kontoliste auf Abmeldungen und Beschwerden | Zeichnet beide in die Kontoliste auf | 
| ACCOUNT | BOUNCE | Überprüft die Kontoliste nur auf Bounces | Zeichnet nur Überweisungen an die Kontoliste auf | 
| ACCOUNT | COMPLAINT | Überprüft die Kontoliste nur auf Beschwerden | Zeichnet Beschwerden nur in der Kontoliste auf | 
| ACCOUNT | Leer | Keine Überprüfung der Unterdrückung | Keine Aufnahme | 

## Priorität der Unterdrückung und Verhalten bei Versand
<a name="sending-email-suppression-list-tenant-level-precedence"></a>

SES löst die Unterdrückungseinstellungen in der folgenden Reihenfolge auf, von der höchsten zur niedrigsten Priorität:

1. **Konfigurationssatz** — Wenn der Konfigurationssatz Unterdrückungseinstellungen festlegt, verwendet SES diese Einstellungen.

1. **Mandant** — Wenn es keine Überschreibung des Konfigurationssatzes gibt, verwendet SES die Unterdrückungseinstellungen des Mandanten.

1. **Konto** — Wenn weder der Konfigurationssatz noch der Mandant Einstellungen spezifizieren, verwendet SES die Standardeinstellungen auf Kontoebene.

**Wichtig**  
Der Unterdrückungsbereich bestimmt, welche Unterdrückungsliste SES zum Zeitpunkt des Sendens überprüft. Wenn der Gültigkeitsbereich aktiviert ist`TENANT`, überprüft SES nur die Unterdrückungsliste des Mandanten und überspringt die Unterdrückungsliste auf Kontoebene. Eine Adresse, die auf der Unterdrückungsliste auf Kontoebene, aber nicht auf der Unterdrückungsliste des Mandanten steht, wird nicht unterdrückt. Wenn der Gültigkeitsbereich aktiviert ist`ACCOUNT`, überprüft SES nur die Unterdrückungsliste auf Kontoebene. Der Geltungsbereich bestimmt auch, wo Abmeldungen und Beschwerden erfasst werden.

### Überschreibungen des Konfigurationssatzes
<a name="sending-email-suppression-list-tenant-level-config-set-overrides"></a>

Der Konfigurationssatz `SuppressionOptions` für einen Konfigurationssatz enthält jetzt ein `SuppressionScope` Feld. Sie können einen Konfigurationssatz verwenden, um nur den Geltungsbereich, nur die Gründe oder beide unabhängig voneinander außer Kraft zu setzen. Auf diese Weise haben Sie eine genaue Kontrolle über das Unterdrückungsverhalten für bestimmte Sende-Workflows. Sie müssen die Standardeinstellungen des Mandanten nicht ändern.

## Automatische Unterdrückung und Aufzeichnung
<a name="sending-email-suppression-list-tenant-level-auto-recording"></a>

Wenn der Unterdrückungsbereich aktiviert ist`TENANT`, zeichnet SES die Unterdrückungseinträge automatisch wie folgt auf:
+ **Hard Bounces** — SES fügt die Adresse der Unterdrückungsliste des Mandanten und der globalen Unterdrückungsliste hinzu. SES fügt die Adresse *nicht* zur Unterdrückungsliste auf Kontoebene hinzu.
+ **Beschwerden** — SES fügt die Adresse nur zur Sperrliste des Mandanten hinzu.
+ **Not-spam Feedback** — Wenn ein Empfänger eine zuvor gemeldete Nachricht als nicht als Spam markiert, entfernt `COMPLAINT` SES automatisch Einträge aus der Unterdrückungsliste des Mieters.

## Identifizierung von Anfragen zur Unterdrückung durch Mandanten
<a name="sending-email-suppression-list-tenant-level-identifying-bounces"></a>

Wenn SES eine Nachricht unterdrückt, weil die Adresse auf der Unterdrückungsliste eines Mandanten steht, können Sie das Ereignis anhand der folgenden Indikatoren identifizieren:
+ **Bounce-Benachrichtigung** — Der Bounce-Typ hat `Permanent` den Untertyp. `OnTenantSuppressionList`
+ **Virtual Deliverability Manager (VDM)** — Der Grund für den Abbruch ist. `ON_TENANT_SUPPRESSION_LIST`
+ **Diagnosecode —** `"Amazon SES did not send the message to this address because it is on the suppression list for your tenant."`
+ **Event-Tag** — SES fügt Benachrichtigungen über Absender und Beschwerden ein `ses:tenant-name` Tag hinzu, sodass Sie feststellen können, welchem Mandanten das Ereignis gehört.

## Verwaltung von Einträgen in der Liste zur Unterdrückung von Mandanten
<a name="sending-email-suppression-list-tenant-level-managing-entries"></a>

Sie verwalten die Einträge in der Mandantenunterdrückungsliste, indem Sie dieselben API-Operationen verwenden, die Sie für Einträge auf Kontoebene verwenden. Um gezielt auf die Unterdrückungsliste eines Mandanten abzuzielen, fügen Sie den `TenantName` Parameter in Ihre Anfrage ein:
+ `PutSuppressedDestination`— Fügt der Unterdrückungsliste eines Mandanten eine Adresse hinzu.
+ `GetSuppressedDestination`— Ruft Details zu einer unterdrückten Adresse für einen Mandanten ab.
+ `DeleteSuppressedDestination`— Entfernt eine Adresse aus der Unterdrückungsliste eines Mandanten.
+ `ListSuppressedDestinations`— Listet alle unterdrückten Adressen für einen Mandanten auf.

Wenn Sie den `TenantName` Parameter weglassen, zielen diese Operationen auf die Unterdrückungsliste auf Kontoebene ab. Dadurch wird die Abwärtskompatibilität mit bestehenden Integrationen aufrechterhalten.

## Überlegungen und Einschränkungen
<a name="sending-email-suppression-list-tenant-level-considerations"></a>

Beachten Sie Folgendes, wenn Sie Unterdrückungslisten auf Mandantenebene verwenden:
+ **Multi-tenancy erforderlich** — Sie müssen SES Multi-Tenancy mit mindestens einem Mandanten konfiguriert haben, um diese Funktion nutzen zu können.
+ **Eine Liste pro Mandant — Jeder Mandant** hat genau eine Unterdrückungsliste. Es gibt eine 1:1 -Zuordnung zwischen Mandanten und Unterdrückungslisten.
+ **Region-specific**— Listen zur Unterdrückung von Mandanten sind spezifisch für die Liste, AWS-Region in der Sie sie konfigurieren.
+ **Adressen bleiben bestehen** — Unterdrückte Adressen verbleiben auf der Mandantenliste, bis Sie sie explizit entfernen oder bis SES sie automatisch entfernt (z. B. wenn ein Empfänger aufgrund eines Eintrags aus einem Grund ein Nicht-Spam-Ereignis meldet). `COMPLAINT`
+ **Case-sensitive Speicher** — E-Mail-Adressen auf der Unterdrückungsliste werden unter Beibehaltung der Groß- und Kleinschreibung gespeichert. API-Aufrufe zur Verwaltung der Unterdrückungsliste erfordern eine genaue Übereinstimmung zwischen Groß- und Kleinschreibung.
+ **Auswirkung auf das Sendekontingent** — Nachrichten, die von einer Mandantenunterdrückungsliste unterdrückt wurden, werden auf Ihr tägliches Sendekontingent angerechnet.
+ **Gmail-Beschwerdedaten** — Gmail sendet keine Beschwerdedaten an SES. Von Gmail gehostete Adressen werden nicht automatisch zur Unterdrückungsliste für Beschwerden hinzugefügt.
+ **Sandbox-Einschränkungen** — Sie können `PutSuppressedDestination` erst anrufen, wenn Ihr Konto Produktionszugriff hat.
+ **Einstellungen löschen** — Um die Unterdrückungseinstellungen eines Mandanten zu löschen, rufen Sie `PutTenantSuppressionAttributes` mit Nullwerten an, sowohl für den Umfang als auch für die Gründe.
+ **Löschen eines Mandanten** — Wenn Sie einen Mandanten löschen, löscht SES auch alle Einträge in der Unterdrückungsliste für diesen Mandanten.

## Zugehörige Ressourcen
<a name="sending-email-suppression-list-tenant-level-related-resources"></a>

Die folgenden Ressourcen können Ihnen helfen, mehr über Unterdrückungslisten in SES zu erfahren.
+ [Verwenden der Unterdrückungsliste auf Kontoebene der Amazon-SES-Konsole](sending-email-suppression-list.md)
+ [Globale Unterdrückungsliste in Amazon SES](sending-email-global-suppression-list.md)