Verwenden von Empfangsregeln in Amazon SES - AWS SDK for JavaScript

Hilf uns, das zu verbessernAWS SDK for JavaScriptVersion 3 (V3) -Dokumentation, indem Sie Feedback mithilfe derFeedbackverlinken, oder erstellen Sie ein Issue oder Pull Request aufGitHubaus.

DieAWS SDK for JavaScriptReferenzhandbuch zur V3-APIbeschreibt ausführlich alle API-Operationen für denAWS SDK for JavaScriptVersion 3 (V3).

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:

  • So erstellen und löschen Sie Empfangsregeln.

  • So organisieren Sie Empfangsregeln in Empfangsregelsätze.

Empfangsregeln in Amazon SES geben an, wie mit E-Mails verfahren wird, die für E-Mail-Adressen oder Domänen, deren Eigentümer Sie sind, empfangen werden 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 festgelegt ist, dann führt Amazon SES die in der Empfangsregel festgelegten Aktionen aus.

Um Amazon SES als E-Mail-Receiver zu verwenden, müssen Sie über mindestens einen aktiven verfügenEmpfangsregelsatzaus. Ein Empfangsregelsatz ist eine sortierte Sammlung von Empfangsregeln, die definieren, wie Amazon SES mit E-Mails arbeiten soll, die der Service für Ihre verifizierten Domänen empfängt. Weitere Informationen finden Sie unterErstellen von Empfangsregeln für Amazon-SES-E-Mail-EmpfangundErstellen eines Empfangsregelsatzes für den Amazon-SES-E-Mail-Empfangim Amazon Simple Email Service-Entwicklerhandbuch.

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 für JavaScript zum Erstellen und Verwenden von E-Mail-Vorlagen mithilfe dieser Methoden desSES-Client-Klasse:

Erforderliche Aufgaben

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

Wichtig

Diese Beispiele zeigen, wie Client-Serviceobjekte importiert/exportiert und mit ECMASCRIPT6 (ES6) befehligt werden.

  • Dies erfordert Node.js Version 13.x oder höher. Informationen zum Herunterladen der neuesten Version von Node.js finden Sie unterNode.js Downloads.aus.

  • Wenn Sie die CommonJS-Syntax verwenden möchten, finden Sie unterJavaScript ES6/CommonJS-Syntaxaus.

Erstellen einer Amazon S3 S3-Empfangsregel

Jede Empfangsregel für Amazon SES enthält eine geordnete Liste der 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 übermittelt. Weitere Informationen zu den Aktionen für Empfangsregeln finden Sie unterAktionsoptionenim Amazon Simple Email Service-Entwicklerhandbuch.

Damit Amazon SES E-Mails in einen Amazon S3 S3-Bucket schreiben kann, erstellen Sie eine Bucket-Richtlinie, diePutObjectErlaubnis für Amazon SES. Weitere Informationen zum Erstellen dieser Bucket-Richtlinie finden Sie unterErteilen der Berechtigung an Amazon SES zum Schreiben an Ihren Amazon S3 S3-Bucketim Amazon Simple Email Service-Entwicklerhandbuch.

In diesem Beispiel erstellen Sie mithilfe eines Moduls Node.js eine Empfangsregel in Amazon SES, um empfangene Nachrichten in einem Amazon S3 S3-Bucket zu speichern.

Erstellen eineslibsErstellen Sie ein Modul Node.js mit dem DateinamensesClient.jsaus. Kopieren Sie den unten stehenden Code und fügen Sie ihn ein, wodurch das Amazon SES SES-Clientobjekt erstellt wird. ErsetzenREGIONmit IhrerAWSRegion :

import { SESClient } from "@aws-sdk/client-ses"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create SES service object. const sesClient = new SESClient({ region: REGION }); export { sesClient };

Diesen Beispielcode finden Siehier auf GitHubaus.

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. rufen aufCreateReceiptRuleSetCommand-Methode aufrufen Sie ein Amazon SES SES-Serviceobjekt und übergeben die Parameter.

Anmerkung

ErsetzenS3_BUCKET_NAMEmit dem Namen des Amazon S3 S3-Buckets,EMAIL_ADDRESS | DOMÄNEmit der E-Mail oder Domain,RULE_NAMEmit dem Namen der Regel undRULE_SET_NAMEmit dem Namen des Regelsatzes.

// Import required AWS SDK clients and commands for Node.js import { CreateReceiptRuleCommand } from "@aws-sdk/client-ses"; import { sesClient } from "./libs/sesClient.js"; // Set the parameters const params = { Rule: { Actions: [ { S3Action: { BucketName: "BUCKET_NAME", // S3_BUCKET_NAME ObjectKeyPrefix: "email", }, }, ], Recipients: [ "EMAIL_ADDRESS", // The email addresses, or domain /* more items */ ], Enabled: true | false, Name: "RULE_NAME", // RULE_NAME ScanEnabled: true | false, TlsPolicy: "Optional", }, RuleSetName: "RULE_SET_NAME", // RULE_SET_NAME }; const run = async () => { try { const data = await sesClient.send(new CreateReceiptRuleCommand(params)); console.log("Rule created", data); return data; // For unit tests. } catch (err) { console.log("Error", err.stack); } }; run();

Geben Sie an der Eingabeaufforderung Folgendes ein, um das Beispiel auszuführen. Amazon SES erstellt die Zahlungsregel.

node ses_createreceiptrule.js

Diesen Beispielcode finden Siehier auf GitHubaus.

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 gezeigt, einschließlich der Installation der erforderlichen Clients und Pakete.

Erstellen Sie ein Parameterobjekt, um den Namen der zu löschenden Empfangsregel zu übergeben. rufen aufDeleteReceiptRuleCommand-Methode aufrufen Sie ein Amazon SES SES-Serviceobjekt und übergeben die Parameter.

Anmerkung

ErsetzenRULE_NAMEmit dem Namen der Regel undRULE_SET_NAMEmit dem Namen des Regelsatzes.

// Import required AWS SDK clients and commands for Node.js import { DeleteReceiptRuleCommand } from "@aws-sdk/client-ses"; import { sesClient } from "./libs/sesClient.js"; // Set the deleteReceiptRule params var params = { RuleName: "RULE_NAME", // RULE_NAME RuleSetName: "RULE_SET_NAME", // RULE_SET_NAME }; const run = async () => { try { const data = await sesClient.send(new DeleteReceiptRuleCommand(params)); console.log("Success.", data); return data; // For unit tests. } catch (err) { console.log("Error", err.stack); } }; run();

Geben Sie an der Eingabeaufforderung Folgendes ein, um das Beispiel auszuführen. Amazon SES erstellt die Liste der Empfangsregelsätze.

node ses_deletereceiptrule.js

Diesen Beispielcode finden Siehier auf GitHubaus.

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 gezeigt, einschließlich der Installation der erforderlichen Clients und Pakete.

Erstellen Sie ein Parameterobjekt, um den Namen des neuen Empfangsregelsatzes zu übergeben. rufen aufCreateReceiptRuleSetCommand-Methode aufrufen Sie ein Amazon SES SES-Client-Serviceobjekt und übergeben die Parameter.

Anmerkung

ErsetzenREGIONmit IhrerAWSRegion,RULE_SET_NAMEmit dem Namen des Regelsatzes.

// Import required AWS SDK clients and commands for Node.js import { CreateReceiptRuleSetCommand } from "@aws-sdk/client-ses"; import { sesClient } from "./libs/sesClient.js"; // Set the parameters const params = { RuleSetName: "RULE_SET_NAME" }; //RULE_SET_NAME const run = async () => { try { const data = await sesClient.send(new CreateReceiptRuleSetCommand(params)); console.log( "Success", data ); return data; // For unit tests. } catch (err) { console.log("Error", err.stack); } }; run();

Geben Sie an der Eingabeaufforderung Folgendes ein, um das Beispiel auszuführen. Amazon SES erstellt die Liste der Empfangsregelsätze.

node ses_createreceiptruleset.js

Diesen Beispielcode finden Siehier auf GitHubaus.

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 gezeigt, einschließlich der Installation der erforderlichen Clients und Pakete.

Erstellen Sie ein Objekt, um den Namen des zu löschenden Empfangsregelsatzes zu übergeben. rufen aufDeleteReceiptRuleSetCommand-Methode aufrufen Sie ein Amazon SES SES-Client-Serviceobjekt und übergeben die Parameter.

Anmerkung

ErsetzenRULE_SET_NAMEmit dem Namen des Regelsatzes.

// Import required AWS SDK clients and commands for Node.js import { DeleteReceiptRuleSetCommand } from "@aws-sdk/client-ses"; import { sesClient } from "./libs/sesClient.js"; // Set the parameters const params = { RuleSetName: "RULE_SET_NAME" }; //RULE_SET_NAME const run = async () => { try { const data = await sesClient.send(new DeleteReceiptRuleSetCommand(params)); console.log("Success.", data); return data; // For unit tests. } catch (err) { console.log("Error", err.stack); } }; run();

Geben Sie an der Eingabeaufforderung Folgendes ein, um das Beispiel auszuführen. Amazon SES erstellt die Liste der Empfangsregelsätze.

node ses_deletereceiptruleset.js // If you prefer JavaScript, enter 'node ses_deletereceiptruleset.js'

Diesen Beispielcode finden Siehier auf GitHubaus.