# Data Types
<a name="API_Types"></a>

The Amazon Simple Email Service API contains several data types that various actions use. This section describes each data type in detail.

**Note**  
The order of each element in a data type structure is not guaranteed. Applications should not assume a particular order.

The following data types are supported:
+  [AccountDetails](API_AccountDetails.md) 
+  [ArchivingOptions](API_ArchivingOptions.md) 
+  [Attachment](API_Attachment.md) 
+  [BatchGetMetricDataQuery](API_BatchGetMetricDataQuery.md) 
+  [BlacklistEntry](API_BlacklistEntry.md) 
+  [Body](API_Body.md) 
+  [Bounce](API_Bounce.md) 
+  [BulkEmailContent](API_BulkEmailContent.md) 
+  [BulkEmailEntry](API_BulkEmailEntry.md) 
+  [BulkEmailEntryResult](API_BulkEmailEntryResult.md) 
+  [CloudWatchDestination](API_CloudWatchDestination.md) 
+  [CloudWatchDimensionConfiguration](API_CloudWatchDimensionConfiguration.md) 
+  [Complaint](API_Complaint.md) 
+  [Contact](API_Contact.md) 
+  [ContactList](API_ContactList.md) 
+  [ContactListDestination](API_ContactListDestination.md) 
+  [Content](API_Content.md) 
+  [CustomVerificationEmailTemplateMetadata](API_CustomVerificationEmailTemplateMetadata.md) 
+  [DailyVolume](API_DailyVolume.md) 
+  [DashboardAttributes](API_DashboardAttributes.md) 
+  [DashboardOptions](API_DashboardOptions.md) 
+  [DedicatedIp](API_DedicatedIp.md) 
+  [DedicatedIpPool](API_DedicatedIpPool.md) 
+  [DeliverabilityTestReport](API_DeliverabilityTestReport.md) 
+  [DeliveryOptions](API_DeliveryOptions.md) 
+  [Destination](API_Destination.md) 
+  [Details](API_Details.md) 
+  [DkimAttributes](API_DkimAttributes.md) 
+  [DkimSigningAttributes](API_DkimSigningAttributes.md) 
+  [DomainDeliverabilityCampaign](API_DomainDeliverabilityCampaign.md) 
+  [DomainDeliverabilityTrackingOption](API_DomainDeliverabilityTrackingOption.md) 
+  [DomainIspPlacement](API_DomainIspPlacement.md) 
+  [EmailAddressInsightsMailboxEvaluations](API_EmailAddressInsightsMailboxEvaluations.md) 
+  [EmailAddressInsightsVerdict](API_EmailAddressInsightsVerdict.md) 
+  [EmailContent](API_EmailContent.md) 
+  [EmailInsights](API_EmailInsights.md) 
+  [EmailTemplateContent](API_EmailTemplateContent.md) 
+  [EmailTemplateMetadata](API_EmailTemplateMetadata.md) 
+  [EventBridgeDestination](API_EventBridgeDestination.md) 
+  [EventDestination](API_EventDestination.md) 
+  [EventDestinationDefinition](API_EventDestinationDefinition.md) 
+  [EventDetails](API_EventDetails.md) 
+  [ExportDataSource](API_ExportDataSource.md) 
+  [ExportDestination](API_ExportDestination.md) 
+  [ExportJobSummary](API_ExportJobSummary.md) 
+  [ExportMetric](API_ExportMetric.md) 
+  [ExportStatistics](API_ExportStatistics.md) 
+  [FailureInfo](API_FailureInfo.md) 
+  [GuardianAttributes](API_GuardianAttributes.md) 
+  [GuardianOptions](API_GuardianOptions.md) 
+  [IdentityInfo](API_IdentityInfo.md) 
+  [ImportDataSource](API_ImportDataSource.md) 
+  [ImportDestination](API_ImportDestination.md) 
+  [ImportJobSummary](API_ImportJobSummary.md) 
+  [InboxPlacementTrackingOption](API_InboxPlacementTrackingOption.md) 
+  [InsightsEvent](API_InsightsEvent.md) 
+  [IspPlacement](API_IspPlacement.md) 
+  [KinesisFirehoseDestination](API_KinesisFirehoseDestination.md) 
+  [ListContactsFilter](API_ListContactsFilter.md) 
+  [ListManagementOptions](API_ListManagementOptions.md) 
+  [MailboxValidation](API_MailboxValidation.md) 
+  [MailFromAttributes](API_MailFromAttributes.md) 
+  [Message](API_Message.md) 
+  [MessageHeader](API_MessageHeader.md) 
+  [MessageInsightsDataSource](API_MessageInsightsDataSource.md) 
+  [MessageInsightsFilters](API_MessageInsightsFilters.md) 
+  [MessageTag](API_MessageTag.md) 
+  [MetricDataError](API_MetricDataError.md) 
+  [MetricDataResult](API_MetricDataResult.md) 
+  [MetricsDataSource](API_MetricsDataSource.md) 
+  [MultiRegionEndpoint](API_MultiRegionEndpoint.md) 
+  [OverallVolume](API_OverallVolume.md) 
+  [PinpointDestination](API_PinpointDestination.md) 
+  [PlacementStatistics](API_PlacementStatistics.md) 
+  [RawMessage](API_RawMessage.md) 
+  [Recommendation](API_Recommendation.md) 
+  [ReplacementEmailContent](API_ReplacementEmailContent.md) 
+  [ReplacementTemplate](API_ReplacementTemplate.md) 
+  [ReputationEntity](API_ReputationEntity.md) 
+  [ReputationOptions](API_ReputationOptions.md) 
+  [ResourceTenantMetadata](API_ResourceTenantMetadata.md) 
+  [ReviewDetails](API_ReviewDetails.md) 
+  [Route](API_Route.md) 
+  [RouteDetails](API_RouteDetails.md) 
+  [SendingOptions](API_SendingOptions.md) 
+  [SendQuota](API_SendQuota.md) 
+  [SnsDestination](API_SnsDestination.md) 
+  [SOARecord](API_SOARecord.md) 
+  [StatusRecord](API_StatusRecord.md) 
+  [SuppressedDestination](API_SuppressedDestination.md) 
+  [SuppressedDestinationAttributes](API_SuppressedDestinationAttributes.md) 
+  [SuppressedDestinationSummary](API_SuppressedDestinationSummary.md) 
+  [SuppressionAttributes](API_SuppressionAttributes.md) 
+  [SuppressionConditionThreshold](API_SuppressionConditionThreshold.md) 
+  [SuppressionConfidenceThreshold](API_SuppressionConfidenceThreshold.md) 
+  [SuppressionListDestination](API_SuppressionListDestination.md) 
+  [SuppressionOptions](API_SuppressionOptions.md) 
+  [SuppressionValidationAttributes](API_SuppressionValidationAttributes.md) 
+  [SuppressionValidationOptions](API_SuppressionValidationOptions.md) 
+  [Tag](API_Tag.md) 
+  [Template](API_Template.md) 
+  [Tenant](API_Tenant.md) 
+  [TenantInfo](API_TenantInfo.md) 
+  [TenantResource](API_TenantResource.md) 
+  [Topic](API_Topic.md) 
+  [TopicFilter](API_TopicFilter.md) 
+  [TopicPreference](API_TopicPreference.md) 
+  [TrackingOptions](API_TrackingOptions.md) 
+  [VdmAttributes](API_VdmAttributes.md) 
+  [VdmOptions](API_VdmOptions.md) 
+  [VerificationInfo](API_VerificationInfo.md) 
+  [VolumeStatistics](API_VolumeStatistics.md) 

# AccountDetails
<a name="API_AccountDetails"></a>

An object that contains information about your account details.

## Contents
<a name="API_AccountDetails_Contents"></a>

 ** AdditionalContactEmailAddresses **   <a name="SES-Type-AccountDetails-AdditionalContactEmailAddresses"></a>
Additional email addresses where updates are sent about your account review process.  
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 4 items.  
Length Constraints: Minimum length of 6. Maximum length of 254.  
Pattern: `^(.+)@(.+)$`   
Required: No

 ** ContactLanguage **   <a name="SES-Type-AccountDetails-ContactLanguage"></a>
The language you would prefer for the case. The contact language can be one of `ENGLISH` or `JAPANESE`.  
Type: String  
Valid Values: `EN | JA`   
Required: No

 ** MailType **   <a name="SES-Type-AccountDetails-MailType"></a>
The type of email your account is sending. The mail type can be one of the following:  
+  `MARKETING` – Most of your sending traffic is to keep your customers informed of your latest offering.
+  `TRANSACTIONAL` – Most of your sending traffic is to communicate during a transaction with a customer.
Type: String  
Valid Values: `MARKETING | TRANSACTIONAL`   
Required: No

 ** ReviewDetails **   <a name="SES-Type-AccountDetails-ReviewDetails"></a>
Information about the review of the latest details you submitted.  
Type: [ReviewDetails](API_ReviewDetails.md) object  
Required: No

 ** UseCaseDescription **   <a name="SES-Type-AccountDetails-UseCaseDescription"></a>
 *This member has been deprecated.*   
A description of the types of email that you plan to send.  
Type: String  
Length Constraints: Maximum length of 5000.  
Required: No

 ** WebsiteURL **   <a name="SES-Type-AccountDetails-WebsiteURL"></a>
The URL of your website. This information helps us better understand the type of content that you plan to send.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1000.  
Pattern: `^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?`   
Required: No

## See Also
<a name="API_AccountDetails_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/AccountDetails) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/AccountDetails) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/AccountDetails) 

# ArchivingOptions
<a name="API_ArchivingOptions"></a>

Used to associate a configuration set with a MailManager archive.

## Contents
<a name="API_ArchivingOptions_Contents"></a>

 ** ArchiveArn **   <a name="SES-Type-ArchivingOptions-ArchiveArn"></a>
The Amazon Resource Name (ARN) of the MailManager archive where the Amazon SES API v2 will archive sent emails.  
Type: String  
Length Constraints: Minimum length of 20. Maximum length of 1011.  
Pattern: `arn:(aws|aws-[a-z-]+):ses:[a-z]{2,4}-[a-z-]+-[0-9]:[0-9]{1,20}:mailmanager-archive/a-[a-z0-9]{24,62}`   
Required: No

## See Also
<a name="API_ArchivingOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ArchivingOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ArchivingOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ArchivingOptions) 

# Attachment
<a name="API_Attachment"></a>

 Contains metadata and attachment raw content.

## Contents
<a name="API_Attachment_Contents"></a>

 ** FileName **   <a name="SES-Type-Attachment-FileName"></a>
The file name for the attachment as it will appear in the email. Amazon SES restricts certain file extensions. To ensure attachments are accepted, check the [Unsupported attachment types](https://docs.aws.amazon.com/ses/latest/dg/mime-types.html) in the Amazon SES Developer Guide.  
Type: String  
Length Constraints: Maximum length of 255.  
Required: Yes

 ** RawContent **   <a name="SES-Type-Attachment-RawContent"></a>
 The raw data of the attachment. It needs to be base64-encoded if you are accessing Amazon SES directly through the HTTPS interface. If you are accessing Amazon SES using an AWS SDK, the SDK takes care of the base 64-encoding for you.  
Type: Base64-encoded binary data object  
Required: Yes

 ** ContentDescription **   <a name="SES-Type-Attachment-ContentDescription"></a>
 A brief description of the attachment content.  
Type: String  
Length Constraints: Maximum length of 1000.  
Required: No

 ** ContentDisposition **   <a name="SES-Type-Attachment-ContentDisposition"></a>
 A standard descriptor indicating how the attachment should be rendered in the email. Supported values: `ATTACHMENT` or `INLINE`.  
Type: String  
Valid Values: `ATTACHMENT | INLINE`   
Required: No

 ** ContentId **   <a name="SES-Type-Attachment-ContentId"></a>
 Unique identifier for the attachment, used for referencing attachments with INLINE disposition in HTML content.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 78.  
Required: No

 ** ContentTransferEncoding **   <a name="SES-Type-Attachment-ContentTransferEncoding"></a>
 Specifies how the attachment is encoded. Supported values: `BASE64`, `QUOTED_PRINTABLE`, `SEVEN_BIT`.  
Type: String  
Valid Values: `BASE64 | QUOTED_PRINTABLE | SEVEN_BIT`   
Required: No

 ** ContentType **   <a name="SES-Type-Attachment-ContentType"></a>
 The MIME type of the attachment.  
Example: `application/pdf`, `image/jpeg` 
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 78.  
Required: No

## See Also
<a name="API_Attachment_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/Attachment) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/Attachment) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/Attachment) 

# BatchGetMetricDataQuery
<a name="API_BatchGetMetricDataQuery"></a>

Represents a single metric data query to include in a batch.

## Contents
<a name="API_BatchGetMetricDataQuery_Contents"></a>

 ** EndDate **   <a name="SES-Type-BatchGetMetricDataQuery-EndDate"></a>
Represents the end date for the query interval.  
Type: Timestamp  
Required: Yes

 ** Id **   <a name="SES-Type-BatchGetMetricDataQuery-Id"></a>
The query identifier.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: Yes

 ** Metric **   <a name="SES-Type-BatchGetMetricDataQuery-Metric"></a>
The queried metric. This can be one of the following:  
+  `SEND` – Emails sent eligible for tracking in the VDM dashboard. This excludes emails sent to the mailbox simulator and emails addressed to more than one recipient.
+  `COMPLAINT` – Complaints received for your account. This excludes complaints from the mailbox simulator, those originating from your account-level suppression list (if enabled), and those for emails addressed to more than one recipient
+  `PERMANENT_BOUNCE` – Permanent bounces - i.e. feedback received for emails sent to non-existent mailboxes. Excludes bounces from the mailbox simulator, those originating from your account-level suppression list (if enabled), and those for emails addressed to more than one recipient.
+  `TRANSIENT_BOUNCE` – Transient bounces - i.e. feedback received for delivery failures excluding issues with non-existent mailboxes. Excludes bounces from the mailbox simulator, and those for emails addressed to more than one recipient.
+  `OPEN` – Unique open events for emails including open trackers. Excludes opens for emails addressed to more than one recipient.
+  `CLICK` – Unique click events for emails including wrapped links. Excludes clicks for emails addressed to more than one recipient.
+  `DELIVERY` – Successful deliveries for email sending attempts. Excludes deliveries to the mailbox simulator and for emails addressed to more than one recipient.
+  `DELIVERY_OPEN` – Successful deliveries for email sending attempts. Excludes deliveries to the mailbox simulator, for emails addressed to more than one recipient, and emails without open trackers.
+  `DELIVERY_CLICK` – Successful deliveries for email sending attempts. Excludes deliveries to the mailbox simulator, for emails addressed to more than one recipient, and emails without click trackers.
+  `DELIVERY_COMPLAINT` – Successful deliveries for email sending attempts. Excludes deliveries to the mailbox simulator, for emails addressed to more than one recipient, and emails addressed to recipients hosted by ISPs with which Amazon SES does not have a feedback loop agreement.
Type: String  
Valid Values: `SEND | COMPLAINT | PERMANENT_BOUNCE | TRANSIENT_BOUNCE | OPEN | CLICK | DELIVERY | DELIVERY_OPEN | DELIVERY_CLICK | DELIVERY_COMPLAINT`   
Required: Yes

 ** Namespace **   <a name="SES-Type-BatchGetMetricDataQuery-Namespace"></a>
The query namespace - e.g. `VDM`   
Type: String  
Valid Values: `VDM`   
Required: Yes

 ** StartDate **   <a name="SES-Type-BatchGetMetricDataQuery-StartDate"></a>
Represents the start date for the query interval.  
Type: Timestamp  
Required: Yes

 ** Dimensions **   <a name="SES-Type-BatchGetMetricDataQuery-Dimensions"></a>
An object that contains mapping between `MetricDimensionName` and `MetricDimensionValue` to filter metrics by.  
Type: String to string map  
Map Entries: Maximum number of 3 items.  
Valid Keys: `EMAIL_IDENTITY | CONFIGURATION_SET | ISP`   
Required: No

## See Also
<a name="API_BatchGetMetricDataQuery_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/BatchGetMetricDataQuery) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/BatchGetMetricDataQuery) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/BatchGetMetricDataQuery) 

# BlacklistEntry
<a name="API_BlacklistEntry"></a>

An object that contains information about a blacklisting event that impacts one of the dedicated IP addresses that is associated with your account.

## Contents
<a name="API_BlacklistEntry_Contents"></a>

 ** Description **   <a name="SES-Type-BlacklistEntry-Description"></a>
Additional information about the blacklisting event, as provided by the blacklist maintainer.  
Type: String  
Required: No

 ** ListingTime **   <a name="SES-Type-BlacklistEntry-ListingTime"></a>
The time when the blacklisting event occurred.  
Type: Timestamp  
Required: No

 ** RblName **   <a name="SES-Type-BlacklistEntry-RblName"></a>
The name of the blacklist that the IP address appears on.  
Type: String  
Required: No

## See Also
<a name="API_BlacklistEntry_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/BlacklistEntry) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/BlacklistEntry) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/BlacklistEntry) 

# Body
<a name="API_Body"></a>

Represents the body of the email message.

## Contents
<a name="API_Body_Contents"></a>

 ** Html **   <a name="SES-Type-Body-Html"></a>
An object that represents the version of the message that is displayed in email clients that support HTML. HTML messages can include formatted text, hyperlinks, images, and more.   
Type: [Content](API_Content.md) object  
Required: No

 ** Text **   <a name="SES-Type-Body-Text"></a>
An object that represents the version of the message that is displayed in email clients that don't support HTML, or clients where the recipient has disabled HTML rendering.  
Type: [Content](API_Content.md) object  
Required: No

## See Also
<a name="API_Body_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/Body) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/Body) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/Body) 

# Bounce
<a name="API_Bounce"></a>

Information about a `Bounce` event.

## Contents
<a name="API_Bounce_Contents"></a>

 ** BounceSubType **   <a name="SES-Type-Bounce-BounceSubType"></a>
The subtype of the bounce, as determined by SES.  
Type: String  
Required: No

 ** BounceType **   <a name="SES-Type-Bounce-BounceType"></a>
The type of the bounce, as determined by SES. Can be one of `UNDETERMINED`, `TRANSIENT`, or `PERMANENT`   
Type: String  
Valid Values: `UNDETERMINED | TRANSIENT | PERMANENT`   
Required: No

 ** DiagnosticCode **   <a name="SES-Type-Bounce-DiagnosticCode"></a>
The status code issued by the reporting Message Transfer Authority (MTA). This field only appears if a delivery status notification (DSN) was attached to the bounce and the `Diagnostic-Code` was provided in the DSN.   
Type: String  
Required: No

## See Also
<a name="API_Bounce_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/Bounce) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/Bounce) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/Bounce) 

# BulkEmailContent
<a name="API_BulkEmailContent"></a>

An object that contains the body of the message. You can specify a template message.

## Contents
<a name="API_BulkEmailContent_Contents"></a>

 ** Template **   <a name="SES-Type-BulkEmailContent-Template"></a>
The template to use for the bulk email message.  
Type: [Template](API_Template.md) object  
Required: No

## See Also
<a name="API_BulkEmailContent_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/BulkEmailContent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/BulkEmailContent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/BulkEmailContent) 

# BulkEmailEntry
<a name="API_BulkEmailEntry"></a>

## Contents
<a name="API_BulkEmailEntry_Contents"></a>

 ** Destination **   <a name="SES-Type-BulkEmailEntry-Destination"></a>
Represents the destination of the message, consisting of To:, CC:, and BCC: fields.  
Amazon SES does not support the SMTPUTF8 extension, as described in [RFC6531](https://tools.ietf.org/html/rfc6531). For this reason, the local part of a destination email address (the part of the email address that precedes the @ sign) may only contain [7-bit ASCII characters](https://en.wikipedia.org/wiki/Email_address#Local-part). 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](https://tools.ietf.org/html/rfc3492.html).
Type: [Destination](API_Destination.md) object  
Required: Yes

 ** ReplacementEmailContent **   <a name="SES-Type-BulkEmailEntry-ReplacementEmailContent"></a>
The `ReplacementEmailContent` associated with a `BulkEmailEntry`.  
Type: [ReplacementEmailContent](API_ReplacementEmailContent.md) object  
Required: No

 ** ReplacementHeaders **   <a name="SES-Type-BulkEmailEntry-ReplacementHeaders"></a>
The list of message headers associated with the `BulkEmailEntry` data type.  
+ Headers Not Present in `BulkEmailEntry`: If a header is specified in [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Template.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Template.html) but not in `BulkEmailEntry`, the header from `Template` will be added to the outgoing email.
+ Headers Present in `BulkEmailEntry`: If a header is specified in `BulkEmailEntry`, it takes precedence over any header of the same name specified in [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Template.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Template.html):
  + If the header is also defined within `Template`, the value from `BulkEmailEntry` will replace the header's value in the email.
  + If the header is not defined within `Template`, it will simply be added to the email as specified in `BulkEmailEntry`.
Type: Array of [MessageHeader](API_MessageHeader.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 15 items.  
Required: No

 ** ReplacementTags **   <a name="SES-Type-BulkEmailEntry-ReplacementTags"></a>
A list of tags, in the form of name/value pairs, to apply to an email that you send using the `SendBulkTemplatedEmail` operation. Tags correspond to characteristics of the email that you define, so that you can publish email sending events.  
Type: Array of [MessageTag](API_MessageTag.md) objects  
Required: No

## See Also
<a name="API_BulkEmailEntry_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/BulkEmailEntry) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/BulkEmailEntry) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/BulkEmailEntry) 

# BulkEmailEntryResult
<a name="API_BulkEmailEntryResult"></a>

The result of the `SendBulkEmail` operation of each specified `BulkEmailEntry`.

## Contents
<a name="API_BulkEmailEntryResult_Contents"></a>

 ** Error **   <a name="SES-Type-BulkEmailEntryResult-Error"></a>
A description of an error that prevented a message being sent using the `SendBulkTemplatedEmail` operation.  
Type: String  
Required: No

 ** MessageId **   <a name="SES-Type-BulkEmailEntryResult-MessageId"></a>
The unique message identifier returned from the `SendBulkTemplatedEmail` operation.  
Type: String  
Required: No

 ** Status **   <a name="SES-Type-BulkEmailEntryResult-Status"></a>
The status of a message sent using the `SendBulkTemplatedEmail` operation.  
Possible values for this parameter include:  
+ SUCCESS: Amazon SES accepted the message, and will attempt to deliver it to the recipients.
+ MESSAGE\$1REJECTED: The message was rejected because it contained a virus.
+ MAIL\$1FROM\$1DOMAIN\$1NOT\$1VERIFIED: The sender's email address or domain was not verified.
+ CONFIGURATION\$1SET\$1DOES\$1NOT\$1EXIST: The configuration set you specified does not exist.
+ TEMPLATE\$1DOES\$1NOT\$1EXIST: The template you specified does not exist.
+ ACCOUNT\$1SUSPENDED: Your account has been shut down because of issues related to your email sending practices.
+ ACCOUNT\$1THROTTLED: The number of emails you can send has been reduced because your account has exceeded its allocated sending limit.
+ ACCOUNT\$1DAILY\$1QUOTA\$1EXCEEDED: You have reached or exceeded the maximum number of emails you can send from your account in a 24-hour period.
+ INVALID\$1SENDING\$1POOL\$1NAME: The configuration set you specified refers to an IP pool that does not exist.
+ ACCOUNT\$1SENDING\$1PAUSED: Email sending for the Amazon SES account was disabled using the [UpdateAccountSendingEnabled](https://docs.aws.amazon.com/ses/latest/APIReference/API_UpdateAccountSendingEnabled.html) operation.
+ CONFIGURATION\$1SET\$1SENDING\$1PAUSED: Email sending for this configuration set was disabled using the [UpdateConfigurationSetSendingEnabled](https://docs.aws.amazon.com/ses/latest/APIReference/API_UpdateConfigurationSetSendingEnabled.html) operation.
+ INVALID\$1PARAMETER\$1VALUE: One or more of the parameters you specified when calling this operation was invalid. See the error message for additional information.
+ TRANSIENT\$1FAILURE: Amazon SES was unable to process your request because of a temporary issue.
+ FAILED: Amazon SES was unable to process your request. See the error message for additional information.
Type: String  
Valid Values: `SUCCESS | MESSAGE_REJECTED | MAIL_FROM_DOMAIN_NOT_VERIFIED | CONFIGURATION_SET_NOT_FOUND | TEMPLATE_NOT_FOUND | ACCOUNT_SUSPENDED | ACCOUNT_THROTTLED | ACCOUNT_DAILY_QUOTA_EXCEEDED | INVALID_SENDING_POOL_NAME | ACCOUNT_SENDING_PAUSED | CONFIGURATION_SET_SENDING_PAUSED | INVALID_PARAMETER | TRANSIENT_FAILURE | FAILED`   
Required: No

## See Also
<a name="API_BulkEmailEntryResult_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/BulkEmailEntryResult) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/BulkEmailEntryResult) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/BulkEmailEntryResult) 

# CloudWatchDestination
<a name="API_CloudWatchDestination"></a>

An object that defines an Amazon CloudWatch destination for email events. You can use Amazon CloudWatch to monitor and gain insights on your email sending metrics.

## Contents
<a name="API_CloudWatchDestination_Contents"></a>

 ** DimensionConfigurations **   <a name="SES-Type-CloudWatchDestination-DimensionConfigurations"></a>
An array of objects that define the dimensions to use when you send email events to Amazon CloudWatch.  
Type: Array of [CloudWatchDimensionConfiguration](API_CloudWatchDimensionConfiguration.md) objects  
Required: Yes

## See Also
<a name="API_CloudWatchDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CloudWatchDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CloudWatchDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CloudWatchDestination) 

# CloudWatchDimensionConfiguration
<a name="API_CloudWatchDimensionConfiguration"></a>

An object that defines the dimension configuration to use when you send email events to Amazon CloudWatch.

## Contents
<a name="API_CloudWatchDimensionConfiguration_Contents"></a>

 ** DefaultDimensionValue **   <a name="SES-Type-CloudWatchDimensionConfiguration-DefaultDimensionValue"></a>
The default value of the dimension that is published to Amazon CloudWatch if you don't provide the value of the dimension when you send an email. This value has to meet the following criteria:  
+ Can only contain ASCII letters (a–z, A–Z), numbers (0–9), underscores (\$1), or dashes (-), at signs (@), and periods (.).
+ It can contain no more than 255 characters.
Type: String  
Required: Yes

 ** DimensionName **   <a name="SES-Type-CloudWatchDimensionConfiguration-DimensionName"></a>
The name of an Amazon CloudWatch dimension associated with an email sending metric. The name has to meet the following criteria:  
+ It can only contain ASCII letters (a–z, A–Z), numbers (0–9), underscores (\$1), or dashes (-).
+ It can contain no more than 255 characters.
Type: String  
Required: Yes

 ** DimensionValueSource **   <a name="SES-Type-CloudWatchDimensionConfiguration-DimensionValueSource"></a>
The location where the Amazon SES API v2 finds the value of a dimension to publish to Amazon CloudWatch. To use the message tags that you specify using an `X-SES-MESSAGE-TAGS` header or a parameter to the `SendEmail` or `SendRawEmail` API, choose `messageTag`. To use your own email headers, choose `emailHeader`. To use link tags, choose `linkTags`.  
Type: String  
Valid Values: `MESSAGE_TAG | EMAIL_HEADER | LINK_TAG`   
Required: Yes

## See Also
<a name="API_CloudWatchDimensionConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CloudWatchDimensionConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CloudWatchDimensionConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CloudWatchDimensionConfiguration) 

# Complaint
<a name="API_Complaint"></a>

Information about a `Complaint` event.

## Contents
<a name="API_Complaint_Contents"></a>

 ** ComplaintFeedbackType **   <a name="SES-Type-Complaint-ComplaintFeedbackType"></a>
 The value of the `Feedback-Type` field from the feedback report received from the ISP.   
Type: String  
Required: No

 ** ComplaintSubType **   <a name="SES-Type-Complaint-ComplaintSubType"></a>
 Can either be `null` or `OnAccountSuppressionList`. If the value is `OnAccountSuppressionList`, SES accepted the message, but didn't attempt to send it because it was on the account-level suppression list.   
Type: String  
Required: No

## See Also
<a name="API_Complaint_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/Complaint) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/Complaint) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/Complaint) 

# Contact
<a name="API_Contact"></a>

A contact is the end-user who is receiving the email.

## Contents
<a name="API_Contact_Contents"></a>

 ** EmailAddress **   <a name="SES-Type-Contact-EmailAddress"></a>
The contact's email address.  
Type: String  
Required: No

 ** LastUpdatedTimestamp **   <a name="SES-Type-Contact-LastUpdatedTimestamp"></a>
A timestamp noting the last time the contact's information was updated.  
Type: Timestamp  
Required: No

 ** TopicDefaultPreferences **   <a name="SES-Type-Contact-TopicDefaultPreferences"></a>
The default topic preferences applied to the contact.  
Type: Array of [TopicPreference](API_TopicPreference.md) objects  
Required: No

 ** TopicPreferences **   <a name="SES-Type-Contact-TopicPreferences"></a>
The contact's preference for being opted-in to or opted-out of a topic.  
Type: Array of [TopicPreference](API_TopicPreference.md) objects  
Required: No

 ** UnsubscribeAll **   <a name="SES-Type-Contact-UnsubscribeAll"></a>
A boolean value status noting if the contact is unsubscribed from all contact list topics.  
Type: Boolean  
Required: No

## See Also
<a name="API_Contact_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/Contact) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/Contact) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/Contact) 

# ContactList
<a name="API_ContactList"></a>

A list that contains contacts that have subscribed to a particular topic or topics.

## Contents
<a name="API_ContactList_Contents"></a>

 ** ContactListName **   <a name="SES-Type-ContactList-ContactListName"></a>
The name of the contact list.  
Type: String  
Required: No

 ** LastUpdatedTimestamp **   <a name="SES-Type-ContactList-LastUpdatedTimestamp"></a>
A timestamp noting the last time the contact list was updated.  
Type: Timestamp  
Required: No

## See Also
<a name="API_ContactList_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ContactList) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ContactList) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ContactList) 

# ContactListDestination
<a name="API_ContactListDestination"></a>

An object that contains details about the action of a contact list.

## Contents
<a name="API_ContactListDestination_Contents"></a>

 ** ContactListImportAction **   <a name="SES-Type-ContactListDestination-ContactListImportAction"></a>
>The type of action to perform on the addresses. The following are the possible values:  
+ PUT: add the addresses to the contact list. If the record already exists, it will override it with the new value.
+ DELETE: remove the addresses from the contact list.
Type: String  
Valid Values: `DELETE | PUT`   
Required: Yes

 ** ContactListName **   <a name="SES-Type-ContactListDestination-ContactListName"></a>
The name of the contact list.  
Type: String  
Required: Yes

## See Also
<a name="API_ContactListDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ContactListDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ContactListDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ContactListDestination) 

# Content
<a name="API_Content"></a>

An object that represents the content of the email, and optionally a character set specification.

## Contents
<a name="API_Content_Contents"></a>

 ** Data **   <a name="SES-Type-Content-Data"></a>
The content of the message itself.  
Type: String  
Required: Yes

 ** Charset **   <a name="SES-Type-Content-Charset"></a>
The character set for the content. Because of the constraints of the SMTP protocol, Amazon SES uses 7-bit ASCII by default. If the text includes characters outside of the ASCII range, you have to specify a character set. For example, you could specify `UTF-8`, `ISO-8859-1`, or `Shift_JIS`.  
Type: String  
Required: No

## See Also
<a name="API_Content_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/Content) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/Content) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/Content) 

# CustomVerificationEmailTemplateMetadata
<a name="API_CustomVerificationEmailTemplateMetadata"></a>

Contains information about a custom verification email template.

## Contents
<a name="API_CustomVerificationEmailTemplateMetadata_Contents"></a>

 ** FailureRedirectionURL **   <a name="SES-Type-CustomVerificationEmailTemplateMetadata-FailureRedirectionURL"></a>
The URL that the recipient of the verification email is sent to if his or her address is not successfully verified.  
Type: String  
Required: No

 ** FromEmailAddress **   <a name="SES-Type-CustomVerificationEmailTemplateMetadata-FromEmailAddress"></a>
The email address that the custom verification email is sent from.  
Type: String  
Required: No

 ** SuccessRedirectionURL **   <a name="SES-Type-CustomVerificationEmailTemplateMetadata-SuccessRedirectionURL"></a>
The URL that the recipient of the verification email is sent to if his or her address is successfully verified.  
Type: String  
Required: No

 ** TemplateName **   <a name="SES-Type-CustomVerificationEmailTemplateMetadata-TemplateName"></a>
The name of the custom verification email template.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** TemplateSubject **   <a name="SES-Type-CustomVerificationEmailTemplateMetadata-TemplateSubject"></a>
The subject line of the custom verification email.  
Type: String  
Required: No

## See Also
<a name="API_CustomVerificationEmailTemplateMetadata_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/CustomVerificationEmailTemplateMetadata) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CustomVerificationEmailTemplateMetadata) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/CustomVerificationEmailTemplateMetadata) 

# DailyVolume
<a name="API_DailyVolume"></a>

An object that contains information about the volume of email sent on each day of the analysis period.

## Contents
<a name="API_DailyVolume_Contents"></a>

 ** DomainIspPlacements **   <a name="SES-Type-DailyVolume-DomainIspPlacements"></a>
An object that contains inbox placement metrics for a specified day in the analysis period, broken out by the recipient's email provider.  
Type: Array of [DomainIspPlacement](API_DomainIspPlacement.md) objects  
Required: No

 ** StartDate **   <a name="SES-Type-DailyVolume-StartDate"></a>
The date that the DailyVolume metrics apply to, in Unix time.  
Type: Timestamp  
Required: No

 ** VolumeStatistics **   <a name="SES-Type-DailyVolume-VolumeStatistics"></a>
An object that contains inbox placement metrics for a specific day in the analysis period.  
Type: [VolumeStatistics](API_VolumeStatistics.md) object  
Required: No

## See Also
<a name="API_DailyVolume_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DailyVolume) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DailyVolume) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DailyVolume) 

# DashboardAttributes
<a name="API_DashboardAttributes"></a>

An object containing additional settings for your VDM configuration as applicable to the Dashboard.

## Contents
<a name="API_DashboardAttributes_Contents"></a>

 ** EngagementMetrics **   <a name="SES-Type-DashboardAttributes-EngagementMetrics"></a>
Specifies the status of your VDM engagement metrics collection. Can be one of the following:  
+  `ENABLED` – Amazon SES enables engagement metrics for your account.
+  `DISABLED` – Amazon SES disables engagement metrics for your account.
Type: String  
Valid Values: `ENABLED | DISABLED`   
Required: No

## See Also
<a name="API_DashboardAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DashboardAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DashboardAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DashboardAttributes) 

# DashboardOptions
<a name="API_DashboardOptions"></a>

An object containing additional settings for your VDM configuration as applicable to the Dashboard.

## Contents
<a name="API_DashboardOptions_Contents"></a>

 ** EngagementMetrics **   <a name="SES-Type-DashboardOptions-EngagementMetrics"></a>
Specifies the status of your VDM engagement metrics collection. Can be one of the following:  
+  `ENABLED` – Amazon SES enables engagement metrics for the configuration set.
+  `DISABLED` – Amazon SES disables engagement metrics for the configuration set.
Type: String  
Valid Values: `ENABLED | DISABLED`   
Required: No

## See Also
<a name="API_DashboardOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DashboardOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DashboardOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DashboardOptions) 

# DedicatedIp
<a name="API_DedicatedIp"></a>

Contains information about a dedicated IP address that is associated with your Amazon SES account.

To learn more about requesting dedicated IP addresses, see [Requesting and Relinquishing Dedicated IP Addresses](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/dedicated-ip-case.html) in the *Amazon SES Developer Guide*.

## Contents
<a name="API_DedicatedIp_Contents"></a>

 ** Ip **   <a name="SES-Type-DedicatedIp-Ip"></a>
An IPv4 address.  
Type: String  
Required: Yes

 ** WarmupPercentage **   <a name="SES-Type-DedicatedIp-WarmupPercentage"></a>
Indicates the progress of your dedicated IP warm-up:  
+  `0-100` – For standard dedicated IP addresses, this shows the warm-up completion percentage. A value of 100 means the IP address is fully warmed up and ready for use.
+  `-1` – Appears for IP addresses in managed dedicated pools where Amazon SES automatically handles the warm-up process, making the percentage not applicable.
Type: Integer  
Required: Yes

 ** WarmupStatus **   <a name="SES-Type-DedicatedIp-WarmupStatus"></a>
The warm-up status of a dedicated IP address. The status can have one of the following values:  
+  `IN_PROGRESS` – The IP address isn't ready to use because the dedicated IP warm-up process is ongoing.
+  `DONE` – The dedicated IP warm-up process is complete, and the IP address is ready to use.
+  `NOT_APPLICABLE` – The warm-up status doesn't apply to this IP address. This status is used for IP addresses in managed dedicated IP pools, where Amazon SES automatically handles the warm-up process.
Type: String  
Valid Values: `IN_PROGRESS | DONE | NOT_APPLICABLE`   
Required: Yes

 ** PoolName **   <a name="SES-Type-DedicatedIp-PoolName"></a>
The name of the dedicated IP pool that the IP address is associated with.  
Type: String  
Required: No

## See Also
<a name="API_DedicatedIp_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DedicatedIp) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DedicatedIp) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DedicatedIp) 

# DedicatedIpPool
<a name="API_DedicatedIpPool"></a>

Contains information about a dedicated IP pool.

## Contents
<a name="API_DedicatedIpPool_Contents"></a>

 ** PoolName **   <a name="SES-Type-DedicatedIpPool-PoolName"></a>
The name of the dedicated IP pool.  
Type: String  
Required: Yes

 ** ScalingMode **   <a name="SES-Type-DedicatedIpPool-ScalingMode"></a>
The type of the dedicated IP pool.  
+  `STANDARD` – A dedicated IP pool where you can control which IPs are part of the pool.
+  `MANAGED` – A dedicated IP pool where the reputation and number of IPs are automatically managed by Amazon SES.
Type: String  
Valid Values: `STANDARD | MANAGED`   
Required: Yes

## See Also
<a name="API_DedicatedIpPool_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DedicatedIpPool) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DedicatedIpPool) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DedicatedIpPool) 

# DeliverabilityTestReport
<a name="API_DeliverabilityTestReport"></a>

An object that contains metadata related to a predictive inbox placement test.

## Contents
<a name="API_DeliverabilityTestReport_Contents"></a>

 ** CreateDate **   <a name="SES-Type-DeliverabilityTestReport-CreateDate"></a>
The date and time when the predictive inbox placement test was created.  
Type: Timestamp  
Required: No

 ** DeliverabilityTestStatus **   <a name="SES-Type-DeliverabilityTestReport-DeliverabilityTestStatus"></a>
The status of the predictive inbox placement test. If the status is `IN_PROGRESS`, then the predictive inbox placement test is currently running. Predictive inbox placement tests are usually complete within 24 hours of creating the test. If the status is `COMPLETE`, then the test is finished, and you can use the `GetDeliverabilityTestReport` to view the results of the test.  
Type: String  
Valid Values: `IN_PROGRESS | COMPLETED`   
Required: No

 ** FromEmailAddress **   <a name="SES-Type-DeliverabilityTestReport-FromEmailAddress"></a>
The sender address that you specified for the predictive inbox placement test.  
Type: String  
Required: No

 ** ReportId **   <a name="SES-Type-DeliverabilityTestReport-ReportId"></a>
A unique string that identifies the predictive inbox placement test.  
Type: String  
Required: No

 ** ReportName **   <a name="SES-Type-DeliverabilityTestReport-ReportName"></a>
A name that helps you identify a predictive inbox placement test report.  
Type: String  
Required: No

 ** Subject **   <a name="SES-Type-DeliverabilityTestReport-Subject"></a>
The subject line for an email that you submitted in a predictive inbox placement test.  
Type: String  
Required: No

## See Also
<a name="API_DeliverabilityTestReport_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DeliverabilityTestReport) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeliverabilityTestReport) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DeliverabilityTestReport) 

# DeliveryOptions
<a name="API_DeliveryOptions"></a>

Used to associate a configuration set with a dedicated IP pool.

## Contents
<a name="API_DeliveryOptions_Contents"></a>

 ** MaxDeliverySeconds **   <a name="SES-Type-DeliveryOptions-MaxDeliverySeconds"></a>
The maximum amount of time, in seconds, that Amazon SES API v2 will attempt delivery of email. If specified, the value must greater than or equal to 300 seconds (5 minutes) and less than or equal to 50400 seconds (840 minutes).   
Type: Long  
Valid Range: Minimum value of 300. Maximum value of 50400.  
Required: No

 ** SendingPoolName **   <a name="SES-Type-DeliveryOptions-SendingPoolName"></a>
The name of the dedicated IP pool to associate with the configuration set.  
Type: String  
Required: No

 ** TlsPolicy **   <a name="SES-Type-DeliveryOptions-TlsPolicy"></a>
Specifies whether messages that use the configuration set are required to use Transport Layer Security (TLS). If the value is `Require`, messages are only delivered if a TLS connection can be established. If the value is `Optional`, messages can be delivered in plain text if a TLS connection can't be established.  
Type: String  
Valid Values: `REQUIRE | OPTIONAL`   
Required: No

## See Also
<a name="API_DeliveryOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DeliveryOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeliveryOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DeliveryOptions) 

# Destination
<a name="API_Destination"></a>

An object that describes the recipients for an email.

**Note**  
Amazon SES does not support the SMTPUTF8 extension, as described in [RFC6531](https://tools.ietf.org/html/rfc6531). For this reason, the *local part* of a destination email address (the part of the email address that precedes the @ sign) may only contain [7-bit ASCII characters](https://en.wikipedia.org/wiki/Email_address#Local-part). 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](https://tools.ietf.org/html/rfc3492.html).

## Contents
<a name="API_Destination_Contents"></a>

 ** BccAddresses **   <a name="SES-Type-Destination-BccAddresses"></a>
An array that contains the email addresses of the "BCC" (blind carbon copy) recipients for the email.  
Type: Array of strings  
Required: No

 ** CcAddresses **   <a name="SES-Type-Destination-CcAddresses"></a>
An array that contains the email addresses of the "CC" (carbon copy) recipients for the email.  
Type: Array of strings  
Required: No

 ** ToAddresses **   <a name="SES-Type-Destination-ToAddresses"></a>
An array that contains the email addresses of the "To" recipients for the email.  
Type: Array of strings  
Required: No

## See Also
<a name="API_Destination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/Destination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/Destination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/Destination) 

# Details
<a name="API_Details"></a>

An object that contains configuration details of multi-region endpoint (global-endpoint).

## Contents
<a name="API_Details_Contents"></a>

 ** RoutesDetails **   <a name="SES-Type-Details-RoutesDetails"></a>
A list of route configuration details. Must contain exactly one route configuration.  
Type: Array of [RouteDetails](API_RouteDetails.md) objects  
Required: Yes

## See Also
<a name="API_Details_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/Details) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/Details) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/Details) 

# DkimAttributes
<a name="API_DkimAttributes"></a>

An object that contains information about the DKIM authentication status for an email identity.

Amazon SES determines the authentication status by searching for specific records in the DNS configuration for the domain. If you used [Easy DKIM](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html) to set up DKIM authentication, Amazon SES tries to find three unique CNAME records in the DNS configuration for your domain. If you provided a public key to perform DKIM authentication, Amazon SES tries to find a TXT record that uses the selector that you specified. The value of the TXT record must be a public key that's paired with the private key that you specified in the process of creating the identity

## Contents
<a name="API_DkimAttributes_Contents"></a>

 ** CurrentSigningKeyLength **   <a name="SES-Type-DkimAttributes-CurrentSigningKeyLength"></a>
[Easy DKIM] The key length of the DKIM key pair in use.  
Type: String  
Valid Values: `RSA_1024_BIT | RSA_2048_BIT`   
Required: No

 ** LastKeyGenerationTimestamp **   <a name="SES-Type-DkimAttributes-LastKeyGenerationTimestamp"></a>
[Easy DKIM] The last time a key pair was generated for this identity.  
Type: Timestamp  
Required: No

 ** NextSigningKeyLength **   <a name="SES-Type-DkimAttributes-NextSigningKeyLength"></a>
[Easy DKIM] The key length of the future DKIM key pair to be generated. This can be changed at most once per day.  
Type: String  
Valid Values: `RSA_1024_BIT | RSA_2048_BIT`   
Required: No

 ** SigningAttributesOrigin **   <a name="SES-Type-DkimAttributes-SigningAttributesOrigin"></a>
A string that indicates how DKIM was configured for the identity. These are the possible values:  
+  `AWS_SES` – Indicates that DKIM was configured for the identity by using [Easy DKIM](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html).
+  `EXTERNAL` – Indicates that DKIM was configured for the identity by using Bring Your Own DKIM (BYODKIM).
+  `AWS_SES_AF_SOUTH_1` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Africa (Cape Town) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_EU_NORTH_1` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Europe (Stockholm) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_SOUTH_1` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Asia Pacific (Mumbai) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_SOUTH_2` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Asia Pacific (Hyderabad) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_EU_WEST_3` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Europe (Paris) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_EU_WEST_2` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Europe (London) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_EU_SOUTH_1` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Europe (Milan) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_EU_WEST_1` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Europe (Ireland) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_NORTHEAST_3` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Asia Pacific (Osaka) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_NORTHEAST_2` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Asia Pacific (Seoul) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_ME_CENTRAL_1` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Middle East (UAE) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_ME_SOUTH_1` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Middle East (Bahrain) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_NORTHEAST_1` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Asia Pacific (Tokyo) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_IL_CENTRAL_1` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Israel (Tel Aviv) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_SA_EAST_1` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in South America (São Paulo) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_CA_CENTRAL_1` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Canada (Central) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_CA_WEST_1` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Canada (Calgary) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_SOUTHEAST_1` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Asia Pacific (Singapore) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_SOUTHEAST_2` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Asia Pacific (Sydney) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_SOUTHEAST_3` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Asia Pacific (Jakarta) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_SOUTHEAST_5` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Asia Pacific (Malaysia) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_EU_CENTRAL_1` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Europe (Frankfurt) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_EU_CENTRAL_2` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in Europe (Zurich) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_US_EAST_1` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in US East (N. Virginia) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_US_EAST_2` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in US East (Ohio) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_US_WEST_1` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in US West (N. California) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_US_WEST_2` – Indicates that DKIM was configured for the identity by replicating signing attributes from a parent identity in US West (Oregon) region using Deterministic Easy-DKIM (DEED). 
Type: String  
Valid Values: `AWS_SES | EXTERNAL | AWS_SES_AF_SOUTH_1 | AWS_SES_EU_NORTH_1 | AWS_SES_AP_SOUTH_1 | AWS_SES_EU_WEST_3 | AWS_SES_EU_WEST_2 | AWS_SES_EU_SOUTH_1 | AWS_SES_EU_WEST_1 | AWS_SES_AP_NORTHEAST_3 | AWS_SES_AP_NORTHEAST_2 | AWS_SES_ME_SOUTH_1 | AWS_SES_AP_NORTHEAST_1 | AWS_SES_IL_CENTRAL_1 | AWS_SES_SA_EAST_1 | AWS_SES_CA_CENTRAL_1 | AWS_SES_AP_SOUTHEAST_1 | AWS_SES_AP_SOUTHEAST_2 | AWS_SES_AP_SOUTHEAST_3 | AWS_SES_EU_CENTRAL_1 | AWS_SES_US_EAST_1 | AWS_SES_US_EAST_2 | AWS_SES_US_WEST_1 | AWS_SES_US_WEST_2 | AWS_SES_ME_CENTRAL_1 | AWS_SES_AP_SOUTH_2 | AWS_SES_EU_CENTRAL_2 | AWS_SES_AP_SOUTHEAST_5 | AWS_SES_CA_WEST_1`   
Required: No

 ** SigningEnabled **   <a name="SES-Type-DkimAttributes-SigningEnabled"></a>
If the value is `true`, then the messages that you send from the identity are signed using DKIM. If the value is `false`, then the messages that you send from the identity aren't DKIM-signed.  
Type: Boolean  
Required: No

 ** SigningHostedZone **   <a name="SES-Type-DkimAttributes-SigningHostedZone"></a>
The hosted zone where Amazon SES publishes the DKIM public key TXT records for this email identity. This value indicates the DNS zone that customers must reference when configuring their CNAME records for DKIM authentication.  
When configuring DKIM for your domain, create CNAME records in your DNS that point to the selectors in this hosted zone. For example:  
 ` selector1._domainkey.yourdomain.com CNAME selector1.<SigningHostedZone> `   
 ` selector2._domainkey.yourdomain.com CNAME selector2.<SigningHostedZone> `   
 ` selector3._domainkey.yourdomain.com CNAME selector3.<SigningHostedZone> `   
Type: String  
Required: No

 ** Status **   <a name="SES-Type-DkimAttributes-Status"></a>
Describes whether or not Amazon SES has successfully located the DKIM records in the DNS records for the domain. The status can be one of the following:  
+  `PENDING` – The verification process was initiated, but Amazon SES hasn't yet detected the DKIM records in the DNS configuration for the domain.
+  `SUCCESS` – The verification process completed successfully.
+  `FAILED` – The verification process failed. This typically occurs when Amazon SES fails to find the DKIM records in the DNS configuration of the domain.
+  `TEMPORARY_FAILURE` – A temporary issue is preventing Amazon SES from determining the DKIM authentication status of the domain.
+  `NOT_STARTED` – The DKIM verification process hasn't been initiated for the domain.
Type: String  
Valid Values: `PENDING | SUCCESS | FAILED | TEMPORARY_FAILURE | NOT_STARTED`   
Required: No

 ** Tokens **   <a name="SES-Type-DkimAttributes-Tokens"></a>
If you used [Easy DKIM](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html) to configure DKIM authentication for the domain, then this object contains a set of unique strings that you use to create a set of CNAME records that you add to the DNS configuration for your domain. When Amazon SES detects these records in the DNS configuration for your domain, the DKIM authentication process is complete.  
If you configured DKIM authentication for the domain by providing your own public-private key pair, then this object contains the selector for the public key.  
Regardless of the DKIM authentication method you use, Amazon SES searches for the appropriate records in the DNS configuration of the domain for up to 72 hours.  
Type: Array of strings  
Required: No

## See Also
<a name="API_DkimAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DkimAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DkimAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DkimAttributes) 

# DkimSigningAttributes
<a name="API_DkimSigningAttributes"></a>

An object that contains configuration for Bring Your Own DKIM (BYODKIM), or, for Easy DKIM

## Contents
<a name="API_DkimSigningAttributes_Contents"></a>

 ** DomainSigningAttributesOrigin **   <a name="SES-Type-DkimSigningAttributes-DomainSigningAttributesOrigin"></a>
The attribute to use for configuring DKIM for the identity depends on the operation:   

1. For `PutEmailIdentityDkimSigningAttributes`: 
   + None of the values are allowed - use the [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutEmailIdentityDkimSigningAttributes.html#SES-PutEmailIdentityDkimSigningAttributes-request-SigningAttributesOrigin](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutEmailIdentityDkimSigningAttributes.html#SES-PutEmailIdentityDkimSigningAttributes-request-SigningAttributesOrigin) parameter instead 

1. For `CreateEmailIdentity` when replicating a parent identity's DKIM configuration: 
   + Allowed values: All values except `AWS_SES` and `EXTERNAL` 
+  `AWS_SES` – Configure DKIM for the identity by using Easy DKIM. 
+  `EXTERNAL` – Configure DKIM for the identity by using Bring Your Own DKIM (BYODKIM). 
+  `AWS_SES_AF_SOUTH_1` – Configure DKIM for the identity by replicating from a parent identity in Africa (Cape Town) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_EU_NORTH_1` – Configure DKIM for the identity by replicating from a parent identity in Europe (Stockholm) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_SOUTH_1` – Configure DKIM for the identity by replicating from a parent identity in Asia Pacific (Mumbai) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_SOUTH_2` – Configure DKIM for the identity by replicating from a parent identity in Asia Pacific (Hyderabad) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_EU_WEST_3` – Configure DKIM for the identity by replicating from a parent identity in Europe (Paris) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_EU_WEST_2` – Configure DKIM for the identity by replicating from a parent identity in Europe (London) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_EU_SOUTH_1` – Configure DKIM for the identity by replicating from a parent identity in Europe (Milan) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_EU_WEST_1` – Configure DKIM for the identity by replicating from a parent identity in Europe (Ireland) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_NORTHEAST_3` – Configure DKIM for the identity by replicating from a parent identity in Asia Pacific (Osaka) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_NORTHEAST_2` – Configure DKIM for the identity by replicating from a parent identity in Asia Pacific (Seoul) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_ME_CENTRAL_1` – Configure DKIM for the identity by replicating from a parent identity in Middle East (UAE) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_ME_SOUTH_1` – Configure DKIM for the identity by replicating from a parent identity in Middle East (Bahrain) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_NORTHEAST_1` – Configure DKIM for the identity by replicating from a parent identity in Asia Pacific (Tokyo) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_IL_CENTRAL_1` – Configure DKIM for the identity by replicating from a parent identity in Israel (Tel Aviv) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_SA_EAST_1` – Configure DKIM for the identity by replicating from a parent identity in South America (São Paulo) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_CA_CENTRAL_1` – Configure DKIM for the identity by replicating from a parent identity in Canada (Central) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_CA_WEST_1` – Configure DKIM for the identity by replicating from a parent identity in Canada (Calgary) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_SOUTHEAST_1` – Configure DKIM for the identity by replicating from a parent identity in Asia Pacific (Singapore) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_SOUTHEAST_2` – Configure DKIM for the identity by replicating from a parent identity in Asia Pacific (Sydney) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_SOUTHEAST_3` – Configure DKIM for the identity by replicating from a parent identity in Asia Pacific (Jakarta) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_AP_SOUTHEAST_5` – Configure DKIM for the identity by replicating from a parent identity in Asia Pacific (Malaysia) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_EU_CENTRAL_1` – Configure DKIM for the identity by replicating from a parent identity in Europe (Frankfurt) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_EU_CENTRAL_2` – Configure DKIM for the identity by replicating from a parent identity in Europe (Zurich) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_US_EAST_1` – Configure DKIM for the identity by replicating from a parent identity in US East (N. Virginia) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_US_EAST_2` – Configure DKIM for the identity by replicating from a parent identity in US East (Ohio) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_US_WEST_1` – Configure DKIM for the identity by replicating from a parent identity in US West (N. California) region using Deterministic Easy-DKIM (DEED). 
+  `AWS_SES_US_WEST_2` – Configure DKIM for the identity by replicating from a parent identity in US West (Oregon) region using Deterministic Easy-DKIM (DEED). 
Type: String  
Valid Values: `AWS_SES | EXTERNAL | AWS_SES_AF_SOUTH_1 | AWS_SES_EU_NORTH_1 | AWS_SES_AP_SOUTH_1 | AWS_SES_EU_WEST_3 | AWS_SES_EU_WEST_2 | AWS_SES_EU_SOUTH_1 | AWS_SES_EU_WEST_1 | AWS_SES_AP_NORTHEAST_3 | AWS_SES_AP_NORTHEAST_2 | AWS_SES_ME_SOUTH_1 | AWS_SES_AP_NORTHEAST_1 | AWS_SES_IL_CENTRAL_1 | AWS_SES_SA_EAST_1 | AWS_SES_CA_CENTRAL_1 | AWS_SES_AP_SOUTHEAST_1 | AWS_SES_AP_SOUTHEAST_2 | AWS_SES_AP_SOUTHEAST_3 | AWS_SES_EU_CENTRAL_1 | AWS_SES_US_EAST_1 | AWS_SES_US_EAST_2 | AWS_SES_US_WEST_1 | AWS_SES_US_WEST_2 | AWS_SES_ME_CENTRAL_1 | AWS_SES_AP_SOUTH_2 | AWS_SES_EU_CENTRAL_2 | AWS_SES_AP_SOUTHEAST_5 | AWS_SES_CA_WEST_1`   
Required: No

 ** DomainSigningPrivateKey **   <a name="SES-Type-DkimSigningAttributes-DomainSigningPrivateKey"></a>
[Bring Your Own DKIM] A private key that's used to generate a DKIM signature.  
The private key must use 1024 or 2048-bit RSA encryption, and must be encoded using base64 encoding.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 20480.  
Pattern: `^[a-zA-Z0-9+\/]+={0,2}$`   
Required: No

 ** DomainSigningSelector **   <a name="SES-Type-DkimSigningAttributes-DomainSigningSelector"></a>
[Bring Your Own DKIM] A string that's used to identify a public key in the DNS configuration for a domain.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 63.  
Pattern: `^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\-]*[a-zA-Z0-9]))$`   
Required: No

 ** NextSigningKeyLength **   <a name="SES-Type-DkimSigningAttributes-NextSigningKeyLength"></a>
[Easy DKIM] The key length of the future DKIM key pair to be generated. This can be changed at most once per day.  
Type: String  
Valid Values: `RSA_1024_BIT | RSA_2048_BIT`   
Required: No

## See Also
<a name="API_DkimSigningAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DkimSigningAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DkimSigningAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DkimSigningAttributes) 

# DomainDeliverabilityCampaign
<a name="API_DomainDeliverabilityCampaign"></a>

An object that contains the deliverability data for a specific campaign. This data is available for a campaign only if the campaign sent email by using a domain that the Deliverability dashboard is enabled for (`PutDeliverabilityDashboardOption` operation).

## Contents
<a name="API_DomainDeliverabilityCampaign_Contents"></a>

 ** CampaignId **   <a name="SES-Type-DomainDeliverabilityCampaign-CampaignId"></a>
The unique identifier for the campaign. The Deliverability dashboard automatically generates and assigns this identifier to a campaign.  
Type: String  
Required: No

 ** DeleteRate **   <a name="SES-Type-DomainDeliverabilityCampaign-DeleteRate"></a>
The percentage of email messages that were deleted by recipients, without being opened first. Due to technical limitations, this value only includes recipients who opened the message by using an email client that supports images.  
Type: Double  
Required: No

 ** Esps **   <a name="SES-Type-DomainDeliverabilityCampaign-Esps"></a>
The major email providers who handled the email message.  
Type: Array of strings  
Required: No

 ** FirstSeenDateTime **   <a name="SES-Type-DomainDeliverabilityCampaign-FirstSeenDateTime"></a>
The first time when the email message was delivered to any recipient's inbox. This value can help you determine how long it took for a campaign to deliver an email message.  
Type: Timestamp  
Required: No

 ** FromAddress **   <a name="SES-Type-DomainDeliverabilityCampaign-FromAddress"></a>
The verified email address that the email message was sent from.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** ImageUrl **   <a name="SES-Type-DomainDeliverabilityCampaign-ImageUrl"></a>
The URL of an image that contains a snapshot of the email message that was sent.  
Type: String  
Required: No

 ** InboxCount **   <a name="SES-Type-DomainDeliverabilityCampaign-InboxCount"></a>
The number of email messages that were delivered to recipients’ inboxes.  
Type: Long  
Required: No

 ** LastSeenDateTime **   <a name="SES-Type-DomainDeliverabilityCampaign-LastSeenDateTime"></a>
The last time when the email message was delivered to any recipient's inbox. This value can help you determine how long it took for a campaign to deliver an email message.  
Type: Timestamp  
Required: No

 ** ProjectedVolume **   <a name="SES-Type-DomainDeliverabilityCampaign-ProjectedVolume"></a>
The projected number of recipients that the email message was sent to.  
Type: Long  
Required: No

 ** ReadDeleteRate **   <a name="SES-Type-DomainDeliverabilityCampaign-ReadDeleteRate"></a>
The percentage of email messages that were opened and then deleted by recipients. Due to technical limitations, this value only includes recipients who opened the message by using an email client that supports images.  
Type: Double  
Required: No

 ** ReadRate **   <a name="SES-Type-DomainDeliverabilityCampaign-ReadRate"></a>
The percentage of email messages that were opened by recipients. Due to technical limitations, this value only includes recipients who opened the message by using an email client that supports images.  
Type: Double  
Required: No

 ** SendingIps **   <a name="SES-Type-DomainDeliverabilityCampaign-SendingIps"></a>
The IP addresses that were used to send the email message.  
Type: Array of strings  
Required: No

 ** SpamCount **   <a name="SES-Type-DomainDeliverabilityCampaign-SpamCount"></a>
The number of email messages that were delivered to recipients' spam or junk mail folders.  
Type: Long  
Required: No

 ** Subject **   <a name="SES-Type-DomainDeliverabilityCampaign-Subject"></a>
The subject line, or title, of the email message.  
Type: String  
Required: No

## See Also
<a name="API_DomainDeliverabilityCampaign_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DomainDeliverabilityCampaign) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DomainDeliverabilityCampaign) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DomainDeliverabilityCampaign) 

# DomainDeliverabilityTrackingOption
<a name="API_DomainDeliverabilityTrackingOption"></a>

An object that contains information about the Deliverability dashboard subscription for a verified domain that you use to send email and currently has an active Deliverability dashboard subscription. If a Deliverability dashboard subscription is active for a domain, you gain access to reputation, inbox placement, and other metrics for the domain.

## Contents
<a name="API_DomainDeliverabilityTrackingOption_Contents"></a>

 ** Domain **   <a name="SES-Type-DomainDeliverabilityTrackingOption-Domain"></a>
A verified domain that’s associated with your AWS account and currently has an active Deliverability dashboard subscription.  
Type: String  
Required: No

 ** InboxPlacementTrackingOption **   <a name="SES-Type-DomainDeliverabilityTrackingOption-InboxPlacementTrackingOption"></a>
An object that contains information about the inbox placement data settings for the domain.  
Type: [InboxPlacementTrackingOption](API_InboxPlacementTrackingOption.md) object  
Required: No

 ** SubscriptionStartDate **   <a name="SES-Type-DomainDeliverabilityTrackingOption-SubscriptionStartDate"></a>
The date when you enabled the Deliverability dashboard for the domain.  
Type: Timestamp  
Required: No

## See Also
<a name="API_DomainDeliverabilityTrackingOption_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DomainDeliverabilityTrackingOption) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DomainDeliverabilityTrackingOption) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DomainDeliverabilityTrackingOption) 

# DomainIspPlacement
<a name="API_DomainIspPlacement"></a>

An object that contains inbox placement data for email sent from one of your email domains to a specific email provider.

## Contents
<a name="API_DomainIspPlacement_Contents"></a>

 ** InboxPercentage **   <a name="SES-Type-DomainIspPlacement-InboxPercentage"></a>
The percentage of messages that were sent from the selected domain to the specified email provider that arrived in recipients' inboxes.  
Type: Double  
Required: No

 ** InboxRawCount **   <a name="SES-Type-DomainIspPlacement-InboxRawCount"></a>
The total number of messages that were sent from the selected domain to the specified email provider that arrived in recipients' inboxes.  
Type: Long  
Required: No

 ** IspName **   <a name="SES-Type-DomainIspPlacement-IspName"></a>
The name of the email provider that the inbox placement data applies to.  
Type: String  
Required: No

 ** SpamPercentage **   <a name="SES-Type-DomainIspPlacement-SpamPercentage"></a>
The percentage of messages that were sent from the selected domain to the specified email provider that arrived in recipients' spam or junk mail folders.  
Type: Double  
Required: No

 ** SpamRawCount **   <a name="SES-Type-DomainIspPlacement-SpamRawCount"></a>
The total number of messages that were sent from the selected domain to the specified email provider that arrived in recipients' spam or junk mail folders.  
Type: Long  
Required: No

## See Also
<a name="API_DomainIspPlacement_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/DomainIspPlacement) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DomainIspPlacement) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/DomainIspPlacement) 

# EmailAddressInsightsMailboxEvaluations
<a name="API_EmailAddressInsightsMailboxEvaluations"></a>

Contains individual validation checks performed on an email address.

## Contents
<a name="API_EmailAddressInsightsMailboxEvaluations_Contents"></a>

 ** HasValidDnsRecords **   <a name="SES-Type-EmailAddressInsightsMailboxEvaluations-HasValidDnsRecords"></a>
Checks that the domain exists, has valid DNS records, and is configured to receive email.  
Type: [EmailAddressInsightsVerdict](API_EmailAddressInsightsVerdict.md) object  
Required: No

 ** HasValidSyntax **   <a name="SES-Type-EmailAddressInsightsMailboxEvaluations-HasValidSyntax"></a>
Checks that the email address follows proper RFC standards and contains valid characters in the correct format.  
Type: [EmailAddressInsightsVerdict](API_EmailAddressInsightsVerdict.md) object  
Required: No

 ** IsDisposable **   <a name="SES-Type-EmailAddressInsightsMailboxEvaluations-IsDisposable"></a>
Checks disposable or temporary email addresses that could negatively impact your sender reputation.  
Type: [EmailAddressInsightsVerdict](API_EmailAddressInsightsVerdict.md) object  
Required: No

 ** IsRandomInput **   <a name="SES-Type-EmailAddressInsightsMailboxEvaluations-IsRandomInput"></a>
Checks if the input appears to be random text.  
Type: [EmailAddressInsightsVerdict](API_EmailAddressInsightsVerdict.md) object  
Required: No

 ** IsRoleAddress **   <a name="SES-Type-EmailAddressInsightsMailboxEvaluations-IsRoleAddress"></a>
Identifies role-based addresses (such as admin@, support@, or info@) that may have lower engagement rates.  
Type: [EmailAddressInsightsVerdict](API_EmailAddressInsightsVerdict.md) object  
Required: No

 ** MailboxExists **   <a name="SES-Type-EmailAddressInsightsMailboxEvaluations-MailboxExists"></a>
Checks that the mailbox exists and can receive messages without actually sending an email.  
Type: [EmailAddressInsightsVerdict](API_EmailAddressInsightsVerdict.md) object  
Required: No

## See Also
<a name="API_EmailAddressInsightsMailboxEvaluations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/EmailAddressInsightsMailboxEvaluations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/EmailAddressInsightsMailboxEvaluations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/EmailAddressInsightsMailboxEvaluations) 

# EmailAddressInsightsVerdict
<a name="API_EmailAddressInsightsVerdict"></a>

Contains the overall validation verdict for an email address.

## Contents
<a name="API_EmailAddressInsightsVerdict_Contents"></a>

 ** ConfidenceVerdict **   <a name="SES-Type-EmailAddressInsightsVerdict-ConfidenceVerdict"></a>
The confidence level of the validation verdict.  
Type: String  
Valid Values: `LOW | MEDIUM | HIGH`   
Required: No

## See Also
<a name="API_EmailAddressInsightsVerdict_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/EmailAddressInsightsVerdict) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/EmailAddressInsightsVerdict) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/EmailAddressInsightsVerdict) 

# EmailContent
<a name="API_EmailContent"></a>

An object that defines the entire content of the email, including the message headers, body content, and attachments. For a simple email message, you specify the subject and provide both text and HTML versions of the message body. You can also add attachments to simple and templated messages. For a raw message, you provide a complete MIME-formatted message, which can include custom headers and attachments.

## Contents
<a name="API_EmailContent_Contents"></a>

 ** Raw **   <a name="SES-Type-EmailContent-Raw"></a>
The raw email message. The message has to meet the following criteria:  
+ The message has to contain a header and a body, separated by one blank line.
+ All of the required header fields must be present in the message.
+ Each part of a multipart MIME message must be formatted properly.
+ If you include attachments, they must be in a file format that the Amazon SES API v2 supports. 
+ The raw data of the message needs to base64-encoded if you are accessing Amazon SES directly through the HTTPS interface. If you are accessing Amazon SES using an AWS SDK, the SDK takes care of the base 64-encoding for you.
+ If any of the MIME parts in your message contain content that is outside of the 7-bit ASCII character range, you should encode that content to ensure that recipients' email clients render the message properly.
+ The length of any single line of text in the message can't exceed 1,000 characters. This restriction is defined in [RFC 5321](https://tools.ietf.org/html/rfc5321).
Type: [RawMessage](API_RawMessage.md) object  
Required: No

 ** Simple **   <a name="SES-Type-EmailContent-Simple"></a>
The simple email message. The message consists of a subject, message body and attachments list.  
Type: [Message](API_Message.md) object  
Required: No

 ** Template **   <a name="SES-Type-EmailContent-Template"></a>
The template to use for the email message.  
Type: [Template](API_Template.md) object  
Required: No

## See Also
<a name="API_EmailContent_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/EmailContent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/EmailContent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/EmailContent) 

# EmailInsights
<a name="API_EmailInsights"></a>

An email's insights contain metadata and delivery information about a specific email.

## Contents
<a name="API_EmailInsights_Contents"></a>

 ** Destination **   <a name="SES-Type-EmailInsights-Destination"></a>
The recipient of the email.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 320.  
Required: No

 ** Events **   <a name="SES-Type-EmailInsights-Events"></a>
A list of events associated with the sent email.  
Type: Array of [InsightsEvent](API_InsightsEvent.md) objects  
Required: No

 ** Isp **   <a name="SES-Type-EmailInsights-Isp"></a>
The recipient's ISP (e.g., `Gmail`, `Yahoo`, etc.).  
Type: String  
Required: No

## See Also
<a name="API_EmailInsights_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/EmailInsights) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/EmailInsights) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/EmailInsights) 

# EmailTemplateContent
<a name="API_EmailTemplateContent"></a>

The content of the email, composed of a subject line, an HTML part, and a text-only part.

## Contents
<a name="API_EmailTemplateContent_Contents"></a>

 ** Html **   <a name="SES-Type-EmailTemplateContent-Html"></a>
The HTML body of the email.  
Type: String  
Required: No

 ** Subject **   <a name="SES-Type-EmailTemplateContent-Subject"></a>
The subject line of the email.  
Type: String  
Required: No

 ** Text **   <a name="SES-Type-EmailTemplateContent-Text"></a>
The email body that will be visible to recipients whose email clients do not display HTML.  
Type: String  
Required: No

## See Also
<a name="API_EmailTemplateContent_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/EmailTemplateContent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/EmailTemplateContent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/EmailTemplateContent) 

# EmailTemplateMetadata
<a name="API_EmailTemplateMetadata"></a>

Contains information about an email template.

## Contents
<a name="API_EmailTemplateMetadata_Contents"></a>

 ** CreatedTimestamp **   <a name="SES-Type-EmailTemplateMetadata-CreatedTimestamp"></a>
The time and date the template was created.  
Type: Timestamp  
Required: No

 ** TemplateName **   <a name="SES-Type-EmailTemplateMetadata-TemplateName"></a>
The name of the template.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

## See Also
<a name="API_EmailTemplateMetadata_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/EmailTemplateMetadata) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/EmailTemplateMetadata) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/EmailTemplateMetadata) 

# EventBridgeDestination
<a name="API_EventBridgeDestination"></a>

An object that defines an Amazon EventBridge destination for email events. You can use Amazon EventBridge to send notifications when certain email events occur.

## Contents
<a name="API_EventBridgeDestination_Contents"></a>

 ** EventBusArn **   <a name="SES-Type-EventBridgeDestination-EventBusArn"></a>
The Amazon Resource Name (ARN) of the Amazon EventBridge bus to publish email events to. Only the default bus is supported.   
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

## See Also
<a name="API_EventBridgeDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/EventBridgeDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/EventBridgeDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/EventBridgeDestination) 

# EventDestination
<a name="API_EventDestination"></a>

In the Amazon SES API v2, *events* include message sends, deliveries, opens, clicks, bounces, complaints and delivery delays. *Event destinations* are places that you can send information about these events to. For example, you can send event data to Amazon SNS to receive notifications when you receive bounces or complaints, or you can use Amazon Kinesis Data Firehose to stream data to Amazon S3 for long-term storage.

## Contents
<a name="API_EventDestination_Contents"></a>

 ** MatchingEventTypes **   <a name="SES-Type-EventDestination-MatchingEventTypes"></a>
The types of events that Amazon SES sends to the specified event destinations.  
+  `SEND` - The send request was successful and SES will attempt to deliver the message to the recipient’s mail server. (If account-level or global suppression is being used, SES will still count it as a send, but delivery is suppressed.)
+  `REJECT` - SES accepted the email, but determined that it contained a virus and didn’t attempt to deliver it to the recipient’s mail server.
+  `BOUNCE` - (*Hard bounce*) The recipient's mail server permanently rejected the email. (*Soft bounces* are only included when SES fails to deliver the email after retrying for a period of time.)
+  `COMPLAINT` - The email was successfully delivered to the recipient’s mail server, but the recipient marked it as spam.
+  `DELIVERY` - SES successfully delivered the email to the recipient's mail server.
+  `OPEN` - The recipient received the message and opened it in their email client.
+  `CLICK` - The recipient clicked one or more links in the email.
+  `RENDERING_FAILURE` - The email wasn't sent because of a template rendering issue. This event type can occur when template data is missing, or when there is a mismatch between template parameters and data. (This event type only occurs when you send email using the [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html) or [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html) API operations.) 
+  `DELIVERY_DELAY` - The email couldn't be delivered to the recipient’s mail server because a temporary issue occurred. Delivery delays can occur, for example, when the recipient's inbox is full, or when the receiving email server experiences a transient issue.
+  `SUBSCRIPTION` - The email was successfully delivered, but the recipient updated their subscription preferences by clicking on an *unsubscribe* link as part of your [subscription management](https://docs.aws.amazon.com/ses/latest/dg/sending-email-subscription-management.html).
Type: Array of strings  
Valid Values: `SEND | REJECT | BOUNCE | COMPLAINT | DELIVERY | OPEN | CLICK | RENDERING_FAILURE | DELIVERY_DELAY | SUBSCRIPTION`   
Required: Yes

 ** Name **   <a name="SES-Type-EventDestination-Name"></a>
A name that identifies the event destination.  
Type: String  
Required: Yes

 ** CloudWatchDestination **   <a name="SES-Type-EventDestination-CloudWatchDestination"></a>
An object that defines an Amazon CloudWatch destination for email events. You can use Amazon CloudWatch to monitor and gain insights on your email sending metrics.  
Type: [CloudWatchDestination](API_CloudWatchDestination.md) object  
Required: No

 ** Enabled **   <a name="SES-Type-EventDestination-Enabled"></a>
If `true`, the event destination is enabled. When the event destination is enabled, the specified event types are sent to the destinations in this `EventDestinationDefinition`.  
If `false`, the event destination is disabled. When the event destination is disabled, events aren't sent to the specified destinations.  
Type: Boolean  
Required: No

 ** EventBridgeDestination **   <a name="SES-Type-EventDestination-EventBridgeDestination"></a>
An object that defines an Amazon EventBridge destination for email events. You can use Amazon EventBridge to send notifications when certain email events occur.  
Type: [EventBridgeDestination](API_EventBridgeDestination.md) object  
Required: No

 ** KinesisFirehoseDestination **   <a name="SES-Type-EventDestination-KinesisFirehoseDestination"></a>
An object that defines an Amazon Kinesis Data Firehose destination for email events. You can use Amazon Kinesis Data Firehose to stream data to other services, such as Amazon S3 and Amazon Redshift.  
Type: [KinesisFirehoseDestination](API_KinesisFirehoseDestination.md) object  
Required: No

 ** PinpointDestination **   <a name="SES-Type-EventDestination-PinpointDestination"></a>
An object that defines an Amazon Pinpoint project destination for email events. You can send email event data to a Amazon Pinpoint project to view metrics using the Transactional Messaging dashboards that are built in to Amazon Pinpoint. For more information, see [Transactional Messaging Charts](https://docs.aws.amazon.com/pinpoint/latest/userguide/analytics-transactional-messages.html) in the *Amazon Pinpoint User Guide*.  
Type: [PinpointDestination](API_PinpointDestination.md) object  
Required: No

 ** SnsDestination **   <a name="SES-Type-EventDestination-SnsDestination"></a>
An object that defines an Amazon SNS destination for email events. You can use Amazon SNS to send notifications when certain email events occur.  
Type: [SnsDestination](API_SnsDestination.md) object  
Required: No

## See Also
<a name="API_EventDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/EventDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/EventDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/EventDestination) 

# EventDestinationDefinition
<a name="API_EventDestinationDefinition"></a>

An object that defines the event destination. Specifically, it defines which services receive events from emails sent using the configuration set that the event destination is associated with. Also defines the types of events that are sent to the event destination.

## Contents
<a name="API_EventDestinationDefinition_Contents"></a>

 ** CloudWatchDestination **   <a name="SES-Type-EventDestinationDefinition-CloudWatchDestination"></a>
An object that defines an Amazon CloudWatch destination for email events. You can use Amazon CloudWatch to monitor and gain insights on your email sending metrics.  
Type: [CloudWatchDestination](API_CloudWatchDestination.md) object  
Required: No

 ** Enabled **   <a name="SES-Type-EventDestinationDefinition-Enabled"></a>
If `true`, the event destination is enabled. When the event destination is enabled, the specified event types are sent to the destinations in this `EventDestinationDefinition`.  
If `false`, the event destination is disabled. When the event destination is disabled, events aren't sent to the specified destinations.  
Type: Boolean  
Required: No

 ** EventBridgeDestination **   <a name="SES-Type-EventDestinationDefinition-EventBridgeDestination"></a>
An object that defines an Amazon EventBridge destination for email events. You can use Amazon EventBridge to send notifications when certain email events occur.  
Type: [EventBridgeDestination](API_EventBridgeDestination.md) object  
Required: No

 ** KinesisFirehoseDestination **   <a name="SES-Type-EventDestinationDefinition-KinesisFirehoseDestination"></a>
An object that defines an Amazon Kinesis Data Firehose destination for email events. You can use Amazon Kinesis Data Firehose to stream data to other services, such as Amazon S3 and Amazon Redshift.  
Type: [KinesisFirehoseDestination](API_KinesisFirehoseDestination.md) object  
Required: No

 ** MatchingEventTypes **   <a name="SES-Type-EventDestinationDefinition-MatchingEventTypes"></a>
An array that specifies which events the Amazon SES API v2 should send to the destinations in this `EventDestinationDefinition`.  
Type: Array of strings  
Valid Values: `SEND | REJECT | BOUNCE | COMPLAINT | DELIVERY | OPEN | CLICK | RENDERING_FAILURE | DELIVERY_DELAY | SUBSCRIPTION`   
Required: No

 ** PinpointDestination **   <a name="SES-Type-EventDestinationDefinition-PinpointDestination"></a>
An object that defines an Amazon Pinpoint project destination for email events. You can send email event data to a Amazon Pinpoint project to view metrics using the Transactional Messaging dashboards that are built in to Amazon Pinpoint. For more information, see [Transactional Messaging Charts](https://docs.aws.amazon.com/pinpoint/latest/userguide/analytics-transactional-messages.html) in the *Amazon Pinpoint User Guide*.  
Type: [PinpointDestination](API_PinpointDestination.md) object  
Required: No

 ** SnsDestination **   <a name="SES-Type-EventDestinationDefinition-SnsDestination"></a>
An object that defines an Amazon SNS destination for email events. You can use Amazon SNS to send notifications when certain email events occur.  
Type: [SnsDestination](API_SnsDestination.md) object  
Required: No

## See Also
<a name="API_EventDestinationDefinition_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/EventDestinationDefinition) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/EventDestinationDefinition) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/EventDestinationDefinition) 

# EventDetails
<a name="API_EventDetails"></a>

 Contains a `Bounce` object if the event type is `BOUNCE`. Contains a `Complaint` object if the event type is `COMPLAINT`. 

## Contents
<a name="API_EventDetails_Contents"></a>

 ** Bounce **   <a name="SES-Type-EventDetails-Bounce"></a>
Information about a `Bounce` event.  
Type: [Bounce](API_Bounce.md) object  
Required: No

 ** Complaint **   <a name="SES-Type-EventDetails-Complaint"></a>
Information about a `Complaint` event.  
Type: [Complaint](API_Complaint.md) object  
Required: No

## See Also
<a name="API_EventDetails_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/EventDetails) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/EventDetails) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/EventDetails) 

# ExportDataSource
<a name="API_ExportDataSource"></a>

An object that contains details about the data source of the export job. It can only contain one of `MetricsDataSource` or `MessageInsightsDataSource` object.

## Contents
<a name="API_ExportDataSource_Contents"></a>

 ** MessageInsightsDataSource **   <a name="SES-Type-ExportDataSource-MessageInsightsDataSource"></a>
An object that contains filters applied when performing the Message Insights export.  
Type: [MessageInsightsDataSource](API_MessageInsightsDataSource.md) object  
Required: No

 ** MetricsDataSource **   <a name="SES-Type-ExportDataSource-MetricsDataSource"></a>
An object that contains details about the data source for the metrics export.  
Type: [MetricsDataSource](API_MetricsDataSource.md) object  
Required: No

## See Also
<a name="API_ExportDataSource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ExportDataSource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ExportDataSource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ExportDataSource) 

# ExportDestination
<a name="API_ExportDestination"></a>

An object that contains details about the destination of the export job.

## Contents
<a name="API_ExportDestination_Contents"></a>

 ** DataFormat **   <a name="SES-Type-ExportDestination-DataFormat"></a>
The data format of the final export job file, can be one of the following:  
+  `CSV` - A comma-separated values file.
+  `JSON` - A Json file.
Type: String  
Valid Values: `CSV | JSON`   
Required: Yes

 ** S3Url **   <a name="SES-Type-ExportDestination-S3Url"></a>
An Amazon S3 pre-signed URL that points to the generated export file.  
Type: String  
Pattern: `^s3:\/\/([^\/]+)\/(.*?([^\/]+)\/?)$`   
Required: No

## See Also
<a name="API_ExportDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ExportDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ExportDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ExportDestination) 

# ExportJobSummary
<a name="API_ExportJobSummary"></a>

A summary of the export job.

## Contents
<a name="API_ExportJobSummary_Contents"></a>

 ** CompletedTimestamp **   <a name="SES-Type-ExportJobSummary-CompletedTimestamp"></a>
The timestamp of when the export job was completed.  
Type: Timestamp  
Required: No

 ** CreatedTimestamp **   <a name="SES-Type-ExportJobSummary-CreatedTimestamp"></a>
The timestamp of when the export job was created.  
Type: Timestamp  
Required: No

 ** ExportSourceType **   <a name="SES-Type-ExportJobSummary-ExportSourceType"></a>
The source type of the export job.  
Type: String  
Valid Values: `METRICS_DATA | MESSAGE_INSIGHTS`   
Required: No

 ** JobId **   <a name="SES-Type-ExportJobSummary-JobId"></a>
The export job ID.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** JobStatus **   <a name="SES-Type-ExportJobSummary-JobStatus"></a>
The status of the export job.  
Type: String  
Valid Values: `CREATED | PROCESSING | COMPLETED | FAILED | CANCELLED`   
Required: No

## See Also
<a name="API_ExportJobSummary_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ExportJobSummary) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ExportJobSummary) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ExportJobSummary) 

# ExportMetric
<a name="API_ExportMetric"></a>

An object that contains a mapping between a `Metric` and `MetricAggregation`.

## Contents
<a name="API_ExportMetric_Contents"></a>

 ** Aggregation **   <a name="SES-Type-ExportMetric-Aggregation"></a>
The aggregation to apply to a metric, can be one of the following:  
+  `VOLUME` - The volume of events for this metric.
+  `RATE` - The rate for this metric relative to the `SEND` metric volume.
Type: String  
Valid Values: `RATE | VOLUME`   
Required: No

 ** Name **   <a name="SES-Type-ExportMetric-Name"></a>
The metric to export, can be one of the following:  
+  `SEND` - Emails sent eligible for tracking in the VDM dashboard. This excludes emails sent to the mailbox simulator and emails addressed to more than one recipient.
+  `COMPLAINT` - Complaints received for your account. This excludes complaints from the mailbox simulator, those originating from your account-level suppression list (if enabled), and those for emails addressed to more than one recipient
+  `PERMANENT_BOUNCE` - Permanent bounces - i.e., feedback received for emails sent to non-existent mailboxes. Excludes bounces from the mailbox simulator, those originating from your account-level suppression list (if enabled), and those for emails addressed to more than one recipient.
+  `TRANSIENT_BOUNCE` - Transient bounces - i.e., feedback received for delivery failures excluding issues with non-existent mailboxes. Excludes bounces from the mailbox simulator, and those for emails addressed to more than one recipient.
+  `OPEN` - Unique open events for emails including open trackers. Excludes opens for emails addressed to more than one recipient.
+  `CLICK` - Unique click events for emails including wrapped links. Excludes clicks for emails addressed to more than one recipient.
+  `DELIVERY` - Successful deliveries for email sending attempts. Excludes deliveries to the mailbox simulator and for emails addressed to more than one recipient.
+  `DELIVERY_OPEN` - Successful deliveries for email sending attempts. Excludes deliveries to the mailbox simulator, for emails addressed to more than one recipient, and emails without open trackers.
+  `DELIVERY_CLICK` - Successful deliveries for email sending attempts. Excludes deliveries to the mailbox simulator, for emails addressed to more than one recipient, and emails without click trackers.
+  `DELIVERY_COMPLAINT` - Successful deliveries for email sending attempts. Excludes deliveries to the mailbox simulator, for emails addressed to more than one recipient, and emails addressed to recipients hosted by ISPs with which Amazon SES does not have a feedback loop agreement.
Type: String  
Valid Values: `SEND | COMPLAINT | PERMANENT_BOUNCE | TRANSIENT_BOUNCE | OPEN | CLICK | DELIVERY | DELIVERY_OPEN | DELIVERY_CLICK | DELIVERY_COMPLAINT`   
Required: No

## See Also
<a name="API_ExportMetric_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ExportMetric) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ExportMetric) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ExportMetric) 

# ExportStatistics
<a name="API_ExportStatistics"></a>

Statistics about the execution of an export job.

## Contents
<a name="API_ExportStatistics_Contents"></a>

 ** ExportedRecordsCount **   <a name="SES-Type-ExportStatistics-ExportedRecordsCount"></a>
The number of records that were exported to the final export file.  
This value might not be available for all export source types  
Type: Integer  
Required: No

 ** ProcessedRecordsCount **   <a name="SES-Type-ExportStatistics-ProcessedRecordsCount"></a>
The number of records that were processed to generate the final export file.  
Type: Integer  
Required: No

## See Also
<a name="API_ExportStatistics_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ExportStatistics) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ExportStatistics) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ExportStatistics) 

# FailureInfo
<a name="API_FailureInfo"></a>

An object that contains the failure details about a job.

## Contents
<a name="API_FailureInfo_Contents"></a>

 ** ErrorMessage **   <a name="SES-Type-FailureInfo-ErrorMessage"></a>
A message about why the job failed.  
Type: String  
Required: No

 ** FailedRecordsS3Url **   <a name="SES-Type-FailureInfo-FailedRecordsS3Url"></a>
An Amazon S3 pre-signed URL that contains all the failed records and related information.  
Type: String  
Required: No

## See Also
<a name="API_FailureInfo_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/FailureInfo) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/FailureInfo) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/FailureInfo) 

# GuardianAttributes
<a name="API_GuardianAttributes"></a>

An object containing additional settings for your VDM configuration as applicable to the Guardian.

## Contents
<a name="API_GuardianAttributes_Contents"></a>

 ** OptimizedSharedDelivery **   <a name="SES-Type-GuardianAttributes-OptimizedSharedDelivery"></a>
Specifies the status of your VDM optimized shared delivery. Can be one of the following:  
+  `ENABLED` – Amazon SES enables optimized shared delivery for your account.
+  `DISABLED` – Amazon SES disables optimized shared delivery for your account.
Type: String  
Valid Values: `ENABLED | DISABLED`   
Required: No

## See Also
<a name="API_GuardianAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GuardianAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GuardianAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GuardianAttributes) 

# GuardianOptions
<a name="API_GuardianOptions"></a>

An object containing additional settings for your VDM configuration as applicable to the Guardian.

## Contents
<a name="API_GuardianOptions_Contents"></a>

 ** OptimizedSharedDelivery **   <a name="SES-Type-GuardianOptions-OptimizedSharedDelivery"></a>
Specifies the status of your VDM optimized shared delivery. Can be one of the following:  
+  `ENABLED` – Amazon SES enables optimized shared delivery for the configuration set.
+  `DISABLED` – Amazon SES disables optimized shared delivery for the configuration set.
Type: String  
Valid Values: `ENABLED | DISABLED`   
Required: No

## See Also
<a name="API_GuardianOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/GuardianOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/GuardianOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/GuardianOptions) 

# IdentityInfo
<a name="API_IdentityInfo"></a>

Information about an email identity.

## Contents
<a name="API_IdentityInfo_Contents"></a>

 ** IdentityName **   <a name="SES-Type-IdentityInfo-IdentityName"></a>
The address or domain of the identity.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** IdentityType **   <a name="SES-Type-IdentityInfo-IdentityType"></a>
The email identity type. Note: the `MANAGED_DOMAIN` type is not supported for email identity types.  
Type: String  
Valid Values: `EMAIL_ADDRESS | DOMAIN | MANAGED_DOMAIN`   
Required: No

 ** SendingEnabled **   <a name="SES-Type-IdentityInfo-SendingEnabled"></a>
Indicates whether or not you can send email from the identity.  
An *identity* is an email address or domain that you send email from. Before you can send email from an identity, you have to demostrate that you own the identity, and that you authorize Amazon SES to send email from that identity.  
Type: Boolean  
Required: No

 ** VerificationStatus **   <a name="SES-Type-IdentityInfo-VerificationStatus"></a>
The verification status of the identity. The status can be one of the following:  
+  `PENDING` – The verification process was initiated, but Amazon SES hasn't yet been able to verify the identity.
+  `SUCCESS` – The verification process completed successfully.
+  `FAILED` – The verification process failed.
+  `TEMPORARY_FAILURE` – A temporary issue is preventing Amazon SES from determining the verification status of the identity.
+  `NOT_STARTED` – The verification process hasn't been initiated for the identity.
Type: String  
Valid Values: `PENDING | SUCCESS | FAILED | TEMPORARY_FAILURE | NOT_STARTED`   
Required: No

## See Also
<a name="API_IdentityInfo_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/IdentityInfo) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/IdentityInfo) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/IdentityInfo) 

# ImportDataSource
<a name="API_ImportDataSource"></a>

An object that contains details about the data source of the import job.

## Contents
<a name="API_ImportDataSource_Contents"></a>

 ** DataFormat **   <a name="SES-Type-ImportDataSource-DataFormat"></a>
The data format of the import job's data source.  
Type: String  
Valid Values: `CSV | JSON`   
Required: Yes

 ** S3Url **   <a name="SES-Type-ImportDataSource-S3Url"></a>
An Amazon S3 URL in the format s3://*<bucket\$1name>*/*<object>*.  
Type: String  
Pattern: `^s3:\/\/([^\/]+)\/(.*?([^\/]+)\/?)$`   
Required: Yes

## See Also
<a name="API_ImportDataSource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ImportDataSource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ImportDataSource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ImportDataSource) 

# ImportDestination
<a name="API_ImportDestination"></a>

An object that contains details about the resource destination the import job is going to target.

## Contents
<a name="API_ImportDestination_Contents"></a>

 ** ContactListDestination **   <a name="SES-Type-ImportDestination-ContactListDestination"></a>
An object that contains the action of the import job towards a contact list.  
Type: [ContactListDestination](API_ContactListDestination.md) object  
Required: No

 ** SuppressionListDestination **   <a name="SES-Type-ImportDestination-SuppressionListDestination"></a>
An object that contains the action of the import job towards suppression list.  
Type: [SuppressionListDestination](API_SuppressionListDestination.md) object  
Required: No

## See Also
<a name="API_ImportDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ImportDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ImportDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ImportDestination) 

# ImportJobSummary
<a name="API_ImportJobSummary"></a>

A summary of the import job.

## Contents
<a name="API_ImportJobSummary_Contents"></a>

 ** CreatedTimestamp **   <a name="SES-Type-ImportJobSummary-CreatedTimestamp"></a>
The date and time when the import job was created.  
Type: Timestamp  
Required: No

 ** FailedRecordsCount **   <a name="SES-Type-ImportJobSummary-FailedRecordsCount"></a>
The number of records that failed processing because of invalid input or other reasons.  
Type: Integer  
Required: No

 ** ImportDestination **   <a name="SES-Type-ImportJobSummary-ImportDestination"></a>
An object that contains details about the resource destination the import job is going to target.  
Type: [ImportDestination](API_ImportDestination.md) object  
Required: No

 ** JobId **   <a name="SES-Type-ImportJobSummary-JobId"></a>
A string that represents a job ID.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** JobStatus **   <a name="SES-Type-ImportJobSummary-JobStatus"></a>
The status of a job.  
+  `CREATED` – Job has just been created.
+  `PROCESSING` – Job is processing.
+  `ERROR` – An error occurred during processing.
+  `COMPLETED` – Job has completed processing successfully.
Type: String  
Valid Values: `CREATED | PROCESSING | COMPLETED | FAILED | CANCELLED`   
Required: No

 ** ProcessedRecordsCount **   <a name="SES-Type-ImportJobSummary-ProcessedRecordsCount"></a>
The current number of records processed.  
Type: Integer  
Required: No

## See Also
<a name="API_ImportJobSummary_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ImportJobSummary) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ImportJobSummary) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ImportJobSummary) 

# InboxPlacementTrackingOption
<a name="API_InboxPlacementTrackingOption"></a>

An object that contains information about the inbox placement data settings for a verified domain that’s associated with your AWS account. This data is available only if you enabled the Deliverability dashboard for the domain.

## Contents
<a name="API_InboxPlacementTrackingOption_Contents"></a>

 ** Global **   <a name="SES-Type-InboxPlacementTrackingOption-Global"></a>
Specifies whether inbox placement data is being tracked for the domain.  
Type: Boolean  
Required: No

 ** TrackedIsps **   <a name="SES-Type-InboxPlacementTrackingOption-TrackedIsps"></a>
An array of strings, one for each major email provider that the inbox placement data applies to.  
Type: Array of strings  
Required: No

## See Also
<a name="API_InboxPlacementTrackingOption_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/InboxPlacementTrackingOption) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/InboxPlacementTrackingOption) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/InboxPlacementTrackingOption) 

# InsightsEvent
<a name="API_InsightsEvent"></a>

An object containing details about a specific event.

## Contents
<a name="API_InsightsEvent_Contents"></a>

 ** Details **   <a name="SES-Type-InsightsEvent-Details"></a>
Details about bounce or complaint events.  
Type: [EventDetails](API_EventDetails.md) object  
Required: No

 ** Timestamp **   <a name="SES-Type-InsightsEvent-Timestamp"></a>
The timestamp of the event.  
Type: Timestamp  
Required: No

 ** Type **   <a name="SES-Type-InsightsEvent-Type"></a>
The type of event:  
+  `SEND` - The send request was successful and SES will attempt to deliver the message to the recipient’s mail server. (If account-level or global suppression is being used, SES will still count it as a send, but delivery is suppressed.) 
+  `DELIVERY` - SES successfully delivered the email to the recipient's mail server. Excludes deliveries to the mailbox simulator, and those from emails addressed to more than one recipient. 
+  `BOUNCE` - Feedback received for delivery failures. Additional details about the bounce are provided in the `Details` object. Excludes bounces from the mailbox simulator, and those from emails addressed to more than one recipient. 
+  `COMPLAINT` - Complaint received for the email. Additional details about the complaint are provided in the `Details` object. This excludes complaints from the mailbox simulator, those originating from your account-level suppression list (if enabled), and those from emails addressed to more than one recipient. 
+  `OPEN` - Open event for emails including open trackers. Excludes opens for emails addressed to more than one recipient.
+  `CLICK` - Click event for emails including wrapped links. Excludes clicks for emails addressed to more than one recipient.
Type: String  
Valid Values: `SEND | REJECT | BOUNCE | COMPLAINT | DELIVERY | OPEN | CLICK | RENDERING_FAILURE | DELIVERY_DELAY | SUBSCRIPTION`   
Required: No

## See Also
<a name="API_InsightsEvent_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/InsightsEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/InsightsEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/InsightsEvent) 

# IspPlacement
<a name="API_IspPlacement"></a>

An object that describes how email sent during the predictive inbox placement test was handled by a certain email provider.

## Contents
<a name="API_IspPlacement_Contents"></a>

 ** IspName **   <a name="SES-Type-IspPlacement-IspName"></a>
The name of the email provider that the inbox placement data applies to.  
Type: String  
Required: No

 ** PlacementStatistics **   <a name="SES-Type-IspPlacement-PlacementStatistics"></a>
An object that contains inbox placement metrics for a specific email provider.  
Type: [PlacementStatistics](API_PlacementStatistics.md) object  
Required: No

## See Also
<a name="API_IspPlacement_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/IspPlacement) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/IspPlacement) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/IspPlacement) 

# KinesisFirehoseDestination
<a name="API_KinesisFirehoseDestination"></a>

An object that defines an Amazon Kinesis Data Firehose destination for email events. You can use Amazon Kinesis Data Firehose to stream data to other services, such as Amazon S3 and Amazon Redshift.

## Contents
<a name="API_KinesisFirehoseDestination_Contents"></a>

 ** DeliveryStreamArn **   <a name="SES-Type-KinesisFirehoseDestination-DeliveryStreamArn"></a>
The Amazon Resource Name (ARN) of the Amazon Kinesis Data Firehose stream that the Amazon SES API v2 sends email events to.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

 ** IamRoleArn **   <a name="SES-Type-KinesisFirehoseDestination-IamRoleArn"></a>
The Amazon Resource Name (ARN) of the IAM role that the Amazon SES API v2 uses to send email events to the Amazon Kinesis Data Firehose stream.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

## See Also
<a name="API_KinesisFirehoseDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/KinesisFirehoseDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/KinesisFirehoseDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/KinesisFirehoseDestination) 

# ListContactsFilter
<a name="API_ListContactsFilter"></a>

A filter that can be applied to a list of contacts.

## Contents
<a name="API_ListContactsFilter_Contents"></a>

 ** FilteredStatus **   <a name="SES-Type-ListContactsFilter-FilteredStatus"></a>
The status by which you are filtering: `OPT_IN` or `OPT_OUT`.  
Type: String  
Valid Values: `OPT_IN | OPT_OUT`   
Required: No

 ** TopicFilter **   <a name="SES-Type-ListContactsFilter-TopicFilter"></a>
Used for filtering by a specific topic preference.  
Type: [TopicFilter](API_TopicFilter.md) object  
Required: No

## See Also
<a name="API_ListContactsFilter_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListContactsFilter) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListContactsFilter) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListContactsFilter) 

# ListManagementOptions
<a name="API_ListManagementOptions"></a>

An object used to specify a list or topic to which an email belongs, which will be used when a contact chooses to unsubscribe.

## Contents
<a name="API_ListManagementOptions_Contents"></a>

 ** ContactListName **   <a name="SES-Type-ListManagementOptions-ContactListName"></a>
The name of the contact list.  
Type: String  
Required: Yes

 ** TopicName **   <a name="SES-Type-ListManagementOptions-TopicName"></a>
The name of the topic.  
Type: String  
Required: No

## See Also
<a name="API_ListManagementOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ListManagementOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListManagementOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ListManagementOptions) 

# MailboxValidation
<a name="API_MailboxValidation"></a>

Contains detailed validation information about an email address.

## Contents
<a name="API_MailboxValidation_Contents"></a>

 ** Evaluations **   <a name="SES-Type-MailboxValidation-Evaluations"></a>
Specific validation checks performed on the email address.  
Type: [EmailAddressInsightsMailboxEvaluations](API_EmailAddressInsightsMailboxEvaluations.md) object  
Required: No

 ** IsValid **   <a name="SES-Type-MailboxValidation-IsValid"></a>
Overall validity assessment with a confidence verdict.  
Type: [EmailAddressInsightsVerdict](API_EmailAddressInsightsVerdict.md) object  
Required: No

## See Also
<a name="API_MailboxValidation_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/MailboxValidation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/MailboxValidation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/MailboxValidation) 

# MailFromAttributes
<a name="API_MailFromAttributes"></a>

A list of attributes that are associated with a MAIL FROM domain.

## Contents
<a name="API_MailFromAttributes_Contents"></a>

 ** BehaviorOnMxFailure **   <a name="SES-Type-MailFromAttributes-BehaviorOnMxFailure"></a>
The action to take if the required MX record can't be found when you send an email. When you set this value to `USE_DEFAULT_VALUE`, the mail is sent using *amazonses.com* as the MAIL FROM domain. When you set this value to `REJECT_MESSAGE`, the Amazon SES API v2 returns a `MailFromDomainNotVerified` error, and doesn't attempt to deliver the email.  
These behaviors are taken when the custom MAIL FROM domain configuration is in the `Pending`, `Failed`, and `TemporaryFailure` states.  
Type: String  
Valid Values: `USE_DEFAULT_VALUE | REJECT_MESSAGE`   
Required: Yes

 ** MailFromDomain **   <a name="SES-Type-MailFromAttributes-MailFromDomain"></a>
The name of a domain that an email identity uses as a custom MAIL FROM domain.  
Type: String  
Required: Yes

 ** MailFromDomainStatus **   <a name="SES-Type-MailFromAttributes-MailFromDomainStatus"></a>
The status of the MAIL FROM domain. This status can have the following values:  
+  `PENDING` – Amazon SES hasn't started searching for the MX record yet.
+  `SUCCESS` – Amazon SES detected the required MX record for the MAIL FROM domain.
+  `FAILED` – Amazon SES can't find the required MX record, or the record no longer exists.
+  `TEMPORARY_FAILURE` – A temporary issue occurred, which prevented Amazon SES from determining the status of the MAIL FROM domain.
Type: String  
Valid Values: `PENDING | SUCCESS | FAILED | TEMPORARY_FAILURE`   
Required: Yes

## See Also
<a name="API_MailFromAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/MailFromAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/MailFromAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/MailFromAttributes) 

# Message
<a name="API_Message"></a>

Represents the email message that you're sending. The `Message` object consists of a subject line and a message body.

## Contents
<a name="API_Message_Contents"></a>

 ** Body **   <a name="SES-Type-Message-Body"></a>
The body of the message. You can specify an HTML version of the message, a text-only version of the message, or both.  
Type: [Body](API_Body.md) object  
Required: Yes

 ** Subject **   <a name="SES-Type-Message-Subject"></a>
The subject line of the email. The subject line can only contain 7-bit ASCII characters. However, you can specify non-ASCII characters in the subject line by using encoded-word syntax, as described in [RFC 2047](https://tools.ietf.org/html/rfc2047).  
Type: [Content](API_Content.md) object  
Required: Yes

 ** Attachments **   <a name="SES-Type-Message-Attachments"></a>
 The List of attachments to include in your email. All recipients will receive the same attachments.  
Type: Array of [Attachment](API_Attachment.md) objects  
Required: No

 ** Headers **   <a name="SES-Type-Message-Headers"></a>
The list of message headers that will be added to the email message.  
Type: Array of [MessageHeader](API_MessageHeader.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 15 items.  
Required: No

## See Also
<a name="API_Message_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/Message) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/Message) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/Message) 

# MessageHeader
<a name="API_MessageHeader"></a>

Contains the name and value of a message header that you add to an email.

## Contents
<a name="API_MessageHeader_Contents"></a>

 ** Name **   <a name="SES-Type-MessageHeader-Name"></a>
The name of the message header. The message header name has to meet the following criteria:  
+ Can contain any printable ASCII character (33 - 126) except for colon (:).
+ Can contain no more than 126 characters.
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 126.  
Pattern: `^[!-9;-@A-~]+$`   
Required: Yes

 ** Value **   <a name="SES-Type-MessageHeader-Value"></a>
The value of the message header. The message header value has to meet the following criteria:  
+ Can contain any printable ASCII character.
+ Can contain no more than 995 characters.
+ The combined length of the header name and value must not exceed 996 characters.
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 995.  
Pattern: `[ -~]*`   
Required: Yes

## See Also
<a name="API_MessageHeader_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/MessageHeader) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/MessageHeader) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/MessageHeader) 

# MessageInsightsDataSource
<a name="API_MessageInsightsDataSource"></a>

An object that contains filters applied when performing the Message Insights export.

## Contents
<a name="API_MessageInsightsDataSource_Contents"></a>

 ** EndDate **   <a name="SES-Type-MessageInsightsDataSource-EndDate"></a>
Represents the end date for the export interval as a timestamp. The end date is inclusive.  
Type: Timestamp  
Required: Yes

 ** StartDate **   <a name="SES-Type-MessageInsightsDataSource-StartDate"></a>
Represents the start date for the export interval as a timestamp. The start date is inclusive.  
Type: Timestamp  
Required: Yes

 ** Exclude **   <a name="SES-Type-MessageInsightsDataSource-Exclude"></a>
Filters for results to be excluded from the export file.  
Type: [MessageInsightsFilters](API_MessageInsightsFilters.md) object  
Required: No

 ** Include **   <a name="SES-Type-MessageInsightsDataSource-Include"></a>
Filters for results to be included in the export file.  
Type: [MessageInsightsFilters](API_MessageInsightsFilters.md) object  
Required: No

 ** MaxResults **   <a name="SES-Type-MessageInsightsDataSource-MaxResults"></a>
The maximum number of results.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 10000.  
Required: No

## See Also
<a name="API_MessageInsightsDataSource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/MessageInsightsDataSource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/MessageInsightsDataSource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/MessageInsightsDataSource) 

# MessageInsightsFilters
<a name="API_MessageInsightsFilters"></a>

An object containing Message Insights filters.

If you specify multiple filters, the filters are joined by AND.

If you specify multiple values for a filter, the values are joined by OR. Filter values are case-sensitive.

 `FromEmailAddress`, `Destination`, and `Subject` filters support partial match. A partial match is performed by using the `*` wildcard character placed at the beginning (suffix match), the end (prefix match) or both ends of the string (contains match). In order to match the literal characters `*` or `\`, they must be escaped using the `\` character. If no wildcard character is present, an exact match is performed. 

## Contents
<a name="API_MessageInsightsFilters_Contents"></a>

 ** Destination **   <a name="SES-Type-MessageInsightsFilters-Destination"></a>
The recipient's email address.  
Type: Array of strings  
Array Members: Maximum number of 5 items.  
Length Constraints: Minimum length of 1. Maximum length of 320.  
Required: No

 ** FromEmailAddress **   <a name="SES-Type-MessageInsightsFilters-FromEmailAddress"></a>
The from address used to send the message.  
Type: Array of strings  
Array Members: Maximum number of 5 items.  
Length Constraints: Minimum length of 1. Maximum length of 320.  
Required: No

 ** Isp **   <a name="SES-Type-MessageInsightsFilters-Isp"></a>
The recipient's ISP (e.g., `Gmail`, `Yahoo`, etc.).  
Type: Array of strings  
Array Members: Maximum number of 5 items.  
Required: No

 ** LastDeliveryEvent **   <a name="SES-Type-MessageInsightsFilters-LastDeliveryEvent"></a>
 The last delivery-related event for the email, where the ordering is as follows: `SEND` < `BOUNCE` < `DELIVERY` < `COMPLAINT`.   
Type: Array of strings  
Array Members: Maximum number of 5 items.  
Valid Values: `SEND | DELIVERY | TRANSIENT_BOUNCE | PERMANENT_BOUNCE | UNDETERMINED_BOUNCE | COMPLAINT`   
Required: No

 ** LastEngagementEvent **   <a name="SES-Type-MessageInsightsFilters-LastEngagementEvent"></a>
 The last engagement-related event for the email, where the ordering is as follows: `OPEN` < `CLICK`.   
 Engagement events are only available if [Engagement tracking](https://docs.aws.amazon.com/ses/latest/dg/vdm-settings.html) is enabled.   
Type: Array of strings  
Array Members: Maximum number of 2 items.  
Valid Values: `OPEN | CLICK`   
Required: No

 ** Subject **   <a name="SES-Type-MessageInsightsFilters-Subject"></a>
The subject line of the message.  
Type: Array of strings  
Array Members: Maximum number of 1 item.  
Length Constraints: Minimum length of 1. Maximum length of 998.  
Required: No

## See Also
<a name="API_MessageInsightsFilters_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/MessageInsightsFilters) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/MessageInsightsFilters) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/MessageInsightsFilters) 

# MessageTag
<a name="API_MessageTag"></a>

Contains the name and value of a tag that you apply to an email. You can use message tags when you publish email sending events. 

## Contents
<a name="API_MessageTag_Contents"></a>

 ** Name **   <a name="SES-Type-MessageTag-Name"></a>
The name of the message tag. The message tag name has to meet the following criteria:  
+ It can only contain ASCII letters (a–z, A–Z), numbers (0–9), underscores (\$1), or dashes (-).
+ It can contain no more than 256 characters.
Type: String  
Required: Yes

 ** Value **   <a name="SES-Type-MessageTag-Value"></a>
The value of the message tag. The message tag value has to meet the following criteria:  
+ It can only contain ASCII letters (a–z, A–Z), numbers (0–9), underscores (\$1), or dashes (-).
+ It can contain no more than 256 characters.
Type: String  
Required: Yes

## See Also
<a name="API_MessageTag_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/MessageTag) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/MessageTag) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/MessageTag) 

# MetricDataError
<a name="API_MetricDataError"></a>

An error corresponding to the unsuccessful processing of a single metric data query.

## Contents
<a name="API_MetricDataError_Contents"></a>

 ** Code **   <a name="SES-Type-MetricDataError-Code"></a>
The query error code. Can be one of:  
+  `INTERNAL_FAILURE` – Amazon SES has failed to process one of the queries.
+  `ACCESS_DENIED` – You have insufficient access to retrieve metrics based on the given query.
Type: String  
Valid Values: `INTERNAL_FAILURE | ACCESS_DENIED`   
Required: No

 ** Id **   <a name="SES-Type-MetricDataError-Id"></a>
The query identifier.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

 ** Message **   <a name="SES-Type-MetricDataError-Message"></a>
The error message associated with the current query error.  
Type: String  
Required: No

## See Also
<a name="API_MetricDataError_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/MetricDataError) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/MetricDataError) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/MetricDataError) 

# MetricDataResult
<a name="API_MetricDataResult"></a>

The result of a single metric data query.

## Contents
<a name="API_MetricDataResult_Contents"></a>

 ** Id **   <a name="SES-Type-MetricDataResult-Id"></a>
The query identifier.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

 ** Timestamps **   <a name="SES-Type-MetricDataResult-Timestamps"></a>
A list of timestamps for the metric data results.  
Type: Array of timestamps  
Required: No

 ** Values **   <a name="SES-Type-MetricDataResult-Values"></a>
A list of values (cumulative / sum) for the metric data results.  
Type: Array of longs  
Required: No

## See Also
<a name="API_MetricDataResult_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/MetricDataResult) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/MetricDataResult) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/MetricDataResult) 

# MetricsDataSource
<a name="API_MetricsDataSource"></a>

An object that contains details about the data source for the metrics export.

## Contents
<a name="API_MetricsDataSource_Contents"></a>

 ** Dimensions **   <a name="SES-Type-MetricsDataSource-Dimensions"></a>
An object that contains a mapping between a `MetricDimensionName` and `MetricDimensionValue` to filter metrics by. Must contain a least 1 dimension but no more than 3 unique ones.  
Type: String to array of strings map  
Map Entries: Maximum number of 3 items.  
Valid Keys: `EMAIL_IDENTITY | CONFIGURATION_SET | ISP`   
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Required: Yes

 ** EndDate **   <a name="SES-Type-MetricsDataSource-EndDate"></a>
Represents the end date for the export interval as a timestamp.  
Type: Timestamp  
Required: Yes

 ** Metrics **   <a name="SES-Type-MetricsDataSource-Metrics"></a>
A list of `ExportMetric` objects to export.  
Type: Array of [ExportMetric](API_ExportMetric.md) objects  
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Required: Yes

 ** Namespace **   <a name="SES-Type-MetricsDataSource-Namespace"></a>
The metrics namespace - e.g., `VDM`.  
Type: String  
Valid Values: `VDM`   
Required: Yes

 ** StartDate **   <a name="SES-Type-MetricsDataSource-StartDate"></a>
Represents the start date for the export interval as a timestamp.  
Type: Timestamp  
Required: Yes

## See Also
<a name="API_MetricsDataSource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/MetricsDataSource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/MetricsDataSource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/MetricsDataSource) 

# MultiRegionEndpoint
<a name="API_MultiRegionEndpoint"></a>

An object that contains multi-region endpoint (global-endpoint) properties.

## Contents
<a name="API_MultiRegionEndpoint_Contents"></a>

 ** CreatedTimestamp **   <a name="SES-Type-MultiRegionEndpoint-CreatedTimestamp"></a>
The time stamp of when the multi-region endpoint (global-endpoint) was created.  
Type: Timestamp  
Required: No

 ** EndpointId **   <a name="SES-Type-MultiRegionEndpoint-EndpointId"></a>
The ID of the multi-region endpoint (global-endpoint).  
Type: String  
Required: No

 ** EndpointName **   <a name="SES-Type-MultiRegionEndpoint-EndpointName"></a>
The name of the multi-region endpoint (global-endpoint).  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `^[\w\-_]+$`   
Required: No

 ** LastUpdatedTimestamp **   <a name="SES-Type-MultiRegionEndpoint-LastUpdatedTimestamp"></a>
The time stamp of when the multi-region endpoint (global-endpoint) was last updated.  
Type: Timestamp  
Required: No

 ** Regions **   <a name="SES-Type-MultiRegionEndpoint-Regions"></a>
Primary and secondary regions between which multi-region endpoint splits sending traffic.  
Type: Array of strings  
Required: No

 ** Status **   <a name="SES-Type-MultiRegionEndpoint-Status"></a>
The status of the multi-region endpoint (global-endpoint).  
+  `CREATING` – The resource is being provisioned.
+  `READY` – The resource is ready to use.
+  `FAILED` – The resource failed to be provisioned.
+  `DELETING` – The resource is being deleted as requested.
Type: String  
Valid Values: `CREATING | READY | FAILED | DELETING`   
Required: No

## See Also
<a name="API_MultiRegionEndpoint_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/MultiRegionEndpoint) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/MultiRegionEndpoint) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/MultiRegionEndpoint) 

# OverallVolume
<a name="API_OverallVolume"></a>

An object that contains information about email that was sent from the selected domain.

## Contents
<a name="API_OverallVolume_Contents"></a>

 ** DomainIspPlacements **   <a name="SES-Type-OverallVolume-DomainIspPlacements"></a>
An object that contains inbox and junk mail placement metrics for individual email providers.  
Type: Array of [DomainIspPlacement](API_DomainIspPlacement.md) objects  
Required: No

 ** ReadRatePercent **   <a name="SES-Type-OverallVolume-ReadRatePercent"></a>
The percentage of emails that were sent from the domain that were read by their recipients.  
Type: Double  
Required: No

 ** VolumeStatistics **   <a name="SES-Type-OverallVolume-VolumeStatistics"></a>
An object that contains information about the numbers of messages that arrived in recipients' inboxes and junk mail folders.  
Type: [VolumeStatistics](API_VolumeStatistics.md) object  
Required: No

## See Also
<a name="API_OverallVolume_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/OverallVolume) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/OverallVolume) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/OverallVolume) 

# PinpointDestination
<a name="API_PinpointDestination"></a>

An object that defines an Amazon Pinpoint project destination for email events. You can send email event data to a Amazon Pinpoint project to view metrics using the Transactional Messaging dashboards that are built in to Amazon Pinpoint. For more information, see [Transactional Messaging Charts](https://docs.aws.amazon.com/pinpoint/latest/userguide/analytics-transactional-messages.html) in the *Amazon Pinpoint User Guide*.

## Contents
<a name="API_PinpointDestination_Contents"></a>

 ** ApplicationArn **   <a name="SES-Type-PinpointDestination-ApplicationArn"></a>
The Amazon Resource Name (ARN) of the Amazon Pinpoint project to send email events to.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

## See Also
<a name="API_PinpointDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PinpointDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PinpointDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PinpointDestination) 

# PlacementStatistics
<a name="API_PlacementStatistics"></a>

An object that contains inbox placement data for an email provider.

## Contents
<a name="API_PlacementStatistics_Contents"></a>

 ** DkimPercentage **   <a name="SES-Type-PlacementStatistics-DkimPercentage"></a>
The percentage of emails that were authenticated by using DomainKeys Identified Mail (DKIM) during the predictive inbox placement test.  
Type: Double  
Required: No

 ** InboxPercentage **   <a name="SES-Type-PlacementStatistics-InboxPercentage"></a>
The percentage of emails that arrived in recipients' inboxes during the predictive inbox placement test.  
Type: Double  
Required: No

 ** MissingPercentage **   <a name="SES-Type-PlacementStatistics-MissingPercentage"></a>
The percentage of emails that didn't arrive in recipients' inboxes at all during the predictive inbox placement test.  
Type: Double  
Required: No

 ** SpamPercentage **   <a name="SES-Type-PlacementStatistics-SpamPercentage"></a>
The percentage of emails that arrived in recipients' spam or junk mail folders during the predictive inbox placement test.  
Type: Double  
Required: No

 ** SpfPercentage **   <a name="SES-Type-PlacementStatistics-SpfPercentage"></a>
The percentage of emails that were authenticated by using Sender Policy Framework (SPF) during the predictive inbox placement test.  
Type: Double  
Required: No

## See Also
<a name="API_PlacementStatistics_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/PlacementStatistics) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/PlacementStatistics) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/PlacementStatistics) 

# RawMessage
<a name="API_RawMessage"></a>

Represents the raw content of an email message.

## Contents
<a name="API_RawMessage_Contents"></a>

 ** Data **   <a name="SES-Type-RawMessage-Data"></a>
The raw email message. The message has to meet the following criteria:  
+ The message has to contain a header and a body, separated by one blank line.
+ All of the required header fields must be present in the message.
+ Each part of a multipart MIME message must be formatted properly.
+ Attachments must be in a file format that the Amazon SES supports.
+ The raw data of the message needs to base64-encoded if you are accessing Amazon SES directly through the HTTPS interface. If you are accessing Amazon SES using an AWS SDK, the SDK takes care of the base 64-encoding for you.
+ If any of the MIME parts in your message contain content that is outside of the 7-bit ASCII character range, you should encode that content to ensure that recipients' email clients render the message properly.
+ The length of any single line of text in the message can't exceed 1,000 characters. This restriction is defined in [RFC 5321](https://tools.ietf.org/html/rfc5321).
Type: Base64-encoded binary data object  
Required: Yes

## See Also
<a name="API_RawMessage_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/RawMessage) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/RawMessage) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/RawMessage) 

# Recommendation
<a name="API_Recommendation"></a>

A recommendation generated for your account.

## Contents
<a name="API_Recommendation_Contents"></a>

 ** CreatedTimestamp **   <a name="SES-Type-Recommendation-CreatedTimestamp"></a>
The first time this issue was encountered and the recommendation was generated.  
Type: Timestamp  
Required: No

 ** Description **   <a name="SES-Type-Recommendation-Description"></a>
The recommendation description / disambiguator - e.g. `DKIM1` and `DKIM2` are different recommendations about your DKIM setup.  
Type: String  
Required: No

 ** Impact **   <a name="SES-Type-Recommendation-Impact"></a>
The recommendation impact, with values like `HIGH` or `LOW`.  
Type: String  
Valid Values: `LOW | HIGH`   
Required: No

 ** LastUpdatedTimestamp **   <a name="SES-Type-Recommendation-LastUpdatedTimestamp"></a>
The last time the recommendation was updated.  
Type: Timestamp  
Required: No

 ** ResourceArn **   <a name="SES-Type-Recommendation-ResourceArn"></a>
The resource affected by the recommendation, with values like `arn:aws:ses:us-east-1:123456789012:identity/example.com`.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** Status **   <a name="SES-Type-Recommendation-Status"></a>
The recommendation status, with values like `OPEN` or `FIXED`.  
Type: String  
Valid Values: `OPEN | FIXED`   
Required: No

 ** Type **   <a name="SES-Type-Recommendation-Type"></a>
The recommendation type, with values like `DKIM`, `SPF`, `DMARC`, `BIMI`, or `COMPLAINT`.  
Type: String  
Valid Values: `DKIM | DMARC | SPF | BIMI | COMPLAINT | BOUNCE | FEEDBACK_3P | IP_LISTING`   
Required: No

## See Also
<a name="API_Recommendation_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/Recommendation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/Recommendation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/Recommendation) 

# ReplacementEmailContent
<a name="API_ReplacementEmailContent"></a>

The `ReplaceEmailContent` object to be used for a specific `BulkEmailEntry`. The `ReplacementTemplate` can be specified within this object.

## Contents
<a name="API_ReplacementEmailContent_Contents"></a>

 ** ReplacementTemplate **   <a name="SES-Type-ReplacementEmailContent-ReplacementTemplate"></a>
The `ReplacementTemplate` associated with `ReplacementEmailContent`.  
Type: [ReplacementTemplate](API_ReplacementTemplate.md) object  
Required: No

## See Also
<a name="API_ReplacementEmailContent_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ReplacementEmailContent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ReplacementEmailContent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ReplacementEmailContent) 

# ReplacementTemplate
<a name="API_ReplacementTemplate"></a>

An object which contains `ReplacementTemplateData` to be used for a specific `BulkEmailEntry`.

## Contents
<a name="API_ReplacementTemplate_Contents"></a>

 ** ReplacementTemplateData **   <a name="SES-Type-ReplacementTemplate-ReplacementTemplateData"></a>
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.  
Type: String  
Length Constraints: Maximum length of 262144.  
Required: No

## See Also
<a name="API_ReplacementTemplate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ReplacementTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ReplacementTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ReplacementTemplate) 

# ReputationEntity
<a name="API_ReputationEntity"></a>

An object that contains information about a reputation entity, including its reference, type, policy, status records, and reputation impact.

## Contents
<a name="API_ReputationEntity_Contents"></a>

 ** AwsSesManagedStatus **   <a name="SES-Type-ReputationEntity-AwsSesManagedStatus"></a>
The AWS Amazon SES-managed status record for this reputation entity, including the current status, cause description, and last updated timestamp.  
Type: [StatusRecord](API_StatusRecord.md) object  
Required: No

 ** CustomerManagedStatus **   <a name="SES-Type-ReputationEntity-CustomerManagedStatus"></a>
The customer-managed status record for this reputation entity, including the current status, cause description, and last updated timestamp.  
Type: [StatusRecord](API_StatusRecord.md) object  
Required: No

 ** ReputationEntityReference **   <a name="SES-Type-ReputationEntity-ReputationEntityReference"></a>
The unique identifier for the reputation entity. For resource-type entities, this is the Amazon Resource Name (ARN) of the resource.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** ReputationEntityType **   <a name="SES-Type-ReputationEntity-ReputationEntityType"></a>
The type of reputation entity. Currently, only `RESOURCE` type entities are supported.  
Type: String  
Valid Values: `RESOURCE`   
Required: No

 ** ReputationImpact **   <a name="SES-Type-ReputationEntity-ReputationImpact"></a>
The reputation impact level for this entity, representing the highest impact reputation finding currently active. Reputation findings can be retrieved using the `ListRecommendations` operation.  
Type: String  
Valid Values: `LOW | HIGH`   
Required: No

 ** ReputationManagementPolicy **   <a name="SES-Type-ReputationEntity-ReputationManagementPolicy"></a>
The Amazon Resource Name (ARN) of the reputation management policy applied to this entity. This is an AWS Amazon SES-managed policy.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** SendingStatusAggregate **   <a name="SES-Type-ReputationEntity-SendingStatusAggregate"></a>
The aggregate sending status that determines whether the entity is allowed to send emails. This status is derived from both the customer-managed and AWS Amazon SES-managed statuses. If either the customer-managed status or the AWS Amazon SES-managed status is `DISABLED`, the aggregate status will be `DISABLED` and the entity will not be allowed to send emails. When the customer-managed status is set to `REINSTATED`, the entity can continue sending even if there are active reputation findings, provided the AWS Amazon SES-managed status also permits sending. The entity can only send emails when both statuses permit sending.  
Type: String  
Valid Values: `ENABLED | REINSTATED | DISABLED`   
Required: No

## See Also
<a name="API_ReputationEntity_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ReputationEntity) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ReputationEntity) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ReputationEntity) 

# ReputationOptions
<a name="API_ReputationOptions"></a>

Enable or disable collection of reputation metrics for emails that you send using this configuration set in the current AWS Region. 

## Contents
<a name="API_ReputationOptions_Contents"></a>

 ** LastFreshStart **   <a name="SES-Type-ReputationOptions-LastFreshStart"></a>
The date and time (in Unix time) when the reputation metrics were last given a fresh start. When your account is given a fresh start, your reputation metrics are calculated starting from the date of the fresh start.  
Type: Timestamp  
Required: No

 ** ReputationMetricsEnabled **   <a name="SES-Type-ReputationOptions-ReputationMetricsEnabled"></a>
If `true`, tracking of reputation metrics is enabled for the configuration set. If `false`, tracking of reputation metrics is disabled for the configuration set.  
Type: Boolean  
Required: No

## See Also
<a name="API_ReputationOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ReputationOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ReputationOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ReputationOptions) 

# ResourceTenantMetadata
<a name="API_ResourceTenantMetadata"></a>

A structure that contains information about a tenant associated with a resource.

## Contents
<a name="API_ResourceTenantMetadata_Contents"></a>

 ** AssociatedTimestamp **   <a name="SES-Type-ResourceTenantMetadata-AssociatedTimestamp"></a>
The date and time when the resource was associated with the tenant.  
Type: Timestamp  
Required: No

 ** ResourceArn **   <a name="SES-Type-ResourceTenantMetadata-ResourceArn"></a>
The Amazon Resource Name (ARN) of the resource.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** TenantId **   <a name="SES-Type-ResourceTenantMetadata-TenantId"></a>
A unique identifier for the tenant associated with the resource.  
Type: String  
Required: No

 ** TenantName **   <a name="SES-Type-ResourceTenantMetadata-TenantName"></a>
The name of the tenant associated with the resource.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

## See Also
<a name="API_ResourceTenantMetadata_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ResourceTenantMetadata) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ResourceTenantMetadata) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ResourceTenantMetadata) 

# ReviewDetails
<a name="API_ReviewDetails"></a>

An object that contains information about your account details review.

## Contents
<a name="API_ReviewDetails_Contents"></a>

 ** CaseId **   <a name="SES-Type-ReviewDetails-CaseId"></a>
The associated support center case ID (if any).  
Type: String  
Required: No

 ** Status **   <a name="SES-Type-ReviewDetails-Status"></a>
The status of the latest review of your account. The status can be one of the following:  
+  `PENDING` – We have received your appeal and are in the process of reviewing it.
+  `GRANTED` – Your appeal has been reviewed and your production access has been granted.
+  `DENIED` – Your appeal has been reviewed and your production access has been denied.
+  `FAILED` – An internal error occurred and we didn't receive your appeal. You can submit your appeal again.
Type: String  
Valid Values: `PENDING | FAILED | GRANTED | DENIED`   
Required: No

## See Also
<a name="API_ReviewDetails_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/ReviewDetails) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ReviewDetails) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/ReviewDetails) 

# Route
<a name="API_Route"></a>

An object which contains an AWS-Region and routing status.

## Contents
<a name="API_Route_Contents"></a>

 ** Region **   <a name="SES-Type-Route-Region"></a>
The name of an AWS-Region.  
Type: String  
Required: Yes

## See Also
<a name="API_Route_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/Route) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/Route) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/Route) 

# RouteDetails
<a name="API_RouteDetails"></a>

An object that contains route configuration. Includes secondary region name.

## Contents
<a name="API_RouteDetails_Contents"></a>

 ** Region **   <a name="SES-Type-RouteDetails-Region"></a>
The name of an AWS-Region to be a secondary region for the multi-region endpoint (global-endpoint).  
Type: String  
Required: Yes

## See Also
<a name="API_RouteDetails_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/RouteDetails) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/RouteDetails) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/RouteDetails) 

# SendingOptions
<a name="API_SendingOptions"></a>

Used to enable or disable email sending for messages that use this configuration set in the current AWS Region.

## Contents
<a name="API_SendingOptions_Contents"></a>

 ** SendingEnabled **   <a name="SES-Type-SendingOptions-SendingEnabled"></a>
If `true`, email sending is enabled for the configuration set. If `false`, email sending is disabled for the configuration set.  
Type: Boolean  
Required: No

## See Also
<a name="API_SendingOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SendingOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SendingOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SendingOptions) 

# SendQuota
<a name="API_SendQuota"></a>

An object that contains information about the per-day and per-second sending limits for your Amazon SES account in the current AWS Region.

## Contents
<a name="API_SendQuota_Contents"></a>

 ** Max24HourSend **   <a name="SES-Type-SendQuota-Max24HourSend"></a>
The maximum number of emails that you can send in the current AWS Region over a 24-hour period. A value of -1 signifies an unlimited quota. (This value is also referred to as your *sending quota*.)  
Type: Double  
Required: No

 ** MaxSendRate **   <a name="SES-Type-SendQuota-MaxSendRate"></a>
The maximum number of emails that you can send per second in the current AWS Region. This value is also called your *maximum sending rate* or your *maximum TPS (transactions per second) rate*.  
Type: Double  
Required: No

 ** SentLast24Hours **   <a name="SES-Type-SendQuota-SentLast24Hours"></a>
The number of emails sent from your Amazon SES account in the current AWS Region over the past 24 hours.  
Type: Double  
Required: No

## See Also
<a name="API_SendQuota_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SendQuota) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SendQuota) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SendQuota) 

# SnsDestination
<a name="API_SnsDestination"></a>

An object that defines an Amazon SNS destination for email events. You can use Amazon SNS to send notifications when certain email events occur.

## Contents
<a name="API_SnsDestination_Contents"></a>

 ** TopicArn **   <a name="SES-Type-SnsDestination-TopicArn"></a>
The Amazon Resource Name (ARN) of the Amazon SNS topic to publish email events to. For more information about Amazon SNS topics, see the [Amazon SNS Developer Guide](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html).  
Type: String  
Length Constraints: Minimum length of 1.  
Required: Yes

## See Also
<a name="API_SnsDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SnsDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SnsDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SnsDestination) 

# SOARecord
<a name="API_SOARecord"></a>

An object that contains information about the start of authority (SOA) record associated with the identity.

## Contents
<a name="API_SOARecord_Contents"></a>

 ** AdminEmail **   <a name="SES-Type-SOARecord-AdminEmail"></a>
Administrative contact email from the SOA record.  
Type: String  
Required: No

 ** PrimaryNameServer **   <a name="SES-Type-SOARecord-PrimaryNameServer"></a>
Primary name server specified in the SOA record.  
Type: String  
Required: No

 ** SerialNumber **   <a name="SES-Type-SOARecord-SerialNumber"></a>
Serial number from the SOA record.  
Type: Long  
Required: No

## See Also
<a name="API_SOARecord_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SOARecord) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SOARecord) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SOARecord) 

# StatusRecord
<a name="API_StatusRecord"></a>

An object that contains status information for a reputation entity, including the current status, cause description, and timestamp.

## Contents
<a name="API_StatusRecord_Contents"></a>

 ** Cause **   <a name="SES-Type-StatusRecord-Cause"></a>
A description of the reason for the current status, or null if no specific cause is available.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 512.  
Required: No

 ** LastUpdatedTimestamp **   <a name="SES-Type-StatusRecord-LastUpdatedTimestamp"></a>
The timestamp when this status was last updated.  
Type: Timestamp  
Required: No

 ** Status **   <a name="SES-Type-StatusRecord-Status"></a>
The current sending status. This can be one of the following:  
+  `ENABLED` – Sending is allowed.
+  `DISABLED` – Sending is prevented.
+  `REINSTATED` – Sending is allowed even with active reputation findings.
Type: String  
Valid Values: `ENABLED | REINSTATED | DISABLED`   
Required: No

## See Also
<a name="API_StatusRecord_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/StatusRecord) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/StatusRecord) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/StatusRecord) 

# SuppressedDestination
<a name="API_SuppressedDestination"></a>

An object that contains information about an email address that is on the suppression list for your account.

## Contents
<a name="API_SuppressedDestination_Contents"></a>

 ** EmailAddress **   <a name="SES-Type-SuppressedDestination-EmailAddress"></a>
The email address that is on the suppression list for your account.  
Type: String  
Required: Yes

 ** LastUpdateTime **   <a name="SES-Type-SuppressedDestination-LastUpdateTime"></a>
The date and time when the suppressed destination was last updated, shown in Unix time format.  
Type: Timestamp  
Required: Yes

 ** Reason **   <a name="SES-Type-SuppressedDestination-Reason"></a>
The reason that the address was added to the suppression list for your account.  
Type: String  
Valid Values: `BOUNCE | COMPLAINT`   
Required: Yes

 ** Attributes **   <a name="SES-Type-SuppressedDestination-Attributes"></a>
An optional value that can contain additional information about the reasons that the address was added to the suppression list for your account.  
Type: [SuppressedDestinationAttributes](API_SuppressedDestinationAttributes.md) object  
Required: No

## See Also
<a name="API_SuppressedDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SuppressedDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SuppressedDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SuppressedDestination) 

# SuppressedDestinationAttributes
<a name="API_SuppressedDestinationAttributes"></a>

An object that contains additional attributes that are related an email address that is on the suppression list for your account.

## Contents
<a name="API_SuppressedDestinationAttributes_Contents"></a>

 ** FeedbackId **   <a name="SES-Type-SuppressedDestinationAttributes-FeedbackId"></a>
A unique identifier that's generated when an email address is added to the suppression list for your account.  
Type: String  
Required: No

 ** MessageId **   <a name="SES-Type-SuppressedDestinationAttributes-MessageId"></a>
The unique identifier of the email message that caused the email address to be added to the suppression list for your account.  
Type: String  
Required: No

## See Also
<a name="API_SuppressedDestinationAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SuppressedDestinationAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SuppressedDestinationAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SuppressedDestinationAttributes) 

# SuppressedDestinationSummary
<a name="API_SuppressedDestinationSummary"></a>

A summary that describes the suppressed email address.

## Contents
<a name="API_SuppressedDestinationSummary_Contents"></a>

 ** EmailAddress **   <a name="SES-Type-SuppressedDestinationSummary-EmailAddress"></a>
The email address that's on the suppression list for your account.  
Type: String  
Required: Yes

 ** LastUpdateTime **   <a name="SES-Type-SuppressedDestinationSummary-LastUpdateTime"></a>
The date and time when the suppressed destination was last updated, shown in Unix time format.  
Type: Timestamp  
Required: Yes

 ** Reason **   <a name="SES-Type-SuppressedDestinationSummary-Reason"></a>
The reason that the address was added to the suppression list for your account.  
Type: String  
Valid Values: `BOUNCE | COMPLAINT`   
Required: Yes

## See Also
<a name="API_SuppressedDestinationSummary_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SuppressedDestinationSummary) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SuppressedDestinationSummary) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SuppressedDestinationSummary) 

# SuppressionAttributes
<a name="API_SuppressionAttributes"></a>

An object that contains information about the email address suppression preferences for your account in the current AWS Region.

## Contents
<a name="API_SuppressionAttributes_Contents"></a>

 ** SuppressedReasons **   <a name="SES-Type-SuppressionAttributes-SuppressedReasons"></a>
A list that contains the reasons that email addresses will be automatically added to the suppression list for your account. This list can contain any or all of the following:  
+  `COMPLAINT` – Amazon SES adds an email address to the suppression list for your account when a message sent to that address results in a complaint.
+  `BOUNCE` – Amazon SES adds an email address to the suppression list for your account when a message sent to that address results in a hard bounce.
Type: Array of strings  
Valid Values: `BOUNCE | COMPLAINT`   
Required: No

 ** ValidationAttributes **   <a name="SES-Type-SuppressionAttributes-ValidationAttributes"></a>
Structure containing validation attributes used for suppressing sending to specific destination on account level.  
Type: [SuppressionValidationAttributes](API_SuppressionValidationAttributes.md) object  
Required: No

## See Also
<a name="API_SuppressionAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SuppressionAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SuppressionAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SuppressionAttributes) 

# SuppressionConditionThreshold
<a name="API_SuppressionConditionThreshold"></a>

Contains Auto Validation settings, allowing you to suppress sending to specific destination(s) if they do not meet required threshold. For details on Auto Validation, see [Auto Validation](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/email-validation.html).

## Contents
<a name="API_SuppressionConditionThreshold_Contents"></a>

 ** ConditionThresholdEnabled **   <a name="SES-Type-SuppressionConditionThreshold-ConditionThresholdEnabled"></a>
Indicates whether Auto Validation is enabled for suppression. Set to `ENABLED` to enable the Auto Validation feature, or set to `DISABLED` to disable it.  
Type: String  
Valid Values: `ENABLED | DISABLED`   
Required: Yes

 ** OverallConfidenceThreshold **   <a name="SES-Type-SuppressionConditionThreshold-OverallConfidenceThreshold"></a>
The overall confidence threshold used to determine suppression decisions.  
Type: [SuppressionConfidenceThreshold](API_SuppressionConfidenceThreshold.md) object  
Required: No

## See Also
<a name="API_SuppressionConditionThreshold_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SuppressionConditionThreshold) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SuppressionConditionThreshold) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SuppressionConditionThreshold) 

# SuppressionConfidenceThreshold
<a name="API_SuppressionConfidenceThreshold"></a>

Contains the confidence threshold settings for Auto Validation.

## Contents
<a name="API_SuppressionConfidenceThreshold_Contents"></a>

 ** ConfidenceVerdictThreshold **   <a name="SES-Type-SuppressionConfidenceThreshold-ConfidenceVerdictThreshold"></a>
The confidence level threshold for suppression decisions.  
Type: String  
Valid Values: `MEDIUM | HIGH | MANAGED`   
Required: Yes

## See Also
<a name="API_SuppressionConfidenceThreshold_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SuppressionConfidenceThreshold) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SuppressionConfidenceThreshold) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SuppressionConfidenceThreshold) 

# SuppressionListDestination
<a name="API_SuppressionListDestination"></a>

An object that contains details about the action of suppression list.

## Contents
<a name="API_SuppressionListDestination_Contents"></a>

 ** SuppressionListImportAction **   <a name="SES-Type-SuppressionListDestination-SuppressionListImportAction"></a>
The type of action to perform on the address. The following are possible values:  
+ PUT: add the addresses to the suppression list. If the record already exists, it will override it with the new value.
+ DELETE: remove the addresses from the suppression list.
Type: String  
Valid Values: `DELETE | PUT`   
Required: Yes

## See Also
<a name="API_SuppressionListDestination_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SuppressionListDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SuppressionListDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SuppressionListDestination) 

# SuppressionOptions
<a name="API_SuppressionOptions"></a>

An object that contains information about the suppression list preferences for your account.

## Contents
<a name="API_SuppressionOptions_Contents"></a>

 ** SuppressedReasons **   <a name="SES-Type-SuppressionOptions-SuppressedReasons"></a>
A list that contains the reasons that email addresses are automatically added to the suppression list for your account. This list can contain any or all of the following:  
+  `COMPLAINT` – Amazon SES adds an email address to the suppression list for your account when a message sent to that address results in a complaint.
+  `BOUNCE` – Amazon SES adds an email address to the suppression list for your account when a message sent to that address results in a hard bounce.
Type: Array of strings  
Valid Values: `BOUNCE | COMPLAINT`   
Required: No

 ** ValidationOptions **   <a name="SES-Type-SuppressionOptions-ValidationOptions"></a>
Contains validation options for email address suppression.  
Type: [SuppressionValidationOptions](API_SuppressionValidationOptions.md) object  
Required: No

## See Also
<a name="API_SuppressionOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SuppressionOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SuppressionOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SuppressionOptions) 

# SuppressionValidationAttributes
<a name="API_SuppressionValidationAttributes"></a>

Structure containing validation attributes used for suppressing sending to specific destination on account level.

## Contents
<a name="API_SuppressionValidationAttributes_Contents"></a>

 ** ConditionThreshold **   <a name="SES-Type-SuppressionValidationAttributes-ConditionThreshold"></a>
Specifies the condition threshold settings for account-level suppression.  
Type: [SuppressionConditionThreshold](API_SuppressionConditionThreshold.md) object  
Required: Yes

## See Also
<a name="API_SuppressionValidationAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SuppressionValidationAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SuppressionValidationAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SuppressionValidationAttributes) 

# SuppressionValidationOptions
<a name="API_SuppressionValidationOptions"></a>

Contains validation options for email address suppression.

## Contents
<a name="API_SuppressionValidationOptions_Contents"></a>

 ** ConditionThreshold **   <a name="SES-Type-SuppressionValidationOptions-ConditionThreshold"></a>
Specifies the condition threshold settings for suppression validation.  
Type: [SuppressionConditionThreshold](API_SuppressionConditionThreshold.md) object  
Required: Yes

## See Also
<a name="API_SuppressionValidationOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/SuppressionValidationOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SuppressionValidationOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/SuppressionValidationOptions) 

# Tag
<a name="API_Tag"></a>

An object that defines the tags that are associated with a resource. A *tag* is a label that you optionally define and associate with a resource. Tags can help you categorize and manage resources in different ways, such as by purpose, owner, environment, or other criteria. A resource can have as many as 50 tags.

Each tag consists of a required *tag key* and an associated *tag value*, both of which you define. A tag key is a general label that acts as a category for a more specific tag value. A tag value acts as a descriptor within a tag key. A tag key can contain as many as 128 characters. A tag value can contain as many as 256 characters. The characters can be Unicode letters, digits, white space, or one of the following symbols: \$1 . : / = \$1 -. The following additional restrictions apply to tags:
+ Tag keys and values are case sensitive.
+ For each associated resource, each tag key must be unique and it can have only one value.
+ The `aws:` prefix is reserved for use by AWS; you can’t use it in any tag keys or values that you define. In addition, you can't edit or remove tag keys or values that use this prefix. Tags that use this prefix don’t count against the limit of 50 tags per resource.
+ You can associate tags with public or shared resources, but the tags are available only for your AWS account, not any other accounts that share the resource. In addition, the tags are available only for resources that are located in the specified AWS Region for your AWS account.

## Contents
<a name="API_Tag_Contents"></a>

 ** Key **   <a name="SES-Type-Tag-Key"></a>
One part of a key-value pair that defines a tag. The maximum length of a tag key is 128 characters. The minimum length is 1 character.  
Type: String  
Required: Yes

 ** Value **   <a name="SES-Type-Tag-Value"></a>
The optional part of a key-value pair that defines a tag. The maximum length of a tag value is 256 characters. The minimum length is 0 characters. If you don't want a resource to have a specific tag value, don't specify a value for this parameter. If you don't specify a value, Amazon SES sets the value to an empty string.  
Type: String  
Required: Yes

## See Also
<a name="API_Tag_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/Tag) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/Tag) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/Tag) 

# Template
<a name="API_Template"></a>

An object that defines the email template to use for an email message, and the values to use for any message variables in that template. An *email template* is a type of message template that contains content that you want to reuse in email messages that you send. You can specifiy the email template by providing the name or ARN of an *email template* previously saved in your Amazon SES account or by providing the full template content.

## Contents
<a name="API_Template_Contents"></a>

 ** Attachments **   <a name="SES-Type-Template-Attachments"></a>
 The List of attachments to include in your email. All recipients will receive the same attachments.  
Type: Array of [Attachment](API_Attachment.md) objects  
Required: No

 ** Headers **   <a name="SES-Type-Template-Headers"></a>
The list of message headers that will be added to the email message.  
Type: Array of [MessageHeader](API_MessageHeader.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 15 items.  
Required: No

 ** TemplateArn **   <a name="SES-Type-Template-TemplateArn"></a>
The Amazon Resource Name (ARN) of the template.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** TemplateContent **   <a name="SES-Type-Template-TemplateContent"></a>
The content of the template.  
Amazon SES supports only simple substitions when you send email using the `SendEmail` or `SendBulkEmail` operations and you provide the full template content in the request.
Type: [EmailTemplateContent](API_EmailTemplateContent.md) object  
Required: No

 ** TemplateData **   <a name="SES-Type-Template-TemplateData"></a>
An object that defines the values to use for message variables in the template. This object is a set of key-value pairs. Each key defines a message variable in the template. The corresponding value defines the value to use for that variable.  
Type: String  
Length Constraints: Maximum length of 262144.  
Required: No

 ** TemplateName **   <a name="SES-Type-Template-TemplateName"></a>
The name of the template. You will refer to this name when you send email using the `SendEmail` or `SendBulkEmail` operations.   
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

## See Also
<a name="API_Template_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/Template) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/Template) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/Template) 

# Tenant
<a name="API_Tenant"></a>

A structure that contains details about a tenant.

## Contents
<a name="API_Tenant_Contents"></a>

 ** CreatedTimestamp **   <a name="SES-Type-Tenant-CreatedTimestamp"></a>
The date and time when the tenant was created.  
Type: Timestamp  
Required: No

 ** SendingStatus **   <a name="SES-Type-Tenant-SendingStatus"></a>
The status of sending capability for the tenant.  
Type: String  
Valid Values: `ENABLED | REINSTATED | DISABLED`   
Required: No

 ** Tags **   <a name="SES-Type-Tenant-Tags"></a>
An array of objects that define the tags (keys and values) associated with the tenant.  
Type: Array of [Tag](API_Tag.md) objects  
Required: No

 ** TenantArn **   <a name="SES-Type-Tenant-TenantArn"></a>
The Amazon Resource Name (ARN) of the tenant.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** TenantId **   <a name="SES-Type-Tenant-TenantId"></a>
A unique identifier for the tenant.  
Type: String  
Required: No

 ** TenantName **   <a name="SES-Type-Tenant-TenantName"></a>
The name of the tenant.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

## See Also
<a name="API_Tenant_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/Tenant) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/Tenant) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/Tenant) 

# TenantInfo
<a name="API_TenantInfo"></a>

A structure that contains basic information about a tenant.

## Contents
<a name="API_TenantInfo_Contents"></a>

 ** CreatedTimestamp **   <a name="SES-Type-TenantInfo-CreatedTimestamp"></a>
The date and time when the tenant was created.  
Type: Timestamp  
Required: No

 ** TenantArn **   <a name="SES-Type-TenantInfo-TenantArn"></a>
The Amazon Resource Name (ARN) of the tenant.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** TenantId **   <a name="SES-Type-TenantInfo-TenantId"></a>
A unique identifier for the tenant.  
Type: String  
Required: No

 ** TenantName **   <a name="SES-Type-TenantInfo-TenantName"></a>
The name of the tenant.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

## See Also
<a name="API_TenantInfo_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/TenantInfo) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/TenantInfo) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/TenantInfo) 

# TenantResource
<a name="API_TenantResource"></a>

A structure that contains information about a resource associated with a tenant.

## Contents
<a name="API_TenantResource_Contents"></a>

 ** ResourceArn **   <a name="SES-Type-TenantResource-ResourceArn"></a>
The Amazon Resource Name (ARN) of the resource associated with the tenant.  
Type: String  
Length Constraints: Minimum length of 1.  
Required: No

 ** ResourceType **   <a name="SES-Type-TenantResource-ResourceType"></a>
The type of resource associated with the tenant. Valid values are `EMAIL_IDENTITY`, `CONFIGURATION_SET`, or `EMAIL_TEMPLATE`.  
Type: String  
Valid Values: `EMAIL_IDENTITY | CONFIGURATION_SET | EMAIL_TEMPLATE`   
Required: No

## See Also
<a name="API_TenantResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/TenantResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/TenantResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/TenantResource) 

# Topic
<a name="API_Topic"></a>

An interest group, theme, or label within a list. Lists can have multiple topics.

## Contents
<a name="API_Topic_Contents"></a>

 ** DefaultSubscriptionStatus **   <a name="SES-Type-Topic-DefaultSubscriptionStatus"></a>
The default subscription status to be applied to a contact if the contact has not noted their preference for subscribing to a topic.  
Type: String  
Valid Values: `OPT_IN | OPT_OUT`   
Required: Yes

 ** DisplayName **   <a name="SES-Type-Topic-DisplayName"></a>
The name of the topic the contact will see.  
Type: String  
Required: Yes

 ** TopicName **   <a name="SES-Type-Topic-TopicName"></a>
The name of the topic.  
Type: String  
Required: Yes

 ** Description **   <a name="SES-Type-Topic-Description"></a>
A description of what the topic is about, which the contact will see.  
Type: String  
Required: No

## See Also
<a name="API_Topic_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/Topic) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/Topic) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/Topic) 

# TopicFilter
<a name="API_TopicFilter"></a>

Used for filtering by a specific topic preference.

## Contents
<a name="API_TopicFilter_Contents"></a>

 ** TopicName **   <a name="SES-Type-TopicFilter-TopicName"></a>
The name of a topic on which you wish to apply the filter.  
Type: String  
Required: No

 ** UseDefaultIfPreferenceUnavailable **   <a name="SES-Type-TopicFilter-UseDefaultIfPreferenceUnavailable"></a>
Notes that the default subscription status should be applied to a contact because the contact has not noted their preference for subscribing to a topic.  
Type: Boolean  
Required: No

## See Also
<a name="API_TopicFilter_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/TopicFilter) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/TopicFilter) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/TopicFilter) 

# TopicPreference
<a name="API_TopicPreference"></a>

The contact's preference for being opted-in to or opted-out of a topic.

## Contents
<a name="API_TopicPreference_Contents"></a>

 ** SubscriptionStatus **   <a name="SES-Type-TopicPreference-SubscriptionStatus"></a>
The contact's subscription status to a topic which is either `OPT_IN` or `OPT_OUT`.  
Type: String  
Valid Values: `OPT_IN | OPT_OUT`   
Required: Yes

 ** TopicName **   <a name="SES-Type-TopicPreference-TopicName"></a>
The name of the topic.  
Type: String  
Required: Yes

## See Also
<a name="API_TopicPreference_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/TopicPreference) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/TopicPreference) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/TopicPreference) 

# TrackingOptions
<a name="API_TrackingOptions"></a>

An object that defines the tracking options for a configuration set. When you use the Amazon SES API v2 to send an email, it contains an invisible image that's used to track when recipients open your email. If your email contains links, those links are changed slightly in order to track when recipients click them.

These images and links include references to a domain operated by AWS. You can optionally configure the Amazon SES to use a domain that you operate for these images and links.

## Contents
<a name="API_TrackingOptions_Contents"></a>

 ** CustomRedirectDomain **   <a name="SES-Type-TrackingOptions-CustomRedirectDomain"></a>
The domain to use for tracking open and click events.  
Type: String  
Required: Yes

 ** HttpsPolicy **   <a name="SES-Type-TrackingOptions-HttpsPolicy"></a>
The https policy to use for tracking open and click events.  
Type: String  
Valid Values: `REQUIRE | REQUIRE_OPEN_ONLY | OPTIONAL`   
Required: No

## See Also
<a name="API_TrackingOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/TrackingOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/TrackingOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/TrackingOptions) 

# VdmAttributes
<a name="API_VdmAttributes"></a>

The VDM attributes that apply to your Amazon SES account.

## Contents
<a name="API_VdmAttributes_Contents"></a>

 ** VdmEnabled **   <a name="SES-Type-VdmAttributes-VdmEnabled"></a>
Specifies the status of your VDM configuration. Can be one of the following:  
+  `ENABLED` – Amazon SES enables VDM for your account.
+  `DISABLED` – Amazon SES disables VDM for your account.
Type: String  
Valid Values: `ENABLED | DISABLED`   
Required: Yes

 ** DashboardAttributes **   <a name="SES-Type-VdmAttributes-DashboardAttributes"></a>
Specifies additional settings for your VDM configuration as applicable to the Dashboard.  
Type: [DashboardAttributes](API_DashboardAttributes.md) object  
Required: No

 ** GuardianAttributes **   <a name="SES-Type-VdmAttributes-GuardianAttributes"></a>
Specifies additional settings for your VDM configuration as applicable to the Guardian.  
Type: [GuardianAttributes](API_GuardianAttributes.md) object  
Required: No

## See Also
<a name="API_VdmAttributes_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/VdmAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/VdmAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/VdmAttributes) 

# VdmOptions
<a name="API_VdmOptions"></a>

An object that defines the VDM settings that apply to emails that you send using the configuration set.

## Contents
<a name="API_VdmOptions_Contents"></a>

 ** DashboardOptions **   <a name="SES-Type-VdmOptions-DashboardOptions"></a>
Specifies additional settings for your VDM configuration as applicable to the Dashboard.  
Type: [DashboardOptions](API_DashboardOptions.md) object  
Required: No

 ** GuardianOptions **   <a name="SES-Type-VdmOptions-GuardianOptions"></a>
Specifies additional settings for your VDM configuration as applicable to the Guardian.  
Type: [GuardianOptions](API_GuardianOptions.md) object  
Required: No

## See Also
<a name="API_VdmOptions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/VdmOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/VdmOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/VdmOptions) 

# VerificationInfo
<a name="API_VerificationInfo"></a>

An object that contains additional information about the verification status for the identity.

## Contents
<a name="API_VerificationInfo_Contents"></a>

 ** ErrorType **   <a name="SES-Type-VerificationInfo-ErrorType"></a>
Provides the reason for the failure describing why Amazon SES was not able to successfully verify the identity. Below are the possible values:   
+  `INVALID_VALUE` – Amazon SES was able to find the record, but the value contained within the record was invalid. Ensure you have published the correct values for the record.
+  `TYPE_NOT_FOUND` – The queried hostname exists but does not have the requested type of DNS record. Ensure that you have published the correct type of DNS record.
+  `HOST_NOT_FOUND` – The queried hostname does not exist or was not reachable at the time of the request. Ensure that you have published the required DNS record(s). 
+  `SERVICE_ERROR` – A temporary issue is preventing Amazon SES from determining the verification status of the domain.
+  `DNS_SERVER_ERROR` – The DNS server encountered an issue and was unable to complete the request.
+  `REPLICATION_ACCESS_DENIED` – The verification failed because the user does not have the required permissions to replicate the DKIM key from the primary region. Ensure you have the necessary permissions in both primary and replica regions. 
+  `REPLICATION_PRIMARY_NOT_FOUND` – The verification failed because no corresponding identity was found in the specified primary region. Ensure the identity exists in the primary region before attempting replication. 
+  `REPLICATION_PRIMARY_BYO_DKIM_NOT_SUPPORTED` – The verification failed because the identity in the primary region is configured with Bring Your Own DKIM (BYODKIM). DKIM key replication is only supported for identities using Easy DKIM. 
+  `REPLICATION_REPLICA_AS_PRIMARY_NOT_SUPPORTED` – The verification failed because the specified primary identity is a replica of another identity, and multi-level replication is not supported; the primary identity must be a non-replica identity. 
+  `REPLICATION_PRIMARY_INVALID_REGION` – The verification failed due to an invalid primary region specified. Ensure you provide a valid AWS region where Amazon SES is available and different from the replica region. 
Type: String  
Valid Values: `SERVICE_ERROR | DNS_SERVER_ERROR | HOST_NOT_FOUND | TYPE_NOT_FOUND | INVALID_VALUE | REPLICATION_ACCESS_DENIED | REPLICATION_PRIMARY_NOT_FOUND | REPLICATION_PRIMARY_BYO_DKIM_NOT_SUPPORTED | REPLICATION_REPLICA_AS_PRIMARY_NOT_SUPPORTED | REPLICATION_PRIMARY_INVALID_REGION`   
Required: No

 ** LastCheckedTimestamp **   <a name="SES-Type-VerificationInfo-LastCheckedTimestamp"></a>
The last time a verification attempt was made for this identity.  
Type: Timestamp  
Required: No

 ** LastSuccessTimestamp **   <a name="SES-Type-VerificationInfo-LastSuccessTimestamp"></a>
The last time a successful verification was made for this identity.  
Type: Timestamp  
Required: No

 ** SOARecord **   <a name="SES-Type-VerificationInfo-SOARecord"></a>
An object that contains information about the start of authority (SOA) record associated with the identity.  
Type: [SOARecord](API_SOARecord.md) object  
Required: No

## See Also
<a name="API_VerificationInfo_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/VerificationInfo) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/VerificationInfo) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/VerificationInfo) 

# VolumeStatistics
<a name="API_VolumeStatistics"></a>

An object that contains information about the amount of email that was delivered to recipients.

## Contents
<a name="API_VolumeStatistics_Contents"></a>

 ** InboxRawCount **   <a name="SES-Type-VolumeStatistics-InboxRawCount"></a>
The total number of emails that arrived in recipients' inboxes.  
Type: Long  
Required: No

 ** ProjectedInbox **   <a name="SES-Type-VolumeStatistics-ProjectedInbox"></a>
An estimate of the percentage of emails sent from the current domain that will arrive in recipients' inboxes.  
Type: Long  
Required: No

 ** ProjectedSpam **   <a name="SES-Type-VolumeStatistics-ProjectedSpam"></a>
An estimate of the percentage of emails sent from the current domain that will arrive in recipients' spam or junk mail folders.  
Type: Long  
Required: No

 ** SpamRawCount **   <a name="SES-Type-VolumeStatistics-SpamRawCount"></a>
The total number of emails that arrived in recipients' spam or junk mail folders.  
Type: Long  
Required: No

## See Also
<a name="API_VolumeStatistics_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/sesv2-2019-09-27/VolumeStatistics) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/VolumeStatistics) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/sesv2-2019-09-27/VolumeStatistics)