aws-sdk-pipes 1.24.0 → 1.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c9e850023a9b7e0436574dcf54799052308eb380a015762c9f88a295c4b745af
-  data.tar.gz: 040b99b6de607cc8e18d0184e8144efddc0b67eb2a76552d637b624a82650f95
+  metadata.gz: 152cafc38dd7996acda13fc2756f9e634d12e3666c13fc976793fd16f11b1272
+  data.tar.gz: 84e425616f56382510c25c785d330f6471ca367a4257481cac11063bd5d4db30
 SHA512:
-  metadata.gz: 9bddeaa26241344985e03dd22bdcf68814a15c43d5bcc2339cb4faea4c65d813692eb507dd25f7f349b539fe09291f911f7abe8548dac5543e1ef3a4e5e4c08b
-  data.tar.gz: 19385f4f973e895b7f14b05459d527d3f1d07f8f667cfd09b509a7d486e1581e974dab51b91fc1aef1cf2eeb17b7beb79500599dd4b0d1fc9347b1766c6fff20
+  metadata.gz: 64bcd899e02ca54f42f59f5f7ded5dd0366ed70a9ab1bd0325cf5dff7086970ebc1c1d69fdf547834a0f366f0247157a45f3daa8c2198a418c1205ddd1d4c4ee
+  data.tar.gz: dab21bfe8e0538a3c0aca4fe69ae7748537350bcd07cae6cede5d6f264bf619432104610902ddccedc926f0e4257c9d551eb80a91acaf0db6cb8c88fb8526694

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.26.0 (2024-09-10)
+------------------
+
+* Feature - This release adds support for customer managed KMS keys in Amazon EventBridge Pipe
+
+1.25.0 (2024-09-03)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.24.0 (2024-07-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.24.0
+1.26.0

data/lib/aws-sdk-pipes/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/rest_json.rb'
 
@@ -83,6 +84,7 @@ module Aws::Pipes
     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::RestJson)
     add_plugin(Aws::Pipes::Plugins::Endpoints)
@@ -330,6 +332,16 @@ module Aws::Pipes
     #     ** 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:
@@ -413,6 +425,12 @@ module Aws::Pipes
     #   @option options [String] :ssl_ca_store
     #     Sets the X509::Store to verify peer certificate.
     #
+    #   @option options [OpenSSL::X509::Certificate] :ssl_cert
+    #     Sets a client certificate when creating http connections.
+    #
+    #   @option options [OpenSSL::PKey] :ssl_key
+    #     Sets a client key when creating http connections.
+    #
     #   @option options [Float] :ssl_timeout
     #     Sets the SSL timeout in seconds
     #
@@ -473,6 +491,22 @@ module Aws::Pipes
     # @option params [Types::PipeLogConfigurationParameters] :log_configuration
     #   The logging configuration settings for the pipe.
     #
+    # @option params [String] :kms_key_identifier
+    #   The identifier of the KMS customer managed key for EventBridge to use,
+    #   if you choose to use a customer managed key to encrypt pipe data. The
+    #   identifier can be the key Amazon Resource Name (ARN), KeyId, key
+    #   alias, or key alias ARN.
+    #
+    #   If you do not specify a customer managed key identifier, EventBridge
+    #   uses an Amazon Web Services owned key to encrypt pipe data.
+    #
+    #   For more information, see [Managing keys][1] in the *Key Management
+    #   Service Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/getting-started.html
+    #
     # @return [Types::CreatePipeResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreatePipeResponse#arn #arn} => String
@@ -813,6 +847,7 @@ module Aws::Pipes
     #       level: "OFF", # required, accepts OFF, ERROR, INFO, TRACE
     #       include_execution_data: ["ALL"], # accepts ALL
     #     },
+    #     kms_key_identifier: "KmsKeyIdentifier",
     #   })
     #
     # @example Response structure
@@ -906,6 +941,7 @@ module Aws::Pipes
     #   * {Types::DescribePipeResponse#creation_time #creation_time} => Time
     #   * {Types::DescribePipeResponse#last_modified_time #last_modified_time} => Time
     #   * {Types::DescribePipeResponse#log_configuration #log_configuration} => Types::PipeLogConfiguration
+    #   * {Types::DescribePipeResponse#kms_key_identifier #kms_key_identifier} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -1116,6 +1152,7 @@ module Aws::Pipes
     #   resp.log_configuration.level #=> String, one of "OFF", "ERROR", "INFO", "TRACE"
     #   resp.log_configuration.include_execution_data #=> Array
     #   resp.log_configuration.include_execution_data[0] #=> String, one of "ALL"
+    #   resp.kms_key_identifier #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/pipes-2015-10-07/DescribePipe AWS API Documentation
     #
@@ -1435,6 +1472,27 @@ module Aws::Pipes
     # @option params [Types::PipeLogConfigurationParameters] :log_configuration
     #   The logging configuration settings for the pipe.
     #
+    # @option params [String] :kms_key_identifier
+    #   The identifier of the KMS customer managed key for EventBridge to use,
+    #   if you choose to use a customer managed key to encrypt pipe data. The
+    #   identifier can be the key Amazon Resource Name (ARN), KeyId, key
+    #   alias, or key alias ARN.
+    #
+    #   To update a pipe that is using the default Amazon Web Services owned
+    #   key to use a customer managed key instead, or update a pipe that is
+    #   using a customer managed key to use a different customer managed key,
+    #   specify a customer managed key identifier.
+    #
+    #   To update a pipe that is using a customer managed key to use the
+    #   default Amazon Web Services owned key, specify an empty string.
+    #
+    #   For more information, see [Managing keys][1] in the *Key Management
+    #   Service Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/getting-started.html
+    #
     # @return [Types::UpdatePipeResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdatePipeResponse#arn #arn} => String
@@ -1758,6 +1816,7 @@ module Aws::Pipes
     #       level: "OFF", # required, accepts OFF, ERROR, INFO, TRACE
     #       include_execution_data: ["ALL"], # accepts ALL
     #     },
+    #     kms_key_identifier: "KmsKeyIdentifier",
     #   })
     #
     # @example Response structure
@@ -1784,14 +1843,19 @@ module Aws::Pipes
     # @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::Pipes')
+      )
       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-pipes'
-      context[:gem_version] = '1.24.0'
+      context[:gem_version] = '1.26.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -99,6 +99,7 @@ module Aws::Pipes
     KafkaTopicName = Shapes::StringShape.new(name: 'KafkaTopicName')
     KinesisPartitionKey = Shapes::StringShape.new(name: 'KinesisPartitionKey')
     KinesisStreamStartPosition = Shapes::StringShape.new(name: 'KinesisStreamStartPosition')
+    KmsKeyIdentifier = Shapes::StringShape.new(name: 'KmsKeyIdentifier')
     LaunchType = Shapes::StringShape.new(name: 'LaunchType')
     LimitMax10 = Shapes::IntegerShape.new(name: 'LimitMax10')
     LimitMax100 = Shapes::IntegerShape.new(name: 'LimitMax100')
@@ -319,6 +320,7 @@ module Aws::Pipes
     CreatePipeRequest.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, required: true, location_name: "RoleArn"))
     CreatePipeRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
     CreatePipeRequest.add_member(:log_configuration, Shapes::ShapeRef.new(shape: PipeLogConfigurationParameters, location_name: "LogConfiguration"))
+    CreatePipeRequest.add_member(:kms_key_identifier, Shapes::ShapeRef.new(shape: KmsKeyIdentifier, location_name: "KmsKeyIdentifier"))
     CreatePipeRequest.struct_class = Types::CreatePipeRequest
 
     CreatePipeResponse.add_member(:arn, Shapes::ShapeRef.new(shape: PipeArn, location_name: "Arn"))
@@ -363,6 +365,7 @@ module Aws::Pipes
     DescribePipeResponse.add_member(:creation_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "CreationTime"))
     DescribePipeResponse.add_member(:last_modified_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "LastModifiedTime"))
     DescribePipeResponse.add_member(:log_configuration, Shapes::ShapeRef.new(shape: PipeLogConfiguration, location_name: "LogConfiguration"))
+    DescribePipeResponse.add_member(:kms_key_identifier, Shapes::ShapeRef.new(shape: KmsKeyIdentifier, location_name: "KmsKeyIdentifier"))
     DescribePipeResponse.struct_class = Types::DescribePipeResponse
 
     DimensionMapping.add_member(:dimension_value, Shapes::ShapeRef.new(shape: DimensionValue, required: true, location_name: "DimensionValue"))
@@ -832,6 +835,7 @@ module Aws::Pipes
     UpdatePipeRequest.add_member(:target_parameters, Shapes::ShapeRef.new(shape: PipeTargetParameters, location_name: "TargetParameters"))
     UpdatePipeRequest.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, required: true, location_name: "RoleArn"))
     UpdatePipeRequest.add_member(:log_configuration, Shapes::ShapeRef.new(shape: PipeLogConfigurationParameters, location_name: "LogConfiguration"))
+    UpdatePipeRequest.add_member(:kms_key_identifier, Shapes::ShapeRef.new(shape: KmsKeyIdentifier, location_name: "KmsKeyIdentifier"))
     UpdatePipeRequest.struct_class = Types::UpdatePipeRequest
 
     UpdatePipeResponse.add_member(:arn, Shapes::ShapeRef.new(shape: PipeArn, location_name: "Arn"))
@@ -914,6 +918,7 @@ module Aws::Pipes
 
       api.metadata = {
         "apiVersion" => "2015-10-07",
+        "auth" => ["aws.auth#sigv4"],
         "endpointPrefix" => "pipes",
         "protocol" => "rest-json",
         "protocols" => ["rest-json"],

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

@@ -496,6 +496,23 @@ module Aws::Pipes
     #   The logging configuration settings for the pipe.
     #   @return [Types::PipeLogConfigurationParameters]
     #
+    # @!attribute [rw] kms_key_identifier
+    #   The identifier of the KMS customer managed key for EventBridge to
+    #   use, if you choose to use a customer managed key to encrypt pipe
+    #   data. The identifier can be the key Amazon Resource Name (ARN),
+    #   KeyId, key alias, or key alias ARN.
+    #
+    #   If you do not specify a customer managed key identifier, EventBridge
+    #   uses an Amazon Web Services owned key to encrypt pipe data.
+    #
+    #   For more information, see [Managing keys][1] in the *Key Management
+    #   Service Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/getting-started.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/pipes-2015-10-07/CreatePipeRequest AWS API Documentation
     #
     class CreatePipeRequest < Struct.new(
@@ -510,7 +527,8 @@ module Aws::Pipes
       :target_parameters,
       :role_arn,
       :tags,
-      :log_configuration)
+      :log_configuration,
+      :kms_key_identifier)
       SENSITIVE = [:description, :tags]
       include Aws::Structure
     end
@@ -722,6 +740,18 @@ module Aws::Pipes
     #   The logging configuration settings for the pipe.
     #   @return [Types::PipeLogConfiguration]
     #
+    # @!attribute [rw] kms_key_identifier
+    #   The identifier of the KMS customer managed key for EventBridge to
+    #   use to encrypt pipe data, if one has been specified.
+    #
+    #   For more information, see [Data encryption in EventBridge][1] in the
+    #   *Amazon EventBridge User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-encryption.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/pipes-2015-10-07/DescribePipeResponse AWS API Documentation
     #
     class DescribePipeResponse < Struct.new(
@@ -741,7 +771,8 @@ module Aws::Pipes
       :tags,
       :creation_time,
       :last_modified_time,
-      :log_configuration)
+      :log_configuration,
+      :kms_key_identifier)
       SENSITIVE = [:description, :tags]
       include Aws::Structure
     end
@@ -2807,15 +2838,7 @@ module Aws::Pipes
     # @!attribute [rw] output_format
     #   The format EventBridge uses for the log records.
     #
-    #   * `json`: JSON
-    #
-    #   * `plain`: Plain text
-    #
-    #   * `w3c`: [W3C extended logging file format][1]
-    #
-    #
-    #
-    #   [1]: https://www.w3.org/TR/WD-logfile
+    #   EventBridge currently only supports `json` formatting.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/pipes-2015-10-07/S3LogDestination AWS API Documentation
@@ -2844,15 +2867,7 @@ module Aws::Pipes
     # @!attribute [rw] output_format
     #   How EventBridge should format the log records.
     #
-    #   * `json`: JSON
-    #
-    #   * `plain`: Plain text
-    #
-    #   * `w3c`: [W3C extended logging file format][1]
-    #
-    #
-    #
-    #   [1]: https://www.w3.org/TR/WD-logfile
+    #   EventBridge currently only supports `json` formatting.
     #   @return [String]
     #
     # @!attribute [rw] prefix
@@ -2956,8 +2971,7 @@ module Aws::Pipes
     # @!attribute [rw] security_group
     #   Specifies the security groups associated with the stream. These
     #   security groups must all be in the same VPC. You can specify as many
-    #   as five security groups. If you do not specify a security group, the
-    #   default security group for the VPC is used.
+    #   as five security groups.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/pipes-2015-10-07/SelfManagedKafkaAccessConfigurationVpc AWS API Documentation
@@ -3284,6 +3298,28 @@ module Aws::Pipes
     #   The logging configuration settings for the pipe.
     #   @return [Types::PipeLogConfigurationParameters]
     #
+    # @!attribute [rw] kms_key_identifier
+    #   The identifier of the KMS customer managed key for EventBridge to
+    #   use, if you choose to use a customer managed key to encrypt pipe
+    #   data. The identifier can be the key Amazon Resource Name (ARN),
+    #   KeyId, key alias, or key alias ARN.
+    #
+    #   To update a pipe that is using the default Amazon Web Services owned
+    #   key to use a customer managed key instead, or update a pipe that is
+    #   using a customer managed key to use a different customer managed
+    #   key, specify a customer managed key identifier.
+    #
+    #   To update a pipe that is using a customer managed key to use the
+    #   default Amazon Web Services owned key, specify an empty string.
+    #
+    #   For more information, see [Managing keys][1] in the *Key Management
+    #   Service Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/getting-started.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/pipes-2015-10-07/UpdatePipeRequest AWS API Documentation
     #
     class UpdatePipeRequest < Struct.new(
@@ -3296,7 +3332,8 @@ module Aws::Pipes
       :target,
       :target_parameters,
       :role_arn,
-      :log_configuration)
+      :log_configuration,
+      :kms_key_identifier)
       SENSITIVE = [:description]
       include Aws::Structure
     end

data/lib/aws-sdk-pipes.rb

@@ -53,6 +53,6 @@ require_relative 'aws-sdk-pipes/customizations'
 # @!group service
 module Aws::Pipes
 
-  GEM_VERSION = '1.24.0'
+  GEM_VERSION = '1.26.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,
@@ -399,7 +400,8 @@ module Aws
                            }?,
                            level: ("OFF" | "ERROR" | "INFO" | "TRACE"),
                            include_execution_data: Array[("ALL")]?
-                         }
+                         },
+                         ?kms_key_identifier: ::String
                        ) -> _CreatePipeResponseSuccess
                      | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreatePipeResponseSuccess
 
@@ -437,6 +439,7 @@ module Aws
         def creation_time: () -> ::Time
         def last_modified_time: () -> ::Time
         def log_configuration: () -> Types::PipeLogConfiguration
+        def kms_key_identifier: () -> ::String
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Pipes/Client.html#describe_pipe-instance_method
       def describe_pipe: (
@@ -832,7 +835,8 @@ module Aws
                            }?,
                            level: ("OFF" | "ERROR" | "INFO" | "TRACE"),
                            include_execution_data: Array[("ALL")]?
-                         }
+                         },
+                         ?kms_key_identifier: ::String
                        ) -> _UpdatePipeResponseSuccess
                      | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdatePipeResponseSuccess
     end

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

@@ -88,6 +88,7 @@ module Aws::Pipes
       attr_accessor role_arn: ::String
       attr_accessor tags: ::Hash[::String, ::String]
       attr_accessor log_configuration: Types::PipeLogConfigurationParameters
+      attr_accessor kms_key_identifier: ::String
       SENSITIVE: [:description]
     end
 
@@ -144,6 +145,7 @@ module Aws::Pipes
       attr_accessor creation_time: ::Time
       attr_accessor last_modified_time: ::Time
       attr_accessor log_configuration: Types::PipeLogConfiguration
+      attr_accessor kms_key_identifier: ::String
       SENSITIVE: [:description]
     end
 
@@ -701,6 +703,7 @@ module Aws::Pipes
       attr_accessor target_parameters: Types::PipeTargetParameters
       attr_accessor role_arn: ::String
       attr_accessor log_configuration: Types::PipeLogConfigurationParameters
+      attr_accessor kms_key_identifier: ::String
       SENSITIVE: [:description]
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-pipes
 version: !ruby/object:Gem::Version
-  version: 1.24.0
+  version: 1.26.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-07-18 00:00:00.000000000 Z
+date: 2024-09-10 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,21 +29,21 @@ 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
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.5'
 description: Official AWS Ruby gem for Amazon EventBridge Pipes. This gem is part
   of the AWS SDK for Ruby.
 email: