Menggunakan Filter Alamat IP untuk Tanda Terima Email di Amazon SES - AWS SDK for JavaScript

Kami mengumumkan yang akan datang end-of-support untuk AWS SDK for JavaScript v2. Kami menyarankan Anda bermigrasi ke AWS SDK for JavaScript v3. Untuk tanggal, detail tambahan, dan informasi tentang cara bermigrasi, silakan merujuk ke pengumuman tertaut.

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

Menggunakan Filter Alamat IP untuk Tanda Terima Email di Amazon SES

JavaScript code example that applies to Node.js execution

Contoh kode Node.js ini menunjukkan:

  • Buat filter alamat IP untuk menerima atau menolak email yang berasal dari alamat IP atau rentang alamat IP.

  • Buat daftar filter alamat IP Anda saat ini.

  • Hapus filter alamat IP.

Di Amazon SES, filter adalah struktur data yang terdiri dari nama, rentang alamat IP, dan apakah akan mengizinkan atau memblokir email darinya. Alamat IP yang ingin Anda blokir atau izinkan ditentukan sebagai alamat IP tunggal atau rentang alamat IP dalam notasi Classless Inter-Domain Routing (CIDR). Untuk detail tentang cara Amazon SES menerima email, lihat Konsep Penerimaan Email Amazon SES di Panduan Pengembang Layanan Email Sederhana Amazon.

Skenario

Dalam contoh ini, serangkaian modul Node.js digunakan untuk mengirim email dalam berbagai cara. Modul Node.js menggunakan SDK JavaScript untuk membuat dan menggunakan templat email menggunakan metode kelas AWS.SES klien berikut:

Tugas Prasyarat

Untuk mengatur dan menjalankan contoh ini, Anda harus terlebih dahulu menyelesaikan tugas-tugas ini:

Mengkonfigurasi SDK

Konfigurasikan SDK untuk JavaScript dengan membuat objek konfigurasi global lalu setel Wilayah untuk kode Anda. Dalam contoh ini, Region diatur keus-west-2.

// Load the SDK for JavaScript var AWS = require('aws-sdk'); // Set the Region AWS.config.update({region: 'us-west-2'});

Membuat Filter Alamat IP

Dalam contoh ini, gunakan modul Node.js untuk mengirim email dengan Amazon SES. Buat modul Node.js dengan nama fileses_createreceiptfilter.js. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya.

Buat objek untuk meneruskan nilai parameter yang menentukan filter IP, termasuk nama filter, alamat IP atau rentang alamat untuk difilter, dan apakah akan mengizinkan atau memblokir lalu lintas email dari alamat yang difilter. Untuk memanggil createReceiptFilter metode ini, buat janji untuk menjalankan objek layanan Amazon SES, melewati parameter. Kemudian tangani callback response in the promise.

// Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create createReceiptFilter params var params = { Filter: { IpFilter: { Cidr: "IP_ADDRESS_OR_RANGE", Policy: "Allow" | "Block", }, Name: "NAME", }, }; // Create the promise and SES service object var sendPromise = new AWS.SES({ apiVersion: "2010-12-01" }) .createReceiptFilter(params) .promise(); // Handle promise's fulfilled/rejected states sendPromise .then(function (data) { console.log(data); }) .catch(function (err) { console.error(err, err.stack); });

Untuk menjalankan contoh, ketik berikut ini di baris perintah. Filter dibuat di Amazon SES.

node ses_createreceiptfilter.js

Kode contoh ini dapat ditemukan di sini GitHub.

Cantumkan Filter Alamat IP Anda

Dalam contoh ini, gunakan modul Node.js untuk mengirim email dengan Amazon SES. Buat modul Node.js dengan nama fileses_listreceiptfilters.js. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya.

Buat objek parameter kosong. Untuk memanggil listReceiptFilters metode ini, buat janji untuk menjalankan objek layanan Amazon SES, melewati parameter. Kemudian tangani callback response in the promise.

// Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create the promise and SES service object var sendPromise = new AWS.SES({ apiVersion: "2010-12-01" }) .listReceiptFilters({}) .promise(); // Handle promise's fulfilled/rejected states sendPromise .then(function (data) { console.log(data.Filters); }) .catch(function (err) { console.error(err, err.stack); });

Untuk menjalankan contoh, ketik berikut ini di baris perintah. Amazon SES mengembalikan daftar filter.

node ses_listreceiptfilters.js

Kode contoh ini dapat ditemukan di sini GitHub.

Menghapus Filter Alamat IP

Dalam contoh ini, gunakan modul Node.js untuk mengirim email dengan Amazon SES. Buat modul Node.js dengan nama fileses_deletereceiptfilter.js. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya.

Buat objek untuk meneruskan nama filter IP untuk dihapus. Untuk memanggil deleteReceiptFilter metode ini, buat janji untuk menjalankan objek layanan Amazon SES, melewati parameter. Kemudian tangani callback response in the promise.

// Load the AWS SDK for Node.js var AWS = require("aws-sdk"); // Set the region AWS.config.update({ region: "REGION" }); // Create the promise and SES service object var sendPromise = new AWS.SES({ apiVersion: "2010-12-01" }) .deleteReceiptFilter({ FilterName: "NAME" }) .promise(); // Handle promise's fulfilled/rejected states sendPromise .then(function (data) { console.log("IP Filter deleted"); }) .catch(function (err) { console.error(err, err.stack); });

Untuk menjalankan contoh, ketik berikut ini di baris perintah. Filter dihapus dari Amazon SES.

node ses_deletereceiptfilter.js

Kode contoh ini dapat ditemukan di sini GitHub.