适用于 .NET 的 AWS SDK V3 已进入维护模式。
我们建议您迁移到 [适用于 .NET 的 AWS SDK V4](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/welcome.html)。有关如何迁移的更多详细信息和信息，请参阅我们的[维护模式公告](https://aws.amazon.com/blogs/developer/aws-sdk-for-net-v3-maintenance-mode-announcement/)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 使用 Amazon SES API v2 的示例 适用于 .NET 的 SDK
以下代码示例向您展示了如何在 Amazon SES API v2 中 适用于 .NET 的 AWS SDK 使用来执行操作和实现常见场景。
*操作*是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。
*场景*是向您演示如何通过在一个服务中调用多个函数或与其他 AWS 服务结合来完成特定任务的代码示例。
每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。
**Topics**
+ [操作](#actions)
+ [场景](#scenarios)
## 操作
### `CreateContact`
以下代码示例演示了如何使用 `CreateContact`。
**适用于 .NET 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/SESv2#code-examples)中查找完整示例，了解如何进行设置和运行。
```
///
/// Creates a contact and adds it to the specified contact list.
///
/// The email address of the contact.
/// The name of the contact list.
/// The response from the CreateContact operation.
public async Task CreateContactAsync(string emailAddress, string contactListName)
{
var request = new CreateContactRequest
{
EmailAddress = emailAddress,
ContactListName = contactListName
};
try
{
var response = await _sesClient.CreateContactAsync(request);
return response.HttpStatusCode == HttpStatusCode.OK;
}
catch (AlreadyExistsException ex)
{
Console.WriteLine($"Contact with email address {emailAddress} already exists in the contact list {contactListName}.");
Console.WriteLine(ex.Message);
return true;
}
catch (NotFoundException ex)
{
Console.WriteLine($"The contact list {contactListName} does not exist.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while creating the contact: {ex.Message}");
}
return false;
}
```
+ 有关 API 的详细信息，请参阅 *适用于 .NET 的 AWS SDK API 参考[CreateContact](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/CreateContact)*中的。
### `CreateContactList`
以下代码示例演示了如何使用 `CreateContactList`。
**适用于 .NET 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/SESv2#code-examples)中查找完整示例，了解如何进行设置和运行。
```
///
/// Creates a contact list with the specified name.
///
/// The name of the contact list.
/// True if successful.
public async Task CreateContactListAsync(string contactListName)
{
var request = new CreateContactListRequest
{
ContactListName = contactListName
};
try
{
var response = await _sesClient.CreateContactListAsync(request);
return response.HttpStatusCode == HttpStatusCode.OK;
}
catch (AlreadyExistsException ex)
{
Console.WriteLine($"Contact list with name {contactListName} already exists.");
Console.WriteLine(ex.Message);
return true;
}
catch (LimitExceededException ex)
{
Console.WriteLine("The limit for contact lists has been exceeded.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while creating the contact list: {ex.Message}");
}
return false;
}
```
+ 有关 API 的详细信息，请参阅 *适用于 .NET 的 AWS SDK API 参考[CreateContactList](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/CreateContactList)*中的。
### `CreateEmailIdentity`
以下代码示例演示了如何使用 `CreateEmailIdentity`。
**适用于 .NET 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/SESv2#code-examples)中查找完整示例，了解如何进行设置和运行。
```
///
/// Creates an email identity (email address or domain) and starts the verification process.
///
/// The email address or domain to create and verify.
/// The response from the CreateEmailIdentity operation.
public async Task CreateEmailIdentityAsync(string emailIdentity)
{
var request = new CreateEmailIdentityRequest
{
EmailIdentity = emailIdentity
};
try
{
var response = await _sesClient.CreateEmailIdentityAsync(request);
return response;
}
catch (AlreadyExistsException ex)
{
Console.WriteLine($"Email identity {emailIdentity} already exists.");
Console.WriteLine(ex.Message);
throw;
}
catch (ConcurrentModificationException ex)
{
Console.WriteLine($"The email identity {emailIdentity} is being modified by another operation or thread.");
Console.WriteLine(ex.Message);
throw;
}
catch (LimitExceededException ex)
{
Console.WriteLine("The limit for email identities has been exceeded.");
Console.WriteLine(ex.Message);
throw;
}
catch (NotFoundException ex)
{
Console.WriteLine($"The email identity {emailIdentity} does not exist.");
Console.WriteLine(ex.Message);
throw;
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
throw;
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while creating the email identity: {ex.Message}");
throw;
}
}
```
+ 有关 API 的详细信息，请参阅 *适用于 .NET 的 AWS SDK API 参考[CreateEmailIdentity](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/CreateEmailIdentity)*中的。
### `CreateEmailTemplate`
以下代码示例演示了如何使用 `CreateEmailTemplate`。
**适用于 .NET 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/SESv2#code-examples)中查找完整示例，了解如何进行设置和运行。
```
///
/// Creates an email template with the specified content.
///
/// The name of the email template.
/// The subject of the email template.
/// The HTML content of the email template.
/// The text content of the email template.
/// True if successful.
public async Task CreateEmailTemplateAsync(string templateName, string subject, string htmlContent, string textContent)
{
var request = new CreateEmailTemplateRequest
{
TemplateName = templateName,
TemplateContent = new EmailTemplateContent
{
Subject = subject,
Html = htmlContent,
Text = textContent
}
};
try
{
var response = await _sesClient.CreateEmailTemplateAsync(request);
return response.HttpStatusCode == HttpStatusCode.OK;
}
catch (AlreadyExistsException ex)
{
Console.WriteLine($"Email template with name {templateName} already exists.");
Console.WriteLine(ex.Message);
}
catch (LimitExceededException ex)
{
Console.WriteLine("The limit for email templates has been exceeded.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while creating the email template: {ex.Message}");
}
return false;
}
```
+ 有关 API 的详细信息，请参阅 *适用于 .NET 的 AWS SDK API 参考[CreateEmailTemplate](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/CreateEmailTemplate)*中的。
### `DeleteContactList`
以下代码示例演示了如何使用 `DeleteContactList`。
**适用于 .NET 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/SESv2#code-examples)中查找完整示例，了解如何进行设置和运行。
```
///
/// Deletes a contact list and all contacts within it.
///
/// The name of the contact list to delete.
/// True if successful.
public async Task DeleteContactListAsync(string contactListName)
{
var request = new DeleteContactListRequest
{
ContactListName = contactListName
};
try
{
var response = await _sesClient.DeleteContactListAsync(request);
return response.HttpStatusCode == HttpStatusCode.OK;
}
catch (ConcurrentModificationException ex)
{
Console.WriteLine($"The contact list {contactListName} is being modified by another operation or thread.");
Console.WriteLine(ex.Message);
}
catch (NotFoundException ex)
{
Console.WriteLine($"The contact list {contactListName} does not exist.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while deleting the contact list: {ex.Message}");
}
return false;
}
```
+ 有关 API 的详细信息，请参阅 *适用于 .NET 的 AWS SDK API 参考[DeleteContactList](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/DeleteContactList)*中的。
### `DeleteEmailIdentity`
以下代码示例演示了如何使用 `DeleteEmailIdentity`。
**适用于 .NET 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/SESv2#code-examples)中查找完整示例，了解如何进行设置和运行。
```
///
/// Deletes an email identity (email address or domain).
///
/// The email address or domain to delete.
/// True if successful.
public async Task DeleteEmailIdentityAsync(string emailIdentity)
{
var request = new DeleteEmailIdentityRequest
{
EmailIdentity = emailIdentity
};
try
{
var response = await _sesClient.DeleteEmailIdentityAsync(request);
return response.HttpStatusCode == HttpStatusCode.OK;
}
catch (ConcurrentModificationException ex)
{
Console.WriteLine($"The email identity {emailIdentity} is being modified by another operation or thread.");
Console.WriteLine(ex.Message);
}
catch (NotFoundException ex)
{
Console.WriteLine($"The email identity {emailIdentity} does not exist.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while deleting the email identity: {ex.Message}");
}
return false;
}
```
+ 有关 API 的详细信息，请参阅 *适用于 .NET 的 AWS SDK API 参考[DeleteEmailIdentity](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/DeleteEmailIdentity)*中的。
### `DeleteEmailTemplate`
以下代码示例演示了如何使用 `DeleteEmailTemplate`。
**适用于 .NET 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/SESv2#code-examples)中查找完整示例，了解如何进行设置和运行。
```
///
/// Deletes an email template.
///
/// The name of the email template to delete.
/// True if successful.
public async Task DeleteEmailTemplateAsync(string templateName)
{
var request = new DeleteEmailTemplateRequest
{
TemplateName = templateName
};
try
{
var response = await _sesClient.DeleteEmailTemplateAsync(request);
return response.HttpStatusCode == HttpStatusCode.OK;
}
catch (NotFoundException ex)
{
Console.WriteLine($"The email template {templateName} does not exist.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while deleting the email template: {ex.Message}");
}
return false;
}
```
+ 有关 API 的详细信息，请参阅 *适用于 .NET 的 AWS SDK API 参考[DeleteEmailTemplate](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/DeleteEmailTemplate)*中的。
### `ListContacts`
以下代码示例演示了如何使用 `ListContacts`。
**适用于 .NET 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/SESv2#code-examples)中查找完整示例，了解如何进行设置和运行。
```
///
/// Lists the contacts in the specified contact list.
///
/// The name of the contact list.
/// The list of contacts response from the ListContacts operation.
public async Task> ListContactsAsync(string contactListName)
{
var request = new ListContactsRequest
{
ContactListName = contactListName
};
try
{
var response = await _sesClient.ListContactsAsync(request);
return response.Contacts;
}
catch (NotFoundException ex)
{
Console.WriteLine($"The contact list {contactListName} does not exist.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while listing the contacts: {ex.Message}");
}
return new List();
}
```
+ 有关 API 的详细信息，请参阅 *适用于 .NET 的 AWS SDK API 参考[ListContacts](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/ListContacts)*中的。
### `SendEmail`
以下代码示例演示了如何使用 `SendEmail`。
**适用于 .NET 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/SESv2#code-examples)中查找完整示例，了解如何进行设置和运行。
```
///
/// Sends an email with the specified content and options.
///
/// The email address to send the email from.
/// The email addresses to send the email to.
/// The subject of the email.
/// The HTML content of the email.
/// The text content of the email.
/// The name of the email template to use (optional).
/// The data to replace placeholders in the email template (optional).
/// The name of the contact list for unsubscribe functionality (optional).
/// The MessageId response from the SendEmail operation.
public async Task SendEmailAsync(string fromEmailAddress, List toEmailAddresses, string? subject,
string? htmlContent, string? textContent, string? templateName = null, string? templateData = null, string? contactListName = null)
{
var request = new SendEmailRequest
{
FromEmailAddress = fromEmailAddress
};
if (toEmailAddresses.Any())
{
request.Destination = new Destination { ToAddresses = toEmailAddresses };
}
if (!string.IsNullOrEmpty(templateName))
{
request.Content = new EmailContent()
{
Template = new Template
{
TemplateName = templateName,
TemplateData = templateData
}
};
}
else
{
request.Content = new EmailContent
{
Simple = new Message
{
Subject = new Content { Data = subject },
Body = new Body
{
Html = new Content { Data = htmlContent },
Text = new Content { Data = textContent }
}
}
};
}
if (!string.IsNullOrEmpty(contactListName))
{
request.ListManagementOptions = new ListManagementOptions
{
ContactListName = contactListName
};
}
try
{
var response = await _sesClient.SendEmailAsync(request);
return response.MessageId;
}
catch (AccountSuspendedException ex)
{
Console.WriteLine("The account's ability to send email has been permanently restricted.");
Console.WriteLine(ex.Message);
}
catch (MailFromDomainNotVerifiedException ex)
{
Console.WriteLine("The sending domain is not verified.");
Console.WriteLine(ex.Message);
}
catch (MessageRejectedException ex)
{
Console.WriteLine("The message content is invalid.");
Console.WriteLine(ex.Message);
}
catch (SendingPausedException ex)
{
Console.WriteLine("The account's ability to send email is currently paused.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while sending the email: {ex.Message}");
}
return string.Empty;
}
```
+ 有关 API 的详细信息，请参阅 *适用于 .NET 的 AWS SDK API 参考[SendEmail](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/SendEmail)*中的。
## 场景
### 时事通讯场景
以下代码示例演示如何运行 Amazon SES API v2 时事通讯场景。
**适用于 .NET 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/SESv2#code-examples)中查找完整示例，了解如何进行设置和运行。
运行场景。
```
using System.Diagnostics;
using System.Text.RegularExpressions;
using Amazon.SimpleEmailV2;
using Amazon.SimpleEmailV2.Model;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.Logging.Console;
using Microsoft.Extensions.Logging.Debug;
namespace Sesv2Scenario;
public static class NewsletterWorkflow
{
/*
This scenario demonstrates how to use the Amazon Simple Email Service (SES) v2 to send a coupon newsletter to a list of subscribers.
The scenario performs the following tasks:
1. Prepare the application:
- Create a verified email identity for sending and replying to emails.
- Create a contact list to store the subscribers' email addresses.
- Create an email template for the coupon newsletter.
2. Gather subscriber email addresses:
- Prompt the user for a base email address.
- Create 3 variants of the email address using subaddress extensions (e.g., user+ses-weekly-newsletter-1@example.com).
- Add each variant as a contact to the contact list.
- Send a welcome email to each new contact.
3. Send the coupon newsletter:
- Retrieve the list of contacts from the contact list.
- Send the coupon newsletter using the email template to each contact.
4. Monitor and review:
- Provide instructions for the user to review the sending activity and metrics in the AWS console.
5. Clean up resources:
- Delete the contact list (which also deletes all contacts within it).
- Delete the email template.
- Optionally delete the verified email identity.
*/
public static SESv2Wrapper _sesv2Wrapper;
public static string? _baseEmailAddress = null;
public static string? _verifiedEmail = null;
private static string _contactListName = "weekly-coupons-newsletter";
private static string _templateName = "weekly-coupons";
private static string _subject = "Weekly Coupons Newsletter";
private static string _htmlContentFile = "coupon-newsletter.html";
private static string _textContentFile = "coupon-newsletter.txt";
private static string _htmlWelcomeFile = "welcome.html";
private static string _textWelcomeFile = "welcome.txt";
private static string _couponsDataFile = "sample_coupons.json";
// Relative location of the resources folder.
private static string _resourcesFilePathLocation = "../../../../resources/";
public static async Task Main(string[] args)
{
// Set up dependency injection for the Amazon service.
using var host = Host.CreateDefaultBuilder(args)
.ConfigureLogging(logging =>
logging.AddFilter("System", LogLevel.Debug)
.AddFilter("Microsoft", LogLevel.Information)
.AddFilter("Microsoft", LogLevel.Trace))
.ConfigureServices((_, services) =>
services.AddAWSService()
.AddTransient()
)
.Build();
ServicesSetup(host);
try
{
Console.WriteLine(new string('-', 80));
Console.WriteLine(new string('-', 80));
Console.WriteLine("Welcome to the Amazon SES v2 Coupon Newsletter Scenario.");
Console.WriteLine("This scenario demonstrates how to use the Amazon Simple Email Service (SES) v2 " +
"\r\nto send a coupon newsletter to a list of subscribers.");
// Prepare the application.
var emailIdentity = await PrepareApplication();
// Gather subscriber email addresses.
await GatherSubscriberEmailAddresses(emailIdentity);
// Send the coupon newsletter.
await SendCouponNewsletter(emailIdentity);
// Monitor and review.
MonitorAndReview(true);
// Clean up resources.
await Cleanup(emailIdentity, true);
Console.WriteLine(new string('-', 80));
Console.WriteLine("Amazon SES v2 Coupon Newsletter scenario is complete.");
Console.WriteLine(new string('-', 80));
Console.WriteLine(new string('-', 80));
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred: {ex.Message}");
}
}
///
/// Populate the services for use within the console application.
///
/// The services host.
private static void ServicesSetup(IHost host)
{
_sesv2Wrapper = host.Services.GetRequiredService();
}
///
/// Set up the resources for the scenario.
///
/// The email address of the verified identity.
public static async Task PrepareApplication()
{
var htmlContent = await File.ReadAllTextAsync(_resourcesFilePathLocation + _htmlContentFile);
var textContent = await File.ReadAllTextAsync(_resourcesFilePathLocation + _textContentFile);
Console.WriteLine(new string('-', 80));
Console.WriteLine("1. In this step, we will prepare the application:" +
"\r\n - Create a verified email identity for sending and replying to emails." +
"\r\n - Create a contact list to store the subscribers' email addresses." +
"\r\n - Create an email template for the coupon newsletter.\r\n");
// Prompt the user for a verified email address.
while (!IsEmail(_verifiedEmail))
{
Console.Write("Enter a verified email address or an email to verify: ");
_verifiedEmail = Console.ReadLine();
}
try
{
// Create an email identity and start the verification process.
await _sesv2Wrapper.CreateEmailIdentityAsync(_verifiedEmail);
Console.WriteLine($"Identity {_verifiedEmail} created.");
}
catch (AlreadyExistsException)
{
Console.WriteLine($"Identity {_verifiedEmail} already exists.");
}
catch (Exception ex)
{
Console.WriteLine($"Error creating email identity: {ex.Message}");
}
// Create a contact list.
try
{
await _sesv2Wrapper.CreateContactListAsync(_contactListName);
Console.WriteLine($"Contact list {_contactListName} created.");
}
catch (AlreadyExistsException)
{
Console.WriteLine($"Contact list {_contactListName} already exists.");
}
catch (Exception ex)
{
Console.WriteLine($"Error creating contact list: {ex.Message}");
}
// Create an email template.
try
{
await _sesv2Wrapper.CreateEmailTemplateAsync(_templateName, _subject, htmlContent, textContent);
Console.WriteLine($"Email template {_templateName} created.");
}
catch (AlreadyExistsException)
{
Console.WriteLine($"Email template {_templateName} already exists.");
}
catch (Exception ex)
{
Console.WriteLine($"Error creating email template: {ex.Message}");
}
return _verifiedEmail;
}
///
/// Generate subscriber addresses and send welcome emails.
///
/// The verified email address from PrepareApplication.
/// True if successful.
public static async Task GatherSubscriberEmailAddresses(string fromEmailAddress)
{
Console.WriteLine(new string('-', 80));
Console.WriteLine("2. In Step 2, we will gather subscriber email addresses:" +
"\r\n - Prompt the user for a base email address." +
"\r\n - Create 3 variants of the email address using subaddress extensions (e.g., user+ses-weekly-newsletter-1@example.com)." +
"\r\n - Add each variant as a contact to the contact list." +
"\r\n - Send a welcome email to each new contact.\r\n");
// Prompt the user for a base email address.
while (!IsEmail(_baseEmailAddress))
{
Console.Write("Enter a base email address (e.g., user@example.com): ");
_baseEmailAddress = Console.ReadLine();
}
// Create 3 variants of the email address using +ses-weekly-newsletter-1, +ses-weekly-newsletter-2, etc.
var baseEmailAddressParts = _baseEmailAddress!.Split("@");
for (int i = 1; i <= 3; i++)
{
string emailAddress = $"{baseEmailAddressParts[0]}+ses-weekly-newsletter-{i}@{baseEmailAddressParts[1]}";
try
{
// Create a contact with the email address in the contact list.
await _sesv2Wrapper.CreateContactAsync(emailAddress, _contactListName);
Console.WriteLine($"Contact {emailAddress} added to the {_contactListName} contact list.");
}
catch (AlreadyExistsException)
{
Console.WriteLine($"Contact {emailAddress} already exists in the {_contactListName} contact list.");
}
catch (Exception ex)
{
Console.WriteLine($"Error creating contact {emailAddress}: {ex.Message}");
return false;
}
// Send a welcome email to the new contact.
try
{
string subject = "Welcome to the Weekly Coupons Newsletter";
string htmlContent = await File.ReadAllTextAsync(_resourcesFilePathLocation + _htmlWelcomeFile);
string textContent = await File.ReadAllTextAsync(_resourcesFilePathLocation + _textWelcomeFile);
await _sesv2Wrapper.SendEmailAsync(fromEmailAddress, new List { emailAddress }, subject, htmlContent, textContent);
Console.WriteLine($"Welcome email sent to {emailAddress}.");
}
catch (Exception ex)
{
Console.WriteLine($"Error sending welcome email to {emailAddress}: {ex.Message}");
return false;
}
// Wait 2 seconds before sending the next email (if the account is in the SES Sandbox).
await Task.Delay(2000);
}
return true;
}
///
/// Send the coupon newsletter to the subscribers in the contact list.
///
/// The verified email address from PrepareApplication.
/// True if successful.
public static async Task SendCouponNewsletter(string fromEmailAddress)
{
Console.WriteLine(new string('-', 80));
Console.WriteLine("3. In this step, we will send the coupon newsletter:" +
"\r\n - Retrieve the list of contacts from the contact list." +
"\r\n - Send the coupon newsletter using the email template to each contact.\r\n");
// Retrieve the list of contacts from the contact list.
var contacts = await _sesv2Wrapper.ListContactsAsync(_contactListName);
if (!contacts.Any())
{
Console.WriteLine($"No contacts found in the {_contactListName} contact list.");
return false;
}
// Load the coupon data from the sample_coupons.json file.
string couponsData = await File.ReadAllTextAsync(_resourcesFilePathLocation + _couponsDataFile);
// Send the coupon newsletter to each contact using the email template.
try
{
foreach (var contact in contacts)
{
// To use the Contact List for list management, send to only one address at a time.
await _sesv2Wrapper.SendEmailAsync(fromEmailAddress,
new List { contact.EmailAddress },
null, null, null, _templateName, couponsData, _contactListName);
}
Console.WriteLine($"Coupon newsletter sent to contact list {_contactListName}.");
}
catch (Exception ex)
{
Console.WriteLine($"Error sending coupon newsletter to contact list {_contactListName}: {ex.Message}");
return false;
}
return true;
}
///
/// Provide instructions for monitoring sending activity and metrics.
///
/// True to run in interactive mode.
/// True if successful.
public static bool MonitorAndReview(bool interactive)
{
Console.WriteLine(new string('-', 80));
Console.WriteLine("4. In step 4, we will monitor and review:" +
"\r\n - Provide instructions for the user to review the sending activity and metrics in the AWS console.\r\n");
Console.WriteLine("Review your sending activity using the SES Homepage in the AWS console.");
Console.WriteLine("Press Enter to open the SES Homepage in your default browser...");
if (interactive)
{
Console.ReadLine();
try
{
// Open the SES Homepage in the default browser.
Process.Start(new ProcessStartInfo
{
FileName = "https://console.aws.amazon.com/ses/home",
UseShellExecute = true
});
}
catch (Exception ex)
{
Console.WriteLine($"Error opening the SES Homepage: {ex.Message}");
return false;
}
}
Console.WriteLine("Review the sending activity and email metrics, then press Enter to continue...");
if (interactive)
Console.ReadLine();
return true;
}
///
/// Clean up the resources used in the scenario.
///
/// The verified email address from PrepareApplication.
/// True if interactive.
/// Async task.
public static async Task Cleanup(string verifiedEmailAddress, bool interactive)
{
Console.WriteLine(new string('-', 80));
Console.WriteLine("5. Finally, we clean up resources:" +
"\r\n - Delete the contact list (which also deletes all contacts within it)." +
"\r\n - Delete the email template." +
"\r\n - Optionally delete the verified email identity.\r\n");
Console.WriteLine("Cleaning up resources...");
// Delete the contact list (this also deletes all contacts in the list).
try
{
await _sesv2Wrapper.DeleteContactListAsync(_contactListName);
Console.WriteLine($"Contact list {_contactListName} deleted.");
}
catch (NotFoundException)
{
Console.WriteLine($"Contact list {_contactListName} not found.");
}
catch (Exception ex)
{
Console.WriteLine($"Error deleting contact list {_contactListName}: {ex.Message}");
return false;
}
// Delete the email template.
try
{
await _sesv2Wrapper.DeleteEmailTemplateAsync(_templateName);
Console.WriteLine($"Email template {_templateName} deleted.");
}
catch (NotFoundException)
{
Console.WriteLine($"Email template {_templateName} not found.");
}
catch (Exception ex)
{
Console.WriteLine($"Error deleting email template {_templateName}: {ex.Message}");
return false;
}
// Ask the user if they want to delete the email identity.
var deleteIdentity = !interactive ||
GetYesNoResponse(
$"Do you want to delete the email identity {verifiedEmailAddress}? (y/n) ");
if (deleteIdentity)
{
try
{
await _sesv2Wrapper.DeleteEmailIdentityAsync(verifiedEmailAddress);
Console.WriteLine($"Email identity {verifiedEmailAddress} deleted.");
}
catch (NotFoundException)
{
Console.WriteLine(
$"Email identity {verifiedEmailAddress} not found.");
}
catch (Exception ex)
{
Console.WriteLine(
$"Error deleting email identity {verifiedEmailAddress}: {ex.Message}");
return false;
}
}
else
{
Console.WriteLine(
$"Skipping deletion of email identity {verifiedEmailAddress}.");
}
return true;
}
///
/// Helper method to get a yes or no response from the user.
///
/// The question string to print on the console.
/// True if the user responds with a yes.
private static bool GetYesNoResponse(string question)
{
Console.WriteLine(question);
var ynResponse = Console.ReadLine();
var response = ynResponse != null && ynResponse.Equals("y", StringComparison.InvariantCultureIgnoreCase);
return response;
}
///
/// Simple check to verify a string is an email address.
///
/// The string to verify.
/// True if a valid email.
private static bool IsEmail(string? email)
{
if (string.IsNullOrEmpty(email))
return false;
return Regex.IsMatch(email, @"^[^@\s]+@[^@\s]+\.[^@\s]+$", RegexOptions.IgnoreCase);
}
}
```
适用于服务操作的包装器。
```
using System.Net;
using Amazon.SimpleEmailV2;
using Amazon.SimpleEmailV2.Model;
namespace Sesv2Scenario;
///
/// Wrapper class for Amazon Simple Email Service (SES) v2 operations.
///
public class SESv2Wrapper
{
private readonly IAmazonSimpleEmailServiceV2 _sesClient;
///
/// Constructor for the SESv2Wrapper.
///
/// The injected SES v2 client.
public SESv2Wrapper(IAmazonSimpleEmailServiceV2 sesClient)
{
_sesClient = sesClient;
}
///
/// Creates a contact and adds it to the specified contact list.
///
/// The email address of the contact.
/// The name of the contact list.
/// The response from the CreateContact operation.
public async Task CreateContactAsync(string emailAddress, string contactListName)
{
var request = new CreateContactRequest
{
EmailAddress = emailAddress,
ContactListName = contactListName
};
try
{
var response = await _sesClient.CreateContactAsync(request);
return response.HttpStatusCode == HttpStatusCode.OK;
}
catch (AlreadyExistsException ex)
{
Console.WriteLine($"Contact with email address {emailAddress} already exists in the contact list {contactListName}.");
Console.WriteLine(ex.Message);
return true;
}
catch (NotFoundException ex)
{
Console.WriteLine($"The contact list {contactListName} does not exist.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while creating the contact: {ex.Message}");
}
return false;
}
///
/// Creates a contact list with the specified name.
///
/// The name of the contact list.
/// True if successful.
public async Task CreateContactListAsync(string contactListName)
{
var request = new CreateContactListRequest
{
ContactListName = contactListName
};
try
{
var response = await _sesClient.CreateContactListAsync(request);
return response.HttpStatusCode == HttpStatusCode.OK;
}
catch (AlreadyExistsException ex)
{
Console.WriteLine($"Contact list with name {contactListName} already exists.");
Console.WriteLine(ex.Message);
return true;
}
catch (LimitExceededException ex)
{
Console.WriteLine("The limit for contact lists has been exceeded.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while creating the contact list: {ex.Message}");
}
return false;
}
///
/// Creates an email identity (email address or domain) and starts the verification process.
///
/// The email address or domain to create and verify.
/// The response from the CreateEmailIdentity operation.
public async Task CreateEmailIdentityAsync(string emailIdentity)
{
var request = new CreateEmailIdentityRequest
{
EmailIdentity = emailIdentity
};
try
{
var response = await _sesClient.CreateEmailIdentityAsync(request);
return response;
}
catch (AlreadyExistsException ex)
{
Console.WriteLine($"Email identity {emailIdentity} already exists.");
Console.WriteLine(ex.Message);
throw;
}
catch (ConcurrentModificationException ex)
{
Console.WriteLine($"The email identity {emailIdentity} is being modified by another operation or thread.");
Console.WriteLine(ex.Message);
throw;
}
catch (LimitExceededException ex)
{
Console.WriteLine("The limit for email identities has been exceeded.");
Console.WriteLine(ex.Message);
throw;
}
catch (NotFoundException ex)
{
Console.WriteLine($"The email identity {emailIdentity} does not exist.");
Console.WriteLine(ex.Message);
throw;
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
throw;
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while creating the email identity: {ex.Message}");
throw;
}
}
///
/// Creates an email template with the specified content.
///
/// The name of the email template.
/// The subject of the email template.
/// The HTML content of the email template.
/// The text content of the email template.
/// True if successful.
public async Task CreateEmailTemplateAsync(string templateName, string subject, string htmlContent, string textContent)
{
var request = new CreateEmailTemplateRequest
{
TemplateName = templateName,
TemplateContent = new EmailTemplateContent
{
Subject = subject,
Html = htmlContent,
Text = textContent
}
};
try
{
var response = await _sesClient.CreateEmailTemplateAsync(request);
return response.HttpStatusCode == HttpStatusCode.OK;
}
catch (AlreadyExistsException ex)
{
Console.WriteLine($"Email template with name {templateName} already exists.");
Console.WriteLine(ex.Message);
}
catch (LimitExceededException ex)
{
Console.WriteLine("The limit for email templates has been exceeded.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while creating the email template: {ex.Message}");
}
return false;
}
///
/// Deletes a contact list and all contacts within it.
///
/// The name of the contact list to delete.
/// True if successful.
public async Task DeleteContactListAsync(string contactListName)
{
var request = new DeleteContactListRequest
{
ContactListName = contactListName
};
try
{
var response = await _sesClient.DeleteContactListAsync(request);
return response.HttpStatusCode == HttpStatusCode.OK;
}
catch (ConcurrentModificationException ex)
{
Console.WriteLine($"The contact list {contactListName} is being modified by another operation or thread.");
Console.WriteLine(ex.Message);
}
catch (NotFoundException ex)
{
Console.WriteLine($"The contact list {contactListName} does not exist.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while deleting the contact list: {ex.Message}");
}
return false;
}
///
/// Deletes an email identity (email address or domain).
///
/// The email address or domain to delete.
/// True if successful.
public async Task DeleteEmailIdentityAsync(string emailIdentity)
{
var request = new DeleteEmailIdentityRequest
{
EmailIdentity = emailIdentity
};
try
{
var response = await _sesClient.DeleteEmailIdentityAsync(request);
return response.HttpStatusCode == HttpStatusCode.OK;
}
catch (ConcurrentModificationException ex)
{
Console.WriteLine($"The email identity {emailIdentity} is being modified by another operation or thread.");
Console.WriteLine(ex.Message);
}
catch (NotFoundException ex)
{
Console.WriteLine($"The email identity {emailIdentity} does not exist.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while deleting the email identity: {ex.Message}");
}
return false;
}
///
/// Deletes an email template.
///
/// The name of the email template to delete.
/// True if successful.
public async Task DeleteEmailTemplateAsync(string templateName)
{
var request = new DeleteEmailTemplateRequest
{
TemplateName = templateName
};
try
{
var response = await _sesClient.DeleteEmailTemplateAsync(request);
return response.HttpStatusCode == HttpStatusCode.OK;
}
catch (NotFoundException ex)
{
Console.WriteLine($"The email template {templateName} does not exist.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while deleting the email template: {ex.Message}");
}
return false;
}
///
/// Lists the contacts in the specified contact list.
///
/// The name of the contact list.
/// The list of contacts response from the ListContacts operation.
public async Task> ListContactsAsync(string contactListName)
{
var request = new ListContactsRequest
{
ContactListName = contactListName
};
try
{
var response = await _sesClient.ListContactsAsync(request);
return response.Contacts;
}
catch (NotFoundException ex)
{
Console.WriteLine($"The contact list {contactListName} does not exist.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while listing the contacts: {ex.Message}");
}
return new List();
}
///
/// Sends an email with the specified content and options.
///
/// The email address to send the email from.
/// The email addresses to send the email to.
/// The subject of the email.
/// The HTML content of the email.
/// The text content of the email.
/// The name of the email template to use (optional).
/// The data to replace placeholders in the email template (optional).
/// The name of the contact list for unsubscribe functionality (optional).
/// The MessageId response from the SendEmail operation.
public async Task SendEmailAsync(string fromEmailAddress, List toEmailAddresses, string? subject,
string? htmlContent, string? textContent, string? templateName = null, string? templateData = null, string? contactListName = null)
{
var request = new SendEmailRequest
{
FromEmailAddress = fromEmailAddress
};
if (toEmailAddresses.Any())
{
request.Destination = new Destination { ToAddresses = toEmailAddresses };
}
if (!string.IsNullOrEmpty(templateName))
{
request.Content = new EmailContent()
{
Template = new Template
{
TemplateName = templateName,
TemplateData = templateData
}
};
}
else
{
request.Content = new EmailContent
{
Simple = new Message
{
Subject = new Content { Data = subject },
Body = new Body
{
Html = new Content { Data = htmlContent },
Text = new Content { Data = textContent }
}
}
};
}
if (!string.IsNullOrEmpty(contactListName))
{
request.ListManagementOptions = new ListManagementOptions
{
ContactListName = contactListName
};
}
try
{
var response = await _sesClient.SendEmailAsync(request);
return response.MessageId;
}
catch (AccountSuspendedException ex)
{
Console.WriteLine("The account's ability to send email has been permanently restricted.");
Console.WriteLine(ex.Message);
}
catch (MailFromDomainNotVerifiedException ex)
{
Console.WriteLine("The sending domain is not verified.");
Console.WriteLine(ex.Message);
}
catch (MessageRejectedException ex)
{
Console.WriteLine("The message content is invalid.");
Console.WriteLine(ex.Message);
}
catch (SendingPausedException ex)
{
Console.WriteLine("The account's ability to send email is currently paused.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while sending the email: {ex.Message}");
}
return string.Empty;
}
}
```
+ 有关 API 详细信息，请参阅《适用于 .NET 的 AWS SDK API Reference》**中的以下主题。
+ [CreateContact](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/CreateContact)
+ [CreateContactList](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/CreateContactList)
+ [CreateEmailIdentity](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/CreateEmailIdentity)
+ [CreateEmailTemplate](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/CreateEmailTemplate)
+ [DeleteContactList](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/DeleteContactList)
+ [DeleteEmailIdentity](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/DeleteEmailIdentity)
+ [DeleteEmailTemplate](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/DeleteEmailTemplate)
+ [ListContacts](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/ListContacts)
+ [SendEmail。simple](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/SendEmail.simple)
+ [SendEmail。模板](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/SendEmail.template)