

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
<a name="sending-email-suppression-list-tenant-level-manage"></a>

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
<a name="managing-tenant-suppression-prerequisites"></a>

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](sending-email-suppression-list-tenant-level-configure.md).
+ AWS CLI Version 2 ist mit den entsprechenden Berechtigungen installiert und konfiguriert. Weitere Informationen finden Sie im [AWS Command Line Interface -Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/).
+ Der Mandant ist in Ihrem SES-Konto vorhanden.

## Eine Adresse zur Unterdrückungsliste eines Mandanten hinzufügen
<a name="adding-tenant-suppression-entry"></a>

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:

------
#### [ Linux, macOS, or Unix ]

  ```
  aws sesv2 put-suppressed-destination \
  --email-address {{recipient@example.com}} \
  --reason {{BOUNCE}} \
  --tenant-name {{MyTenant}}
  ```

------
#### [ Windows ]

  ```
  aws sesv2 put-suppressed-destination `
  --email-address {{recipient@example.com}} `
  --reason {{BOUNCE}} `
  --tenant-name {{MyTenant}}
  ```

------

  Im vorherigen Beispiel {{recipient@example.com}} ersetzen Sie es durch die E-Mail-Adresse, die Sie hinzufügen möchten, {{BOUNCE}} durch den Grund für die Unterdrückung (zulässige Werte sind `BOUNCE` und`COMPLAINT`) und {{MyTenant}} durch 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` oder`COMPLAINT`. Sie können dieselbe Adresse aus unterschiedlichen Gründen hinzufügen.

## Prüft, ob eine Adresse auf der Unterdrückungsliste eines Mandanten steht
<a name="checking-tenant-suppression-entry"></a>

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:

------
#### [ Linux, macOS, or Unix ]

  ```
  aws sesv2 get-suppressed-destination \
  --email-address {{recipient@example.com}} \
  --tenant-name {{MyTenant}}
  ```

------
#### [ Windows ]

  ```
  aws sesv2 get-suppressed-destination `
  --email-address {{recipient@example.com}} `
  --tenant-name {{MyTenant}}
  ```

------

  Ersetzen Sie es im vorherigen Beispiel {{recipient@example.com}} durch die E-Mail-Adresse, die überprüft werden soll, und {{MyTenant}} durch 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 (`BOUNCE`oder`COMPLAINT`).
+ `LastUpdateTime`— Wann der Eintrag zuletzt aktualisiert wurde.
+ `Attributes`— Enthält `MessageId` und `FeedbackId` stammt 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
<a name="removing-tenant-suppression-entry"></a>

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:

------
#### [ Linux, macOS, or Unix ]

  ```
  aws sesv2 delete-suppressed-destination \
  --email-address {{recipient@example.com}} \
  --tenant-name {{MyTenant}}
  ```

------
#### [ Windows ]

  ```
  aws sesv2 delete-suppressed-destination `
  --email-address {{recipient@example.com}} `
  --tenant-name {{MyTenant}}
  ```

------

  Ersetzen Sie es im vorherigen Beispiel {{recipient@example.com}} durch die E-Mail-Adresse, die entfernt werden soll, und {{MyTenant}} durch 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
<a name="listing-tenant-suppression-entries"></a>

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:

------
#### [ Linux, macOS, or Unix ]

  ```
  aws sesv2 list-suppressed-destinations \
  --tenant-name {{MyTenant}}
  ```

------
#### [ Windows ]

  ```
  aws sesv2 list-suppressed-destinations `
  --tenant-name {{MyTenant}}
  ```

------

  Im vorherigen Beispiel {{MyTenant}} ersetzen 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
<a name="filtering-tenant-suppression-entries"></a>

Sie können die Ergebnisse nach Grund, Datumsbereich oder beidem filtern.

Der folgende Befehl filtert nach Grund:

------
#### [ Linux, macOS, or Unix ]

```
aws sesv2 list-suppressed-destinations \
--tenant-name {{MyTenant}} \
--reasons BOUNCE COMPLAINT
```

------
#### [ Windows ]

```
aws sesv2 list-suppressed-destinations `
--tenant-name {{MyTenant}} `
--reasons BOUNCE COMPLAINT
```

------

Der folgende Befehl filtert nach Datumsbereich:

------
#### [ Linux, macOS, or Unix ]

```
aws sesv2 list-suppressed-destinations \
--tenant-name {{MyTenant}} \
--start-date {{2026-01-01T00:00:00Z}} \
--end-date {{2026-03-31T23:59:59Z}}
```

------
#### [ Windows ]

```
aws sesv2 list-suppressed-destinations `
--tenant-name {{MyTenant}} `
--start-date {{2026-01-01T00:00:00Z}} `
--end-date {{2026-03-31T23:59:59Z}}
```

------

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 Informationen`Attributes`, einschließlich, zu erhalten, verwenden Sie `GetSuppressedDestination` die Option für einzelne Adressen.

## Automatische Unterdrückung von Einträgen
<a name="automatic-tenant-suppression-entries"></a>

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.