SESEjemplos de Amazon que utilizan AWS CLI

Para eliminar una identidad

En el siguiente ejemplo, se utiliza el delete-identity comando para eliminar una identidad de la lista de identidades verificadas con AmazonSES:

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

Para obtener más información sobre las identidades verificadas, consulte Verificación de direcciones de correo electrónico y dominios en Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

Para obtener los DKIM atributos de Amazon SES Easy para una lista de identidades

En el siguiente ejemplo, se utiliza el get-identity-dkim-attributes comando para recuperar los DKIM atributos de Amazon SES Easy de una lista de identidades:

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

Salida:

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

Si llama a este comando con una identidad que nunca ha enviado para su verificación, esa identidad no aparecerá en el resultado.

Para obtener más información sobre EasyDKIM, consulta Easy DKIM in Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

Para obtener los atributos de SES notificación de Amazon para una lista de identidades

En el siguiente ejemplo, se utiliza el get-identity-notification-attributes comando para recuperar los atributos de SES notificación de Amazon para una lista de identidades:

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

Salida:

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

Este comando devuelve el estado del reenvío de comentarios por correo electrónico y, si corresponde, los nombres de los recursos de Amazon (ARNs) de los SNS temas de Amazon a los que se envían las notificaciones de rebote, queja y entrega.

Si llama a este comando con una identidad que nunca ha enviado para su verificación, esa identidad no aparecerá en el resultado.

Para obtener más información sobre las notificaciones, consulte Uso de notificaciones con Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

Para obtener el estado SES de verificación de Amazon para una lista de identidades

En el siguiente ejemplo, se utiliza el get-identity-verification-attributes comando para recuperar el estado SES de verificación de Amazon de una lista de identidades:

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

Salida:

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

Si llama a este comando con una identidad que nunca ha enviado para su verificación, esa identidad no aparecerá en el resultado.

Para obtener más información sobre las identidades verificadas, consulte Verificación de direcciones de correo electrónico y dominios en Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

Para conocer tus límites de SES envío en Amazon

En el siguiente ejemplo, se utiliza el get-send-quota comando para devolver los límites de SES envío de Amazon:

aws ses get-send-quota

Salida:

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

Max24 HourSend es tu cuota de envío, que es la cantidad máxima de correos electrónicos que puedes enviar en un período de 24 horas. La cuota de envío refleja un período de tiempo acumulativo. Cada vez que intentas enviar un correo electrónico, Amazon SES comprueba cuántos correos electrónicos has enviado en las últimas 24 horas. Siempre que el número total de mensajes de correo electrónico que haya enviado sea inferior a su cuota, se aceptará su solicitud de envío y se enviará su correo electrónico.

SentLast24 horas es el número de correos electrónicos que has enviado en las últimas 24 horas.

MaxSendRate es el número máximo de correos electrónicos que puedes enviar por segundo.

Tenga en cuenta que los límites de envío se basan en los destinatarios en lugar de en los mensajes. Por ejemplo, un correo electrónico que tenga 10 destinatarios se contabiliza como 10 en la cuota de envío.

Para obtener más información, consulta Cómo gestionar tus límites de SES envío de Amazon en la Guía para desarrolladores de Amazon Simple Email Service.

Para obtener tus estadísticas de SES envíos de Amazon

En el siguiente ejemplo, se utiliza el get-send-statistics comando para devolver las estadísticas de SES envíos de Amazon.

aws ses get-send-statistics

Salida:

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

El resultado es una lista de puntos de datos que representan las dos últimas semanas de actividad de envío. Cada punto de datos de la lista contiene estadísticas para un intervalo de 15 minutos.

En este ejemplo, solo hay dos puntos de datos porque los únicos correos electrónicos que el usuario envió en las últimas dos semanas se produjeron en dos intervalos de 15 minutos.

Para obtener más información, consulta Cómo monitorizar tus estadísticas de SES uso de Amazon en la Guía para desarrolladores de Amazon Simple Email Service.

Para enumerar todas las identidades (direcciones de correo electrónico y dominios) de una AWS cuenta específica

En el siguiente ejemplo, se utiliza el list-identities comando para enumerar todas las identidades que se han enviado para su verificación con AmazonSES:

aws ses list-identities

Salida:

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

La lista que se devuelve contiene todas las identidades, independientemente del estado de la verificación (verificada, pendiente de verificación, error, etc.).

En este ejemplo, se devuelven las direcciones de correo electrónico y los dominios porque no especificamos el parámetro de tipo de identidad.

Para obtener más información sobre la verificación, consulte Verificación de direcciones de correo electrónico y dominios en Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

Para enviar un correo electrónico formateado mediante Amazon SES

En el siguiente ejemplo, se utiliza el comando send-email para enviar un correo electrónico formateado:

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

Salida:

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

El destino y el mensaje son estructuras de JSON datos guardadas en archivos.json en el directorio actual. Estos archivos son los siguientes:

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

Sustituya las direcciones de correo electrónico del remitente y del destinatario por las que desee utilizar. Ten en cuenta que la dirección de correo electrónico del remitente debe estar verificada con AmazonSES. Hasta que se te conceda el acceso de producción a AmazonSES, también debes verificar la dirección de correo electrónico de cada destinatario, a menos que el destinatario sea el simulador de SES buzones de Amazon. Para obtener más información sobre la verificación, consulte Verificación de direcciones de correo electrónico y dominios en Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

El ID del mensaje en el resultado indica que la llamada para enviar el correo electrónico se ha realizado correctamente.

Si no recibe el correo electrónico, marque la casilla de correo no deseado.

Para obtener más información sobre el envío de correo electrónico formateado, consulte Envío de correo electrónico formateado con Amazon SES API en la Guía para desarrolladores de Amazon Simple Email Service.

Para enviar un correo electrónico sin procesar mediante Amazon SES

En el siguiente ejemplo, se utiliza el send-raw-email comando para enviar un correo electrónico con un TXT archivo adjunto:

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

Salida:

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

El mensaje sin procesar es una estructura de JSON datos guardada en un archivo denominado message.json en el directorio actual. Contiene lo siguiente:

{
   "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 puede ver, «Datos» es una cadena larga que contiene todo el contenido sin procesar del correo electrónico en MIME formato, incluido un archivo adjunto denominado attachment.txt.

Sustituya sender@example.com y recipient@example.com por las direcciones que desee utilizar. Ten en cuenta que la dirección de correo electrónico del remitente debe estar verificada con AmazonSES. Hasta que se te conceda el acceso de producción a AmazonSES, también debes verificar la dirección de correo electrónico del destinatario, a menos que el destinatario sea el simulador de SES buzones de Amazon. Para obtener más información sobre la verificación, consulte Verificación de direcciones de correo electrónico y dominios en Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

El identificador del mensaje que aparece en el resultado indica que la llamada a send-raw-email se ha realizado correctamente.

Si no recibe el correo electrónico, marque la casilla de correo no deseado.

Para obtener más información sobre el envío de correo electrónico sin procesar, consulte Envío de correo electrónico sin procesar con Amazon SES API en la Guía para desarrolladores de Amazon Simple Email Service.

Para activar o desactivar Easy DKIM for a Amazon SES Verified Identity

En el siguiente ejemplo, se utiliza el set-identity-dkim-enabled comando DKIM para deshabilitar una dirección de correo electrónico verificada:

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

Para obtener más información sobre EasyDKIM, consulta Easy DKIM in Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

Para habilitar o deshabilitar el rebote y el envío de comentarios por correo electrónico para una identidad verificada de Amazon SES

En el siguiente ejemplo, se utiliza el set-identity-feedback-forwarding-enabled comando para permitir que una dirección de correo electrónico verificada reciba notificaciones de devoluciones y quejas por correo electrónico:

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

Debes recibir las notificaciones de devoluciones y quejas a través de Amazon SNS o mediante el reenvío de comentarios por correo electrónico, por lo que solo puedes deshabilitar el reenvío de comentarios por correo electrónico si seleccionas un SNS tema de Amazon para las notificaciones de rebote y queja.

Para obtener más información sobre las notificaciones, consulte Uso de notificaciones con Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

Para configurar el SNS tema de Amazon en el que Amazon SES publicará las notificaciones de rebote, queja o entrega de una identidad verificada

En el siguiente ejemplo, se utiliza el set-identity-notification-topic comando para especificar el SNS tema de Amazon en el que una dirección de correo electrónico verificada recibirá las notificaciones de rebote:

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

Para obtener más información sobre las notificaciones, consulte Uso de notificaciones con Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

Para generar los DKIM tokens de un dominio verificado para DKIM firmar con Amazon SES

En el siguiente ejemplo, se utiliza el verify-domain-dkim comando para generar DKIM tokens para un dominio que se ha verificado con AmazonSES:

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

Salida:

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

Para configurarloDKIM, debes usar los DKIM tokens devueltos para actualizar la DNS configuración de tu dominio con CNAME registros que apunten a claves DKIM públicas alojadas por AmazonSES. Para obtener más información, consulta Easy DKIM in Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

Para verificar un dominio con Amazon SES

En el siguiente ejemplo, se usa el comando verify-domain-identity para verificar un dominio:

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

Salida:

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

Para completar la verificación del dominio, debes añadir un TXT registro con el token de verificación devuelto a la DNS configuración de tu dominio. Para obtener más información, consulte Verificación de dominios en Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

Para verificar una dirección de correo electrónico con Amazon SES

En el siguiente ejemplo, se usa el comando verify-email-identity para verificar una dirección de correo electrónico:

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

Antes de poder enviar un correo electrónico a través de AmazonSES, debes verificar la dirección o el dominio desde el que lo envías para demostrar que eres el propietario. Si aún no tienes acceso a producción, también debes verificar todas las direcciones de correo electrónico a las que envíes correos electrónicos, excepto las direcciones de correo electrónico proporcionadas por el simulador de SES buzones de Amazon.

Cuando verify-email-identity la llames, la dirección de correo electrónico recibirá un correo electrónico de verificación. El usuario debe hacer clic en el enlace del correo electrónico para completar el proceso de verificación.

Para obtener más información, consulte Verificación de direcciones de correo electrónico en Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.