View a markdown version of this page

Errori di invio di e-mail con Amazon SES - Amazon Simple Email Service

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à.

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 chiami direttamente l'API Amazon SES, l'operazione restituisce un errore. L'errore potrebbe essere uno degli errori che SendEmail restituisce un'operazione nell'API Amazon SES v2 o uno degli errori specificati in Errori comuni argomento del Riferimento all'API Amazon SES v2. Gli errori che SendEmail i rendimenti delle operazioni includono MessageRejected, SendingPausedException, e MailFromDomainNotVerifiedException.

  • Se chiami Amazon SES utilizzando un AWS SDK che utilizza un linguaggio di programmazione che supporta le eccezioni, Amazon SES può generare un'eccezione. Il tipo di eccezione dipende dall'SDK e dall'errore. Ad esempio, l'eccezione potrebbe essere un Amazon SES MessageRejectedException (il nome effettivo può variare a seconda dell'SDK) o generico AWS eccezione. 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.

I seguenti sono i tipi di Amazon SES-specific problemi che possono far sì che Amazon SES restituisca un errore quando si tenta di inviare un'e-mail. Questi errori si aggiungono a quelli generali AWS errori come AccessDeniedException come specificato nel Errori comuni argomento del Riferimento all'API Amazon SES v2.

  • L'indirizzo email non è verificato. 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 «Da», «Mittente» o»Return-Path«indirizzo», o al FromEmailAddress che specifichi nella richiesta. 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 ha endpoint in multiplo Regioni AWSe lo stato di verifica dell'indirizzo email è separato per ciascuno Regione AWS. È necessario completare il processo di verifica per ciascun mittente nel 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, vedere Come gestire un errore «Throttling - Velocità massima di invio superata» sul AWS Blog di messaggistica e targeting.

    • È stata superata la velocità massima di invio SMTP Sigv2—Stai tentando di inviare messaggi utilizzando credenziali SMTP create prima del 10 gennaio 2019; le tue credenziali SMTP sono state create utilizzando una versione precedente di AWS Firma. 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 email 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.

  • Errori e timeout del server—In rare occasioni, a SendEmail o SendBulkEmail la richiesta potrebbe scadere o restituire un errore del server dopo che l'e-mail è già stata accettata per la consegna. Se l'applicazione riprova la richiesta, potrebbe essere inviata una seconda email con un ID messaggio diverso. Per correlare in modo affidabile le notifiche degli eventi con la logica di invio, usa tag dei messaggi anziché affidarsi esclusivamente all'ID del messaggio.