aws-sdk-kafkaconnect 1.33.0 → 1.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5ddb74fa0bf0af39495dcb4577c65a79f7a4df891c712b0b3f091c149cbed075
-  data.tar.gz: 60f51d5cb54a7567ae89a89b053ff3381b2f6545799e6ba933b4274fb0d54ed2
+  metadata.gz: 967293ecc7395aa3cc2bbab3195c213b1272cf06457d07b87d4804b8545d2438
+  data.tar.gz: dc4fabff2795853cadf185c296e193626759b2cf7b4808b4465b82a6b9da91a8
 SHA512:
-  metadata.gz: a346b08efd92336fbf383ea99745b4c263ec5e21492c4e77f475731366d2d75d49abac267c7aab54c42ad28e939bfaaf94b1ba876d1a50eb3d7a2a2f0791d571
-  data.tar.gz: 0d413442e3c455c1f0593d0196cd40892b1403a09b81455c1a226c8946ed246cf577ae9262b1297bc7d7e92ed7fb49dbd5bcd3cc61a2bebe33b16262cf4e46e8
+  metadata.gz: 0bddc43a84063d4f951592a6a8c1c2c70a4c435de7cc5bf9da7e32c032c1b765cc138e8376dc7d3e5169bd69ea69369cf7d3f4262f48343c21354d211212156e
+  data.tar.gz: d0604f5a1a2f1ee38d2b9d6945db4ebef5a453938b89506f9aa3ec633aae1c10944de166aaee095c4904e0505165db073ea99a60d7210ba8e545c9e97e108b32

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.35.0 (2025-01-15)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.34.0 (2025-01-13)
+------------------
+
+* Feature - Support updating connector configuration via UpdateConnector API. Release Operations API to monitor the status of the connector operation.
+
 1.33.0 (2024-10-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.33.0
+1.35.0

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

@@ -257,11 +257,34 @@ module Aws::KafkaConnect
     #     Used when loading credentials from the shared credentials file
     #     at HOME/.aws/credentials.  When not specified, 'default' is used.
     #
+    #   @option options [String] :request_checksum_calculation ("when_supported")
+    #     Determines when a checksum will be calculated for request payloads. Values are:
+    #
+    #     * `when_supported` - (default) When set, a checksum will be
+    #       calculated for all request payloads of operations modeled with the
+    #       `httpChecksum` trait where `requestChecksumRequired` is `true` and/or a
+    #       `requestAlgorithmMember` is modeled.
+    #     * `when_required` - When set, a checksum will only be calculated for
+    #       request payloads of operations modeled with the  `httpChecksum` trait where
+    #       `requestChecksumRequired` is `true` or where a `requestAlgorithmMember`
+    #       is modeled and supplied.
+    #
     #   @option options [Integer] :request_min_compression_size_bytes (10240)
     #     The minimum size in bytes that triggers compression for request
     #     bodies. The value must be non-negative integer value between 0
     #     and 10485780 bytes inclusive.
     #
+    #   @option options [String] :response_checksum_validation ("when_supported")
+    #     Determines when checksum validation will be performed on response payloads. Values are:
+    #
+    #     * `when_supported` - (default) When set, checksum validation is performed on all
+    #       response payloads of operations modeled with the `httpChecksum` trait where
+    #       `responseAlgorithms` is modeled, except when no modeled checksum algorithms
+    #       are supported.
+    #     * `when_required` - When set, checksum validation is not performed on
+    #       response payloads of operations unless the checksum algorithm is supported and
+    #       the `requestValidationModeMember` member is set to `ENABLED`.
+    #
     #   @option options [Proc] :retry_backoff
     #     A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
     #     This option is only used in the `legacy` retry mode.
@@ -495,12 +518,12 @@ 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.
     #
+    # @option params [Hash<String,String>] :tags
+    #   The tags you want to attach to the connector.
+    #
     # @return [Types::CreateConnectorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateConnectorResponse#connector_arn #connector_arn} => String
@@ -574,13 +597,13 @@ module Aws::KafkaConnect
     #       },
     #     ],
     #     service_execution_role_arn: "__string", # required
-    #     tags: {
-    #       "TagKey" => "TagValue",
-    #     },
     #     worker_configuration: {
     #       revision: 1, # required
     #       worker_configuration_arn: "__string", # required
     #     },
+    #     tags: {
+    #       "TagKey" => "TagValue",
+    #     },
     #   })
     #
     # @example Response structure
@@ -828,8 +851,8 @@ module Aws::KafkaConnect
     #   * {Types::DescribeConnectorResponse#log_delivery #log_delivery} => Types::LogDeliveryDescription
     #   * {Types::DescribeConnectorResponse#plugins #plugins} => Array&lt;Types::PluginDescription&gt;
     #   * {Types::DescribeConnectorResponse#service_execution_role_arn #service_execution_role_arn} => String
-    #   * {Types::DescribeConnectorResponse#state_description #state_description} => Types::StateDescription
     #   * {Types::DescribeConnectorResponse#worker_configuration #worker_configuration} => Types::WorkerConfigurationDescription
+    #   * {Types::DescribeConnectorResponse#state_description #state_description} => Types::StateDescription
     #
     # @example Request syntax with placeholder values
     #
@@ -873,10 +896,10 @@ module Aws::KafkaConnect
     #   resp.plugins[0].custom_plugin.custom_plugin_arn #=> String
     #   resp.plugins[0].custom_plugin.revision #=> Integer
     #   resp.service_execution_role_arn #=> String
-    #   resp.state_description.code #=> String
-    #   resp.state_description.message #=> String
     #   resp.worker_configuration.revision #=> Integer
     #   resp.worker_configuration.worker_configuration_arn #=> String
+    #   resp.state_description.code #=> String
+    #   resp.state_description.message #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kafkaconnect-2021-09-14/DescribeConnector AWS API Documentation
     #
@@ -887,6 +910,73 @@ module Aws::KafkaConnect
       req.send_request(options)
     end
 
+    # Returns information about the specified connector's operations.
+    #
+    # @option params [required, String] :connector_operation_arn
+    #   ARN of the connector operation to be described.
+    #
+    # @return [Types::DescribeConnectorOperationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeConnectorOperationResponse#connector_arn #connector_arn} => String
+    #   * {Types::DescribeConnectorOperationResponse#connector_operation_arn #connector_operation_arn} => String
+    #   * {Types::DescribeConnectorOperationResponse#connector_operation_state #connector_operation_state} => String
+    #   * {Types::DescribeConnectorOperationResponse#connector_operation_type #connector_operation_type} => String
+    #   * {Types::DescribeConnectorOperationResponse#operation_steps #operation_steps} => Array&lt;Types::ConnectorOperationStep&gt;
+    #   * {Types::DescribeConnectorOperationResponse#origin_worker_setting #origin_worker_setting} => Types::WorkerSetting
+    #   * {Types::DescribeConnectorOperationResponse#origin_connector_configuration #origin_connector_configuration} => Hash&lt;String,String&gt;
+    #   * {Types::DescribeConnectorOperationResponse#target_worker_setting #target_worker_setting} => Types::WorkerSetting
+    #   * {Types::DescribeConnectorOperationResponse#target_connector_configuration #target_connector_configuration} => Hash&lt;String,String&gt;
+    #   * {Types::DescribeConnectorOperationResponse#error_info #error_info} => Types::StateDescription
+    #   * {Types::DescribeConnectorOperationResponse#creation_time #creation_time} => Time
+    #   * {Types::DescribeConnectorOperationResponse#end_time #end_time} => Time
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_connector_operation({
+    #     connector_operation_arn: "__string", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.connector_arn #=> String
+    #   resp.connector_operation_arn #=> String
+    #   resp.connector_operation_state #=> String, one of "PENDING", "UPDATE_IN_PROGRESS", "UPDATE_COMPLETE", "UPDATE_FAILED", "ROLLBACK_IN_PROGRESS", "ROLLBACK_FAILED", "ROLLBACK_COMPLETE"
+    #   resp.connector_operation_type #=> String, one of "UPDATE_WORKER_SETTING", "UPDATE_CONNECTOR_CONFIGURATION", "ISOLATE_CONNECTOR", "RESTORE_CONNECTOR"
+    #   resp.operation_steps #=> Array
+    #   resp.operation_steps[0].step_type #=> String, one of "INITIALIZE_UPDATE", "FINALIZE_UPDATE", "UPDATE_WORKER_SETTING", "UPDATE_CONNECTOR_CONFIGURATION", "VALIDATE_UPDATE"
+    #   resp.operation_steps[0].step_state #=> String, one of "PENDING", "IN_PROGRESS", "COMPLETED", "FAILED", "CANCELLED"
+    #   resp.origin_worker_setting.capacity.auto_scaling.max_worker_count #=> Integer
+    #   resp.origin_worker_setting.capacity.auto_scaling.mcu_count #=> Integer
+    #   resp.origin_worker_setting.capacity.auto_scaling.min_worker_count #=> Integer
+    #   resp.origin_worker_setting.capacity.auto_scaling.scale_in_policy.cpu_utilization_percentage #=> Integer
+    #   resp.origin_worker_setting.capacity.auto_scaling.scale_out_policy.cpu_utilization_percentage #=> Integer
+    #   resp.origin_worker_setting.capacity.provisioned_capacity.mcu_count #=> Integer
+    #   resp.origin_worker_setting.capacity.provisioned_capacity.worker_count #=> Integer
+    #   resp.origin_connector_configuration #=> Hash
+    #   resp.origin_connector_configuration["__string"] #=> String
+    #   resp.target_worker_setting.capacity.auto_scaling.max_worker_count #=> Integer
+    #   resp.target_worker_setting.capacity.auto_scaling.mcu_count #=> Integer
+    #   resp.target_worker_setting.capacity.auto_scaling.min_worker_count #=> Integer
+    #   resp.target_worker_setting.capacity.auto_scaling.scale_in_policy.cpu_utilization_percentage #=> Integer
+    #   resp.target_worker_setting.capacity.auto_scaling.scale_out_policy.cpu_utilization_percentage #=> Integer
+    #   resp.target_worker_setting.capacity.provisioned_capacity.mcu_count #=> Integer
+    #   resp.target_worker_setting.capacity.provisioned_capacity.worker_count #=> Integer
+    #   resp.target_connector_configuration #=> Hash
+    #   resp.target_connector_configuration["__string"] #=> String
+    #   resp.error_info.code #=> String
+    #   resp.error_info.message #=> String
+    #   resp.creation_time #=> Time
+    #   resp.end_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kafkaconnect-2021-09-14/DescribeConnectorOperation AWS API Documentation
+    #
+    # @overload describe_connector_operation(params = {})
+    # @param [Hash] params ({})
+    def describe_connector_operation(params = {}, options = {})
+      req = build_request(:describe_connector_operation, params)
+      req.send_request(options)
+    end
+
     # A summary description of the custom plugin.
     #
     # @option params [required, String] :custom_plugin_arn
@@ -978,6 +1068,54 @@ module Aws::KafkaConnect
       req.send_request(options)
     end
 
+    # Lists information about a connector's operation(s).
+    #
+    # @option params [required, String] :connector_arn
+    #   The Amazon Resource Name (ARN) of the connector for which to list
+    #   operations.
+    #
+    # @option params [Integer] :max_results
+    #   Maximum number of connector operations to fetch in one get request.
+    #
+    # @option params [String] :next_token
+    #   If the response is truncated, it includes a NextToken. Send this
+    #   NextToken in a subsequent request to continue listing from where it
+    #   left off.
+    #
+    # @return [Types::ListConnectorOperationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListConnectorOperationsResponse#connector_operations #connector_operations} => Array&lt;Types::ConnectorOperationSummary&gt;
+    #   * {Types::ListConnectorOperationsResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_connector_operations({
+    #     connector_arn: "__string", # required
+    #     max_results: 1,
+    #     next_token: "__string",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.connector_operations #=> Array
+    #   resp.connector_operations[0].connector_operation_arn #=> String
+    #   resp.connector_operations[0].connector_operation_type #=> String, one of "UPDATE_WORKER_SETTING", "UPDATE_CONNECTOR_CONFIGURATION", "ISOLATE_CONNECTOR", "RESTORE_CONNECTOR"
+    #   resp.connector_operations[0].connector_operation_state #=> String, one of "PENDING", "UPDATE_IN_PROGRESS", "UPDATE_COMPLETE", "UPDATE_FAILED", "ROLLBACK_IN_PROGRESS", "ROLLBACK_FAILED", "ROLLBACK_COMPLETE"
+    #   resp.connector_operations[0].creation_time #=> Time
+    #   resp.connector_operations[0].end_time #=> Time
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kafkaconnect-2021-09-14/ListConnectorOperations AWS API Documentation
+    #
+    # @overload list_connector_operations(params = {})
+    # @param [Hash] params ({})
+    def list_connector_operations(params = {}, options = {})
+      req = build_request(:list_connector_operations, params)
+      req.send_request(options)
+    end
+
     # Returns a list of all the connectors in this account and Region. The
     # list is limited to connectors whose name starts with the specified
     # prefix. The response also includes a description of each of the listed
@@ -1064,14 +1202,14 @@ 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
     #   continue listing from where the previous operation left off.
     #
+    # @option params [String] :name_prefix
+    #   Lists custom plugin names that start with the specified text string.
+    #
     # @return [Types::ListCustomPluginsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListCustomPluginsResponse#custom_plugins #custom_plugins} => Array&lt;Types::CustomPluginSummary&gt;
@@ -1083,8 +1221,8 @@ module Aws::KafkaConnect
     #
     #   resp = client.list_custom_plugins({
     #     max_results: 1,
-    #     name_prefix: "__string",
     #     next_token: "__string",
+    #     name_prefix: "__string",
     #   })
     #
     # @example Response structure
@@ -1151,16 +1289,16 @@ module Aws::KafkaConnect
     # @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
     #   request to continue listing from where the previous operation left
     #   off.
     #
+    # @option params [String] :name_prefix
+    #   Lists worker configuration names that start with the specified text
+    #   string.
+    #
     # @return [Types::ListWorkerConfigurationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListWorkerConfigurationsResponse#next_token #next_token} => String
@@ -1172,8 +1310,8 @@ module Aws::KafkaConnect
     #
     #   resp = client.list_worker_configurations({
     #     max_results: 1,
-    #     name_prefix: "__string",
     #     next_token: "__string",
+    #     name_prefix: "__string",
     #   })
     #
     # @example Response structure
@@ -1256,9 +1394,13 @@ module Aws::KafkaConnect
 
     # Updates the specified connector.
     #
-    # @option params [required, Types::CapacityUpdate] :capacity
+    # @option params [Types::CapacityUpdate] :capacity
     #   The target capacity.
     #
+    # @option params [Hash<String,String>] :connector_configuration
+    #   A map of keys to values that represent the configuration for the
+    #   connector.
+    #
     # @option params [required, String] :connector_arn
     #   The Amazon Resource Name (ARN) of the connector that you want to
     #   update.
@@ -1270,11 +1412,12 @@ module Aws::KafkaConnect
     #
     #   * {Types::UpdateConnectorResponse#connector_arn #connector_arn} => String
     #   * {Types::UpdateConnectorResponse#connector_state #connector_state} => String
+    #   * {Types::UpdateConnectorResponse#connector_operation_arn #connector_operation_arn} => String
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_connector({
-    #     capacity: { # required
+    #     capacity: {
     #       auto_scaling: {
     #         max_worker_count: 1, # required
     #         mcu_count: 1, # required
@@ -1291,6 +1434,9 @@ module Aws::KafkaConnect
     #         worker_count: 1, # required
     #       },
     #     },
+    #     connector_configuration: {
+    #       "__string" => "__string",
+    #     },
     #     connector_arn: "__string", # required
     #     current_version: "__string", # required
     #   })
@@ -1299,6 +1445,7 @@ module Aws::KafkaConnect
     #
     #   resp.connector_arn #=> String
     #   resp.connector_state #=> String, one of "RUNNING", "CREATING", "UPDATING", "DELETING", "FAILED"
+    #   resp.connector_operation_arn #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kafkaconnect-2021-09-14/UpdateConnector AWS API Documentation
     #
@@ -1327,7 +1474,7 @@ module Aws::KafkaConnect
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-kafkaconnect'
-      context[:gem_version] = '1.33.0'
+      context[:gem_version] = '1.35.0'
       Seahorse::Client::Request.new(handlers, context)
     end