SES v2 (Simple Email Service v2)

Implementation details for API sesv2

Coverage Overview

Simple Email Service v2 (SES v2) is supported by LocalStack only in the pro image.

AvailabilityTesting*
OperationImplementedImageInternal Test SuiteExternal Test SuiteTerraform ValidatedAWS ValidatedSnapshot TestedDetails
BatchGetMetricData
CancelExportJob
CreateConfigurationSet
CreateConfigurationSetEventDestination
CreateContact
CreateContactList
CreateCustomVerificationEmailTemplate
CreateDedicatedIpPool
CreateDeliverabilityTestReport
CreateEmailIdentity✔️pro✔️Show Tests
CreateEmailIdentityPolicy
CreateEmailTemplate✔️pro✔️Show Tests
CreateExportJob
CreateImportJob
DeleteConfigurationSet
DeleteConfigurationSetEventDestination
DeleteContact
DeleteContactList
DeleteCustomVerificationEmailTemplate
DeleteDedicatedIpPool
DeleteEmailIdentity✔️pro✔️Show Tests
DeleteEmailIdentityPolicy
DeleteEmailTemplate✔️pro
DeleteSuppressedDestination
GetAccount
GetBlacklistReports
GetConfigurationSet
GetConfigurationSetEventDestinations
GetContact
GetContactList
GetCustomVerificationEmailTemplate
GetDedicatedIp
GetDedicatedIpPool
GetDedicatedIps
GetDeliverabilityDashboardOptions
GetDeliverabilityTestReport
GetDomainDeliverabilityCampaign
GetDomainStatisticsReport
GetEmailIdentity✔️pro✔️Show Tests
GetEmailIdentityPolicies
GetEmailTemplate
GetExportJob
GetImportJob
GetMessageInsights
GetSuppressedDestination
ListConfigurationSets
ListContactLists
ListContacts
ListCustomVerificationEmailTemplates
ListDedicatedIpPools
ListDeliverabilityTestReports
ListDomainDeliverabilityCampaigns
ListEmailIdentities✔️pro✔️Show Tests
ListEmailTemplates✔️pro
ListExportJobs
ListImportJobs
ListRecommendations
ListSuppressedDestinations
ListTagsForResource
PutAccountDedicatedIpWarmupAttributes
PutAccountDetails
PutAccountSendingAttributes
PutAccountSuppressionAttributes
PutAccountVdmAttributes
PutConfigurationSetDeliveryOptions
PutConfigurationSetReputationOptions
PutConfigurationSetSendingOptions
PutConfigurationSetSuppressionOptions
PutConfigurationSetTrackingOptions
PutConfigurationSetVdmOptions
PutDedicatedIpInPool
PutDedicatedIpPoolScalingAttributes
PutDedicatedIpWarmupAttributes
PutDeliverabilityDashboardOption
PutEmailIdentityConfigurationSetAttributes
PutEmailIdentityDkimAttributes
PutEmailIdentityDkimSigningAttributes✔️pro
PutEmailIdentityFeedbackAttributes
PutEmailIdentityMailFromAttributes
PutSuppressedDestination
SendBulkEmail✔️pro✔️Show Tests
SendCustomVerificationEmail
SendEmail✔️pro✔️✔️Show Tests
TagResource
TestRenderEmailTemplate
UntagResource
UpdateConfigurationSetEventDestination
UpdateContact
UpdateContactList
UpdateCustomVerificationEmailTemplate
UpdateEmailIdentityPolicy
UpdateEmailTemplate

Terminology

  • Internal Test Suite: tested by LocalStack's internal integration test suite
  • External Test Suite: covered by an external integration test suite, that runs against LocalStack
  • Terraform Validated: operation tested with Terraform
  • AWS Validated: the integration test that includes this operation call was validated against AWS
  • Snapshot Tested: the operation is part of a snapshot parity test, which verifies the responses by LocalStack and AWS are the same

Testing Details

This section gives an overview about the internal integration test suite and the specific test cases that recorded the API call.

How to read the test details?

For each operation we put up a list of the related integration test cases.
Those operation calls have been recorded during the execution of the outlined test cases. Some calls might be internal, i.e., they are not explicitly called in the test, but are triggered implicitly by the LocalStack framework.

  • Parameters: The tests are ordered by the parameters used, which are highlighted in bold.
  • Test Details: LocalStack Community or LocalStack Pro indicates where the test originates. For each test you see:
    • test name
    • status code returned (which is the expected one for the test case)
    • information about validation:
      • AWS validated the test is validated against AWS, meaning it run successfully against real AWS as well
      • Snapshot Tested this is a snapshot parity test, meaning the responses are validated against AWS


CreateEmailIdentity

Parameters: EmailIdentity
  • LocalStack Pro
    • test_email_identities LocalStack Pro: tests/aws/services/sesv2/test_sesv2.py::TestSesv2::test_email_identities HTTP Status Code: 200
    • test_send_bulk_email LocalStack Pro: tests/aws/services/sesv2/test_sesv2.py::TestSesv2::test_send_bulk_email HTTP Status Code: 200

CreateEmailTemplate

Parameters: TemplateContent, TemplateName
  • LocalStack Pro
    • test_send_bulk_email LocalStack Pro: tests/aws/services/sesv2/test_sesv2.py::TestSesv2::test_send_bulk_email HTTP Status Code: 200
    • test_send_email_template LocalStack Pro: tests/aws/services/sesv2/test_sesv2.py::TestSesv2::test_send_email_template HTTP Status Code: 200

DeleteEmailIdentity

Parameters: EmailIdentity
  • LocalStack Pro
    • test_email_identities LocalStack Pro: tests/aws/services/sesv2/test_sesv2.py::TestSesv2::test_email_identities HTTP Status Code: 200

GetEmailIdentity

Parameters: EmailIdentity
  • LocalStack Pro
    • test_email_identities LocalStack Pro: tests/aws/services/sesv2/test_sesv2.py::TestSesv2::test_email_identities HTTP Status Code: 200
    • test_email_identities LocalStack Pro: tests/aws/services/sesv2/test_sesv2.py::TestSesv2::test_email_identities HTTP Status Code: 404 (NotFoundException)

ListEmailIdentities

Parameters: - (without any parameters)
  • LocalStack Pro
    • test_email_identities LocalStack Pro: tests/aws/services/sesv2/test_sesv2.py::TestSesv2::test_email_identities HTTP Status Code: 200

SendBulkEmail

Parameters: BulkEmailEntries, DefaultContent, FromEmailAddress
  • LocalStack Pro
    • test_send_bulk_email LocalStack Pro: tests/aws/services/sesv2/test_sesv2.py::TestSesv2::test_send_bulk_email HTTP Status Code: 200
    • test_send_bulk_email LocalStack Pro: tests/aws/services/sesv2/test_sesv2.py::TestSesv2::test_send_bulk_email HTTP Status Code: 400 (MessageRejected)
    • test_send_bulk_email LocalStack Pro: tests/aws/services/sesv2/test_sesv2.py::TestSesv2::test_send_bulk_email HTTP Status Code: 404 (NotFoundException)

SendEmail

Parameters: Content
  • LocalStack Pro
    • test_send_email_raw LocalStack Pro: tests/aws/services/sesv2/test_sesv2.py::TestSesv2::test_send_email_raw HTTP Status Code: 200
    • test_send_email LocalStack Pro: tests/aws/services/sesv2/test_sesv2.py::TestSesv2::test_send_email HTTP Status Code: 400 (BadRequestException) AWS validated
Parameters: Content, Destination, FromEmailAddress
  • LocalStack Pro
    • test_send_email_simple LocalStack Pro: tests/aws/services/sesv2/test_sesv2.py::TestSesv2::test_send_email_simple HTTP Status Code: 200
    • test_send_email_template LocalStack Pro: tests/aws/services/sesv2/test_sesv2.py::TestSesv2::test_send_email_template HTTP Status Code: 200

Last modified July 22, 2024: Update Parity Coverage Docs (#1393) (1200bd259)