Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples). Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Ejemplos de Amazon SES que utilizan AWS CLI Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes AWS Command Line Interface con Amazon SES. Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados. En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto. **Topics** + [Acciones](#actions) ## Acciones ### `delete-identity` En el siguiente ejemplo de código, se muestra cómo utilizar `delete-identity`. **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 más información sobre la API, consulte [DeleteIdentity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ses/delete-identity.html)la *Referencia de AWS CLI comandos*. ### `get-identity-dkim-attributes` En el siguiente ejemplo de código, se muestra cómo utilizar `get-identity-dkim-attributes`. **AWS CLI** **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 más información sobre la API, consulte [GetIdentityDkimAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ses/get-identity-dkim-attributes.html)la *Referencia de AWS CLI comandos*. ### `get-identity-notification-attributes` En el siguiente ejemplo de código, se muestra cómo utilizar `get-identity-notification-attributes`. **AWS CLI** **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 los recursos de Amazon (ARNs) de los temas de Amazon SNS 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 acerca de las notificaciones, consulte Using Notifications With Amazon SES en la *Guía para desarrolladores de Amazon Simple Email Service*. + *Para obtener más información sobre la API, consulte la Referencia de [GetIdentityNotificationAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ses/get-identity-notification-attributes.html)comandos AWS CLI .* ### `get-identity-verification-attributes` En el siguiente ejemplo de código, se muestra cómo utilizar `get-identity-verification-attributes`. **AWS CLI** **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 más información sobre la API, consulte [GetIdentityVerificationAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ses/get-identity-verification-attributes.html)la *Referencia de AWS CLI comandos*. ### `get-send-quota` En el siguiente ejemplo de código, se muestra cómo utilizar `get-send-quota`. **AWS CLI** **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 } ``` 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 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. 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, 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 más información sobre la API, consulta [GetSendQuota](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ses/get-send-quota.html)la *Referencia de AWS CLI comandos*. ### `get-send-statistics` En el siguiente ejemplo de código, se muestra cómo utilizar `get-send-statistics`. **AWS CLI** **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 obtener más información sobre la API, consulte [GetSendStatistics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ses/get-send-statistics.html)la *Referencia de AWS CLI comandos*. ### `list-identities` En el siguiente ejemplo de código, se muestra cómo utilizar `list-identities`. **AWS CLI** **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 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 obtener información sobre la API, consulte [ListIdentities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ses/list-identities.html)la *Referencia de AWS CLI comandos*. ### `send-email` En el siguiente ejemplo de código, se muestra cómo utilizar `send-email`. **AWS CLI** **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: Amazon SES Developer Guide.", "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 obtener más información sobre la API, consulte [SendEmail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ses/send-email.html)la *Referencia de AWS CLI comandos*. ### `send-raw-email` En el siguiente ejemplo de código, se muestra cómo utilizar `send-raw-email`. **AWS CLI** **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 identificador del mensaje en el resultado indica que la llamada a send-raw-email se realizó 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 obtener más información sobre la API, consulte [SendRawEmail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ses/send-raw-email.html)la *Referencia de AWS CLI comandos*. ### `set-identity-dkim-enabled` En el siguiente ejemplo de código, se muestra cómo utilizar `set-identity-dkim-enabled`. **AWS CLI** **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 obtener más información sobre la API, consulte [SetIdentityDkimEnabled](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ses/set-identity-dkim-enabled.html)la *Referencia de AWS CLI comandos*. ### `set-identity-feedback-forwarding-enabled` En el siguiente ejemplo de código, se muestra cómo utilizar `set-identity-feedback-forwarding-enabled`. **AWS CLI** **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 obtener más información sobre la API, consulte [SetIdentityFeedbackForwardingEnabled](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ses/set-identity-feedback-forwarding-enabled.html)la *Referencia de AWS CLI comandos*. ### `set-identity-notification-topic` En el siguiente ejemplo de código, se muestra cómo utilizar `set-identity-notification-topic`. **AWS CLI** **Para configurar el tema de Amazon SNS en el que Amazon SES publicará las notificaciones de rebote, queja o and/or entrega de 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 obtener más información sobre la API, consulte la Referencia [SetIdentityNotificationTopic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ses/set-identity-notification-topic.html)de *AWS CLI comandos*. ### `verify-domain-dkim` En el siguiente ejemplo de código, se muestra cómo utilizar `verify-domain-dkim`. **AWS CLI** **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 obtener más información sobre la API, consulte [VerifyDomainDkim](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ses/verify-domain-dkim.html)la *Referencia de AWS CLI comandos*. ### `verify-domain-identity` En el siguiente ejemplo de código, se muestra cómo utilizar `verify-domain-identity`. **AWS CLI** **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 obtener más información sobre la API, consulte [VerifyDomainIdentity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ses/verify-domain-identity.html)la *Referencia de AWS CLI comandos*. ### `verify-email-identity` En el siguiente ejemplo de código, se muestra cómo utilizar `verify-email-identity`. **AWS CLI** **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. Una vez verify-email-identity que se llame, 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*. + Para obtener más información sobre la API, consulte [VerifyEmailIdentity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ses/verify-email-identity.html)la *Referencia de AWS CLI comandos*.