aws-sdk-personalize 1.36.0 → 1.37.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: adeadb326c22cbb9572562ca2ac2e53bc2b275d5cf9eabe8285459d154989404
-  data.tar.gz: f151a46c3db6df4355c96a8146589ac6e5ef4aad40b39d405b06cf7a02ab428b
+  metadata.gz: cf98d123a7a3b2b97ec7c4fc3b0ff0ae0811f56a60b198ec08443668bdea265e
+  data.tar.gz: 0a2a71cdcce226d897ece996765bfa51577a256be6835603332d4ac1d07fcc0b
 SHA512:
-  metadata.gz: 0bc07f3763497b00fb5b9ec7fbb0435fb6b981c7aae860b1b641a74db500bbd847bd34206418c5b6706021e2b135554feb50a42e66baed1b0d460711e9106f4b
-  data.tar.gz: fa2c015b1fd9e0d288d700b12d76884aa453fe9380d717b5d1d60be45de119b488b3468c80a3dbccbc4300b158b878839a9fa20a23f1a2cb51620b1fce281c4c
+  metadata.gz: ec10ccd41bb02cbd755527eb161628bcfbb0ee6caebf2f2d9d422c4773fe724415fc92f4b62aafe88c59f421a298fd7a66c663f068a4cfef903ce91c3e9f28eb
+  data.tar.gz: c0fd6ffd4a403f4e4f4aa94be5714403cf32890181d25ed3e0a3a53c87bca2ed574cfe5364f04e0907ef48e11f633e9d9482eb55aa1c03a1e3aa7730bf6dd690

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.37.0 (2022-02-02)
+------------------
+
+* Feature - Adding minRecommendationRequestsPerSecond attribute to recommender APIs.
+
 1.36.0 (2021-12-21)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.36.0
+1.37.0

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

@@ -1074,6 +1074,32 @@ module Aws::Personalize
     # and specify the recommender's Amazon Resource Name (ARN) when you
     # make a [GetRecommendations][1] request.
     #
+    # **Minimum recommendation requests per second**
+    #
+    # When you create a recommender, you can configure the recommender's
+    # minimum recommendation requests per second. The minimum recommendation
+    # requests per second (`minRecommendationRequestsPerSecond`) specifies
+    # the baseline recommendation request throughput provisioned by Amazon
+    # Personalize. The default minRecommendationRequestsPerSecond is `1`. A
+    # recommendation request is a single `GetRecommendations` operation.
+    # Request throughput is measured in requests per second and Amazon
+    # Personalize uses your requests per second to derive your requests per
+    # hour and the price of your recommender usage.
+    #
+    # If your requests per second increases beyond
+    # `minRecommendationRequestsPerSecond`, Amazon Personalize auto-scales
+    # the provisioned capacity up and down, but never below
+    # `minRecommendationRequestsPerSecond`. There's a short time delay
+    # while the capacity is increased that might cause loss of requests.
+    #
+    # Your bill is the greater of either the minimum requests per hour
+    # (based on minRecommendationRequestsPerSecond) or the actual number of
+    # requests. The actual request throughput used is calculated as the
+    # average requests/second within a one-hour window. We recommend
+    # starting with the default `minRecommendationRequestsPerSecond`, track
+    # your usage using Amazon CloudWatch metrics, and then increase the
+    # `minRecommendationRequestsPerSecond` as necessary.
+    #
     # **Status**
     #
     # A recommender can be in one of the following states:
@@ -1139,6 +1165,7 @@ module Aws::Personalize
     #       item_exploration_config: {
     #         "ParameterName" => "ParameterValue",
     #       },
+    #       min_recommendation_requests_per_second: 1,
     #     },
     #   })
     #
@@ -2234,12 +2261,14 @@ module Aws::Personalize
     #   resp.recommender.recipe_arn #=> String
     #   resp.recommender.recommender_config.item_exploration_config #=> Hash
     #   resp.recommender.recommender_config.item_exploration_config["ParameterName"] #=> String
+    #   resp.recommender.recommender_config.min_recommendation_requests_per_second #=> Integer
     #   resp.recommender.creation_date_time #=> Time
     #   resp.recommender.last_updated_date_time #=> Time
     #   resp.recommender.status #=> String
     #   resp.recommender.failure_reason #=> String
     #   resp.recommender.latest_recommender_update.recommender_config.item_exploration_config #=> Hash
     #   resp.recommender.latest_recommender_update.recommender_config.item_exploration_config["ParameterName"] #=> String
+    #   resp.recommender.latest_recommender_update.recommender_config.min_recommendation_requests_per_second #=> Integer
     #   resp.recommender.latest_recommender_update.creation_date_time #=> Time
     #   resp.recommender.latest_recommender_update.last_updated_date_time #=> Time
     #   resp.recommender.latest_recommender_update.status #=> String
@@ -3015,6 +3044,7 @@ module Aws::Personalize
     #   resp.recommenders[0].recipe_arn #=> String
     #   resp.recommenders[0].recommender_config.item_exploration_config #=> Hash
     #   resp.recommenders[0].recommender_config.item_exploration_config["ParameterName"] #=> String
+    #   resp.recommenders[0].recommender_config.min_recommendation_requests_per_second #=> Integer
     #   resp.recommenders[0].status #=> String
     #   resp.recommenders[0].creation_date_time #=> Time
     #   resp.recommenders[0].last_updated_date_time #=> Time
@@ -3286,6 +3316,7 @@ module Aws::Personalize
     #       item_exploration_config: {
     #         "ParameterName" => "ParameterValue",
     #       },
+    #       min_recommendation_requests_per_second: 1,
     #     },
     #   })
     #
@@ -3315,7 +3346,7 @@ module Aws::Personalize
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-personalize'
-      context[:gem_version] = '1.36.0'
+      context[:gem_version] = '1.37.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1037,6 +1037,7 @@ module Aws::Personalize
     Recommender.struct_class = Types::Recommender
 
     RecommenderConfig.add_member(:item_exploration_config, Shapes::ShapeRef.new(shape: HyperParameters, location_name: "itemExplorationConfig"))
+    RecommenderConfig.add_member(:min_recommendation_requests_per_second, Shapes::ShapeRef.new(shape: TransactionsPerSecond, location_name: "minRecommendationRequestsPerSecond"))
     RecommenderConfig.struct_class = Types::RecommenderConfig
 
     RecommenderSummary.add_member(:name, Shapes::ShapeRef.new(shape: Name, location_name: "name"))

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

@@ -1396,6 +1396,7 @@ module Aws::Personalize
     #           item_exploration_config: {
     #             "ParameterName" => "ParameterValue",
     #           },
+    #           min_recommendation_requests_per_second: 1,
     #         },
     #       }
     #
@@ -4568,6 +4569,7 @@ module Aws::Personalize
     #         item_exploration_config: {
     #           "ParameterName" => "ParameterValue",
     #         },
+    #         min_recommendation_requests_per_second: 1,
     #       }
     #
     # @!attribute [rw] item_exploration_config
@@ -4579,10 +4581,16 @@ module Aws::Personalize
     #   user (not popular items or similar items).
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] min_recommendation_requests_per_second
+    #   Specifies the requested minimum provisioned recommendation requests
+    #   per second that Amazon Personalize will support.
+    #   @return [Integer]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/RecommenderConfig AWS API Documentation
     #
     class RecommenderConfig < Struct.new(
-      :item_exploration_config)
+      :item_exploration_config,
+      :min_recommendation_requests_per_second)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4646,7 +4654,7 @@ module Aws::Personalize
     end
 
     # Provides a summary of the properties of a recommender update. For a
-    # complete listing, call the DescribeRecommender API.
+    # complete listing, call the DescribeRecommender API operation.
     #
     # @!attribute [rw] recommender_config
     #   The configuration details of the recommender update.
@@ -4745,7 +4753,7 @@ module Aws::Personalize
     # @!attribute [rw] kms_key_arn
     #   The Amazon Resource Name (ARN) of the Key Management Service (KMS)
     #   key that Amazon Personalize uses to encrypt or decrypt the input and
-    #   output files of a batch inference job.
+    #   output files.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/S3DataConfig AWS API Documentation
@@ -5257,6 +5265,7 @@ module Aws::Personalize
     #           item_exploration_config: {
     #             "ParameterName" => "ParameterValue",
     #           },
+    #           min_recommendation_requests_per_second: 1,
     #         },
     #       }
     #

data/lib/aws-sdk-personalize.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-personalize/customizations'
 # @!group service
 module Aws::Personalize
 
-  GEM_VERSION = '1.36.0'
+  GEM_VERSION = '1.37.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-personalize
 version: !ruby/object:Gem::Version
-  version: 1.36.0
+  version: 1.37.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-12-21 00:00:00.000000000 Z
+date: 2022-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core