SESAmazon-Beispiele mit 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.

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.

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.

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.

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.

Um Ihre SES Amazon-Versandstatistiken abzurufen

Im folgenden Beispiel wird der get-send-statistics Befehl verwendet, um Ihre SES Amazon-Versandstatistiken zurückzugeben

aws 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.

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.

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 --destination file://destination.json --message file://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.

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.

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-enabled

Weitere Informationen zu Easy DKIM finden Sie unter Easy DKIM in Amazon SES im Amazon Simple Email Service Developer Guide.

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-enabled

Sie 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.

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-type Bounce --sns-topic arn: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.

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.

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.

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.