aws-sdk-kafkaconnect 1.19.0 → 1.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f921059d67ed0a8d9a5773da388921567b016402f16bde21bd5f4b1704fd31bd
-  data.tar.gz: 8563d802482adb0a1675857e2f649a418802a51f22d59a5935589b899b09b77f
+  metadata.gz: b0cbd857ea77b6cad7dec7580bd93a8ce7a257345d035485017ccbf34572b525
+  data.tar.gz: de524dda862d22f172301556c530a3800e3277839d529922b934d699185f7baf
 SHA512:
-  metadata.gz: 3e72d35b8a143d7f6e6762cdfed8c96398a9cf9549f6fd6b95ec1a2d35986e875178a229a97357890c54aa282c7748d376d1d69a5796517eefa4e9bf43a8c983
-  data.tar.gz: f6c9f53e6decaf95facfff1ddd8cbf7430b962e9b12a1bf2444497cff6e43995536cd08a6840a0af21cdd4c0926ae40dc06a1f29891f8d639116f8630d0e3375
+  metadata.gz: 1c154a575ba6d6d319e5a4e6e3e5ccf0f9ffbbed50373c1753995aa017560b86304c1c54cf6d14f9d5bd17f13b999cc937547f91892f1a8ef2ad1d9c7d402b09
+  data.tar.gz: 7baa5a69e90ab5d044be4e42f409fff003d7fcab0942307ebd704399f43e65911195d1f8bac0fa2bfba6a6cf68a0e2aa96e683de339df213e07d7c63398ed634

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.21.0 (2024-04-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.20.0 (2024-02-26)
+------------------
+
+* Feature - Adds support for tagging, with new TagResource, UntagResource and ListTagsForResource APIs to manage tags and updates to existing APIs to allow tag on create. This release also adds support for the new DeleteWorkerConfiguration API.
+
 1.19.0 (2024-01-26)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.19.0
+1.21.0

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

@@ -22,6 +22,7 @@ require 'aws-sdk-core/plugins/endpoint_pattern.rb'
 require 'aws-sdk-core/plugins/response_paging.rb'
 require 'aws-sdk-core/plugins/stub_responses.rb'
 require 'aws-sdk-core/plugins/idempotency_token.rb'
+require 'aws-sdk-core/plugins/invocation_id.rb'
 require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
@@ -72,6 +73,7 @@ module Aws::KafkaConnect
     add_plugin(Aws::Plugins::ResponsePaging)
     add_plugin(Aws::Plugins::StubResponses)
     add_plugin(Aws::Plugins::IdempotencyToken)
+    add_plugin(Aws::Plugins::InvocationId)
     add_plugin(Aws::Plugins::JsonvalueConverter)
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
@@ -196,10 +198,17 @@ module Aws::KafkaConnect
     #     When set to 'true' the request body will not be compressed
     #     for supported operations.
     #
-    #   @option options [String] :endpoint
-    #     The client endpoint is normally constructed from the `:region`
-    #     option. You should only configure an `:endpoint` when connecting
-    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
+    #   @option options [String, URI::HTTPS, URI::HTTP] :endpoint
+    #     Normally you should not configure the `:endpoint` option
+    #     directly. This is normally constructed from the `:region`
+    #     option. Configuring `:endpoint` is normally reserved for
+    #     connecting to test or custom endpoints. The endpoint should
+    #     be a URI formatted like:
+    #
+    #         'http://example.com'
+    #         'https://example.com'
+    #         'http://example.com:123'
+    #
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -337,50 +346,65 @@ module Aws::KafkaConnect
     #   @option options [Aws::KafkaConnect::EndpointProvider] :endpoint_provider
     #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::KafkaConnect::EndpointParameters`
     #
-    #   @option options [URI::HTTP,String] :http_proxy A proxy to send
-    #     requests through.  Formatted like 'http://proxy.com:123'.
-    #
-    #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before raising a
-    #     `Timeout::Error`.
-    #
-    #   @option options [Float] :http_read_timeout (60) The default
-    #     number of seconds to wait for response data.  This value can
-    #     safely be set per-request on the session.
-    #
-    #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idle before it is
-    #     considered stale.  Stale connections are closed and removed
-    #     from the pool before making a request.
-    #
-    #   @option options [Float] :http_continue_timeout (1) The number of
-    #     seconds to wait for a 100-continue response before sending the
-    #     request body.  This option has no effect unless the request has
-    #     "Expect" header set to "100-continue".  Defaults to `nil` which
-    #     disables this behaviour.  This value can safely be set per
-    #     request on the session.
-    #
-    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
-    #     in seconds.
+    #   @option options [Float] :http_continue_timeout (1)
+    #     The number of seconds to wait for a 100-continue response before sending the
+    #     request body.  This option has no effect unless the request has "Expect"
+    #     header set to "100-continue".  Defaults to `nil` which  disables this
+    #     behaviour.  This value can safely be set per request on the session.
+    #
+    #   @option options [Float] :http_idle_timeout (5)
+    #     The number of seconds a connection is allowed to sit idle before it
+    #     is considered stale.  Stale connections are closed and removed from the
+    #     pool before making a request.
+    #
+    #   @option options [Float] :http_open_timeout (15)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [URI::HTTP,String] :http_proxy
+    #     A proxy to send requests through.  Formatted like 'http://proxy.com:123'.
+    #
+    #   @option options [Float] :http_read_timeout (60)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [Boolean] :http_wire_trace (false)
+    #     When `true`,  HTTP debug output will be sent to the `:logger`.
+    #
+    #   @option options [Proc] :on_chunk_received
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the response body is received. It provides three arguments: the chunk,
+    #     the number of bytes received, and the total number of
+    #     bytes in the response (or nil if the server did not send a `content-length`).
+    #
+    #   @option options [Proc] :on_chunk_sent
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the request body is sent. It provides three arguments: the chunk,
+    #     the number of bytes read from the body, and the total number of
+    #     bytes in the body.
+    #
+    #   @option options [Boolean] :raise_response_errors (true)
+    #     When `true`, response errors are raised.
+    #
+    #   @option options [String] :ssl_ca_bundle
+    #     Full path to the SSL certificate authority bundle file that should be used when
+    #     verifying peer certificates.  If you do not pass `:ssl_ca_bundle` or
+    #     `:ssl_ca_directory` the the system default will be used if available.
+    #
+    #   @option options [String] :ssl_ca_directory
+    #     Full path of the directory that contains the unbundled SSL certificate
+    #     authority files for verifying peer certificates.  If you do
+    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system
+    #     default will be used if available.
     #
-    #   @option options [Boolean] :http_wire_trace (false) When `true`,
-    #     HTTP debug output will be sent to the `:logger`.
+    #   @option options [String] :ssl_ca_store
+    #     Sets the X509::Store to verify peer certificate.
     #
-    #   @option options [Boolean] :ssl_verify_peer (true) When `true`,
-    #     SSL peer certificates are verified when establishing a
-    #     connection.
+    #   @option options [Float] :ssl_timeout
+    #     Sets the SSL timeout in seconds
     #
-    #   @option options [String] :ssl_ca_bundle Full path to the SSL
-    #     certificate authority bundle file that should be used when
-    #     verifying peer certificates.  If you do not pass
-    #     `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
-    #     will be used if available.
-    #
-    #   @option options [String] :ssl_ca_directory Full path of the
-    #     directory that contains the unbundled SSL certificate
-    #     authority files for verifying peer certificates.  If you do
-    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
-    #     system default will be used if available.
+    #   @option options [Boolean] :ssl_verify_peer (true)
+    #     When `true`, SSL peer certificates are verified when establishing a connection.
     #
     def initialize(*args)
       super
@@ -421,7 +445,13 @@ module Aws::KafkaConnect
     #   Details about log delivery.
     #
     # @option params [required, Array<Types::Plugin>] :plugins
-    #   Specifies which plugins to use for the connector.
+    #   Amazon MSK Connect does not currently support specifying multiple
+    #   plugins as a list. To use more than one plugin for your connector, you
+    #   can create a single custom plugin using a ZIP file that bundles
+    #   multiple plugins together.
+    #
+    #   Specifies which plugin to use for the connector. You must specify a
+    #   single-element list containing one `customPlugin` object.
     #
     # @option params [required, String] :service_execution_role_arn
     #   The Amazon Resource Name (ARN) of the IAM role used by the connector
@@ -430,6 +460,9 @@ module Aws::KafkaConnect
     #   connector that has Amazon S3 as a destination must have permissions
     #   that allow it to write to the S3 destination bucket.
     #
+    # @option params [Hash<String,String>] :tags
+    #   The tags you want to attach to the connector.
+    #
     # @option params [Types::WorkerConfiguration] :worker_configuration
     #   Specifies which worker configuration to use with the connector.
     #
@@ -506,6 +539,9 @@ module Aws::KafkaConnect
     #       },
     #     ],
     #     service_execution_role_arn: "__string", # required
+    #     tags: {
+    #       "TagKey" => "TagValue",
+    #     },
     #     worker_configuration: {
     #       revision: 1, # required
     #       worker_configuration_arn: "__string", # required
@@ -541,6 +577,9 @@ module Aws::KafkaConnect
     # @option params [required, String] :name
     #   The name of the custom plugin.
     #
+    # @option params [Hash<String,String>] :tags
+    #   The tags you want to attach to the custom plugin.
+    #
     # @return [Types::CreateCustomPluginResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateCustomPluginResponse#custom_plugin_arn #custom_plugin_arn} => String
@@ -561,6 +600,9 @@ module Aws::KafkaConnect
     #       },
     #     },
     #     name: "__stringMin1Max128", # required
+    #     tags: {
+    #       "TagKey" => "TagValue",
+    #     },
     #   })
     #
     # @example Response structure
@@ -590,12 +632,16 @@ module Aws::KafkaConnect
     # @option params [required, String] :properties_file_content
     #   Base64 encoded contents of connect-distributed.properties file.
     #
+    # @option params [Hash<String,String>] :tags
+    #   The tags you want to attach to the worker configuration.
+    #
     # @return [Types::CreateWorkerConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateWorkerConfigurationResponse#creation_time #creation_time} => Time
     #   * {Types::CreateWorkerConfigurationResponse#latest_revision #latest_revision} => Types::WorkerConfigurationRevisionSummary
     #   * {Types::CreateWorkerConfigurationResponse#name #name} => String
     #   * {Types::CreateWorkerConfigurationResponse#worker_configuration_arn #worker_configuration_arn} => String
+    #   * {Types::CreateWorkerConfigurationResponse#worker_configuration_state #worker_configuration_state} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -603,6 +649,9 @@ module Aws::KafkaConnect
     #     description: "__stringMax1024",
     #     name: "__stringMin1Max128", # required
     #     properties_file_content: "__sensitiveString", # required
+    #     tags: {
+    #       "TagKey" => "TagValue",
+    #     },
     #   })
     #
     # @example Response structure
@@ -613,6 +662,7 @@ module Aws::KafkaConnect
     #   resp.latest_revision.revision #=> Integer
     #   resp.name #=> String
     #   resp.worker_configuration_arn #=> String
+    #   resp.worker_configuration_state #=> String, one of "ACTIVE", "DELETING"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kafkaconnect-2021-09-14/CreateWorkerConfiguration AWS API Documentation
     #
@@ -689,6 +739,37 @@ module Aws::KafkaConnect
       req.send_request(options)
     end
 
+    # Deletes the specified worker configuration.
+    #
+    # @option params [required, String] :worker_configuration_arn
+    #   The Amazon Resource Name (ARN) of the worker configuration that you
+    #   want to delete.
+    #
+    # @return [Types::DeleteWorkerConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DeleteWorkerConfigurationResponse#worker_configuration_arn #worker_configuration_arn} => String
+    #   * {Types::DeleteWorkerConfigurationResponse#worker_configuration_state #worker_configuration_state} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_worker_configuration({
+    #     worker_configuration_arn: "__string", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.worker_configuration_arn #=> String
+    #   resp.worker_configuration_state #=> String, one of "ACTIVE", "DELETING"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kafkaconnect-2021-09-14/DeleteWorkerConfiguration AWS API Documentation
+    #
+    # @overload delete_worker_configuration(params = {})
+    # @param [Hash] params ({})
+    def delete_worker_configuration(params = {}, options = {})
+      req = build_request(:delete_worker_configuration, params)
+      req.send_request(options)
+    end
+
     # Returns summary information about the connector.
     #
     # @option params [required, String] :connector_arn
@@ -833,6 +914,7 @@ module Aws::KafkaConnect
     #   * {Types::DescribeWorkerConfigurationResponse#latest_revision #latest_revision} => Types::WorkerConfigurationRevisionDescription
     #   * {Types::DescribeWorkerConfigurationResponse#name #name} => String
     #   * {Types::DescribeWorkerConfigurationResponse#worker_configuration_arn #worker_configuration_arn} => String
+    #   * {Types::DescribeWorkerConfigurationResponse#worker_configuration_state #worker_configuration_state} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -850,6 +932,7 @@ module Aws::KafkaConnect
     #   resp.latest_revision.revision #=> Integer
     #   resp.name #=> String
     #   resp.worker_configuration_arn #=> String
+    #   resp.worker_configuration_state #=> String, one of "ACTIVE", "DELETING"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kafkaconnect-2021-09-14/DescribeWorkerConfiguration AWS API Documentation
     #
@@ -946,6 +1029,9 @@ module Aws::KafkaConnect
     # @option params [Integer] :max_results
     #   The maximum number of custom plugins to list in one response.
     #
+    # @option params [String] :name_prefix
+    #   Lists custom plugin names that start with the specified text string.
+    #
     # @option params [String] :next_token
     #   If the response of a ListCustomPlugins operation is truncated, it will
     #   include a NextToken. Send this NextToken in a subsequent request to
@@ -962,6 +1048,7 @@ module Aws::KafkaConnect
     #
     #   resp = client.list_custom_plugins({
     #     max_results: 1,
+    #     name_prefix: "__string",
     #     next_token: "__string",
     #   })
     #
@@ -993,12 +1080,46 @@ module Aws::KafkaConnect
       req.send_request(options)
     end
 
+    # Lists all the tags attached to the specified resource.
+    #
+    # @option params [required, String] :resource_arn
+    #   The Amazon Resource Name (ARN) of the resource for which you want to
+    #   list all attached tags.
+    #
+    # @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListTagsForResourceResponse#tags #tags} => Hash&lt;String,String&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_tags_for_resource({
+    #     resource_arn: "__string", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.tags #=> Hash
+    #   resp.tags["TagKey"] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kafkaconnect-2021-09-14/ListTagsForResource AWS API Documentation
+    #
+    # @overload list_tags_for_resource(params = {})
+    # @param [Hash] params ({})
+    def list_tags_for_resource(params = {}, options = {})
+      req = build_request(:list_tags_for_resource, params)
+      req.send_request(options)
+    end
+
     # Returns a list of all of the worker configurations in this account and
     # Region.
     #
     # @option params [Integer] :max_results
     #   The maximum number of worker configurations to list in one response.
     #
+    # @option params [String] :name_prefix
+    #   Lists worker configuration names that start with the specified text
+    #   string.
+    #
     # @option params [String] :next_token
     #   If the response of a ListWorkerConfigurations operation is truncated,
     #   it will include a NextToken. Send this NextToken in a subsequent
@@ -1016,6 +1137,7 @@ module Aws::KafkaConnect
     #
     #   resp = client.list_worker_configurations({
     #     max_results: 1,
+    #     name_prefix: "__string",
     #     next_token: "__string",
     #   })
     #
@@ -1030,6 +1152,7 @@ module Aws::KafkaConnect
     #   resp.worker_configurations[0].latest_revision.revision #=> Integer
     #   resp.worker_configurations[0].name #=> String
     #   resp.worker_configurations[0].worker_configuration_arn #=> String
+    #   resp.worker_configurations[0].worker_configuration_state #=> String, one of "ACTIVE", "DELETING"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kafkaconnect-2021-09-14/ListWorkerConfigurations AWS API Documentation
     #
@@ -1040,6 +1163,62 @@ module Aws::KafkaConnect
       req.send_request(options)
     end
 
+    # Attaches tags to the specified resource.
+    #
+    # @option params [required, String] :resource_arn
+    #   The Amazon Resource Name (ARN) of the resource to which you want to
+    #   attach tags.
+    #
+    # @option params [required, Hash<String,String>] :tags
+    #   The tags that you want to attach to the resource.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.tag_resource({
+    #     resource_arn: "__string", # required
+    #     tags: { # required
+    #       "TagKey" => "TagValue",
+    #     },
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kafkaconnect-2021-09-14/TagResource AWS API Documentation
+    #
+    # @overload tag_resource(params = {})
+    # @param [Hash] params ({})
+    def tag_resource(params = {}, options = {})
+      req = build_request(:tag_resource, params)
+      req.send_request(options)
+    end
+
+    # Removes tags from the specified resource.
+    #
+    # @option params [required, String] :resource_arn
+    #   The Amazon Resource Name (ARN) of the resource from which you want to
+    #   remove tags.
+    #
+    # @option params [required, Array<String>] :tag_keys
+    #   The keys of the tags that you want to remove from the resource.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.untag_resource({
+    #     resource_arn: "__string", # required
+    #     tag_keys: ["TagKey"], # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kafkaconnect-2021-09-14/UntagResource AWS API Documentation
+    #
+    # @overload untag_resource(params = {})
+    # @param [Hash] params ({})
+    def untag_resource(params = {}, options = {})
+      req = build_request(:untag_resource, params)
+      req.send_request(options)
+    end
+
     # Updates the specified connector.
     #
     # @option params [required, Types::CapacityUpdate] :capacity
@@ -1108,7 +1287,7 @@ module Aws::KafkaConnect
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kafkaconnect'
-      context[:gem_version] = '1.19.0'
+      context[:gem_version] = '1.21.0'
       Seahorse::Client::Request.new(handlers, context)
     end