Verwenden von Zahlungsregeln in Amazon SES - AWS SDK for JavaScript

Helfen Sie uns, dasAWS SDK for JavaScriptVersion 3 (V3) -Dokumentation durch Feedback unter Verwendung derFeedbackLink oder erstellen Sie ein Problem oder ziehen Sie eine Anfrage anGitHubaus.

DieAWS SDK for JavaScriptReferenzhandbuch zur V3-API-Referenzbeschreibt ausführlich alle API-Operationen für dieAWS 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 Zahlungsregeln in Amazon SES

JavaScript code example that applies to Node.js execution

Dieses Node.js-Codebeispiel zeigt:

  • So erstellen und löschen Sie Empfangsregeln.

  • das Organisieren von Empfangsregeln in Empfangsregelsätze.

Empfangsregeln in Amazon SES geben an, wie mit E-Mails geschehen wird, die für E-Mail-Adressen oder Domänen, die Sie besitzen, 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 einen aktivenEmpfangsregelsatzaus. Ein Empfangsregelsatz ist eine sortierte Sammlung von Empfangsregeln, die definieren, wie Amazon SES mit E-Mails verfahren soll, die der Service für Ihre verifizierten Domänen empfängt. Weitere Informationen finden Sie unterErstellen von Zahlungsregeln für Amazon SES E-Mail-EmpfangundErstellen eines Wareneingangsregelsatzes für 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-Klasse:

Erforderliche Aufgaben

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

  • Richten Sie die Projektumgebung so ein, dass diese Node TypeScript Beispiele ausgeführt werden, und installieren Sie die erforderlicheAWS SDK for JavaScriptDrittanbieter-Module. Folgen Sie den Anweisungen aufGitHubaus.

  • 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 mit gemeinsamen -Anmeld.

Wichtig

In diesen Beispielen wird gezeigt, wie Client-Service-Objekte und Befehle mithilfe von ECMAScript6 (ES6) importiert/exportiert werden.

Erstellen einer Amazon S3 Zahlungsregel

Jede Empfangsregel für Amazon SES enthält eine geordnete Liste der Aktionen. In diesem Beispiel wird eine Empfangsregel mit einer Amazon S3 Aktion erstellt, die die E-Mail-Nachricht einem Amazon S3-Bucket zustellt. Weitere Informationen über Empfangsregelaktionen finden Sie unter unterAktionsoptionenim Amazon Simple Email Service-Entwicklerhandbuch.

Um Amazon SES E-Mails an einen Amazon S3 Bucket zu schreiben, erstellen Sie eine Bucket-Richtlinie, diePutObject-Berechtigung für Amazon SES. Weitere Informationen zum Erstellen dieser Bucket-Richtlinie finden Sie unterErteilen Sie Amazon SES Berechtigung zum Schreiben von Daten in Ihren Amazon S3 Bucketim Amazon Simple Email Service-Entwicklerhandbuch.

In diesem Beispiel verwenden Sie ein Modul Node.js, um eine Empfangsregel in Amazon SES zu erstellen, um empfangene Nachrichten in einem Amazon S3 Bucket zu speichern.

Erstellen eineslibsVerzeichnis und erstellen Sie ein Modul Node.js mit dem DateinamensesClient.jsaus. Kopieren Sie den folgenden Code, und fügen Sie ihn ein, wodurch das Amazon SES Client-Objekt 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 };

Den Beispielcode finden Sie unterauf 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. Um auf derCreateReceiptRuleSetCommand-Methode ein Amazon SES Objekts aufzurufen und übergeben die Parameter.

Anmerkung

ErsetzenS3_BUCKET_NAMEMit dem Namen des Amazon S3 BucketsEMAIL_ADDRESS | DOMAINmit der E-Mail oder Domain,RULE_NAMEDer Name der RegelREGEL_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();

Um das Beispiel auszuführen, geben Sie Folgendes bei der Eingabeaufforderung ein. Amazon SES erstellt die Zahlungsregel.

node ses_createreceiptrule.js

Den Beispielcode finden Sie unterauf 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. Um auf derDeleteReceiptRuleCommand-Methode ein Amazon SES Objekts aufzurufen und übergeben die Parameter.

Anmerkung

ErsetzenRULE_NAMEDer Name der RegelREGEL_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();

Um das Beispiel auszuführen, geben Sie Folgendes bei der Eingabeaufforderung ein. Amazon SES erstellt die Liste der Wareneingangsregelsätze.

node ses_deletereceiptrule.js

Den Beispielcode finden Sie unterauf 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. Um auf derCreateReceiptRuleSetCommand-Methode ein Amazon SES Client-Serviceobjekt aufzurufen und übergeben die Parameter.

Anmerkung

ErsetzenREGIONmit IhrerAWSRegion,REGEL_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();

Um das Beispiel auszuführen, geben Sie Folgendes bei der Eingabeaufforderung ein. Amazon SES erstellt die Liste der Wareneingangsregelsätze.

node ses_createreceiptruleset.js

Den Beispielcode finden Sie unterhier 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. Um auf derDeleteReceiptRuleSetCommand-Methode ein Amazon SES Client-Serviceobjekt aufzurufen und übergeben die Parameter.

Anmerkung

ErsetzenREGEL_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();

Um das Beispiel auszuführen, geben Sie Folgendes bei der Eingabeaufforderung ein. Amazon SES erstellt die Liste der Wareneingangsregelsätze.

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

Den Beispielcode finden Sie unterauf GitHubaus.