aws-sdk-sesv2 1.105.0 → 1.106.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f546ee6cfb4fdc485ec83b729715ed51b26fc523053436c40371243495c405a
-  data.tar.gz: e3f944e5cb6068de7e24454d48fb4daae10f7c165a9efacc74d1cb75b41a0227
+  metadata.gz: 7f13ef709d7e1ec0a249d10c13cabe08307e4cf74313091763ac55d9517a0594
+  data.tar.gz: 790f51d2cc3acea699575829656e6eca9131afeaaf1d93b78148e71d5bb870fe
 SHA512:
-  metadata.gz: ab9c7991693db390623ffc646ab32f90755be8bf0e669699a3fe571588eacdebbcdb7e7f8ae5135f7f0663d27201cfc7d9cb0784f6e80b1bcdbabf328b304b20
-  data.tar.gz: fd6c921e0245e712e7af0dcd5436fce4a486a79b11a574c664ee0cdb48fdee6106d1f289a55f8c7bd08120b75bf4c38fccd18045e5d399646e29d1f588807f08
+  metadata.gz: f005e2f143b6cd1a04a4adb013345fd1d1cc225226f3e9baf8857722a305ceefc2fb83d439a317fc81767b76ac87ade4d6f4ea613b8da4978f332a399bde13cb
+  data.tar.gz: 9967ca4751d276e9936906d7b4f77e6f2133c8847b158f58d7ede42f9fcae7e1a171b0adfd6e3ad8c39584e140036ee2ce6ba7c7650a852ff2243d0c684d8656

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.106.0 (2026-08-20)
+------------------
+
+* Feature - Amazon SES now supports per-message tracking overrides. You can use the new ConfigurationOverrides parameter in SendEmail and SendBulkEmail to enable or disable open and click tracking for individual messages without changing your account-level or configuration set settings.
+
 1.105.0 (2026-07-22)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.105.0
+1.106.0

data/lib/aws-sdk-sesv2/client.rb

@@ -4534,25 +4534,24 @@ module Aws::SESV2
       req.send_request(options)
     end
 
-    # Set the pricing plan for your Amazon SES account. Use this operation
-    # to choose a billing plan that packages multiple Amazon SES features at
-    # a single rate.
+    # Set the pricing plan for your Amazon SES account.
     #
     # @option params [required, String] :plan
-    #   The pricing plan to apply to your Amazon SES account. Can be one of
-    #   the following:
+    #   The pricing plan to apply to your Amazon SES account. For details
+    #   about each plan, see [Amazon SES Pricing][1]. Can be one of the
+    #   following:
     #
-    #   * `NONE` – No pricing plan is applied; billing follows per-feature
-    #     pricing.
+    #   * `NONE`
     #
-    #   * `ESSENTIALS` – Baseline Amazon SES capabilities and select premium
-    #     features.
+    #   * `ESSENTIALS`
     #
-    #   * `PRO` – Includes everything in `ESSENTIALS`, plus additional premium
-    #     features for growing senders.
+    #   * `PRO`
     #
-    #   * `ENTERPRISE` – Includes everything in `PRO`, plus features intended
-    #     for large-scale senders.
+    #   * `ENTERPRISE`
+    #
+    #
+    #
+    #   [1]: http://aws.amazon.com/ses/pricing/
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -5524,6 +5523,12 @@ module Aws::SESV2
     #
     #    </note>
     #
+    # @option params [Types::ConfigurationOverrides] :configuration_overrides
+    #   An object that overrides, for the messages in this request only,
+    #   settings that would otherwise apply to them. The overrides apply to
+    #   every message in the request. Each setting that you don't override
+    #   keeps the value that already applies.
+    #
     # @return [Types::SendBulkEmailResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::SendBulkEmailResponse#bulk_email_entry_results #bulk_email_entry_results} => Array&lt;Types::BulkEmailEntryResult&gt;
@@ -5600,6 +5605,12 @@ module Aws::SESV2
     #     configuration_set_name: "ConfigurationSetName",
     #     endpoint_id: "EndpointId",
     #     tenant_name: "TenantName",
+    #     configuration_overrides: {
+    #       tracking: {
+    #         open_tracking_enabled: "ENABLED", # accepts ENABLED, DISABLED
+    #         click_tracking_enabled: "ENABLED", # accepts ENABLED, DISABLED
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -5775,6 +5786,11 @@ module Aws::SESV2
     #   An object used to specify a list or topic to which an email belongs,
     #   which will be used when a contact chooses to unsubscribe.
     #
+    # @option params [Types::ConfigurationOverrides] :configuration_overrides
+    #   An object that overrides, for this message only, settings that would
+    #   otherwise apply to it. Each setting that you don't override keeps the
+    #   value that already applies.
+    #
     # @return [Types::SendEmailResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::SendEmailResponse#message_id #message_id} => String
@@ -5870,6 +5886,12 @@ module Aws::SESV2
     #       contact_list_name: "ContactListName", # required
     #       topic_name: "TopicName",
     #     },
+    #     configuration_overrides: {
+    #       tracking: {
+    #         open_tracking_enabled: "ENABLED", # accepts ENABLED, DISABLED
+    #         click_tracking_enabled: "ENABLED", # accepts ENABLED, DISABLED
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -6424,7 +6446,7 @@ module Aws::SESV2
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-sesv2'
-      context[:gem_version] = '1.105.0'
+      context[:gem_version] = '1.106.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-sesv2/client_api.rb

@@ -66,6 +66,7 @@ module Aws::SESV2
     ComplaintFeedbackType = Shapes::StringShape.new(name: 'ComplaintFeedbackType')
     ComplaintSubType = Shapes::StringShape.new(name: 'ComplaintSubType')
     ConcurrentModificationException = Shapes::StructureShape.new(name: 'ConcurrentModificationException')
+    ConfigurationOverrides = Shapes::StructureShape.new(name: 'ConfigurationOverrides')
     ConfigurationSetName = Shapes::StringShape.new(name: 'ConfigurationSetName')
     ConfigurationSetNameList = Shapes::ListShape.new(name: 'ConfigurationSetNameList')
     ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
@@ -572,6 +573,7 @@ module Aws::SESV2
     TopicPreference = Shapes::StructureShape.new(name: 'TopicPreference')
     TopicPreferenceList = Shapes::ListShape.new(name: 'TopicPreferenceList')
     Topics = Shapes::ListShape.new(name: 'Topics')
+    TrackingConfigurationOverrides = Shapes::StructureShape.new(name: 'TrackingConfigurationOverrides')
     TrackingOptions = Shapes::StructureShape.new(name: 'TrackingOptions')
     UnsubscribeAll = Shapes::BooleanShape.new(name: 'UnsubscribeAll')
     UntagResourceRequest = Shapes::StructureShape.new(name: 'UntagResourceRequest')
@@ -711,6 +713,9 @@ module Aws::SESV2
 
     ConcurrentModificationException.struct_class = Types::ConcurrentModificationException
 
+    ConfigurationOverrides.add_member(:tracking, Shapes::ShapeRef.new(shape: TrackingConfigurationOverrides, location_name: "Tracking"))
+    ConfigurationOverrides.struct_class = Types::ConfigurationOverrides
+
     ConfigurationSetNameList.member = Shapes::ShapeRef.new(shape: ConfigurationSetName)
 
     ConflictException.struct_class = Types::ConflictException
@@ -1986,6 +1991,7 @@ module Aws::SESV2
     SendBulkEmailRequest.add_member(:configuration_set_name, Shapes::ShapeRef.new(shape: ConfigurationSetName, location_name: "ConfigurationSetName"))
     SendBulkEmailRequest.add_member(:endpoint_id, Shapes::ShapeRef.new(shape: EndpointId, location_name: "EndpointId", metadata: {"contextParam" => {"name" => "EndpointId"}}))
     SendBulkEmailRequest.add_member(:tenant_name, Shapes::ShapeRef.new(shape: TenantName, location_name: "TenantName"))
+    SendBulkEmailRequest.add_member(:configuration_overrides, Shapes::ShapeRef.new(shape: ConfigurationOverrides, location_name: "ConfigurationOverrides"))
     SendBulkEmailRequest.struct_class = Types::SendBulkEmailRequest
 
     SendBulkEmailResponse.add_member(:bulk_email_entry_results, Shapes::ShapeRef.new(shape: BulkEmailEntryResultList, required: true, location_name: "BulkEmailEntryResults"))
@@ -2011,6 +2017,7 @@ module Aws::SESV2
     SendEmailRequest.add_member(:endpoint_id, Shapes::ShapeRef.new(shape: EndpointId, location_name: "EndpointId", metadata: {"contextParam" => {"name" => "EndpointId"}}))
     SendEmailRequest.add_member(:tenant_name, Shapes::ShapeRef.new(shape: TenantName, location_name: "TenantName"))
     SendEmailRequest.add_member(:list_management_options, Shapes::ShapeRef.new(shape: ListManagementOptions, location_name: "ListManagementOptions"))
+    SendEmailRequest.add_member(:configuration_overrides, Shapes::ShapeRef.new(shape: ConfigurationOverrides, location_name: "ConfigurationOverrides"))
     SendEmailRequest.struct_class = Types::SendEmailRequest
 
     SendEmailResponse.add_member(:message_id, Shapes::ShapeRef.new(shape: OutboundMessageId, location_name: "MessageId"))
@@ -2157,6 +2164,10 @@ module Aws::SESV2
 
     Topics.member = Shapes::ShapeRef.new(shape: Topic)
 
+    TrackingConfigurationOverrides.add_member(:open_tracking_enabled, Shapes::ShapeRef.new(shape: FeatureStatus, location_name: "OpenTrackingEnabled"))
+    TrackingConfigurationOverrides.add_member(:click_tracking_enabled, Shapes::ShapeRef.new(shape: FeatureStatus, location_name: "ClickTrackingEnabled"))
+    TrackingConfigurationOverrides.struct_class = Types::TrackingConfigurationOverrides
+
     TrackingOptions.add_member(:custom_redirect_domain, Shapes::ShapeRef.new(shape: CustomRedirectDomain, required: true, location_name: "CustomRedirectDomain"))
     TrackingOptions.add_member(:https_policy, Shapes::ShapeRef.new(shape: HttpsPolicy, location_name: "HttpsPolicy"))
     TrackingOptions.struct_class = Types::TrackingOptions

data/lib/aws-sdk-sesv2/types.rb

@@ -623,6 +623,29 @@ module Aws::SESV2
     #
     class ConcurrentModificationException < Aws::EmptyStructure; end
 
+    # An object that overrides settings for a single email sending request.
+    # An override applies only to the message or messages in the request
+    # that contains it. It doesn't change your account-level settings, and
+    # it doesn't change the configuration set that the request uses.
+    #
+    # A setting that you don't override keeps the value that would
+    # otherwise apply to the message. Depending on the setting, that value
+    # comes from the configuration set that the message uses, from your
+    # account-level settings, or from the Amazon SES default.
+    #
+    # @!attribute [rw] tracking
+    #   An object that overrides the open and click tracking settings that
+    #   would otherwise apply to the message.
+    #   @return [Types::TrackingConfigurationOverrides]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sesv2-2019-09-27/ConfigurationOverrides AWS API Documentation
+    #
+    class ConfigurationOverrides < Struct.new(
+      :tracking)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # If there is already an ongoing account details update under review.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sesv2-2019-09-27/ConflictException AWS API Documentation
@@ -6586,8 +6609,7 @@ module Aws::SESV2
     end
 
     # The pricing attributes that apply to your Amazon SES account,
-    # including the currently active pricing plan and any scheduled change
-    # for the next billing cycle.
+    # including the currently active pricing plan and any scheduled change.
     #
     # @!attribute [rw] current_plan
     #   The pricing plan that is currently active on your Amazon SES
@@ -6596,7 +6618,7 @@ module Aws::SESV2
     #
     # @!attribute [rw] next_plan
     #   The pricing plan that will become active at the start of the next
-    #   billing cycle, if a scheduled change has been requested. This field
+    #   monthly cycle, if a scheduled change has been requested. This field
     #   is empty when no scheduled change is pending.
     #   @return [String]
     #
@@ -6695,20 +6717,21 @@ module Aws::SESV2
     # A request to set the pricing plan for your Amazon SES account.
     #
     # @!attribute [rw] plan
-    #   The pricing plan to apply to your Amazon SES account. Can be one of
-    #   the following:
+    #   The pricing plan to apply to your Amazon SES account. For details
+    #   about each plan, see [Amazon SES Pricing][1]. Can be one of the
+    #   following:
+    #
+    #   * `NONE`
     #
-    #   * `NONE` – No pricing plan is applied; billing follows per-feature
-    #     pricing.
+    #   * `ESSENTIALS`
     #
-    #   * `ESSENTIALS` – Baseline Amazon SES capabilities and select premium
-    #     features.
+    #   * `PRO`
     #
-    #   * `PRO` – Includes everything in `ESSENTIALS`, plus additional
-    #     premium features for growing senders.
+    #   * `ENTERPRISE`
     #
-    #   * `ENTERPRISE` – Includes everything in `PRO`, plus features
-    #     intended for large-scale senders.
+    #
+    #
+    #   [1]: http://aws.amazon.com/ses/pricing/
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sesv2-2019-09-27/PutAccountPricingAttributesRequest AWS API Documentation
@@ -7985,6 +8008,13 @@ module Aws::SESV2
     #    </note>
     #   @return [String]
     #
+    # @!attribute [rw] configuration_overrides
+    #   An object that overrides, for the messages in this request only,
+    #   settings that would otherwise apply to them. The overrides apply to
+    #   every message in the request. Each setting that you don't override
+    #   keeps the value that already applies.
+    #   @return [Types::ConfigurationOverrides]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sesv2-2019-09-27/SendBulkEmailRequest AWS API Documentation
     #
     class SendBulkEmailRequest < Struct.new(
@@ -7998,7 +8028,8 @@ module Aws::SESV2
       :bulk_email_entries,
       :configuration_set_name,
       :endpoint_id,
-      :tenant_name)
+      :tenant_name,
+      :configuration_overrides)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -8167,6 +8198,12 @@ module Aws::SESV2
     #   which will be used when a contact chooses to unsubscribe.
     #   @return [Types::ListManagementOptions]
     #
+    # @!attribute [rw] configuration_overrides
+    #   An object that overrides, for this message only, settings that would
+    #   otherwise apply to it. Each setting that you don't override keeps
+    #   the value that already applies.
+    #   @return [Types::ConfigurationOverrides]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sesv2-2019-09-27/SendEmailRequest AWS API Documentation
     #
     class SendEmailRequest < Struct.new(
@@ -8181,7 +8218,8 @@ module Aws::SESV2
       :configuration_set_name,
       :endpoint_id,
       :tenant_name,
-      :list_management_options)
+      :list_management_options,
+      :configuration_overrides)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -8968,6 +9006,80 @@ module Aws::SESV2
       include Aws::Structure
     end
 
+    # An object that overrides, for a single email sending request, the
+    # engagement tracking settings that would otherwise apply. Use these
+    # overrides to turn open tracking or click tracking on or off for an
+    # individual message, for example to suppress tracking in a
+    # transactional message that you send from an account or a configuration
+    # set that has tracking enabled.
+    #
+    # Without an override, engagement tracking is determined by your
+    # account-level `EngagementMetrics` setting, which you configure using
+    # the `PutAccountVdmAttributes` operation, by the `EngagementMetrics`
+    # setting of the configuration set that the message uses, which you
+    # configure using the `PutConfigurationSetVdmOptions` operation, and by
+    # whether that configuration set has an event destination whose
+    # `MatchingEventTypes` include the `OPEN` or `CLICK` event types.
+    #
+    # For more information about tracking open and click events, see the
+    # [Amazon SES Developer Guide][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/ses/latest/DeveloperGuide/event-publishing.html
+    #
+    # @!attribute [rw] open_tracking_enabled
+    #   Specifies whether Amazon SES tracks when the recipient opens this
+    #   message. Can be one of the following:
+    #
+    #   * `ENABLED` – Amazon SES tracks opens for this message, even when
+    #     your account-level and configuration set settings don't enable
+    #     open tracking.
+    #
+    #   * `DISABLED` – Amazon SES doesn't track opens for this message,
+    #     even when your account-level or configuration set settings enable
+    #     open tracking. Amazon SES doesn't add the tracking image to the
+    #     message.
+    #
+    #   If you don't specify this value, Amazon SES uses the open tracking
+    #   setting that would otherwise apply to the message.
+    #   @return [String]
+    #
+    # @!attribute [rw] click_tracking_enabled
+    #   Specifies whether Amazon SES tracks when the recipient clicks a link
+    #   in this message. Can be one of the following:
+    #
+    #   * `ENABLED` – Amazon SES tracks clicks for this message, even when
+    #     your account-level and configuration set settings don't enable
+    #     click tracking.
+    #
+    #   * `DISABLED` – Amazon SES doesn't track clicks for this message,
+    #     even when your account-level or configuration set settings enable
+    #     click tracking. Amazon SES doesn't rewrite the links in the
+    #     message.
+    #
+    #   If you don't specify this value, Amazon SES uses the click tracking
+    #   setting that would otherwise apply to the message.
+    #
+    #   <note markdown="1"> Enabling open or click tracking with an override doesn't create an
+    #   event destination. Amazon SES records the resulting open and click
+    #   events in VDM, where you can review them using VDM metrics and
+    #   Message Insights. To also receive these events at a destination that
+    #   you own, the configuration set that the message uses must have an
+    #   event destination that publishes open and click events.
+    #
+    #    </note>
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sesv2-2019-09-27/TrackingConfigurationOverrides AWS API Documentation
+    #
+    class TrackingConfigurationOverrides < Struct.new(
+      :open_tracking_enabled,
+      :click_tracking_enabled)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # 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.

data/lib/aws-sdk-sesv2.rb

@@ -54,7 +54,7 @@ module Aws::SESV2
   autoload :EndpointProvider, 'aws-sdk-sesv2/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-sesv2/endpoints'
 
-  GEM_VERSION = '1.105.0'
+  GEM_VERSION = '1.106.0'
 
 end
 

data/sig/client.rbs

@@ -1463,7 +1463,13 @@ module Aws
                              ],
                              ?configuration_set_name: ::String,
                              ?endpoint_id: ::String,
-                             ?tenant_name: ::String
+                             ?tenant_name: ::String,
+                             ?configuration_overrides: {
+                               tracking: {
+                                 open_tracking_enabled: ("ENABLED" | "DISABLED")?,
+                                 click_tracking_enabled: ("ENABLED" | "DISABLED")?
+                               }?
+                             }
                            ) -> _SendBulkEmailResponseSuccess
                          | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _SendBulkEmailResponseSuccess
 
@@ -1508,6 +1514,12 @@ module Aws
                         ?list_management_options: {
                           contact_list_name: ::String,
                           topic_name: ::String?
+                        },
+                        ?configuration_overrides: {
+                          tracking: {
+                            open_tracking_enabled: ("ENABLED" | "DISABLED")?,
+                            click_tracking_enabled: ("ENABLED" | "DISABLED")?
+                          }?
                         }
                       ) -> _SendEmailResponseSuccess
                     | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _SendEmailResponseSuccess

data/sig/types.rbs

@@ -133,6 +133,11 @@ module Aws::SESV2
     class ConcurrentModificationException < Aws::EmptyStructure
     end
 
+    class ConfigurationOverrides
+      attr_accessor tracking: Types::TrackingConfigurationOverrides
+      SENSITIVE: []
+    end
+
     class ConflictException < Aws::EmptyStructure
     end
 
@@ -1794,6 +1799,7 @@ module Aws::SESV2
       attr_accessor configuration_set_name: ::String
       attr_accessor endpoint_id: ::String
       attr_accessor tenant_name: ::String
+      attr_accessor configuration_overrides: Types::ConfigurationOverrides
       SENSITIVE: []
     end
 
@@ -1827,6 +1833,7 @@ module Aws::SESV2
       attr_accessor endpoint_id: ::String
       attr_accessor tenant_name: ::String
       attr_accessor list_management_options: Types::ListManagementOptions
+      attr_accessor configuration_overrides: Types::ConfigurationOverrides
       SENSITIVE: []
     end
 
@@ -2013,6 +2020,12 @@ module Aws::SESV2
       SENSITIVE: []
     end
 
+    class TrackingConfigurationOverrides
+      attr_accessor open_tracking_enabled: ("ENABLED" | "DISABLED")
+      attr_accessor click_tracking_enabled: ("ENABLED" | "DISABLED")
+      SENSITIVE: []
+    end
+
     class TrackingOptions
       attr_accessor custom_redirect_domain: ::String
       attr_accessor https_policy: ("REQUIRE" | "REQUIRE_OPEN_ONLY" | "OPTIONAL")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-sesv2
 version: !ruby/object:Gem::Version
-  version: 1.105.0
+  version: 1.106.0
 platform: ruby
 authors:
 - Amazon Web Services