Das AWS SDK for JavaScriptV3-API-Referenzhandbuch beschreibt detailliert alle API-Operationen fürAWS SDK for JavaScript Version 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-Identitäten
Dieses Node.js-Codebeispiel zeigt:
So verifizieren Sie E-Mail-Adressen und Domains, die mit Amazon SES verwendet werden.
So weisen Sie Ihren Amazon SES SES-Identitäten eineAWS Identity and Access Management (IAM-) Richtlinie zu.
So listen Sie alle Amazon SES SES-Identitäten für IhrAWS Konto auf.
So löschen Sie Identitäten, die mit Amazon SES verwendet wurden.
Eine Amazon-SES-Identität ist eine E-Mail-Adresse oder Domäne, die Amazon SES zum Senden von E-Mails verwendet. Amazon SES verlangt von Ihnen, Ihre E-Mail-Identitäten zu verifizieren, um zu bestätigen, dass Sie deren Eigentümer sind, und zu verhindern, dass andere sie verwenden.
Einzelheiten zur Verifizierung von E-Mail-Adressen und Domänen in Amazon SES finden Sie unter Verifizieren von E-Mail-Adressen und Domänen in Amazon SES im Entwicklerhandbuch für Amazon Simple Email Service. Informationen zur Sendeautorisierung in Amazon SES finden Sie unter Überblick über die Amazon SES-Versandautorisierung.
Das Szenarios
In diesem Beispiel verwenden Sie eine Reihe von Node.js, um Amazon-SES-Identitäten zu überprüfen und zu verwalten. Die Module Node.js verwenden das SDK für, JavaScript um E-Mail-Adressen und Domänen zu überprüfen, indem sie die folgenden Methoden derSES
Client-Klasse verwenden:
Erforderliche Aufgaben
Zum Einrichten und Ausführen dieses Beispiels müssen Sie zunächst diese Aufgaben abschließen:
-
Richten Sie die Projektumgebung für die Ausführung dieser TypeScript Node-Beispiele ein und installieren Sie die erforderlichen ModuleAWS SDK for JavaScript und Module von Drittanbietern. Folgen Sie den Anweisungen auf GitHub
. 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.
Wichtig
Diese Beispiele zeigen, wie Sie Clientservice-Objekte und Befehle mithilfe von ECMAScript6 (ES6) importieren/exportieren.
Dies erfordert Node.js Version 13.x oder höher. Informationen zum Herunterladen der neuesten Version von Node.js finden Sie unter Herunterladen von Node.js.
. Wenn Sie die CommonJS-Syntax bevorzugen, finden Sie unterJavaScript ES6/CommonJS-Syntax.
Deine Identitäten auflisten
Verwenden Sie in diesem Beispiel ein Modul Node.js, um E-Mail-Adressen und Domänen aufzulisten, die mit Amazon SES verwendet werden sollen.
Erstellen Sie einlibs
Verzeichnis und erstellen Sie ein Modul Node.js mit dem DateinamensesClient.js
. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das Amazon SES-Client-Objekt erstellt wird. Ersetze REGION
durch deineAWS Region.
import { SESClient } from "@aws-sdk/client-ses"; // Set the AWS Region. const REGION = "us-east-1"; // Create SES service object. const sesClient = new SESClient({ region: REGION }); export { sesClient };
Diesen Beispielcode finden Sie hier 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. Um dieListIdentitiesCommand
Methode aufzurufen, rufen Sie ein Amazon SES-Serviceobjekt auf und übergeben Sie das Parameterobjekt.
Diedata
zurückgegebene Datei enthält ein Array von Domänenidentitäten, wie imIdentityType
Parameter angegeben.
Anmerkung
Ersetzen Sie IDENTITY_TYPE
durch den Identitätstyp, der "EmailAddress" oder „Domain“ sein kann.
import { ListIdentitiesCommand } from "@aws-sdk/client-ses"; import { sesClient } from "./libs/sesClient.js"; const createListIdentitiesCommand = () => new ListIdentitiesCommand({ IdentityType: "EmailAddress", MaxItems: 10 }); const run = async () => { const listIdentitiesCommand = createListIdentitiesCommand(); try { return await sesClient.send(listIdentitiesCommand); } catch (err) { console.log("Failed to list identities.", err); return err; } };
Um das Beispiel auszuführen, geben Sie Folgendes an der -Eingabeaufforderung Folgendes ein, um das Beispiel zu verwenden.
node ses_listidentities.js
Diesen Beispielcode finden Sie hier auf GitHub
Verifizieren der Identität einer E-Mail-Adresse
Verwenden Sie in diesem Beispiel ein Modul Node.js, um E-Mail-Absender zu verifizieren, die mit Amazon SES verwendet werden sollen.
Erstellen Sie einlibs
Verzeichnis und erstellen Sie ein Modul Node.js mit dem DateinamensesClient.js
. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das Amazon SES-Client-Objekt erstellt wird. Ersetze REGION
durch deineAWS Region.
import { SESClient } from "@aws-sdk/client-ses"; // Set the AWS Region. const REGION = "us-east-1"; // Create SES service object. const sesClient = new SESClient({ region: REGION }); export { sesClient };
Diesen Beispielcode finden Sie hier 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. Um dieVerifyEmailIdentityCommand
Methode aufzurufen, rufen Sie ein Amazon SES-Clientservice-Objekt auf und übergeben Sie die Parameter.
Anmerkung
Ersetzen Sie ADDRESS@DOMAIN.EXT
durch die E-Mail-Adresse, z. B. 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"; const EMAIL_ADDRESS = "name@example.com"; const createVerifyEmailIdentityCommand = (emailAddress) => { return new VerifyEmailIdentityCommand({ EmailAddress: emailAddress }); }; const run = async () => { const verifyEmailIdentityCommand = createVerifyEmailIdentityCommand(EMAIL_ADDRESS); try { return await sesClient.send(verifyEmailIdentityCommand); } catch (err) { console.log("Failed to verify email identity.", err); return err; } };
Um das Beispiel auszuführen, geben Sie Folgendes an der -Eingabeaufforderung Folgendes ein, um das Beispiel zu verwenden. Die Domain wird zu Amazon SES hinzugefügt, um verifiziert zu werden.
node ses_verifyemailidentity.js
Diesen Beispielcode finden Sie hier auf GitHub
Verifizieren einer Domänenidentität
Verwenden Sie in diesem Beispiel das Modul Node.js, um E-Mail-Domänen zu verifizieren, die mit Amazon SES verwendet werden sollen.
Erstellen Sie einlibs
Verzeichnis und erstellen Sie ein Modul Node.js mit dem DateinamensesClient.js
. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das Amazon SES-Client-Objekt erstellt wird. Ersetze REGION
durch deineAWS Region.
import { SESClient } from "@aws-sdk/client-ses"; // Set the AWS Region. const REGION = "us-east-1"; // Create SES service object. const sesClient = new SESClient({ region: REGION }); export { sesClient };
Diesen Beispielcode finden Sie hier 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. Um dieVerifyDomainIdentityCommand
Methode aufzurufen, rufen Sie ein Amazon SES-Clientservice-Objekt auf und übergeben Sie das Parameterobjekt.
Anmerkung
In diesem Beispiel werden die erforderlichenAWS Service V3-Paketclients und V3-Befehle importiert und verwendet. Diesend
Methode wird in einem async/await-Muster verwendet. Sie können dieses Beispiel stattdessen mit V2-Befehlen erstellen, indem Sie einige geringfügige Änderungen vornehmen. Details hierzu finden Sie unter Verwenden von V3-Befehlen.
Anmerkung
Ersetzen Sie AMI_ID
durch die ID des auszuführenden Amazon Machine Images (AMI) und KEY_PAIR_NAME
des key pair, das der AMI-ID zugewiesen werden soll.
import { VerifyDomainIdentityCommand } from "@aws-sdk/client-ses"; import { getUniqueName, postfix } from "../../libs/utils/util-string.js"; import { sesClient } from "./libs/sesClient.js"; /** * You must have access to the domain's DNS settings to complete the * domain verification process. */ const DOMAIN_NAME = postfix(getUniqueName("Domain"), ".example.com"); const createVerifyDomainIdentityCommand = () => { return new VerifyDomainIdentityCommand({ Domain: DOMAIN_NAME }); }; const run = async () => { const VerifyDomainIdentityCommand = createVerifyDomainIdentityCommand(); try { return await sesClient.send(VerifyDomainIdentityCommand); } catch (err) { console.log("Failed to verify domain.", err); return err; } };
Um das Beispiel auszuführen, geben Sie Folgendes an der -Eingabeaufforderung Folgendes ein, um das Beispiel zu verwenden. Die Domain wird zu Amazon SES hinzugefügt, um verifiziert zu werden.
node ses_verifydomainidentity.js
Diesen Beispielcode finden Sie hier auf GitHub
Löschen von Identitä
Verwenden Sie in diesem Beispiel ein Modul Node.js, um E-Mail-Adressen oder Domains zu löschen, die mit Amazon SES verwendet werden.
Erstellen Sie einlibs
Verzeichnis und erstellen Sie ein Modul Node.js mit dem DateinamensesClient.js
. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das Amazon SES-Client-Objekt erstellt wird. Ersetze REGION
durch deineAWS Region.
import { SESClient } from "@aws-sdk/client-ses"; // Set the AWS Region. const REGION = "us-east-1"; // Create SES service object. const sesClient = new SESClient({ region: REGION }); export { sesClient };
Diesen Beispielcode finden Sie hier 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. Um dieDeleteIdentityCommand
Methode aufzurufen, erstellen Sie einerequest
zum Aufrufen eines Amazon SES-Clientservice-Objekts, wobei die Parameter übergeben werden.
Anmerkung
In diesem Beispiel werden die erforderlichenAWS Service V3-Paketclients und V3-Befehle importiert und verwendet. Diesend
Methode wird in einem async/await-Muster verwendet. Sie können dieses Beispiel stattdessen mit V2-Befehlen erstellen, indem Sie einige geringfügige Änderungen vornehmen. Details hierzu finden Sie unter Verwenden von V3-Befehlen.
Anmerkung
Ersetzen Sie IDENTITY_TYPE
durch den zu löschenden Identitätstyp und IDENTITY_NAME
durch den Namen der zu löschenden Identität.
import { DeleteIdentityCommand } from "@aws-sdk/client-ses"; import { sesClient } from "./libs/sesClient.js"; const IDENTITY_EMAIL = "fake@example.com"; const createDeleteIdentityCommand = (identityName) => { return new DeleteIdentityCommand({ Identity: identityName, }); }; const run = async () => { const deleteIdentityCommand = createDeleteIdentityCommand(IDENTITY_EMAIL); try { return await sesClient.send(deleteIdentityCommand); } catch (err) { console.log("Failed to delete identity.", err); return err; } };
Um das Beispiel auszuführen, geben Sie Folgendes an der -Eingabeaufforderung Folgendes ein, um das Beispiel zu verwenden.
node ses_deleteidentity.js
Diesen Beispielcode finden Sie hier auf GitHub