Hilf uns, das zu verbessernAWS SDK for JavaScriptVersion 3 (V3) -Dokumentation, indem Sie Feedback mithilfe derFeedbackverlinken, oder erstellen Sie ein Issue oder Pull Request aufGitHub
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
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:
-
Richten Sie die Projektumgebung ein, um diese Node TypeScript-Beispiele auszuführen, und installieren Sie die erforderlichenAWS SDK for JavaScriptund Drittanbieter-Module. Folgen Sie den Anweisungen aufGitHub
aus. Erstellen Sie eine freigegebene Konfigurationsdatei mit Ihren Anmeldeinformationen. Weitere Informationen zum Bereitstellen einer JSON-Datei mit den Anmeldeinformationen finden Sie unter Laden der Anmeldeinformationen in Node.js aus der Datei für gemeinsam genutzte Anmeldeinformationen.
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, diePutObject
Erlaubnis 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 eineslibs
Erstellen Sie ein Modul Node.js mit dem DateinamensesClient.js
aus. Kopieren Sie den unten stehenden Code und fügen Sie ihn ein, wodurch das Amazon SES SES-Clientobjekt erstellt wird. ErsetzenREGION
mit 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 GitHub
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.
ErsetzenS3_BUCKET_NAME
mit dem Namen des Amazon S3 S3-Buckets,EMAIL_ADDRESS | DOMÄNE
mit der E-Mail oder Domain,RULE_NAME
mit dem Namen der Regel undRULE_SET_NAME
mit 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 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 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.
ErsetzenRULE_NAME
mit dem Namen der Regel undRULE_SET_NAME
mit 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 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 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.
ErsetzenREGION
mit IhrerAWSRegion,RULE_SET_NAME
mit 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 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 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.
ErsetzenRULE_SET_NAME
mit 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 GitHub