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
<a name="sending-email-suppression-list-tenant-level"></a>

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
<a name="sending-email-suppression-list-tenant-level-how-it-works"></a>

*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.
+ `BOUNCE`dan `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
<a name="sending-email-suppression-list-tenant-level-behavior-by-config"></a>

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
<a name="sending-email-suppression-list-tenant-level-precedence"></a>

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.

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

1. **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 cakupannya`TENANT`, 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 cakupannya`ACCOUNT`, SES hanya memeriksa daftar penekanan tingkat akun. Ruang lingkup juga mengontrol di mana pantulan dan keluhan dicatat.

### Penggantian set konfigurasi
<a name="sending-email-suppression-list-tenant-level-config-set-overrides"></a>

`SuppressionOptions`Untuk 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
<a name="sending-email-suppression-list-tenant-level-auto-recording"></a>

Ketika cakupan penekanan`TENANT`, 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
<a name="sending-email-suppression-list-tenant-level-identifying-bounces"></a>

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
<a name="sending-email-suppression-list-tenant-level-managing-entries"></a>

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
<a name="sending-email-suppression-list-tenant-level-considerations"></a>

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 Wilayah AWS 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 terkait
<a name="sending-email-suppression-list-tenant-level-related-resources"></a>

Sumber daya berikut dapat membantu Anda mempelajari lebih lanjut tentang daftar penindasan di SES.
+ [Menggunakan daftar penindasan tingkat akun Amazon SES](sending-email-suppression-list.md)
+ [Daftar penindasan global Amazon SES](sending-email-global-suppression-list.md)