View a markdown version of this page

Mengkonfigurasi penekanan tingkat penyewa - Layanan Email Sederhana Amazon
PrasyaratMengaktifkan penekanan tingkat penyewaMengkonfigurasi penekanan untuk penyewa baruMengganti dengan set konfigurasiMenonaktifkan penekanan tingkat penyewaMelihat konfigurasi penekanan saat iniPemecahan masalahSumber daya terkait

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

Mengkonfigurasi penekanan tingkat penyewa

Konfigurasikan pengaturan penekanan tingkat penyewa untuk mengontrol cara Amazon Simple Email Service (Amazon SES) menangani pantulan dan keluhan untuk penyewa individu. Secara default, penyewa menggunakan daftar penekanan tingkat akun Anda. Saat Anda mengaktifkan penekanan tingkat penyewa, SES mempertahankan daftar penekanan terpisah untuk setiap penyewa. Ini memberi Anda kontrol terperinci atas pengiriman email.

Topik ini menyediakan prosedur untuk mengaktifkan, memodifikasi, menonaktifkan, dan melihat pengaturan penekanan tingkat penyewa dengan menggunakan. AWS CLI

penting

Menonaktifkan penekanan tingkat penyewa tidak menghapus entri yang ada dari daftar penindasan penyewa. Jika Anda mengaktifkan kembali penekanan tingkat penyewa nanti, entri tersebut masih aktif.

Prasyarat

Sebelum Anda mengonfigurasi penekanan tingkat penyewa, pastikan Anda memenuhi persyaratan berikut:

Mengaktifkan penekanan tingkat penyewa untuk penyewa yang ada

Gunakan operasi PutTenantSuppressionAttributes API untuk mengaktifkan penekanan tingkat penyewa untuk penyewa yang ada. Operasi ini idempoten, sehingga Anda dapat memanggilnya beberapa kali dengan parameter yang sama tanpa efek samping.

Untuk mengaktifkan penekanan tingkat penyewa

  1. Pada baris perintah, jalankan put-tenant-suppression-attributes perintah berikut untuk mengaktifkan penekanan tingkat penyewa untuk pantulan dan keluhan:

    Linux, macOS, or Unix
    aws sesv2 put-tenant-suppression-attributes \
--tenant-name MyTenant \
--suppression-scope TENANT \
--suppressed-reasons BOUNCE COMPLAINT
    Windows
    aws sesv2 put-tenant-suppression-attributes `
--tenant-name MyTenant `
--suppression-scope TENANT `
--suppressed-reasons BOUNCE COMPLAINT

    Ganti MyTenant dengan nama penyewa Anda.

  2. Verifikasi bahwa perintah tidak mengembalikan output. Permintaan yang berhasil mengembalikan respons HTTP 200 tanpa isi.

  3. Konfirmasikan konfigurasi dengan menjalankan perintah berikut:

    aws sesv2 get-tenant --tenant-name MyTenant

Penyewa sekarang menggunakan daftar penindasan sendiri untuk pantulan dan keluhan.

Anda juga dapat mengonfigurasi penekanan untuk satu jenis alasan. Contoh berikut menunjukkan cara mengaktifkan penekanan hanya untuk pantulan atau keluhan saja.

Perintah berikut hanya menekan pantulan:

Linux, macOS, or Unix
aws sesv2 put-tenant-suppression-attributes \
--tenant-name MyTenant \
--suppression-scope TENANT \
--suppressed-reasons BOUNCE
Windows
aws sesv2 put-tenant-suppression-attributes `
--tenant-name MyTenant `
--suppression-scope TENANT `
--suppressed-reasons BOUNCE

Perintah berikut hanya menekan keluhan:

Linux, macOS, or Unix
aws sesv2 put-tenant-suppression-attributes \
--tenant-name MyTenant \
--suppression-scope TENANT \
--suppressed-reasons COMPLAINT
Windows
aws sesv2 put-tenant-suppression-attributes `
--tenant-name MyTenant `
--suppression-scope TENANT `
--suppressed-reasons COMPLAINT
catatan

Anda harus menyediakan --suppression-scope dan --suppressed-reasons bersama-sama. Memberikan satu tanpa yang lain mengembalikanInvalidParameterValueException.

Mengkonfigurasi penekanan saat membuat penyewa baru

Gunakan operasi CreateTenant API dengan SuppressionAttributes parameter untuk membuat penyewa dengan penekanan tingkat penyewa diaktifkan sejak awal.

Untuk membuat penyewa dengan penindasan tingkat penyewa

  1. Pada baris perintah, jalankan create-tenant perintah berikut:

    Linux, macOS, or Unix
    aws sesv2 create-tenant \
--tenant-name MyNewTenant \
--suppression-attributes '{"SuppressionScope":"TENANT","SuppressedReasons":["BOUNCE","COMPLAINT"]}'
    Windows
    aws sesv2 create-tenant `
--tenant-name MyNewTenant `
--suppression-attributes '{"SuppressionScope":"TENANT","SuppressedReasons":["BOUNCE","COMPLAINT"]}'

    Ganti MyNewTenant dengan nama penyewa baru Anda.

  2. Verifikasi bahwa respons berisi ID penyewa:

    {
    "TenantId": "tn-abc123def456"
}

Penyewa dibuat dengan penekanan tingkat penyewa yang diaktifkan untuk pantulan dan keluhan.

catatan

Jika Anda menghilangkan--suppression-attributes, penyewa default ke ACCOUNT cakupan dan menggunakan daftar penekanan tingkat akun.

Mengesampingkan penekanan penyewa dengan set konfigurasi

Anda dapat mengganti setelan penekanan penyewa dengan menambahkan SuppressionScope ke set konfigurasi. SuppressionOptions Saat Anda mengirim email menggunakan set konfigurasi ini, pengaturan penekanan set konfigurasi lebih diutamakan daripada pengaturan penyewa. Anda dapat mengganti ruang lingkup saja, alasan saja, atau keduanya secara independen.

Untuk membuat set konfigurasi dengan penggantian cakupan penyewa

  1. Pada baris perintah, jalankan create-configuration-set perintah berikut:

    Linux, macOS, or Unix
    aws sesv2 create-configuration-set \
--configuration-set-name my-config-set \
--suppression-options '{"SuppressionScope":"TENANT","SuppressedReasons":["BOUNCE"]}'
    Windows
    aws sesv2 create-configuration-set `
--configuration-set-name my-config-set `
--suppression-options '{"SuppressionScope":"TENANT","SuppressedReasons":["BOUNCE"]}'

    Ganti my-config-set dengan nama untuk set konfigurasi Anda.

  2. Verifikasi bahwa perintah tidak mengembalikan output. Permintaan yang berhasil mengembalikan respons HTTP 200.

Untuk memperbarui set konfigurasi yang ada dengan opsi penekanan

  1. Pada baris perintah, jalankan put-configuration-set-suppression-options perintah berikut:

    Linux, macOS, or Unix
    aws sesv2 put-configuration-set-suppression-options \
--configuration-set-name my-config-set \
--suppression-scope TENANT \
--suppressed-reasons BOUNCE
    Windows
    aws sesv2 put-configuration-set-suppression-options `
--configuration-set-name my-config-set `
--suppression-scope TENANT `
--suppressed-reasons BOUNCE

    Ganti my-config-set dengan nama set konfigurasi Anda.

  2. Verifikasi bahwa perintah tidak mengembalikan output. Permintaan yang berhasil mengembalikan respons HTTP 200.

Menonaktifkan penekanan tingkat penyewa

Untuk mengembalikan penyewa ke penekanan tingkat akun, Anda dapat mengatur cakupan ACCOUNT atau menghapus semua pengaturan penekanan.

Untuk mengatur penyewa ke penekanan tingkat akun

  1. Pada baris perintah, jalankan perintah berikut untuk secara eksplisit mengatur cakupan ke: ACCOUNT

    Linux, macOS, or Unix
    aws sesv2 put-tenant-suppression-attributes \
--tenant-name MyTenant \
--suppression-scope ACCOUNT \
--suppressed-reasons BOUNCE COMPLAINT
    Windows
    aws sesv2 put-tenant-suppression-attributes `
--tenant-name MyTenant `
--suppression-scope ACCOUNT `
--suppressed-reasons BOUNCE COMPLAINT

    Ganti MyTenant dengan nama penyewa Anda.

  2. Verifikasi bahwa perintah tidak mengembalikan output.

Untuk menghapus semua pengaturan penekanan

  1. Pada baris perintah, jalankan perintah berikut tanpa menentukan ruang lingkup atau alasan:

    aws sesv2 put-tenant-suppression-attributes --tenant-name MyTenant

    Ganti MyTenant dengan nama penyewa Anda.

  2. Verifikasi bahwa perintah tidak mengembalikan output.

catatan

Ketika Anda menghilangkan keduanya --suppression-scope dan--suppressed-reasons, SES menghapus pengaturan penindasan penyewa. Penyewa kembali ke perilaku penindasan tingkat akun.

penting

Menonaktifkan penekanan tingkat penyewa tidak menghapus entri yang ada dari daftar penindasan penyewa. Jika Anda mengaktifkan kembali penekanan tingkat penyewa nanti, entri tersebut masih aktif.

Melihat konfigurasi penekanan saat ini

Gunakan operasi GetTenant API untuk memeriksa pengaturan penekanan penyewa saat ini.

Untuk melihat konfigurasi penindasan penyewa

  1. Pada baris perintah, jalankan get-tenant perintah berikut:

    aws sesv2 get-tenant --tenant-name MyTenant

    Ganti MyTenant dengan nama penyewa Anda.

  2. Tinjau tanggapannya. Contoh berikut menunjukkan penyewa dengan penekanan tingkat penyewa diaktifkan:

    {
    "Tenant": {
        "TenantName": "MyTenant",
        "TenantId": "tn-abc123def456",
        "TenantArn": "arn:aws:ses:us-east-1:123456789012:tenant/MyTenant/tn-abc123def456",
        "SendingStatus": "ENABLED",
        "CreatedTimestamp": 1705312800,
        "UpdateTimestamp": 1705762800,
        "SuppressionAttributes": {
            "SuppressionScope": "TENANT",
            "SuppressedReasons": ["BOUNCE", "COMPLAINT"]
        }
    }
}

Tabel berikut menjelaskan bidang kunci dalam SuppressionAttributes objek.

Bidang Deskripsi
SuppressionScope Ruang lingkup penindasan untuk penyewa. Nilai TENANT berarti penyewa menggunakan daftar penindasannya sendiri. Nilai ACCOUNT sarana penyewa menggunakan daftar penekanan tingkat akun.
SuppressedReasons Alasan penindasan yang aktif untuk penyewa. Nilai yang mungkin adalahBOUNCE,COMPLAINT, atau keduanya.

Jika tidak SuppressionAttributes ada atau nol dalam respons, penyewa menggunakan penekanan tingkat akun.

Pemecahan masalah

Berikut ini adalah kesalahan umum yang mungkin Anda temui saat mengonfigurasi penekanan tingkat penyewa.

InvalidParameterValueException: SuppressedReasons cannot be null when SuppressionScope is provided

  • Penyebab — Anda ditentukan --suppression-scope tanpa--suppressed-reasons.

  • Perbaiki - Berikan kedua parameter bersama-sama, atau hilangkan keduanya untuk menghapus pengaturan.

InvalidParameterValueException: SuppressionScope is required when SuppressedReasons are provided

  • Penyebab — Anda ditentukan --suppressed-reasons tanpa--suppression-scope.

  • Perbaiki - Berikan kedua parameter bersama-sama.

NotFoundException

  • Penyebab - Nama penyewa yang Anda tentukan tidak ada.

  • Fix - Verifikasi nama penyewa dengan menjalankan perintah berikut:

    aws sesv2 list-tenants