Verwenden von Empfangsregeln in Amazon SES - AWS SDK für JavaScript

Wir haben das Kommende end-of-support für AWS SDK für JavaScript v2 angekündigt. Wir empfehlen Ihnen, auf AWS SDK für JavaScript Version 3 zu migrieren. Termine, weitere Details und Informationen zur Migration finden Sie in der verlinkten Ankündigung.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden von Empfangsregeln in Amazon SES

JavaScript code example that applies to Node.js execution

Dieses Node.js-Codebeispiel zeigt:

  • das Erstellen und Löschen von Empfangsregeln.

  • das Organisieren von Empfangsregeln in Gruppen von Empfangsregelsätzen.

Die Empfangsregeln in Amazon SES legen fest, was mit E-Mails geschehen soll, die Sie für E-Mail-Adressen oder Domains erhalten haben, die Sie besitzen. Eine Empfangsregel enthält eine Bedingung und eine sortierte Liste mit Aktionen. Wenn der Empfänger einer eingehenden E-Mail mit einem Empfänger übereinstimmt, der in den Bedingungen für die Empfangsregel angegeben ist, führt Amazon SES die in der Empfangsregel angegebenen Aktionen aus.

Um Amazon SES als E-Mail-Empfänger verwenden zu können, müssen Sie mindestens eine aktive Empfangsregel festgelegt haben. Ein Empfangsregelsatz ist eine geordnete Sammlung von Empfangsregeln, die festlegen, was Amazon SES mit E-Mails tun soll, die Amazon SES über Ihre verifizierten Domains empfängt. Weitere Informationen finden Sie unter Erstellen von Empfangsregeln für den Amazon SES SES-E-Mail-Empfang und Erstellen eines Empfangsregelsatzes für den Amazon SES SES-E-Mail-Empfang im Amazon Simple Email Service Developer Guide.

Das Szenario

In diesem Beispiel werden mehrere Node.js-Module verwendet, um E-Mails auf verschiedene Weisen zu senden. Die Module Node.js verwenden das SDK JavaScript , um E-Mail-Vorlagen mit den folgenden Methoden der AWS.SES Client-Klasse zu erstellen und zu verwenden:

Erforderliche Aufgaben

Zum Einrichten und Ausführen dieses Beispiels müssen Sie zunächst diese Aufgaben abschließen:

Eine Amazon S3 S3-Empfangsregel erstellen

Jede Empfangsregel für Amazon SES enthält eine geordnete Liste von Aktionen. In diesem Beispiel wird eine Empfangsregel mit einer Amazon S3 S3-Aktion erstellt, die die E-Mail-Nachricht an einen Amazon S3 S3-Bucket zustellt. Einzelheiten zu Aktionen mit Empfangsregeln finden Sie unter Aktionsoptionen im Amazon Simple Email Service Developer Guide.

Damit Amazon SES E-Mails in einen Amazon S3 S3-Bucket schreiben kann, erstellen Sie eine Bucket-Richtlinie, die Amazon SES die PutObject Erlaubnis erteilt. Informationen zur Erstellung dieser Bucket-Richtlinie finden Sie unter Erteilen Sie Amazon SES Permission to Write to Your Amazon S3 Bucket im Amazon Simple Email Service Developer Guide.

Verwenden Sie in diesem Beispiel ein Modul Node.js, um eine Empfangsregel in Amazon SES zu erstellen, um empfangene Nachrichten in einem Amazon S3 S3-Bucket zu speichern. Erstellen Sie ein Node.js-Modul mit dem Dateinamen ses_createreceiptrule.js. Konfigurieren Sie das SDK wie zuvor dargestellt.

Erstellen Sie ein Parameterobjekt, um die erforderlichen Werte zum Erstellen des Empfangsregelsatzes zu übergeben. Um die createReceiptRuleSet-Methode aufzurufen, erstellen Sie ein Promise für den Aufruf eines Amazon SES-Serviceobjekts und übergeben die Parameter. Verarbeiten Sie anschließend die response im Promise-Callback.

// 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); });

Um das Beispiel auszuführen, geben Sie Folgendes in der Befehlszeile ein. Amazon SES erstellt die Empfangsregel.

node ses_createreceiptrule.js

Diesen Beispielcode finden Sie hier auf GitHub.

Löschen einer Empfangsregel

In diesem Beispiel verwenden Sie ein Node.js-Modul zum Senden von E-Mail mit Amazon SES. Erstellen Sie ein Node.js-Modul mit dem Dateinamen ses_deletereceiptrule.js. Konfigurieren Sie das SDK wie zuvor dargestellt.

Erstellen Sie ein Parameterobjekt, um den Namen der zu löschenden Empfangsregel zu übergeben. Um die deleteReceiptRule-Methode aufzurufen, erstellen Sie ein Promise für den Aufruf eines Amazon SES-Serviceobjekts und übergeben die Parameter. Verarbeiten Sie anschließend die response im Promise-Callback.

// 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); });

Um das Beispiel auszuführen, geben Sie Folgendes in der Befehlszeile ein. Amazon SES erstellt die Liste der Empfangsregelsätze.

node ses_deletereceiptrule.js

Diesen Beispielcode finden Sie hier auf GitHub.

Erstellen eines Empfangsregelsatzes

In diesem Beispiel verwenden Sie ein Node.js-Modul zum Senden von E-Mail mit Amazon SES. Erstellen Sie ein Node.js-Modul mit dem Dateinamen ses_createreceiptruleset.js. Konfigurieren Sie das SDK wie zuvor dargestellt.

Erstellen Sie ein Parameterobjekt, um den Namen des neuen Empfangsregelsatzes zu übergeben. Um die createReceiptRuleSet-Methode aufzurufen, erstellen Sie ein Promise für den Aufruf eines Amazon SES-Serviceobjekts und übergeben die Parameter. Verarbeiten Sie anschließend die response im Promise-Callback.

// 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); });

Um das Beispiel auszuführen, geben Sie Folgendes in der Befehlszeile ein. Amazon SES erstellt die Liste der Empfangsregelsätze.

node ses_createreceiptruleset.js

Diesen Beispielcode finden Sie hier auf GitHub.

Löschen eines Empfangsregelsatzes

In diesem Beispiel verwenden Sie ein Node.js-Modul zum Senden von E-Mail mit Amazon SES. Erstellen Sie ein Node.js-Modul mit dem Dateinamen ses_deletereceiptruleset.js. Konfigurieren Sie das SDK wie zuvor dargestellt.

Erstellen Sie ein Objekt, um den Namen des zu löschenden Empfangsregelsatzes zu übergeben. Um die deleeReceiptRuleSet-Methode aufzurufen, erstellen Sie ein Promise für den Aufruf eines Amazon SES-Serviceobjekts und übergeben die Parameter. Verarbeiten Sie anschließend die response im Promise-Callback.

// 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); });

Um das Beispiel auszuführen, geben Sie Folgendes in der Befehlszeile ein. Amazon SES erstellt die Liste der Empfangsregelsätze.

node ses_deletereceiptruleset.js

Diesen Beispielcode finden Sie hier auf GitHub.