Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilizzo di elenchi di soppressione a livello di tenant in Amazon SES
<a name="sending-email-suppression-list-tenant-level"></a>

Se utilizzi la modalità multi-tenancy di Amazon Simple Email Service (SES) per inviare e-mail per conto di più tenant, puoi assegnare a ciascun tenant la propria lista di soppressione. Tenant-level la soppressione isola i respingimenti e i reclami in modo che riguardino solo il tenant che ha inviato l'e-mail. Senza questa funzionalità, tutti i tenant condividono l'elenco di soppressione a livello di account. Quando un destinatario non risponde o si lamenta dell'e-mail di un inquilino, quell'indirizzo viene soppresso per ogni inquilino dell'account. Tenant-level la soppressione impedisce questa contaminazione tra tenant mantenendo un elenco separato di indirizzi soppressi per ogni tenant.

## Come funziona la soppressione a livello di tenant
<a name="sending-email-suppression-list-tenant-level-how-it-works"></a>

**Due impostazioni controllano il comportamento di soppressione per ogni tenant: l'ambito della soppressione e i motivi soppressi.** È possibile configurare entrambe le impostazioni insieme utilizzando l'operazione `PutTenantSuppressionAttributes` API o specificando `SuppressionAttributes` quando si crea un tenant con l'operazione API. `CreateTenant`

L'**ambito di soppressione** determina l'elenco di soppressione utilizzato da SES per il tenant:
+ `TENANT`— Utilizza l'elenco di soppressione del tenant.
+ `ACCOUNT`— Utilizza l'elenco di soppressione a livello di account. Questa è l'impostazione predefinita sia per gli inquilini esistenti che per quelli nuovi.

I **motivi soppressi** determinano quali eventi fanno sì che SES aggiunga indirizzi all'elenco di soppressione:
+ `BOUNCE`— Aggiungi indirizzi che generano hard bounce.
+ `COMPLAINT`— Aggiungi indirizzi che generano reclami.
+ `BOUNCE`e`COMPLAINT`: aggiungi gli indirizzi che producono entrambi gli eventi.
+ Vuoto: non controlla né registra in alcun elenco di soppressione.

**Nota**  
È necessario fornire `SuppressionScope` e `SuppressedReasons` insieme oppure impostare entrambi su null. L'impostazione di entrambi su null cancella le impostazioni di soppressione del tenant e riporta il tenant al comportamento di ambito predefinito. `ACCOUNT`

### Comportamento di soppressione in base alla configurazione
<a name="sending-email-suppression-list-tenant-level-behavior-by-config"></a>

La tabella seguente descrive il comportamento di invio e registrazione per ogni combinazione di ambito di soppressione e motivi di soppressione.


| Scope | Motivi | Send-time comportamento | Comportamento di registrazione | 
| --- | --- | --- | --- | 
| TENANT | BOUNCE, COMPLAINT | Controlla l'elenco degli inquilini per eventuali rimbalzi e reclami | Registra entrambi nell'elenco degli inquilini | 
| TENANT | BOUNCE | Controlla l'elenco degli inquilini solo per eventuali rimbalzi | Registra i rimbalzi solo nell'elenco degli inquilini | 
| TENANT | COMPLAINT | Controlla l'elenco degli inquilini solo per eventuali reclami | Registra i reclami solo nell'elenco degli inquilini | 
| TENANT | Empty | Nessun controllo di soppressione | Nessuna registrazione | 
| ACCOUNT | BOUNCE, COMPLAINT | Controlla l'elenco degli account per eventuali rimbalzi e reclami | Registra entrambi nell'elenco degli account | 
| ACCOUNT | BOUNCE | Controlla solo i rimbalzi nell'elenco degli account | Registra i rimbalzi solo nell'elenco degli account | 
| ACCOUNT | COMPLAINT | Controlla l'elenco degli account solo per i reclami | Registra i reclami solo nell'elenco degli account | 
| ACCOUNT | Empty | Nessun controllo di soppressione | Nessuna registrazione | 

## Soppressione, precedenza e comportamento in fase di invio
<a name="sending-email-suppression-list-tenant-level-precedence"></a>

SES risolve le impostazioni di soppressione nel seguente ordine di precedenza, dal più alto al più basso:

1. **Set di configurazione**: se il set di configurazione specifica impostazioni di soppressione, SES utilizza tali impostazioni.

1. **Tenant**: se non esiste alcuna alternativa al set di configurazione, SES utilizza le impostazioni di soppressione del tenant.

1. **Account**: se né il set di configurazione né il tenant specificano le impostazioni, SES utilizza le impostazioni predefinite a livello di account.

**Importante**  
L'ambito di soppressione determina l'elenco di soppressione che SES controlla al momento dell'invio. Quando l'ambito è impostato`TENANT`, SES controlla solo l'elenco di soppressione del tenant e salta l'elenco di soppressione a livello di account. Un indirizzo che si trova nell'elenco di soppressione a livello di account ma non nell'elenco di soppressione del tenant non viene soppresso. Quando l'ambito è impostato`ACCOUNT`, SES controlla solo l'elenco di soppressione a livello di account. L'ambito controlla anche dove vengono registrati i rimbalzi e i reclami.

### I set di configurazione sostituiscono
<a name="sending-email-suppression-list-tenant-level-config-set-overrides"></a>

Il set di configurazione `SuppressionOptions` per un set di configurazione ora include un `SuppressionScope` campo. È possibile utilizzare un set di configurazione per sovrascrivere solo l'ambito, solo i motivi o entrambi in modo indipendente. In questo modo è possibile controllare in modo preciso il comportamento di soppressione per flussi di lavoro di invio specifici. Non è necessario modificare le impostazioni predefinite del tenant.

## Registrazione automatica della soppressione
<a name="sending-email-suppression-list-tenant-level-auto-recording"></a>

Quando l'ambito di soppressione è impostato`TENANT`, SES registra automaticamente le voci di soppressione come segue:
+ **Hard bounces**: SES aggiunge l'indirizzo all'elenco di soppressione del tenant e all'elenco di soppressione globale. SES *non* aggiunge l'indirizzo all'elenco di soppressione a livello di account.
+ **Reclami**: SES aggiunge l'indirizzo solo all'elenco di soppressione dell'inquilino.
+ **Not-spam feedback**: quando un destinatario contrassegna un messaggio segnalato in precedenza come non spam, SES rimuove automaticamente le voci «`COMPLAINT`-reason» dall'elenco di soppressione del tenant.

## Identificazione dei rimbalzi di soppressione degli inquilini
<a name="sending-email-suppression-list-tenant-level-identifying-bounces"></a>

Quando SES elimina un messaggio perché l'indirizzo si trova nell'elenco di soppressione di un tenant, è possibile identificare l'evento utilizzando i seguenti indicatori:
+ **Notifica di rimbalzo**: il tipo di rimbalzo è con un sottotipo di. `Permanent` `OnTenantSuppressionList`
+ **Virtual Deliverability Manager (VDM**): il motivo del rimbalzo è. `ON_TENANT_SUPPRESSION_LIST`
+ **Codice** diagnostico: `"Amazon SES did not send the message to this address because it is on the suppression list for your tenant."`
+ **Tag evento**: SES aggiunge un `ses:tenant-name` tag alle notifiche di rimbalzo e di reclamo in modo da poter identificare a quale tenant appartiene l'evento.

## Gestione delle voci dell'elenco di soppressione dei tenant
<a name="sending-email-suppression-list-tenant-level-managing-entries"></a>

È possibile gestire le voci dell'elenco di soppressione dei tenant utilizzando le stesse operazioni API utilizzate per le voci a livello di account. Per scegliere come target l'elenco di soppressione di un tenant, includi il parametro nella tua richiesta: `TenantName`
+ `PutSuppressedDestination`— Aggiungere un indirizzo all'elenco di soppressione di un tenant.
+ `GetSuppressedDestination`— Recupera i dettagli su un indirizzo soppresso per un inquilino.
+ `DeleteSuppressedDestination`— Rimuove un indirizzo dall'elenco di soppressione di un inquilino.
+ `ListSuppressedDestinations`— Elenca tutti gli indirizzi soppressi per un inquilino.

Se si omette il `TenantName` parametro, queste operazioni hanno come obiettivo l'elenco di soppressione a livello di account. Ciò mantiene la compatibilità con le versioni precedenti con le integrazioni esistenti.

## Considerazioni e limitazioni
<a name="sending-email-suppression-list-tenant-level-considerations"></a>

Tieni presente quanto segue quando utilizzi gli elenchi di soppressione a livello di tenant:
+ **Multi-tenancy obbligatorio**: è necessario che SES multi-tenancy sia configurato con almeno un tenant per utilizzare questa funzionalità.
+ **Un elenco per tenant: ogni tenant** ha esattamente un elenco di soppressione. Esiste una mappatura 1:1 tra inquilini ed elenchi di soppressione.
+ **Region-specific**— Gli elenchi di soppressione dei tenant sono specifici del tipo in cui vengono configurati Regione AWS .
+ **Gli indirizzi persistono**: gli indirizzi soppressi rimangono nell'elenco del tenant finché non vengono rimossi esplicitamente o finché SES non li rimuove automaticamente (ad esempio, quando un destinatario segnala un evento di non spam per una voce -reason). `COMPLAINT`
+ **Case-sensitive archiviazione**: gli indirizzi e-mail nell'elenco di soppressione vengono archiviati mantenendo le maiuscole e minuscole. Le chiamate API per la gestione delle liste di soppressione richiedono una corrispondenza esatta tra maiuscole e minuscole.
+ **Impatto sulla quota di invio**: i messaggi eliminati da un elenco di soppressione dei tenant vengono conteggiati nella quota di invio giornaliera.
+ Dati relativi ai **reclami di Gmail: Gmail non invia i dati dei reclami** a SES. Gli indirizzi ospitati da Gmail non vengono aggiunti automaticamente all'elenco di soppressione dei reclami.
+ **Restrizioni relative alla sandbox**: non puoi chiamare `PutSuppressedDestination` finché il tuo account non ha accesso alla versione di produzione.
+ **Cancellazione delle impostazioni**: per cancellare le impostazioni di soppressione di un inquilino, chiama `PutTenantSuppressionAttributes` con valori nulli sia per l'ambito che per i motivi.
+ **Eliminazione di un tenant**: quando si elimina un tenant, SES elimina anche tutte le voci dell'elenco di soppressione relative a quel tenant.

## Risorse correlate
<a name="sending-email-suppression-list-tenant-level-related-resources"></a>

Le seguenti risorse possono aiutarti a saperne di più sugli elenchi di soppressione in SES.
+ [Utilizzo dell'elenco di eliminazione a livello di account di Amazon SES](sending-email-suppression-list.md)
+ [Elenco di eliminazione globale Amazon SES](sending-email-global-suppression-list.md)