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.
Verwalten von Amazon SES SES-Identitäten
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:
-
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.
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 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_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.
Diedata
zurückgegebenen enthält ein Array von Domänen-Identitäten, die von derIdentityType
-Parameter.
ErsetzenIDENTITY_TYPE
mit 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 GitHub
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 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_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.
ErsetzenADDRESS@DOMAIN.EXT
mit 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 GitHub
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 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_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.
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.
ErsetzenAMI_ID
mit der ID des auszuführenden Amazon Machine Image (AMI) undKEY_PAIR_NAME
des 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 GitHub
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 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_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 aufDeleteIdentityCommand
Methode, erstellen Sie einerequest
für den Aufruf eines Amazon SES SES-Client-Serviceobjekts und übergeben die Parameter.
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.
ErsetzenIDENTITY_TYPE
mit dem zu löschenden Identitätstyp undIDENTITY_NAME
mit 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 GitHub