Kesalahan pengiriman email Amazon SES

Topik ini meninjau tipe kesalahan pengiriman email tertentu yang mungkin Anda alami ketika Anda mengirim email melalui Amazon SES. Jika Anda mencoba untuk mengirim email melalui Amazon SES dan panggilan ke Amazon SES gagal, Amazon SES mengembalikan pesan kesalahan untuk aplikasi Anda dan tidak mengirim email. Cara yang Anda amati pada pesan kesalahan ini tergantung pada cara yang Anda sebut Amazon SES.

• Jika Anda memanggil API Amazon SES secara langsung, tindakan Kueri akan mengembalikan kesalahan. Kesalahan mungkin MessageRejected atau salah satu kesalahan yang ditentukan dalam topik Kesalahan Umum dari Referensi API Amazon Simple Email Service.

• Jika Anda memanggil Amazon SES menggunakan AWS SDK yang menggunakan bahasa pemrograman yang mendukung pengecualian, Amazon SES mungkin melemparkan pengecualian. Tipe pengecualian tergantung pada SDK dan kesalahan. Misalnya, pengecualian bisa menjadi Amazon SES MessageRejectedException (nama sebenarnya dapat beragam tergantung pada SDK) atau pengecualian AWS umum. Terlepas dari tipe pengecualian, tipe kesalahan dan pesan kesalahan dalam pengecualian akan memberi Anda lebih banyak informasi.

• Jika Anda memanggil Amazon SES melalui antarmuka SMTP, cara Anda mengalami kesalahan tergantung pada aplikasi. Beberapa aplikasi mungkin menampilkan pesan kesalahan tertentu, dan aplikasi lainnya mungkin tidak. Untuk daftar kode respons SMTP yang mengembalikan Amazon SES, lihat Kode respons SMTP dikembalikan oleh Amazon SES.

catatan

Ketika panggilan Anda ke Amazon SES untuk mengirim email gagal, Anda tidak ditagih untuk email itu.

Berikut ini adalah tipe masalah spesifik Amazon SES yang dapat menyebabkan Amazon SES untuk mengembalikan kesalahan ketika Anda mencoba untuk mengirim email. Kesalahan ini adalah tambahan ke kesalahan AWS umum seperti MalformedQueryString seperti yang ditentukan dalam topik Kesalahan Umum dari Referensi API Amazon Simple Email Service.

• Alamat email tidak diverifikasi. Identitas berikut gagal dalam wilayah check in wilayah: identity1, identity2, identity3—Anda mencoba mengirim email dari alamat email atau domain yang belum diverifikasi dengan Amazon SES. Kesalahan ini dapat diterapkan untuk alamat "Dari", "Sumber", "Pengirim", atau "Jalur-Kembali". Jika akun Anda masih dalam sandbox Amazon SES, Anda juga harus memverifikasi setiap alamat email penerima kecuali penerima yang disediakan oleh simulator kotak surat Amazon SES. Jika Amazon SES tidak mampu menunjukkan semua identitas yang gagal, pesan kesalahan berakhir dengan elipsis.

  catatan

  Amazon SES memiliki titik akhir di beberapa Wilayah AWS, dan status verifikasi alamat email terpisah untuk setiap Wilayah AWS. Anda harus menyelesaikan proses verifikasi untuk setiap pengirim di Wilayah AWS yang ingin Anda gunakan.

• Akun dijeda—Kemampuan akun Anda untuk mengirim email dijeda. Anda masih dapat mengakses konsol Amazon SES dan melakukan sebagian besar operasi. Namun, jika Anda mencoba untuk mengirim email, Anda menerima pesan ini.

  Jika kami menjeda kemampuan akun Anda untuk mengirim email, kami secara otomatis mengirimkan notifikasi ke alamat email yang terkait dengan Akun AWS Anda. Untuk informasi lebih lanjut, lihat FAQ proses peninjauan Pengiriman Amazon SES.

• Throttling—Aplikasi Anda mungkin mencoba mengirim terlalu banyak pesan per detik, atau Anda mungkin telah mengirim terlalu banyak email selama 24 jam terakhir. Dalam kasus ini, pesan kesalahan mungkin mirip dengan contoh berikut:

  • Kuota pesan harian terlampaui—Anda telah mengirim jumlah pesan maksimum yang diizinkan dalam waktu 24 jam. Jika Anda telah melampaui kuota harian, Anda harus menunggu hingga waktu 24 jam berikutnya sebelum dapat mengirim email lainnya.

  • Laju pengiriman maksimum terlampaui—Anda mencoba untuk mengirim lebih banyak email per detik daripada yang diizinkan oleh laju pengiriman maksimum Anda. Jika Anda telah melampaui laju pengiriman Anda, Anda dapat terus mengirim email, tetapi akan perlu untuk mengurangi laju pengiriman Anda. Untuk informasi lebih lanjut, lihat Cara menangani kesalahan "Throttling - laju pengiriman maksimum terlampaui" di Blog Pesan dan Target AWS.

  • Laju pengiriman SMTP SigV2 maksimum terlampaui—Anda mencoba mengirim pesan menggunakan kredensial SMTP yang dibuat sebelum tanggal 10 Januari 2019; kredensial SMTP Anda dibuat menggunakan versi Tanda Tangan AWS. Demi keamanan, Anda harus menghapus kredensial yang Anda buat sebelum tanggal ini, dan menggantinya dengan kredensial yang lebih baru. Anda dapat menghapus kredensial menggunakan konsol IAM. Untuk informasi lebih lanjut, lihat Mendapatkan kredensial SMTP Amazon SES untuk membuat kredensial.

  Anda harus memantau aktivitas pengiriman Anda secara teratur untuk melihat seberapa dekat Anda dengan kuota pengiriman Anda. Untuk informasi lebih lanjut, lihat Pemantauan kuota pengiriman Amazon SES Anda. Untuk informasi umum tentang kuota pengiriman, lihat Mengelola batas pengiriman Amazon SES Anda. Untuk informasi tentang cara meningkatkan kuota pengiriman Anda, lihat Meningkatkan kuota pengiriman Amazon SES Anda.

  penting

  Jika teks kesalahan yang menjelaskan kesalahan throttling tidak terkait dengan Anda yang melampaui kuota harian Anda atau laju pengiriman maksimum, maka mungkin ada masalah di seluruh sistem yang menyebabkan kemampuan pengiriman berkurang. Untuk informasi tentang status layanan, buka AWS Service Health Dashboard.

• Tidak ada penerima yang ditentukan—Tidak ada penerima yang diberikan.

• Ada karakter non-ASCII di alamat email—String alamat email harus berupa ASCII 7-bit. Jika Anda ingin mengirim ke atau dari alamat email yang berisi karakter Unicode di bagian domain alamat, Anda harus mengodekan domain menggunakan Punycode. Punycode tidak diizinkan di bagian lokal dari alamat email (bagian sebelum tanda @) atau dalam nama "friendly from". Jika Anda ingin menggunakan karakter Unicode dalam nama "friendly from", Anda harus mengodekan nama "friendly from" menggunakan sintaksis kata yang dikodekan MIME, seperti yang dijelaskan dalam Mengirim email mentah menggunakan Amazon SES API v2. Untuk informasi selengkapnya tentang Punycode, lihat RFC 3492.

• Domain surat FROM tidak diverifikasi—Amazon SES tidak dapat membaca catatan MX yang diperlukan untuk menggunakan domain MAIL FROM yang ditentukan. Untuk informasi pengaturan domain MAIL FROM kustom, lihat Menggunakan domain MAIL FROM kustom.

• Set konfigurasi tidak ada—Set konfigurasi yang Anda tentukan tidak ada. Set konfigurasi adalah parameter opsional yang Anda gunakan untuk memublikasikan kejadian pengiriman email. Untuk informasi lebih lanjut, lihat Pantau pengiriman email menggunakan penerbitan peristiwa Amazon SES.