aws-sdk-kafka 1.116.0 → 1.117.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6dd0975d05cbc9f58b2f4a9156a146f982d04978ec4879989bf9495683b64352
-  data.tar.gz: 05ace13d23527dc257103de277e0988e21eb762a439a2341363427d84e3d17cb
+  metadata.gz: 2b4ea41a96b50b7c20015dcbbf2c45521af725dd00a471fdd5e6b6f8d9dff2ff
+  data.tar.gz: ef790c3f2d2a00a2aee954104226cd28cb5a32d523c0bbab44c77ce1a90001ed
 SHA512:
-  metadata.gz: bcd4c0e9760bb7f6233ac6ae560b8dc9535f3120bf3a9943b7afde42a5af1c62f620a2a3a389fda88425650073bdcd659dc4833e33c71f731c2848cd059cd694
-  data.tar.gz: 93dc6581b91a2f39fadaa6333b73e7983cea820874a2fde7040498790779a57e6dcdedc3854b1a8e640daa14a80fdb0bd6740c5210f866b6c8b94ca3d051911d
+  metadata.gz: 61461945da3092546b0eac34aa6b190046da84cd55fd893cde306dadbc2146611e817049283493fa3bec9f1be81f97c4f377da7eb90bd50fb444dfee9a731b31
+  data.tar.gz: '08e2240ab4b449492ac52dbc19df1d77a130e00241a5a814b23a3f90ae63846218019b28db77a3fbe925f9970c566e47c63f55cc39f80105cead73e89c252414'

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.117.0 (2026-07-30)
+------------------
+
+* Feature - Amazon MSK Express brokers now support streaming tables for Apache Iceberg, continuously materializing Apache Kafka topics as Iceberg tables in Amazon S3 Tables. Express brokers also now support data delivery to Amazon S3 general purpose buckets.
+
 1.116.0 (2026-07-09)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.116.0
+1.117.0

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

@@ -902,6 +902,146 @@ module Aws::Kafka
       req.send_request(options)
     end
 
+    # Creates a Channel that streams records from an Amazon MSK Express
+    # cluster topic to Amazon S3 or Apache Iceberg.
+    #
+    # @option params [required, String] :channel_name
+    #   The name of the channel. Must be unique within the cluster.
+    #
+    # @option params [required, String] :cluster_arn
+    #   The Amazon Resource Name (ARN) that uniquely identifies the cluster.
+    #
+    # @option params [Types::EncryptionConfiguration] :encryption_configuration
+    #   The encryption configuration applied to the channel.
+    #
+    # @option params [Types::IcebergDestinationConfiguration] :iceberg_destination_configuration
+    #   The Apache Iceberg destination for the channel. Mutually exclusive
+    #   with s3DestinationConfiguration.
+    #
+    # @option params [Types::ChannelLoggingInfo] :logging_info
+    #   The destinations to which the channel publishes operational logs.
+    #
+    # @option params [Types::S3DestinationConfiguration] :s3_destination_configuration
+    #   The Amazon S3 destination for the channel. Mutually exclusive with
+    #   icebergDestinationConfiguration.
+    #
+    # @option params [Hash<String,String>] :tags
+    #   The tags attached to the channel.
+    #
+    # @option params [required, Array<Types::TopicConfiguration>] :topic_configuration_list
+    #   The list of topic configurations for the channel. Currently exactly
+    #   one topic must be specified.
+    #
+    # @return [Types::CreateChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateChannelResponse#channel_arn #channel_arn} => String
+    #   * {Types::CreateChannelResponse#cluster_operation_arn #cluster_operation_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_channel({
+    #     channel_name: "__string", # required
+    #     cluster_arn: "__string", # required
+    #     encryption_configuration: {
+    #       kms_key_arn: "__string", # required
+    #     },
+    #     iceberg_destination_configuration: {
+    #       append_only: false, # required
+    #       catalog: {
+    #         catalog_arn: "__string",
+    #         warehouse_location: "__string",
+    #       },
+    #       data_freshness_in_seconds: 1,
+    #       dead_letter_queue_s3: { # required
+    #         bucket_arn: "__string", # required
+    #         error_output_prefix: "__string",
+    #         expected_bucket_owner: "__string",
+    #       },
+    #       destination_table_list: [ # required
+    #         {
+    #           destination_database_name: "__string",
+    #           destination_table_name: "__string",
+    #           partition_spec: {
+    #             partition_strategy: "TIME_HOUR", # required, accepts TIME_HOUR
+    #             source_list: [
+    #               {
+    #                 source_name: "__string",
+    #               },
+    #             ],
+    #           },
+    #         },
+    #       ],
+    #       schema_evolution: { # required
+    #         enable_schema_evolution: false,
+    #       },
+    #       service_execution_role_arn: "__string", # required
+    #       table_creation: { # required
+    #         enable_table_creation: false,
+    #       },
+    #       compression_type: "ZSTD", # accepts ZSTD, SNAPPY
+    #     },
+    #     logging_info: {
+    #       cloud_watch_logs: {
+    #         enabled: false, # required
+    #         log_group: "__string",
+    #       },
+    #       firehose: {
+    #         delivery_stream: "__string",
+    #         enabled: false, # required
+    #       },
+    #       s3: {
+    #         bucket: "__string",
+    #         enabled: false, # required
+    #         prefix: "__string",
+    #       },
+    #     },
+    #     s3_destination_configuration: {
+    #       data_freshness_in_seconds: 1,
+    #       dead_letter_queue_s3: { # required
+    #         bucket_arn: "__string", # required
+    #         error_output_prefix: "__string",
+    #         expected_bucket_owner: "__string",
+    #       },
+    #       service_execution_role_arn: "__string", # required
+    #       storage: { # required
+    #         bucket_arn: "__string", # required
+    #         compression_type: "NONE", # required, accepts NONE, GZIP, ZSTD
+    #         output_prefix: "__string",
+    #         output_key_template: "__string",
+    #         storage_class: "STANDARD", # required, accepts STANDARD, INTELLIGENT_TIERING, GLACIER_IR
+    #         expected_bucket_owner: "__string",
+    #       },
+    #     },
+    #     tags: {
+    #       "__string" => "__string",
+    #     },
+    #     topic_configuration_list: [ # required
+    #       {
+    #         record_converter: { # required
+    #           value_converter: "BYTE_ARRAY", # required, accepts BYTE_ARRAY, JSON, JSON_SCHEMA_GSR, STRING
+    #         },
+    #         record_schema: {
+    #           gsr_arn: "__string", # required
+    #         },
+    #         topic_arn: "__string", # required
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.channel_arn #=> String
+    #   resp.cluster_operation_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kafka-2018-11-14/CreateChannel AWS API Documentation
+    #
+    # @overload create_channel(params = {})
+    # @param [Hash] params ({})
+    def create_channel(params = {}, options = {})
+      req = build_request(:create_channel, params)
+      req.send_request(options)
+    end
+
     # Creates a new Kafka Replicator.
     #
     # @option params [String] :description
@@ -1176,6 +1316,42 @@ module Aws::Kafka
       req.send_request(options)
     end
 
+    # Deletes the channel specified by channelArn from the cluster specified
+    # by clusterArn. The channel transitions through DELETING and is removed
+    # when the asynchronous delete completes.
+    #
+    # @option params [required, String] :channel_arn
+    #   The Amazon Resource Name (ARN) that uniquely identifies the channel.
+    #
+    # @option params [required, String] :cluster_arn
+    #   The Amazon Resource Name (ARN) that uniquely identifies the cluster.
+    #
+    # @return [Types::DeleteChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DeleteChannelResponse#channel_arn #channel_arn} => String
+    #   * {Types::DeleteChannelResponse#cluster_operation_arn #cluster_operation_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_channel({
+    #     channel_arn: "__string", # required
+    #     cluster_arn: "__string", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.channel_arn #=> String
+    #   resp.cluster_operation_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kafka-2018-11-14/DeleteChannel AWS API Documentation
+    #
+    # @overload delete_channel(params = {})
+    # @param [Hash] params ({})
+    def delete_channel(params = {}, options = {})
+      req = build_request(:delete_channel, params)
+      req.send_request(options)
+    end
+
     # Deletes the specified MSK configuration. The configuration must be in
     # the ACTIVE or DELETE\_FAILED state.
     #
@@ -1729,6 +1905,99 @@ module Aws::Kafka
       req.send_request(options)
     end
 
+    # Returns the current configuration and state of a channel.
+    #
+    # @option params [required, String] :channel_arn
+    #   The Amazon Resource Name (ARN) that uniquely identifies the channel.
+    #
+    # @option params [required, String] :cluster_arn
+    #   The Amazon Resource Name (ARN) that uniquely identifies the cluster.
+    #
+    # @return [Types::DescribeChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeChannelResponse#channel_arn #channel_arn} => String
+    #   * {Types::DescribeChannelResponse#channel_name #channel_name} => String
+    #   * {Types::DescribeChannelResponse#encryption_configuration #encryption_configuration} => Types::EncryptionConfiguration
+    #   * {Types::DescribeChannelResponse#iceberg_destination_configuration #iceberg_destination_configuration} => Types::IcebergDestinationConfiguration
+    #   * {Types::DescribeChannelResponse#s3_destination_configuration #s3_destination_configuration} => Types::S3DestinationConfiguration
+    #   * {Types::DescribeChannelResponse#status #status} => String
+    #   * {Types::DescribeChannelResponse#destination_type #destination_type} => String
+    #   * {Types::DescribeChannelResponse#creation_time #creation_time} => Time
+    #   * {Types::DescribeChannelResponse#topic_configuration_list #topic_configuration_list} => Array&lt;Types::TopicConfiguration&gt;
+    #   * {Types::DescribeChannelResponse#logging_info #logging_info} => Types::ChannelLoggingInfo
+    #   * {Types::DescribeChannelResponse#state_info #state_info} => Types::ChannelStateInfo
+    #   * {Types::DescribeChannelResponse#cluster_operation_arn #cluster_operation_arn} => String
+    #   * {Types::DescribeChannelResponse#tags #tags} => Hash&lt;String,String&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_channel({
+    #     channel_arn: "__string", # required
+    #     cluster_arn: "__string", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.channel_arn #=> String
+    #   resp.channel_name #=> String
+    #   resp.encryption_configuration.kms_key_arn #=> String
+    #   resp.iceberg_destination_configuration.append_only #=> Boolean
+    #   resp.iceberg_destination_configuration.catalog.catalog_arn #=> String
+    #   resp.iceberg_destination_configuration.catalog.warehouse_location #=> String
+    #   resp.iceberg_destination_configuration.data_freshness_in_seconds #=> Integer
+    #   resp.iceberg_destination_configuration.dead_letter_queue_s3.bucket_arn #=> String
+    #   resp.iceberg_destination_configuration.dead_letter_queue_s3.error_output_prefix #=> String
+    #   resp.iceberg_destination_configuration.dead_letter_queue_s3.expected_bucket_owner #=> String
+    #   resp.iceberg_destination_configuration.destination_table_list #=> Array
+    #   resp.iceberg_destination_configuration.destination_table_list[0].destination_database_name #=> String
+    #   resp.iceberg_destination_configuration.destination_table_list[0].destination_table_name #=> String
+    #   resp.iceberg_destination_configuration.destination_table_list[0].partition_spec.partition_strategy #=> String, one of "TIME_HOUR"
+    #   resp.iceberg_destination_configuration.destination_table_list[0].partition_spec.source_list #=> Array
+    #   resp.iceberg_destination_configuration.destination_table_list[0].partition_spec.source_list[0].source_name #=> String
+    #   resp.iceberg_destination_configuration.schema_evolution.enable_schema_evolution #=> Boolean
+    #   resp.iceberg_destination_configuration.service_execution_role_arn #=> String
+    #   resp.iceberg_destination_configuration.table_creation.enable_table_creation #=> Boolean
+    #   resp.iceberg_destination_configuration.compression_type #=> String, one of "ZSTD", "SNAPPY"
+    #   resp.s3_destination_configuration.data_freshness_in_seconds #=> Integer
+    #   resp.s3_destination_configuration.dead_letter_queue_s3.bucket_arn #=> String
+    #   resp.s3_destination_configuration.dead_letter_queue_s3.error_output_prefix #=> String
+    #   resp.s3_destination_configuration.dead_letter_queue_s3.expected_bucket_owner #=> String
+    #   resp.s3_destination_configuration.service_execution_role_arn #=> String
+    #   resp.s3_destination_configuration.storage.bucket_arn #=> String
+    #   resp.s3_destination_configuration.storage.compression_type #=> String, one of "NONE", "GZIP", "ZSTD"
+    #   resp.s3_destination_configuration.storage.output_prefix #=> String
+    #   resp.s3_destination_configuration.storage.output_key_template #=> String
+    #   resp.s3_destination_configuration.storage.storage_class #=> String, one of "STANDARD", "INTELLIGENT_TIERING", "GLACIER_IR"
+    #   resp.s3_destination_configuration.storage.expected_bucket_owner #=> String
+    #   resp.status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "FAILED", "SUSPENDING", "SUSPENDED"
+    #   resp.destination_type #=> String, one of "ICEBERG", "S3"
+    #   resp.creation_time #=> Time
+    #   resp.topic_configuration_list #=> Array
+    #   resp.topic_configuration_list[0].record_converter.value_converter #=> String, one of "BYTE_ARRAY", "JSON", "JSON_SCHEMA_GSR", "STRING"
+    #   resp.topic_configuration_list[0].record_schema.gsr_arn #=> String
+    #   resp.topic_configuration_list[0].topic_arn #=> String
+    #   resp.logging_info.cloud_watch_logs.enabled #=> Boolean
+    #   resp.logging_info.cloud_watch_logs.log_group #=> String
+    #   resp.logging_info.firehose.delivery_stream #=> String
+    #   resp.logging_info.firehose.enabled #=> Boolean
+    #   resp.logging_info.s3.bucket #=> String
+    #   resp.logging_info.s3.enabled #=> Boolean
+    #   resp.logging_info.s3.prefix #=> String
+    #   resp.state_info.code #=> String
+    #   resp.state_info.message #=> String
+    #   resp.cluster_operation_arn #=> String
+    #   resp.tags #=> Hash
+    #   resp.tags["__string"] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kafka-2018-11-14/DescribeChannel AWS API Documentation
+    #
+    # @overload describe_channel(params = {})
+    # @param [Hash] params ({})
+    def describe_channel(params = {}, options = {})
+      req = build_request(:describe_channel, params)
+      req.send_request(options)
+    end
+
     # Returns a description of this MSK configuration.
     #
     # @option params [required, String] :arn
@@ -2161,6 +2430,57 @@ module Aws::Kafka
       req.send_request(options)
     end
 
+    # Returns the list of channels in a cluster.
+    #
+    # @option params [required, String] :cluster_arn
+    #   The Amazon Resource Name (ARN) that uniquely identifies the cluster.
+    #
+    # @option params [Integer] :max_results
+    #   Maximum number of channels to return in a single response.
+    #
+    # @option params [String] :next_token
+    #   If the response of ListChannels is truncated, it returns a nextToken
+    #   in the response. This nextToken should be sent in the subsequent
+    #   request to ListChannels.
+    #
+    # @option params [String] :topic_name_filter
+    #   Filters results to channels whose topic name matches the specified
+    #   value.
+    #
+    # @return [Types::ListChannelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListChannelsResponse#channels #channels} => Array&lt;Types::ChannelInfo&gt;
+    #   * {Types::ListChannelsResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_channels({
+    #     cluster_arn: "__string", # required
+    #     max_results: 1,
+    #     next_token: "__string",
+    #     topic_name_filter: "__string",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.channels #=> Array
+    #   resp.channels[0].channel_arn #=> String
+    #   resp.channels[0].channel_name #=> String
+    #   resp.channels[0].status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "FAILED", "SUSPENDING", "SUSPENDED"
+    #   resp.channels[0].creation_time #=> Time
+    #   resp.channels[0].destination_type #=> String, one of "ICEBERG", "S3"
+    #   resp.channels[0].cluster_operation_arn #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kafka-2018-11-14/ListChannels AWS API Documentation
+    #
+    # @overload list_channels(params = {})
+    # @param [Hash] params ({})
+    def list_channels(params = {}, options = {})
+      req = build_request(:list_channels, params)
+      req.send_request(options)
+    end
+
     # Returns a list of all the operations that have been performed on the
     # specified MSK cluster.
     #
@@ -3332,6 +3652,56 @@ module Aws::Kafka
       req.send_request(options)
     end
 
+    # Updates the destination configuration of an existing channel. Exactly
+    # one of icebergDestinationUpdate or s3DestinationUpdate must be
+    # supplied.
+    #
+    # @option params [required, String] :channel_arn
+    #   The Amazon Resource Name (ARN) that uniquely identifies the channel.
+    #
+    # @option params [required, String] :cluster_arn
+    #   The Amazon Resource Name (ARN) that uniquely identifies the cluster.
+    #
+    # @option params [Types::IcebergDestinationUpdate] :iceberg_destination_update
+    #   Updates fields on an Apache Iceberg destination. Use only when the
+    #   channel was created with an Iceberg destination.
+    #
+    # @option params [Types::S3DestinationUpdate] :s3_destination_update
+    #   Updates fields on an Amazon S3 destination. Use only when the channel
+    #   was created with an Amazon S3 destination.
+    #
+    # @return [Types::UpdateChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateChannelResponse#channel_arn #channel_arn} => String
+    #   * {Types::UpdateChannelResponse#cluster_operation_arn #cluster_operation_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_channel({
+    #     channel_arn: "__string", # required
+    #     cluster_arn: "__string", # required
+    #     iceberg_destination_update: {
+    #       data_freshness_in_seconds: 1, # required
+    #     },
+    #     s3_destination_update: {
+    #       data_freshness_in_seconds: 1, # required
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.channel_arn #=> String
+    #   resp.cluster_operation_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kafka-2018-11-14/UpdateChannel AWS API Documentation
+    #
+    # @overload update_channel(params = {})
+    # @param [Hash] params ({})
+    def update_channel(params = {}, options = {})
+      req = build_request(:update_channel, params)
+      req.send_request(options)
+    end
+
     # Updates the cluster with the configuration that is specified in the
     # request body.
     #
@@ -3861,7 +4231,7 @@ module Aws::Kafka
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-kafka'
-      context[:gem_version] = '1.116.0'
+      context[:gem_version] = '1.117.0'
       Seahorse::Client::Request.new(handlers, context)
     end