AWS ses documentation change
Summary
Added new code examples and links for CreateEmailIdentity API, including email attachments scenario implementation
Security assessment
The changes add implementation examples and scenario links without addressing security vulnerabilities or introducing security features. The added error handling for LimitExceededException is routine resource management, not security-related. No security advisories or vulnerability mitigations are present.
Diff
diff --git a/ses/latest/dg/sesv2_example_sesv2_CreateEmailIdentity_section.md b/ses/latest/dg/sesv2_example_sesv2_CreateEmailIdentity_section.md index b9507c1cf..ea846974a 100644 --- a//ses/latest/dg/sesv2_example_sesv2_CreateEmailIdentity_section.md +++ b//ses/latest/dg/sesv2_example_sesv2_CreateEmailIdentity_section.md @@ -11 +11,3 @@ The following code examples show how to use `CreateEmailIdentity`. -Action examples are code excerpts from larger programs and must be run in context. You can see this action in context in the following code example: +Action examples are code excerpts from larger programs and must be run in context. You can see this action in context in the following code examples: + + * [Email Attachments Scenario](./sesv2_example_sesv2_Scenario_EmailAttachments_section.html) @@ -136 +138,72 @@ Python -There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/sesv2#code-examples). +There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/sesv2/attachments_scenario#code-examples). + + + class SESv2Wrapper: + """Encapsulates Amazon SESv2 email sending actions.""" + + def __init__(self, sesv2_client: Any) -> None: + """ + Initializes the SESv2Wrapper with an SESv2 client. + + :param sesv2_client: A Boto3 SESv2 client. + """ + self.sesv2_client = sesv2_client + + @classmethod + def from_client(cls) -> "SESv2Wrapper": + """ + Creates an SESv2Wrapper instance with a default Boto3 SESv2 client. + + :return: A new SESv2Wrapper instance. + """ + sesv2_client = boto3.client("sesv2") + return cls(sesv2_client) + + + def create_email_identity(self, email_address: str) -> Dict[str, Any]: + """ + Starts the process of verifying an email identity (email address or domain). + + :param email_address: The email address or domain to verify. + :return: A dictionary with the identity type and verification status. + :raises ClientError: If the limit is exceeded (LimitExceededException). + """ + try: + response = self.sesv2_client.create_email_identity( + EmailIdentity=email_address + ) + logger.info( + "Started verification for email identity %s.", email_address + ) + return response + except ClientError as err: + if err.response["Error"]["Code"] == "LimitExceededException": + logger.error( + "Couldn't create email identity %s. You have exceeded " + "the maximum number of email identities. " + "Use an existing verified identity.", + email_address, + ) + else: + logger.error( + "Couldn't create email identity %s. Here's why: %s: %s", + email_address, + err.response["Error"]["Code"], + err.response["Error"]["Message"], + ) + raise + + + + + * For API details, see [CreateEmailIdentity](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateEmailIdentity) in _AWS SDK for Python (Boto3) API Reference_. + + + + +**SDK for Python (Boto3)** + + +###### Note + +There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/sesv2/newsletter_scenario#code-examples).