View a markdown version of this page

Konfiguration der Unterdrückung auf Mandantenebene - Amazon Simple Email Service
VoraussetzungenAktivierung der Unterdrückung auf MandantenebeneKonfiguration der Unterdrückung für einen neuen MandantenÜberschreiben mit einem KonfigurationssatzUnterdrückung auf Mandantenebene wird deaktiviertAktuelle Unterdrückungskonfiguration anzeigenFehlerbehebungZugehörige Ressourcen

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.

Konfiguration der Unterdrückung auf Mandantenebene

Konfigurieren Sie Unterdrückungseinstellungen auf Mandantenebene, um zu steuern, wie Amazon Simple Email Service (Amazon SES) mit Bounces und Beschwerden einzelner Mandanten umgeht. Standardmäßig verwenden Mandanten Ihre Unterdrückungsliste auf Kontoebene. Wenn Sie die Unterdrückung auf Mandantenebene aktivieren, verwaltet SES für jeden Mandanten eine separate Unterdrückungsliste. Auf diese Weise haben Sie eine detaillierte Kontrolle über die Zustellbarkeit von E-Mails.

Dieses Thema enthält Verfahren zum Aktivieren, Ändern, Deaktivieren und Anzeigen von Unterdrückungseinstellungen auf Mandantenebene mithilfe von. AWS CLI

Wichtig

Durch das Deaktivieren der Unterdrückung auf Mandantenebene werden keine vorhandenen Einträge aus der Unterdrückungsliste des Mandanten gelöscht. Wenn Sie die Unterdrückung auf Mandantenebene später wieder aktivieren, sind diese Einträge weiterhin aktiv.

Voraussetzungen

Bevor Sie die Unterdrückung auf Mandantenebene konfigurieren, stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen:

Aktivierung der Unterdrückung auf Mandantenebene für einen bestehenden Mandanten

Verwenden Sie den PutTenantSuppressionAttributes API-Vorgang, um die Unterdrückung auf Mandantenebene für einen vorhandenen Mandanten zu aktivieren. Diese Operation ist idempotent, sodass Sie sie ohne Nebenwirkungen mehrmals mit denselben Parametern aufrufen können.

Um die Unterdrückung auf Mandantenebene zu aktivieren

  1. Führen Sie in der Befehlszeile den folgenden put-tenant-suppression-attributes Befehl aus, um die Unterdrückung auf Mandantenebene sowohl für Bounces als auch für Beschwerden zu aktivieren:

    Linux, macOS, or Unix
    aws sesv2 put-tenant-suppression-attributes \
--tenant-name MyTenant \
--suppression-scope TENANT \
--suppressed-reasons BOUNCE COMPLAINT
    Windows
    aws sesv2 put-tenant-suppression-attributes `
--tenant-name MyTenant `
--suppression-scope TENANT `
--suppressed-reasons BOUNCE COMPLAINT

    Ersetzen Sie es MyTenant durch den Namen Ihres Mandanten.

  2. Stellen Sie sicher, dass der Befehl keine Ausgabe zurückgibt. Eine erfolgreiche Anfrage gibt eine HTTP 200-Antwort ohne Hauptteil zurück.

  3. Bestätigen Sie die Konfiguration, indem Sie den folgenden Befehl ausführen:

    aws sesv2 get-tenant --tenant-name MyTenant

Der Mandant verwendet jetzt seine eigene Unterdrückungsliste sowohl für Bounces als auch für Beschwerden.

Sie können die Unterdrückung auch für einen einzelnen Grausyp konfigurieren. Die folgenden Beispiele zeigen, wie Sie die Unterdrückung nur für Bounces oder Beschwerden aktivieren können.

Mit dem folgenden Befehl werden nur Bounces unterdrückt:

Linux, macOS, or Unix
aws sesv2 put-tenant-suppression-attributes \
--tenant-name MyTenant \
--suppression-scope TENANT \
--suppressed-reasons BOUNCE
Windows
aws sesv2 put-tenant-suppression-attributes `
--tenant-name MyTenant `
--suppression-scope TENANT `
--suppressed-reasons BOUNCE

Der folgende Befehl unterdrückt nur Beschwerden:

Linux, macOS, or Unix
aws sesv2 put-tenant-suppression-attributes \
--tenant-name MyTenant \
--suppression-scope TENANT \
--suppressed-reasons COMPLAINT
Windows
aws sesv2 put-tenant-suppression-attributes `
--tenant-name MyTenant `
--suppression-scope TENANT `
--suppressed-reasons COMPLAINT
Anmerkung

Sie müssen --suppression-scope und --suppressed-reasons zusammen bereitstellen. Wenn Sie eines ohne das andere angeben, wird ein zurückgegebenInvalidParameterValueException.

Konfiguration der Unterdrückung beim Erstellen eines neuen Mandanten

Verwenden Sie den CreateTenant API-Vorgang mit dem SuppressionAttributes Parameter, um einen Mandanten zu erstellen, bei dem die Unterdrückung auf Mandantenebene von Anfang an aktiviert ist.

Um einen Mandanten mit Unterdrückung auf Mandantenebene zu erstellen

  1. Führen Sie in der Befehlszeile den folgenden create-tenant Befehl aus:

    Linux, macOS, or Unix
    aws sesv2 create-tenant \
--tenant-name MyNewTenant \
--suppression-attributes '{"SuppressionScope":"TENANT","SuppressedReasons":["BOUNCE","COMPLAINT"]}'
    Windows
    aws sesv2 create-tenant `
--tenant-name MyNewTenant `
--suppression-attributes '{"SuppressionScope":"TENANT","SuppressedReasons":["BOUNCE","COMPLAINT"]}'

    MyNewTenantErsetzen Sie es durch den Namen Ihres neuen Mandanten.

  2. Stellen Sie sicher, dass die Antwort die Mandanten-ID enthält:

    {
    "TenantId": "tn-abc123def456"
}

Der Mandant wird so erstellt, dass die Unterdrückung auf Mandantenebene sowohl für Bounces als auch für Beschwerden aktiviert ist.

Anmerkung

Wenn Sie diese Option weglassen--suppression-attributes, verwendet der Mandant standardmäßig den ACCOUNT Geltungsbereich und verwendet die Unterdrückungsliste auf Kontoebene.

Überschreiben der Mandantenunterdrückung mit einem Konfigurationssatz

Sie können die Unterdrückungseinstellungen eines Mandanten überschreiben, indem Sie sie SuppressionScope zu den Einstellungen eines Konfigurationssatzes hinzufügen. SuppressionOptions Wenn Sie mit diesem Konfigurationssatz E-Mails senden, haben die Unterdrückungseinstellungen des Konfigurationssatzes Vorrang vor den Einstellungen des Mandanten. Sie können nur den Geltungsbereich, nur Gründe oder beide unabhängig voneinander außer Kraft setzen.

Um einen Konfigurationssatz mit Mandantenbereichsüberschreibung zu erstellen

  1. Führen Sie in der Befehlszeile den folgenden create-configuration-set Befehl aus:

    Linux, macOS, or Unix
    aws sesv2 create-configuration-set \
--configuration-set-name my-config-set \
--suppression-options '{"SuppressionScope":"TENANT","SuppressedReasons":["BOUNCE"]}'
    Windows
    aws sesv2 create-configuration-set `
--configuration-set-name my-config-set `
--suppression-options '{"SuppressionScope":"TENANT","SuppressedReasons":["BOUNCE"]}'

    my-config-setErsetzen Sie es durch den Namen für Ihren Konfigurationssatz.

  2. Stellen Sie sicher, dass der Befehl keine Ausgabe zurückgibt. Eine erfolgreiche Anfrage gibt eine HTTP 200-Antwort zurück.

Um einen vorhandenen Konfigurationssatz mit Unterdrückungsoptionen zu aktualisieren

  1. Führen Sie in der Befehlszeile den folgenden put-configuration-set-suppression-options Befehl aus:

    Linux, macOS, or Unix
    aws sesv2 put-configuration-set-suppression-options \
--configuration-set-name my-config-set \
--suppression-scope TENANT \
--suppressed-reasons BOUNCE
    Windows
    aws sesv2 put-configuration-set-suppression-options `
--configuration-set-name my-config-set `
--suppression-scope TENANT `
--suppressed-reasons BOUNCE

    my-config-setErsetzen Sie es durch den Namen Ihres Konfigurationssatzes.

  2. Stellen Sie sicher, dass der Befehl keine Ausgabe zurückgibt. Eine erfolgreiche Anfrage gibt eine HTTP 200-Antwort zurück.

Unterdrückung auf Mandantenebene wird deaktiviert

Um für einen Mandanten die Unterdrückung auf Kontoebene wiederherzustellen, können Sie entweder den Geltungsbereich auf ACCOUNT oder alle Unterdrückungseinstellungen löschen.

Um für den Mandanten die Unterdrückung auf Kontoebene einzurichten

  1. Führen Sie in der Befehlszeile den folgenden Befehl aus, um den Bereich explizit auf festzulegen: ACCOUNT

    Linux, macOS, or Unix
    aws sesv2 put-tenant-suppression-attributes \
--tenant-name MyTenant \
--suppression-scope ACCOUNT \
--suppressed-reasons BOUNCE COMPLAINT
    Windows
    aws sesv2 put-tenant-suppression-attributes `
--tenant-name MyTenant `
--suppression-scope ACCOUNT `
--suppressed-reasons BOUNCE COMPLAINT

    MyTenantErsetzen Sie es durch den Namen Ihres Mandanten.

  2. Stellen Sie sicher, dass der Befehl keine Ausgabe zurückgibt.

Um alle Unterdrückungseinstellungen zu löschen

  1. Führen Sie in der Befehlszeile den folgenden Befehl aus, ohne Umfang oder Gründe anzugeben:

    aws sesv2 put-tenant-suppression-attributes --tenant-name MyTenant

    MyTenantErsetzen Sie ihn durch den Namen Ihres Mandanten.

  2. Stellen Sie sicher, dass der Befehl keine Ausgabe zurückgibt.

Anmerkung

Wenn Sie --suppression-scope sowohl als auch weglassen--suppressed-reasons, löscht SES die Unterdrückungseinstellungen des Mandanten. Der Mandant greift auf das Unterdrückungsverhalten auf Kontoebene zurück.

Wichtig

Durch die Deaktivierung der Unterdrückung auf Mandantenebene werden keine vorhandenen Einträge aus der Unterdrückungsliste des Mandanten gelöscht. Wenn Sie die Unterdrückung auf Mandantenebene später wieder aktivieren, sind diese Einträge weiterhin aktiv.

Aktuelle Unterdrückungskonfiguration anzeigen

Verwenden Sie den GetTenant API-Vorgang, um die aktuellen Unterdrückungseinstellungen eines Mandanten zu überprüfen.

Um die Unterdrückungskonfiguration eines Mandanten einzusehen

  1. Führen Sie in der Befehlszeile den folgenden get-tenant Befehl aus:

    aws sesv2 get-tenant --tenant-name MyTenant

    MyTenantErsetzen Sie es durch den Namen Ihres Mandanten.

  2. Überprüfen Sie die Antwort. Das folgende Beispiel zeigt einen Mandanten mit aktivierter Unterdrückung auf Mandantenebene:

    {
    "Tenant": {
        "TenantName": "MyTenant",
        "TenantId": "tn-abc123def456",
        "TenantArn": "arn:aws:ses:us-east-1:123456789012:tenant/MyTenant/tn-abc123def456",
        "SendingStatus": "ENABLED",
        "CreatedTimestamp": 1705312800,
        "UpdateTimestamp": 1705762800,
        "SuppressionAttributes": {
            "SuppressionScope": "TENANT",
            "SuppressedReasons": ["BOUNCE", "COMPLAINT"]
        }
    }
}

In der folgenden Tabelle werden die wichtigsten Felder im SuppressionAttributes Objekt beschrieben.

Feld Description
SuppressionScope Der Unterdrückungsbereich für den Mandanten. Der Wert TENANT bedeutet, dass der Mandant seine eigene Unterdrückungsliste verwendet. Der Wert ACCOUNT bedeutet, dass der Mandant die Unterdrückungsliste auf Kontoebene verwendet.
SuppressedReasons Die Unterdrückungsgründe, die für den Mandanten aktiv sind. Mögliche Werte sind BOUNCECOMPLAINT, oder beide.

Fehlt der Wert in der Antwort oder SuppressionAttributes ist Null, verwendet der Mandant die Unterdrückung auf Kontoebene.

Fehlerbehebung

Im Folgenden sind häufig auftretende Fehler aufgeführt, die bei der Konfiguration der Unterdrückung auf Mandantenebene auftreten können.

InvalidParameterValueException: SuppressedReasons cannot be null when SuppressionScope is provided

  • Ursache — Sie haben ohne angegeben--suppression-scope. --suppressed-reasons

  • Korrigieren — Geben Sie beide Parameter zusammen an oder lassen Sie beide weg, um die Einstellungen zu löschen.

InvalidParameterValueException: SuppressionScope is required when SuppressedReasons are provided

  • Ursache — Sie haben --suppressed-reasons ohne --suppression-scope angegeben.

  • Korrigieren — Geben Sie beide Parameter zusammen an.

NotFoundException

  • Ursache — Der von Ihnen angegebene Mandantenname existiert nicht.

  • Behebung — Überprüfen Sie den Mandantennamen, indem Sie den folgenden Befehl ausführen:

    aws sesv2 list-tenants