Prasyarat Menambahkan alamat Memeriksa alamat Menghapus alamat Alamat daftar Entri penindasan otomatis

Mengelola entri daftar penindasan penyewa

Anda mengelola entri pada daftar penindasan penyewa menggunakan operasi API Amazon Simple Email Service (SES) Amazon Simple Service (SES) yang sama yang Anda gunakan untuk daftar penekanan tingkat akun. Untuk menargetkan daftar penyewa tertentu, sertakan --tenant-name parameter di setiap permintaan. Ketika Anda menghilangkan parameter ini, operasi menargetkan daftar tingkat akun. Gunakan tombol AWS CLI untuk menambah, memeriksa, menghapus, dan mencantumkan alamat yang ditekan untuk penyewa tertentu.

penting

Alamat email pada daftar penindasan disimpan dengan case yang diawetkan. Meskipun fungsionalitas pengiriman email memperlakukan alamat dengan kasus yang berbeda sebagai identik, panggilan API untuk manajemen daftar penekanan memerlukan pencocokan kasus yang tepat. Pastikan bahwa Anda menggunakan kasus yang tepat dari alamat email seperti yang muncul dalam daftar penekanan ketika Anda menambahkan, memeriksa, atau menghapus entri.

Prasyarat

Sebelum Anda mengelola entri daftar penindasan penyewa, pastikan Anda memenuhi persyaratan berikut:

Tenant-level penindasan diaktifkan untuk penyewa. Untuk informasi selengkapnya, lihat Mengkonfigurasi penekanan tingkat penyewa.
AWS CLI versi 2 diinstal dan dikonfigurasi dengan izin yang sesuai. Untuk informasi selengkapnya, silakan lihat Panduan Pengguna AWS Command Line Interface.
Penyewa ada di akun SES Anda.

Menambahkan alamat ke daftar penindasan penyewa

Gunakan operasi PutSuppressedDestination API dengan --tenant-name parameter untuk menambahkan alamat email ke daftar penindasan penyewa.

Untuk menambahkan alamat ke daftar penindasan penyewa menggunakan AWS CLI

Di baris perintah, masukkan perintah berikut:
Linux, macOS, or Unix
```
aws sesv2 put-suppressed-destination \
--email-address recipient@example.com \
--reason BOUNCE \
--tenant-name MyTenant
```
Windows
```
aws sesv2 put-suppressed-destination `
--email-address recipient@example.com `
--reason BOUNCE `
--tenant-name MyTenant
```
Pada contoh sebelumnya, ganti recipient@example.com dengan alamat email yang akan ditambahkan, BOUNCE dengan alasan penindasan (nilai yang dapat diterima adalah BOUNCE danCOMPLAINT), dan MyTenant dengan nama penyewa Anda.

Perintah tidak menghasilkan output pada keberhasilan (HTTP 200). Alamatnya sekarang ada di daftar penindasan penyewa.

catatan

--reasonParameter menerima BOUNCE atauCOMPLAINT. Anda dapat menambahkan alamat yang sama dengan alasan yang berbeda.

Memeriksa apakah alamat ada di daftar penindasan penyewa

Gunakan operasi GetSuppressedDestination API dengan --tenant-name parameter untuk memeriksa apakah alamat email ada di daftar penindasan penyewa.

Untuk memeriksa apakah alamat ada di daftar penindasan penyewa menggunakan AWS CLI

Di baris perintah, masukkan perintah berikut:

Pada contoh sebelumnya, ganti recipient@example.com dengan alamat email untuk memeriksa dan MyTenant dengan nama penyewa Anda.

Jika alamat ada di daftar penindasan penyewa, perintah mengembalikan output yang menyerupai contoh berikut:


{
    "SuppressedDestination": {
        "EmailAddress": "recipient@example.com",
        "Reason": "BOUNCE",
        "LastUpdateTime": "2026-03-15T10:30:00.000Z",
        "Attributes": {
            "MessageId": "0100018e1234abcd-12345678-abcd-1234-abcd-123456789012-000000",
            "FeedbackId": "0100018e1234abce-12345678-abcd-1234-abcd-123456789012-000000"
        }
    }
}

Tanggapan tersebut mencakup bidang-bidang berikut:

EmailAddress— Alamat email yang ditekan.
Reason— Mengapa alamatnya ditekan (BOUNCEatauCOMPLAINT).
LastUpdateTime— Saat entri terakhir diperbarui.
Attributes— Berisi MessageId dan FeedbackId dari peristiwa yang menyebabkan penindasan. Bidang ini hadir untuk alamat yang ditekan secara otomatis dan tidak ada untuk entri yang ditambahkan secara manual.

catatan

Jika alamat tidak ada dalam daftar penindasan penyewa, API akan mengembalikan file. NotFoundException

Menghapus alamat dari daftar penindasan penyewa

Gunakan operasi DeleteSuppressedDestination API dengan --tenant-name parameter untuk menghapus alamat email dari daftar penindasan penyewa.

Untuk menghapus alamat dari daftar penindasan penyewa menggunakan AWS CLI

Di baris perintah, masukkan perintah berikut:

Pada contoh sebelumnya, ganti recipient@example.com dengan alamat email yang akan dihapus dan MyTenant dengan nama penyewa Anda.

Perintah tidak menghasilkan output pada keberhasilan (HTTP 200). Alamat dihapus dari daftar penindasan penyewa.

penting

Menghapus alamat dari daftar penindasan penyewa tidak menghapusnya dari daftar penindasan global atau daftar penindasan tingkat akun. Setiap daftar dikelola secara independen.

Daftar alamat pada daftar penindasan penyewa

Gunakan operasi ListSuppressedDestinations API dengan --tenant-name parameter untuk mengambil semua alamat yang ditekan untuk penyewa tertentu.

Untuk mencantumkan semua alamat pada daftar penindasan penyewa menggunakan AWS CLI

Di baris perintah, masukkan perintah berikut:
Linux, macOS, or Unix
```
aws sesv2 list-suppressed-destinations \
--tenant-name MyTenant
```
Windows
```
aws sesv2 list-suppressed-destinations `
--tenant-name MyTenant
```
Pada contoh sebelumnya, ganti MyTenant dengan nama penyewa Anda.

Contoh output berikut menunjukkan dua alamat yang ditekan:


{
    "SuppressedDestinationSummaries": [
        {
            "EmailAddress": "bounce@example.com",
            "Reason": "BOUNCE",
            "LastUpdateTime": "2026-03-10T08:15:00.000Z"
        },
        {
            "EmailAddress": "complaint@example.com",
            "Reason": "COMPLAINT",
            "LastUpdateTime": "2026-03-12T14:30:00.000Z"
        }
    ]
}

Memfilter hasil

Anda dapat memfilter hasil berdasarkan alasan, rentang tanggal, atau keduanya.

Perintah berikut menyaring dengan alasan:

Perintah berikut menyaring berdasarkan rentang tanggal:

Jika respons menyertakan NextToken nilai, gunakan dalam permintaan berikutnya untuk mengambil lebih banyak hasil. Gunakan --page-size parameter untuk mengontrol jumlah hasil per halaman.

catatan

Operasi daftar hanya mengembalikan informasi ringkasan. Untuk mendapatkan detail lengkap termasukAttributes, gunakan GetSuppressedDestination untuk alamat individual.

Entri penindasan otomatis

SES secara otomatis mengelola entri penekanan berdasarkan konfigurasi penindasan penyewa. Anda tidak perlu mengambil tindakan apa pun untuk entri otomatis. Mereka muncul di daftar penindasan penyewa di samping entri yang ditambahkan secara manual.

SES secara otomatis menambahkan entri dalam kasus berikut:

Terjadi hard bounce, jika penindasan bouncing diaktifkan untuk penyewa.
Keluhan diterima, jika penindasan keluhan diaktifkan untuk penyewa.

SES secara otomatis menghapus entri dalam kasus berikut:

Laporan bukan spam diterima untuk alamat yang ditekan keluhan.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Mengkonfigurasi penekanan tingkat penyewa

Menggunakan penekanan set-level konfigurasi