aws-sdk-personalize 1.57.0 → 1.59.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 497ec8ab9d141f4d66a35ea8f66994b1ec0db37e5ff480febc5a4d8ffb75ffaf
-  data.tar.gz: d0d7c01a94947ac6a74f0205a6e4fe96e9b9e4405c27a56abc404ab9689a49d5
+  metadata.gz: 1bbf9f9dfaa6c21ec60de92115714cf616ed34a13314feee44adda460b367b32
+  data.tar.gz: e87dcd0cfb2a597c90352605368508874c53764348eb25b04dad8209f579a1fe
 SHA512:
-  metadata.gz: 196eafeab48df267c053ec31ef8dc88f730a677b6f74ed9c765f22fc9bee81b525574ad283c794ee93b336a0a18fa89d2e7abc0b076e69c69c2dc52b16ea6265
-  data.tar.gz: 8d6d7b8423c0de6f5365ff03898db20795f7c23bf8e0d332a9da908e4ed3cfeb8ba3a920078dc459cff708f3ae0d8fc7c3637ff9f3d594bb02cb83fad96ca01a
+  metadata.gz: 45a8d39268c544f6f2b8c6006aa722ee2e9239eb8ea8d4ce02f52a83ed10ec4f42a4cab3cc7c30acd291ee6547c73b605a609d5a88cc92443dfcd432ea6e5c58
+  data.tar.gz: 60a9bb3ca25d87016682be7d0d05e60c29ea348e2d5844b350e973df8fe967c3b599787d104c656bf609397815fac1af3dc1cea6dd97cf1b67f389e447a18728

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.59.0 (2024-01-26)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.58.0 (2024-01-16)
+------------------
+
+* Feature - Documentation updates for Amazon Personalize.
+
 1.57.0 (2023-11-28)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.57.0
+1.59.0

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

@@ -644,28 +644,34 @@ module Aws::Personalize
     #
     # **Minimum Provisioned TPS and Auto-Scaling**
     #
-    # A high `minProvisionedTPS` will increase your bill. We recommend
+    # A high `minProvisionedTPS` will increase your cost. We recommend
     # starting with 1 for `minProvisionedTPS` (the default). Track your
     # usage using Amazon CloudWatch metrics, and increase the
     # `minProvisionedTPS` as necessary.
     #
-    # A transaction is a single `GetRecommendations` or
-    # `GetPersonalizedRanking` call. Transactions per second (TPS) is the
-    # throughput and unit of billing for Amazon Personalize. The minimum
-    # provisioned TPS (`minProvisionedTPS`) specifies the baseline
-    # throughput provisioned by Amazon Personalize, and thus, the minimum
-    # billing charge.
-    #
-    # If your TPS increases beyond `minProvisionedTPS`, Amazon Personalize
-    # auto-scales the provisioned capacity up and down, but never below
-    # `minProvisionedTPS`. There's a short time delay while the capacity is
-    # increased that might cause loss of transactions.
+    # When you create an Amazon Personalize campaign, you can specify the
+    # minimum provisioned transactions per second (`minProvisionedTPS`) for
+    # the campaign. This is the baseline transaction throughput for the
+    # campaign provisioned by Amazon Personalize. It sets the minimum
+    # billing charge for the campaign while it is active. A transaction is a
+    # single `GetRecommendations` or `GetPersonalizedRanking` request. The
+    # default `minProvisionedTPS` is 1.
+    #
+    # If your TPS increases beyond the `minProvisionedTPS`, Amazon
+    # Personalize auto-scales the provisioned capacity up and down, but
+    # never below `minProvisionedTPS`. There's a short time delay while the
+    # capacity is increased that might cause loss of transactions. When your
+    # traffic reduces, capacity returns to the `minProvisionedTPS`.
+    #
+    # You are charged for the the minimum provisioned TPS or, if your
+    # requests exceed the `minProvisionedTPS`, the actual TPS. The actual
+    # TPS is the total number of recommendation requests you make. We
+    # recommend starting with a low `minProvisionedTPS`, track your usage
+    # using Amazon CloudWatch metrics, and then increase the
+    # `minProvisionedTPS` as necessary.
     #
-    # The actual TPS used is calculated as the average requests/second
-    # within a 5-minute window. You pay for maximum of either the minimum
-    # provisioned TPS or the actual TPS. We recommend starting with a low
-    # `minProvisionedTPS`, track your usage using Amazon CloudWatch metrics,
-    # and then increase the `minProvisionedTPS` as necessary.
+    # For more information about campaign costs, see [Amazon Personalize
+    # pricing][3].
     #
     # **Status**
     #
@@ -676,7 +682,7 @@ module Aws::Personalize
     #
     # * DELETE PENDING > DELETE IN\_PROGRESS
     #
-    # To get the campaign status, call [DescribeCampaign][3].
+    # To get the campaign status, call [DescribeCampaign][4].
     #
     # <note markdown="1"> Wait until the `status` of the campaign is `ACTIVE` before asking the
     # campaign for recommendations.
@@ -685,22 +691,23 @@ module Aws::Personalize
     #
     # **Related APIs**
     #
-    # * [ListCampaigns][4]
+    # * [ListCampaigns][5]
     #
-    # * [DescribeCampaign][3]
+    # * [DescribeCampaign][4]
     #
-    # * [UpdateCampaign][5]
+    # * [UpdateCampaign][6]
     #
-    # * [DeleteCampaign][6]
+    # * [DeleteCampaign][7]
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html
     # [2]: https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetPersonalizedRanking.html
-    # [3]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html
-    # [4]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html
-    # [5]: https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateCampaign.html
-    # [6]: https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteCampaign.html
+    # [3]: https://aws.amazon.com/personalize/pricing/
+    # [4]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html
+    # [5]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html
+    # [6]: https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateCampaign.html
+    # [7]: https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteCampaign.html
     #
     # @option params [required, String] :name
     #   A name for the new campaign. The campaign name must be unique within
@@ -1721,7 +1728,7 @@ module Aws::Personalize
     # @option params [Boolean] :perform_auto_ml
     #   We don't recommend enabling automated machine learning. Instead,
     #   match your use case to the available Amazon Personalize recipes. For
-    #   more information, see [Determining your use case.][1]
+    #   more information, see [Choosing a recipe][1].
     #
     #   Whether to perform automated machine learning (AutoML). The default is
     #   `false`. For this case, you must specify `recipeArn`.
@@ -1735,11 +1742,17 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/determining-use-case.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html
     #
     # @option params [String] :recipe_arn
-    #   The ARN of the recipe to use for model training. This is required when
-    #   `performAutoML` is false.
+    #   The Amazon Resource Name (ARN) of the recipe to use for model
+    #   training. This is required when `performAutoML` is false. For
+    #   information about different Amazon Personalize recipes and their ARNs,
+    #   see [Choosing a recipe][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html
     #
     # @option params [required, String] :dataset_group_arn
     #   The Amazon Resource Name (ARN) of the dataset group that provides the
@@ -4397,7 +4410,7 @@ module Aws::Personalize
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-personalize'
-      context[:gem_version] = '1.57.0'
+      context[:gem_version] = '1.59.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-personalize/plugins/endpoints.rb

@@ -14,6 +14,7 @@ module Aws::Personalize
       option(
         :endpoint_provider,
         doc_type: 'Aws::Personalize::EndpointProvider',
+        rbs_type: 'untyped',
         docstring: 'The endpoint provider used to resolve endpoints. Any '\
                    'object that responds to `#resolve_endpoint(parameters)` '\
                    'where `parameters` is a Struct similar to '\

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

@@ -630,14 +630,17 @@ module Aws::Personalize
     #   Whether metadata with recommendations is enabled for the campaign.
     #   If enabled, you can specify the columns from your Items dataset in
     #   your request for recommendations. Amazon Personalize returns this
-    #   data for each item in the recommendation response.
+    #   data for each item in the recommendation response. For information
+    #   about enabling metadata for a campaign, see [Enabling metadata in
+    #   recommendations for a campaign][1].
     #
     #   If you enable metadata in recommendations, you will incur additional
-    #   costs. For more information, see [Amazon Personalize pricing][1].
+    #   costs. For more information, see [Amazon Personalize pricing][2].
     #
     #
     #
-    #   [1]: https://aws.amazon.com/personalize/pricing/
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata
+    #   [2]: https://aws.amazon.com/personalize/pricing/
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CampaignConfig AWS API Documentation
@@ -1534,7 +1537,7 @@ module Aws::Personalize
     # @!attribute [rw] perform_auto_ml
     #   We don't recommend enabling automated machine learning. Instead,
     #   match your use case to the available Amazon Personalize recipes. For
-    #   more information, see [Determining your use case.][1]
+    #   more information, see [Choosing a recipe][1].
     #
     #   Whether to perform automated machine learning (AutoML). The default
     #   is `false`. For this case, you must specify `recipeArn`.
@@ -1548,12 +1551,18 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/determining-use-case.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html
     #   @return [Boolean]
     #
     # @!attribute [rw] recipe_arn
-    #   The ARN of the recipe to use for model training. This is required
-    #   when `performAutoML` is false.
+    #   The Amazon Resource Name (ARN) of the recipe to use for model
+    #   training. This is required when `performAutoML` is false. For
+    #   information about different Amazon Personalize recipes and their
+    #   ARNs, see [Choosing a recipe][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html
     #   @return [String]
     #
     # @!attribute [rw] dataset_group_arn
@@ -4645,14 +4654,17 @@ module Aws::Personalize
     #   Whether metadata with recommendations is enabled for the
     #   recommender. If enabled, you can specify the columns from your Items
     #   dataset in your request for recommendations. Amazon Personalize
-    #   returns this data for each item in the recommendation response.
+    #   returns this data for each item in the recommendation response. For
+    #   information about enabling metadata for a recommender, see [Enabling
+    #   metadata in recommendations for a recommender][1].
     #
     #   If you enable metadata in recommendations, you will incur additional
-    #   costs. For more information, see [Amazon Personalize pricing][1].
+    #   costs. For more information, see [Amazon Personalize pricing][2].
     #
     #
     #
-    #   [1]: https://aws.amazon.com/personalize/pricing/
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/creating-recommenders.html#create-recommender-return-metadata
+    #   [2]: https://aws.amazon.com/personalize/pricing/
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/RecommenderConfig AWS API Documentation

data/lib/aws-sdk-personalize.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-personalize/customizations'
 # @!group service
 module Aws::Personalize
 
-  GEM_VERSION = '1.57.0'
+  GEM_VERSION = '1.59.0'
 
 end