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à.
Gestione delle voci dell'elenco di soppressione dei tenant
Gestisci le voci nell'elenco di soppressione di un tenant utilizzando le stesse operazioni dell'API Amazon Simple Email Service (SES) che usi per l'elenco di soppressione a livello di account. Per scegliere come target un elenco di tenant specifico, includi il parametro in ogni richiesta. --tenant-name Quando si omette questo parametro, le operazioni hanno come obiettivo l'elenco a livello di account. Utilizzate il AWS CLI per aggiungere, controllare, rimuovere ed elencare gli indirizzi soppressi per un tenant specifico.
Importante
Gli indirizzi e-mail nell'elenco di soppressione vengono archiviati mantenendo le maiuscole e minuscole. Sebbene la funzionalità di invio e-mail consideri identici gli indirizzi con maiuscole e minuscole diverse, le chiamate API per la gestione degli elenchi di soppressione richiedono una corrispondenza esatta dei casi. Quando aggiungi, controlli o rimuovi delle voci, assicurati di utilizzare l'indirizzo e-mail con le maiuscole e minuscole che compare nell'elenco di soppressione.
Prerequisiti
Prima di gestire le voci dell'elenco di soppressione dei tenant, assicuratevi di soddisfare i seguenti requisiti:
-
Tenant-level la soppressione è abilitata per il tenant. Per ulteriori informazioni, consulta Configurazione della soppressione a livello di tenant.
-
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.
-
Il tenant esiste nel tuo account SES.
Aggiungere un indirizzo all'elenco di soppressione di un inquilino
Utilizza l'operazione PutSuppressedDestination API con il --tenant-name parametro per aggiungere un indirizzo e-mail all'elenco di soppressione di un tenant.
Per aggiungere un indirizzo all'elenco di soppressione di un tenant utilizzando il AWS CLI
-
Nella riga di comando, inserisci il comando seguente:
Nell'esempio precedente, sostituiscilo
recipient@example.comcon l'indirizzo e-mail da aggiungere,BOUNCEcon il motivo della soppressione (i valori accettabili sonoBOUNCEeCOMPLAINT) eMyTenantcon il nome del tenant.
Il comando non produce alcun output in caso di successo (HTTP 200). L'indirizzo è ora nell'elenco di soppressione del tenant.
Nota
Il --reason parametro accetta BOUNCE o. COMPLAINT Puoi aggiungere lo stesso indirizzo per motivi diversi.
Verifica se un indirizzo è presente nell'elenco di soppressione di un inquilino
Utilizza l'operazione GetSuppressedDestination API con il --tenant-name parametro per verificare se un indirizzo e-mail è presente nell'elenco di soppressione di un tenant.
Per verificare se un indirizzo è presente nell'elenco di soppressione di un tenant, utilizzare il AWS CLI
-
Nella riga di comando, inserisci il comando seguente:
Nell'esempio precedente, sostituiscilo
recipient@example.comcon l'indirizzo e-mail da controllare eMyTenantcon il nome del tuo inquilino.
Se l'indirizzo è nell'elenco di soppressione del tenant, il comando restituisce un output simile al seguente esempio:
{ "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" } } }
La risposta include i seguenti campi:
-
EmailAddress— L'indirizzo e-mail soppresso. -
Reason— Perché l'indirizzo è stato soppresso (BOUNCEoCOMPLAINT). -
LastUpdateTime— Quando la voce è stata aggiornata l'ultima volta. -
Attributes— ContieneMessageIdeFeedbackIdderivante dall'evento che ha causato la soppressione. Questi campi sono presenti per gli indirizzi soppressi automaticamente e assenti per le voci aggiunte manualmente.
Nota
Se l'indirizzo non è presente nell'elenco di soppressione del tenant, l'API restituisce un. NotFoundException
Rimozione di un indirizzo dall'elenco di soppressione di un tenant
Utilizza l'operazione DeleteSuppressedDestination API con il --tenant-name parametro per rimuovere un indirizzo e-mail dall'elenco di soppressione di un tenant.
Per rimuovere un indirizzo dall'elenco di soppressione di un tenant utilizzando il AWS CLI
-
Nella riga di comando, inserisci il comando seguente:
Nell'esempio precedente, sostituiscilo
recipient@example.comcon l'indirizzo e-mail da rimuovere eMyTenantcon il nome del tuo inquilino.
Il comando non produce alcun output in caso di successo (HTTP 200). L'indirizzo viene rimosso dall'elenco di soppressione del tenant.
Importante
La rimozione di un indirizzo dall'elenco di soppressione di un tenant non lo rimuove dall'elenco di soppressione globale o dall'elenco di soppressione a livello di account. Ogni elenco è gestito in modo indipendente.
Elenco degli indirizzi nell'elenco di soppressione di un inquilino
Utilizza l'operazione ListSuppressedDestinations API con il --tenant-name parametro per recuperare tutti gli indirizzi soppressi per un tenant specifico.
Per elencare tutti gli indirizzi nell'elenco di soppressione di un tenant utilizzando il AWS CLI
-
Nella riga di comando, inserisci il comando seguente:
Nell'esempio precedente, sostituiscilo
MyTenantcon il nome del tuo inquilino.
L'output di esempio seguente mostra due indirizzi soppressi:
{ "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" } ] }
Filtrare i risultati
Puoi filtrare i risultati per motivo, intervallo di date o entrambi.
Il comando seguente filtra per motivo:
Il comando seguente filtra per intervallo di date:
Se la risposta include un NextToken valore, utilizzalo in una richiesta successiva per recuperare altri risultati. Utilizzate il --page-size parametro per controllare il numero di risultati per pagina.
Nota
L'operazione di elenco restituisce solo informazioni di riepilogo. Per ottenere dettagli completiAttributes, tra cui, utilizza GetSuppressedDestination per singoli indirizzi.
Inserimenti di soppressione automatica
SES gestisce automaticamente le voci di soppressione in base alla configurazione di soppressione del tenant. Non è necessario intraprendere alcuna azione per le immissioni automatiche. Vengono visualizzate nell'elenco di soppressione del tenant insieme alle voci aggiunte manualmente.
SES aggiunge automaticamente le voci nei seguenti casi:
-
Si verifica un hard bounce se la soppressione del rimbalzo è abilitata per il tenant.
-
Viene ricevuto un reclamo, se la soppressione dei reclami è abilitata per l'inquilino.
SES rimuove automaticamente le voci nei seguenti casi:
-
Viene ricevuta una segnalazione di non spam per un indirizzo che non contiene alcun reclamo.
