Menggunakan Aturan Tanda Terima 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 Aturan Tanda Terima di Amazon SES

JavaScript code example that applies to Node.js execution

Contoh kode Node.js ini menunjukkan:

  • Buat dan hapus aturan tanda terima.

  • Atur aturan tanda terima ke dalam set aturan penerimaan.

Aturan tanda terima di Amazon SES menentukan apa yang harus dilakukan dengan email yang diterima untuk alamat email atau domain yang Anda miliki. Aturan tanda terima berisi kondisi dan daftar tindakan yang diurutkan. Jika penerima email masuk cocok dengan penerima yang ditentukan dalam kondisi aturan tanda terima, Amazon SES akan melakukan tindakan yang ditentukan oleh aturan tanda terima.

Untuk menggunakan Amazon SES sebagai penerima email Anda, Anda harus memiliki setidaknya satu aturan tanda terima aktif yang ditetapkan. Kumpulan aturan tanda terima adalah kumpulan aturan tanda terima yang diurutkan yang menentukan apa yang harus dilakukan Amazon SES dengan email yang diterimanya di seluruh domain terverifikasi Anda. Untuk informasi selengkapnya, lihat Membuat Aturan Tanda Terima untuk Menerima Email Amazon SES dan Membuat Aturan Tanda Terima yang Ditetapkan untuk 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:

Membuat Aturan Tanda Terima Amazon S3

Setiap aturan tanda terima untuk Amazon SES berisi daftar tindakan yang diurutkan. Contoh ini membuat aturan tanda terima dengan tindakan Amazon S3, yang mengirimkan pesan email ke bucket Amazon S3. Untuk detail tentang tindakan aturan penerimaan, lihat Opsi Tindakan di Panduan Pengembang Layanan Email Sederhana Amazon.

Agar Amazon SES dapat menulis email ke bucket Amazon S3, buat kebijakan bucket yang memberikan PutObject izin ke Amazon SES. Untuk informasi tentang cara membuat kebijakan bucket ini, lihat Berikan Izin Amazon SES untuk Menulis ke Bucket Amazon S3 Anda di Panduan Pengembang Layanan Email Sederhana Amazon.

Dalam contoh ini, gunakan modul Node.js untuk membuat aturan tanda terima di Amazon SES untuk menyimpan pesan yang diterima di bucket Amazon S3. Buat modul Node.js dengan nama fileses_createreceiptrule.js. Konfigurasikan SDK seperti yang ditunjukkan sebelumnya.

Buat objek parameter untuk meneruskan nilai yang diperlukan untuk membuat set aturan penerimaan. Untuk memanggil createReceiptRuleSet 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 createReceiptRule params var params = { Rule: { Actions: [ { S3Action: { BucketName: "S3_BUCKET_NAME", ObjectKeyPrefix: "email", }, }, ], Recipients: [ "DOMAIN | EMAIL_ADDRESS", /* more items */ ], Enabled: true | false, Name: "RULE_NAME", ScanEnabled: true | false, TlsPolicy: "Optional", }, RuleSetName: "RULE_SET_NAME", }; // Create the promise and SES service object var newRulePromise = new AWS.SES({ apiVersion: "2010-12-01" }) .createReceiptRule(params) .promise(); // Handle promise's fulfilled/rejected states newRulePromise .then(function (data) { console.log("Rule created"); }) .catch(function (err) { console.error(err, err.stack); });

Untuk menjalankan contoh, ketik berikut ini di baris perintah. Amazon SES membuat aturan tanda terima.

node ses_createreceiptrule.js

Kode contoh ini dapat ditemukan di sini GitHub.

Menghapus Aturan Tanda Terima

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

Buat objek parameter untuk meneruskan nama untuk menghapus aturan tanda terima. Untuk memanggil deleteReceiptRule 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 deleteReceiptRule params var params = { RuleName: "RULE_NAME" /* required */, RuleSetName: "RULE_SET_NAME" /* required */, }; // Create the promise and SES service object var newRulePromise = new AWS.SES({ apiVersion: "2010-12-01" }) .deleteReceiptRule(params) .promise(); // Handle promise's fulfilled/rejected states newRulePromise .then(function (data) { console.log("Receipt Rule Deleted"); }) .catch(function (err) { console.error(err, err.stack); });

Untuk menjalankan contoh, ketik berikut ini di baris perintah. Amazon SES membuat daftar set aturan tanda terima.

node ses_deletereceiptrule.js

Kode contoh ini dapat ditemukan di sini GitHub.

Membuat Set Aturan Tanda Terima

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

Buat objek parameter untuk meneruskan nama untuk set aturan penerimaan baru. Untuk memanggil createReceiptRuleSet 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 newRulePromise = new AWS.SES({ apiVersion: "2010-12-01" }) .createReceiptRuleSet({ RuleSetName: "NAME" }) .promise(); // Handle promise's fulfilled/rejected states newRulePromise .then(function (data) { console.log(data); }) .catch(function (err) { console.error(err, err.stack); });

Untuk menjalankan contoh, ketik berikut ini di baris perintah. Amazon SES membuat daftar set aturan tanda terima.

node ses_createreceiptruleset.js

Kode contoh ini dapat ditemukan di sini GitHub.

Menghapus Set Aturan Tanda Terima

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

Buat objek untuk meneruskan nama untuk aturan tanda terima yang ditetapkan untuk dihapus. Untuk memanggil deleeReceiptRuleSet 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 newRulePromise = new AWS.SES({ apiVersion: "2010-12-01" }) .deleteReceiptRuleSet({ RuleSetName: "NAME" }) .promise(); // Handle promise's fulfilled/rejected states newRulePromise .then(function (data) { console.log(data); }) .catch(function (err) { console.error(err, err.stack); });

Untuk menjalankan contoh, ketik berikut ini di baris perintah. Amazon SES membuat daftar set aturan tanda terima.

node ses_deletereceiptruleset.js

Kode contoh ini dapat ditemukan di sini GitHub.