Ejemplos de Amazon SES que utilizan la AWS CLI

Para eliminar una identidad

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

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 atributos Easy DKIM de Amazon SES para una lista de identidades

En el siguiente ejemplo, se utiliza el comando get-identity-dkim-attributes para recuperar los atributos Easy DKIM de Amazon SES 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 Easy DKIM, consulte Easy DKIM in Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

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

En el siguiente ejemplo, se utiliza el comando get-identity-notification-attributes para recuperar los atributos de notificación de Amazon SES de 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 recursos de Amazon (ARN) de los temas de Amazon SNS a los que se envían las notificaciones de devolución, 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 acerca de las notificaciones, consulte Using Notifications With Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

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

En el siguiente ejemplo, se utiliza el comando get-identity-verification-attributes para recuperar el estado de verificación de Amazon SES 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 obtener los límites de envío de Amazon SES

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

aws ses get-send-quota

Salida:

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

Max24HourSend es la cuota de envío, que es el número máximo de correos electrónicos que puede enviar en un periodo de 24 horas. La cuota de envío refleja un período de tiempo acumulativo. Cada vez que intenta enviar un correo electrónico, Amazon SES comprueba la cantidad de correos electrónicos que envió en las 24 horas anteriores. 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.

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

MaxSendRate es el número máximo de correos electrónicos que puede 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, consulte Administración de los límites de envío de Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

Para obtener las estadísticas de envío de Amazon SES

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

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 correspondiente a las últimas dos semanas de actividad de envío. Cada punto de datos de la lista contiene las estadísticas de un intervalo de 15 minutos.

En este ejemplo, solo hay dos puntos de datos, porque los únicos correos electrónicos que el usuario ha enviado en las últimas dos semanas han tenido lugar en dos intervalos de 15 minutos.

Para obtener más información, consulte Monitoring Your Amazon SES Usage Statistics in the en la Guía para desarrolladores de Amazon Simple Email Service.

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

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

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 con 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 datos de JSON 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. Tenga en cuenta que la dirección de correo electrónico del remitente se debe verificar con Amazon SES. Hasta que se le conceda el acceso de producción a Amazon SES, también debe verificar la dirección de correo electrónico de cada destinatario, a menos que el destinatario sea el simulador de bandeja de correo de Amazon SES. 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 la API de Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

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

En el siguiente ejemplo, se utiliza el comando send-raw-email para enviar un correo electrónico con un TXT 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 datos JSON 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 formato MIME, incluido un archivo adjunto llamado attachment.txt.

Sustituya sender@example.com y recipient@example.com por las direcciones que desee utilizar. Tenga en cuenta que la dirección de correo electrónico del remitente se debe verificar con Amazon SES. Hasta que se le conceda el acceso de producción a Amazon SES, también debe verificar la dirección de correo electrónico del destinatario, a menos que el destinatario sea el simulador de bandeja de correo de Amazon SES. 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 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 la API de Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

Para activar o desactivar Easy DKIM para una identidad verificada de Amazon SES

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

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

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

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

En el siguiente ejemplo, se utiliza el comando set-identity-feedback-forwarding-enabled 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

Debe recibir notificaciones de devoluciones y reclamaciones a través de Amazon SNS o de reenvío de comentarios de correo electrónico, para poder deshabilitar el reenvío de comentarios de correo electrónico si selecciona un tema de Amazon SNS tanto para notificaciones de devolución como de reclamaciones.

Para obtener más información acerca de las notificaciones, consulte Using Notifications With Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

Para configurar el tema de Amazon SNS donde Amazon SES publicará notificaciones de devoluciones, reclamaciones o entregas para una identidad verificada

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

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 acerca de las notificaciones, consulte Using Notifications With Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service.

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

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

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

Salida:

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

Para configurar DKIM, debe usar los tokens DKIM devueltos para actualizar la configuración de DNS de su dominio con registros CNAME que apunten hacia claves públicas de DKIM alojadas en Amazon SES. Para obtener más información, consulte 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, debe agregar un registro TXT con el token de verificación devuelto a la configuración de DNS del 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 mediante Amazon SES, debe verificar la dirección o el dominio desde el que envía el correo electrónico para demostrar que es de su propiedad. Si todavía no tiene acceso de producción, también deberá verificar las direcciones de correo electrónico a las que envíe correos electrónicos, excepto las proporcionadas por el simulador de buzón de correo de Amazon SES.

Después de llamar a verify-email-identity, 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.