aws-sdk-personalize 1.46.0 → 1.47.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f81f7f89f543038b996875b4d7e26729a6bc8c78e7d4dbc8747d96fedde7fac5
-  data.tar.gz: a1e2d3d8a9490876818980c942c48c2baa1bfa544ba5e7e8cfafc4b3186e21b0
+  metadata.gz: 15c6785b70645ebb6b66eefc40083a357925c0ac61be29d3a2f70735feb1bf22
+  data.tar.gz: b81c22624e7c6b97bcd9952b9dffa0f9db736036665366258fb259fc5cf57ca9
 SHA512:
-  metadata.gz: 210d6fe4978bfb540a1695fcbb40ea05efbbd6c03b2f90f44c57e245d787b07477af024a721db71782d4eb02c569702eef92ea6a3c866b1d4459ea6e9cd04a4d
-  data.tar.gz: 2aa58a5d7c6b37fb3d0da1f74f854803ebd2ff5b7015415db7232baea0a799319c3f46ae23f480f8af7a6a77c5c96d8cba4d556761e570673ddf7aa04ac4a84c
+  metadata.gz: 5092cbd11d0506068625eb564ffbf060d7711dffbc0f9c6244e8fc47f6c7b159569f7e944b3bbed427d1443b787e0d6c474fb5ca24d067820530208b4164d88c
+  data.tar.gz: 8b39992e5147e260c6a41651d0b3733a4b8883558969de55e7b26bf6e52306c1a0d80bddbf94bf10d722b84381fa9c382b038ef2343221d53b2df8b47d362234

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.47.0 (2023-05-30)
+------------------
+
+* Feature - This release provides support for the exclusion of certain columns for training when creating a solution and creating or updating a recommender with Amazon Personalize.
+
 1.46.0 (2023-01-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.46.0
+1.47.0

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

@@ -426,7 +426,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @return [Types::CreateBatchInferenceJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -504,7 +504,8 @@ module Aws::Personalize
     #
     # @option params [Integer] :num_results
     #   The number of predicted users generated by the batch segment job for
-    #   each line of input data.
+    #   each line of input data. The maximum number of users per segment is 5
+    #   million.
     #
     # @option params [required, Types::BatchSegmentJobInput] :job_input
     #   The Amazon S3 path for the input data used to generate the batch
@@ -524,7 +525,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @return [Types::CreateBatchSegmentJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -577,6 +578,11 @@ module Aws::Personalize
     #
     # **Minimum Provisioned TPS and Auto-Scaling**
     #
+    # A high `minProvisionedTPS` will increase your bill. 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
@@ -639,7 +645,11 @@ module Aws::Personalize
     #
     # @option params [Integer] :min_provisioned_tps
     #   Specifies the requested minimum provisioned transactions
-    #   (recommendations) per second that Amazon Personalize will support.
+    #   (recommendations) per second that Amazon Personalize will support. A
+    #   high `minProvisionedTPS` will increase your bill. We recommend
+    #   starting with 1 for `minProvisionedTPS` (the default). Track your
+    #   usage using Amazon CloudWatch metrics, and increase the
+    #   `minProvisionedTPS` as necessary.
     #
     # @option params [Types::CampaignConfig] :campaign_config
     #   The configuration details of a campaign.
@@ -649,7 +659,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @return [Types::CreateCampaignResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -757,7 +767,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @return [Types::CreateDatasetResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -845,7 +855,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @return [Types::CreateDatasetExportJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -974,7 +984,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @return [Types::CreateDatasetGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1075,7 +1085,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @option params [String] :import_mode
     #   Specify how to add the new records to an existing dataset. The default
@@ -1186,7 +1196,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @return [Types::CreateEventTrackerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1248,7 +1258,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @return [Types::CreateFilterResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1353,6 +1363,11 @@ module Aws::Personalize
     #
     # **Minimum recommendation requests per second**
     #
+    # A high `minRecommendationRequestsPerSecond` will increase your bill.
+    # We recommend starting with 1 for `minRecommendationRequestsPerSecond`
+    # (the default). Track your usage using Amazon CloudWatch metrics, and
+    # increase the `minRecommendationRequestsPerSecond` as necessary.
+    #
     # When you create a recommender, you can configure the recommender's
     # minimum recommendation requests per second. The minimum recommendation
     # requests per second (`minRecommendationRequestsPerSecond`) specifies
@@ -1440,7 +1455,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @return [Types::CreateRecommenderResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1457,6 +1472,11 @@ module Aws::Personalize
     #         "ParameterName" => "ParameterValue",
     #       },
     #       min_recommendation_requests_per_second: 1,
+    #       training_data_config: {
+    #         excluded_dataset_columns: {
+    #           "DatasetType" => ["ColumnName"],
+    #         },
+    #       },
     #     },
     #     tags: [
     #       {
@@ -1540,10 +1560,10 @@ module Aws::Personalize
     end
 
     # Creates the configuration for training a model. A trained model is
-    # known as a solution. After the configuration is created, you train the
-    # model (create a solution) by calling the [CreateSolutionVersion][1]
-    # operation. Every time you call `CreateSolutionVersion`, a new version
-    # of the solution is created.
+    # known as a solution version. After the configuration is created, you
+    # train the model (create a solution version) by calling the
+    # [CreateSolutionVersion][1] operation. Every time you call
+    # `CreateSolutionVersion`, a new version of the solution is created.
     #
     # After creating a solution version, you check its accuracy by calling
     # [GetSolutionMetrics][2]. When you are satisfied with the version, you
@@ -1554,9 +1574,7 @@ module Aws::Personalize
     # recipe. The training data comes from the dataset group that you
     # provide in the request. A recipe specifies the training algorithm and
     # a feature transformation. You can specify one of the predefined
-    # recipes provided by Amazon Personalize. Alternatively, you can specify
-    # `performAutoML` and Amazon Personalize will analyze your data and
-    # select the optimum USER\_PERSONALIZATION recipe for you.
+    # recipes provided by Amazon Personalize.
     #
     # <note markdown="1"> Amazon Personalize doesn't support configuring the `hpoObjective` for
     # solution hyperparameter optimization at this time.
@@ -1614,6 +1632,10 @@ module Aws::Personalize
     #   not set it to `false`.
     #
     # @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]
+    #
     #   Whether to perform automated machine learning (AutoML). The default is
     #   `false`. For this case, you must specify `recipeArn`.
     #
@@ -1624,6 +1646,10 @@ module Aws::Personalize
     #   hyperparameters. AutoML lengthens the training process as compared to
     #   selecting a specific recipe.
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/determining-use-case.html
+    #
     # @option params [String] :recipe_arn
     #   The ARN of the recipe to use for model training. Only specified when
     #   `performAutoML` is false.
@@ -1655,7 +1681,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @return [Types::CreateSolutionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1719,6 +1745,11 @@ module Aws::Personalize
     #         item_attribute: "ItemAttribute",
     #         objective_sensitivity: "LOW", # accepts LOW, MEDIUM, HIGH, OFF
     #       },
+    #       training_data_config: {
+    #         excluded_dataset_columns: {
+    #           "DatasetType" => ["ColumnName"],
+    #         },
+    #       },
     #     },
     #     tags: [
     #       {
@@ -1821,7 +1852,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @return [Types::CreateSolutionVersionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2724,6 +2755,9 @@ module Aws::Personalize
     #   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.recommender_config.training_data_config.excluded_dataset_columns #=> Hash
+    #   resp.recommender.recommender_config.training_data_config.excluded_dataset_columns["DatasetType"] #=> Array
+    #   resp.recommender.recommender_config.training_data_config.excluded_dataset_columns["DatasetType"][0] #=> String
     #   resp.recommender.creation_date_time #=> Time
     #   resp.recommender.last_updated_date_time #=> Time
     #   resp.recommender.status #=> String
@@ -2731,6 +2765,9 @@ module Aws::Personalize
     #   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.recommender_config.training_data_config.excluded_dataset_columns #=> Hash
+    #   resp.recommender.latest_recommender_update.recommender_config.training_data_config.excluded_dataset_columns["DatasetType"] #=> Array
+    #   resp.recommender.latest_recommender_update.recommender_config.training_data_config.excluded_dataset_columns["DatasetType"][0] #=> String
     #   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
@@ -2841,6 +2878,9 @@ module Aws::Personalize
     #   resp.solution.solution_config.auto_ml_config.recipe_list[0] #=> String
     #   resp.solution.solution_config.optimization_objective.item_attribute #=> String
     #   resp.solution.solution_config.optimization_objective.objective_sensitivity #=> String, one of "LOW", "MEDIUM", "HIGH", "OFF"
+    #   resp.solution.solution_config.training_data_config.excluded_dataset_columns #=> Hash
+    #   resp.solution.solution_config.training_data_config.excluded_dataset_columns["DatasetType"] #=> Array
+    #   resp.solution.solution_config.training_data_config.excluded_dataset_columns["DatasetType"][0] #=> String
     #   resp.solution.auto_ml_result.best_recipe_arn #=> String
     #   resp.solution.status #=> String
     #   resp.solution.creation_date_time #=> Time
@@ -2917,6 +2957,9 @@ module Aws::Personalize
     #   resp.solution_version.solution_config.auto_ml_config.recipe_list[0] #=> String
     #   resp.solution_version.solution_config.optimization_objective.item_attribute #=> String
     #   resp.solution_version.solution_config.optimization_objective.objective_sensitivity #=> String, one of "LOW", "MEDIUM", "HIGH", "OFF"
+    #   resp.solution_version.solution_config.training_data_config.excluded_dataset_columns #=> Hash
+    #   resp.solution_version.solution_config.training_data_config.excluded_dataset_columns["DatasetType"] #=> Array
+    #   resp.solution_version.solution_config.training_data_config.excluded_dataset_columns["DatasetType"][0] #=> String
     #   resp.solution_version.training_hours #=> Float
     #   resp.solution_version.training_mode #=> String, one of "FULL", "UPDATE"
     #   resp.solution_version.tuned_hpo_params.algorithm_hyper_parameters #=> Hash
@@ -3649,6 +3692,9 @@ module Aws::Personalize
     #   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].recommender_config.training_data_config.excluded_dataset_columns #=> Hash
+    #   resp.recommenders[0].recommender_config.training_data_config.excluded_dataset_columns["DatasetType"] #=> Array
+    #   resp.recommenders[0].recommender_config.training_data_config.excluded_dataset_columns["DatasetType"][0] #=> String
     #   resp.recommenders[0].status #=> String
     #   resp.recommenders[0].creation_date_time #=> Time
     #   resp.recommenders[0].last_updated_date_time #=> Time
@@ -3819,7 +3865,7 @@ module Aws::Personalize
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @option params [required, String] :resource_arn
     #   The resource's Amazon Resource Name.
@@ -3952,11 +3998,11 @@ module Aws::Personalize
     #
     # @option params [required, Array<Types::Tag>] :tags
     #   Tags to apply to the resource. For more information see [Tagging
-    #   Personalize resources][1].
+    #   Amazon Personalize recources][1].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -3985,7 +4031,7 @@ module Aws::Personalize
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @option params [required, String] :resource_arn
     #   The resource's Amazon Resource Name (ARN).
@@ -4040,7 +4086,11 @@ module Aws::Personalize
     #
     # @option params [Integer] :min_provisioned_tps
     #   Specifies the requested minimum provisioned transactions
-    #   (recommendations) per second that Amazon Personalize will support.
+    #   (recommendations) per second that Amazon Personalize will support. A
+    #   high `minProvisionedTPS` will increase your bill. We recommend
+    #   starting with 1 for `minProvisionedTPS` (the default). Track your
+    #   usage using Amazon CloudWatch metrics, and increase the
+    #   `minProvisionedTPS` as necessary.
     #
     # @option params [Types::CampaignConfig] :campaign_config
     #   The configuration details of a campaign.
@@ -4127,7 +4177,18 @@ module Aws::Personalize
       req.send_request(options)
     end
 
-    # Updates the recommender to modify the recommender configuration.
+    # Updates the recommender to modify the recommender configuration. If
+    # you update the recommender to modify the columns used in training,
+    # Amazon Personalize automatically starts a full retraining of the
+    # models backing your recommender. While the update completes, you can
+    # still get recommendations from the recommender. The recommender uses
+    # the previous configuration until the update completes. To track the
+    # status of this update, use the `latestRecommenderUpdate` returned in
+    # the [DescribeRecommender][1] operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html
     #
     # @option params [required, String] :recommender_arn
     #   The Amazon Resource Name (ARN) of the recommender to modify.
@@ -4148,6 +4209,11 @@ module Aws::Personalize
     #         "ParameterName" => "ParameterValue",
     #       },
     #       min_recommendation_requests_per_second: 1,
+    #       training_data_config: {
+    #         excluded_dataset_columns: {
+    #           "DatasetType" => ["ColumnName"],
+    #         },
+    #       },
     #     },
     #   })
     #
@@ -4177,7 +4243,7 @@ module Aws::Personalize
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-personalize'
-      context[:gem_version] = '1.46.0'
+      context[:gem_version] = '1.47.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -42,6 +42,8 @@ module Aws::Personalize
     CategoricalHyperParameterRanges = Shapes::ListShape.new(name: 'CategoricalHyperParameterRanges')
     CategoricalValue = Shapes::StringShape.new(name: 'CategoricalValue')
     CategoricalValues = Shapes::ListShape.new(name: 'CategoricalValues')
+    ColumnName = Shapes::StringShape.new(name: 'ColumnName')
+    ColumnNamesList = Shapes::ListShape.new(name: 'ColumnNamesList')
     ContinuousHyperParameterRange = Shapes::StructureShape.new(name: 'ContinuousHyperParameterRange')
     ContinuousHyperParameterRanges = Shapes::ListShape.new(name: 'ContinuousHyperParameterRanges')
     ContinuousMaxValue = Shapes::FloatShape.new(name: 'ContinuousMaxValue')
@@ -151,6 +153,7 @@ module Aws::Personalize
     EventTrackers = Shapes::ListShape.new(name: 'EventTrackers')
     EventType = Shapes::StringShape.new(name: 'EventType')
     EventValueThreshold = Shapes::StringShape.new(name: 'EventValueThreshold')
+    ExcludedDatasetColumns = Shapes::MapShape.new(name: 'ExcludedDatasetColumns')
     FailureReason = Shapes::StringShape.new(name: 'FailureReason')
     FeatureTransformation = Shapes::StructureShape.new(name: 'FeatureTransformation')
     FeatureTransformationParameters = Shapes::MapShape.new(name: 'FeatureTransformationParameters')
@@ -276,6 +279,7 @@ module Aws::Personalize
     TooManyTagKeysException = Shapes::StructureShape.new(name: 'TooManyTagKeysException')
     TooManyTagsException = Shapes::StructureShape.new(name: 'TooManyTagsException')
     TrackingId = Shapes::StringShape.new(name: 'TrackingId')
+    TrainingDataConfig = Shapes::StructureShape.new(name: 'TrainingDataConfig')
     TrainingHours = Shapes::FloatShape.new(name: 'TrainingHours')
     TrainingInputMode = Shapes::StringShape.new(name: 'TrainingInputMode')
     TrainingMode = Shapes::StringShape.new(name: 'TrainingMode')
@@ -424,6 +428,8 @@ module Aws::Personalize
 
     CategoricalValues.member = Shapes::ShapeRef.new(shape: CategoricalValue)
 
+    ColumnNamesList.member = Shapes::ShapeRef.new(shape: ColumnName)
+
     ContinuousHyperParameterRange.add_member(:name, Shapes::ShapeRef.new(shape: ParameterName, location_name: "name"))
     ContinuousHyperParameterRange.add_member(:min_value, Shapes::ShapeRef.new(shape: ContinuousMinValue, location_name: "minValue"))
     ContinuousHyperParameterRange.add_member(:max_value, Shapes::ShapeRef.new(shape: ContinuousMaxValue, location_name: "maxValue"))
@@ -864,6 +870,9 @@ module Aws::Personalize
 
     EventTrackers.member = Shapes::ShapeRef.new(shape: EventTrackerSummary)
 
+    ExcludedDatasetColumns.key = Shapes::ShapeRef.new(shape: DatasetType)
+    ExcludedDatasetColumns.value = Shapes::ShapeRef.new(shape: ColumnNamesList)
+
     FeatureTransformation.add_member(:name, Shapes::ShapeRef.new(shape: Name, location_name: "name"))
     FeatureTransformation.add_member(:feature_transformation_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "featureTransformationArn"))
     FeatureTransformation.add_member(:default_parameters, Shapes::ShapeRef.new(shape: FeaturizationParameters, location_name: "defaultParameters"))
@@ -1169,6 +1178,7 @@ module Aws::Personalize
 
     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.add_member(:training_data_config, Shapes::ShapeRef.new(shape: TrainingDataConfig, location_name: "trainingDataConfig"))
     RecommenderConfig.struct_class = Types::RecommenderConfig
 
     RecommenderSummary.add_member(:name, Shapes::ShapeRef.new(shape: Name, location_name: "name"))
@@ -1229,6 +1239,7 @@ module Aws::Personalize
     SolutionConfig.add_member(:feature_transformation_parameters, Shapes::ShapeRef.new(shape: FeatureTransformationParameters, location_name: "featureTransformationParameters"))
     SolutionConfig.add_member(:auto_ml_config, Shapes::ShapeRef.new(shape: AutoMLConfig, location_name: "autoMLConfig"))
     SolutionConfig.add_member(:optimization_objective, Shapes::ShapeRef.new(shape: OptimizationObjective, location_name: "optimizationObjective"))
+    SolutionConfig.add_member(:training_data_config, Shapes::ShapeRef.new(shape: TrainingDataConfig, location_name: "trainingDataConfig"))
     SolutionConfig.struct_class = Types::SolutionConfig
 
     SolutionSummary.add_member(:name, Shapes::ShapeRef.new(shape: Name, location_name: "name"))
@@ -1303,6 +1314,9 @@ module Aws::Personalize
     TooManyTagsException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "message"))
     TooManyTagsException.struct_class = Types::TooManyTagsException
 
+    TrainingDataConfig.add_member(:excluded_dataset_columns, Shapes::ShapeRef.new(shape: ExcludedDatasetColumns, location_name: "excludedDatasetColumns"))
+    TrainingDataConfig.struct_class = Types::TrainingDataConfig
+
     TunedHPOParams.add_member(:algorithm_hyper_parameters, Shapes::ShapeRef.new(shape: HyperParameters, location_name: "algorithmHyperParameters"))
     TunedHPOParams.struct_class = Types::TunedHPOParams
 

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

@@ -14,36 +14,39 @@ module Aws::Personalize
       use_dual_stack = parameters.use_dual_stack
       use_fips = parameters.use_fips
       endpoint = parameters.endpoint
-      if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
-        if Aws::Endpoints::Matchers.set?(endpoint) && (url = Aws::Endpoints::Matchers.parse_url(endpoint))
-          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
-          end
-          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-            raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
-          end
-          return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
-        end
-        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://personalize-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
-        end
+      if Aws::Endpoints::Matchers.set?(endpoint)
         if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
-            return Aws::Endpoints::Endpoint.new(url: "https://personalize-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
         end
         if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://personalize.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+          raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
+        end
+        return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
+      end
+      if Aws::Endpoints::Matchers.set?(region)
+        if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://personalize-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+              return Aws::Endpoints::Endpoint.new(url: "https://personalize-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://personalize.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
           end
-          raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
+          return Aws::Endpoints::Endpoint.new(url: "https://personalize.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
         end
-        return Aws::Endpoints::Endpoint.new(url: "https://personalize.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
       end
+      raise ArgumentError, "Invalid Configuration: Missing Region"
       raise ArgumentError, 'No endpoint could be resolved'
 
     end

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

@@ -366,7 +366,8 @@ module Aws::Personalize
     #
     # @!attribute [rw] num_results
     #   The number of predicted users generated by the batch segment job for
-    #   each line of input data.
+    #   each line of input data. The maximum number of users per segment is
+    #   5 million.
     #   @return [Integer]
     #
     # @!attribute [rw] job_input
@@ -535,7 +536,11 @@ module Aws::Personalize
     #
     # @!attribute [rw] min_provisioned_tps
     #   Specifies the requested minimum provisioned transactions
-    #   (recommendations) per second.
+    #   (recommendations) per second. A high `minProvisionedTPS` will
+    #   increase your bill. We recommend starting with 1 for
+    #   `minProvisionedTPS` (the default). Track your usage using Amazon
+    #   CloudWatch metrics, and increase the `minProvisionedTPS` as
+    #   necessary.
     #   @return [Integer]
     #
     # @!attribute [rw] campaign_config
@@ -815,7 +820,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #   @return [Array<Types::Tag>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateBatchInferenceJobRequest AWS API Documentation
@@ -867,7 +872,8 @@ module Aws::Personalize
     #
     # @!attribute [rw] num_results
     #   The number of predicted users generated by the batch segment job for
-    #   each line of input data.
+    #   each line of input data. The maximum number of users per segment is
+    #   5 million.
     #   @return [Integer]
     #
     # @!attribute [rw] job_input
@@ -891,7 +897,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #   @return [Array<Types::Tag>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateBatchSegmentJobRequest AWS API Documentation
@@ -932,7 +938,11 @@ module Aws::Personalize
     #
     # @!attribute [rw] min_provisioned_tps
     #   Specifies the requested minimum provisioned transactions
-    #   (recommendations) per second that Amazon Personalize will support.
+    #   (recommendations) per second that Amazon Personalize will support. A
+    #   high `minProvisionedTPS` will increase your bill. We recommend
+    #   starting with 1 for `minProvisionedTPS` (the default). Track your
+    #   usage using Amazon CloudWatch metrics, and increase the
+    #   `minProvisionedTPS` as necessary.
     #   @return [Integer]
     #
     # @!attribute [rw] campaign_config
@@ -944,7 +954,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #   @return [Array<Types::Tag>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateCampaignRequest AWS API Documentation
@@ -1002,7 +1012,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #   @return [Array<Types::Tag>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateDatasetExportJobRequest AWS API Documentation
@@ -1058,7 +1068,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #   @return [Array<Types::Tag>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateDatasetGroupRequest AWS API Documentation
@@ -1112,7 +1122,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] import_mode
@@ -1190,7 +1200,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #   @return [Array<Types::Tag>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateDatasetRequest AWS API Documentation
@@ -1231,7 +1241,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #   @return [Array<Types::Tag>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateEventTrackerRequest AWS API Documentation
@@ -1290,7 +1300,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #   @return [Array<Types::Tag>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateFilterRequest AWS API Documentation
@@ -1390,7 +1400,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #   @return [Array<Types::Tag>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateRecommenderRequest AWS API Documentation
@@ -1466,6 +1476,10 @@ module Aws::Personalize
     #   @return [Boolean]
     #
     # @!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]
+    #
     #   Whether to perform automated machine learning (AutoML). The default
     #   is `false`. For this case, you must specify `recipeArn`.
     #
@@ -1475,6 +1489,10 @@ module Aws::Personalize
     #   Personalize determines the optimal recipe by running tests with
     #   different values for the hyperparameters. AutoML lengthens the
     #   training process as compared to selecting a specific recipe.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/determining-use-case.html
     #   @return [Boolean]
     #
     # @!attribute [rw] recipe_arn
@@ -1512,7 +1530,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #   @return [Array<Types::Tag>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateSolutionRequest AWS API Documentation
@@ -1576,7 +1594,7 @@ module Aws::Personalize
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #   @return [Array<Types::Tag>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateSolutionVersionRequest AWS API Documentation
@@ -4477,14 +4495,24 @@ module Aws::Personalize
     #
     # @!attribute [rw] min_recommendation_requests_per_second
     #   Specifies the requested minimum provisioned recommendation requests
-    #   per second that Amazon Personalize will support.
+    #   per second that Amazon Personalize will support. A high
+    #   `minRecommendationRequestsPerSecond` will increase your bill. We
+    #   recommend starting with 1 for `minRecommendationRequestsPerSecond`
+    #   (the default). Track your usage using Amazon CloudWatch metrics, and
+    #   increase the `minRecommendationRequestsPerSecond` as necessary.
     #   @return [Integer]
     #
+    # @!attribute [rw] training_data_config
+    #   Specifies the training data configuration to use when creating a
+    #   domain recommender.
+    #   @return [Types::TrainingDataConfig]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/RecommenderConfig AWS API Documentation
     #
     class RecommenderConfig < Struct.new(
       :item_exploration_config,
-      :min_recommendation_requests_per_second)
+      :min_recommendation_requests_per_second,
+      :training_data_config)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4678,10 +4706,18 @@ module Aws::Personalize
     #   @return [Boolean]
     #
     # @!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]
+    #
     #   When true, Amazon Personalize performs a search for the best
     #   USER\_PERSONALIZATION recipe from the list specified in the solution
     #   configuration (`recipeArn` must not be specified). When false (the
     #   default), Amazon Personalize uses `recipeArn` for training.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/determining-use-case.html
     #   @return [Boolean]
     #
     # @!attribute [rw] recipe_arn
@@ -4790,6 +4826,11 @@ module Aws::Personalize
     #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/optimizing-solution-for-objective.html
     #   @return [Types::OptimizationObjective]
     #
+    # @!attribute [rw] training_data_config
+    #   Specifies the training data configuration to use when creating a
+    #   custom solution version (trained model).
+    #   @return [Types::TrainingDataConfig]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/SolutionConfig AWS API Documentation
     #
     class SolutionConfig < Struct.new(
@@ -4798,7 +4839,8 @@ module Aws::Personalize
       :algorithm_hyper_parameters,
       :feature_transformation_parameters,
       :auto_ml_config,
-      :optimization_objective)
+      :optimization_objective,
+      :training_data_config)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -5099,11 +5141,11 @@ module Aws::Personalize
     # The optional metadata that you apply to resources to help you
     # categorize and organize them. Each tag consists of a key and an
     # optional value, both of which you define. For more information see
-    # [Tagging Personalize resources][1].
+    # [Tagging Amazon Personalize recources][1].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @!attribute [rw] tag_key
     #   One part of a key-value pair that makes up a tag. A key is a general
@@ -5130,11 +5172,11 @@ module Aws::Personalize
     #
     # @!attribute [rw] tags
     #   Tags to apply to the resource. For more information see [Tagging
-    #   Personalize resources][1].
+    #   Amazon Personalize recources][1].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #   @return [Array<Types::Tag>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/TagResourceRequest AWS API Documentation
@@ -5178,6 +5220,27 @@ module Aws::Personalize
       include Aws::Structure
     end
 
+    # The training data configuration to use when creating a domain
+    # recommender or custom solution version (trained model).
+    #
+    # @!attribute [rw] excluded_dataset_columns
+    #   Specifies the columns to exclude from training. Each key is a
+    #   dataset type, and each value is a list of columns. Exclude columns
+    #   to control what data Amazon Personalize uses to generate
+    #   recommendations. For example, you might have a column that you want
+    #   to use only to filter recommendations. You can exclude this column
+    #   from training and Amazon Personalize considers it only when
+    #   filtering.
+    #   @return [Hash<String,Array<String>>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/TrainingDataConfig AWS API Documentation
+    #
+    class TrainingDataConfig < Struct.new(
+      :excluded_dataset_columns)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # If hyperparameter optimization (HPO) was performed, contains the
     # hyperparameter values of the best performing model.
     #
@@ -5224,7 +5287,11 @@ module Aws::Personalize
     #
     # @!attribute [rw] min_provisioned_tps
     #   Specifies the requested minimum provisioned transactions
-    #   (recommendations) per second that Amazon Personalize will support.
+    #   (recommendations) per second that Amazon Personalize will support. A
+    #   high `minProvisionedTPS` will increase your bill. We recommend
+    #   starting with 1 for `minProvisionedTPS` (the default). Track your
+    #   usage using Amazon CloudWatch metrics, and increase the
+    #   `minProvisionedTPS` as necessary.
     #   @return [Integer]
     #
     # @!attribute [rw] campaign_config

data/lib/aws-sdk-personalize.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-personalize
 version: !ruby/object:Gem::Version
-  version: 1.46.0
+  version: 1.47.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-18 00:00:00.000000000 Z
+date: 2023-05-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core