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 la API v2 de Amazon SES utilizando SDK para Rust
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso del AWS SDK para Rust con Amazon SES API v2.
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.
Los *escenarios* son ejemplos de código que muestran cómo llevar a cabo una tarea específica a través de llamadas a varias funciones dentro del servicio o combinado con otros Servicios de AWS.
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)
+ [Escenarios](#scenarios)
## Acciones
### `CreateContact`
En el siguiente ejemplo de código, se muestra cómo utilizar `CreateContact`.
**SDK para Rust**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/ses#code-examples).
```
async fn add_contact(client: &Client, list: &str, email: &str) -> Result<(), Error> {
client
.create_contact()
.contact_list_name(list)
.email_address(email)
.send()
.await?;
println!("Created contact");
Ok(())
}
```
+ Para obtener más información sobre la API, consulta [CreateContact](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.create_contact)la *referencia sobre la API de AWS SDK para Rust*.
### `CreateContactList`
En el siguiente ejemplo de código, se muestra cómo utilizar `CreateContactList`.
**SDK para Rust**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/ses#code-examples).
```
async fn make_list(client: &Client, contact_list: &str) -> Result<(), Error> {
client
.create_contact_list()
.contact_list_name(contact_list)
.send()
.await?;
println!("Created contact list.");
Ok(())
}
```
+ Para obtener más información sobre la API, consulta [CreateContactList](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.create_contact_list)la *referencia sobre la API de AWS SDK para Rust*.
### `CreateEmailIdentity`
En el siguiente ejemplo de código, se muestra cómo utilizar `CreateEmailIdentity`.
**SDK para Rust**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/ses#code-examples).
```
match self
.client
.create_email_identity()
.email_identity(self.verified_email.clone())
.send()
.await
{
Ok(_) => writeln!(self.stdout, "Email identity created successfully.")?,
Err(e) => match e.into_service_error() {
CreateEmailIdentityError::AlreadyExistsException(_) => {
writeln!(
self.stdout,
"Email identity already exists, skipping creation."
)?;
}
e => return Err(anyhow!("Error creating email identity: {}", e)),
},
}
```
+ Para obtener más información sobre la API, consulta [CreateEmailIdentity](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.create_email_identity)la *referencia sobre la API de AWS SDK para Rust*.
### `CreateEmailTemplate`
En el siguiente ejemplo de código, se muestra cómo utilizar `CreateEmailTemplate`.
**SDK para Rust**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/ses#code-examples).
```
let template_html =
std::fs::read_to_string("../resources/newsletter/coupon-newsletter.html")
.unwrap_or_else(|_| "Missing coupon-newsletter.html".to_string());
let template_text =
std::fs::read_to_string("../resources/newsletter/coupon-newsletter.txt")
.unwrap_or_else(|_| "Missing coupon-newsletter.txt".to_string());
// Create the email template
let template_content = EmailTemplateContent::builder()
.subject("Weekly Coupons Newsletter")
.html(template_html)
.text(template_text)
.build();
match self
.client
.create_email_template()
.template_name(TEMPLATE_NAME)
.template_content(template_content)
.send()
.await
{
Ok(_) => writeln!(self.stdout, "Email template created successfully.")?,
Err(e) => match e.into_service_error() {
CreateEmailTemplateError::AlreadyExistsException(_) => {
writeln!(
self.stdout,
"Email template already exists, skipping creation."
)?;
}
e => return Err(anyhow!("Error creating email template: {}", e)),
},
}
```
+ Para obtener más información sobre la API, consulta [CreateEmailTemplate](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.create_email_template)la *referencia sobre la API de AWS SDK para Rust*.
### `DeleteContactList`
En el siguiente ejemplo de código, se muestra cómo utilizar `DeleteContactList`.
**SDK para Rust**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/ses#code-examples).
```
match self
.client
.delete_contact_list()
.contact_list_name(CONTACT_LIST_NAME)
.send()
.await
{
Ok(_) => writeln!(self.stdout, "Contact list deleted successfully.")?,
Err(e) => return Err(anyhow!("Error deleting contact list: {e}")),
}
```
+ Para obtener más información sobre la API, consulta [DeleteContactList](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.delete_contact_list)la *referencia sobre la API de AWS SDK para Rust*.
### `DeleteEmailIdentity`
En el siguiente ejemplo de código, se muestra cómo utilizar `DeleteEmailIdentity`.
**SDK para Rust**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/ses#code-examples).
```
match self
.client
.delete_email_identity()
.email_identity(self.verified_email.clone())
.send()
.await
{
Ok(_) => writeln!(self.stdout, "Email identity deleted successfully.")?,
Err(e) => {
return Err(anyhow!("Error deleting email identity: {}", e));
}
}
```
+ Para obtener más información sobre la API, consulta [DeleteEmailIdentity](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.delete_email_identity)la *referencia sobre la API de AWS SDK para Rust*.
### `DeleteEmailTemplate`
En el siguiente ejemplo de código, se muestra cómo utilizar `DeleteEmailTemplate`.
**SDK para Rust**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/ses#code-examples).
```
match self
.client
.delete_email_template()
.template_name(TEMPLATE_NAME)
.send()
.await
{
Ok(_) => writeln!(self.stdout, "Email template deleted successfully.")?,
Err(e) => {
return Err(anyhow!("Error deleting email template: {e}"));
}
}
```
+ Para obtener más información sobre la API, consulta [DeleteEmailTemplate](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.delete_email_template)la *referencia sobre la API de AWS SDK para Rust*.
### `GetEmailIdentity`
En el siguiente ejemplo de código, se muestra cómo utilizar `GetEmailIdentity`.
**SDK para Rust**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/ses#code-examples).
Determina si se ha verificado una dirección de correo electrónico.
```
async fn is_verified(client: &Client, email: &str) -> Result<(), Error> {
let resp = client
.get_email_identity()
.email_identity(email)
.send()
.await?;
if resp.verified_for_sending_status() {
println!("The address is verified");
} else {
println!("The address is not verified");
}
Ok(())
}
```
+ Para obtener más información sobre la API, consulta [GetEmailIdentity](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.get_email_identity)la *referencia sobre la API de AWS SDK para Rust*.
### `ListContactLists`
En el siguiente ejemplo de código, se muestra cómo utilizar `ListContactLists`.
**SDK para Rust**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/ses#code-examples).
```
async fn show_lists(client: &Client) -> Result<(), Error> {
let resp = client.list_contact_lists().send().await?;
println!("Contact lists:");
for list in resp.contact_lists() {
println!(" {}", list.contact_list_name().unwrap_or_default());
}
Ok(())
}
```
+ Para obtener más información sobre la API, consulta [ListContactLists](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.list_contact_lists)la *referencia sobre la API de AWS SDK para Rust*.
### `ListContacts`
En el siguiente ejemplo de código, se muestra cómo utilizar `ListContacts`.
**SDK para Rust**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/ses#code-examples).
```
async fn show_contacts(client: &Client, list: &str) -> Result<(), Error> {
let resp = client
.list_contacts()
.contact_list_name(list)
.send()
.await?;
println!("Contacts:");
for contact in resp.contacts() {
println!(" {}", contact.email_address().unwrap_or_default());
}
Ok(())
}
```
+ Para obtener más información sobre la API, consulta [ListContacts](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.list_contacts)la *referencia sobre la API de AWS SDK para Rust*.
### `SendEmail`
En el siguiente ejemplo de código, se muestra cómo utilizar `SendEmail`.
**SDK para Rust**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/ses#code-examples).
Envía un mensaje a todos los miembros de la lista de contactos.
```
async fn send_message(
client: &Client,
list: &str,
from: &str,
subject: &str,
message: &str,
) -> Result<(), Error> {
// Get list of email addresses from contact list.
let resp = client
.list_contacts()
.contact_list_name(list)
.send()
.await?;
let contacts = resp.contacts();
let cs: Vec = contacts
.iter()
.map(|i| i.email_address().unwrap_or_default().to_string())
.collect();
let mut dest: Destination = Destination::builder().build();
dest.to_addresses = Some(cs);
let subject_content = Content::builder()
.data(subject)
.charset("UTF-8")
.build()
.expect("building Content");
let body_content = Content::builder()
.data(message)
.charset("UTF-8")
.build()
.expect("building Content");
let body = Body::builder().text(body_content).build();
let msg = Message::builder()
.subject(subject_content)
.body(body)
.build();
let email_content = EmailContent::builder().simple(msg).build();
client
.send_email()
.from_email_address(from)
.destination(dest)
.content(email_content)
.send()
.await?;
println!("Email sent to list");
Ok(())
}
```
Envía un mensaje a todos los miembros de la lista de contactos mediante una plantilla.
```
let coupons = std::fs::read_to_string("../resources/newsletter/sample_coupons.json")
.unwrap_or_else(|_| r#"{"coupons":[]}"#.to_string());
let email_content = EmailContent::builder()
.template(
Template::builder()
.template_name(TEMPLATE_NAME)
.template_data(coupons)
.build(),
)
.build();
match self
.client
.send_email()
.from_email_address(self.verified_email.clone())
.destination(Destination::builder().to_addresses(email.clone()).build())
.content(email_content)
.list_management_options(
ListManagementOptions::builder()
.contact_list_name(CONTACT_LIST_NAME)
.build()?,
)
.send()
.await
{
Ok(output) => {
if let Some(message_id) = output.message_id {
writeln!(
self.stdout,
"Newsletter sent to {} with message ID {}",
email, message_id
)?;
} else {
writeln!(self.stdout, "Newsletter sent to {}", email)?;
}
}
Err(e) => return Err(anyhow!("Error sending newsletter to {}: {}", email, e)),
}
```
+ Para obtener más información sobre la API, consulta [SendEmail](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.send_email)la *referencia sobre la API de AWS SDK para Rust*.
## Escenarios
### Escenario de Newsletter
El siguiente ejemplo de código muestra cómo ejecutar el escenario de Amazon SES API v2 Newsletter.
**SDK para Rust**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/ses#code-examples).
```
match self
.client
.create_contact_list()
.contact_list_name(CONTACT_LIST_NAME)
.send()
.await
{
Ok(_) => writeln!(self.stdout, "Contact list created successfully.")?,
Err(e) => match e.into_service_error() {
CreateContactListError::AlreadyExistsException(_) => {
writeln!(
self.stdout,
"Contact list already exists, skipping creation."
)?;
}
e => return Err(anyhow!("Error creating contact list: {}", e)),
},
}
match self
.client
.create_contact()
.contact_list_name(CONTACT_LIST_NAME)
.email_address(email.clone())
.send()
.await
{
Ok(_) => writeln!(self.stdout, "Contact created for {}", email)?,
Err(e) => match e.into_service_error() {
CreateContactError::AlreadyExistsException(_) => writeln!(
self.stdout,
"Contact already exists for {}, skipping creation.",
email
)?,
e => return Err(anyhow!("Error creating contact for {}: {}", email, e)),
},
}
let contacts: Vec = match self
.client
.list_contacts()
.contact_list_name(CONTACT_LIST_NAME)
.send()
.await
{
Ok(list_contacts_output) => {
list_contacts_output.contacts.unwrap().into_iter().collect()
}
Err(e) => {
return Err(anyhow!(
"Error retrieving contact list {}: {}",
CONTACT_LIST_NAME,
e
))
}
};
let coupons = std::fs::read_to_string("../resources/newsletter/sample_coupons.json")
.unwrap_or_else(|_| r#"{"coupons":[]}"#.to_string());
let email_content = EmailContent::builder()
.template(
Template::builder()
.template_name(TEMPLATE_NAME)
.template_data(coupons)
.build(),
)
.build();
match self
.client
.send_email()
.from_email_address(self.verified_email.clone())
.destination(Destination::builder().to_addresses(email.clone()).build())
.content(email_content)
.list_management_options(
ListManagementOptions::builder()
.contact_list_name(CONTACT_LIST_NAME)
.build()?,
)
.send()
.await
{
Ok(output) => {
if let Some(message_id) = output.message_id {
writeln!(
self.stdout,
"Newsletter sent to {} with message ID {}",
email, message_id
)?;
} else {
writeln!(self.stdout, "Newsletter sent to {}", email)?;
}
}
Err(e) => return Err(anyhow!("Error sending newsletter to {}: {}", email, e)),
}
match self
.client
.create_email_identity()
.email_identity(self.verified_email.clone())
.send()
.await
{
Ok(_) => writeln!(self.stdout, "Email identity created successfully.")?,
Err(e) => match e.into_service_error() {
CreateEmailIdentityError::AlreadyExistsException(_) => {
writeln!(
self.stdout,
"Email identity already exists, skipping creation."
)?;
}
e => return Err(anyhow!("Error creating email identity: {}", e)),
},
}
let template_html =
std::fs::read_to_string("../resources/newsletter/coupon-newsletter.html")
.unwrap_or_else(|_| "Missing coupon-newsletter.html".to_string());
let template_text =
std::fs::read_to_string("../resources/newsletter/coupon-newsletter.txt")
.unwrap_or_else(|_| "Missing coupon-newsletter.txt".to_string());
// Create the email template
let template_content = EmailTemplateContent::builder()
.subject("Weekly Coupons Newsletter")
.html(template_html)
.text(template_text)
.build();
match self
.client
.create_email_template()
.template_name(TEMPLATE_NAME)
.template_content(template_content)
.send()
.await
{
Ok(_) => writeln!(self.stdout, "Email template created successfully.")?,
Err(e) => match e.into_service_error() {
CreateEmailTemplateError::AlreadyExistsException(_) => {
writeln!(
self.stdout,
"Email template already exists, skipping creation."
)?;
}
e => return Err(anyhow!("Error creating email template: {}", e)),
},
}
match self
.client
.delete_contact_list()
.contact_list_name(CONTACT_LIST_NAME)
.send()
.await
{
Ok(_) => writeln!(self.stdout, "Contact list deleted successfully.")?,
Err(e) => return Err(anyhow!("Error deleting contact list: {e}")),
}
match self
.client
.delete_email_identity()
.email_identity(self.verified_email.clone())
.send()
.await
{
Ok(_) => writeln!(self.stdout, "Email identity deleted successfully.")?,
Err(e) => {
return Err(anyhow!("Error deleting email identity: {}", e));
}
}
match self
.client
.delete_email_template()
.template_name(TEMPLATE_NAME)
.send()
.await
{
Ok(_) => writeln!(self.stdout, "Email template deleted successfully.")?,
Err(e) => {
return Err(anyhow!("Error deleting email template: {e}"));
}
}
```
+ Para obtener información sobre la API, consulte los siguientes temas en la *Referencia de la API de AWS SDK para Rust*.
+ [CreateContact](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.create_contact)
+ [CreateContactList](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.create_contact_list)
+ [CreateEmailIdentity](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.create_email_identity)
+ [CreateEmailTemplate](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.create_email_template)
+ [DeleteContactList](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.delete_contact_list)
+ [DeleteEmailIdentity](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.delete_email_identity)
+ [DeleteEmailTemplate](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.delete_email_template)
+ [ListContacts](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.list_contacts)
+ [SendEmail.simple](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.send_email.simple)
+ [SendEmail.plantilla](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.send_email.template)