Weitere AWS SDK Beispiele sind im Repo AWS Doc SDK Examples
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.
SESAmazon-Beispiele mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface mit Amazon Aktionen ausführen und allgemeine Szenarien implementierenSES.
Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Aktionen zeigen Ihnen zwar, wie Sie einzelne Servicefunktionen aufrufen, aber Sie können Aktionen im Kontext der zugehörigen Szenarien sehen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, in dem Sie Anweisungen zum Einrichten und Ausführen des Codes im Kontext finden.
Themen
Aktionen
Das folgende Codebeispiel zeigt die Verwendungdelete-identity
.
- AWS CLI
-
So löschen Sie eine Identität
Im folgenden Beispiel wird der
delete-identity
Befehl verwendet, um eine Identität aus der Liste der bei Amazon SES verifizierten Identitäten zu löschen:aws ses delete-identity --identity
user@example.com
Weitere Informationen zu verifizierten Identitäten finden Sie unter Verifying Email Addresses and Domains in Amazon SES im Amazon Simple Email Service Developer Guide.
-
APIEinzelheiten finden Sie DeleteIdentity
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungget-identity-dkim-attributes
.
- AWS CLI
-
Um die Amazon SES DKIM Easy-Attribute für eine Liste von Identitäten abzurufen
Im folgenden Beispiel wird der
get-identity-dkim-attributes
Befehl verwendet, um die Amazon SES DKIM Easy-Attribute für eine Liste von Identitäten abzurufen:aws ses get-identity-dkim-attributes --identities
"example.com"
"user@example.com"
Ausgabe:
{ "DkimAttributes": { "example.com": { "DkimTokens": [ "EXAMPLEjcs5xoyqytjsotsijas7236gr", "EXAMPLEjr76cvoc6mysspnioorxsn6ep", "EXAMPLEkbmkqkhlm2lyz77ppkulerm4k" ], "DkimEnabled": true, "DkimVerificationStatus": "Success" }, "user@example.com": { "DkimEnabled": false, "DkimVerificationStatus": "NotStarted" } } }
Wenn Sie diesen Befehl mit einer Identität aufrufen, die Sie noch nie zur Überprüfung eingereicht haben, wird diese Identität nicht in der Ausgabe angezeigt.
Weitere Informationen zu Easy DKIM finden Sie unter Easy DKIM in Amazon SES im Amazon Simple Email Service Developer Guide.
-
APIEinzelheiten finden Sie GetIdentityDkimAttributes
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungget-identity-notification-attributes
.
- AWS CLI
-
Um die SES Amazon-Benachrichtigungsattribute für eine Liste von Identitäten abzurufen
Im folgenden Beispiel wird der
get-identity-notification-attributes
Befehl verwendet, um die SES Amazon-Benachrichtigungsattribute für eine Liste von Identitäten abzurufen:aws ses get-identity-notification-attributes --identities
"user1@example.com"
"user2@example.com"
Ausgabe:
{ "NotificationAttributes": { "user1@example.com": { "ForwardingEnabled": false, "ComplaintTopic": "arn:aws:sns:us-east-1:EXAMPLE65304:MyTopic", "BounceTopic": "arn:aws:sns:us-east-1:EXAMPLE65304:MyTopic", "DeliveryTopic": "arn:aws:sns:us-east-1:EXAMPLE65304:MyTopic" }, "user2@example.com": { "ForwardingEnabled": true } } }
Dieser Befehl gibt den Status der Weiterleitung von E-Mail-Feedback und gegebenenfalls die Amazon-Ressourcennamen (ARNs) der SNS Amazon-Themen zurück, an die Bounce-, Beschwerde- und Lieferbenachrichtigungen gesendet werden.
Wenn Sie diesen Befehl mit einer Identität aufrufen, die Sie noch nie zur Überprüfung eingereicht haben, wird diese Identität nicht in der Ausgabe angezeigt.
Weitere Informationen zu Benachrichtigungen finden Sie unter Using Notifications With Amazon SES im Amazon Simple Email Service Developer Guide.
-
APIEinzelheiten finden Sie GetIdentityNotificationAttributes
unter AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungget-identity-verification-attributes
.
- AWS CLI
-
Um den SES Amazon-Bestätigungsstatus für eine Liste von Identitäten abzurufen
Im folgenden Beispiel wird der
get-identity-verification-attributes
Befehl verwendet, um den SES Amazon-Bestätigungsstatus für eine Liste von Identitäten abzurufen:aws ses get-identity-verification-attributes --identities
"user1@example.com"
"user2@example.com"
Ausgabe:
{ "VerificationAttributes": { "user1@example.com": { "VerificationStatus": "Success" }, "user2@example.com": { "VerificationStatus": "Pending" } } }
Wenn Sie diesen Befehl mit einer Identität aufrufen, die Sie noch nie zur Überprüfung eingereicht haben, wird diese Identität nicht in der Ausgabe angezeigt.
Weitere Informationen zu verifizierten Identitäten finden Sie unter Verifying Email Addresses and Domains in Amazon SES im Amazon Simple Email Service Developer Guide.
-
APIEinzelheiten finden Sie GetIdentityVerificationAttributes
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungget-send-quota
.
- AWS CLI
-
So erhalten Sie Ihre SES Amazon-Sendelimits
Im folgenden Beispiel wird der
get-send-quota
Befehl verwendet, um Ihre SES Amazon-Sendelimits zurückzugeben:aws ses get-send-quota
Ausgabe:
{ "Max24HourSend": 200.0, "SentLast24Hours": 1.0, "MaxSendRate": 1.0 }
Max24 HourSend ist Ihr Versandkontingent, das ist die maximale Anzahl von E-Mails, die Sie in einem Zeitraum von 24 Stunden versenden können. Die Sendequote bezieht sich auf einen gleitenden Zeitraum. Jedes Mal, wenn Sie versuchen, eine E-Mail zu senden, SES überprüft Amazon, wie viele E-Mails Sie in den letzten 24 Stunden gesendet haben. Solange die Gesamtzahl der von Ihnen gesendeten E-Mails unter Ihrer Quote liegt, wird Ihre Sendeanforderung akzeptiert und Ihre E-Mail versendet.
SentLast24 Stunden ist die Anzahl der E-Mails, die Sie in den letzten 24 Stunden gesendet haben.
MaxSendRate ist die maximale Anzahl von E-Mails, die Sie pro Sekunde versenden können.
Beachten Sie, dass Sendelimits auf der Anzahl der Empfänger, nicht der Anzahl der Nachrichten basieren. Beispielsweise zählt eine E-Mail mit 10 Empfängern bei Ihrem Sendekontingent als 10.
Weitere Informationen finden Sie unter Verwaltung Ihrer SES Amazon-Sendelimits im Amazon Simple Email Service Developer Guide.
-
APIEinzelheiten finden Sie GetSendQuota
unter AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungget-send-statistics
.
- AWS CLI
-
Um Ihre SES Amazon-Versandstatistiken abzurufen
Im folgenden Beispiel wird der
get-send-statistics
Befehl verwendet, um Ihre SES Amazon-Versandstatistiken zurückzugebenaws ses get-send-statistics
Ausgabe:
{ "SendDataPoints": [ { "Complaints": 0, "Timestamp": "2013-06-12T19:32:00Z", "DeliveryAttempts": 2, "Bounces": 0, "Rejects": 0 }, { "Complaints": 0, "Timestamp": "2013-06-12T00:47:00Z", "DeliveryAttempts": 1, "Bounces": 0, "Rejects": 0 } ] }
Das Ergebnis ist eine Liste von Datenpunkten, die die Sendeaktivitäten der letzten zwei Wochen repräsentieren. Jeder Datenpunkt in der Liste enthält Statistiken für ein 15-Minuten-Intervall.
In diesem Beispiel gibt es nur zwei Datenpunkte, da die einzigen E-Mails, die der Benutzer in den letzten zwei Wochen gesendet hat, innerhalb von zwei 15-Minuten-Intervallen fielen.
Weitere Informationen finden Sie unter Überwachung Ihrer SES Amazon-Nutzungsstatistiken im Amazon Simple Email Service Developer Guide.
-
APIEinzelheiten finden Sie GetSendStatistics
unter AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendunglist-identities
.
- AWS CLI
-
Um alle Identitäten (E-Mail-Adressen und Domains) für ein bestimmtes AWS Konto aufzulisten
Im folgenden Beispiel wird der
list-identities
Befehl verwendet, um alle Identitäten aufzulisten, die zur Überprüfung bei Amazon SES eingereicht wurden:aws ses list-identities
Ausgabe:
{ "Identities": [ "user@example.com", "example.com" ] }
Die zurückgegebene Liste enthält alle Identitäten unabhängig vom Überprüfungsstatus (verifiziert, Überprüfung ausstehend, fehlgeschlagen usw.).
In diesem Beispiel werden E-Mail-Adressen und Domains zurückgegeben, weil wir den Parameter identity-type nicht angegeben haben.
Weitere Informationen zur Überprüfung finden Sie unter Verifizieren von E-Mail-Adressen und Domains bei Amazon SES im Amazon Simple Email Service Developer Guide.
-
APIEinzelheiten finden Sie ListIdentities
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungsend-email
.
- AWS CLI
-
Um eine formatierte E-Mail mit Amazon zu senden SES
Im folgenden Beispiel wird der
send-email
-Befehl verwendet, um eine formatierte E-Mail zu senden:aws ses send-email --from
sender@example.com
--destinationfile://destination.json
--messagefile://message.json
Ausgabe:
{ "MessageId": "EXAMPLEf3a5efcd1-51adec81-d2a4-4e3f-9fe2-5d85c1b23783-000000" }
Das Ziel und die Nachricht sind JSON Datenstrukturen, die in JSON-Dateien im aktuellen Verzeichnis gespeichert sind. Es handelt sich dabei um die folgenden Dateien:
destination.json
:{ "ToAddresses": ["recipient1@example.com", "recipient2@example.com"], "CcAddresses": ["recipient3@example.com"], "BccAddresses": [] }
message.json
:{ "Subject": { "Data": "Test email sent using the AWS CLI", "Charset": "UTF-8" }, "Body": { "Text": { "Data": "This is the message body in text format.", "Charset": "UTF-8" }, "Html": { "Data": "This message body contains HTML formatting. It can, for example, contain links like this one: <a class=\"ulink\" href=\"http://docs.aws.amazon.com/ses/latest/DeveloperGuide\" target=\"_blank\">Amazon SES Developer Guide</a>.", "Charset": "UTF-8" } } }
Ersetzen Sie die Absender- und Empfänger-E-Mail-Adressen durch die Adressen, die Sie verwenden möchten. Beachten Sie, dass die E-Mail-Adresse des Absenders bei Amazon verifiziert werden mussSES. Bis Ihnen Produktionszugriff auf Amazon gewährt wirdSES, müssen Sie auch die E-Mail-Adresse jedes Empfängers verifizieren, es sei denn, es handelt sich bei dem Empfänger um den SES Amazon-Postfachsimulator. Weitere Informationen zur Überprüfung finden Sie unter Verifizieren von E-Mail-Adressen und Domains bei Amazon SES im Amazon Simple Email Service Developer Guide.
Die Nachrichten-ID in der Ausgabe gibt an, dass der Aufruf von send-email erfolgreich war.
Wenn Sie die E-Mail nicht erhalten, überprüfen Sie Ihr Junk-Postfach.
Weitere Informationen zum Senden formatierter E-Mails finden Sie unter Senden formatierter E-Mails über Amazon SES API im Amazon Simple Email Service Developer Guide.
-
APIEinzelheiten finden Sie SendEmail
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungsend-raw-email
.
- AWS CLI
-
Um eine Roh-E-Mail mit Amazon zu versenden SES
Im folgenden Beispiel wird der
send-raw-email
Befehl verwendet, um eine E-Mail mit einem TXT Anhang zu senden:aws ses send-raw-email --raw-message
file://message.json
Ausgabe:
{ "MessageId": "EXAMPLEf3f73d99b-c63fb06f-d263-41f8-a0fb-d0dc67d56c07-000000" }
Die Rohnachricht ist eine JSON Datenstruktur, die in einer Datei mit dem Namen
message.json
im aktuellen Verzeichnis gespeichert ist. Sie enthält Folgendes:{ "Data": "From: sender@example.com\nTo: recipient@example.com\nSubject: Test email sent using the AWS CLI (contains an attachment)\nMIME-Version: 1.0\nContent-type: Multipart/Mixed; boundary=\"NextPart\"\n\n--NextPart\nContent-Type: text/plain\n\nThis is the message body.\n\n--NextPart\nContent-Type: text/plain;\nContent-Disposition: attachment; filename=\"attachment.txt\"\n\nThis is the text in the attachment.\n\n--NextPart--" }
Wie Sie sehen können, ist „Data“ eine lange Zeichenfolge, die den gesamten E-Mail-Rohinhalt im MIME Format enthält, einschließlich eines Anhangs mit dem Namen attachment.txt.
Ersetzen Sie sender@example.com und recipient@example.com durch die Adressen, die Sie verwenden möchten. Beachten Sie, dass die E-Mail-Adresse des Absenders bei Amazon verifiziert werden mussSES. Bis Ihnen Produktionszugriff auf Amazon gewährt wirdSES, müssen Sie auch die E-Mail-Adresse des Empfängers verifizieren, es sei denn, der Empfänger ist der SES Amazon-Postfachsimulator. Weitere Informationen zur Überprüfung finden Sie unter Verifizieren von E-Mail-Adressen und Domains bei Amazon SES im Amazon Simple Email Service Developer Guide.
Die Nachrichten-ID in der Ausgabe gibt an, dass der Aufruf von erfolgreich send-raw-email war.
Wenn Sie die E-Mail nicht erhalten, überprüfen Sie Ihr Junk-Postfach.
Weitere Informationen zum Senden von Roh-E-Mails finden Sie unter Senden von Roh-E-Mails über Amazon SES API im Amazon Simple Email Service Developer Guide.
-
APIEinzelheiten finden Sie SendRawEmail
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungset-identity-dkim-enabled
.
- AWS CLI
-
Um Easy DKIM für eine von Amazon SES verifizierte Identität zu aktivieren oder zu deaktivieren
Im folgenden Beispiel wird der
set-identity-dkim-enabled
Befehl zur Deaktivierung DKIM für eine verifizierte E-Mail-Adresse verwendet:aws ses set-identity-dkim-enabled --identity
user@example.com
--no-dkim-enabledWeitere Informationen zu Easy DKIM finden Sie unter Easy DKIM in Amazon SES im Amazon Simple Email Service Developer Guide.
-
APIEinzelheiten finden Sie SetIdentityDkimEnabled
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungset-identity-feedback-forwarding-enabled
.
- AWS CLI
-
So aktivieren oder deaktivieren Sie die Feedback-Weiterleitung von Bounce- und Beschwerde-Mails für eine von Amazon SES verifizierte Identität
Im folgenden Beispiel wird der
set-identity-feedback-forwarding-enabled
Befehl verwendet, um einer verifizierten E-Mail-Adresse den Empfang von Benachrichtigungen über unberechtigte Anfragen und Beschwerden per E-Mail zu ermöglichen:aws ses set-identity-feedback-forwarding-enabled --identity
user@example.com
--forwarding-enabledSie müssen Benachrichtigungen über Absagen und Beschwerden entweder über Amazon SNS oder über die Feedback-Weiterleitung per E-Mail erhalten. Sie können die Weiterleitung von E-Mail-Feedback also nur deaktivieren, wenn Sie ein SNS Amazon-Thema sowohl für Bounce- als auch für Beschwerdebenachrichtigungen auswählen.
Weitere Informationen zu Benachrichtigungen finden Sie unter Using Notifications With Amazon SES im Amazon Simple Email Service Developer Guide.
-
APIEinzelheiten finden Sie SetIdentityFeedbackForwardingEnabled
unter AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungset-identity-notification-topic
.
- AWS CLI
-
Um das SNS Amazon-Thema festzulegen, zu dem Amazon SES Benachrichtigungen über Rücksendungen, Beschwerden und/oder Lieferungen für eine verifizierte Identität veröffentlicht
Im folgenden Beispiel wird der
set-identity-notification-topic
Befehl verwendet, um das SNS Amazon-Thema anzugeben, an das eine verifizierte E-Mail-Adresse Bounce-Benachrichtigungen erhalten soll:aws ses set-identity-notification-topic --identity
user@example.com
--notification-typeBounce
--sns-topicarn:aws:sns:us-east-1:EXAMPLE65304:MyTopic
Weitere Informationen zu Benachrichtigungen finden Sie unter Using Notifications With Amazon SES im Amazon Simple Email Service Developer Guide.
-
APIEinzelheiten finden Sie SetIdentityNotificationTopic
unter AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungverify-domain-dkim
.
- AWS CLI
-
Um DKIM Tokens einer verifizierten Domain zum DKIM Signieren bei Amazon zu generieren SES
Im folgenden Beispiel wird der
verify-domain-dkim
Befehl verwendet, um DKIM Token für eine Domain zu generieren, die bei Amazon verifiziert wurdeSES:aws ses verify-domain-dkim --domain
example.com
Ausgabe:
{ "DkimTokens": [ "EXAMPLEq76owjnks3lnluwg65scbemvw", "EXAMPLEi3dnsj67hstzaj673klariwx2", "EXAMPLEwfbtcukvimehexktmdtaz6naj" ] }
Für die Einrichtung müssen Sie die zurückgegebenen DKIM Token verwendenDKIM, um die DNS Einstellungen Ihrer Domain mit CNAME Datensätzen zu aktualisieren, die auf von Amazon gehostete DKIM öffentliche Schlüssel verweisenSES. Weitere Informationen finden Sie unter Easy DKIM in Amazon SES im Amazon Simple Email Service Developer Guide.
-
APIEinzelheiten finden Sie VerifyDomainDkim
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungverify-domain-identity
.
- AWS CLI
-
Um eine Domain bei Amazon zu verifizieren SES
Im folgenden Beispiel wird der
verify-domain-identity
-Befehl verwendet, um eine Domain zu verifizieren:aws ses verify-domain-identity --domain
example.com
Ausgabe:
{ "VerificationToken": "eoEmxw+YaYhb3h3iVJHuXMJXqeu1q1/wwmvjuEXAMPLE" }
Um die Domainverifizierung abzuschließen, müssen Sie den DNS Einstellungen Ihrer Domain einen TXT Datensatz mit dem zurückgegebenen Verifizierungstoken hinzufügen. Weitere Informationen finden Sie unter Verifying Domains in Amazon SES im Amazon Simple Email Service Developer Guide.
-
APIEinzelheiten finden Sie unter VerifyDomainIdentity AWS CLI
Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungverify-email-identity
.
- AWS CLI
-
Um eine E-Mail-Adresse bei Amazon zu verifizieren SES
Im folgenden Beispiel wird der
verify-email-identity
-Befehl verwendet, um eine E-Mail-Adresse zu verifizieren:aws ses verify-email-identity --email-address
user@example.com
Bevor Sie eine E-Mail über Amazon versenden könnenSES, müssen Sie die Adresse oder Domain verifizieren, von der aus Sie die E-Mail versenden, um nachzuweisen, dass Sie der Eigentümer der E-Mail sind. Wenn Sie noch keinen Produktionszugriff haben, müssen Sie auch alle E-Mail-Adressen verifizieren, an die Sie E-Mails senden, mit Ausnahme der vom SES Amazon-Postfachsimulator bereitgestellten E-Mail-Adressen.
Nach dem Anruf verify-email-identity erhält die E-Mail-Adresse eine Bestätigungs-E-Mail. Der Benutzer muss auf den Link in der E-Mail klicken, um den Verifizierungsvorgang abzuschließen.
Weitere Informationen finden Sie unter Verifizieren von E-Mail-Adressen in Amazon SES im Amazon Simple Email Service Developer Guide.
-
APIEinzelheiten finden Sie unter VerifyEmailIdentity AWS CLI
Befehlsreferenz.
-