aws-sdk-ses 1.68.0 → 1.70.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 73cb7b7a6dcdec37ab4846f64e4916d4f37e877b03b1ba99b81d14e0903384e8
-  data.tar.gz: c13392722f7f3e59bf064431dcadcb87e611a9138c62e7c602545ce83c0f9b83
+  metadata.gz: d7064e9a7fa9dc47750f5f858af07f77a2a0749079ab9b69822412ca871cbe84
+  data.tar.gz: bb60cc6e61f038f0ad927efcce960f4b788e41daeee4af6e01accc1fb9c0d97e
 SHA512:
-  metadata.gz: 96e8f866de133ab939db4b69d111b4487631ea67dca7f051c43e0b556dce035a73be5da71c7fb3427f6e880ca9b955bee7d6ffac4b11b67117321334ffe0c44e
-  data.tar.gz: a66ceea91aaab8745ec49f1d6e04e348ebf7da64ebe3b6ef9b3928a94cfb459b5b3be5bbce8e6aefa55698a50214f26ec5558dc46ab3f8fb3424941111498909
+  metadata.gz: a7e59a605dc21956f3730ca160ee1340afe86ea803d8d63602861b3015fd3772e134cb592bae0f4cedf467abcce08b233ec9282f0d7bc6f6f6e07954dd5f6224
+  data.tar.gz: 72029f224d9c1502c3a1135f9f340a6f6dd9547430908cb74c4a4247478fa9b1461d450ea32a2fdd4df0f96f18c3b6344e27cbd91b8f18daeb03d92404dd6567

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.70.0 (2024-09-03)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.69.0 (2024-08-21)
+------------------
+
+* Feature - Enable email receiving customers to provide SES with access to their S3 buckets via an IAM role for "Deliver to S3 Action"
+
 1.68.0 (2024-07-08)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.68.0
+1.70.0

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

@@ -32,6 +32,7 @@ require 'aws-sdk-core/plugins/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/request_compression.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
+require 'aws-sdk-core/plugins/telemetry.rb'
 require 'aws-sdk-core/plugins/sign.rb'
 require 'aws-sdk-core/plugins/protocols/query.rb'
 
@@ -83,6 +84,7 @@ module Aws::SES
     add_plugin(Aws::Plugins::RequestCompression)
     add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::RecursionDetection)
+    add_plugin(Aws::Plugins::Telemetry)
     add_plugin(Aws::Plugins::Sign)
     add_plugin(Aws::Plugins::Protocols::Query)
     add_plugin(Aws::SES::Plugins::Endpoints)
@@ -330,6 +332,16 @@ module Aws::SES
     #     ** Please note ** When response stubbing is enabled, no HTTP
     #     requests are made, and retries are disabled.
     #
+    #   @option options [Aws::Telemetry::TelemetryProviderBase] :telemetry_provider (Aws::Telemetry::NoOpTelemetryProvider)
+    #     Allows you to provide a telemetry provider, which is used to
+    #     emit telemetry data. By default, uses `NoOpTelemetryProvider` which
+    #     will not record or emit any telemetry data. The SDK supports the
+    #     following telemetry providers:
+    #
+    #     * OpenTelemetry (OTel) - To use the OTel provider, install and require the
+    #     `opentelemetry-sdk` gem and then, pass in an instance of a
+    #     `Aws::Telemetry::OTelProvider` for telemetry provider.
+    #
     #   @option options [Aws::TokenProvider] :token_provider
     #     A Bearer Token Provider. This can be an instance of any one of the
     #     following classes:
@@ -808,6 +820,7 @@ module Aws::SES
     #             bucket_name: "S3BucketName", # required
     #             object_key_prefix: "S3KeyPrefix",
     #             kms_key_arn: "AmazonResourceName",
+    #             iam_role_arn: "IAMRoleARN",
     #           },
     #           bounce_action: {
     #             topic_arn: "AmazonResourceName",
@@ -1418,6 +1431,7 @@ module Aws::SES
     #   resp.rules[0].actions[0].s3_action.bucket_name #=> String
     #   resp.rules[0].actions[0].s3_action.object_key_prefix #=> String
     #   resp.rules[0].actions[0].s3_action.kms_key_arn #=> String
+    #   resp.rules[0].actions[0].s3_action.iam_role_arn #=> String
     #   resp.rules[0].actions[0].bounce_action.topic_arn #=> String
     #   resp.rules[0].actions[0].bounce_action.smtp_reply_code #=> String
     #   resp.rules[0].actions[0].bounce_action.status_code #=> String
@@ -1574,6 +1588,7 @@ module Aws::SES
     #   resp.rule.actions[0].s3_action.bucket_name #=> String
     #   resp.rule.actions[0].s3_action.object_key_prefix #=> String
     #   resp.rule.actions[0].s3_action.kms_key_arn #=> String
+    #   resp.rule.actions[0].s3_action.iam_role_arn #=> String
     #   resp.rule.actions[0].bounce_action.topic_arn #=> String
     #   resp.rule.actions[0].bounce_action.smtp_reply_code #=> String
     #   resp.rule.actions[0].bounce_action.status_code #=> String
@@ -1674,6 +1689,7 @@ module Aws::SES
     #   resp.rules[0].actions[0].s3_action.bucket_name #=> String
     #   resp.rules[0].actions[0].s3_action.object_key_prefix #=> String
     #   resp.rules[0].actions[0].s3_action.kms_key_arn #=> String
+    #   resp.rules[0].actions[0].s3_action.iam_role_arn #=> String
     #   resp.rules[0].actions[0].bounce_action.topic_arn #=> String
     #   resp.rules[0].actions[0].bounce_action.smtp_reply_code #=> String
     #   resp.rules[0].actions[0].bounce_action.status_code #=> String
@@ -3159,7 +3175,7 @@ module Aws::SES
     # @option params [String] :template_arn
     #   The ARN of the template to use when sending this email.
     #
-    # @option params [String] :default_template_data
+    # @option params [required, String] :default_template_data
     #   A list of replacement values to apply to the template when replacement
     #   data is not specified in a Destination object. These values act as a
     #   default or fallback option when no other data is available.
@@ -3194,7 +3210,7 @@ module Aws::SES
     #     ],
     #     template: "TemplateName", # required
     #     template_arn: "AmazonResourceName",
-    #     default_template_data: "TemplateData",
+    #     default_template_data: "TemplateData", # required
     #     destinations: [ # required
     #       {
     #         destination: { # required
@@ -4855,6 +4871,7 @@ module Aws::SES
     #             bucket_name: "S3BucketName", # required
     #             object_key_prefix: "S3KeyPrefix",
     #             kms_key_arn: "AmazonResourceName",
+    #             iam_role_arn: "IAMRoleARN",
     #           },
     #           bounce_action: {
     #             topic_arn: "AmazonResourceName",
@@ -5144,14 +5161,19 @@ module Aws::SES
     # @api private
     def build_request(operation_name, params = {})
       handlers = @handlers.for(operation_name)
+      tracer = config.telemetry_provider.tracer_provider.tracer(
+        Aws::Telemetry.module_to_tracer_name('Aws::SES')
+      )
       context = Seahorse::Client::RequestContext.new(
         operation_name: operation_name,
         operation: config.api.operation(operation_name),
         client: self,
         params: params,
-        config: config)
+        config: config,
+        tracer: tracer
+      )
       context[:gem_name] = 'aws-sdk-ses'
-      context[:gem_version] = '1.68.0'
+      context[:gem_version] = '1.70.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -149,6 +149,7 @@ module Aws::SES
     HeaderName = Shapes::StringShape.new(name: 'HeaderName')
     HeaderValue = Shapes::StringShape.new(name: 'HeaderValue')
     HtmlPart = Shapes::StringShape.new(name: 'HtmlPart')
+    IAMRoleARN = Shapes::StringShape.new(name: 'IAMRoleARN')
     Identity = Shapes::StringShape.new(name: 'Identity')
     IdentityDkimAttributes = Shapes::StructureShape.new(name: 'IdentityDkimAttributes')
     IdentityList = Shapes::ListShape.new(name: 'IdentityList')
@@ -905,6 +906,7 @@ module Aws::SES
     S3Action.add_member(:bucket_name, Shapes::ShapeRef.new(shape: S3BucketName, required: true, location_name: "BucketName"))
     S3Action.add_member(:object_key_prefix, Shapes::ShapeRef.new(shape: S3KeyPrefix, location_name: "ObjectKeyPrefix"))
     S3Action.add_member(:kms_key_arn, Shapes::ShapeRef.new(shape: AmazonResourceName, location_name: "KmsKeyArn"))
+    S3Action.add_member(:iam_role_arn, Shapes::ShapeRef.new(shape: IAMRoleARN, location_name: "IamRoleArn"))
     S3Action.struct_class = Types::S3Action
 
     SNSAction.add_member(:topic_arn, Shapes::ShapeRef.new(shape: AmazonResourceName, required: true, location_name: "TopicArn"))
@@ -934,7 +936,7 @@ module Aws::SES
     SendBulkTemplatedEmailRequest.add_member(:default_tags, Shapes::ShapeRef.new(shape: MessageTagList, location_name: "DefaultTags"))
     SendBulkTemplatedEmailRequest.add_member(:template, Shapes::ShapeRef.new(shape: TemplateName, required: true, location_name: "Template"))
     SendBulkTemplatedEmailRequest.add_member(:template_arn, Shapes::ShapeRef.new(shape: AmazonResourceName, location_name: "TemplateArn"))
-    SendBulkTemplatedEmailRequest.add_member(:default_template_data, Shapes::ShapeRef.new(shape: TemplateData, location_name: "DefaultTemplateData"))
+    SendBulkTemplatedEmailRequest.add_member(:default_template_data, Shapes::ShapeRef.new(shape: TemplateData, required: true, location_name: "DefaultTemplateData"))
     SendBulkTemplatedEmailRequest.add_member(:destinations, Shapes::ShapeRef.new(shape: BulkEmailDestinationList, required: true, location_name: "Destinations"))
     SendBulkTemplatedEmailRequest.struct_class = Types::SendBulkTemplatedEmailRequest
 

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

@@ -3525,28 +3525,28 @@ module Aws::SES
     #   @return [String]
     #
     # @!attribute [rw] kms_key_arn
-    #   The customer master key that Amazon SES should use to encrypt your
+    #   The customer managed key that Amazon SES should use to encrypt your
     #   emails before saving them to the Amazon S3 bucket. You can use the
-    #   default master key or a custom master key that you created in Amazon
-    #   Web Services KMS as follows:
+    #   default managed key or a custom managed key that you created in
+    #   Amazon Web Services KMS as follows:
     #
-    #   * To use the default master key, provide an ARN in the form of
+    #   * To use the default managed key, provide an ARN in the form of
     #     `arn:aws:kms:REGION:ACCOUNT-ID-WITHOUT-HYPHENS:alias/aws/ses`. For
     #     example, if your Amazon Web Services account ID is 123456789012
-    #     and you want to use the default master key in the US West (Oregon)
-    #     Region, the ARN of the default master key would be
+    #     and you want to use the default managed key in the US West
+    #     (Oregon) Region, the ARN of the default master key would be
     #     `arn:aws:kms:us-west-2:123456789012:alias/aws/ses`. If you use the
-    #     default master key, you don't need to perform any extra steps to
+    #     default managed key, you don't need to perform any extra steps to
     #     give Amazon SES permission to use the key.
     #
-    #   * To use a custom master key that you created in Amazon Web Services
-    #     KMS, provide the ARN of the master key and ensure that you add a
-    #     statement to your key's policy to give Amazon SES permission to
-    #     use it. For more information about giving permissions, see the
-    #     [Amazon SES Developer Guide][1].
+    #   * To use a custom managed key that you created in Amazon Web
+    #     Services KMS, provide the ARN of the managed key and ensure that
+    #     you add a statement to your key's policy to give Amazon SES
+    #     permission to use it. For more information about giving
+    #     permissions, see the [Amazon SES Developer Guide][1].
     #
     #   For more information about key policies, see the [Amazon Web
-    #   Services KMS Developer Guide][2]. If you do not specify a master
+    #   Services KMS Developer Guide][2]. If you do not specify a managed
     #   key, Amazon SES does not encrypt your emails.
     #
     #   Your mail is encrypted by Amazon SES using the Amazon S3 encryption
@@ -3558,7 +3558,7 @@ module Aws::SES
     #   encryption client is currently available with the [Amazon Web
     #   Services SDK for Java][3] and [Amazon Web Services SDK for Ruby][4]
     #   only. For more information about client-side encryption using Amazon
-    #   Web Services KMS master keys, see the [Amazon S3 Developer
+    #   Web Services KMS managed keys, see the [Amazon S3 Developer
     #   Guide][5].
     #
     #
@@ -3570,13 +3570,37 @@ module Aws::SES
     #   [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingClientSideEncryption.html
     #   @return [String]
     #
+    # @!attribute [rw] iam_role_arn
+    #   The ARN of the IAM role to be used by Amazon Simple Email Service
+    #   while writing to the Amazon S3 bucket, optionally encrypting your
+    #   mail via the provided customer managed key, and publishing to the
+    #   Amazon SNS topic. This role should have access to the following
+    #   APIs:
+    #
+    #   * `s3:PutObject`, `kms:Encrypt` and `kms:GenerateDataKey` for the
+    #     given Amazon S3 bucket.
+    #
+    #   * `kms:GenerateDataKey` for the given Amazon Web Services KMS
+    #     customer managed key.
+    #
+    #   * `sns:Publish` for the given Amazon SNS topic.
+    #
+    #   <note markdown="1"> If an IAM role ARN is provided, the role (and only the role) is used
+    #   to access all the given resources (Amazon S3 bucket, Amazon Web
+    #   Services KMS customer managed key and Amazon SNS topic). Therefore,
+    #   setting up individual resource access permissions is not required.
+    #
+    #    </note>
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/S3Action AWS API Documentation
     #
     class S3Action < Struct.new(
       :topic_arn,
       :bucket_name,
       :object_key_prefix,
-      :kms_key_arn)
+      :kms_key_arn,
+      :iam_role_arn)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-ses.rb

@@ -53,6 +53,6 @@ require_relative 'aws-sdk-ses/customizations'
 # @!group service
 module Aws::SES
 
-  GEM_VERSION = '1.68.0'
+  GEM_VERSION = '1.70.0'
 
 end

data/sig/client.rbs

@@ -50,6 +50,7 @@ module Aws
                       ?session_token: String,
                       ?sigv4a_signing_region_set: Array[String],
                       ?stub_responses: untyped,
+                      ?telemetry_provider: Aws::Telemetry::TelemetryProviderBase,
                       ?token_provider: untyped,
                       ?use_dualstack_endpoint: bool,
                       ?use_fips_endpoint: bool,
@@ -180,7 +181,8 @@ module Aws
                                          topic_arn: ::String?,
                                          bucket_name: ::String,
                                          object_key_prefix: ::String?,
-                                         kms_key_arn: ::String?
+                                         kms_key_arn: ::String?,
+                                         iam_role_arn: ::String?
                                        }?,
                                        bounce_action: {
                                          topic_arn: ::String?,
@@ -669,7 +671,7 @@ module Aws
                                        ],
                                        template: ::String,
                                        ?template_arn: ::String,
-                                       ?default_template_data: ::String,
+                                       default_template_data: ::String,
                                        destinations: Array[
                                          {
                                            destination: {
@@ -970,7 +972,8 @@ module Aws
                                          topic_arn: ::String?,
                                          bucket_name: ::String,
                                          object_key_prefix: ::String?,
-                                         kms_key_arn: ::String?
+                                         kms_key_arn: ::String?,
+                                         iam_role_arn: ::String?
                                        }?,
                                        bounce_action: {
                                          topic_arn: ::String?,

data/sig/resource.rbs

@@ -50,6 +50,7 @@ module Aws
                         ?session_token: String,
                         ?sigv4a_signing_region_set: Array[String],
                         ?stub_responses: untyped,
+                        ?telemetry_provider: Aws::Telemetry::TelemetryProviderBase,
                         ?token_provider: untyped,
                         ?use_dualstack_endpoint: bool,
                         ?use_fips_endpoint: bool,

data/sig/types.rbs

@@ -795,6 +795,7 @@ module Aws::SES
       attr_accessor bucket_name: ::String
       attr_accessor object_key_prefix: ::String
       attr_accessor kms_key_arn: ::String
+      attr_accessor iam_role_arn: ::String
       SENSITIVE: []
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ses
 version: !ruby/object:Gem::Version
-  version: 1.68.0
+  version: 1.70.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-07-08 00:00:00.000000000 Z
+date: 2024-09-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.201.0
+        version: 3.203.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.201.0
+        version: 3.203.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement