View a markdown version of this page

Menggunakan daftar penindasan tingkat penyewa di Amazon SES - Layanan Email Sederhana Amazon
Cara kerja penindasan tingkat penyewaPrioritas penindasanPerekaman penindasan otomatisMengidentifikasi pantulan penindasan penyewaMengelola entriPertimbangan dan batasanSumber daya terkait

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menggunakan daftar penindasan tingkat penyewa di Amazon SES

Jika Anda menggunakan Amazon Simple Email Service (SES) multi-tenancy untuk mengirim email atas nama beberapa penyewa, Anda dapat memberikan setiap penyewa daftar penindasan sendiri. Tenant-level penindasan mengisolasi pantulan dan keluhan sehingga hanya mempengaruhi penyewa yang mengirim email. Tanpa fitur ini, semua penyewa berbagi daftar penekanan tingkat akun. Ketika penerima memantul atau mengeluh tentang email satu penyewa, alamat itu ditekan untuk setiap penyewa di akun. Tenant-level penindasan mencegah kontaminasi penyewa silang ini dengan mempertahankan daftar alamat yang ditekan terpisah untuk setiap penyewa.

Cara kerja penindasan tingkat penyewa

Dua pengaturan mengontrol perilaku penekanan untuk setiap penyewa: ruang lingkup penekanan dan alasan yang ditekan. Anda mengonfigurasi kedua pengaturan secara bersamaan menggunakan operasi PutTenantSuppressionAttributes API, atau dengan menentukan SuppressionAttributes kapan Anda membuat penyewa dengan operasi CreateTenant API.

Lingkup penekanan menentukan daftar penindasan mana yang digunakan SES untuk penyewa:

  • TENANT— Gunakan daftar penindasan penyewa sendiri.

  • ACCOUNT— Gunakan daftar penekanan tingkat akun. Ini adalah default untuk penyewa yang sudah ada dan yang baru.

Alasan yang ditekan menentukan peristiwa mana yang menyebabkan SES menambahkan alamat ke daftar penekanan:

  • BOUNCE— Tambahkan alamat yang menghasilkan pantulan keras.

  • COMPLAINT— Tambahkan alamat yang menghasilkan keluhan.

  • BOUNCEdan COMPLAINT — Tambahkan alamat yang menghasilkan salah satu acara.

  • Kosong - Jangan periksa atau rekam ke daftar penindasan apa pun.

catatan

Anda harus menyediakan SuppressionScope dan SuppressedReasons bersama-sama, atau mengatur keduanya ke nol. Menyetel keduanya ke null akan menghapus pengaturan penekanan penyewa dan mengembalikan penyewa ke perilaku cakupan default. ACCOUNT

Perilaku penekanan dengan konfigurasi

Tabel berikut menjelaskan perilaku waktu pengiriman dan perekaman untuk setiap kombinasi lingkup penekanan dan alasan yang ditekan.

Lingkup Alasan Send-time perilaku Perilaku perekaman
TENANT BOUNCE, COMPLAINT Memeriksa daftar penyewa untuk bounces dan keluhan Merekam keduanya ke daftar penyewa
TENANT BOUNCE Memeriksa daftar penyewa untuk bounces saja Rekaman memantul ke daftar penyewa saja
TENANT COMPLAINT Cek daftar penyewa hanya untuk keluhan Mencatat keluhan ke daftar penyewa saja
TENANT Kosong Tidak ada pemeriksaan penindasan Tidak ada rekaman
ACCOUNT BOUNCE, COMPLAINT Memeriksa daftar akun untuk bouncing dan keluhan Merekam keduanya ke daftar akun
ACCOUNT BOUNCE Memeriksa daftar akun hanya untuk bounces Rekaman memantul ke daftar akun saja
ACCOUNT COMPLAINT Memeriksa daftar akun hanya untuk keluhan Mencatat keluhan ke daftar akun saja
ACCOUNT Kosong Tidak ada pemeriksaan penindasan Tidak ada rekaman

Prioritas penekanan dan perilaku waktu pengiriman

SES menyelesaikan pengaturan penekanan dalam urutan prioritas berikut, dari tertinggi ke terendah:

  1. Set konfigurasi - Jika set konfigurasi menentukan pengaturan penekanan, SES menggunakan pengaturan tersebut.

  2. Penyewa - Jika tidak ada penggantian set konfigurasi, SES menggunakan pengaturan penekanan penyewa.

  3. Akun - Jika set konfigurasi maupun penyewa tidak menentukan pengaturan, SES menggunakan default tingkat akun.

penting

Lingkup penindasan menentukan daftar penindasan mana yang diperiksa SES pada waktu pengiriman. Ketika cakupannyaTENANT, SES hanya memeriksa daftar penindasan penyewa dan melewatkan daftar penekanan tingkat akun. Alamat yang ada di daftar penindasan tingkat akun tetapi tidak pada daftar penindasan penyewa tidak ditekan. Ketika cakupannyaACCOUNT, SES hanya memeriksa daftar penekanan tingkat akun. Ruang lingkup juga mengontrol di mana pantulan dan keluhan dicatat.

Penggantian set konfigurasi

SuppressionOptionsUntuk set konfigurasi sekarang termasuk SuppressionScope bidang. Anda dapat menggunakan set konfigurasi untuk mengganti cakupan saja, alasannya saja, atau keduanya secara independen. Ini memberi Anda kontrol halus atas perilaku penekanan untuk alur kerja pengiriman tertentu. Anda tidak perlu mengubah pengaturan default penyewa.

Perekaman penindasan otomatis

Ketika cakupan penekananTENANT, SES secara otomatis mencatat entri penekanan sebagai berikut:

  • Hard bounce — SES menambahkan alamat ke daftar penindasan penyewa dan daftar penindasan global. SES tidak menambahkan alamat ke daftar penekanan tingkat akun.

  • Keluhan — SES menambahkan alamat ke daftar penindasan penyewa saja.

  • Not-spam umpan balik — Ketika penerima menandai pesan yang dilaporkan sebelumnya sebagai bukan spam, SES secara otomatis menghapus entri COMPLAINT -reason dari daftar penindasan penyewa.

Mengidentifikasi pantulan penindasan penyewa

Saat SES menekan pesan karena alamatnya ada di daftar penindasan penyewa, Anda dapat mengidentifikasi acara dengan menggunakan indikator berikut:

  • Pemberitahuan bouncing — Jenis bouncing adalah Permanent dengan subtipe dari. OnTenantSuppressionList

  • Virtual Deliverability Manager (VDM) — Alasan pentalan adalah. ON_TENANT_SUPPRESSION_LIST

  • Kode diagnostik - "Amazon SES did not send the message to this address because it is on the suppression list for your tenant."

  • Event tag — SES menambahkan ses:tenant-name tag untuk bouncing dan pemberitahuan keluhan sehingga Anda dapat mengidentifikasi penyewa acara tersebut.

Mengelola entri daftar penindasan penyewa

Anda mengelola entri daftar penghambatan penyewa dengan menggunakan operasi API yang sama dengan yang Anda gunakan untuk entri tingkat akun. Untuk menargetkan daftar penindasan penyewa, sertakan TenantName parameter dalam permintaan Anda:

  • PutSuppressedDestination— Tambahkan alamat ke daftar penindasan penyewa.

  • GetSuppressedDestination— Ambil detail tentang alamat yang ditekan untuk penyewa.

  • DeleteSuppressedDestination— Hapus alamat dari daftar penindasan penyewa.

  • ListSuppressedDestinations— Daftar semua alamat yang ditekan untuk penyewa.

Jika Anda menghilangkan TenantName parameter, operasi ini menargetkan daftar penekanan tingkat akun. Ini mempertahankan kompatibilitas mundur dengan integrasi yang ada.

Pertimbangan dan batasan

Ingatlah hal berikut saat Anda menggunakan daftar penekanan tingkat penyewa:

  • Multi-tenancy diperlukan - Anda harus memiliki SES multi-tenancy dikonfigurasi dengan setidaknya satu penyewa untuk menggunakan fitur ini.

  • Satu daftar per penyewa - Setiap penyewa memiliki persis satu daftar penindasan. Ada pemetaan 1:1 antara penyewa dan daftar penindasan.

  • Region-specific— Daftar penindasan penyewa khusus untuk tempat AWS Region Anda mengonfigurasinya.

  • Alamat tetap ada — Alamat yang ditekan tetap ada di daftar penyewa sampai Anda menghapusnya secara eksplisit atau sampai SES secara otomatis menghapusnya (misalnya, ketika penerima melaporkan peristiwa bukan spam untuk entri -alasan). COMPLAINT

  • Case-sensitive penyimpanan — Alamat email pada daftar penindasan disimpan dengan case yang diawetkan. Panggilan API untuk manajemen daftar penekanan memerlukan kecocokan kasus yang tepat.

  • Mengirim dampak kuota — Pesan yang ditekan oleh daftar penindasan penyewa dihitung terhadap kuota pengiriman harian Anda.

  • Data keluhan Gmail — Gmail tidak mengirim data keluhan ke SES. Alamat yang di-host oleh Gmail tidak secara otomatis ditambahkan ke daftar penindasan untuk keluhan.

  • Pembatasan kotak pasir - Anda tidak dapat menelepon PutSuppressedDestination sampai akun Anda memiliki akses produksi.

  • Menghapus pengaturan - Untuk menghapus pengaturan penindasan penyewa, panggil PutTenantSuppressionAttributes dengan nilai nol untuk cakupan dan alasan.

  • Menghapus penyewa — Saat Anda menghapus penyewa, SES juga menghapus semua entri daftar penindasan untuk penyewa tersebut.

Sumber daya berikut dapat membantu Anda mempelajari lebih lanjut tentang daftar penindasan di SES.