SESExemples Amazon utilisant AWS CLI

Pour supprimer une identité

L'exemple suivant utilise la delete-identity commande pour supprimer une identité de la liste des identités vérifiées auprès d'Amazon SES :

aws ses delete-identity --identity user@example.com

Pour plus d'informations sur les identités vérifiées, consultez la section Vérification des adresses e-mail et des domaines sur Amazon SES dans le manuel Amazon Simple Email Service Developer Guide.

Pour obtenir les DKIM attributs Amazon SES Easy pour une liste d'identités

L'exemple suivant utilise la get-identity-dkim-attributes commande pour récupérer les DKIM attributs Amazon SES Easy d'une liste d'identités :

aws ses get-identity-dkim-attributes --identities "example.com" "user@example.com"

Sortie :

{
   "DkimAttributes": {
       "example.com": {
           "DkimTokens": [
               "EXAMPLEjcs5xoyqytjsotsijas7236gr",
               "EXAMPLEjr76cvoc6mysspnioorxsn6ep",
               "EXAMPLEkbmkqkhlm2lyz77ppkulerm4k"
           ],
           "DkimEnabled": true,
           "DkimVerificationStatus": "Success"
       },
       "user@example.com": {
           "DkimEnabled": false,
           "DkimVerificationStatus": "NotStarted"
       }
   }
}

Si vous appelez cette commande avec une identité que vous n'avez jamais soumise pour vérification, cette identité n'apparaîtra pas dans la sortie.

Pour plus d'informations sur EasyDKIM, consultez Easy DKIM in Amazon SES dans le manuel Amazon Simple Email Service Developer Guide.

Pour obtenir les attributs de SES notification Amazon pour une liste d'identités

L'exemple suivant utilise la get-identity-notification-attributes commande pour récupérer les attributs de SES notification Amazon pour une liste d'identités :

aws ses get-identity-notification-attributes --identities "user1@example.com" "user2@example.com"

Sortie :

{
   "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
       }
   }
}

Cette commande renvoie l'état du transfert des commentaires par e-mail et, le cas échéant, les Amazon Resource Names (ARNs) des SNS sujets Amazon auxquels les notifications de renvoi, de réclamation et de livraison sont envoyées.

Si vous appelez cette commande avec une identité que vous n'avez jamais soumise pour vérification, cette identité n'apparaîtra pas dans la sortie.

Pour plus d'informations sur les notifications, consultez la section Utilisation des notifications avec Amazon SES dans le manuel Amazon Simple Email Service Developer Guide.

Pour obtenir le statut SES de vérification Amazon pour une liste d'identités

L'exemple suivant utilise la get-identity-verification-attributes commande pour récupérer le statut de SES vérification Amazon pour une liste d'identités :

aws ses get-identity-verification-attributes --identities "user1@example.com" "user2@example.com"

Sortie :

{
   "VerificationAttributes": {
       "user1@example.com": {
           "VerificationStatus": "Success"
       },
       "user2@example.com": {
           "VerificationStatus": "Pending"
       }
   }
}

Si vous appelez cette commande avec une identité que vous n'avez jamais soumise pour vérification, cette identité n'apparaîtra pas dans la sortie.

Pour plus d'informations sur les identités vérifiées, consultez la section Vérification des adresses e-mail et des domaines sur Amazon SES dans le manuel Amazon Simple Email Service Developer Guide.

Pour connaître vos limites SES d'envoi Amazon

L'exemple suivant utilise la get-send-quota commande pour renvoyer vos limites SES d'envoi Amazon :

aws ses get-send-quota

Sortie :

{
   "Max24HourSend": 200.0,
   "SentLast24Hours": 1.0,
   "MaxSendRate": 1.0
}

Max24 HourSend est votre quota d'envoi, c'est-à-dire le nombre maximum d'e-mails que vous pouvez envoyer sur une période de 24 heures. Le quota d'envoi reflète une période glissante. Chaque fois que vous essayez d'envoyer un e-mail, Amazon SES vérifie le nombre d'e-mails que vous avez envoyés au cours des 24 heures précédentes. Tant que le nombre total d'e-mails que vous avez envoyés est inférieur à votre quota, votre demande d'envoi est acceptée et votre e-mail est envoyé.

SentLast24Hours est le nombre d'e-mails que vous avez envoyés au cours des 24 heures précédentes.

MaxSendRate est le nombre maximum d'e-mails que vous pouvez envoyer par seconde.

Notez que les limites d'envoi sont définies en fonction des destinataires et non pas des messages. Par exemple, un e-mail qui a 10 destinataires compte pour 10 dans votre quota d'envoi.

Pour plus d'informations, consultez Gérer vos limites SES d'envoi Amazon dans le guide du développeur Amazon Simple Email Service.

Pour obtenir vos statistiques d'SESenvoi sur Amazon

L'exemple suivant utilise la get-send-statistics commande pour renvoyer vos statistiques SES d'envoi Amazon.

aws ses get-send-statistics

Sortie :

{
   "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
       }
   ]
}

Le résultat est une liste de points de données représentant les deux dernières semaines d'activité d'envoi. Chaque point de données de la liste contient des statistiques pour un intervalle de 15 minutes.

Dans cet exemple, il n'y a que deux points de données, car les seuls e-mails envoyés par l'utilisateur au cours des deux dernières semaines se situaient à deux intervalles de 15 minutes.

Pour plus d'informations, consultez la section Surveillance de vos statistiques SES d'utilisation Amazon dans le guide du développeur Amazon Simple Email Service.

Pour répertorier toutes les identités (adresses e-mail et domaines) d'un AWS compte spécifique

L'exemple suivant utilise la list-identities commande pour répertorier toutes les identités soumises pour vérification auprès d'Amazon SES :

aws ses list-identities

Sortie :

{
    "Identities": [
      "user@example.com",
      "example.com"
    ]
}

La liste renvoyée contient toutes les identités, quel que soit le statut de vérification (vérifié, en attente de vérification, échec, etc.).

Dans cet exemple, les adresses e-mail et les domaines sont renvoyés car nous n'avons pas spécifié le paramètre identity-type.

Pour plus d'informations sur la vérification, consultez la section Vérification des adresses e-mail et des domaines sur Amazon SES dans le manuel Amazon Simple Email Service Developer Guide.

Pour envoyer un e-mail formaté à l'aide d'Amazon SES

L'exemple suivant utilise la commande send-email pour envoyer un e-mail formaté :

aws ses send-email --from sender@example.com --destination file://destination.json --message file://message.json

Sortie :

{
   "MessageId": "EXAMPLEf3a5efcd1-51adec81-d2a4-4e3f-9fe2-5d85c1b23783-000000"
}

La destination et le message sont JSON des structures de données enregistrées dans des fichiers .json du répertoire en cours. Ces fichiers sont les suivants :

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"
       }
   }
}

Remplacez les adresses e-mail de l'expéditeur et du destinataire par celles que vous souhaitez utiliser. Notez que l'adresse e-mail de l'expéditeur doit être vérifiée auprès d'AmazonSES. Jusqu'à ce que vous obteniez un accès de production à AmazonSES, vous devez également vérifier l'adresse e-mail de chaque destinataire, sauf si le destinataire est le simulateur de SES boîte aux lettres Amazon. Pour plus d'informations sur la vérification, consultez la section Vérification des adresses e-mail et des domaines sur Amazon SES dans le manuel Amazon Simple Email Service Developer Guide.

L'ID du message dans la sortie indique que l'appel pour envoyer un e-mail a réussi.

Si vous ne recevez pas l'e-mail, vérifiez votre boîte de courrier indésirable.

Pour plus d'informations sur l'envoi d'e-mails formatés, consultez la section Envoyer un e-mail formaté à l'aide d'Amazon SES API dans le manuel Amazon Simple Email Service Developer Guide.

Pour envoyer un e-mail brut à l'aide d'Amazon SES

L'exemple suivant utilise la send-raw-email commande pour envoyer un e-mail avec une TXT pièce jointe :

aws ses send-raw-email --raw-message file://message.json

Sortie :

{
   "MessageId": "EXAMPLEf3f73d99b-c63fb06f-d263-41f8-a0fb-d0dc67d56c07-000000"
}

Le message brut est une structure de JSON données enregistrée dans un fichier nommé message.json dans le répertoire courant. Il contient les éléments suivants :

{
   "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--"
}

Comme vous pouvez le constater, « Data » est une longue chaîne contenant l'intégralité du contenu brut du courrier électronique au MIME format, y compris une pièce jointe appelée attachment.txt.

Remplacez sender@example.com et recipient@example.com par les adresses que vous souhaitez utiliser. Notez que l'adresse e-mail de l'expéditeur doit être vérifiée auprès d'AmazonSES. Jusqu'à ce que vous obteniez un accès de production à AmazonSES, vous devez également vérifier l'adresse e-mail du destinataire, sauf si le destinataire est le simulateur de SES boîte aux lettres Amazon. Pour plus d'informations sur la vérification, consultez la section Vérification des adresses e-mail et des domaines sur Amazon SES dans le manuel Amazon Simple Email Service Developer Guide.

L'ID du message dans la sortie indique que l'appel send-raw-email a réussi.

Si vous ne recevez pas l'e-mail, vérifiez votre boîte de courrier indésirable.

Pour plus d'informations sur l'envoi d'e-mails bruts, consultez la section Envoyer des e-mails bruts à l'aide d'Amazon SES API dans le manuel Amazon Simple Email Service Developer Guide.

Pour activer ou désactiver Easy DKIM for a Amazon SES Verified Identity

L'exemple suivant utilise la set-identity-dkim-enabled commande DKIM pour désactiver une adresse e-mail vérifiée :

aws ses set-identity-dkim-enabled --identity user@example.com --no-dkim-enabled

Pour plus d'informations sur EasyDKIM, consultez Easy DKIM in Amazon SES dans le manuel Amazon Simple Email Service Developer Guide.

Pour activer ou désactiver le transfert des commentaires par e-mail de rebond et de réclamation pour une identité SES vérifiée par Amazon

L'exemple suivant utilise la set-identity-feedback-forwarding-enabled commande pour permettre à une adresse e-mail vérifiée de recevoir des notifications de rebond et de plainte par e-mail :

aws ses set-identity-feedback-forwarding-enabled --identity user@example.com --forwarding-enabled

Vous devez recevoir des notifications de rebond et de réclamation via Amazon SNS ou via le transfert de commentaires par e-mail. Vous ne pouvez donc désactiver le transfert de commentaires par e-mail que si vous sélectionnez un SNS sujet Amazon pour les notifications de rebond et de plainte.

Pour plus d'informations sur les notifications, consultez la section Utilisation des notifications avec Amazon SES dans le manuel Amazon Simple Email Service Developer Guide.

Pour définir le SNS sujet Amazon sur lequel Amazon SES publiera les notifications de rebond, de plainte et/ou de livraison pour une identité vérifiée

L'exemple suivant utilise la set-identity-notification-topic commande pour spécifier le SNS sujet Amazon pour lequel une adresse e-mail vérifiée recevra des notifications de rebond :

aws ses set-identity-notification-topic --identity user@example.com --notification-type Bounce --sns-topic arn:aws:sns:us-east-1:EXAMPLE65304:MyTopic

Pour plus d'informations sur les notifications, consultez la section Utilisation des notifications avec Amazon SES dans le manuel Amazon Simple Email Service Developer Guide.

Pour générer les DKIM jetons d'un domaine vérifié à des fins de DKIM signature avec Amazon SES

L'exemple suivant utilise la verify-domain-dkim commande pour générer des DKIM jetons pour un domaine qui a été vérifié auprès d'Amazon SES :

aws ses verify-domain-dkim --domain example.com

Sortie :

{
   "DkimTokens": [
       "EXAMPLEq76owjnks3lnluwg65scbemvw",
       "EXAMPLEi3dnsj67hstzaj673klariwx2",
       "EXAMPLEwfbtcukvimehexktmdtaz6naj"
   ]
}

Pour le configurerDKIM, vous devez utiliser les DKIM jetons renvoyés pour mettre à jour DNS les paramètres de votre domaine avec CNAME des enregistrements pointant vers des clés DKIM publiques hébergées par AmazonSES. Pour plus d'informations, consultez Easy DKIM in Amazon SES dans le manuel Amazon Simple Email Service Developer Guide.

Pour vérifier un domaine auprès d'Amazon SES

L'exemple suivant utilise la commande verify-domain-identity pour vérifier un domaine :

aws ses verify-domain-identity --domain example.com

Sortie :

{
   "VerificationToken": "eoEmxw+YaYhb3h3iVJHuXMJXqeu1q1/wwmvjuEXAMPLE"
}

Pour terminer la vérification du domaine, vous devez ajouter un TXT enregistrement avec le jeton de vérification renvoyé aux DNS paramètres de votre domaine. Pour plus d'informations, consultez la section Verifying Domains in Amazon SES dans le manuel Amazon Simple Email Service Developer Guide.

Pour vérifier une adresse e-mail auprès d'Amazon SES

L'exemple suivant utilise la commande verify-email-identity pour vérifier une adresse e-mail :

aws ses verify-email-identity --email-address user@example.com

Avant de pouvoir envoyer un e-mail via AmazonSES, vous devez vérifier l'adresse ou le domaine depuis lequel vous envoyez l'e-mail afin de prouver que vous en êtes le propriétaire. Si vous n'avez pas encore accès à la production, vous devez également vérifier toutes les adresses e-mail auxquelles vous envoyez des e-mails, à l'exception des adresses e-mail fournies par le simulateur de SES boîte aux lettres Amazon.

Après avoir été verify-email-identity appelée, l'adresse e-mail recevra un e-mail de vérification. L'utilisateur doit cliquer sur le lien disponible dans l'e-mail pour terminer le processus de vérification.

Pour plus d'informations, consultez la section Vérification des adresses e-mail sur Amazon SES dans le manuel Amazon Simple Email Service Developer Guide.