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](sending-email-suppression-list-tenant-level-configure.md). + 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](https://docs.aws.amazon.com/cli/latest/userguide/). + 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: ------ #### [ Linux, macOS, or Unix ] ``` aws sesv2 put-suppressed-destination \ --email-address {{recipient@example.com}} \ --reason {{BOUNCE}} \ --tenant-name {{MyTenant}} ``` ------ #### [ Windows ] ``` aws sesv2 put-suppressed-destination ` --email-address {{recipient@example.com}} ` --reason {{BOUNCE}} ` --tenant-name {{MyTenant}} ``` ------ Nell'esempio precedente, sostituiscilo {{recipient@example.com}} con l'indirizzo e-mail da aggiungere, {{BOUNCE}} con il motivo della soppressione (i valori accettabili sono `BOUNCE` e`COMPLAINT`) e {{MyTenant}} con 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: ------ #### [ Linux, macOS, or Unix ] ``` aws sesv2 get-suppressed-destination \ --email-address {{recipient@example.com}} \ --tenant-name {{MyTenant}} ``` ------ #### [ Windows ] ``` aws sesv2 get-suppressed-destination ` --email-address {{recipient@example.com}} ` --tenant-name {{MyTenant}} ``` ------ Nell'esempio precedente, sostituiscilo {{recipient@example.com}} con l'indirizzo e-mail da controllare e {{MyTenant}} con 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 (`BOUNCE`o`COMPLAINT`). + `LastUpdateTime`— Quando la voce è stata aggiornata l'ultima volta. + `Attributes`— Contiene `MessageId` e `FeedbackId` derivante 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: ------ #### [ Linux, macOS, or Unix ] ``` aws sesv2 delete-suppressed-destination \ --email-address {{recipient@example.com}} \ --tenant-name {{MyTenant}} ``` ------ #### [ Windows ] ``` aws sesv2 delete-suppressed-destination ` --email-address {{recipient@example.com}} ` --tenant-name {{MyTenant}} ``` ------ Nell'esempio precedente, sostituiscilo {{recipient@example.com}} con l'indirizzo e-mail da rimuovere e {{MyTenant}} con 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: ------ #### [ Linux, macOS, or Unix ] ``` aws sesv2 list-suppressed-destinations \ --tenant-name {{MyTenant}} ``` ------ #### [ Windows ] ``` aws sesv2 list-suppressed-destinations ` --tenant-name {{MyTenant}} ``` ------ Nell'esempio precedente, sostituiscilo {{MyTenant}} con 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: ------ #### [ Linux, macOS, or Unix ] ``` aws sesv2 list-suppressed-destinations \ --tenant-name {{MyTenant}} \ --reasons BOUNCE COMPLAINT ``` ------ #### [ Windows ] ``` aws sesv2 list-suppressed-destinations ` --tenant-name {{MyTenant}} ` --reasons BOUNCE COMPLAINT ``` ------ Il comando seguente filtra per intervallo di date: ------ #### [ Linux, macOS, or Unix ] ``` aws sesv2 list-suppressed-destinations \ --tenant-name {{MyTenant}} \ --start-date {{2026-01-01T00:00:00Z}} \ --end-date {{2026-03-31T23:59:59Z}} ``` ------ #### [ Windows ] ``` aws sesv2 list-suppressed-destinations ` --tenant-name {{MyTenant}} ` --start-date {{2026-01-01T00:00:00Z}} ` --end-date {{2026-03-31T23:59:59Z}} ``` ------ 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 completi`Attributes`, 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.