aws-sdk-kafka 1.13.0 → 1.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 157a956bc7a06c3aa24a941710c213520c99882a
-  data.tar.gz: fc66c59e7a229a2da9b10dbde378831a2ffdb8cd
+  metadata.gz: e31772cfe5cda683b1475842c8d54c4a1a4f3253
+  data.tar.gz: 1c2c4ef5e0d4db86177cef70a91c76b633d0493c
 SHA512:
-  metadata.gz: 12e0a0e1ebbcb790069d404e9290caad5ce2de89ad9e2444836d0ed8abf170806c6bbabbc64b581f447b749ceec7e21ffee4b53076ce78bc5c2c356a9d9155aa
-  data.tar.gz: ceb5d634105cb040ebe512a264f9f6d315752320dfc163038015893bd78f12f264a024c342d0cecfeb9f3ebf8a6cd17964a75f99115fd22fe82996a35e1f9bdf
+  metadata.gz: 4e8b8638b2cd580f60701df17d38472e5335e2f4a057f8b8a719c4edb41f7be277f271d8071ce06c480731f379cfb320da8301325c190c4106fcf12c1f9397b8
+  data.tar.gz: 3048a3def224f87c2fdea6e27542c62ad9cab1ae231d6efb2fe48a9fca72dfb2f3d85227d806282363bf467f67fd93aee7b32ac002062b3a4f99709a5ed2e365

data/lib/aws-sdk-kafka.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-kafka/customizations'
 # @service
 module Aws::Kafka
 
-  GEM_VERSION = '1.13.0'
+  GEM_VERSION = '1.14.0'
 
 end

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

@@ -266,8 +266,7 @@ module Aws::Kafka
     #   The name of the cluster.
     #
     # @option params [Types::ConfigurationInfo] :configuration_info
-    #   Represents the configuration that you want MSK to use for the brokers
-    #   in a cluster.
+    #   Represents the configuration that you want MSK to use for the cluster.
     #
     # @option params [Types::EncryptionInfo] :encryption_info
     #   Includes all encryption-related information.
@@ -357,7 +356,8 @@ module Aws::Kafka
     #   configuration.
     #
     # @option params [required, String] :name
-    #   The name of the configuration.
+    #   The name of the configuration. Configuration names are strings that
+    #   match the regex "^\[0-9A-Za-z-\]+$".
     #
     # @option params [required, String, IO] :server_properties
     #
@@ -753,7 +753,7 @@ module Aws::Kafka
       req.send_request(options)
     end
 
-    # Returns a list of all the MSK configurations in this Region.
+    # Returns a list of all the revisions of an MSK configuration.
     #
     # @option params [required, String] :arn
     #
@@ -966,6 +966,46 @@ module Aws::Kafka
       req.send_request(options)
     end
 
+    # Updates the number of broker nodes in the cluster. You can use this
+    # operation to increase the number of brokers in an existing cluster.
+    # You can't decrease the number of brokers.
+    #
+    # @option params [required, String] :cluster_arn
+    #
+    # @option params [required, String] :current_version
+    #   The current version of the cluster.
+    #
+    # @option params [required, Integer] :target_number_of_broker_nodes
+    #   The number of broker nodes that you want the cluster to have after
+    #   this operation completes successfully.
+    #
+    # @return [Types::UpdateBrokerCountResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateBrokerCountResponse#cluster_arn #cluster_arn} => String
+    #   * {Types::UpdateBrokerCountResponse#cluster_operation_arn #cluster_operation_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_broker_count({
+    #     cluster_arn: "__string", # required
+    #     current_version: "__string", # required
+    #     target_number_of_broker_nodes: 1, # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.cluster_arn #=> String
+    #   resp.cluster_operation_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kafka-2018-11-14/UpdateBrokerCount AWS API Documentation
+    #
+    # @overload update_broker_count(params = {})
+    # @param [Hash] params ({})
+    def update_broker_count(params = {}, options = {})
+      req = build_request(:update_broker_count, params)
+      req.send_request(options)
+    end
+
     # Updates the EBS storage associated with MSK brokers.
     #
     # @option params [required, String] :cluster_arn
@@ -978,6 +1018,12 @@ module Aws::Kafka
     #   Describes the target volume size and the ID of the broker to apply the
     #   update to.
     #
+    #   The value you specify for Target-Volume-in-GiB must be a whole number
+    #   that is greater than 100 GiB.
+    #
+    #   The storage per broker after the update operation can't exceed 16384
+    #   GiB.
+    #
     # @return [Types::UpdateBrokerStorageResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateBrokerStorageResponse#cluster_arn #cluster_arn} => String
@@ -1016,11 +1062,10 @@ module Aws::Kafka
     # @option params [required, String] :cluster_arn
     #
     # @option params [required, Types::ConfigurationInfo] :configuration_info
-    #   Represents the configuration that you want MSK to use for the brokers
-    #   in a cluster.
+    #   Represents the configuration that you want MSK to use for the cluster.
     #
     # @option params [required, String] :current_version
-    #   The version of the cluster that needs to be updated.
+    #   The version of the cluster that you want to update.
     #
     # @return [Types::UpdateClusterConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1065,7 +1110,7 @@ module Aws::Kafka
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kafka'
-      context[:gem_version] = '1.13.0'
+      context[:gem_version] = '1.14.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -75,6 +75,8 @@ module Aws::Kafka
     TooManyRequestsException = Shapes::StructureShape.new(name: 'TooManyRequestsException')
     UnauthorizedException = Shapes::StructureShape.new(name: 'UnauthorizedException')
     UntagResourceRequest = Shapes::StructureShape.new(name: 'UntagResourceRequest')
+    UpdateBrokerCountRequest = Shapes::StructureShape.new(name: 'UpdateBrokerCountRequest')
+    UpdateBrokerCountResponse = Shapes::StructureShape.new(name: 'UpdateBrokerCountResponse')
     UpdateBrokerStorageRequest = Shapes::StructureShape.new(name: 'UpdateBrokerStorageRequest')
     UpdateBrokerStorageResponse = Shapes::StructureShape.new(name: 'UpdateBrokerStorageResponse')
     UpdateClusterConfigurationRequest = Shapes::StructureShape.new(name: 'UpdateClusterConfigurationRequest')
@@ -100,7 +102,6 @@ module Aws::Kafka
     __stringMin1Max64 = Shapes::StringShape.new(name: '__stringMin1Max64')
     __stringMin5Max32 = Shapes::StringShape.new(name: '__stringMin5Max32')
     __timestampIso8601 = Shapes::TimestampShape.new(name: '__timestampIso8601', timestampFormat: "iso8601")
-    __timestampUnix = Shapes::TimestampShape.new(name: '__timestampUnix', timestampFormat: "unixTimestamp")
 
     BadRequestException.add_member(:invalid_parameter, Shapes::ShapeRef.new(shape: __string, location_name: "invalidParameter"))
     BadRequestException.add_member(:message, Shapes::ShapeRef.new(shape: __string, location_name: "message"))
@@ -382,6 +383,15 @@ module Aws::Kafka
     UntagResourceRequest.add_member(:tag_keys, Shapes::ShapeRef.new(shape: __listOf__string, required: true, location: "querystring", location_name: "tagKeys"))
     UntagResourceRequest.struct_class = Types::UntagResourceRequest
 
+    UpdateBrokerCountRequest.add_member(:cluster_arn, Shapes::ShapeRef.new(shape: __string, required: true, location: "uri", location_name: "clusterArn"))
+    UpdateBrokerCountRequest.add_member(:current_version, Shapes::ShapeRef.new(shape: __string, required: true, location_name: "currentVersion"))
+    UpdateBrokerCountRequest.add_member(:target_number_of_broker_nodes, Shapes::ShapeRef.new(shape: __integerMin1Max15, required: true, location_name: "targetNumberOfBrokerNodes"))
+    UpdateBrokerCountRequest.struct_class = Types::UpdateBrokerCountRequest
+
+    UpdateBrokerCountResponse.add_member(:cluster_arn, Shapes::ShapeRef.new(shape: __string, location_name: "clusterArn"))
+    UpdateBrokerCountResponse.add_member(:cluster_operation_arn, Shapes::ShapeRef.new(shape: __string, location_name: "clusterOperationArn"))
+    UpdateBrokerCountResponse.struct_class = Types::UpdateBrokerCountResponse
+
     UpdateBrokerStorageRequest.add_member(:cluster_arn, Shapes::ShapeRef.new(shape: __string, required: true, location: "uri", location_name: "clusterArn"))
     UpdateBrokerStorageRequest.add_member(:current_version, Shapes::ShapeRef.new(shape: __string, required: true, location_name: "currentVersion"))
     UpdateBrokerStorageRequest.add_member(:target_broker_ebs_volume_info, Shapes::ShapeRef.new(shape: __listOfBrokerEBSVolumeInfo, required: true, location_name: "targetBrokerEBSVolumeInfo"))
@@ -678,6 +688,19 @@ module Aws::Kafka
         o.errors << Shapes::ShapeRef.new(shape: InternalServerErrorException)
       end)
 
+      api.add_operation(:update_broker_count, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "UpdateBrokerCount"
+        o.http_method = "PUT"
+        o.http_request_uri = "/v1/clusters/{clusterArn}/nodes/count"
+        o.input = Shapes::ShapeRef.new(shape: UpdateBrokerCountRequest)
+        o.output = Shapes::ShapeRef.new(shape: UpdateBrokerCountResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
+        o.errors << Shapes::ShapeRef.new(shape: BadRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerErrorException)
+        o.errors << Shapes::ShapeRef.new(shape: ForbiddenException)
+      end)
+
       api.add_operation(:update_broker_storage, Seahorse::Model::Operation.new.tap do |o|
         o.name = "UpdateBrokerStorage"
         o.http_method = "PUT"

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

@@ -70,14 +70,7 @@ module Aws::Kafka
     #       }
     #
     # @!attribute [rw] broker_az_distribution
-    #   The distribution of broker nodes across Availability Zones. This is
-    #   an optional parameter. If you don't specify it, Amazon MSK gives it
-    #   the value DEFAULT. You can also explicitly set this parameter to the
-    #   value DEFAULT. No other values are currently allowed.
-    #
-    #   Amazon MSK distributes the broker nodes evenly across the
-    #   Availability Zones that correspond to the subnets you provide when
-    #   you create the cluster.
+    #   The distribution of broker nodes across Availability Zones.
     #   @return [String]
     #
     # @!attribute [rw] client_subnets
@@ -100,6 +93,9 @@ module Aws::Kafka
     #   interfaces in order to specify who can connect to and communicate
     #   with the Amazon MSK cluster. If you don't specify a security group,
     #   Amazon MSK uses the default security group associated with the VPC.
+    #   If you specify security groups that were shared with you, you must
+    #   ensure that you have permissions to them. Specifically, you need the
+    #   ec2:DescribeSecurityGroups permission.
     #   @return [Array<String>]
     #
     # @!attribute [rw] storage_info
@@ -236,7 +232,9 @@ module Aws::Kafka
     #   @return [Types::BrokerSoftwareInfo]
     #
     # @!attribute [rw] current_version
-    #   The current version of the MSK cluster.
+    #   The current version of the MSK cluster. Cluster versions aren't
+    #   simple integers. You can obtain the current version by describing
+    #   the cluster. An example version is KTVPDKIKX0DER.
     #   @return [String]
     #
     # @!attribute [rw] encryption_info
@@ -375,7 +373,8 @@ module Aws::Kafka
     #   @return [Types::ConfigurationRevision]
     #
     # @!attribute [rw] name
-    #   The name of the configuration.
+    #   The name of the configuration. Configuration names are strings that
+    #   match the regex "^\[0-9A-Za-z-\]+$".
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kafka-2018-11-14/Configuration AWS API Documentation
@@ -513,7 +512,7 @@ module Aws::Kafka
     #
     # @!attribute [rw] configuration_info
     #   Represents the configuration that you want MSK to use for the
-    #   brokers in a cluster.
+    #   cluster.
     #   @return [Types::ConfigurationInfo]
     #
     # @!attribute [rw] encryption_info
@@ -598,7 +597,8 @@ module Aws::Kafka
     #   @return [Array<String>]
     #
     # @!attribute [rw] name
-    #   The name of the configuration.
+    #   The name of the configuration. Configuration names are strings that
+    #   match the regex "^\[0-9A-Za-z-\]+$".
     #   @return [String]
     #
     # @!attribute [rw] server_properties
@@ -629,7 +629,8 @@ module Aws::Kafka
     #   @return [Types::ConfigurationRevision]
     #
     # @!attribute [rw] name
-    #   The name of the configuration.
+    #   The name of the configuration. Configuration names are strings that
+    #   match the regex "^\[0-9A-Za-z-\]+$".
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kafka-2018-11-14/CreateConfigurationResponse AWS API Documentation
@@ -784,7 +785,8 @@ module Aws::Kafka
     #   @return [Types::ConfigurationRevision]
     #
     # @!attribute [rw] name
-    #   The name of the configuration.
+    #   The name of the configuration. Configuration names are strings that
+    #   match the regex "^\[0-9A-Za-z-\]+$".
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kafka-2018-11-14/DescribeConfigurationResponse AWS API Documentation
@@ -908,7 +910,7 @@ module Aws::Kafka
     #
     # @!attribute [rw] client_broker
     #   Indicates the encryption setting for data in transit between clients
-    #   and brokers. The following are the possible values.
+    #   and brokers. You must set it to one of the following values.
     #
     #   TLS means that client-broker communication is enabled with TLS only.
     #
@@ -918,7 +920,7 @@ module Aws::Kafka
     #   PLAINTEXT means that client-broker communication is enabled in
     #   plaintext only.
     #
-    #   The default value is TLS\_PLAINTEXT.
+    #   The default value is TLS.
     #   @return [String]
     #
     # @!attribute [rw] in_cluster
@@ -1047,7 +1049,9 @@ module Aws::Kafka
     #
     # @!attribute [rw] bootstrap_broker_string_tls
     #   A string containing one or more DNS names (or IP) and TLS port
-    #   pairs.
+    #   pairs. The following is an example.
+    #
+    #   <programlisting>\{ "BootstrapBrokerStringTls": "b-3.exampleClusterName.abcde.c2.kafka.us-east-1.amazonaws.com:9094,b-1.exampleClusterName.abcde.c2.kafka.us-east-1.amazonaws.com:9094,b-2.exampleClusterName.abcde.c2.kafka.us-east-1.amazonaws.com:9094" \}</programlisting>
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kafka-2018-11-14/GetBootstrapBrokersResponse AWS API Documentation
@@ -1557,6 +1561,56 @@ module Aws::Kafka
       include Aws::Structure
     end
 
+    # Request body for UpdateBrokerCount.
+    #
+    # @note When making an API call, you may pass UpdateBrokerCountRequest
+    #   data as a hash:
+    #
+    #       {
+    #         cluster_arn: "__string", # required
+    #         current_version: "__string", # required
+    #         target_number_of_broker_nodes: 1, # required
+    #       }
+    #
+    # @!attribute [rw] cluster_arn
+    #   @return [String]
+    #
+    # @!attribute [rw] current_version
+    #   The current version of the cluster.
+    #   @return [String]
+    #
+    # @!attribute [rw] target_number_of_broker_nodes
+    #   The number of broker nodes that you want the cluster to have after
+    #   this operation completes successfully.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kafka-2018-11-14/UpdateBrokerCountRequest AWS API Documentation
+    #
+    class UpdateBrokerCountRequest < Struct.new(
+      :cluster_arn,
+      :current_version,
+      :target_number_of_broker_nodes)
+      include Aws::Structure
+    end
+
+    # Response body for UpdateBrokerCount.
+    #
+    # @!attribute [rw] cluster_arn
+    #   The Amazon Resource Name (ARN) of the cluster.
+    #   @return [String]
+    #
+    # @!attribute [rw] cluster_operation_arn
+    #   The Amazon Resource Name (ARN) of the cluster operation.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kafka-2018-11-14/UpdateBrokerCountResponse AWS API Documentation
+    #
+    class UpdateBrokerCountResponse < Struct.new(
+      :cluster_arn,
+      :cluster_operation_arn)
+      include Aws::Structure
+    end
+
     # Request object for UpdateBrokerStorage.
     #
     # @note When making an API call, you may pass UpdateBrokerStorageRequest
@@ -1584,6 +1638,12 @@ module Aws::Kafka
     # @!attribute [rw] target_broker_ebs_volume_info
     #   Describes the target volume size and the ID of the broker to apply
     #   the update to.
+    #
+    #   The value you specify for Target-Volume-in-GiB must be a whole
+    #   number that is greater than 100 GiB.
+    #
+    #   The storage per broker after the update operation can't exceed
+    #   16384 GiB.
     #   @return [Array<Types::BrokerEBSVolumeInfo>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kafka-2018-11-14/UpdateBrokerStorageRequest AWS API Documentation
@@ -1632,11 +1692,11 @@ module Aws::Kafka
     #
     # @!attribute [rw] configuration_info
     #   Represents the configuration that you want MSK to use for the
-    #   brokers in a cluster.
+    #   cluster.
     #   @return [Types::ConfigurationInfo]
     #
     # @!attribute [rw] current_version
-    #   The version of the cluster that needs to be updated.
+    #   The version of the cluster that you want to update.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kafka-2018-11-14/UpdateClusterConfigurationRequest AWS API Documentation

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-kafka
 version: !ruby/object:Gem::Version
-  version: 1.13.0
+  version: 1.14.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-10-09 00:00:00.000000000 Z
+date: 2019-10-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core