aws-sdk-personalize 1.59.0 → 1.61.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1bbf9f9dfaa6c21ec60de92115714cf616ed34a13314feee44adda460b367b32
-  data.tar.gz: e87dcd0cfb2a597c90352605368508874c53764348eb25b04dad8209f579a1fe
+  metadata.gz: 53625cbd92b5a82827d860361b4946dda1dce7142737dc06a161a58a2dfc6dcb
+  data.tar.gz: 523ae480a50925c9df066d71e5ee8f0e4363fa3f3b73eb2da99e60257557d853
 SHA512:
-  metadata.gz: 45a8d39268c544f6f2b8c6006aa722ee2e9239eb8ea8d4ce02f52a83ed10ec4f42a4cab3cc7c30acd291ee6547c73b605a609d5a88cc92443dfcd432ea6e5c58
-  data.tar.gz: 60a9bb3ca25d87016682be7d0d05e60c29ea348e2d5844b350e973df8fe967c3b599787d104c656bf609397815fac1af3dc1cea6dd97cf1b67f389e447a18728
+  metadata.gz: 8f2b67329fe8927c914fb92cc6c2998e94bfb809f3a80da84accdebe7783e76351f67e973b43553a0963dddbb93d8e04e86b344dd321828e1aa7351369bfc4c3
+  data.tar.gz: a11a96310941eeb1bb19092806bc3137ebf0c93978520295714a1e178a342fb49f17756e46439a938e85c4093d0ce768ef603b967b3c64793b388773b7d461fe

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.61.0 (2024-04-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.60.0 (2024-04-19)
+------------------
+
+* Feature - This releases auto training capability while creating a solution and automatically syncing latest solution versions when creating/updating a campaign
+
 1.59.0 (2024-01-26)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.59.0
+1.61.0

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

@@ -22,6 +22,7 @@ require 'aws-sdk-core/plugins/endpoint_pattern.rb'
 require 'aws-sdk-core/plugins/response_paging.rb'
 require 'aws-sdk-core/plugins/stub_responses.rb'
 require 'aws-sdk-core/plugins/idempotency_token.rb'
+require 'aws-sdk-core/plugins/invocation_id.rb'
 require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
@@ -72,6 +73,7 @@ module Aws::Personalize
     add_plugin(Aws::Plugins::ResponsePaging)
     add_plugin(Aws::Plugins::StubResponses)
     add_plugin(Aws::Plugins::IdempotencyToken)
+    add_plugin(Aws::Plugins::InvocationId)
     add_plugin(Aws::Plugins::JsonvalueConverter)
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
@@ -196,10 +198,17 @@ module Aws::Personalize
     #     When set to 'true' the request body will not be compressed
     #     for supported operations.
     #
-    #   @option options [String] :endpoint
-    #     The client endpoint is normally constructed from the `:region`
-    #     option. You should only configure an `:endpoint` when connecting
-    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
+    #   @option options [String, URI::HTTPS, URI::HTTP] :endpoint
+    #     Normally you should not configure the `:endpoint` option
+    #     directly. This is normally constructed from the `:region`
+    #     option. Configuring `:endpoint` is normally reserved for
+    #     connecting to test or custom endpoints. The endpoint should
+    #     be a URI formatted like:
+    #
+    #         'http://example.com'
+    #         'https://example.com'
+    #         'http://example.com:123'
+    #
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -347,50 +356,65 @@ module Aws::Personalize
     #   @option options [Aws::Personalize::EndpointProvider] :endpoint_provider
     #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::Personalize::EndpointParameters`
     #
-    #   @option options [URI::HTTP,String] :http_proxy A proxy to send
-    #     requests through.  Formatted like 'http://proxy.com:123'.
-    #
-    #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before raising a
-    #     `Timeout::Error`.
-    #
-    #   @option options [Float] :http_read_timeout (60) The default
-    #     number of seconds to wait for response data.  This value can
-    #     safely be set per-request on the session.
-    #
-    #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idle before it is
-    #     considered stale.  Stale connections are closed and removed
-    #     from the pool before making a request.
-    #
-    #   @option options [Float] :http_continue_timeout (1) The number of
-    #     seconds to wait for a 100-continue response before sending the
-    #     request body.  This option has no effect unless the request has
-    #     "Expect" header set to "100-continue".  Defaults to `nil` which
-    #     disables this behaviour.  This value can safely be set per
-    #     request on the session.
-    #
-    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
-    #     in seconds.
-    #
-    #   @option options [Boolean] :http_wire_trace (false) When `true`,
-    #     HTTP debug output will be sent to the `:logger`.
+    #   @option options [Float] :http_continue_timeout (1)
+    #     The number of seconds to wait for a 100-continue response before sending the
+    #     request body.  This option has no effect unless the request has "Expect"
+    #     header set to "100-continue".  Defaults to `nil` which  disables this
+    #     behaviour.  This value can safely be set per request on the session.
+    #
+    #   @option options [Float] :http_idle_timeout (5)
+    #     The number of seconds a connection is allowed to sit idle before it
+    #     is considered stale.  Stale connections are closed and removed from the
+    #     pool before making a request.
+    #
+    #   @option options [Float] :http_open_timeout (15)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [URI::HTTP,String] :http_proxy
+    #     A proxy to send requests through.  Formatted like 'http://proxy.com:123'.
+    #
+    #   @option options [Float] :http_read_timeout (60)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [Boolean] :http_wire_trace (false)
+    #     When `true`,  HTTP debug output will be sent to the `:logger`.
+    #
+    #   @option options [Proc] :on_chunk_received
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the response body is received. It provides three arguments: the chunk,
+    #     the number of bytes received, and the total number of
+    #     bytes in the response (or nil if the server did not send a `content-length`).
+    #
+    #   @option options [Proc] :on_chunk_sent
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the request body is sent. It provides three arguments: the chunk,
+    #     the number of bytes read from the body, and the total number of
+    #     bytes in the body.
+    #
+    #   @option options [Boolean] :raise_response_errors (true)
+    #     When `true`, response errors are raised.
+    #
+    #   @option options [String] :ssl_ca_bundle
+    #     Full path to the SSL certificate authority bundle file that should be used when
+    #     verifying peer certificates.  If you do not pass `:ssl_ca_bundle` or
+    #     `:ssl_ca_directory` the the system default will be used if available.
+    #
+    #   @option options [String] :ssl_ca_directory
+    #     Full path of the directory that contains the unbundled SSL certificate
+    #     authority files for verifying peer certificates.  If you do
+    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system
+    #     default will be used if available.
     #
-    #   @option options [Boolean] :ssl_verify_peer (true) When `true`,
-    #     SSL peer certificates are verified when establishing a
-    #     connection.
+    #   @option options [String] :ssl_ca_store
+    #     Sets the X509::Store to verify peer certificate.
     #
-    #   @option options [String] :ssl_ca_bundle Full path to the SSL
-    #     certificate authority bundle file that should be used when
-    #     verifying peer certificates.  If you do not pass
-    #     `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
-    #     will be used if available.
+    #   @option options [Float] :ssl_timeout
+    #     Sets the SSL timeout in seconds
     #
-    #   @option options [String] :ssl_ca_directory Full path of the
-    #     directory that contains the unbundled SSL certificate
-    #     authority files for verifying peer certificates.  If you do
-    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
-    #     system default will be used if available.
+    #   @option options [Boolean] :ssl_verify_peer (true)
+    #     When `true`, SSL peer certificates are verified when establishing a connection.
     #
     def initialize(*args)
       super
@@ -638,8 +662,12 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # You incur campaign costs while it is active. To avoid unnecessary
+    # costs, make sure to delete the campaign when you are finished. For
+    # information about campaign costs, see [Amazon Personalize pricing][1].
+    #
     # Creates a campaign that deploys a solution version. When a client
-    # calls the [GetRecommendations][1] and [GetPersonalizedRanking][2]
+    # calls the [GetRecommendations][2] and [GetPersonalizedRanking][3]
     # APIs, a campaign is specified in the request.
     #
     # **Minimum Provisioned TPS and Auto-Scaling**
@@ -671,7 +699,7 @@ module Aws::Personalize
     # `minProvisionedTPS` as necessary.
     #
     # For more information about campaign costs, see [Amazon Personalize
-    # pricing][3].
+    # pricing][1].
     #
     # **Status**
     #
@@ -701,9 +729,9 @@ module Aws::Personalize
     #
     #
     #
-    # [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://aws.amazon.com/personalize/pricing/
+    # [1]: https://aws.amazon.com/personalize/pricing/
+    # [2]: https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html
+    # [3]: https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetPersonalizedRanking.html
     # [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
@@ -714,7 +742,22 @@ module Aws::Personalize
     #   your account.
     #
     # @option params [required, String] :solution_version_arn
-    #   The Amazon Resource Name (ARN) of the solution version to deploy.
+    #   The Amazon Resource Name (ARN) of the trained model to deploy with the
+    #   campaign. To specify the latest solution version of your solution,
+    #   specify the ARN of your *solution* in `SolutionArn/$LATEST` format.
+    #   You must use this format if you set `syncWithLatestSolutionVersion` to
+    #   `True` in the [CampaignConfig][1].
+    #
+    #   To deploy a model that isn't the latest solution version of your
+    #   solution, specify the ARN of the solution version.
+    #
+    #   For more information about automatic campaign updates, see [Enabling
+    #   automatic campaign updates][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html
+    #   [2]: https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update
     #
     # @option params [Integer] :min_provisioned_tps
     #   Specifies the requested minimum provisioned transactions
@@ -749,6 +792,7 @@ module Aws::Personalize
     #         "ParameterName" => "ParameterValue",
     #       },
     #       enable_metadata_with_recommendations: false,
+    #       sync_with_latest_solution_version: false,
     #     },
     #     tags: [
     #       {
@@ -1653,22 +1697,40 @@ module Aws::Personalize
       req.send_request(options)
     end
 
-    # Creates the configuration for training a model. A trained model is
-    # 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
-    # deploy it using [CreateCampaign][3]. The campaign provides
-    # recommendations to a client through the [GetRecommendations][4] API.
-    #
-    # To train a model, Amazon Personalize requires training data and a
-    # 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.
+    # After you create a solution, you can’t change its configuration. By
+    # default, all new solutions use automatic training. With automatic
+    # training, you incur training costs while your solution is active. You
+    # can't stop automatic training for a solution. To avoid unnecessary
+    # costs, make sure to delete the solution when you are finished. For
+    # information about training costs, see [Amazon Personalize pricing][1].
+    #
+    # Creates the configuration for training a model (creating a solution
+    # version). This configuration includes the recipe to use for model
+    # training and optional training configuration, such as columns to use
+    # in training and feature transformation parameters. For more
+    # information about configuring a solution, see [Creating and
+    # configuring a solution][2].
+    #
+    # By default, new solutions use automatic training to create solution
+    # versions every 7 days. You can change the training frequency.
+    # Automatic solution version creation starts one hour after the solution
+    # is ACTIVE. If you manually create a solution version within the hour,
+    # the solution skips the first automatic training. For more information,
+    # see [Configuring automatic training][3].
+    #
+    # To turn off automatic training, set `performAutoTraining` to false. If
+    # you turn off automatic training, you must manually create a solution
+    # version by calling the [CreateSolutionVersion][4] operation.
+    #
+    # After training starts, you can get the solution version's Amazon
+    # Resource Name (ARN) with the [ListSolutionVersions][5] API operation.
+    # To get its status, use the [DescribeSolutionVersion][6].
+    #
+    # After training completes you can evaluate model accuracy by calling
+    # [GetSolutionMetrics][7]. When you are satisfied with the solution
+    # version, you deploy it using [CreateCampaign][8]. The campaign
+    # provides recommendations to a client through the
+    # [GetRecommendations][9] API.
     #
     # <note markdown="1"> Amazon Personalize doesn't support configuring the `hpoObjective` for
     # solution hyperparameter optimization at this time.
@@ -1684,36 +1746,39 @@ module Aws::Personalize
     #
     # * DELETE PENDING &gt; DELETE IN\_PROGRESS
     #
-    # To get the status of the solution, call [DescribeSolution][5]. Wait
-    # until the status shows as ACTIVE before calling
+    # To get the status of the solution, call [DescribeSolution][10]. If you
+    # use manual training, the status must be ACTIVE before you call
     # `CreateSolutionVersion`.
     #
     # **Related APIs**
     #
-    # * [ListSolutions][6]
+    # * [ListSolutions][11]
     #
-    # * [CreateSolutionVersion][1]
+    # * [CreateSolutionVersion][4]
     #
-    # * [DescribeSolution][5]
+    # * [DescribeSolution][10]
     #
-    # * [DeleteSolution][7]
+    # * [DeleteSolution][12]
     # ^
     #
-    # * [ListSolutionVersions][8]
+    # * [ListSolutionVersions][5]
     #
-    # * [DescribeSolutionVersion][9]
+    # * [DescribeSolutionVersion][6]
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html
-    # [2]: https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html
-    # [3]: https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html
-    # [4]: https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html
-    # [5]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html
-    # [6]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html
-    # [7]: https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html
-    # [8]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html
-    # [9]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html
+    # [1]: https://aws.amazon.com/personalize/pricing/
+    # [2]: https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html
+    # [3]: https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html
+    # [4]: https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html
+    # [5]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html
+    # [6]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html
+    # [7]: https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html
+    # [8]: https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html
+    # [9]: https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html
+    # [10]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html
+    # [11]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html
+    # [12]: https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html
     #
     # @option params [required, String] :name
     #   The name for the solution.
@@ -1744,6 +1809,29 @@ module Aws::Personalize
     #
     #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html
     #
+    # @option params [Boolean] :perform_auto_training
+    #   Whether the solution uses automatic training to create new solution
+    #   versions (trained models). The default is `True` and the solution
+    #   automatically creates new solution versions every 7 days. You can
+    #   change the training frequency by specifying a `schedulingExpression`
+    #   in the `AutoTrainingConfig` as part of solution configuration. For
+    #   more information about automatic training, see [Configuring automatic
+    #   training][1].
+    #
+    #   Automatic solution version creation starts one hour after the solution
+    #   is ACTIVE. If you manually create a solution version within the hour,
+    #   the solution skips the first automatic training.
+    #
+    #   After training starts, you can get the solution version's Amazon
+    #   Resource Name (ARN) with the [ListSolutionVersions][2] API operation.
+    #   To get its status, use the [DescribeSolutionVersion][3].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html
+    #   [2]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html
+    #   [3]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html
+    #
     # @option params [String] :recipe_arn
     #   The Amazon Resource Name (ARN) of the recipe to use for model
     #   training. This is required when `performAutoML` is false. For
@@ -1793,6 +1881,7 @@ module Aws::Personalize
     #     name: "Name", # required
     #     perform_hpo: false,
     #     perform_auto_ml: false,
+    #     perform_auto_training: false,
     #     recipe_arn: "Arn",
     #     dataset_group_arn: "Arn", # required
     #     event_type: "EventType",
@@ -1850,6 +1939,9 @@ module Aws::Personalize
     #           "DatasetType" => ["ColumnName"],
     #         },
     #       },
+    #       auto_training_config: {
+    #         scheduling_expression: "SchedulingExpression",
+    #       },
     #     },
     #     tags: [
     #       {
@@ -1972,7 +2064,7 @@ module Aws::Personalize
     #   resp = client.create_solution_version({
     #     name: "Name",
     #     solution_arn: "Arn", # required
-    #     training_mode: "FULL", # accepts FULL, UPDATE
+    #     training_mode: "FULL", # accepts FULL, UPDATE, AUTOTRAIN
     #     tags: [
     #       {
     #         tag_key: "TagKey", # required
@@ -2427,6 +2519,7 @@ module Aws::Personalize
     #   resp.campaign.campaign_config.item_exploration_config #=> Hash
     #   resp.campaign.campaign_config.item_exploration_config["ParameterName"] #=> String
     #   resp.campaign.campaign_config.enable_metadata_with_recommendations #=> Boolean
+    #   resp.campaign.campaign_config.sync_with_latest_solution_version #=> Boolean
     #   resp.campaign.status #=> String
     #   resp.campaign.failure_reason #=> String
     #   resp.campaign.creation_date_time #=> Time
@@ -2436,6 +2529,7 @@ module Aws::Personalize
     #   resp.campaign.latest_campaign_update.campaign_config.item_exploration_config #=> Hash
     #   resp.campaign.latest_campaign_update.campaign_config.item_exploration_config["ParameterName"] #=> String
     #   resp.campaign.latest_campaign_update.campaign_config.enable_metadata_with_recommendations #=> Boolean
+    #   resp.campaign.latest_campaign_update.campaign_config.sync_with_latest_solution_version #=> Boolean
     #   resp.campaign.latest_campaign_update.status #=> String
     #   resp.campaign.latest_campaign_update.failure_reason #=> String
     #   resp.campaign.latest_campaign_update.creation_date_time #=> Time
@@ -2969,6 +3063,7 @@ module Aws::Personalize
     #   resp.solution.solution_arn #=> String
     #   resp.solution.perform_hpo #=> Boolean
     #   resp.solution.perform_auto_ml #=> Boolean
+    #   resp.solution.perform_auto_training #=> Boolean
     #   resp.solution.recipe_arn #=> String
     #   resp.solution.dataset_group_arn #=> String
     #   resp.solution.event_type #=> String
@@ -3002,12 +3097,15 @@ module Aws::Personalize
     #   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.solution_config.auto_training_config.scheduling_expression #=> String
     #   resp.solution.auto_ml_result.best_recipe_arn #=> String
     #   resp.solution.status #=> String
     #   resp.solution.creation_date_time #=> Time
     #   resp.solution.last_updated_date_time #=> Time
     #   resp.solution.latest_solution_version.solution_version_arn #=> String
     #   resp.solution.latest_solution_version.status #=> String
+    #   resp.solution.latest_solution_version.training_mode #=> String, one of "FULL", "UPDATE", "AUTOTRAIN"
+    #   resp.solution.latest_solution_version.training_type #=> String, one of "AUTOMATIC", "MANUAL"
     #   resp.solution.latest_solution_version.creation_date_time #=> Time
     #   resp.solution.latest_solution_version.last_updated_date_time #=> Time
     #   resp.solution.latest_solution_version.failure_reason #=> String
@@ -3081,14 +3179,16 @@ module Aws::Personalize
     #   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.solution_config.auto_training_config.scheduling_expression #=> String
     #   resp.solution_version.training_hours #=> Float
-    #   resp.solution_version.training_mode #=> String, one of "FULL", "UPDATE"
+    #   resp.solution_version.training_mode #=> String, one of "FULL", "UPDATE", "AUTOTRAIN"
     #   resp.solution_version.tuned_hpo_params.algorithm_hyper_parameters #=> Hash
     #   resp.solution_version.tuned_hpo_params.algorithm_hyper_parameters["ParameterName"] #=> String
     #   resp.solution_version.status #=> String
     #   resp.solution_version.failure_reason #=> String
     #   resp.solution_version.creation_date_time #=> Time
     #   resp.solution_version.last_updated_date_time #=> Time
+    #   resp.solution_version.training_type #=> String, one of "AUTOMATIC", "MANUAL"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeSolutionVersion AWS API Documentation
     #
@@ -3915,6 +4015,8 @@ module Aws::Personalize
     #   resp.solution_versions #=> Array
     #   resp.solution_versions[0].solution_version_arn #=> String
     #   resp.solution_versions[0].status #=> String
+    #   resp.solution_versions[0].training_mode #=> String, one of "FULL", "UPDATE", "AUTOTRAIN"
+    #   resp.solution_versions[0].training_type #=> String, one of "AUTOMATIC", "MANUAL"
     #   resp.solution_versions[0].creation_date_time #=> Time
     #   resp.solution_versions[0].last_updated_date_time #=> Time
     #   resp.solution_versions[0].failure_reason #=> String
@@ -3929,11 +4031,11 @@ module Aws::Personalize
       req.send_request(options)
     end
 
-    # Returns a list of solutions that use the given dataset group. When a
-    # dataset group is not specified, all the solutions associated with the
-    # account are listed. The response provides the properties for each
-    # solution, including the Amazon Resource Name (ARN). For more
-    # information on solutions, see [CreateSolution][1].
+    # Returns a list of solutions in a given dataset group. When a dataset
+    # group is not specified, all the solutions associated with the account
+    # are listed. The response provides the properties for each solution,
+    # including the Amazon Resource Name (ARN). For more information on
+    # solutions, see [CreateSolution][1].
     #
     #
     #
@@ -3991,7 +4093,7 @@ module Aws::Personalize
     # [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
     #
     # @option params [required, String] :resource_arn
-    #   The resource's Amazon Resource Name.
+    #   The resource's Amazon Resource Name (ARN).
     #
     # @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4121,7 +4223,7 @@ module Aws::Personalize
     #
     # @option params [required, Array<Types::Tag>] :tags
     #   Tags to apply to the resource. For more information see [Tagging
-    #   Amazon Personalize recources][1].
+    #   Amazon Personalize resources][1].
     #
     #
     #
@@ -4150,17 +4252,18 @@ module Aws::Personalize
       req.send_request(options)
     end
 
-    # Remove [tags][1] that are attached to a resource.
+    # Removes the specified tags that are attached to a resource. For more
+    # information, see [Removing tags from Amazon Personalize resources][1].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/tags-remove.html
     #
     # @option params [required, String] :resource_arn
     #   The resource's Amazon Resource Name (ARN).
     #
     # @option params [required, Array<String>] :tag_keys
-    #   Keys to remove from the resource's tags.
+    #   The keys of the tags to be removed.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -4182,8 +4285,17 @@ module Aws::Personalize
 
     # Updates a campaign to deploy a retrained solution version with an
     # existing campaign, change your campaign's `minProvisionedTPS`, or
-    # modify your campaign's configuration, such as the exploration
-    # configuration.
+    # modify your campaign's configuration. For example, you can set
+    # `enableMetadataWithRecommendations` to true for an existing campaign.
+    #
+    # To update a campaign to start automatically using the latest solution
+    # version, specify the following:
+    #
+    # * For the `SolutionVersionArn` parameter, specify the Amazon Resource
+    #   Name (ARN) of your solution in `SolutionArn/$LATEST` format.
+    #
+    # * In the `campaignConfig`, set `syncWithLatestSolutionVersion` to
+    #   `true`.
     #
     # To update a campaign, the campaign status must be ACTIVE or CREATE
     # FAILED. Check the campaign status using the [DescribeCampaign][1]
@@ -4210,7 +4322,22 @@ module Aws::Personalize
     #   The Amazon Resource Name (ARN) of the campaign.
     #
     # @option params [String] :solution_version_arn
-    #   The ARN of a new solution version to deploy.
+    #   The Amazon Resource Name (ARN) of a new model to deploy. To specify
+    #   the latest solution version of your solution, specify the ARN of your
+    #   *solution* in `SolutionArn/$LATEST` format. You must use this format
+    #   if you set `syncWithLatestSolutionVersion` to `True` in the
+    #   [CampaignConfig][1].
+    #
+    #   To deploy a model that isn't the latest solution version of your
+    #   solution, specify the ARN of the solution version.
+    #
+    #   For more information about automatic campaign updates, see [Enabling
+    #   automatic campaign updates][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html
+    #   [2]: https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update
     #
     # @option params [Integer] :min_provisioned_tps
     #   Specifies the requested minimum provisioned transactions
@@ -4238,6 +4365,7 @@ module Aws::Personalize
     #         "ParameterName" => "ParameterValue",
     #       },
     #       enable_metadata_with_recommendations: false,
+    #       sync_with_latest_solution_version: false,
     #     },
     #   })
     #
@@ -4410,7 +4538,7 @@ module Aws::Personalize
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-personalize'
-      context[:gem_version] = '1.59.0'
+      context[:gem_version] = '1.61.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -20,6 +20,7 @@ module Aws::Personalize
     ArnList = Shapes::ListShape.new(name: 'ArnList')
     AutoMLConfig = Shapes::StructureShape.new(name: 'AutoMLConfig')
     AutoMLResult = Shapes::StructureShape.new(name: 'AutoMLResult')
+    AutoTrainingConfig = Shapes::StructureShape.new(name: 'AutoTrainingConfig')
     AvroSchema = Shapes::StringShape.new(name: 'AvroSchema')
     BatchInferenceJob = Shapes::StructureShape.new(name: 'BatchInferenceJob')
     BatchInferenceJobConfig = Shapes::StructureShape.new(name: 'BatchInferenceJobConfig')
@@ -240,6 +241,7 @@ module Aws::Personalize
     ParameterName = Shapes::StringShape.new(name: 'ParameterName')
     ParameterValue = Shapes::StringShape.new(name: 'ParameterValue')
     PerformAutoML = Shapes::BooleanShape.new(name: 'PerformAutoML')
+    PerformAutoTraining = Shapes::BooleanShape.new(name: 'PerformAutoTraining')
     PerformHPO = Shapes::BooleanShape.new(name: 'PerformHPO')
     Recipe = Shapes::StructureShape.new(name: 'Recipe')
     RecipeProvider = Shapes::StringShape.new(name: 'RecipeProvider')
@@ -258,6 +260,7 @@ module Aws::Personalize
     RoleArn = Shapes::StringShape.new(name: 'RoleArn')
     S3DataConfig = Shapes::StructureShape.new(name: 'S3DataConfig')
     S3Location = Shapes::StringShape.new(name: 'S3Location')
+    SchedulingExpression = Shapes::StringShape.new(name: 'SchedulingExpression')
     Schemas = Shapes::ListShape.new(name: 'Schemas')
     Solution = Shapes::StructureShape.new(name: 'Solution')
     SolutionConfig = Shapes::StructureShape.new(name: 'SolutionConfig')
@@ -287,6 +290,7 @@ module Aws::Personalize
     TrainingHours = Shapes::FloatShape.new(name: 'TrainingHours')
     TrainingInputMode = Shapes::StringShape.new(name: 'TrainingInputMode')
     TrainingMode = Shapes::StringShape.new(name: 'TrainingMode')
+    TrainingType = Shapes::StringShape.new(name: 'TrainingType')
     TransactionsPerSecond = Shapes::IntegerShape.new(name: 'TransactionsPerSecond')
     Tunable = Shapes::BooleanShape.new(name: 'Tunable')
     TunedHPOParams = Shapes::StructureShape.new(name: 'TunedHPOParams')
@@ -326,6 +330,9 @@ module Aws::Personalize
     AutoMLResult.add_member(:best_recipe_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "bestRecipeArn"))
     AutoMLResult.struct_class = Types::AutoMLResult
 
+    AutoTrainingConfig.add_member(:scheduling_expression, Shapes::ShapeRef.new(shape: SchedulingExpression, location_name: "schedulingExpression"))
+    AutoTrainingConfig.struct_class = Types::AutoTrainingConfig
+
     BatchInferenceJob.add_member(:job_name, Shapes::ShapeRef.new(shape: Name, location_name: "jobName"))
     BatchInferenceJob.add_member(:batch_inference_job_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "batchInferenceJobArn"))
     BatchInferenceJob.add_member(:filter_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "filterArn"))
@@ -409,6 +416,7 @@ module Aws::Personalize
 
     CampaignConfig.add_member(:item_exploration_config, Shapes::ShapeRef.new(shape: HyperParameters, location_name: "itemExplorationConfig"))
     CampaignConfig.add_member(:enable_metadata_with_recommendations, Shapes::ShapeRef.new(shape: Boolean, location_name: "enableMetadataWithRecommendations"))
+    CampaignConfig.add_member(:sync_with_latest_solution_version, Shapes::ShapeRef.new(shape: Boolean, location_name: "syncWithLatestSolutionVersion"))
     CampaignConfig.struct_class = Types::CampaignConfig
 
     CampaignSummary.add_member(:name, Shapes::ShapeRef.new(shape: Name, location_name: "name"))
@@ -578,6 +586,7 @@ module Aws::Personalize
     CreateSolutionRequest.add_member(:name, Shapes::ShapeRef.new(shape: Name, required: true, location_name: "name"))
     CreateSolutionRequest.add_member(:perform_hpo, Shapes::ShapeRef.new(shape: Boolean, location_name: "performHPO"))
     CreateSolutionRequest.add_member(:perform_auto_ml, Shapes::ShapeRef.new(shape: PerformAutoML, location_name: "performAutoML"))
+    CreateSolutionRequest.add_member(:perform_auto_training, Shapes::ShapeRef.new(shape: PerformAutoTraining, location_name: "performAutoTraining"))
     CreateSolutionRequest.add_member(:recipe_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "recipeArn"))
     CreateSolutionRequest.add_member(:dataset_group_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "datasetGroupArn"))
     CreateSolutionRequest.add_member(:event_type, Shapes::ShapeRef.new(shape: EventType, location_name: "eventType"))
@@ -1247,6 +1256,7 @@ module Aws::Personalize
     Solution.add_member(:solution_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "solutionArn"))
     Solution.add_member(:perform_hpo, Shapes::ShapeRef.new(shape: PerformHPO, location_name: "performHPO"))
     Solution.add_member(:perform_auto_ml, Shapes::ShapeRef.new(shape: PerformAutoML, location_name: "performAutoML"))
+    Solution.add_member(:perform_auto_training, Shapes::ShapeRef.new(shape: PerformAutoTraining, location_name: "performAutoTraining"))
     Solution.add_member(:recipe_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "recipeArn"))
     Solution.add_member(:dataset_group_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "datasetGroupArn"))
     Solution.add_member(:event_type, Shapes::ShapeRef.new(shape: EventType, location_name: "eventType"))
@@ -1265,6 +1275,7 @@ module Aws::Personalize
     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.add_member(:auto_training_config, Shapes::ShapeRef.new(shape: AutoTrainingConfig, location_name: "autoTrainingConfig"))
     SolutionConfig.struct_class = Types::SolutionConfig
 
     SolutionSummary.add_member(:name, Shapes::ShapeRef.new(shape: Name, location_name: "name"))
@@ -1291,10 +1302,13 @@ module Aws::Personalize
     SolutionVersion.add_member(:failure_reason, Shapes::ShapeRef.new(shape: FailureReason, location_name: "failureReason"))
     SolutionVersion.add_member(:creation_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "creationDateTime"))
     SolutionVersion.add_member(:last_updated_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "lastUpdatedDateTime"))
+    SolutionVersion.add_member(:training_type, Shapes::ShapeRef.new(shape: TrainingType, location_name: "trainingType"))
     SolutionVersion.struct_class = Types::SolutionVersion
 
     SolutionVersionSummary.add_member(:solution_version_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "solutionVersionArn"))
     SolutionVersionSummary.add_member(:status, Shapes::ShapeRef.new(shape: Status, location_name: "status"))
+    SolutionVersionSummary.add_member(:training_mode, Shapes::ShapeRef.new(shape: TrainingMode, location_name: "trainingMode"))
+    SolutionVersionSummary.add_member(:training_type, Shapes::ShapeRef.new(shape: TrainingType, location_name: "trainingType"))
     SolutionVersionSummary.add_member(:creation_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "creationDateTime"))
     SolutionVersionSummary.add_member(:last_updated_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "lastUpdatedDateTime"))
     SolutionVersionSummary.add_member(:failure_reason, Shapes::ShapeRef.new(shape: FailureReason, location_name: "failureReason"))

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

@@ -138,6 +138,32 @@ module Aws::Personalize
       include Aws::Structure
     end
 
+    # The automatic training configuration to use when `performAutoTraining`
+    # is true.
+    #
+    # @!attribute [rw] scheduling_expression
+    #   Specifies how often to automatically train new solution versions.
+    #   Specify a rate expression in rate(*value* *unit*) format. For value,
+    #   specify a number between 1 and 30. For unit, specify `day` or
+    #   `days`. For example, to automatically create a new solution version
+    #   every 5 days, specify `rate(5 days)`. The default is every 7 days.
+    #
+    #   For more information about auto training, see [Creating and
+    #   configuring a solution][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/AutoTrainingConfig AWS API Documentation
+    #
+    class AutoTrainingConfig < Struct.new(
+      :scheduling_expression)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains information on a batch inference job.
     #
     # @!attribute [rw] job_name
@@ -545,8 +571,8 @@ module Aws::Personalize
     #   @return [String]
     #
     # @!attribute [rw] solution_version_arn
-    #   The Amazon Resource Name (ARN) of a specific version of the
-    #   solution.
+    #   The Amazon Resource Name (ARN) of the solution version the campaign
+    #   uses.
     #   @return [String]
     #
     # @!attribute [rw] min_provisioned_tps
@@ -643,11 +669,28 @@ module Aws::Personalize
     #   [2]: https://aws.amazon.com/personalize/pricing/
     #   @return [Boolean]
     #
+    # @!attribute [rw] sync_with_latest_solution_version
+    #   Whether the campaign automatically updates to use the latest
+    #   solution version (trained model) of a solution. If you specify
+    #   `True`, you must specify the ARN of your *solution* for the
+    #   `SolutionVersionArn` parameter. It must be in `SolutionArn/$LATEST`
+    #   format. The default is `False` and you must manually update the
+    #   campaign to deploy the latest solution version.
+    #
+    #   For more information about automatic campaign updates, see [Enabling
+    #   automatic campaign updates][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CampaignConfig AWS API Documentation
     #
     class CampaignConfig < Struct.new(
       :item_exploration_config,
-      :enable_metadata_with_recommendations)
+      :enable_metadata_with_recommendations,
+      :sync_with_latest_solution_version)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -988,7 +1031,23 @@ module Aws::Personalize
     #   @return [String]
     #
     # @!attribute [rw] solution_version_arn
-    #   The Amazon Resource Name (ARN) of the solution version to deploy.
+    #   The Amazon Resource Name (ARN) of the trained model to deploy with
+    #   the campaign. To specify the latest solution version of your
+    #   solution, specify the ARN of your *solution* in
+    #   `SolutionArn/$LATEST` format. You must use this format if you set
+    #   `syncWithLatestSolutionVersion` to `True` in the
+    #   [CampaignConfig][1].
+    #
+    #   To deploy a model that isn't the latest solution version of your
+    #   solution, specify the ARN of the solution version.
+    #
+    #   For more information about automatic campaign updates, see [Enabling
+    #   automatic campaign updates][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html
+    #   [2]: https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update
     #   @return [String]
     #
     # @!attribute [rw] min_provisioned_tps
@@ -1554,6 +1613,30 @@ module Aws::Personalize
     #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html
     #   @return [Boolean]
     #
+    # @!attribute [rw] perform_auto_training
+    #   Whether the solution uses automatic training to create new solution
+    #   versions (trained models). The default is `True` and the solution
+    #   automatically creates new solution versions every 7 days. You can
+    #   change the training frequency by specifying a `schedulingExpression`
+    #   in the `AutoTrainingConfig` as part of solution configuration. For
+    #   more information about automatic training, see [Configuring
+    #   automatic training][1].
+    #
+    #   Automatic solution version creation starts one hour after the
+    #   solution is ACTIVE. If you manually create a solution version within
+    #   the hour, the solution skips the first automatic training.
+    #
+    #   After training starts, you can get the solution version's Amazon
+    #   Resource Name (ARN) with the [ListSolutionVersions][2] API
+    #   operation. To get its status, use the [DescribeSolutionVersion][3].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html
+    #   [2]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html
+    #   [3]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html
+    #   @return [Boolean]
+    #
     # @!attribute [rw] recipe_arn
     #   The Amazon Resource Name (ARN) of the recipe to use for model
     #   training. This is required when `performAutoML` is false. For
@@ -1604,6 +1687,7 @@ module Aws::Personalize
       :name,
       :perform_hpo,
       :perform_auto_ml,
+      :perform_auto_training,
       :recipe_arn,
       :dataset_group_arn,
       :event_type,
@@ -4212,7 +4296,7 @@ module Aws::Personalize
     end
 
     # @!attribute [rw] resource_arn
-    #   The resource's Amazon Resource Name.
+    #   The resource's Amazon Resource Name (ARN).
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListTagsForResourceRequest AWS API Documentation
@@ -4850,8 +4934,26 @@ module Aws::Personalize
       include Aws::Structure
     end
 
-    # An object that provides information about a solution. A solution is a
-    # trained model that can be deployed as a campaign.
+    # After you create a solution, you can’t change its configuration. By
+    # default, all new solutions use automatic training. With automatic
+    # training, you incur training costs while your solution is active. You
+    # can't stop automatic training for a solution. To avoid unnecessary
+    # costs, make sure to delete the solution when you are finished. For
+    # information about training costs, see [Amazon Personalize pricing][1].
+    #
+    # An object that provides information about a solution. A solution
+    # includes the custom recipe, customized parameters, and trained models
+    # (Solution Versions) that Amazon Personalize uses to generate
+    # recommendations.
+    #
+    # After you create a solution, you can’t change its configuration. If
+    # you need to make changes, you can [clone the solution][2] with the
+    # Amazon Personalize console or create a new one.
+    #
+    #
+    #
+    # [1]: https://aws.amazon.com/personalize/pricing/
+    # [2]: https://docs.aws.amazon.com/personalize/latest/dg/cloning-solution.html
     #
     # @!attribute [rw] name
     #   The name of the solution.
@@ -4881,6 +4983,19 @@ module Aws::Personalize
     #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/determining-use-case.html
     #   @return [Boolean]
     #
+    # @!attribute [rw] perform_auto_training
+    #   Specifies whether the solution automatically creates solution
+    #   versions. The default is `True` and the solution automatically
+    #   creates new solution versions every 7 days.
+    #
+    #   For more information about auto training, see [Creating and
+    #   configuring a solution][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html
+    #   @return [Boolean]
+    #
     # @!attribute [rw] recipe_arn
     #   The ARN of the recipe used to create the solution. This is required
     #   when `performAutoML` is false.
@@ -4937,6 +5052,7 @@ module Aws::Personalize
       :solution_arn,
       :perform_hpo,
       :perform_auto_ml,
+      :perform_auto_training,
       :recipe_arn,
       :dataset_group_arn,
       :event_type,
@@ -4993,6 +5109,10 @@ module Aws::Personalize
     #   custom solution version (trained model).
     #   @return [Types::TrainingDataConfig]
     #
+    # @!attribute [rw] auto_training_config
+    #   Specifies the automatic training configuration to use.
+    #   @return [Types::AutoTrainingConfig]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/SolutionConfig AWS API Documentation
     #
     class SolutionConfig < Struct.new(
@@ -5002,7 +5122,8 @@ module Aws::Personalize
       :feature_transformation_parameters,
       :auto_ml_config,
       :optimization_objective,
-      :training_data_config)
+      :training_data_config,
+      :auto_training_config)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -5114,22 +5235,10 @@ module Aws::Personalize
     #
     # @!attribute [rw] training_mode
     #   The scope of training to be performed when creating the solution
-    #   version. The `FULL` option trains the solution version based on the
-    #   entirety of the input solution's training data, while the `UPDATE`
-    #   option processes only the data that has changed in comparison to the
-    #   input solution. Choose `UPDATE` when you want to incrementally
-    #   update your solution version instead of creating an entirely new
-    #   one.
-    #
-    #   The `UPDATE` option can only be used when you already have an active
-    #   solution version created from the input solution using the `FULL`
-    #   option and the input solution was trained with the
-    #   [User-Personalization][1] recipe or the [HRNN-Coldstart][2] recipe.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html
-    #   [2]: https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-hrnn-coldstart.html
+    #   version. A `FULL` training considers all of the data in your dataset
+    #   group. An `UPDATE` processes only the data that has changed since
+    #   the latest training. Only solution versions created with the
+    #   User-Personalization recipe can use `UPDATE`.
     #   @return [String]
     #
     # @!attribute [rw] tuned_hpo_params
@@ -5168,6 +5277,10 @@ module Aws::Personalize
     #   The date and time (in Unix time) that the solution was last updated.
     #   @return [Time]
     #
+    # @!attribute [rw] training_type
+    #   Whether the solution version was created automatically or manually.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/SolutionVersion AWS API Documentation
     #
     class SolutionVersion < Struct.new(
@@ -5186,7 +5299,8 @@ module Aws::Personalize
       :status,
       :failure_reason,
       :creation_date_time,
-      :last_updated_date_time)
+      :last_updated_date_time,
+      :training_type)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -5213,6 +5327,18 @@ module Aws::Personalize
     #   ^
     #   @return [String]
     #
+    # @!attribute [rw] training_mode
+    #   The scope of training to be performed when creating the solution
+    #   version. A `FULL` training considers all of the data in your dataset
+    #   group. An `UPDATE` processes only the data that has changed since
+    #   the latest training. Only solution versions created with the
+    #   User-Personalization recipe can use `UPDATE`.
+    #   @return [String]
+    #
+    # @!attribute [rw] training_type
+    #   Whether the solution version was created automatically or manually.
+    #   @return [String]
+    #
     # @!attribute [rw] creation_date_time
     #   The date and time (in Unix time) that this version of a solution was
     #   created.
@@ -5232,6 +5358,8 @@ module Aws::Personalize
     class SolutionVersionSummary < Struct.new(
       :solution_version_arn,
       :status,
+      :training_mode,
+      :training_type,
       :creation_date_time,
       :last_updated_date_time,
       :failure_reason)
@@ -5303,7 +5431,7 @@ 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 Amazon Personalize recources][1].
+    # [Tagging Amazon Personalize resources][1].
     #
     #
     #
@@ -5334,7 +5462,7 @@ module Aws::Personalize
     #
     # @!attribute [rw] tags
     #   Tags to apply to the resource. For more information see [Tagging
-    #   Amazon Personalize recources][1].
+    #   Amazon Personalize resources][1].
     #
     #
     #
@@ -5405,10 +5533,11 @@ module Aws::Personalize
     #   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.
+    #   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
@@ -5439,7 +5568,7 @@ module Aws::Personalize
     #   @return [String]
     #
     # @!attribute [rw] tag_keys
-    #   Keys to remove from the resource's tags.
+    #   The keys of the tags to be removed.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/UntagResourceRequest AWS API Documentation
@@ -5460,7 +5589,22 @@ module Aws::Personalize
     #   @return [String]
     #
     # @!attribute [rw] solution_version_arn
-    #   The ARN of a new solution version to deploy.
+    #   The Amazon Resource Name (ARN) of a new model to deploy. To specify
+    #   the latest solution version of your solution, specify the ARN of
+    #   your *solution* in `SolutionArn/$LATEST` format. You must use this
+    #   format if you set `syncWithLatestSolutionVersion` to `True` in the
+    #   [CampaignConfig][1].
+    #
+    #   To deploy a model that isn't the latest solution version of your
+    #   solution, specify the ARN of the solution version.
+    #
+    #   For more information about automatic campaign updates, see [Enabling
+    #   automatic campaign updates][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html
+    #   [2]: https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update
     #   @return [String]
     #
     # @!attribute [rw] min_provisioned_tps

data/lib/aws-sdk-personalize.rb

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

data/sig/client.rbs

@@ -157,7 +157,8 @@ module Aws
                              ?min_provisioned_tps: ::Integer,
                              ?campaign_config: {
                                item_exploration_config: Hash[::String, ::String]?,
-                               enable_metadata_with_recommendations: bool?
+                               enable_metadata_with_recommendations: bool?,
+                               sync_with_latest_solution_version: bool?
                              },
                              ?tags: Array[
                                {
@@ -363,6 +364,7 @@ module Aws
                              name: ::String,
                              ?perform_hpo: bool,
                              ?perform_auto_ml: bool,
+                             ?perform_auto_training: bool,
                              ?recipe_arn: ::String,
                              dataset_group_arn: ::String,
                              ?event_type: ::String,
@@ -413,6 +415,9 @@ module Aws
                                }?,
                                training_data_config: {
                                  excluded_dataset_columns: Hash[::String, Array[::String]]?
+                               }?,
+                               auto_training_config: {
+                                 scheduling_expression: ::String?
                                }?
                              },
                              ?tags: Array[
@@ -432,7 +437,7 @@ module Aws
       def create_solution_version: (
                                      ?name: ::String,
                                      solution_arn: ::String,
-                                     ?training_mode: ("FULL" | "UPDATE"),
+                                     ?training_mode: ("FULL" | "UPDATE" | "AUTOTRAIN"),
                                      ?tags: Array[
                                        {
                                          tag_key: ::String,
@@ -956,7 +961,8 @@ module Aws
                              ?min_provisioned_tps: ::Integer,
                              ?campaign_config: {
                                item_exploration_config: Hash[::String, ::String]?,
-                               enable_metadata_with_recommendations: bool?
+                               enable_metadata_with_recommendations: bool?,
+                               sync_with_latest_solution_version: bool?
                              }
                            ) -> _UpdateCampaignResponseSuccess
                          | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateCampaignResponseSuccess

data/sig/types.rbs

@@ -39,6 +39,11 @@ module Aws::Personalize
       SENSITIVE: []
     end
 
+    class AutoTrainingConfig
+      attr_accessor scheduling_expression: ::String
+      SENSITIVE: []
+    end
+
     class BatchInferenceJob
       attr_accessor job_name: ::String
       attr_accessor batch_inference_job_arn: ::String
@@ -139,6 +144,7 @@ module Aws::Personalize
     class CampaignConfig
       attr_accessor item_exploration_config: ::Hash[::String, ::String]
       attr_accessor enable_metadata_with_recommendations: bool
+      attr_accessor sync_with_latest_solution_version: bool
       SENSITIVE: []
     end
 
@@ -356,6 +362,7 @@ module Aws::Personalize
       attr_accessor name: ::String
       attr_accessor perform_hpo: bool
       attr_accessor perform_auto_ml: bool
+      attr_accessor perform_auto_training: bool
       attr_accessor recipe_arn: ::String
       attr_accessor dataset_group_arn: ::String
       attr_accessor event_type: ::String
@@ -372,7 +379,7 @@ module Aws::Personalize
     class CreateSolutionVersionRequest
       attr_accessor name: ::String
       attr_accessor solution_arn: ::String
-      attr_accessor training_mode: ("FULL" | "UPDATE")
+      attr_accessor training_mode: ("FULL" | "UPDATE" | "AUTOTRAIN")
       attr_accessor tags: ::Array[Types::Tag]
       SENSITIVE: []
     end
@@ -1233,6 +1240,7 @@ module Aws::Personalize
       attr_accessor solution_arn: ::String
       attr_accessor perform_hpo: bool
       attr_accessor perform_auto_ml: bool
+      attr_accessor perform_auto_training: bool
       attr_accessor recipe_arn: ::String
       attr_accessor dataset_group_arn: ::String
       attr_accessor event_type: ::String
@@ -1253,6 +1261,7 @@ module Aws::Personalize
       attr_accessor auto_ml_config: Types::AutoMLConfig
       attr_accessor optimization_objective: Types::OptimizationObjective
       attr_accessor training_data_config: Types::TrainingDataConfig
+      attr_accessor auto_training_config: Types::AutoTrainingConfig
       SENSITIVE: []
     end
 
@@ -1277,18 +1286,21 @@ module Aws::Personalize
       attr_accessor dataset_group_arn: ::String
       attr_accessor solution_config: Types::SolutionConfig
       attr_accessor training_hours: ::Float
-      attr_accessor training_mode: ("FULL" | "UPDATE")
+      attr_accessor training_mode: ("FULL" | "UPDATE" | "AUTOTRAIN")
       attr_accessor tuned_hpo_params: Types::TunedHPOParams
       attr_accessor status: ::String
       attr_accessor failure_reason: ::String
       attr_accessor creation_date_time: ::Time
       attr_accessor last_updated_date_time: ::Time
+      attr_accessor training_type: ("AUTOMATIC" | "MANUAL")
       SENSITIVE: []
     end
 
     class SolutionVersionSummary
       attr_accessor solution_version_arn: ::String
       attr_accessor status: ::String
+      attr_accessor training_mode: ("FULL" | "UPDATE" | "AUTOTRAIN")
+      attr_accessor training_type: ("AUTOMATIC" | "MANUAL")
       attr_accessor creation_date_time: ::Time
       attr_accessor last_updated_date_time: ::Time
       attr_accessor failure_reason: ::String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-personalize
 version: !ruby/object:Gem::Version
-  version: 1.59.0
+  version: 1.61.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-26 00:00:00.000000000 Z
+date: 2024-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.191.0
+        version: 3.193.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.191.0
+        version: 3.193.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement