SESExemplos da Amazon usando AWS CLI

Para excluir uma identidade

O exemplo a seguir usa o delete-identity comando para excluir uma identidade da lista de identidades verificadas com a AmazonSES:

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

Para obter mais informações sobre identidades verificadas, consulte Verificação de endereços de e-mail e domínios na Amazon no Guia SES do desenvolvedor do Amazon Simple Email Service.

Para obter os DKIM atributos do Amazon SES Easy para uma lista de identidades

O exemplo a seguir usa o get-identity-dkim-attributes comando para recuperar os DKIM atributos do Amazon SES Easy para uma lista de identidades:

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

Saída:

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

Se você chamar esse comando com uma identidade que nunca foi enviada para verificação, essa identidade não aparecerá na saída.

Para obter mais informações sobre o EasyDKIM, consulte Easy DKIM na Amazon SES no Guia do desenvolvedor do Amazon Simple Email Service.

Para obter os atributos de SES notificação da Amazon para uma lista de identidades

O exemplo a seguir usa o get-identity-notification-attributes comando para recuperar os atributos de SES notificação da Amazon para uma lista de identidades:

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

Saída:

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

Esse comando retorna o status do encaminhamento de feedback por e-mail e, se aplicável, os Amazon Resource Names (ARNs) dos SNS tópicos da Amazon para os quais as notificações de devolução, reclamação e entrega são enviadas.

Se você chamar esse comando com uma identidade que nunca foi enviada para verificação, essa identidade não aparecerá na saída.

Para obter mais informações sobre notificações, consulte Usando notificações com a Amazon SES no Guia do desenvolvedor do Amazon Simple Email Service.

Para obter o status SES de verificação da Amazon para uma lista de identidades

O exemplo a seguir usa o get-identity-verification-attributes comando para recuperar o status de SES verificação da Amazon para uma lista de identidades:

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

Saída:

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

Se você chamar esse comando com uma identidade que nunca foi enviada para verificação, essa identidade não aparecerá na saída.

Para obter mais informações sobre identidades verificadas, consulte Verificação de endereços de e-mail e domínios na Amazon no Guia SES do desenvolvedor do Amazon Simple Email Service.

Para obter seus limites de SES envio da Amazon

O exemplo a seguir usa o get-send-quota comando para retornar seus limites de SES envio da Amazon:

aws ses get-send-quota

Saída:

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

Max24 HourSend é sua cota de envio, que é o número máximo de e-mails que você pode enviar em um período de 24 horas. A cota de envio reflete um período de tempo acumulado. Toda vez que você tenta enviar um e-mail, a Amazon SES verifica quantos e-mails você enviou nas últimas 24 horas. Desde que o número total de e-mails que você enviou seja menor que a sua cota, sua solicitação de envio será aceito e seus e-mails serão enviados.

SentLast24Hours é o número de e-mails que você enviou nas últimas 24 horas.

MaxSendRate é o número máximo de e-mails que você pode enviar por segundo.

Os limites de envio se baseiam em destinatários, e não em mensagens. Por exemplo, um e-mail com dez destinatários conta como dez em sua cota de envio.

Para obter mais informações, consulte Gerenciando seus limites de SES envio da Amazon no Guia do desenvolvedor do Amazon Simple Email Service.

Para obter suas estatísticas de SES envio da Amazon

O exemplo a seguir usa o get-send-statistics comando para retornar suas estatísticas de SES envio da Amazon

aws ses get-send-statistics

Saída:

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

O resultado é uma lista de pontos de dados, representando as duas últimas semanas da atividade de envio. Cada ponto de dados na lista contém estatísticas para um intervalo de 15 minutos.

Neste exemplo, há apenas dois pontos de dados porque os únicos e-mails que o usuário enviou nas últimas duas semanas caíram em dois intervalos de 15 minutos.

Para obter mais informações, consulte Monitorando suas estatísticas de SES uso da Amazon no Guia do desenvolvedor do Amazon Simple Email Service.

Para listar todas as identidades (endereços de e-mail e domínios) de uma conta específica AWS

O exemplo a seguir usa o list-identities comando para listar todas as identidades que foram enviadas para verificação com a AmazonSES:

aws ses list-identities

Saída:

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

A lista retornada contém todas as identidades, independentemente do status da verificação (verificada, verificação pendente, falha etc.).

Neste exemplo, endereços de e-mail e domínios são retornados porque não especificamos o parâmetro identity-type.

Para obter mais informações sobre verificação, consulte Verificação de endereços de e-mail e domínios SES na Amazon no Guia do desenvolvedor do Amazon Simple Email Service.

Para enviar um e-mail formatado usando a Amazon SES

O exemplo a seguir usa o comando send-email para enviar um e-mail formatado:

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

Saída:

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

O destino e a mensagem são estruturas de JSON dados salvas em arquivos.json no diretório atual. Esses arquivos são os seguintes:

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

Substitua os endereços de e-mail do remetente e do destinatário por aqueles que você deseja usar. Observe que o endereço de e-mail do remetente deve ser verificado com a AmazonSES. Até que você tenha acesso de produção à AmazonSES, você também deve verificar o endereço de e-mail de cada destinatário, a menos que o destinatário seja o simulador de SES caixa de correio da Amazon. Para obter mais informações sobre verificação, consulte Verificação de endereços de e-mail e domínios SES na Amazon no Guia do desenvolvedor do Amazon Simple Email Service.

O ID da mensagem na saída indica que a chamada para send-email foi bem-sucedida.

Se você não receber o e-mail, verifique a caixa de lixo eletrônico.

Para obter mais informações sobre o envio de e-mail formatado, consulte Envio de e-mail formatado usando a Amazon SES API no Guia do desenvolvedor do Amazon Simple Email Service.

Para enviar um e-mail bruto usando a Amazon SES

O exemplo a seguir usa o send-raw-email comando para enviar um e-mail com um TXT anexo:

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

Saída:

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

A mensagem bruta é uma estrutura de JSON dados salva em um arquivo nomeado message.json no diretório atual. Ele contém o seguinte:

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

Como você pode ver, “Dados” é uma longa sequência de caracteres que contém todo o conteúdo bruto do e-mail em MIME formato, incluindo um anexo chamado attachment.txt.

Substitua sender@example.com e recipient@example.com pelos endereços que você deseja usar. Observe que o endereço de e-mail do remetente deve ser verificado com a AmazonSES. Até que você tenha acesso de produção à AmazonSES, você também deve verificar o endereço de e-mail do destinatário, a menos que o destinatário seja o simulador de SES caixa de correio da Amazon. Para obter mais informações sobre verificação, consulte Verificação de endereços de e-mail e domínios SES na Amazon no Guia do desenvolvedor do Amazon Simple Email Service.

O ID da mensagem na saída indica que a chamada para send-raw-email foi bem-sucedida.

Se você não receber o e-mail, verifique a caixa de lixo eletrônico.

Para obter mais informações sobre o envio de e-mail bruto, consulte Envio de e-mail bruto usando a Amazon SES API no Guia do desenvolvedor do Amazon Simple Email Service.

Para ativar ou desativar o Easy DKIM para uma identidade SES verificada pela Amazon

O exemplo a seguir usa o set-identity-dkim-enabled comando DKIM para desativar um endereço de e-mail verificado:

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

Para obter mais informações sobre o EasyDKIM, consulte Easy DKIM na Amazon SES no Guia do desenvolvedor do Amazon Simple Email Service.

Para ativar ou desativar o encaminhamento de feedback por e-mail de devolução e reclamação para uma identidade verificada pela Amazon SES

O exemplo a seguir usa o set-identity-feedback-forwarding-enabled comando para permitir que um endereço de e-mail verificado receba notificações de devolução e reclamação por e-mail:

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

Você precisa receber notificações de devolução e reclamação pela Amazon SNS ou pelo encaminhamento de feedback por e-mail. Portanto, você só pode desativar o encaminhamento de feedback por e-mail se selecionar um SNS tópico da Amazon para notificações de devolução e reclamação.

Para obter mais informações sobre notificações, consulte Usando notificações com a Amazon SES no Guia do desenvolvedor do Amazon Simple Email Service.

Para definir o SNS tópico da Amazon no qual a Amazon SES publicará notificações de devolução, reclamação e/ou entrega para uma identidade verificada

O exemplo a seguir usa o set-identity-notification-topic comando para especificar o SNS tópico da Amazon para o qual um endereço de e-mail verificado receberá notificações de devolução:

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

Para obter mais informações sobre notificações, consulte Usando notificações com a Amazon SES no Guia do desenvolvedor do Amazon Simple Email Service.

Para gerar DKIM tokens de um domínio verificado para DKIM assinatura com a Amazon SES

O exemplo a seguir usa o verify-domain-dkim comando para gerar DKIM tokens para um domínio que foi verificado com a AmazonSES:

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

Saída:

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

Para configurarDKIM, você deve usar os DKIM tokens devolvidos para atualizar DNS as configurações do seu domínio com CNAME registros que apontam para chaves DKIM públicas hospedadas pela AmazonSES. Para obter mais informações, consulte Easy DKIM in Amazon SES no Guia do desenvolvedor do Amazon Simple Email Service.

Para verificar um domínio com a Amazon SES

O exemplo a seguir usa o comando verify-domain-identity para verificar um domínio:

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

Saída:

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

Para concluir a verificação do domínio, você deve adicionar um TXT registro com o token de verificação devolvido às DNS configurações do seu domínio. Para obter mais informações, consulte Verificação de domínios SES na Amazon no Guia do desenvolvedor do Amazon Simple Email Service.

Para verificar um endereço de e-mail com a Amazon SES

O exemplo a seguir usa o comando verify-email-identity para verificar um endereço de e-mail:

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

Antes de enviar um e-mail usando a AmazonSES, você deve verificar o endereço ou domínio do qual você está enviando o e-mail para provar que você é o proprietário. Se você ainda não tem acesso à produção, você também precisa verificar todos os endereços de e-mail para os quais você envia e-mails, exceto os endereços de e-mail fornecidos pelo simulador de SES caixa de correio da Amazon.

Depois verify-email-identity de ser chamado, o endereço de e-mail receberá um e-mail de verificação. O usuário deve clicar no link do e-mail para concluir o processo de verificação.

Para obter mais informações, consulte Verificação de endereços de e-mail na Amazon SES no Guia do desenvolvedor do Amazon Simple Email Service.