Verwalten von Amazon SES SES-Identitäten - 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.

Verwalten von Amazon SES SES-Identitäten

JavaScript code example that applies to Node.js execution

Dieses Node.js-Codebeispiel zeigt:

  • das Verifizieren der mit Amazon SES verwendeten E-Mail-Adressen und Domänen.

  • So weisen Sie einAWS Identity and Access Management(IAM) -Richtlinie für Ihre Amazon SES SES-Identitäten.

  • So listen Sie alle Amazon SES SES-Identitäten für Ihre aufAWSKonto.

  • Löschen von Identitäten, die mit Amazon SES verwendet werden.

Ein Amazon SESIdentitätist eine E-Mail-Adresse oder Domäne, die Amazon SES zum Senden von E-Mail verwendet. Bei Amazon SES müssen Sie Ihre E-Mail-Identitäten verifizieren, bestätigen, dass Sie selbst deren Eigentümer sind, und verhindert, dass sie von anderen Personen verwendet werden.

Weitere Informationen dazu, wie Sie E-Mail-Adressen und Domänen in Amazon SES verifizieren, finden Sie unter.Verifizieren von E-Mail-Adressen und Domänen in Amazon SESim Amazon Simple Email Service-Entwicklerhandbuch. Weitere Informationen zum Senden der Autorisierung in Amazon SES finden Sie unterÜbersicht über die Amazon-SES-Sendeautorisierungaus.

Das Szenario

In diesem Beispiel verwenden Sie eine Reihe von Modulen von Node.js zum Verifizieren und Verwalten von Amazon SES SES-Identitäten. Die Module Node.js verwenden das SDK für JavaScript zum Verifizieren von E-Mail-Adressen und Domänen 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.

Auflisten von Identitäten

In diesem Beispiel listen Sie mithilfe eines Moduls Node.js E-Mail-Adressen und Domänen auf, die mit Amazon SES verwendet werden.

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_listidentities.js. Konfigurieren Sie das SDK wie zuvor gezeigt, einschließlich der Installation der erforderlichen Clients und Pakete.

Erstellen Sie ein Objekt, um den IdentityType und andere Parameter für die ListIdentitiesCommand-Methode der SES-Client-Klasse zu übergeben. rufen aufListIdentitiesCommand-Methode aufrufen Sie ein Amazon SES SES-Serviceobjekt und übergeben Sie das Parameterobjekt.

Diedatazurückgegebenen enthält ein Array von Domänen-Identitäten, die von derIdentityType-Parameter.

Anmerkung

ErsetzenIDENTITY_TYPEmit dem Identitätstyp, der „EmailAddress“ oder „Domain“ sein kann.

// Import required AWS SDK clients and commands for Node.js import { ListIdentitiesCommand } from "@aws-sdk/client-ses"; import { sesClient } from "./libs/sesClient.js"; // Set the parameters var params = { IdentityType: "EmailAddress", // IDENTITY_TYPE: "EmailAddress' or 'Domain' MaxItems: 10, }; const run = async () => { try { const data = await sesClient.send(new ListIdentitiesCommand(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.

node ses_listidentities.js

Diesen Beispielcode finden Siehier auf GitHubaus.

Verifizieren einer E-Mail-Adressidentität

In diesem Beispiel verifizieren Sie mithilfe eines Moduls Node.js die E-Mail-Absender, die mit Amazon SES verwendet werden.

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_verifyemailidentity.js. Konfigurieren Sie das SDK wie zuvor gezeigt, einschließlich des Herunterladens der erforderlichen Clients und Pakete.

Erstellen Sie ein Objekt mit dem sie den EmailAddress-Parameter an die VerifyEmailIdentityCommand-Methode der SES-Client-Klasse übergeben. rufen aufVerifyEmailIdentityCommand-Methode aufrufen Sie ein Amazon SES SES-Client-Serviceobjekt und übergeben die Parameter.

Anmerkung

ErsetzenADDRESS@DOMAIN.EXTmit der E-Mail-Adresse wie name@example.com.

// Import required AWS SDK clients and commands for Node.js import { VerifyEmailIdentityCommand } from "@aws-sdk/client-ses"; import { sesClient } from "./libs/sesClient.js"; // Set the parameters const params = { EmailAddress: "ADDRESS@DOMAIN.EXT" }; //ADDRESS@DOMAIN.EXT; e.g., name@example.com const run = async () => { try { const data = await sesClient.send(new VerifyEmailIdentityCommand(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. Die Domäne wird Amazon SES hinzugefügt, damit sie verifiziert werden kann.

node ses_verifyemailidentity.js

Diesen Beispielcode finden Siehier auf GitHubaus.

Verifizieren einer Domänen-Identität

In diesem Beispiel verifizieren Sie mithilfe eines Moduls Node.js E-Mail-Domänen, die mit Amazon SES verwendet werden.

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_verifydomainidentity.js. Konfigurieren Sie das SDK wie zuvor gezeigt, einschließlich der Installation der erforderlichen Clients und Pakete.

Erstellen Sie ein Objekt mit dem sie den Domain-Parameter an die VerifyDomainIdentityCommand-Methode der SES-Client-Klasse übergeben. rufen aufVerifyDomainIdentityCommand-Methode aufrufen Sie ein Amazon SES SES-Client-Serviceobjekt und übergeben Sie das Parameterobjekt.

Anmerkung

In diesem Beispiel wird das erforderliche importiert und verwendetAWSService V3-Paket-Clients, V3-Befehle und verwendetsend-Methode in einem async/await-Muster. Sie können dieses Beispiel stattdessen mit V2-Befehlen erstellen, indem Sie einige kleinere Änderungen vornehmen. Details hierzu finden Sie unter Verwenden von V3-Befehlen.

Anmerkung

ErsetzenAMI_IDmit der ID des auszuführenden Amazon Machine Image (AMI) undKEY_PAIR_NAMEdes key pair, das der AMI-ID zugewiesen werden soll.

// Import required AWS SDK clients and commands for Node.js import { VerifyDomainIdentityCommand, } from "@aws-sdk/client-ses"; import { sesClient } from "./libs/sesClient.js"; // Set the parameters const params = { Domain: "DOMAIN_NAME" }; //DOMAIN_NAME const run = async () => { try { const data = await sesClient.send(new VerifyDomainIdentityCommand(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. Die Domäne wird Amazon SES hinzugefügt, damit sie verifiziert werden kann.

node ses_verifydomainidentity.js

Diesen Beispielcode finden Siehier auf GitHubaus.

Löschen von Identitäten

In diesem Beispiel löschen Sie mithilfe eines Moduls Node.js E-Mail-Adressen oder Domänen, die mit Amazon SES verwendet werden.

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_deleteidentity.js. Konfigurieren Sie das SDK wie zuvor gezeigt, einschließlich der Installation der erforderlichen Clients und Pakete.

Erstellen Sie ein Objekt mit dem sie den Identity-Parameter an die DeleteIdentityCommand-Methode der SES-Client-Klasse übergeben. rufen aufDeleteIdentityCommandMethode, erstellen Sie einerequestfür den Aufruf eines Amazon SES SES-Client-Serviceobjekts und übergeben die Parameter.

Anmerkung

In diesem Beispiel wird das erforderliche importiert und verwendetAWSService V3-Paket-Clients, V3-Befehle und verwendetsend-Methode in einem async/await-Muster. Sie können dieses Beispiel stattdessen mit V2-Befehlen erstellen, indem Sie einige kleinere Änderungen vornehmen. Details hierzu finden Sie unter Verwenden von V3-Befehlen.

Anmerkung

ErsetzenIDENTITY_TYPEmit dem zu löschenden Identitätstyp undIDENTITY_NAMEmit dem Namen der zu löschenden Identität.

// Import required AWS SDK clients and commands for Node.js import { DeleteIdentityCommand } from "@aws-sdk/client-ses"; import { sesClient } from "./libs/sesClient.js"; // Set the parameters const params = { IdentityType: "IDENTITY_TYPE", // IDENTITY_TYPE - i.e., 'EmailAddress' or 'Domain' Identity: "IDENTITY_NAME", }; // IDENTITY_NAME const run = async () => { try { const data = await sesClient.send(new DeleteIdentityCommand(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.

node ses_deleteidentity.js

Diesen Beispielcode finden Siehier auf GitHubaus.