Errori di invio di e-mail con Amazon SES

In questo argomento vengono esaminati i tipi di errori specifici dell'invio di e-mail che potrebbero verificarsi quando si invia un'e-mail tramite Amazon SES. Se provi a inviare un'e-mail tramite Amazon SES e la chiamata ad Amazon SES non riesce, Amazon SES restituisce un messaggio di errore all'applicazione e non invia l'e-mail. Questo messaggio di errore varia in base al modo in cui si chiama Amazon SES.

• Se effettui una chiamata diretta all'API Amazon SES, l'operazione di query restituisce un errore. L'errore potrebbe essere MessageRejected o uno degli errori specificati nell'argomento Errori comuni della Documentazione di riferimento per le API di Amazon Simple Email Service.

• Se chiami Amazon SES utilizzando un SDK AWS che usa un linguaggio di programmazione che supporta le eccezioni, Amazon SES potrebbe generare un'eccezione. Il tipo di eccezione dipende dall'SDK e dall'errore. Ad esempio potrebbe essere un'eccezione MessageRejectedException di Amazon SES (il nome effettivo può variare in base all'SDK) o un'eccezione AWS generica. Indipendentemente dal tipo di eccezione, il tipo di errore e il messaggio di errore nell'eccezione forniscono ulteriori informazioni.

• Se chiami Amazon SES tramite l'interfaccia SMTP, il modo in cui si verifica l'errore dipende dall'applicazione. In alcune applicazioni potrebbe essere visualizzato un messaggio di errore specifico, mentre in altre no. Per l'elenco dei codici di risposta SMTP restituiti da Amazon SES, consulta Codici di risposta SMTP restituiti da Amazon SES.

Nota

Quando la chiamata ad Amazon SES per l'invio di un'e-mail non riesce, l'e-mail non viene fatturata.

Di seguito sono elencati i tipi di problemi specifici di Amazon SES che possono comportare la restituzione di un errore da parte di Amazon SES quando provi a inviare un'e-mail. Questi errori si aggiungono agli errori generici di AWS come MalformedQueryString, come specificato nell'argomento Errori comuni della Documentazione di riferimento per le API di Amazon Simple Email Service.

• Email address is not verified. The following identities failed the check in region region: identity1, identity2, identity3 (Le seguenti identità non hanno superato il controllo nella Regione <Regione>: <identità1>, <identità2>, <identità3>): stai provando a inviare l'e-mail da un indirizzo e-mail o un dominio che non hai verificato con Amazon SES. Questo errore potrebbe riguardare l'indirizzo "From" (Da), "Source" (Origine), "Sender" (Mittente) o "Return-Path" (Percorso di ritorno). Se il tuo account si trova ancora nella sandbox Amazon SES, devi verificare anche gli indirizzi e-mail di tutti i destinatari, ad eccezione dei destinatari forniti dal simulatore di mailbox Amazon SES. Se Amazon SES non è in grado di visualizzare tutte le identità che hanno determinato l'errore, il messaggio di errore termina con i puntini di sospensione.

  Nota

  Amazon SES dispone di endpoint in più Regioni AWS e lo stato della verifica degli indirizzi e-mail è separato per ciascuna Regione AWS. È necessario completare la procedura di verifica per ogni mittente nelle Regioni AWS che desideri utilizzare.

• Account is paused (Account sospeso): abbiamo sospeso la capacità del tuo account di inviare e-mail. È comunque possibile accedere alla console Amazon SES ed eseguire la maggior parte delle operazioni. Tuttavia, se tenti di inviare un'e-mail, riceverai questo messaggio.

  In caso di sospensione della capacità di inviare e-mail da parte del tuo account, inviamo automaticamente una notifica all'indirizzo e-mail associato al tuo Account AWS. Per ulteriori informazioni, consulta . Domande frequenti sul processo di verifica dell'invio di Amazon SES.

• Throttling (Limitazione): è possibile che l'applicazione stia provando a inviare un numero eccessivo di messaggi al secondo o che nelle ultime 24 ore sia stato inviato un numero eccessivo di e-mail. In questi casi, il messaggio di errore potrebbe somigliare agli esempi seguenti:

  • Daily message quota exceeded (Quota giornaliera messaggi superata): hai inviato il numero massimo di messaggi consentiti in un periodo di 24 ore. Se hai superato la quota giornaliera, dovrai attendere il successivo periodo di 24 ore prima di poter inviare altre e-mail.

  • Maximum sending rate exceeded (Frequenza massima in uscita superata): stai provando a inviare un numero maggiore di e-mail al secondo di quanto è consentito dalla frequenza massima in uscita. Se hai superato la frequenza di invio, puoi continuare a inviare e-mail ma devi ridurre la frequenza. Per ulteriori informazioni, consulta How to handle a "Throttling - Maximum sending rate exceeded" error nel blog AWS Messaging and Targeting.

  • Maximum SigV2 SMTP sending rate exceeded (Velocità massima di invio SMTP SIGv2 superata): stai tentando di inviare messaggi utilizzando le credenziali SMTP create prima del 10 gennaio 2019; le credenziali SMTP sono state create utilizzando una versione precedente della firma AWS. Per motivi di sicurezza, devi eliminare le credenziali create prima di questa data e sostituirle con credenziali più recenti. Puoi eliminare le credenziali più vecchie usando la console IAM. Per ulteriori informazioni sulla creazione delle credenziali, consulta Richiesta delle credenziali SMTP Amazon SES.

  È opportuno monitorare regolarmente le attività di invio per vedere quanto manca al raggiungimento delle quote di invio. Per ulteriori informazioni, consulta . Monitoraggio delle quote di invio di Amazon SES. Per informazioni generali sulle quote di invio, consulta Gestione dei limiti di invio di Amazon SES. Per informazioni su come aumentare le quote di invio, consulta Aumento delle quote di invio di Amazon SES.

  Importante

  Se il messaggio che spiega l'errore di throttling non è correlato al superamento della quota giornaliera o della frequenza massima in uscita, è possibile che esista un problema a livello di sistema che comporta una riduzione delle funzionalità di invio. Per informazioni sullo stato dei servizi, vai alla Service Health Dashboard di AWS.

• There are no recipients specified (Nessun destinatario specificato): non sono stati indicati i destinatari.

• There are non-ASCII characters in the email address (Nessun carattere non ASCII nell'indirizzo e-mail): la stringa dell'indirizzo e-mail deve essere ASCII a 7 bit. Se desideri utilizzare indirizzi e-mail (del mittente o del destinatario) che contengono caratteri Unicode nella parte del dominio, devi codificare il dominio utilizzando Punycode. Punycode non è consentito nella parte locale dell'indirizzo e-mail (ad esempio, la parte prima della @), né nel nome del mittente. Se desideri utilizzare caratteri Unicode nel nome del mittente, devi codificarlo con la sintassi MIME, come descritto in Invio di e-mail non elaborate utilizzando l'API Amazon SES v2. Per ulteriori informazioni su Punycode, consulta RFC 3492.

• Mail FROM domain is not verified (Dominio Mail FROM non verificato): Amazon SES non è riuscito a leggere il record MX necessario per usare il dominio MAIL FROM specificato. Per informazioni sulla configurazione di domini MAIL FROM personalizzati, consulta Uso di un dominio MAIL FROM personalizzato.

• Configuration set does not exist (Set di configurazione inesistente): il set di configurazione specificato non esiste. Un set di configurazione è un parametro opzionale che puoi utilizzare per pubblicare gli eventi di invio di e-mail. Per ulteriori informazioni, consulta . Monitoraggio dell'invio di e-mail utilizzando la pubblicazione di eventi di Amazon SES.