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 dell'elenco di eliminazione a livello di account di Amazon SES L'elenco di soppressione a livello di account Amazon SES è stato introdotto in modo che i clienti possano creare e controllare il proprio elenco di soppressioni e gestire la propria reputazione, pertanto l'elenco di soppressioni a livello di account si applica solo al proprio account. L'interfaccia dell'elenco di eliminazione a livello di account nella console SES fornisce un modo semplice per gestire gli indirizzi nell'elenco di eliminazione a livello di account, incluse operazioni per aggiungere o rimuovere indirizzi in blocco. L'*elenco di eliminazione a livello di account* di SES si applica solo al tuo Account AWS nella Regione AWS corrente. Puoi aggiungere o rimuovere, singolarmente o in blocco, indirizzi dall'elenco di eliminazione a livello di account utilizzando l'API SES v2 o la console. **Nota** Per aggiungere o rimuovere in blocco gli indirizzi, è necessario disporre dell'accesso di produzione. Per ulteriori informazioni sulla sandbox, consulta [Richiedi l'accesso alla produzione (uscita dalla sandbox di Amazon SES)](request-production-access.md). **Importante** Gli elenchi di eliminazione degli account SES fanno distinzione tra maiuscole e minuscole. Quando un indirizzo e-mail viene aggiunto all'elenco di soppressione, *User@Example.com*, viene memorizzato esattamente come ricevuto, preservando la maiuscola/minuscola originale. Sebbene la funzionalità di invio e-mail consideri identici gli indirizzi con lettere maiuscole e minuscole, ad esempio *User@Example.com* è uguale a *user@example.com*, le chiamate API per la gestione delle liste di soppressione richiedono una corrispondenza esatta tra maiuscole e minuscole. Pertanto, quando utilizzate la gestione delle APIs liste di soppressione, assicuratevi di utilizzare l'indirizzo e-mail con le maiuscole e minuscole esatte così come appare nell'elenco di soppressione. ## Considerazioni sull'elenco di eliminazione a livello di account di Amazon SES Quando si utilizza l'elenco di eliminazione a livello di account, è necessario considerare i seguenti fattori: + Se hai iniziato a utilizzare Amazon SES dopo il 25 novembre 2019, l'account utilizza l'elenco di eliminazione a livello di account per impostazione predefinita sia per i mancati recapiti che per i reclami. Se hai iniziato a utilizzare SES prima di questa data, è necessario abilitare questa funzionalità tramite l'operazione `PutAccountSuppressionAttributes` nell'API SES. + Se tenti di inviare un messaggio a un indirizzo che si trova nell’elenco di eliminazione a livello di account con un motivo per l’eliminazione che corrisponde allo stesso motivo scelto per le *impostazioni* dell’eliminazione a livello di account , SES accetta il messaggio, ma non lo invia; tuttavia, se n on corrispondono, allora SES lo *invia*. Per chiarire questo punto, vengono forniti i seguenti esempi: + Hai impostato l’eliminazione a livello di account con il motivo di eliminazione di *solo Bounce* e SES non tenterà di recapitare gli indirizzi presenti nell'elenco di eliminazione a livello di account il cui motivo di eliminazione è *Bounce*. Tuttavia, SES *tenterà* di recapitare gli indirizzi presenti nell'elenco di soppressione a livello di account indicando il motivo della soppressione di *Reclamo* (perché in questo caso non corrispondono). + Hai impostato l’eliminazione a livello di account con il motivo di eliminazione di *Bounce e lamentele* e SES non tenterà di recapitare gli indirizzi presenti nell'elenco di eliminazione a livello di account il cui motivo di eliminazione è *Bounce* o *Lamentela*. + *SES non conta nella Reputazione i messaggi inviati agli indirizzi presenti nell'elenco di soppressione a livello di account. *BounceRate*o Reputazione. ComplaintRate*metriche nello spazio dei nomi AWS/SES del tuo account. Tali messaggi vengono conteggiati nelle metriche *Bounce* o *Complaint* nello spazio dei nomi /SES. AWS + Se un indirizzo si trova nell'elenco di eliminazione globale, ma non in quello a livello di account *(il che significa che vuoi spedire a tale indirizzo)* e viene inviata un’email a tale indirizzo, SES proverà a inviarla; tuttavia, se torna indietro, viene comunque conteggiata ai fini della frequenza di mancato recapito del tuo account e della quota di invio giornaliera. + SES conteggia i messaggi inviati agli indirizzi presenti nell'elenco di eliminazione a livello di account ai fini della quota di invio giornaliera. + Gli indirizzi e-mail nell'elenco di eliminazione a livello di account rimangono al suo interno fino a quando non li rimuovi. + Se la capacità del tuo account di inviare e-mail viene sospesa, dopo 90 giorni SES elimina automaticamente gli indirizzi presenti nell'elenco di eliminazione a livello di account. Se la capacità del tuo account di inviare e-mail viene ripristinata prima del termine di questo periodo di 90 giorni, gli indirizzi nell'elenco non vengono eliminati. + Gmail non fornisce dati di reclamo a SES. Se un destinatario utilizza il pulsante **Spam** nel client Web Gmail per segnalare un messaggio ricevuto come spam, non viene aggiunto all'elenco di eliminazione a livello di account. + Puoi abilitare l'elenco di eliminazione a livello di account se l'account si trova nella sandbox SES. Tuttavia, non puoi utilizzare l'[CreateImportJob](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html)operazione [PutSuppressedDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutSuppressedDestination)o finché l'account non viene rimosso dalla sandbox. Per ulteriori informazioni sulla sandbox, consulta [Richiedi l'accesso alla produzione (uscita dalla sandbox di Amazon SES)](request-production-access.md). + Solo i mancati recapiti permanenti vengono aggiunti all'elenco di eliminazione a livello di account. Per ulteriori informazioni sulla differenza tra un'e-mail non recapitata e un mancato recapito permanente, consulta [Dopo l'invio di un e-mail da parte di Amazon SES](send-email-concepts-process.md#send-email-concepts-process-after-send). + Quando utilizzi l'elenco di eliminazione a livello di account, SES aggiunge all'elenco di eliminazione globale anche gli indirizzi che provocano mancati recapiti permanenti. **Nota** Le procedure descritte nelle sezioni seguenti presuppongono che tu abbia già installato il AWS CLI. Per ulteriori informazioni sull'installazione e la configurazione di AWS CLI, consulta la [Guida per l'AWS Command Line Interface utente](https://docs.aws.amazon.com/cli/latest/userguide/). ## Abilitazione dell'elenco di eliminazione a livello di account di Amazon SES Puoi utilizzare l'[PutAccountSuppressionAttributes](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutAccountSuppressionAttributes.html)operazione nell'API Amazon SES v2 per abilitare e configurare l'elenco di soppressione a livello di account. Puoi configurare rapidamente e facilmente questa impostazione utilizzando l' AWS CLI. Per ulteriori informazioni sull'installazione e la configurazione dell' AWS CLI, consulta la [Guida per l'utente di AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/). **Per configurare l'elenco di soppressione a livello di account utilizzando il AWS CLI** + Nella riga di comando, inserisci il comando seguente: ------ #### [ Linux, macOS, or Unix ] ``` aws sesv2 put-account-suppression-attributes \ --suppressed-reasons BOUNCE COMPLAINT ``` ------ #### [ Windows ] ``` aws sesv2 put-account-suppression-attributes ` --suppressed-reasons BOUNCE COMPLAINT ``` ------ Per abilitare l'elenco di eliminazione a livello di account, è necessario specificare almeno un motivo per il parametro `suppressed-reasons`. È possibile specificare `BOUNCE` o `COMPLAINT` oppure entrambi, come mostrato nell'esempio precedente. **Per configurare l'elenco di eliminazione a livello di account tramite la console SES:** 1. Accedi Console di gestione AWS e apri la console Amazon SES all'indirizzo [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. Nel pannello di navigazione, in **Configuration (Configurazione)** scegli **Suppression list (Elenco di eliminazione)**. 1. Nel riquadro **Account-level settings (Impostazioni a livello di account)**, scegli**Edit (Modifica)**. 1. In **Suppression list (Elenco di eliminazione)**, seleziona la casella **Enabled (Abilitato)**. 1. In **Suppression reasons (Motivi eliminazione)**, seleziona uno dei motivi per cui gli indirizzi e-mail del destinatario devono essere aggiunti automaticamente all'elenco di eliminazione a livello di account. 1. Scegli **Save changes** (Salva modifiche). ## Abilitazione dell'elenco di eliminazione a livello di account di Amazon SES per un set di configurazione Puoi anche configurare l'eliminazione a livello di account di Amazon SES in modo che si applichi solo a specifici [set di configurazione](using-configuration-sets.md). In questo caso, gli indirizzi vengono aggiunti all'elenco di eliminazione solo se hai specificato il set di configurazione quando hai inviato l'e-mail che ha causato l'evento di mancato recapito o reclamo. **Per configurare l'elenco di soppressione a livello di account per un set di configurazione utilizzando il AWS CLI** + Nella riga di comando, inserisci il comando seguente: ------ #### [ Linux, macOS, or Unix ] ``` aws sesv2 put-configuration-set-suppression-options \ --configuration-set-name configSet \ --suppressed-reasons BOUNCE COMPLAINT ``` ------ #### [ Windows ] ``` aws sesv2 put-configuration-set-suppression-options ` --configuration-set-name configSet ` --suppressed-reasons BOUNCE COMPLAINT ``` ------ Nell'esempio precedente, sostituiscilo *configSet* con il nome del set di configurazione che dovrebbe utilizzare l'elenco di soppressione a livello di account. **Per configurare l'elenco di eliminazione a livello di account per un set di configurazione tramite la console SES:** 1. Accedi Console di gestione AWS e apri la console Amazon SES all'indirizzo [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. Nel pannello di navigazione, in **Configuration** (Configurazione), scegli **Configuration sets** (Set di configurazione). 1. In **Configuration sets (Set di configurazione)**, scegli il nome del set di configurazione che vuoi configurare con l'eliminazione personalizzata. 1. Nel riquadro **Suppression list options (Opzioni elenco di eliminazione)**, scegli **Edit (Modifica)**. 1. La sezione **Suppression list options (Opzioni elenco di eliminazione)** fornisce un set di decisioni per definire l'eliminazione personalizzata a partire dall'opzione di utilizzare questo set di configurazione per sovrascrivere l'eliminazione a livello di account. La [mappa logica di eliminazione a livello di set di configurazione](sending-email-suppression-list-config-level.md) ti aiuterà a comprendere gli effetti delle combinazioni di sovrascrittura. Queste selezioni su più livelli di sovrascrittura possono essere combinate per implementare tre diversi livelli di eliminazione: 1. **Use account-level suppression (Usa eliminazione a livello di account)**: non sovrascrivere l'eliminazione a livello di account e non implementare alcuna eliminazione a livello di set di configurazione. Fondamentalmente, qualsiasi e-mail inviata utilizzando questo set di configurazione utilizzerà solo l'eliminazione a livello di account. Per farlo: 1. In **Suppression list settings (Impostazioni elenco di eliminazione)**, deseleziona la casella **Override account level settings (Sovrascrivi impostazioni a livello di account)**. 1. **Do not use any suppression (Non usare alcuna eliminazione)**: sovrascrivi l'eliminazione a livello di account senza abilitare l'eliminazione a livello di set di configurazione. Questo significa che qualsiasi e-mail inviata utilizzando questo set di configurazione non utilizzerà alcuna eliminazione a livello di account. In altre parole, tutta l'eliminazione viene annullata. Per farlo: 1. In **Suppression list settings (Impostazioni elenco di eliminazione)**, controlla la casella **Override account level settings (Sovrascrivi impostazioni a livello di account)**. 1. In **Suppression list (Elenco di eliminazione)**, deseleziona la casella **Enabled (Abilitato)**. 1. **Use configuration set-level suppression (Usa eliminazione a livello di set di configurazione)**: sostituisci l'eliminazione a livello di account con impostazioni personalizzate dell'elenco di eliminazione definite in questo set di configurazione. Questo significa che qualsiasi e-mail inviata utilizzando questo set di configurazione utilizzerà solo le proprie impostazioni di eliminazione e ignorerà le impostazioni di eliminazione a livello di account. Per farlo: 1. In **Suppression list settings (Impostazioni elenco di eliminazione)**, controlla la casella **Override account level settings (Sovrascrivi impostazioni a livello di account)**. 1. In **Suppression list (Elenco di eliminazione)**, seleziona **Enabled (Abilitato)**. 1. In **Specify the reason(s)… (Specificare i motivi…)**, seleziona uno dei motivi dell'eliminazione da utilizzare per questo set di configurazione. 1. Scegli **Save changes** (Salva modifiche). ## Aggiunta di singoli indirizzi e-mail all'elenco di eliminazione a livello di account di Amazon SES Puoi aggiungere singoli indirizzi all'elenco di soppressione a livello di account Amazon SES utilizzando l'[PutSuppressedDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutSuppressedDestination.html)operazione nell'API SES v2. Non è previsto alcun limite al numero di indirizzi che è possibile aggiungere all'elenco di eliminazione a livello di account. **Per aggiungere singoli indirizzi all'elenco di soppressione a livello di account, utilizza 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 ``` ------ #### [ Windows ] ``` aws sesv2 put-suppressed-destination ` --email-address recipient@example.com ` --reason BOUNCE ``` ------ Nell'esempio precedente, sostituiscilo *recipient@example.com* con l'indirizzo e-mail che desideri aggiungere all'elenco di soppressione a livello di account e *BOUNCE* con il motivo per cui stai aggiungendo l'indirizzo all'elenco di soppressione (i valori accettabili sono e). `BOUNCE` `COMPLAINT` **Aggiunta di singoli indirizzi all'elenco di eliminazione a livello di account tramite la console SES:** 1. Accedi Console di gestione AWS e apri la console Amazon SES all'indirizzo [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. Nel pannello di navigazione, in **Configuration (Configurazione)** scegli **Suppression list (Elenco di eliminazione)**. 1. Nel riquadro **Suppression list (Elenco di eliminazione)**, scegli **Add email address (Aggiungi indirizzo e-mail)**. 1. Inserisci un indirizzo e-mail in **Email address** (Indirizzo e-mail) e seleziona un motivo in **Suppression reason** (Motivo eliminazione). Per aggiungere altri indirizzi, scegli **Enter another address** (Aggiungi un altro indirizzo) e ripeti l'operazione per ogni indirizzo aggiuntivo. 1. Al termine dell'inserimento degli indirizzi, controlla che tutte le voci siano corrette. Se decidi che una delle voci non dovrebbe far parte di questo invio, seleziona il rispettivo pulsante **Remove** (Rimuovi). 1. Scegli **Save changes** (Salva modifiche) per aggiungere gli indirizzi e-mail inseriti all'elenco di eliminazione a livello di account. ## Aggiunta di indirizzi e-mail in blocco all'elenco di eliminazione a livello di account di Amazon SES Puoi aggiungere indirizzi in blocco caricando prima l'elenco dei contatti in un oggetto Amazon S3, quindi utilizzando [CreateImportJob](#CIJ-add-bulk-API)l'operazione nell'API Amazon SES v2. **Nota** Non è previsto alcun limite al numero di indirizzi che è possibile aggiungere all'elenco di eliminazione a livello di account, ma è previsto un limite di aggiunta in blocco di 100.000 indirizzi in un oggetto Simple Storage Service (Amazon S3) per ogni chiamata API. Non puoi eseguire più di 20 processi di importazione simultanei. Se l'origine dati è un bucket S3, deve esistere nella stessa regione in cui viene importato. Per aggiungere indirizzi e-mail in blocco all'elenco di eliminazione a livello di account, completare la seguente procedura. + Carica il tuo elenco di indirizzi in un oggetto Amazon S3 in formato CSV o JSON. Esempio di formato CSV per l'aggiunta di indirizzi: `recipient1@example.com,BOUNCE` `recipient2@example.com,COMPLAINT` Sono supportati solo i file JSON delimitati da nuova riga. In questo formato, ogni riga è un oggetto JSON completo che contiene una singola definizione di indirizzo. Esempio di formato JSON per l'aggiunta di indirizzi: `{"emailAddress":"recipient1@example.com","reason":"BOUNCE"}` `{"emailAddress":"recipient2@example.com","reason":"COMPLAINT"}` Negli esempi precedenti, sostituisci *recipient1@example.com* e *recipient2@example.com* con gli indirizzi e-mail che desideri aggiungere all'elenco di soppressione a livello di account. I motivi accettabili per cui aggiungere gli indirizzi all'elenco di soppressione sono `BOUNCE` e `COMPLAINT`. + Concedi a SES l'autorizzazione a utilizzare la chiave AWS KMS . Se l'oggetto Amazon S3 è crittografato con una AWS KMS chiave, devi autorizzare Amazon SES a utilizzare la AWS KMS chiave. SES può ottenere l'autorizzazione solo da una chiave gestita dal cliente, non da una chiave KMS di default. Devi concedere a SES l'autorizzazione a utilizzare la chiave gestita dal cliente aggiungendo un'istruzione alla policy della chiave. Incolla la seguente istruzione nella policy della chiave per consentire a SES di utilizzare la tua chiave gestita dal cliente. ``` { "Sid": "AllowSESToDecrypt", "Effect": "Allow", "Principal": { "Service":"ses.amazonaws.com" }, "Action": [ "kms:Decrypt", ], "Resource": "*" } ``` + Utilizza l'[CreateImportJob](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html)operazione nell'API SES v2. **Nota** L'esempio seguente presuppone che sia già installata l' AWS CLI. Per ulteriori informazioni sull'installazione e la configurazione di AWS CLI, consulta la Guida per l'[AWS Command Line Interface utente](https://docs.aws.amazon.com/cli/latest/userguide/). Nella riga di comando, immetti il comando seguente: Sostituisci *s3bucket* con il nome di un bucket Amazon S3 e *s3object* con il nome di un oggetto Amazon S3. ``` aws sesv2 create-import-job --import-destination SuppressionListDestination={SuppressionListImportAction=PUT} --import-data-source S3Url=s3://s3bucket/s3object,DataFormat=CSV ``` **Per aggiungere indirizzi e-mail in blocco all'elenco di eliminazione a livello di account tramite la console SES:** 1. Accedi Console di gestione AWS e apri la console Amazon SES all'indirizzo [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. Nel pannello di navigazione, in **Configuration (Configurazione)** scegli **Suppression list (Elenco di eliminazione)**. 1. Nella tabella **Suppression list (Elenco di eliminazione)**, espandi il pulsante **Bulk actions (Operazioni in blocco)** e seleziona **Add email addresses in bulk (Aggiungi indirizzi e-mail in blocco)**. 1. In **Bulk action specifications (Specifiche operazione in blocco)**, seleziona (a)**Choose file from S3 bucket (Scegli file dal bucket S3)** o (b)**Import from file (Importa da file)**. Sono previste procedure per ciascun metodo di importazione: 1. **Choose file from S3 bucket (Scegli file dal bucket S3)**: *se il file di origine è già archiviato in un bucket Amazon S3*: 1. Se conosci l'URI del bucket Amazon S3 che vuoi utilizzare, inseriscilo nel campo **Amazon S3 URI (URI Amazon S3)**; in caso contrario, scegli **Browse S3 (Sfoglia S3)**: 1. In **Buckets (Bucket)**, seleziona il nome del bucket S3. 1. In **Objects (Oggetti)**, seleziona il nome del file, quindi seleziona **Choose (Scegli)**: verrà riaperta la schermata **Bulk action specifications (Specifiche operazione in blocco)**. 1. (Facoltativo) Se vuoi tornare alla console Amazon S3 per visualizzare i dettagli sul tuo oggetto S3, scegli **View (Visualizza)**. 1. In **File format (Formato file)**, seleziona il formato del file che hai scelto di importare dal tuo bucket Amazon S3. 1. Scegli **Add email addresses (Aggiungi indirizzi e-mail)** per avviare l'importazione di indirizzi dal tuo file: viene visualizzata una tabella sotto la scheda **Bulk actions (Operazioni in blocco)**. 1. **Import from file (Importa da file)**: *se disponi di un file di origine locale da caricare su un bucket Amazon S3 nuovo o esistente*: 1. In **Import source file (Importa file di origine)**, seleziona **Choose file (Scegli file)**. 1. Seleziona il file JSON o CSV nel browser dei file e scegli **Open (Apri)**: vedrai il nome, la dimensione e la data del tuo file sotto il pulsante **Choose file (Scegli file)**. 1. Espandi **Amazon S3 bucket (Bucket Amazon S3)** e seleziona il bucket S3. 1. Per caricare il file in un nuovo bucket, scegli **Create S3 bucket (Crea bucket S3)**, inserisci un nome nel campo **Bucket name (Nome bucket)** e scegli **Create bucket (Crea bucket)**. 1. Scegli **Add email addresses (Aggiungi indirizzi e-mail)** per avviare l'importazione di indirizzi dal tuo file: viene visualizzata una tabella nella scheda **Bulk actions (Operazioni in blocco)**. 1. Indipendentemente dal metodo di importazione utilizzato, il tuo ID processo sarà elencato in **Bulk actions (Operazioni in blocco)** insieme al tipo di importazione, allo stato e alla data: per visualizzare i dettagli del processo, seleziona l'ID processo. 1. Seleziona la scheda **Suppression list (Elenco di eliminazione)** e tutti gli indirizzi e-mail importati correttamente verranno visualizzati con il relativo motivo dell'eliminazione e la data aggiunti; sono disponibili le seguenti opzioni: 1. Seleziona un indirizzo e-mail o seleziona la casella di controllo corrispondente e scegli **View report (Visualizza report)** per visualizzarne i dettagli. Se si tratta di un indirizzo aggiunto automaticamente al tuo elenco di eliminazione a causa di un mancato recapito o di un reclamo, verranno visualizzate informazioni sull'evento di feedback che ne ha causato l'aggiunta, inclusi i dettagli sul messaggio e-mail che ha prodotto l'evento di attivazione. 1. Seleziona la casella di controllo corrispondente di uno o più indirizzi e-mail che desideri rimuovere dall'elenco di eliminazione dell'account e scegli **Remove (Rimuovi)**. ## Visualizzazione di un elenco di indirizzi presenti nell'elenco di eliminazione a livello di account di Amazon SES Puoi visualizzare un elenco di tutti gli indirizzi e-mail presenti nell'elenco di soppressione a livello di account per il tuo account utilizzando l'[ListSuppressedDestinations](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListSuppressedDestinations.html)operazione nell'API SES v2. **Visualizzazione di un elenco di tutti gli indirizzi e-mail presenti nell'elenco di eliminazione a livello di account** + Nella riga di comando, inserisci il comando seguente: ``` aws sesv2 list-suppressed-destinations ``` Il comando precedente restituisce tutti gli indirizzi e-mail presenti nell'elenco di eliminazione a livello di account per l'account in questione. L'output è simile a quello riportato di seguito. ``` { "SuppressedDestinationSummaries": [ { "EmailAddress": "recipient2@example.com", "Reason": "COMPLAINT", "LastUpdateTime": "2020-04-10T21:03:05Z" }, { "EmailAddress": "recipient0@example.com", "Reason": "COMPLAINT", "LastUpdateTime": "2020-04-10T21:04:26Z" }, { "EmailAddress": "recipient1@example.com", "Reason": "BOUNCE", "LastUpdateTime": "2020-04-10T22:07:59Z" } ] } ``` + **Nota**: se l'output include un campo "NextToken" con un valore di stringa, significa che ci sono altri indirizzi e-mail nell'elenco di soppressione del tuo account. Per visualizzare questi ulteriori indirizzi eliminati, invia un'altra richiesta a `ListSuppressedDestinations` e passa il valore della stringa restituito nel parametro `--next-token` in questo modo: ``` aws sesv2 list-suppressed-destinations --next-token string ``` Nel comando precedente, sostituisci *string* con il valore restituito NextToken . Per ulteriori informazioni, consulta [How to list over 1000 email addresses from account-level suppression list](https://aws.amazon.com/blogs/messaging-and-targeting/how-to-list-over-1000-email-addresses-from-account-level-suppression-list/). È possibile utilizzare l'opzione `StartDate` per visualizzare solo gli indirizzi e-mail aggiunti all'elenco *dopo* una determinata data. **Visualizzazione di un elenco di indirizzi aggiunti all'elenco di eliminazione a livello di account dopo una data specifica** + Nella riga di comando, inserisci il comando seguente: ``` aws sesv2 list-suppressed-destinations --start-date 1604394130 ``` Nel comando precedente, sostituite *1604394130* con il timestamp Unix della data di inizio. È inoltre possibile utilizzare l'opzione `EndDate` per visualizzare solo gli indirizzi e-mail aggiunti all'elenco *prima* di una determinata data. **Visualizzazione di un elenco di indirizzi aggiunti all'elenco di eliminazione a livello di account prima di una data specifica** + Nella riga di comando, inserisci il comando seguente: ``` aws sesv2 list-suppressed-destinations --end-date 1611126000 ``` Nel comando precedente, sostituite *1611126000* con il timestamp Unix della data di fine. Nella riga di comando Linux, macOS o Unix, è anche possibile utilizzare l'utility `grep` integrata per cercare indirizzi o domini specifici. **Ricerca di un indirizzo specifico nell'elenco di eliminazione a livello di account** + Nella riga di comando, inserisci il comando seguente: ``` aws sesv2 list-suppressed-destinations | grep -A2 'example.com' ``` Nel comando precedente, sostituite *example.com* con la stringa di testo (ad esempio l'indirizzo o il dominio) che desiderate cercare. **Visualizzazione di un elenco di tutti gli indirizzi e-mail presenti nell'elenco di eliminazione a livello di account tramite la console SES:** 1. Accedi Console di gestione AWS e apri la console Amazon SES all'indirizzo [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. Nel pannello di navigazione, in **Configuration (Configurazione)** scegli **Suppression list (Elenco di eliminazione)**. 1. Nel riquadro **Suppression list (Elenco di eliminazione)**, tutti gli indirizzi e-mail nell'elenco di eliminazione a livello di account vengono visualizzati con il relativo motivo dell'eliminazione e la data aggiunti; sono disponibili le seguenti opzioni: 1. Seleziona un indirizzo e-mail o seleziona la casella di controllo corrispondente e scegli **View report (Visualizza report)** per visualizzarne i dettagli. Se si tratta di un indirizzo aggiunto automaticamente al tuo elenco di eliminazione a causa di un mancato recapito o di un reclamo, verranno visualizzate informazioni sull'evento di feedback che ne ha causato l'aggiunta, inclusi i dettagli sul messaggio e-mail che ha prodotto l'evento di attivazione. 1. Puoi personalizzare la tabella dell'elenco di eliminazione scegliendo l'icona a forma di ingranaggio: verrà visualizzata una finestra modale in cui puoi personalizzare le dimensioni della pagina, il ritorno a capo e le colonne da visualizzare. Dopo aver effettuato le selezioni, scegli **Confirm (Conferma)**. La tabella dell'elenco di eliminazione rifletterà le tue scelte di visualizzazione. ## Rimozione di singoli indirizzi e-mail dall'elenco di eliminazione a livello di account di Amazon SES Se un indirizzo è nell'elenco di soppressione del tuo account, ma sai che l'indirizzo non dovrebbe essere nell'elenco, puoi rimuoverlo utilizzando l'[DeleteSuppressedDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_DeleteSuppressedDestination.html)operazione nell'API SES v2. **Per rimuovere singoli indirizzi dall'elenco di soppressione a livello di account 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 ``` ------ #### [ Windows ] ``` aws sesv2 delete-suppressed-destination ` --email-address recipient@example.com ``` ------ Nell'esempio precedente, sostituiscilo *recipient@example.com* con l'indirizzo e-mail che desideri rimuovere dall'elenco di soppressione a livello di account. **Rimozione di singoli indirizzi dall'elenco di eliminazione a livello di account tramite la console SES:** 1. Accedi Console di gestione AWS e apri la console Amazon SES all'indirizzo [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. Nel pannello di navigazione, in **Configuration (Configurazione)** scegli **Suppression list (Elenco di eliminazione)**. 1. Rimuovi i singoli indirizzi e-mail tramite *(a)* la selezione dalla tabella o *(b)* l'inserimento mediante digitazione: 1. *Selezione dalla tabella*: nella tabella **Suppression list** (Elenco di eliminazione), seleziona la casella di controllo corrispondente a uno o più indirizzi e-mail e scegli **Remove** (Rimuovi). 1. *Inserimento mediante digitazione*: 1. Nella tabella **Suppression list** (Elenco di eliminazione), scegli **Remove email address** (Rimuovi indirizzo e-mail). 1. Inserisci un indirizzo e-mail in **Email address**. Per aggiungere altri indirizzi, scegli **Enter another address** (Inserisci un altro indirizzo) e ripeti l'operazione per ogni indirizzo aggiuntivo. 1. Al termine dell'inserimento degli indirizzi, controlla che tutte le voci siano corrette. Se decidi che una delle voci non dovrebbe far parte di questo invio, seleziona il rispettivo pulsante **Remove** (Rimuovi). 1. Scegli **Save changes** (Salva modifiche) per rimuovere gli indirizzi e-mail specificati dall'elenco di eliminazione a livello di account. ## Rimozione di indirizzi e-mail in blocco dall'elenco di eliminazione a livello di account di Amazon SES Puoi rimuovere gli indirizzi in blocco caricando prima l'elenco dei contatti in un oggetto Amazon S3, quindi utilizzando [CreateImportJob](#CIJ-remove-bulk-API)l'operazione nell'API SES v2. **Nota** Non è previsto alcun limite al numero di indirizzi che è possibile rimuovere dall'elenco di eliminazione a livello di account, ma è previsto un limite di eliminazione in blocco di 10.000 indirizzi in un oggetto Amazon S3 per ogni chiamata API. Se l'origine dati è un bucket S3, deve esistere nella stessa regione in cui viene importato. Per rimuovere indirizzi e-mail in blocco dall'elenco di eliminazione a livello di account, completare la seguente procedura. + Carica il tuo elenco di indirizzi in un oggetto Amazon S3 in formato CSV o JSON. Esempio di formato CSV per la rimozione degli indirizzi: `recipient3@example.com` Sono supportati solo i file JSON delimitati da nuova riga. In questo formato, ogni riga è un oggetto JSON completo che contiene una singola definizione di indirizzo. Esempio di formato JSON per l'aggiunta di indirizzi: `{"emailAddress":"recipient3@example.com"}` Negli esempi precedenti, sostituiscili *recipient3@example.com* con gli indirizzi e-mail che desideri rimuovere dall'elenco di soppressione a livello di account. + Concedi a SES l'autorizzazione a leggere l'oggetto Amazon S3. Se applicata a un bucket Amazon S3, la seguente policy concede a SES l'autorizzazione a leggere tale bucket. Per maggiori informazioni sulle policy dei bucket per Amazon S3, consulta [Utilizzo delle policy dei bucket e dell'utente](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-iam-policies.html) nella *Guida per l'utente di Amazon Simple Storage Service*. + Concedi a SES il permesso di usare la tua chiave. AWS KMS Se l'oggetto Amazon S3 è crittografato con una AWS KMS chiave, devi autorizzare Amazon SES a utilizzare la AWS KMS chiave. SES può ottenere l'autorizzazione solo da una chiave gestita dal cliente, non da una chiave KMS di default. Devi concedere a SES l'autorizzazione a utilizzare la chiave gestita dal cliente aggiungendo un'istruzione alla policy della chiave. Incolla la seguente istruzione nella policy della chiave per consentire a SES di utilizzare la tua chiave gestita dal cliente. ``` { "Sid": "AllowSESToDecrypt", "Effect": "Allow", "Principal": { "Service":"ses.amazonaws.com" }, "Action": [ "kms:Decrypt", ], "Resource": "*" } ``` + Utilizza l'[CreateImportJob](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html)operazione nell'API SES v2. **Nota** L'esempio seguente presuppone che sia già installata l' AWS CLI. Per ulteriori informazioni sull'installazione e la configurazione di AWS CLI, consulta la Guida per l'[AWS Command Line Interface utente](https://docs.aws.amazon.com/cli/latest/userguide/). Nella riga di comando, immetti il comando seguente: Sostituisci *s3bucket* con il nome del bucket Amazon S3 e *s3object* con il nome dell'oggetto Amazon S3. ``` aws sesv2 create-import-job --import-destination SuppressionListDestination={SuppressionListImportAction=DELETE} --import-data-source S3Url="s3://s3bucket/s3object",DataFormat=CSV ``` **Per rimuovere indirizzi e-mail in blocco dall'elenco di eliminazione a livello di account tramite la console SES:** 1. Accedi Console di gestione AWS e apri la console Amazon SES all'indirizzo [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. Nel pannello di navigazione, in **Configuration (Configurazione)** scegli **Suppression list (Elenco di eliminazione)**. 1. Nella tabella **Suppression list (Elenco di eliminazione)**, espandi il pulsante **Bulk actions (Operazioni in blocco)** e seleziona **Remove email addresses in bulk (Rimuovi indirizzi e-mail in blocco)**. 1. In **Bulk action specifications** (Specifiche operazione in blocco), seleziona (a) **Choose file from S3 bucket** (Scegli file dal bucket S3) o (b) **Import from file** (Importa da file). Sono previste procedure diverse per ciascun metodo di importazione: 1. **Choose file from S3 bucket (Scegli file dal bucket S3)**: *se il file di origine è già archiviato in un bucket Amazon S3*: 1. Se conosci l'URI del bucket Amazon S3 che vuoi utilizzare, inseriscilo nel campo **Amazon S3 URI (URI Amazon S3)**; in caso contrario, scegli **Browse S3 (Sfoglia S3)**: 1. In **Buckets (Bucket)**, seleziona il nome del bucket S3. 1. In **Objects (Oggetti)**, seleziona il nome del file, quindi seleziona **Choose (Scegli)**: verrà riaperta la schermata **Bulk action specifications (Specifiche operazione in blocco)**. 1. (Facoltativo) Se vuoi tornare alla console Amazon S3 per visualizzare i dettagli sul tuo oggetto S3, scegli **View (Visualizza)**. 1. In **File format (Formato file)**, seleziona il formato del file che hai scelto di importare dal bucket Amazon S3. 1. Scegli **Remove email addresses (Rimuovi indirizzi e-mail)** per avviare l'importazione di indirizzi dal tuo file: viene visualizzata una tabella nella scheda **Bulk actions (Operazioni in blocco)**. 1. **Import from file (Importa da file)**: *se disponi di un file di origine locale da caricare su un bucket Amazon S3 nuovo o esistente*: 1. In **Import source file (Importa file di origine)**, seleziona **Choose file (Scegli file)**. 1. Seleziona il file JSON o CSV nel browser dei file e scegli **Open (Apri)**: vedrai il nome, la dimensione e la data del tuo file sotto il pulsante **Choose file (Scegli file)**. 1. Espandi **Amazon S3 bucket (Bucket Amazon S3)** e seleziona il bucket S3. 1. Per caricare il file in un nuovo bucket, scegli **Create S3 bucket (Crea bucket S3)**, inserisci un nome nel campo **Bucket name (Nome bucket)** e scegli **Create bucket (Crea bucket)**. 1. Scegli **Remove email addresses (Rimuovi indirizzi e-mail)** per avviare l'importazione di indirizzi dal tuo file: viene visualizzata una tabella nella scheda **Bulk actions (Operazioni in blocco)**. 1. Indipendentemente dal metodo di importazione utilizzato, il tuo ID processo sarà elencato in **Bulk actions (Operazioni in blocco)** insieme al tipo di importazione, allo stato e alla data: per visualizzare i dettagli del processo, seleziona l'ID processo. 1. Seleziona la scheda **Suppression list (Elenco di eliminazione)** e tutti gli indirizzi e-mail importati correttamente rimossi dall'elenco di eliminazione non verranno più visualizzati. ## Visualizzazione di un elenco di processi di importazione per l'account Puoi visualizzare un elenco di tutti gli indirizzi e-mail presenti nell'elenco di soppressione a livello di account per il tuo account utilizzando l'[ListImportJobs](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListImportJobs.html)operazione nell'API Amazon SES v2. **Visualizzazione di un elenco di tutti i processi di importazione per l'account** + Nella riga di comando, inserisci il comando seguente: ``` aws sesv2 list-import-jobs ``` Il comando precedente restituisce tutti i processi di importazione per l'account. L'output è simile a quello riportato di seguito. ``` { "ImportJobs": [ { "CreatedTimestamp": 2020-07-31T06:06:55Z", "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "PUT" } }, "JobStatus": "COMPLETED", "JobId": "755380d7-fbdb-4ed2-a9a3-06866220f5b5" }, { "CreatedTimestamp": "2020-07-30T18:45:32Z", "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "DELETE" } }, "JobStatus": "COMPLETED", "JobId": "076683bd-a7ee-4a40-9754-4ad1161ba8b6" }, { "CreatedTimestamp": "2020-08-05T16:45:18Z", "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "PUT" } }, "JobStatus": "COMPLETED", "JobId": "6e261869-bd30-4b33-b1f2-9e035a83a395" } ] } ``` **Per visualizzare un elenco di tutti i processi di importazione per l'account tramite la console SES:** 1. Accedi Console di gestione AWS e apri la console Amazon SES all'indirizzo [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. Nel pannello di navigazione, in **Configuration (Configurazione)** scegli **Suppression list (Elenco di eliminazione)**. 1. Nel riquadro **Suppression list (Elenco di eliminazione)**, seleziona la scheda **Bulk actions (Operazioni in blocco)**. 1. Tutti i processi di importazione saranno elencati nella tabella **Bulk actions (Operazioni in blocco)** insieme al tipo di importazione, allo stato e alla data. 1. Per visualizzare i dettagli del processo, seleziona l'ID processo e verranno visualizzati i riquadri seguenti: 1. **Bulk action status (Stato operazione in blocco)**: mostra lo stato generale dei processi, l'ora e la data di completamento, il numero di record importati e il numero di record che non sono stati importati correttamente. 1. **Bulk action details (Dettagli operazione in blocco)**: mostra l'ID processo, indipendentemente dal fatto che sia stato utilizzato per aggiungere o rimuovere indirizzi, se il formato di file era JSON o CSV, l'URI del bucket Amazon S3 in cui è stato archiviato il file in blocco e l'ora e la data di creazione dell'operazione in blocco. ## Recupero di informazioni di un processo di importazione per l'account Puoi ottenere informazioni su un processo di importazione per l'account utilizzando l'[GetImportJob](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetImportJob.html)operazione nell'API Amazon SES v2. **Recupero di informazioni su un processo di importazione per l'account** + Nella riga di comando, inserisci il comando seguente: ``` aws sesv2 get-import-job --job-id JobId ``` Il comando precedente restituisce informazioni su un processo di importazione per l'account. L'output è simile a quello riportato di seguito. ``` { "ImportDataSource": { "S3Url": "s3://bucket/object", "DataFormat": "CSV" }, "ProcessedRecordsCount": 2, "FailureInfo": { "FailedRecordsS3Url": "s3presignedurl" }, "JobStatus": "COMPLETED", "JobId": "jobid", "CreatedTimestamp": "2020-08-12T17:05:15Z", "FailedRecordsCount": 1, "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "PUT" } }, "CompletedTimestamp": "2020-08-12T17:06:42Z" } ``` **Per ottenere informazioni su un processo di importazione per l'account tramite la console SES:** 1. Accedi Console di gestione AWS e apri la console Amazon SES all'indirizzo [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. Nel pannello di navigazione, in **Configuration (Configurazione)** scegli **Suppression list (Elenco di eliminazione)**. 1. Nel riquadro **Suppression list (Elenco di eliminazione)**, seleziona la scheda **Bulk actions (Operazioni in blocco)**. 1. Tutti i processi di importazione saranno elencati nella tabella **Bulk actions (Operazioni in blocco)** insieme al tipo di importazione, allo stato e alla data. 1. Per visualizzare i dettagli del processo, seleziona l'ID processo e verranno visualizzati i riquadri seguenti: 1. **Bulk action status (Stato operazione in blocco)**: mostra lo stato generale dei processi, l'ora e la data di completamento, il numero di record importati e il numero di record che non sono stati importati correttamente. 1. **Bulk action details (Dettagli operazione in blocco)**: mostra l'ID processo, indipendentemente dal fatto che sia stato utilizzato per aggiungere o rimuovere indirizzi, se il formato di file era JSON o CSV, l'URI del bucket Amazon S3 in cui è stato archiviato il file in blocco e l'ora e la data di creazione dell'operazione in blocco. ## Disabilitazione dell'elenco di eliminazione a livello di account di Amazon SES Puoi utilizzare l'[PutAccountSuppressionAttributes](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutAccountSuppressionAttributes.html)operazione nell'API SES v2 per disabilitare efficacemente l'elenco di soppressione a livello di account rimuovendo i valori dall'attributo. `suppressed-reasons` **Per disabilitare l'elenco di soppressione a livello di account, utilizzare il AWS CLI** + Nella riga di comando, inserisci il comando seguente: ``` aws sesv2 put-account-suppression-attributes --suppressed-reasons ``` **Disabilitazione dell'elenco di eliminazione a livello di account tramite la console SES:** 1. Accedi Console di gestione AWS e apri la console Amazon SES all'indirizzo [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. Nel pannello di navigazione, in **Configuration (Configurazione)** scegli **Suppression list (Elenco di eliminazione)**. 1. Nel riquadro **Account-level settings (Impostazioni a livello di account)**, scegli**Edit (Modifica)**. 1. In **Suppression list (Elenco di eliminazione)**, deseleziona la casella **Enabled (Abilitato)**. 1. Scegli **Save changes (Salva modifiche)**.