View a markdown version of this page

Utilizzo di elenchi di soppressione a livello di tenant in Amazon SES - Amazon Simple Email Service
Come funziona la soppressione a livello di tenantPrecedenza di soppressioneRegistrazione automatica della soppressioneIdentificazione dei rimbalzi di soppressione degli inquiliniGestione delle vociConsiderazioni e limitazioniRisorse correlate

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

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

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.

  • BOUNCEeCOMPLAINT: 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

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

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.

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

  3. 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 è impostatoTENANT, 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 è impostatoACCOUNT, 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

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

Quando l'ambito di soppressione è impostatoTENANT, 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

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

È 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

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.

Le seguenti risorse possono aiutarti a saperne di più sugli elenchi di soppressione in SES.