AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
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 Developer Guide.
Namespace: Amazon.SimpleEmail
Assembly: AWSSDK.dll
Version: (assembly version)
public interface IAmazonSimpleEmailService IDisposable
The IAmazonSimpleEmailService type exposes the following members
Name | Description | |
---|---|---|
BeginCloneReceiptRuleSet(CloneReceiptRuleSetRequest, AsyncCallback, object) | Initiates the asynchronous execution of the CloneReceiptRuleSet operation. | |
BeginCreateReceiptFilter(CreateReceiptFilterRequest, AsyncCallback, object) | Initiates the asynchronous execution of the CreateReceiptFilter operation. | |
BeginCreateReceiptRule(CreateReceiptRuleRequest, AsyncCallback, object) | Initiates the asynchronous execution of the CreateReceiptRule operation. | |
BeginCreateReceiptRuleSet(CreateReceiptRuleSetRequest, AsyncCallback, object) | Initiates the asynchronous execution of the CreateReceiptRuleSet operation. | |
BeginDeleteIdentity(DeleteIdentityRequest, AsyncCallback, object) | Initiates the asynchronous execution of the DeleteIdentity operation. | |
BeginDeleteIdentityPolicy(DeleteIdentityPolicyRequest, AsyncCallback, object) | Initiates the asynchronous execution of the DeleteIdentityPolicy operation. | |
BeginDeleteReceiptFilter(DeleteReceiptFilterRequest, AsyncCallback, object) | Initiates the asynchronous execution of the DeleteReceiptFilter operation. | |
BeginDeleteReceiptRule(DeleteReceiptRuleRequest, AsyncCallback, object) | Initiates the asynchronous execution of the DeleteReceiptRule operation. | |
BeginDeleteReceiptRuleSet(DeleteReceiptRuleSetRequest, AsyncCallback, object) | Initiates the asynchronous execution of the DeleteReceiptRuleSet operation. | |
BeginDeleteVerifiedEmailAddress(DeleteVerifiedEmailAddressRequest, AsyncCallback, object) | Initiates the asynchronous execution of the DeleteVerifiedEmailAddress operation. | |
BeginDescribeActiveReceiptRuleSet(DescribeActiveReceiptRuleSetRequest, AsyncCallback, object) | Initiates the asynchronous execution of the DescribeActiveReceiptRuleSet operation. | |
BeginDescribeReceiptRule(DescribeReceiptRuleRequest, AsyncCallback, object) | Initiates the asynchronous execution of the DescribeReceiptRule operation. | |
BeginDescribeReceiptRuleSet(DescribeReceiptRuleSetRequest, AsyncCallback, object) | Initiates the asynchronous execution of the DescribeReceiptRuleSet operation. | |
BeginGetIdentityDkimAttributes(GetIdentityDkimAttributesRequest, AsyncCallback, object) | Initiates the asynchronous execution of the GetIdentityDkimAttributes operation. | |
BeginGetIdentityNotificationAttributes(GetIdentityNotificationAttributesRequest, AsyncCallback, object) | Initiates the asynchronous execution of the GetIdentityNotificationAttributes operation. | |
BeginGetIdentityPolicies(GetIdentityPoliciesRequest, AsyncCallback, object) | Initiates the asynchronous execution of the GetIdentityPolicies operation. | |
BeginGetIdentityVerificationAttributes(GetIdentityVerificationAttributesRequest, AsyncCallback, object) | Initiates the asynchronous execution of the GetIdentityVerificationAttributes operation. | |
BeginGetSendQuota(GetSendQuotaRequest, AsyncCallback, object) | Initiates the asynchronous execution of the GetSendQuota operation. | |
BeginGetSendStatistics(GetSendStatisticsRequest, AsyncCallback, object) | Initiates the asynchronous execution of the GetSendStatistics operation. | |
BeginListIdentities(ListIdentitiesRequest, AsyncCallback, object) | Initiates the asynchronous execution of the ListIdentities operation. | |
BeginListIdentityPolicies(ListIdentityPoliciesRequest, AsyncCallback, object) | Initiates the asynchronous execution of the ListIdentityPolicies operation. | |
BeginListReceiptFilters(ListReceiptFiltersRequest, AsyncCallback, object) | Initiates the asynchronous execution of the ListReceiptFilters operation. | |
BeginListReceiptRuleSets(ListReceiptRuleSetsRequest, AsyncCallback, object) | Initiates the asynchronous execution of the ListReceiptRuleSets operation. | |
BeginListVerifiedEmailAddresses(ListVerifiedEmailAddressesRequest, AsyncCallback, object) | Initiates the asynchronous execution of the ListVerifiedEmailAddresses operation. | |
BeginPutIdentityPolicy(PutIdentityPolicyRequest, AsyncCallback, object) | Initiates the asynchronous execution of the PutIdentityPolicy operation. | |
BeginReorderReceiptRuleSet(ReorderReceiptRuleSetRequest, AsyncCallback, object) | Initiates the asynchronous execution of the ReorderReceiptRuleSet operation. | |
BeginSendBounce(SendBounceRequest, AsyncCallback, object) | Initiates the asynchronous execution of the SendBounce operation. | |
BeginSendEmail(SendEmailRequest, AsyncCallback, object) | Initiates the asynchronous execution of the SendEmail operation. | |
BeginSendRawEmail(SendRawEmailRequest, AsyncCallback, object) | Initiates the asynchronous execution of the SendRawEmail operation. | |
BeginSetActiveReceiptRuleSet(SetActiveReceiptRuleSetRequest, AsyncCallback, object) | Initiates the asynchronous execution of the SetActiveReceiptRuleSet operation. | |
BeginSetIdentityDkimEnabled(SetIdentityDkimEnabledRequest, AsyncCallback, object) | Initiates the asynchronous execution of the SetIdentityDkimEnabled operation. | |
BeginSetIdentityFeedbackForwardingEnabled(SetIdentityFeedbackForwardingEnabledRequest, AsyncCallback, object) | Initiates the asynchronous execution of the SetIdentityFeedbackForwardingEnabled operation. | |
BeginSetIdentityNotificationTopic(SetIdentityNotificationTopicRequest, AsyncCallback, object) | Initiates the asynchronous execution of the SetIdentityNotificationTopic operation. | |
BeginSetReceiptRulePosition(SetReceiptRulePositionRequest, AsyncCallback, object) | Initiates the asynchronous execution of the SetReceiptRulePosition operation. | |
BeginUpdateReceiptRule(UpdateReceiptRuleRequest, AsyncCallback, object) | Initiates the asynchronous execution of the UpdateReceiptRule operation. | |
BeginVerifyDomainDkim(VerifyDomainDkimRequest, AsyncCallback, object) | Initiates the asynchronous execution of the VerifyDomainDkim operation. | |
BeginVerifyDomainIdentity(VerifyDomainIdentityRequest, AsyncCallback, object) | Initiates the asynchronous execution of the VerifyDomainIdentity operation. | |
BeginVerifyEmailAddress(VerifyEmailAddressRequest, AsyncCallback, object) | Initiates the asynchronous execution of the VerifyEmailAddress operation. | |
BeginVerifyEmailIdentity(VerifyEmailIdentityRequest, AsyncCallback, object) | Initiates the asynchronous execution of the VerifyEmailIdentity operation. | |
CloneReceiptRuleSet(CloneReceiptRuleSetRequest) |
Creates a receipt rule set by cloning an existing one. All receipt rules and configurations
are copied to the new receipt rule set and are completely independent of the source
rule set.
For information about setting up rule sets, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
CreateReceiptFilter(CreateReceiptFilterRequest) |
Creates a new IP address filter.
For information about setting up IP address filters, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
CreateReceiptRule(CreateReceiptRuleRequest) |
Creates a receipt rule.
For information about setting up receipt rules, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
CreateReceiptRuleSet(CreateReceiptRuleSetRequest) |
Creates an empty receipt rule set.
For information about setting up receipt rule sets, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
DeleteIdentity(DeleteIdentityRequest) |
Deletes the specified identity (email address or domain) from the list of verified
identities.
This action is throttled at one request per second. |
|
DeleteIdentityPolicy(DeleteIdentityPolicyRequest) |
Deletes the specified sending authorization policy for the given identity (email address
or domain). This API returns successfully even if a policy with the specified name
does not exist.
Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
DeleteReceiptFilter(DeleteReceiptFilterRequest) |
Deletes the specified IP address filter.
For information about managing IP address filters, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
DeleteReceiptRule(DeleteReceiptRuleRequest) |
Deletes the specified receipt rule.
For information about managing receipt rules, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
DeleteReceiptRuleSet(DeleteReceiptRuleSetRequest) |
Deletes the specified receipt rule set and all of the receipt rules it contains.
For information about managing receipt rule sets, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
DeleteVerifiedEmailAddress(DeleteVerifiedEmailAddressRequest) |
Deletes the specified email address from the list of verified addresses.
This action is throttled at one request per second. |
|
DescribeActiveReceiptRuleSet(DescribeActiveReceiptRuleSetRequest) |
Returns the metadata and receipt rules for the receipt rule set that is currently
active.
For information about setting up receipt rule sets, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
DescribeReceiptRule(DescribeReceiptRuleRequest) |
Returns the details of the specified receipt rule.
For information about setting up receipt rules, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
DescribeReceiptRuleSet(DescribeReceiptRuleSetRequest) |
Returns the details of the specified receipt rule set.
For information about managing receipt rule sets, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
EndCloneReceiptRuleSet(IAsyncResult) | Finishes the asynchronous execution of the CloneReceiptRuleSet operation. | |
EndCreateReceiptFilter(IAsyncResult) | Finishes the asynchronous execution of the CreateReceiptFilter operation. | |
EndCreateReceiptRule(IAsyncResult) | Finishes the asynchronous execution of the CreateReceiptRule operation. | |
EndCreateReceiptRuleSet(IAsyncResult) | Finishes the asynchronous execution of the CreateReceiptRuleSet operation. | |
EndDeleteIdentity(IAsyncResult) | Finishes the asynchronous execution of the DeleteIdentity operation. | |
EndDeleteIdentityPolicy(IAsyncResult) | Finishes the asynchronous execution of the DeleteIdentityPolicy operation. | |
EndDeleteReceiptFilter(IAsyncResult) | Finishes the asynchronous execution of the DeleteReceiptFilter operation. | |
EndDeleteReceiptRule(IAsyncResult) | Finishes the asynchronous execution of the DeleteReceiptRule operation. | |
EndDeleteReceiptRuleSet(IAsyncResult) | Finishes the asynchronous execution of the DeleteReceiptRuleSet operation. | |
EndDeleteVerifiedEmailAddress(IAsyncResult) | Finishes the asynchronous execution of the DeleteVerifiedEmailAddress operation. | |
EndDescribeActiveReceiptRuleSet(IAsyncResult) | Finishes the asynchronous execution of the DescribeActiveReceiptRuleSet operation. | |
EndDescribeReceiptRule(IAsyncResult) | Finishes the asynchronous execution of the DescribeReceiptRule operation. | |
EndDescribeReceiptRuleSet(IAsyncResult) | Finishes the asynchronous execution of the DescribeReceiptRuleSet operation. | |
EndGetIdentityDkimAttributes(IAsyncResult) | Finishes the asynchronous execution of the GetIdentityDkimAttributes operation. | |
EndGetIdentityNotificationAttributes(IAsyncResult) | Finishes the asynchronous execution of the GetIdentityNotificationAttributes operation. | |
EndGetIdentityPolicies(IAsyncResult) | Finishes the asynchronous execution of the GetIdentityPolicies operation. | |
EndGetIdentityVerificationAttributes(IAsyncResult) | Finishes the asynchronous execution of the GetIdentityVerificationAttributes operation. | |
EndGetSendQuota(IAsyncResult) | Finishes the asynchronous execution of the GetSendQuota operation. | |
EndGetSendStatistics(IAsyncResult) | Finishes the asynchronous execution of the GetSendStatistics operation. | |
EndListIdentities(IAsyncResult) | Finishes the asynchronous execution of the ListIdentities operation. | |
EndListIdentityPolicies(IAsyncResult) | Finishes the asynchronous execution of the ListIdentityPolicies operation. | |
EndListReceiptFilters(IAsyncResult) | Finishes the asynchronous execution of the ListReceiptFilters operation. | |
EndListReceiptRuleSets(IAsyncResult) | Finishes the asynchronous execution of the ListReceiptRuleSets operation. | |
EndListVerifiedEmailAddresses(IAsyncResult) | Finishes the asynchronous execution of the ListVerifiedEmailAddresses operation. | |
EndPutIdentityPolicy(IAsyncResult) | Finishes the asynchronous execution of the PutIdentityPolicy operation. | |
EndReorderReceiptRuleSet(IAsyncResult) | Finishes the asynchronous execution of the ReorderReceiptRuleSet operation. | |
EndSendBounce(IAsyncResult) | Finishes the asynchronous execution of the SendBounce operation. | |
EndSendEmail(IAsyncResult) | Finishes the asynchronous execution of the SendEmail operation. | |
EndSendRawEmail(IAsyncResult) | Finishes the asynchronous execution of the SendRawEmail operation. | |
EndSetActiveReceiptRuleSet(IAsyncResult) | Finishes the asynchronous execution of the SetActiveReceiptRuleSet operation. | |
EndSetIdentityDkimEnabled(IAsyncResult) | Finishes the asynchronous execution of the SetIdentityDkimEnabled operation. | |
EndSetIdentityFeedbackForwardingEnabled(IAsyncResult) | Finishes the asynchronous execution of the SetIdentityFeedbackForwardingEnabled operation. | |
EndSetIdentityNotificationTopic(IAsyncResult) | Finishes the asynchronous execution of the SetIdentityNotificationTopic operation. | |
EndSetReceiptRulePosition(IAsyncResult) | Finishes the asynchronous execution of the SetReceiptRulePosition operation. | |
EndUpdateReceiptRule(IAsyncResult) | Finishes the asynchronous execution of the UpdateReceiptRule operation. | |
EndVerifyDomainDkim(IAsyncResult) | Finishes the asynchronous execution of the VerifyDomainDkim operation. | |
EndVerifyDomainIdentity(IAsyncResult) | Finishes the asynchronous execution of the VerifyDomainIdentity operation. | |
EndVerifyEmailAddress(IAsyncResult) | Finishes the asynchronous execution of the VerifyEmailAddress operation. | |
EndVerifyEmailIdentity(IAsyncResult) | Finishes the asynchronous execution of the VerifyEmailIdentity operation. | |
GetIdentityDkimAttributes(GetIdentityDkimAttributesRequest) |
Returns the current status of Easy DKIM signing for an entity. For domain name identities,
this action also returns the DKIM tokens that are required for Easy DKIM signing,
and whether Amazon SES has successfully verified that these tokens have been published.
This action takes a list of identities as input and returns the following information for each:
This action is throttled at one request per second and can only get DKIM attributes for up to 100 identities at a time. For more information about creating DNS records using DKIM tokens, go to the Amazon SES Developer Guide. |
|
GetIdentityNotificationAttributes(GetIdentityNotificationAttributesRequest) |
Given a list of verified identities (email addresses and/or domains), returns a structure
describing identity notification attributes.
This action is throttled at one request per second and can only get notification attributes for up to 100 identities at a time. For more information about using notifications with Amazon SES, see the Amazon SES Developer Guide. |
|
GetIdentityPolicies(GetIdentityPoliciesRequest) |
Returns the requested sending authorization policies for the given identity (email
address or domain). The policies are returned as a map of policy names to policy contents.
You can retrieve a maximum of 20 policies at a time.
Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
GetIdentityVerificationAttributes(GetIdentityVerificationAttributesRequest) |
Given a list of identities (email addresses and/or domains), returns the verification
status and (for domain identities) the verification token for each identity.
This action is throttled at one request per second and can only get verification attributes for up to 100 identities at a time. |
|
GetSendQuota() |
Returns the user's current sending limits.
This action is throttled at one request per second. |
|
GetSendQuota(GetSendQuotaRequest) |
Returns the user's current sending limits.
This action is throttled at one request per second. |
|
GetSendStatistics() |
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. This action is throttled at one request per second. |
|
GetSendStatistics(GetSendStatisticsRequest) |
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. This action is throttled at one request per second. |
|
ListIdentities() |
Returns a list containing all of the identities (email addresses and domains) for
a specific AWS Account, regardless of verification status.
This action is throttled at one request per second. |
|
ListIdentities(ListIdentitiesRequest) |
Returns a list containing all of the identities (email addresses and domains) for
a specific AWS Account, regardless of verification status.
This action is throttled at one request per second. |
|
ListIdentityPolicies(ListIdentityPoliciesRequest) |
Returns a list of sending authorization policies that are attached to the given identity
(email address or domain). This API returns only a list. If you want the actual policy
content, you can use GetIdentityPolicies .
Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
ListReceiptFilters(ListReceiptFiltersRequest) |
Lists the IP address filters associated with your account.
For information about managing IP address filters, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
ListReceiptRuleSets(ListReceiptRuleSetsRequest) |
Lists the receipt rule sets that exist under your AWS account. If there are additional
receipt rule sets to be retrieved, you will receive a NextToken that
you can provide to the next call to ListReceiptRuleSets to retrieve the
additional entries.
For information about managing receipt rule sets, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
ListVerifiedEmailAddresses() |
Returns a list containing all of the email addresses that have been verified.
This action is throttled at one request per second. |
|
ListVerifiedEmailAddresses(ListVerifiedEmailAddressesRequest) |
Returns a list containing all of the email addresses that have been verified.
This action is throttled at one request per second. |
|
PutIdentityPolicy(PutIdentityPolicyRequest) |
Adds or updates a sending authorization policy for the specified identity (email address
or domain).
Sending authorization is a feature that enables an identity owner to authorize other senders to use its identities. For information about using sending authorization, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
ReorderReceiptRuleSet(ReorderReceiptRuleSetRequest) |
Reorders the receipt rules within a receipt rule set.
For information about managing receipt rule sets, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
SendBounce(SendBounceRequest) |
Generates and sends a bounce message to the sender of an email you received through
Amazon SES. You can only use this API on an email up to 24 hours after you receive
it.
For information about receiving email through Amazon SES, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
SendEmail(SendEmailRequest) |
Composes an email message based on input data, and then immediately queues the message
for sending.
There are several important points to know about
|
|
SendRawEmail(SendRawEmailRequest) |
Sends an email message, with header and content specified by the client. The SendRawEmail
action is useful for sending multipart MIME emails. The raw text of the message must
comply with Internet email standards; otherwise, the message cannot be sent.
There are several important points to know about
|
|
SetActiveReceiptRuleSet(SetActiveReceiptRuleSetRequest) |
Sets the specified receipt rule set as the active receipt rule set.
For information about managing receipt rule sets, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
SetIdentityDkimEnabled(SetIdentityDkimEnabledRequest) |
Enables or disables Easy DKIM signing of email sent from an identity:
For email addresses (e.g., This action is throttled at one request per second. For more information about Easy DKIM signing, go to the Amazon SES Developer Guide. |
|
SetIdentityFeedbackForwardingEnabled(SetIdentityFeedbackForwardingEnabledRequest) |
Given an identity (email address or domain), enables or disables whether Amazon SES
forwards bounce and complaint notifications as email. Feedback forwarding can only
be disabled when Amazon Simple Notification Service (Amazon SNS) topics are specified
for both bounces and complaints.
This action is throttled at one request per second. For more information about using notifications with Amazon SES, see the Amazon SES Developer Guide. |
|
SetIdentityNotificationTopic(SetIdentityNotificationTopicRequest) |
Given an identity (email address or domain), sets the Amazon Simple Notification Service
(Amazon SNS) topic to which Amazon SES will publish bounce, complaint, and/or delivery
notifications for emails sent with that identity as the Source .
SetIdentityFeedbackForwardingEnabled .
This action is throttled at one request per second. For more information about feedback notification, see the Amazon SES Developer Guide. |
|
SetReceiptRulePosition(SetReceiptRulePositionRequest) |
Sets the position of the specified receipt rule in the receipt rule set.
For information about managing receipt rules, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
UpdateReceiptRule(UpdateReceiptRuleRequest) |
Updates a receipt rule.
For information about managing receipt rules, see the Amazon SES Developer Guide. This action is throttled at one request per second. |
|
VerifyDomainDkim(VerifyDomainDkimRequest) |
Returns a set of DKIM tokens for a domain. DKIM tokens are character strings
that represent your domain's identity. Using these tokens, you will need to create
DNS CNAME records that point to DKIM public keys hosted by Amazon SES. Amazon Web
Services will eventually detect that you have updated your DNS records; this detection
process may take up to 72 hours. Upon successful detection, Amazon SES will be able
to DKIM-sign email originating from that domain.
This action is throttled at one request per second.
To enable or disable Easy DKIM signing for a domain, use the For more information about creating DNS records using DKIM tokens, go to the Amazon SES Developer Guide. |
|
VerifyDomainIdentity(VerifyDomainIdentityRequest) |
Verifies a domain.
This action is throttled at one request per second. |
|
VerifyEmailAddress(VerifyEmailAddressRequest) |
Verifies an email address. This action causes a confirmation email message to be sent
to the specified address.
This action is throttled at one request per second. |
|
VerifyEmailIdentity(VerifyEmailIdentityRequest) |
Verifies an email address. This action causes a confirmation email message to be sent
to the specified address.
This action is throttled at one request per second. |
This example shows how to send an email.
var sesClient = new AmazonSimpleEmailServiceClient(); var dest = new Destination { ToAddresses = new List<string>() { "janedoe@example.com" }, CcAddresses = new List<string>() { "richarddoe@example.com" } }; var from = "johndoe@example.com"; var subject = new Content("You're invited to the meeting"); var body = new Body(new Content("Please join us Monday at 7:00 PM.")); var msg = new Message(subject, body); var request = new SendEmailRequest { Destination = dest, Message = msg, Source = from }; sesClient.SendEmail(request);
.NET Framework:
Supported in: 4.5, 4.0, 3.5
.NET for Windows Store apps:
Supported in: Windows 8.1, Windows 8
.NET for Windows Phone:
Supported in: Windows Phone 8.1, Windows Phone 8