AWS ses documentation change
Summary
Updated terminology from 'Amazon SES' to 'SES' throughout the document for consistency. Clarified bounce behavior wording and adjusted service name references in policy examples.
Security assessment
The changes are primarily branding/terminology updates (e.g., 'Amazon SES' → 'SES') and minor clarifications about bounce event handling. No security vulnerabilities or new security features are addressed. The KMS/S3 permission references maintain existing security practices without introducing new requirements or fixes.
Diff
diff --git a/ses/latest/dg/sending-email-list-management.md b/ses/latest/dg/sending-email-list-management.md index f38d15e24..404fbfa0f 100644 --- a//ses/latest/dg/sending-email-list-management.md +++ b//ses/latest/dg/sending-email-list-management.md @@ -31 +31 @@ You should consider the following factors when you use list management: - * You can import your existing contact lists to Amazon SES using the [`CreateImportJob`](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html) API. + * You can import your existing contact lists to SES using the [`CreateImportJob`](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html) API. @@ -33 +33 @@ You should consider the following factors when you use list management: - * Amazon SES will bounce an email if it is sent to an unsubscribed contact on your contact list. For more information, see [Using subscription management](./sending-email-subscription-management.html). + * SES will issue a bounce event for a message that is sent to an unsubscribed contact on your contact list. For more information, see [Using subscription management](./sending-email-subscription-management.html). @@ -46 +46 @@ You can use the following operations to configure list management capabilities. -You can use the [`CreateContactList`](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContactList.html) operation in the Amazon SES API v2 to create a contact list. You can quickly and easily configure this setting by using the AWS CLI. For more information about installing and configuring the AWS CLI, see the [AWS Command Line Interface User Guide](https://docs.aws.amazon.com/cli/latest/userguide/). +You can use the [`CreateContactList`](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContactList.html) operation in the SES API v2 to create a contact list. You can quickly and easily configure this setting by using the AWS CLI. For more information about installing and configuring the AWS CLI, see the [AWS Command Line Interface User Guide](https://docs.aws.amazon.com/cli/latest/userguide/). @@ -94 +94 @@ An example `CreateContactList` input JSON file for the request is as follows: -You can use the [`CreateContact`](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContact.html) operation in the Amazon SES API v2 to create a contact. You can quickly and easily configure this setting by using the AWS CLI. For more information about installing and configuring the AWS CLI, see the [AWS Command Line Interface User Guide](https://docs.aws.amazon.com/cli/latest/userguide/). +You can use the [`CreateContact`](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContact.html) operation in the SES API v2 to create a contact. You can quickly and easily configure this setting by using the AWS CLI. For more information about installing and configuring the AWS CLI, see the [AWS Command Line Interface User Guide](https://docs.aws.amazon.com/cli/latest/userguide/). @@ -130 +130 @@ The `AttributesData` is a JSON field where you can put any metadata about our co -You can manually add addresses in bulk by first uploading your contacts into an Amazon S3 object followed by using the [`CreateImportJob`](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html) operation in the Amazon SES API v2 or by using the SES console. For more information see [Adding email addresses in bulk to your account-level suppression list](./sending-email-suppression-list.html#sending-email-suppression-list-manual-add-bulk). +You can manually add addresses in bulk by first uploading your contacts into an Amazon S3 object followed by using the [`CreateImportJob`](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html) operation in the SES API v2 or by using the SES console. For more information see [Adding email addresses in bulk to your account-level suppression list](./sending-email-suppression-list.html#sending-email-suppression-list-manual-add-bulk). @@ -204 +204 @@ Attribute | Description - * Give Amazon SES permission to read the Amazon S3 object. + * Give SES permission to read the Amazon S3 object. @@ -206 +206 @@ Attribute | Description -When applied to an Amazon S3 bucket, the following policy gives Amazon SES permission to read that bucket. For more information about attaching policies to Amazon S3 buckets, see [Using Bucket Policies and User Policies](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-iam-policies.html) in the _Amazon Simple Storage Service User Guide_. +When applied to an Amazon S3 bucket, the following policy gives SES permission to read that bucket. For more information about attaching policies to Amazon S3 buckets, see [Using Bucket Policies and User Policies](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-iam-policies.html) in the _Amazon Simple Storage Service User Guide_. @@ -208 +208 @@ When applied to an Amazon S3 bucket, the following policy gives Amazon SES permi - * Give Amazon SES permission to use your AWS KMS key. + * Give SES permission to use your AWS KMS key. @@ -210 +210 @@ When applied to an Amazon S3 bucket, the following policy gives Amazon SES permi -If the Amazon S3 object is encrypted with an AWS KMS key, you need to give Amazon SES permission to use the KMS key. Amazon SES can only attain permission from a customer managed key, not a default KMS key. You must give Amazon SES permission to use the customer managed key by adding a statement to the key's policy. +If the Amazon S3 object is encrypted with an AWS KMS key, you need to give Amazon SES permission to use the KMS key. SES can only attain permission from a customer managed key, not a default KMS key. You must give SES permission to use the customer managed key by adding a statement to the key's policy. @@ -212 +212 @@ If the Amazon S3 object is encrypted with an AWS KMS key, you need to give Amazo -Paste the following policy statement into the key policy to permit Amazon SES to use your customer managed key. +Paste the following policy statement into the key policy to permit SES to use your customer managed key. @@ -226 +226 @@ Paste the following policy statement into the key policy to permit Amazon SES to - * Use the [`CreateImportJob`](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html) operation in the Amazon SES API v2. + * Use the [`CreateImportJob`](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html) operation in the SES API v2. @@ -283 +283 @@ If you include `ListManagementOptions` in your `SendEmail` request to a recipien -Amazon SES will bounce an email if it is sent to an unsubscribed contact on your contact list, which means you won’t need to update your `SendEmail` requests to avoid sending to contacts who have unsubscribed. +SES will issue a bounce event for a message that is sent to an unsubscribed contact on your contact list, which means you won’t need to update your `SendEmail` requests to avoid sending to contacts who have unsubscribed. @@ -285 +285 @@ Amazon SES will bounce an email if it is sent to an unsubscribed contact on your - 3. Indicate the location for your unsubscribe links – When utilizing [`ListManagementOptions`](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html) you have the option to enable Amazon SES to add unsubscribe footer links in your email using the `{{amazonSESUnsubscribeUrl}}` placeholder to specify where SES needs to insert the unsubscribe URL. Placeholder replacement is supported only for HTML and TEXT content types. You can include the placeholder two times maximum. If used more than two times, only the first two occurrences are replaced. For more information, see [Using subscription management](./sending-email-subscription-management.html). + 3. Indicate the location for your unsubscribe links – When utilizing [`ListManagementOptions`](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html) you have the option to enable SES to add unsubscribe footer links in your email using the `{{amazonSESUnsubscribeUrl}}` placeholder to specify where SES needs to insert the unsubscribe URL. Placeholder replacement is supported only for HTML and TEXT content types. You can include the placeholder two times maximum. If used more than two times, only the first two occurrences are replaced. For more information, see [Using subscription management](./sending-email-subscription-management.html).