Given an identity (an email address or a 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.

#create_configuration_set_event_destination(params = {}) ⇒ Struct

Creates a configuration set event destination.

When you create or update an event destination, you must provide one,
and only one, destination. The destination can be Amazon CloudWatch,
Amazon Kinesis Firehose, or Amazon Simple Notification Service (Amazon
SNS).

An event destination is the AWS service to which Amazon SES publishes
the email sending events associated with a configuration set. For
information about using configuration sets, see the Amazon SES
Developer Guide.

The content of the custom verification email. The total size of the
email must be less than 10 MB. The message body may contain HTML, with
some limitations. For more information, see Custom Verification Email
Frequently Asked Questions in the Amazon SES Developer Guide.

:success_redirection_url(required, String)
—

The URL that the recipient of the verification email is sent to if his
or her address is successfully verified.

:failure_redirection_url(required, String)
—

The URL that the recipient of the verification email is sent to if his
or her address is not successfully verified.

# The following example creates a new receipt rule:
resp=client.create_receipt_rule({after:"",rule:{actions:[{s3_action:{bucket_name:"MyBucket",object_key_prefix:"email",},},],enabled:true,name:"MyRule",scan_enabled:true,tls_policy:"Optional",},rule_set_name:"MyRuleSet",})

#delete_configuration_set_event_destination(params = {}) ⇒ Struct

Deletes a configuration set event destination. Configuration set event
destinations are associated with configuration sets, which enable you
to publish email sending events. For information about using
configuration sets, see the Amazon SES Developer Guide.

#delete_identity_policy(params = {}) ⇒ Struct

Deletes the specified sending authorization policy for the given
identity (an email address or a domain). This API returns successfully
even if a policy with the specified name does not exist.

This API is for the identity owner only. If you have not verified the
identity, this API will return an error.

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.

You can execute this operation no more than once per second.

Examples:

Example: DeleteIdentityPolicy

# The following example deletes a sending authorization policy for an identity:
resp=client.delete_identity_policy({identity:"user@example.com",policy_name:"MyPolicy",})

The identity that is associated with the policy that you want to
delete. You can specify the identity by using its name or by using its
Amazon Resource Name (ARN). Examples: user@example.com,
example.com,
arn:aws:ses:us-east-1:123456789012:identity/example.com.

#delete_verified_email_address(params = {}) ⇒ Struct

Deprecated. Use the DeleteIdentity operation to delete email
addresses and domains.

Examples:

Example: DeleteVerifiedEmailAddress

# The following example deletes an email address from the list of identities that have been submitted for verification
# with Amazon SES:
resp=client.delete_verified_email_address({email_address:"user@example.com",})

# The following example returns the metadata and receipt rules for the receipt rule set that is currently active:
resp=client.describe_active_receipt_rule_set({})resp.to_houtputsthefollowing:{metadata:{created_timestamp:Time.parse("2016-07-15T16:25:59.607Z"),name:"default-rule-set",},rules:[{actions:[{s3_action:{bucket_name:"MyBucket",object_key_prefix:"email",},},],enabled:true,name:"MyRule",scan_enabled:true,tls_policy:"Optional",},],}

# The following example returns the details of a receipt rule:
resp=client.describe_receipt_rule({rule_name:"MyRule",rule_set_name:"MyRuleSet",})resp.to_houtputsthefollowing:{rule:{actions:[{s3_action:{bucket_name:"MyBucket",object_key_prefix:"email",},},],enabled:true,name:"MyRule",scan_enabled:true,tls_policy:"Optional",},}

# The following example returns the metadata and receipt rules of a receipt rule set:
resp=client.describe_receipt_rule_set({rule_set_name:"MyRuleSet",})resp.to_houtputsthefollowing:{metadata:{created_timestamp:Time.parse("2016-07-15T16:25:59.607Z"),name:"MyRuleSet",},rules:[{actions:[{s3_action:{bucket_name:"MyBucket",object_key_prefix:"email",},},],enabled:true,name:"MyRule",scan_enabled:true,tls_policy:"Optional",},],}

Returns the current status of Easy DKIM signing for an entity. For
domain name identities, this operation 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 operation takes a list of identities as input and returns the
following information for each:

Whether Easy DKIM signing is enabled or disabled.

A set of DKIM tokens that represent the identity. If the identity is
an email address, the tokens represent the domain of that address.

Whether Amazon SES has successfully verified the DKIM tokens
published in the domain's DNS. This information is only returned
for domain name identities, not for email addresses.

This operation is throttled at one request per second and can only get
DKIM attributes for up to 100 identities at a time.

# The following example retrieves the Amazon SES Easy DKIM attributes for a list of identities:
resp=client.get_identity_dkim_attributes({identities:["example.com","user@example.com",],})resp.to_houtputsthefollowing:{dkim_attributes:{"example.com"=>{dkim_enabled:true,dkim_tokens:["EXAMPLEjcs5xoyqytjsotsijas7236gr","EXAMPLEjr76cvoc6mysspnioorxsn6ep","EXAMPLEkbmkqkhlm2lyz77ppkulerm4k",],dkim_verification_status:"Success",},"user@example.com"=>{dkim_enabled:false,dkim_verification_status:"NotStarted",},},}

Returns the custom MAIL FROM attributes for a list of identities
(email addresses : domains).

This operation is throttled at one request per second and can only get
custom MAIL FROM attributes for up to 100 identities at a time.

Examples:

Example: GetIdentityMailFromDomainAttributes

# The following example returns the custom MAIL FROM attributes for an identity:
resp=client.get_identity_mail_from_domain_attributes({identities:["example.com",],})resp.to_houtputsthefollowing:{mail_from_domain_attributes:{"example.com"=>{behavior_on_mx_failure:"UseDefaultValue",mail_from_domain:"bounces.example.com",mail_from_domain_status:"Success",},},}

# The following example returns the notification attributes for an identity:
resp=client.get_identity_notification_attributes({identities:["example.com",],})resp.to_houtputsthefollowing:{notification_attributes:{"example.com"=>{bounce_topic:"arn:aws:sns:us-east-1:EXAMPLE65304:ExampleTopic",complaint_topic:"arn:aws:sns:us-east-1:EXAMPLE65304:ExampleTopic",delivery_topic:"arn:aws:sns:us-east-1:EXAMPLE65304:ExampleTopic",forwarding_enabled:true,headers_in_bounce_notifications_enabled:false,headers_in_complaint_notifications_enabled:false,headers_in_delivery_notifications_enabled:false,},},}

A list of one or more identities. You can specify an identity by using
its name or by using its Amazon Resource Name (ARN). Examples:
user@example.com, example.com,
arn:aws:ses:us-east-1:123456789012:identity/example.com.

Returns the requested sending authorization policies for the given
identity (an email address or a 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.

This API is for the identity owner only. If you have not verified the
identity, this API will return an error.

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.

You can execute this operation no more than once per second.

Examples:

Example: GetIdentityPolicies

# The following example returns a sending authorization policy for an identity:
resp=client.get_identity_policies({identity:"example.com",policy_names:["MyPolicy",],})resp.to_houtputsthefollowing:{policies:{"MyPolicy"=>"{\"Version\":\"2008-10-17\",\"Statement\":[{\"Sid\":\"stmt1469123904194\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:root\"},\"Action\":[\"ses:SendEmail\",\"ses:SendRawEmail\"],\"Resource\":\"arn:aws:ses:us-east-1:EXAMPLE65304:identity/example.com\"}]}",},}

The identity for which the policies will be retrieved. You can specify
an identity by using its name or by using its Amazon Resource Name
(ARN). Examples: user@example.com, example.com,
arn:aws:ses:us-east-1:123456789012:identity/example.com.

To successfully call this API, you must own the identity.

:policy_names(required, Array<String>)
—

A list of the names of policies to be retrieved. You can retrieve a
maximum of 20 policies at a time. If you do not know the names of the
policies that are attached to the identity, you can use
ListIdentityPolicies.

Given a list of identities (email addresses and/or domains), returns
the verification status and (for domain identities) the verification
token for each identity.

The verification status of an email address is "Pending" until the
email address owner clicks the link within the verification email that
Amazon SES sent to that address. If the email address owner clicks the
link within 24 hours, the verification status of the email address
changes to "Success". If the link is not clicked within 24 hours,
the verification status changes to "Failed." In that case, if you
still want to verify the email address, you must restart the
verification process from the beginning.

For domain identities, the domain's verification status is
"Pending" as Amazon SES searches for the required TXT record in the
DNS settings of the domain. When Amazon SES detects the record, the
domain's verification status changes to "Success". If Amazon SES is
unable to detect the record within 72 hours, the domain's
verification status changes to "Failed." In that case, if you still
want to verify the domain, you must restart the verification process
from the beginning.

This operation is throttled at one request per second and can only get
verification attributes for up to 100 identities at a time.

Examples:

Example: GetIdentityVerificationAttributes

# The following example returns the verification status and the verification token for a domain identity:
resp=client.get_identity_verification_attributes({identities:["example.com",],})resp.to_houtputsthefollowing:{verification_attributes:{"example.com"=>{verification_status:"Success",verification_token:"EXAMPLE3VYb9EDI2nTOQRi/Tf6MI/6bD6THIGiP1MVY=",},},}

# The following example returns the Amazon SES sending limits for an AWS account:
resp=client.get_send_quota({})resp.to_houtputsthefollowing:{max_24_hour_send:200,max_send_rate:1,sent_last_24_hours:1,}

Provides sending statistics for the Amazon SES account. 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 period of time.

You can execute this operation no more than once per second. This
operation will return up to 1,000 configuration sets each time it is
run. If your Amazon SES account has more than 1,000 configuration
sets, this operation will also return a NextToken element. You can
then execute the ListConfigurationSets operation again, passing the
NextToken parameter and the value of the NextToken element to
retrieve additional results.

A token returned from a previous call to
ListCustomVerificationEmailTemplates to indicate the position in the
list of email templates.

:max_results(Integer)
—

The maximum number of custom verification email templates to return.
This value must be at least 1 and less than or equal to 50. If you do
not specify a value, or if you specify a value less than 1 or greater
than 50, the operation will return up to 50 results.

Returns a list containing all of the identities (email addresses and
domains) for your AWS account, regardless of verification status.

You can execute this operation no more than once per second.

Examples:

Example: ListIdentities

# The following example lists the email address identities that have been submitted for verification with Amazon SES:
resp=client.list_identities({identity_type:"EmailAddress",max_items:123,next_token:"",})resp.to_houtputsthefollowing:{identities:["user@example.com",],next_token:"",}

Returns a list of sending authorization policies that are attached to
the given identity (an email address or a domain). This API returns
only a list. If you want the actual policy content, you can use
GetIdentityPolicies.

This API is for the identity owner only. If you have not verified the
identity, this API will return an error.

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.

You can execute this operation no more than once per second.

Examples:

Example: ListIdentityPolicies

# The following example returns a list of sending authorization policies that are attached to an identity:
resp=client.list_identity_policies({identity:"example.com",})resp.to_houtputsthefollowing:{policy_names:["MyPolicy",],}

Request syntax with placeholder values

resp=client.list_identity_policies({identity:"Identity",# required
})

Response structure

resp.policy_names#=> Array
resp.policy_names[0]#=> String

Parameters:

params(Hash)(defaults to: {})
—

({})

Options Hash (params):

:identity(required, String)
—

The identity that is associated with the policy for which the policies
will be listed. You can specify an identity by using its name or by
using its Amazon Resource Name (ARN). Examples: user@example.com,
example.com,
arn:aws:ses:us-east-1:123456789012:identity/example.com.

# The following example lists the IP address filters that are associated with an AWS account:
resp=client.list_receipt_filters({})resp.to_houtputsthefollowing:{filters:[{ip_filter:{cidr:"1.2.3.4/24",policy:"Block",},name:"MyFilter",},],}

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.

# The following example lists the receipt rule sets that exist under an AWS account:
resp=client.list_receipt_rule_sets({next_token:"",})resp.to_houtputsthefollowing:{next_token:"",rule_sets:[{created_timestamp:Time.parse("2016-07-15T16:25:59.607Z"),name:"MyRuleSet",},],}

The maximum number of templates to return. This value must be at least
1 and less than or equal to 10. If you do not specify a value, or if
you specify a value less than 1 or greater than 10, the operation will
return up to 10 results.

Deprecated. Use the ListIdentities operation to list the email
addresses and domains associated with your account.

Examples:

Example: ListVerifiedEmailAddresses

# The following example lists all email addresses that have been submitted for verification with Amazon SES:
resp=client.list_verified_email_addresses({})resp.to_houtputsthefollowing:{verified_email_addresses:["user1@example.com","user2@example.com",],}

#put_identity_policy(params = {}) ⇒ Struct

Adds or updates a sending authorization policy for the specified
identity (an email address or a domain).

This API is for the identity owner only. If you have not verified the
identity, this API will return an error.

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.

You can execute this operation no more than once per second.

Examples:

Example: PutIdentityPolicy

# The following example adds a sending authorization policy to an identity:
resp=client.put_identity_policy({identity:"example.com",policy:"{\"Version\":\"2008-10-17\",\"Statement\":[{\"Sid\":\"stmt1469123904194\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:root\"},\"Action\":[\"ses:SendEmail\",\"ses:SendRawEmail\"],\"Resource\":\"arn:aws:ses:us-east-1:EXAMPLE65304:identity/example.com\"}]}",policy_name:"MyPolicy",})

The identity that the policy will apply to. You can specify an
identity by using its name or by using its Amazon Resource Name (ARN).
Examples: user@example.com, example.com,
arn:aws:ses:us-east-1:123456789012:identity/example.com.

To successfully call this API, you must own the identity.

:policy_name(required, String)
—

The name of the policy.

The policy name cannot exceed 64 characters and can only include
alphanumeric characters, dashes, and underscores.

A list of recipients of the bounced message, including the information
required to create the Delivery Status Notifications (DSNs) for the
recipients. You must specify at least one BouncedRecipientInfo in
the list.

:bounce_sender_arn(String)
—

This parameter is used only for sending authorization. It is the ARN
of the identity that is associated with the sending authorization
policy that permits you to use the address in the "From" header of
the bounce. For more information about sending authorization, see the
Amazon SES Developer Guide.

Composes an email message to multiple destinations. The message body
is created using an email template.

In order to send email using the SendBulkTemplatedEmail operation,
your call to the API must meet the following requirements:

The call must refer to an existing email template. You can create
email templates using the CreateTemplate operation.

The message must be sent from a verified email address or domain.

If your account is still in the Amazon SES sandbox, you may only
send to verified addresses or domains, or to email addresses
associated with the Amazon SES Mailbox Simulator. For more
information, see Verifying Email Addresses and Domains in the
Amazon SES Developer Guide.

The total size of the message, including attachments, must be less
than 10 MB.

Each Destination parameter must include at least one recipient
email address. The recipient address can be a To: address, a CC:
address, or a BCC: address. If a recipient email address is invalid
(that is, it is not in the format
UserName@[SubDomain.]Domain.TopLevelDomain), the entire message
will be rejected, even if the message contains other recipients that
are valid.

The email address that is sending the email. This email address must
be either individually verified with Amazon SES, or from a domain that
has been verified with Amazon SES. For information about verifying
identities, see the Amazon SES Developer Guide.

If you are sending on behalf of another user and have been permitted
to do so by a sending authorization policy, then you must also specify
the SourceArn parameter. For more information about sending
authorization, see the Amazon SES Developer Guide.

Amazon SES does not support the SMTPUTF8 extension, as described in
RFC6531. For this reason, the local part of a source email
address (the part of the email address that precedes the @ sign) may
only contain 7-bit ASCII characters. If the domain part of an
address (the part after the @ sign) contains non-ASCII characters,
they must be encoded using Punycode, as described in RFC3492. The
sender name (also known as the friendly name) may contain non-ASCII
characters. These characters must be encoded using MIME encoded-word
syntax, as described in RFC 2047. MIME encoded-word syntax uses
the following form: =?charset?encoding?encoded-text?=.

:source_arn(String)
—

This parameter is used only for sending authorization. It is the ARN
of the identity that is associated with the sending authorization
policy that permits you to send for the email address specified in the
Source parameter.

For example, if the owner of example.com (which has ARN
arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a
policy to it that authorizes you to send from user@example.com, then
you would specify the SourceArn to be
arn:aws:ses:us-east-1:123456789012:identity/example.com, and the
Source to be user@example.com.

The reply-to email address(es) for the message. If the recipient
replies to the message, each reply-to address will receive the reply.

:return_path(String)
—

The email address that bounces and complaints will be forwarded to
when feedback forwarding is enabled. If the message cannot be
delivered to the recipient, then an error message will be returned
from the recipient's ISP; this message will then be forwarded to the
email address specified by the ReturnPath parameter. The
ReturnPath parameter is never overwritten. This email address must
be either individually verified with Amazon SES, or from a domain that
has been verified with Amazon SES.

:return_path_arn(String)
—

This parameter is used only for sending authorization. It is the ARN
of the identity that is associated with the sending authorization
policy that permits you to use the email address specified in the
ReturnPath parameter.

For example, if the owner of example.com (which has ARN
arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a
policy to it that authorizes you to use feedback@example.com, then
you would specify the ReturnPathArn to be
arn:aws:ses:us-east-1:123456789012:identity/example.com, and the
ReturnPath to be feedback@example.com.

Composes an email message and immediately queues it for sending. In
order to send email using the SendEmail operation, your message must
meet the following requirements:

The message must be sent from a verified email address or domain. If
you attempt to send email using a non-verified address or domain,
the operation will result in an "Email address not verified"
error.

If your account is still in the Amazon SES sandbox, you may only
send to verified addresses or domains, or to email addresses
associated with the Amazon SES Mailbox Simulator. For more
information, see Verifying Email Addresses and Domains in the
Amazon SES Developer Guide.

The total size of the message, including attachments, must be
smaller than 10 MB.

The message must include at least one recipient email address. The
recipient address can be a To: address, a CC: address, or a BCC:
address. If a recipient email address is invalid (that is, it is not
in the format UserName@[SubDomain.]Domain.TopLevelDomain), the
entire message will be rejected, even if the message contains other
recipients that are valid.

The message may not include more than 50 recipients, across the To:,
CC: and BCC: fields. If you need to send an email message to a
larger audience, you can divide your recipient list into groups of
50 or fewer, and then call the SendEmail operation several times
to send the message to each group.

For every message that you send, the total number of recipients
(including each recipient in the To:, CC: and BCC: fields) is counted
against the maximum number of emails you can send in a 24-hour period
(your sending quota). For more information about sending quotas in
Amazon SES, see Managing Your Amazon SES Sending Limits in the
Amazon SES Developer Guide.

The email address that is sending the email. This email address must
be either individually verified with Amazon SES, or from a domain that
has been verified with Amazon SES. For information about verifying
identities, see the Amazon SES Developer Guide.

If you are sending on behalf of another user and have been permitted
to do so by a sending authorization policy, then you must also specify
the SourceArn parameter. For more information about sending
authorization, see the Amazon SES Developer Guide.

Amazon SES does not support the SMTPUTF8 extension, as described in
RFC6531. For this reason, the local part of a source email
address (the part of the email address that precedes the @ sign) may
only contain 7-bit ASCII characters. If the domain part of an
address (the part after the @ sign) contains non-ASCII characters,
they must be encoded using Punycode, as described in RFC3492. The
sender name (also known as the friendly name) may contain non-ASCII
characters. These characters must be encoded using MIME encoded-word
syntax, as described in RFC 2047. MIME encoded-word syntax uses
the following form: =?charset?encoding?encoded-text?=.

The reply-to email address(es) for the message. If the recipient
replies to the message, each reply-to address will receive the reply.

:return_path(String)
—

The email address that bounces and complaints will be forwarded to
when feedback forwarding is enabled. If the message cannot be
delivered to the recipient, then an error message will be returned
from the recipient's ISP; this message will then be forwarded to the
email address specified by the ReturnPath parameter. The
ReturnPath parameter is never overwritten. This email address must
be either individually verified with Amazon SES, or from a domain that
has been verified with Amazon SES.

:source_arn(String)
—

This parameter is used only for sending authorization. It is the ARN
of the identity that is associated with the sending authorization
policy that permits you to send for the email address specified in the
Source parameter.

For example, if the owner of example.com (which has ARN
arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a
policy to it that authorizes you to send from user@example.com, then
you would specify the SourceArn to be
arn:aws:ses:us-east-1:123456789012:identity/example.com, and the
Source to be user@example.com.

This parameter is used only for sending authorization. It is the ARN
of the identity that is associated with the sending authorization
policy that permits you to use the email address specified in the
ReturnPath parameter.

For example, if the owner of example.com (which has ARN
arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a
policy to it that authorizes you to use feedback@example.com, then
you would specify the ReturnPathArn to be
arn:aws:ses:us-east-1:123456789012:identity/example.com, and the
ReturnPath to be feedback@example.com.

A list of tags, in the form of name/value pairs, to apply to an email
that you send using SendEmail. Tags correspond to characteristics of
the email that you define, so that you can publish email sending
events.

:configuration_set_name(String)
—

The name of the configuration set to use when you send an email using
SendEmail.

Composes an email message and immediately queues it for sending. When
calling this operation, you may specify the message headers as well as
the content. The SendRawEmail operation is particularly useful for
sending multipart MIME emails (such as those that contain both a
plain-text and an HTML version).

In order to send email using the SendRawEmail operation, your
message must meet the following requirements:

The message must be sent from a verified email address or domain. If
you attempt to send email using a non-verified address or domain,
the operation will result in an "Email address not verified"
error.

If your account is still in the Amazon SES sandbox, you may only
send to verified addresses or domains, or to email addresses
associated with the Amazon SES Mailbox Simulator. For more
information, see Verifying Email Addresses and Domains in the
Amazon SES Developer Guide.

The total size of the message, including attachments, must be
smaller than 10 MB.

The message must include at least one recipient email address. The
recipient address can be a To: address, a CC: address, or a BCC:
address. If a recipient email address is invalid (that is, it is not
in the format UserName@[SubDomain.]Domain.TopLevelDomain), the
entire message will be rejected, even if the message contains other
recipients that are valid.

The message may not include more than 50 recipients, across the To:,
CC: and BCC: fields. If you need to send an email message to a
larger audience, you can divide your recipient list into groups of
50 or fewer, and then call the SendRawEmail operation several
times to send the message to each group.

For every message that you send, the total number of recipients
(including each recipient in the To:, CC: and BCC: fields) is counted
against the maximum number of emails you can send in a 24-hour period
(your sending quota). For more information about sending quotas in
Amazon SES, see Managing Your Amazon SES Sending Limits in the
Amazon SES Developer Guide.

Additionally, keep the following considerations in mind when using the
SendRawEmail operation:

Although you can customize the message headers when using the
SendRawEmail operation, Amazon SES will automatically apply its
own Message-ID and Date headers; if you passed these headers
when creating the message, they will be overwritten by the values
that Amazon SES provides.

If you are using sending authorization to send on behalf of another
user, SendRawEmail enables you to specify the cross-account
identity for the email's Source, From, and Return-Path parameters
in one of two ways: you can pass optional parameters SourceArn,
FromArn, and/or ReturnPathArn to the API, or you can include the
following X-headers in the header of your raw email:

X-SES-SOURCE-ARN

X-SES-FROM-ARN

X-SES-RETURN-PATH-ARN

Do not include these X-headers in the DKIM signature; Amazon SES
will remove them before sending the email.

For most common sending authorization scenarios, we recommend that
you specify the SourceIdentityArn parameter and not the
FromIdentityArn or ReturnPathIdentityArn parameters. If you only
specify the SourceIdentityArn parameter, Amazon SES will set the
From and Return Path addresses to the identity specified in
SourceIdentityArn. For more information about sending
authorization, see the Using Sending Authorization with Amazon
SES in the Amazon SES Developer Guide.

Examples:

Example: SendRawEmail

# The following example sends an email with an attachment:
resp=client.send_raw_email({destinations:[],from_arn:"",raw_message:{data:"From: sender@example.com\\nTo: recipient@example.com\\nSubject: Test email (contains an attachment)\\nMIME-Version: 1.0\\nContent-type: Multipart/Mixed; boundary=\"NextPart\"\\n\\n--NextPart\\nContent-Type: text/plain\\n\\nThis is the message body.\\n\\n--NextPart\\nContent-Type: text/plain;\\nContent-Disposition: attachment; filename=\"attachment.txt\"\\n\\nThis is the text in the attachment.\\n\\n--NextPart--",},return_path_arn:"",source:"",source_arn:"",})resp.to_houtputsthefollowing:{message_id:"EXAMPLEf3f73d99b-c63fb06f-d263-41f8-a0fb-d0dc67d56c07-000000",}

The identity's email address. If you do not provide a value for this
parameter, you must specify a "From" address in the raw text of the
message. (You can also specify both.)

Amazon SES does not support the SMTPUTF8 extension, as described
inRFC6531. For this reason, the local part of a source email
address (the part of the email address that precedes the @ sign) may
only contain 7-bit ASCII characters. If the domain part of an
address (the part after the @ sign) contains non-ASCII characters,
they must be encoded using Punycode, as described in RFC3492. The
sender name (also known as the friendly name) may contain non-ASCII
characters. These characters must be encoded using MIME encoded-word
syntax, as described in RFC 2047. MIME encoded-word syntax uses
the following form: =?charset?encoding?encoded-text?=.

If you specify the Source parameter and have feedback forwarding
enabled, then bounces and complaints will be sent to this email
address. This takes precedence over any Return-Path header that you
might include in the raw text of the message.

:destinations(Array<String>)
—

A list of destinations for the message, consisting of To:, CC:, and
BCC: addresses.

Per RFC 5321, the maximum length of each line of text,
including the <CRLF>, must not exceed 1,000 characters.

:from_arn(String)
—

This parameter is used only for sending authorization. It is the ARN
of the identity that is associated with the sending authorization
policy that permits you to specify a particular "From" address in
the header of the raw email.

Instead of using this parameter, you can use the X-header
X-SES-FROM-ARN in the raw message of the email. If you use both the
FromArn parameter and the corresponding X-header, Amazon SES uses
the value of the FromArn parameter.

For information about when to use this parameter, see the description
of SendRawEmail in this guide, or see the Amazon SES Developer
Guide.

:source_arn(String)
—

This parameter is used only for sending authorization. It is the ARN
of the identity that is associated with the sending authorization
policy that permits you to send for the email address specified in the
Source parameter.

For example, if the owner of example.com (which has ARN
arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a
policy to it that authorizes you to send from user@example.com, then
you would specify the SourceArn to be
arn:aws:ses:us-east-1:123456789012:identity/example.com, and the
Source to be user@example.com.

Instead of using this parameter, you can use the X-header
X-SES-SOURCE-ARN in the raw message of the email. If you use both
the SourceArn parameter and the corresponding X-header, Amazon SES
uses the value of the SourceArn parameter.

For information about when to use this parameter, see the description
of SendRawEmail in this guide, or see the Amazon SES Developer
Guide.

:return_path_arn(String)
—

This parameter is used only for sending authorization. It is the ARN
of the identity that is associated with the sending authorization
policy that permits you to use the email address specified in the
ReturnPath parameter.

For example, if the owner of example.com (which has ARN
arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a
policy to it that authorizes you to use feedback@example.com, then
you would specify the ReturnPathArn to be
arn:aws:ses:us-east-1:123456789012:identity/example.com, and the
ReturnPath to be feedback@example.com.

Instead of using this parameter, you can use the X-header
X-SES-RETURN-PATH-ARN in the raw message of the email. If you use
both the ReturnPathArn parameter and the corresponding X-header,
Amazon SES uses the value of the ReturnPathArn parameter.

For information about when to use this parameter, see the description
of SendRawEmail in this guide, or see the Amazon SES Developer
Guide.

A list of tags, in the form of name/value pairs, to apply to an email
that you send using SendRawEmail. Tags correspond to characteristics
of the email that you define, so that you can publish email sending
events.

:configuration_set_name(String)
—

The name of the configuration set to use when you send an email using
SendRawEmail.

Composes an email message using an email template and immediately
queues it for sending.

In order to send email using the SendTemplatedEmail operation, your
call to the API must meet the following requirements:

The call must refer to an existing email template. You can create
email templates using the CreateTemplate operation.

The message must be sent from a verified email address or domain.

If your account is still in the Amazon SES sandbox, you may only
send to verified addresses or domains, or to email addresses
associated with the Amazon SES Mailbox Simulator. For more
information, see Verifying Email Addresses and Domains in the
Amazon SES Developer Guide.

The total size of the message, including attachments, must be less
than 10 MB.

Calls to the SendTemplatedEmail operation may only include one
Destination parameter. A destination is a set of recipients who
will receive the same version of the email. The Destination
parameter can include up to 50 recipients, across the To:, CC: and
BCC: fields.

The Destination parameter must include at least one recipient
email address. The recipient address can be a To: address, a CC:
address, or a BCC: address. If a recipient email address is invalid
(that is, it is not in the format
UserName@[SubDomain.]Domain.TopLevelDomain), the entire message
will be rejected, even if the message contains other recipients that
are valid.

The email address that is sending the email. This email address must
be either individually verified with Amazon SES, or from a domain that
has been verified with Amazon SES. For information about verifying
identities, see the Amazon SES Developer Guide.

If you are sending on behalf of another user and have been permitted
to do so by a sending authorization policy, then you must also specify
the SourceArn parameter. For more information about sending
authorization, see the Amazon SES Developer Guide.

Amazon SES does not support the SMTPUTF8 extension, as described in
RFC6531. For this reason, the local part of a source email
address (the part of the email address that precedes the @ sign) may
only contain 7-bit ASCII characters. If the domain part of an
address (the part after the @ sign) contains non-ASCII characters,
they must be encoded using Punycode, as described in RFC3492. The
sender name (also known as the friendly name) may contain non-ASCII
characters. These characters must be encoded using MIME encoded-word
syntax, as described inRFC 2047. MIME encoded-word syntax uses
the following form: =?charset?encoding?encoded-text?=.

The destination for this email, composed of To:, CC:, and BCC: fields.
A Destination can include up to 50 recipients across these three
fields.

:reply_to_addresses(Array<String>)
—

The reply-to email address(es) for the message. If the recipient
replies to the message, each reply-to address will receive the reply.

:return_path(String)
—

The email address that bounces and complaints will be forwarded to
when feedback forwarding is enabled. If the message cannot be
delivered to the recipient, then an error message will be returned
from the recipient's ISP; this message will then be forwarded to the
email address specified by the ReturnPath parameter. The
ReturnPath parameter is never overwritten. This email address must
be either individually verified with Amazon SES, or from a domain that
has been verified with Amazon SES.

:source_arn(String)
—

This parameter is used only for sending authorization. It is the ARN
of the identity that is associated with the sending authorization
policy that permits you to send for the email address specified in the
Source parameter.

For example, if the owner of example.com (which has ARN
arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a
policy to it that authorizes you to send from user@example.com, then
you would specify the SourceArn to be
arn:aws:ses:us-east-1:123456789012:identity/example.com, and the
Source to be user@example.com.

This parameter is used only for sending authorization. It is the ARN
of the identity that is associated with the sending authorization
policy that permits you to use the email address specified in the
ReturnPath parameter.

For example, if the owner of example.com (which has ARN
arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a
policy to it that authorizes you to use feedback@example.com, then
you would specify the ReturnPathArn to be
arn:aws:ses:us-east-1:123456789012:identity/example.com, and the
ReturnPath to be feedback@example.com.

A list of tags, in the form of name/value pairs, to apply to an email
that you send using SendTemplatedEmail. Tags correspond to
characteristics of the email that you define, so that you can publish
email sending events.

:configuration_set_name(String)
—

The name of the configuration set to use when you send an email using
SendTemplatedEmail.

:template(required, String)
—

The template to use when sending this email.

:template_arn(String)
—

The ARN of the template to use when sending this email.

:template_data(required, String)
—

A list of replacement values to apply to the template. This parameter
is a JSON object, typically consisting of key-value pairs in which the
keys correspond to replacement tags in the email template.

#set_identity_dkim_enabled(params = {}) ⇒ Struct

If Easy DKIM signing is enabled for a domain name identity (such as
example.com), then Amazon SES will DKIM-sign all email sent by
addresses under that domain name (for example, user@example.com).

If Easy DKIM signing is enabled for an email address, then Amazon
SES will DKIM-sign all email sent by that email address.

For email addresses (for example, user@example.com), you can only
enable Easy DKIM signing if the corresponding domain (in this case,
example.com) has been set up for Easy DKIM using the AWS Console or
the VerifyDomainDkim operation.

#set_identity_feedback_forwarding_enabled(params = {}) ⇒ Struct

Given an identity (an email address or a 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.

Feedback forwarding does not apply to delivery notifications. Delivery
notifications are only available through Amazon SNS.

The identity for which to set bounce and complaint notification
forwarding. Examples: user@example.com, example.com.

:forwarding_enabled(required, Boolean)
—

Sets whether Amazon SES will forward bounce and complaint
notifications as email. true specifies that Amazon SES will forward
bounce and complaint notifications as email, in addition to any Amazon
SNS topic publishing otherwise specified. false specifies that
Amazon SES will publish bounce and complaint notifications only
through Amazon SNS. This value can only be set to false when Amazon
SNS topics are set for both Bounce and Complaint notification
types.

# The following example configures Amazon SES to include the original email headers in the Amazon SNS bounce notifications
# for an identity:
resp=client.set_identity_headers_in_notifications_enabled({enabled:true,identity:"user@example.com",notification_type:"Bounce",})

The identity for which to enable or disable headers in notifications.
Examples: user@example.com, example.com.

:notification_type(required, String)
—

The notification type for which to enable or disable headers in
notifications.

:enabled(required, Boolean)
—

Sets whether Amazon SES includes the original email headers in Amazon
SNS notifications of the specified notification type. A value of
true specifies that Amazon SES will include headers in
notifications, and a value of false specifies that Amazon SES will
not include headers in notifications.

This value can only be set when NotificationType is already set to
use a particular Amazon SNS topic.

#set_identity_mail_from_domain(params = {}) ⇒ Struct

Enables or disables the custom MAIL FROM domain setup for a verified
identity (an email address or a domain).

To send emails using the specified MAIL FROM domain, you must add an
MX record to your MAIL FROM domain's DNS settings. If you want your
emails to pass Sender Policy Framework (SPF) checks, you must also add
or update an SPF record. For more information, see the Amazon SES
Developer Guide.

You can execute this operation no more than once per second.

Examples:

Example: SetIdentityMailFromDomain

# The following example configures Amazon SES to use a custom MAIL FROM domain for an identity:
resp=client.set_identity_mail_from_domain({behavior_on_mx_failure:"UseDefaultValue",identity:"user@example.com",mail_from_domain:"bounces.example.com",})

The verified identity for which you want to enable or disable the
specified custom MAIL FROM domain.

:mail_from_domain(String)
—

The custom MAIL FROM domain that you want the verified identity to
use. The MAIL FROM domain must 1) be a subdomain of the verified
identity, 2) not be used in a "From" address if the MAIL FROM domain
is the destination of email feedback forwarding (for more information,
see the Amazon SES Developer Guide), and 3) not be used to
receive emails. A value of null disables the custom MAIL FROM
setting for the identity.

:behavior_on_mx_failure(String)
—

The action that you want Amazon SES to take if it cannot successfully
read the required MX record when you send an email. If you choose
UseDefaultValue, Amazon SES will use amazonses.com (or a subdomain
of that) as the MAIL FROM domain. If you choose RejectMessage,
Amazon SES will return a MailFromDomainNotVerified error and not
send the email.

The action specified in BehaviorOnMXFailure is taken when the custom
MAIL FROM domain setup is in the Pending, Failed, and
TemporaryFailure states.

#set_identity_notification_topic(params = {}) ⇒ Struct

Given an identity (an email address or a 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.

Unless feedback forwarding is enabled, you must specify Amazon SNS
topics for bounce and complaint notifications. For more information,
see SetIdentityFeedbackForwardingEnabled.

# The following example sets the Amazon SNS topic to which Amazon SES will publish bounce, complaint, and/or delivery
# notifications for emails sent with the specified identity as the Source:
resp=client.set_identity_notification_topic({identity:"user@example.com",notification_type:"Bounce",sns_topic:"arn:aws:sns:us-west-2:111122223333:MyTopic",})

The identity for which the Amazon SNS topic will be set. You can
specify an identity by using its name or by using its Amazon Resource
Name (ARN). Examples: user@example.com, example.com,
arn:aws:ses:us-east-1:123456789012:identity/example.com.

:notification_type(required, String)
—

The type of notifications that will be published to the specified
Amazon SNS topic.

:sns_topic(String)
—

The Amazon Resource Name (ARN) of the Amazon SNS topic. If the
parameter is omitted from the request or a null value is passed,
SnsTopic is cleared and publishing is disabled.

# The following example sets the position of a receipt rule in a receipt rule set:
resp=client.set_receipt_rule_position({after:"PutRuleAfterThisRule",rule_name:"RuleToReposition",rule_set_name:"MyRuleSet",})

#update_configuration_set_event_destination(params = {}) ⇒ Struct

Updates the event destination of a configuration set. Event
destinations are associated with configuration sets, which enable you
to publish email sending events to Amazon CloudWatch, Amazon Kinesis
Firehose, or Amazon Simple Notification Service (Amazon SNS). For
information about using configuration sets, see Monitoring Your
Amazon SES Sending Activity in the Amazon SES Developer Guide.

When you create or update an event destination, you must provide one,
and only one, destination. The destination can be Amazon CloudWatch,
Amazon Kinesis Firehose, or Amazon Simple Notification Service (Amazon
SNS).

Enables or disables the publishing of reputation metrics for emails
sent using a specific configuration set. Reputation metrics include
bounce and complaint rates. These metrics are published to Amazon
CloudWatch. By using Amazon CloudWatch, you can create alarms when
bounce or complaint rates exceed a certain threshold.

You can execute this operation no more than once per second.

Examples:

Example: UpdateConfigurationSetReputationMetricsEnabled

# Set the reputationMetricsEnabled flag for a specific configuration set.
resp=client.update_configuration_set_reputation_metrics_enabled({configuration_set_name:"foo",enabled:true,})

#update_configuration_set_sending_enabled(params = {}) ⇒ Struct

Enables or disables email sending for messages sent using a specific
configuration set. You can use this operation in conjunction with
Amazon CloudWatch alarms to temporarily pause email sending for a
configuration set when the reputation metrics for that configuration
set (such as your bounce on complaint rate) reach certain thresholds.

You can execute this operation no more than once per second.

Examples:

Example: UpdateConfigurationSetReputationMetricsEnabled

# Set the sending enabled flag for a specific configuration set.
resp=client.update_configuration_set_sending_enabled({configuration_set_name:"foo",enabled:true,})

The name of the custom verification email template that you want to
update.

:from_email_address(String)
—

The email address that the custom verification email is sent from.

:template_subject(String)
—

The subject line of the custom verification email.

:template_content(String)
—

The content of the custom verification email. The total size of the
email must be less than 10 MB. The message body may contain HTML, with
some limitations. For more information, see Custom Verification Email
Frequently Asked Questions in the Amazon SES Developer Guide.

:success_redirection_url(String)
—

The URL that the recipient of the verification email is sent to if his
or her address is successfully verified.

:failure_redirection_url(String)
—

The URL that the recipient of the verification email is sent to if his
or her address is not successfully verified.

#update_receipt_rule(params = {}) ⇒ Struct

# The following example updates a receipt rule to use an Amazon S3 action:
resp=client.update_receipt_rule({rule:{actions:[{s3_action:{bucket_name:"MyBucket",object_key_prefix:"email",},},],enabled:true,name:"MyRule",scan_enabled:true,tls_policy:"Optional",},rule_set_name:"MyRuleSet",})

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.

You can execute this operation no more than once per second.

To enable or disable Easy DKIM signing for a domain, use the
SetIdentityDkimEnabled operation.

# The following example generates DKIM tokens for a domain that has been verified with Amazon SES:
resp=client.verify_domain_dkim({domain:"example.com",})resp.to_houtputsthefollowing:{dkim_tokens:["EXAMPLEq76owjnks3lnluwg65scbemvw","EXAMPLEi3dnsj67hstzaj673klariwx2","EXAMPLEwfbtcukvimehexktmdtaz6naj",],}

Adds a domain to the list of identities for your Amazon SES account
and attempts to verify it. For more information about verifying
domains, see Verifying Email Addresses and Domains in the Amazon
SES Developer Guide.

You can execute this operation no more than once per second.

Examples:

Example: VerifyDomainIdentity

# The following example starts the domain verification process with Amazon SES:
resp=client.verify_domain_identity({domain:"example.com",})resp.to_houtputsthefollowing:{verification_token:"eoEmxw+YaYhb3h3iVJHuXMJXqeu1q1/wwmvjuEXAMPLE",}