Prerequisiti Attivazione della soppressione a livello di tenant Configurazione della soppressione per un nuovo tenant Sovrascrivere con un set di configurazione Disattivazione della soppressione a livello di tenant Visualizzazione della configurazione di soppressione corrente Risoluzione dei problemi Risorse correlate

Configurazione della soppressione a livello di tenant

Configura le impostazioni di soppressione a livello di tenant per controllare in che modo Amazon Simple Email Service (Amazon SES) Simple Email Service (Amazon SES) gestisce i respingimenti e i reclami per i singoli tenant. Per impostazione predefinita, i tenant utilizzano l'elenco di soppressione a livello di account. Quando si abilita la soppressione a livello di tenant, SES mantiene un elenco di soppressioni separato per ogni tenant. Ciò consente un controllo granulare sulla recapitabilità delle e-mail.

Questo argomento fornisce le procedure per abilitare, modificare, disabilitare e visualizzare le impostazioni di soppressione a livello di tenant utilizzando. AWS CLI

Importante

La disabilitazione della soppressione a livello di tenant non elimina le voci esistenti dall'elenco di soppressione del tenant. Se in un secondo momento si riattiva la soppressione a livello di tenant, tali voci sono ancora attive.

Prerequisiti

Prima di configurare la soppressione a livello di tenant, assicuratevi di soddisfare i seguenti requisiti:

Multi-tenancy è abilitato nel tuo account SES.
Nel tuo account è presente almeno un inquilino o prevedi di crearne uno come parte di questa procedura.
AWS CLI la versione 2 è installata e configurata con le autorizzazioni appropriate. Per ulteriori informazioni, consulta la Guida per l'utente AWS Command Line Interface.
Conoscete i concetti di soppressione a livello di account. Per ulteriori informazioni, consulta Utilizzo dell'elenco di eliminazione a livello di account di Amazon SES.

Attivazione della soppressione a livello di tenant per un tenant esistente

Utilizza l'operazione PutTenantSuppressionAttributes API per abilitare la soppressione a livello di tenant per un tenant esistente. Questa operazione è idempotente, quindi è possibile richiamarla più volte con gli stessi parametri senza effetti collaterali.

Per abilitare la soppressione a livello di tenant

Nella riga di comando, esegui il put-tenant-suppression-attributes comando seguente per abilitare la soppressione a livello di tenant sia per i rimbalzi che per i reclami:

Sostituiscilo MyTenant con il nome del tuo inquilino.

Verifica che il comando non restituisca alcun output. Una richiesta riuscita restituisce una risposta HTTP 200 senza corpo.
Conferma la configurazione eseguendo il comando seguente:
```
aws sesv2 get-tenant --tenant-name MyTenant
```

Il tenant ora utilizza la propria lista di soppressione sia per i rimbalzi che per i reclami.

È inoltre possibile configurare la soppressione per un singolo tipo di motivo. Gli esempi seguenti mostrano come abilitare la soppressione solo per i rimbalzi o solo per i reclami.

Il comando seguente sopprime solo i rimbalzi:

Il comando seguente elimina solo i reclami:

Nota

È necessario fornire --suppression-scope e insieme. --suppressed-reasons Fornire uno senza l'altro restituisce unInvalidParameterValueException.

Configurazione della soppressione durante la creazione di un nuovo tenant

Utilizza l'operazione CreateTenant API con il SuppressionAttributes parametro per creare un tenant con la soppressione a livello di tenant abilitata fin dall'inizio.

Per creare un tenant con soppressione a livello di tenant

Nella riga di comando, esegui il comando seguente: create-tenant

Sostituiscilo MyNewTenant con il nome del nuovo inquilino.

Verifica che la risposta contenga l'ID del tenant:
```
{
    "TenantId": "tn-abc123def456"
}
```

Il tenant viene creato con la soppressione a livello di tenant abilitata sia per i rimbalzi che per i reclami.

Nota

Se si omette, per impostazione predefinita il tenant utilizza l'--suppression-attributesambito e utilizza l'elenco di soppressione a livello di account. ACCOUNT

Sovrascrivere la soppressione dei tenant con un set di configurazione

È possibile sovrascrivere le impostazioni di soppressione di un tenant aggiungendole SuppressionScope a un set di configurazione. SuppressionOptions Quando si invia e-mail utilizzando questo set di configurazione, le impostazioni di soppressione del set di configurazione hanno la precedenza sulle impostazioni del tenant. È possibile sovrascrivere solo l'ambito, solo i motivi o entrambi in modo indipendente.

Per creare un set di configurazione con l'override dell'ambito del tenant

Nella riga di comando, esegui il comando seguente: create-configuration-set

Sostituiscilo my-config-set con il nome del set di configurazione.

Verificate che il comando non restituisca alcun output. Una richiesta riuscita restituisce una risposta HTTP 200.

Per aggiornare un set di configurazione esistente con opzioni di soppressione

Nella riga di comando, esegui il put-configuration-set-suppression-options comando seguente:

Sostituisci my-config-set con il nome del set di configurazione.

Verificate che il comando non restituisca alcun output. Una richiesta riuscita restituisce una risposta HTTP 200.

Disattivazione della soppressione a livello di tenant

Per riportare un tenant alla soppressione a livello di account, è possibile impostare l'ambito su o cancellare tutte le impostazioni di soppressione. ACCOUNT

Per impostare il tenant sulla soppressione a livello di account

Nella riga di comando, esegui il comando seguente per impostare in modo esplicito l'ambito su: ACCOUNT

MyTenantSostituiscilo con il nome del tuo inquilino.

Verifica che il comando non restituisca alcun output.

Per cancellare tutte le impostazioni di soppressione

Nella riga di comando, esegui il comando seguente senza specificare l'ambito o i motivi:
```
aws sesv2 put-tenant-suppression-attributes --tenant-name MyTenant
```
MyTenantSostituiscilo con il nome del tuo inquilino.
Verifica che il comando non restituisca alcun output.

Nota

Quando si omettono entrambi --suppression-scope e--suppressed-reasons, SES cancella le impostazioni di soppressione del tenant. Il tenant torna al comportamento di soppressione a livello di account.

Importante

Visualizzazione della configurazione di soppressione corrente

Utilizza l'operazione GetTenant API per controllare le attuali impostazioni di soppressione di un tenant.

Per visualizzare la configurazione di soppressione di un tenant

Nella riga di comando, esegui il comando seguente: get-tenant
```
aws sesv2 get-tenant --tenant-name MyTenant
```
MyTenantSostituiscilo con il nome del tuo inquilino.

Rivedi la risposta. L'esempio seguente mostra un tenant con la soppressione a livello di tenant abilitata:


{
    "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"]
        }
    }
}

La tabella seguente descrive i campi chiave dell'oggetto. SuppressionAttributes

Campo	Description
`SuppressionScope`	L'ambito di soppressione per il tenant. Un valore di `TENANT` indica che il tenant utilizza il proprio elenco di soppressione. Un valore di `ACCOUNT` indica che il tenant utilizza l'elenco di soppressione a livello di account.
`SuppressedReasons`	I motivi di soppressione attivi per il tenant. I valori possibili sono `BOUNCECOMPLAINT`, o entrambi.

Se SuppressionAttributes è assente o nullo nella risposta, il tenant utilizza la soppressione a livello di account.

Risoluzione dei problemi

Di seguito sono riportati gli errori più comuni che si possono verificare durante la configurazione della soppressione a livello di tenant.

InvalidParameterValueException: SuppressedReasons cannot be null when SuppressionScope is provided

Causa: hai specificato senza. --suppression-scope --suppressed-reasons
Correzione: fornite entrambi i parametri insieme o ometteteli entrambi per cancellare le impostazioni.

InvalidParameterValueException: SuppressionScope is required when SuppressedReasons are provided

Causa: hai specificato --suppressed-reasons senza--suppression-scope.
Correzione: fornisce entrambi i parametri insieme.

NotFoundException

Causa: il nome del tenant specificato non esiste.
Correzione — Verifica il nome del tenant eseguendo il seguente comando:
```
aws sesv2 list-tenants
```

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Tenant-levelelenchi di soppressione

Gestione delle voci di soppressione dei tenant