com.amazonaws.services.simpleemail
Interface AmazonSimpleEmailServiceAsync

All Superinterfaces:

AmazonSimpleEmailService

All Known Implementing Classes:

AmazonSimpleEmailServiceAsyncClient

public interface AmazonSimpleEmailServiceAsync
extends AmazonSimpleEmailService

Interface for accessing AmazonSimpleEmailService asynchronously, using Java Futures. Amazon Simple Email Service

This is the API Reference for Amazon Simple Email Service (Amazon SES). This documentation is intended to be used in conjunction with the Amazon SES Getting Started Guide and the Amazon SES Developer Guide.

For specific details on how to construct a service request, please consult the Amazon SES Developer Guide .

Method Summary

Future<Void>	deleteVerifiedEmailAddressAsync(DeleteVerifiedEmailAddressRequest deleteVerifiedEmailAddressRequest) Deletes the specified email address from the list of verified addresses.
Future<GetSendQuotaResult>	getSendQuotaAsync(GetSendQuotaRequest getSendQuotaRequest) Returns the user's current activity limits.
Future<GetSendStatisticsResult>	getSendStatisticsAsync(GetSendStatisticsRequest getSendStatisticsRequest) Returns the user's sending statistics.
Future<ListVerifiedEmailAddressesResult>	listVerifiedEmailAddressesAsync(ListVerifiedEmailAddressesRequest listVerifiedEmailAddressesRequest) Returns a list containing all of the email addresses that have been verified.
Future<SendEmailResult>	sendEmailAsync(SendEmailRequest sendEmailRequest) Composes an email message based on input data, and then immediately queues the message for sending.
Future<SendRawEmailResult>	sendRawEmailAsync(SendRawEmailRequest sendRawEmailRequest) Sends an email message, with header and content specified by the client.
Future<Void>	verifyEmailAddressAsync(VerifyEmailAddressRequest verifyEmailAddressRequest) Verifies an email address.

Methods inherited from interface com.amazonaws.services.simpleemail.AmazonSimpleEmailService

deleteVerifiedEmailAddress, getCachedResponseMetadata, getSendQuota, getSendQuota, getSendStatistics, getSendStatistics, listVerifiedEmailAddresses, listVerifiedEmailAddresses, sendEmail, sendRawEmail, setEndpoint, shutdown, verifyEmailAddress

Method Detail

getSendQuotaAsync

Future<GetSendQuotaResult> getSendQuotaAsync(GetSendQuotaRequest getSendQuotaRequest)
                                             throws AmazonServiceException,
                                                    AmazonClientException

Returns the user's current activity limits.

Parameters:

getSendQuotaRequest - Container for the necessary parameters to execute the GetSendQuota operation on AmazonSimpleEmailService.

Returns:

A Java Future object containing the response from the GetSendQuota service method, as returned by AmazonSimpleEmailService.

Throws:

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

listVerifiedEmailAddressesAsync

Future<ListVerifiedEmailAddressesResult> listVerifiedEmailAddressesAsync(ListVerifiedEmailAddressesRequest listVerifiedEmailAddressesRequest)
                                                                         throws AmazonServiceException,
                                                                                AmazonClientException

Returns a list containing all of the email addresses that have been verified.

Parameters:

listVerifiedEmailAddressesRequest - Container for the necessary parameters to execute the ListVerifiedEmailAddresses operation on AmazonSimpleEmailService.

Returns:

A Java Future object containing the response from the ListVerifiedEmailAddresses service method, as returned by AmazonSimpleEmailService.

Throws:

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

getSendStatisticsAsync

Future<GetSendStatisticsResult> getSendStatisticsAsync(GetSendStatisticsRequest getSendStatisticsRequest)
                                                       throws AmazonServiceException,
                                                              AmazonClientException

Returns the user's sending statistics. The result is a list of data points, representing the last two weeks of sending activity.

Each data point in the list contains statistics for a 15-minute interval.

Parameters:

getSendStatisticsRequest - Container for the necessary parameters to execute the GetSendStatistics operation on AmazonSimpleEmailService.

Returns:

A Java Future object containing the response from the GetSendStatistics service method, as returned by AmazonSimpleEmailService.

Throws:

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

sendEmailAsync

Future<SendEmailResult> sendEmailAsync(SendEmailRequest sendEmailRequest)
                                       throws AmazonServiceException,
                                              AmazonClientException

Composes an email message based on input data, and then immediately queues the message for sending.

IMPORTANT:If you have not yet requested production access to Amazon SES, then you will only be able to send email to and from verified email addresses. For more information, go to the Amazon SES Developer Guide.

Parameters:

sendEmailRequest - Container for the necessary parameters to execute the SendEmail operation on AmazonSimpleEmailService.

Returns:

A Java Future object containing the response from the SendEmail service method, as returned by AmazonSimpleEmailService.

Throws:

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

deleteVerifiedEmailAddressAsync

Future<Void> deleteVerifiedEmailAddressAsync(DeleteVerifiedEmailAddressRequest deleteVerifiedEmailAddressRequest)
                                             throws AmazonServiceException,
                                                    AmazonClientException

Deletes the specified email address from the list of verified addresses.

Parameters:

deleteVerifiedEmailAddressRequest - Container for the necessary parameters to execute the DeleteVerifiedEmailAddress operation on AmazonSimpleEmailService.

Returns:

A Java Future object containing the response from the DeleteVerifiedEmailAddress service method, as returned by AmazonSimpleEmailService.

Throws:

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

verifyEmailAddressAsync

Future<Void> verifyEmailAddressAsync(VerifyEmailAddressRequest verifyEmailAddressRequest)
                                     throws AmazonServiceException,
                                            AmazonClientException

Verifies an email address. This action causes a confirmation email message to be sent to the specified address.

Parameters:

verifyEmailAddressRequest - Container for the necessary parameters to execute the VerifyEmailAddress operation on AmazonSimpleEmailService.

Returns:

A Java Future object containing the response from the VerifyEmailAddress service method, as returned by AmazonSimpleEmailService.

Throws:

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

sendRawEmailAsync

Future<SendRawEmailResult> sendRawEmailAsync(SendRawEmailRequest sendRawEmailRequest)
                                             throws AmazonServiceException,
                                                    AmazonClientException

Sends an email message, with header and content specified by the client. The SendRawEmail action is useful for sending multipart MIME emails, with attachments or inline content. The raw text of the message must comply with Internet email standards; otherwise, the message cannot be sent.

IMPORTANT:If you have not yet requested production access to Amazon SES, then you will only be able to send email to and from verified email addresses. For more information, go to the Amazon SES Developer Guide.

Parameters:

sendRawEmailRequest - Container for the necessary parameters to execute the SendRawEmail operation on AmazonSimpleEmailService.

Returns:

A Java Future object containing the response from the SendRawEmail service method, as returned by AmazonSimpleEmailService.

Throws:

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.