aws-sdk-personalize 1.68.0 → 1.69.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 4cec660f5231b3c83c21333b117d6ee579e26e9ee1af74af40dfc26d862d093c
4
- data.tar.gz: 2a1a87732677cf5b1f1932f0e7dd3809f2917410d17d7b58442cdb19d860813b
3
+ metadata.gz: b4b5d244aa097f6f5470e5baded9caad98e8f79bb95aa2602b3cccd5340c20ef
4
+ data.tar.gz: 9245af4cd2c070df1a0295769ca172b383e1942c5b0d14d2c9cc99ccb96f989f
5
5
  SHA512:
6
- metadata.gz: 8fe7c9f7f5bf99e5e8dd316cdd97a8c9138d0ef7caa0def9ea4e6a8ded5c9bbcc4943245f3a0738552d06e8e9069a5c650c696f6beff6f333154f12fcf877f54
7
- data.tar.gz: ce589405b84ca6cb50c235f763e2cba1964a8f92b7571b3b85a8a08f16c87d2bd2177ba0ffedb635ea6ed33b946a4e4a34d009351068204e03836a440182a7c7
6
+ metadata.gz: a1be820aa56a310c5b332c6521350abf9c9ec92231877298e2fdbd7cd1611862954aae5f8e3718eeaadf5679afe4c6f33b218b40824feed1d252b6c82290900f
7
+ data.tar.gz: 564ce80dfaa7dd3ac0f0b03c1fc8d95ec0e2b18831e2936f6c3530373cdf5a8d0d7d4bc5309c5577e968d731a1b99082829245596a10f84471eace8289e331ef
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.69.0 (2024-08-29)
5
+ ------------------
6
+
7
+ * Feature - This releases ability to update automatic training scheduler for customer solutions
8
+
4
9
  1.68.0 (2024-07-02)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.68.0
1
+ 1.69.0
@@ -1817,40 +1817,39 @@ module Aws::Personalize
1817
1817
  req.send_request(options)
1818
1818
  end
1819
1819
 
1820
- # After you create a solution, you can’t change its configuration. By
1821
- # default, all new solutions use automatic training. With automatic
1822
- # training, you incur training costs while your solution is active. You
1823
- # can't stop automatic training for a solution. To avoid unnecessary
1824
- # costs, make sure to delete the solution when you are finished. For
1825
- # information about training costs, see [Amazon Personalize pricing][1].
1820
+ # By default, all new solutions use automatic training. With automatic
1821
+ # training, you incur training costs while your solution is active. To
1822
+ # avoid unnecessary costs, when you are finished you can [update the
1823
+ # solution][1] to turn off automatic training. For information about
1824
+ # training costs, see [Amazon Personalize pricing][2].
1826
1825
  #
1827
1826
  # Creates the configuration for training a model (creating a solution
1828
1827
  # version). This configuration includes the recipe to use for model
1829
1828
  # training and optional training configuration, such as columns to use
1830
1829
  # in training and feature transformation parameters. For more
1831
1830
  # information about configuring a solution, see [Creating and
1832
- # configuring a solution][2].
1831
+ # configuring a solution][3].
1833
1832
  #
1834
1833
  # By default, new solutions use automatic training to create solution
1835
1834
  # versions every 7 days. You can change the training frequency.
1836
- # Automatic solution version creation starts one hour after the solution
1837
- # is ACTIVE. If you manually create a solution version within the hour,
1838
- # the solution skips the first automatic training. For more information,
1839
- # see [Configuring automatic training][3].
1835
+ # Automatic solution version creation starts within one hour after the
1836
+ # solution is ACTIVE. If you manually create a solution version within
1837
+ # the hour, the solution skips the first automatic training. For more
1838
+ # information, see [Configuring automatic training][4].
1840
1839
  #
1841
1840
  # To turn off automatic training, set `performAutoTraining` to false. If
1842
1841
  # you turn off automatic training, you must manually create a solution
1843
- # version by calling the [CreateSolutionVersion][4] operation.
1842
+ # version by calling the [CreateSolutionVersion][5] operation.
1844
1843
  #
1845
1844
  # After training starts, you can get the solution version's Amazon
1846
- # Resource Name (ARN) with the [ListSolutionVersions][5] API operation.
1847
- # To get its status, use the [DescribeSolutionVersion][6].
1845
+ # Resource Name (ARN) with the [ListSolutionVersions][6] API operation.
1846
+ # To get its status, use the [DescribeSolutionVersion][7].
1848
1847
  #
1849
1848
  # After training completes you can evaluate model accuracy by calling
1850
- # [GetSolutionMetrics][7]. When you are satisfied with the solution
1851
- # version, you deploy it using [CreateCampaign][8]. The campaign
1849
+ # [GetSolutionMetrics][8]. When you are satisfied with the solution
1850
+ # version, you deploy it using [CreateCampaign][9]. The campaign
1852
1851
  # provides recommendations to a client through the
1853
- # [GetRecommendations][9] API.
1852
+ # [GetRecommendations][10] API.
1854
1853
  #
1855
1854
  # <note markdown="1"> Amazon Personalize doesn't support configuring the `hpoObjective` for
1856
1855
  # solution hyperparameter optimization at this time.
@@ -1866,39 +1865,42 @@ module Aws::Personalize
1866
1865
  #
1867
1866
  # * DELETE PENDING &gt; DELETE IN\_PROGRESS
1868
1867
  #
1869
- # To get the status of the solution, call [DescribeSolution][10]. If you
1868
+ # To get the status of the solution, call [DescribeSolution][11]. If you
1870
1869
  # use manual training, the status must be ACTIVE before you call
1871
1870
  # `CreateSolutionVersion`.
1872
1871
  #
1873
1872
  # **Related APIs**
1874
1873
  #
1875
- # * [ListSolutions][11]
1874
+ # * [UpdateSolution][1]
1876
1875
  #
1877
- # * [CreateSolutionVersion][4]
1876
+ # * [ListSolutions][12]
1878
1877
  #
1879
- # * [DescribeSolution][10]
1878
+ # * [CreateSolutionVersion][5]
1880
1879
  #
1881
- # * [DeleteSolution][12]
1880
+ # * [DescribeSolution][11]
1881
+ #
1882
+ # * [DeleteSolution][13]
1882
1883
  # ^
1883
1884
  #
1884
- # * [ListSolutionVersions][5]
1885
+ # * [ListSolutionVersions][6]
1885
1886
  #
1886
- # * [DescribeSolutionVersion][6]
1887
+ # * [DescribeSolutionVersion][7]
1887
1888
  #
1888
1889
  #
1889
1890
  #
1890
- # [1]: https://aws.amazon.com/personalize/pricing/
1891
- # [2]: https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html
1892
- # [3]: https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html
1893
- # [4]: https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html
1894
- # [5]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html
1895
- # [6]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html
1896
- # [7]: https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html
1897
- # [8]: https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html
1898
- # [9]: https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html
1899
- # [10]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html
1900
- # [11]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html
1901
- # [12]: https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html
1891
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html
1892
+ # [2]: https://aws.amazon.com/personalize/pricing/
1893
+ # [3]: https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html
1894
+ # [4]: https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html
1895
+ # [5]: https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html
1896
+ # [6]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html
1897
+ # [7]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html
1898
+ # [8]: https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html
1899
+ # [9]: https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html
1900
+ # [10]: https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html
1901
+ # [11]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html
1902
+ # [12]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html
1903
+ # [13]: https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html
1902
1904
  #
1903
1905
  # @option params [required, String] :name
1904
1906
  # The name for the solution.
@@ -1938,9 +1940,9 @@ module Aws::Personalize
1938
1940
  # more information about automatic training, see [Configuring automatic
1939
1941
  # training][1].
1940
1942
  #
1941
- # Automatic solution version creation starts one hour after the solution
1942
- # is ACTIVE. If you manually create a solution version within the hour,
1943
- # the solution skips the first automatic training.
1943
+ # Automatic solution version creation starts within one hour after the
1944
+ # solution is ACTIVE. If you manually create a solution version within
1945
+ # the hour, the solution skips the first automatic training.
1944
1946
  #
1945
1947
  # After training starts, you can get the solution version's Amazon
1946
1948
  # Resource Name (ARN) with the [ListSolutionVersions][2] API operation.
@@ -1975,7 +1977,7 @@ module Aws::Personalize
1975
1977
  # interactions for training with equal weight regardless of type.
1976
1978
  #
1977
1979
  # @option params [Types::SolutionConfig] :solution_config
1978
- # The configuration to use with the solution. When `performAutoML` is
1980
+ # The configuration properties for the solution. When `performAutoML` is
1979
1981
  # set to true, Amazon Personalize only evaluates the `autoMLConfig`
1980
1982
  # section of the solution configuration.
1981
1983
  #
@@ -3271,6 +3273,12 @@ module Aws::Personalize
3271
3273
  # resp.solution.latest_solution_version.creation_date_time #=> Time
3272
3274
  # resp.solution.latest_solution_version.last_updated_date_time #=> Time
3273
3275
  # resp.solution.latest_solution_version.failure_reason #=> String
3276
+ # resp.solution.latest_solution_update.solution_update_config.auto_training_config.scheduling_expression #=> String
3277
+ # resp.solution.latest_solution_update.status #=> String
3278
+ # resp.solution.latest_solution_update.perform_auto_training #=> Boolean
3279
+ # resp.solution.latest_solution_update.creation_date_time #=> Time
3280
+ # resp.solution.latest_solution_update.last_updated_date_time #=> Time
3281
+ # resp.solution.latest_solution_update.failure_reason #=> String
3274
3282
  #
3275
3283
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeSolution AWS API Documentation
3276
3284
  #
@@ -4743,6 +4751,81 @@ module Aws::Personalize
4743
4751
  req.send_request(options)
4744
4752
  end
4745
4753
 
4754
+ # Updates an Amazon Personalize solution to use a different automatic
4755
+ # training configuration. When you update a solution, you can change
4756
+ # whether the solution uses automatic training, and you can change the
4757
+ # training frequency. For more information about updating a solution,
4758
+ # see [Updating a solution][1].
4759
+ #
4760
+ # A solution update can be in one of the following states:
4761
+ #
4762
+ # CREATE PENDING &gt; CREATE IN\_PROGRESS &gt; ACTIVE -or- CREATE FAILED
4763
+ #
4764
+ # To get the status of a solution update, call the [DescribeSolution][2]
4765
+ # API operation and find the status in the `latestSolutionUpdate`.
4766
+ #
4767
+ #
4768
+ #
4769
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/updating-solution.html
4770
+ # [2]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html
4771
+ #
4772
+ # @option params [required, String] :solution_arn
4773
+ # The Amazon Resource Name (ARN) of the solution to update.
4774
+ #
4775
+ # @option params [Boolean] :perform_auto_training
4776
+ # Whether the solution uses automatic training to create new solution
4777
+ # versions (trained models). You can change the training frequency by
4778
+ # specifying a `schedulingExpression` in the `AutoTrainingConfig` as
4779
+ # part of solution configuration.
4780
+ #
4781
+ # If you turn on automatic training, the first automatic training starts
4782
+ # within one hour after the solution update completes. If you manually
4783
+ # create a solution version within the hour, the solution skips the
4784
+ # first automatic training. For more information about automatic
4785
+ # training, see [Configuring automatic training][1].
4786
+ #
4787
+ # After training starts, you can get the solution version's Amazon
4788
+ # Resource Name (ARN) with the [ListSolutionVersions][2] API operation.
4789
+ # To get its status, use the [DescribeSolutionVersion][3].
4790
+ #
4791
+ #
4792
+ #
4793
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html
4794
+ # [2]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html
4795
+ # [3]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html
4796
+ #
4797
+ # @option params [Types::SolutionUpdateConfig] :solution_update_config
4798
+ # The new configuration details of the solution.
4799
+ #
4800
+ # @return [Types::UpdateSolutionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4801
+ #
4802
+ # * {Types::UpdateSolutionResponse#solution_arn #solution_arn} => String
4803
+ #
4804
+ # @example Request syntax with placeholder values
4805
+ #
4806
+ # resp = client.update_solution({
4807
+ # solution_arn: "Arn", # required
4808
+ # perform_auto_training: false,
4809
+ # solution_update_config: {
4810
+ # auto_training_config: {
4811
+ # scheduling_expression: "SchedulingExpression",
4812
+ # },
4813
+ # },
4814
+ # })
4815
+ #
4816
+ # @example Response structure
4817
+ #
4818
+ # resp.solution_arn #=> String
4819
+ #
4820
+ # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/UpdateSolution AWS API Documentation
4821
+ #
4822
+ # @overload update_solution(params = {})
4823
+ # @param [Hash] params ({})
4824
+ def update_solution(params = {}, options = {})
4825
+ req = build_request(:update_solution, params)
4826
+ req.send_request(options)
4827
+ end
4828
+
4746
4829
  # @!endgroup
4747
4830
 
4748
4831
  # @param params ({})
@@ -4756,7 +4839,7 @@ module Aws::Personalize
4756
4839
  params: params,
4757
4840
  config: config)
4758
4841
  context[:gem_name] = 'aws-sdk-personalize'
4759
- context[:gem_version] = '1.68.0'
4842
+ context[:gem_version] = '1.69.0'
4760
4843
  Seahorse::Client::Request.new(handlers, context)
4761
4844
  end
4762
4845
 
@@ -275,6 +275,8 @@ module Aws::Personalize
275
275
  Solution = Shapes::StructureShape.new(name: 'Solution')
276
276
  SolutionConfig = Shapes::StructureShape.new(name: 'SolutionConfig')
277
277
  SolutionSummary = Shapes::StructureShape.new(name: 'SolutionSummary')
278
+ SolutionUpdateConfig = Shapes::StructureShape.new(name: 'SolutionUpdateConfig')
279
+ SolutionUpdateSummary = Shapes::StructureShape.new(name: 'SolutionUpdateSummary')
278
280
  SolutionVersion = Shapes::StructureShape.new(name: 'SolutionVersion')
279
281
  SolutionVersionSummary = Shapes::StructureShape.new(name: 'SolutionVersionSummary')
280
282
  SolutionVersions = Shapes::ListShape.new(name: 'SolutionVersions')
@@ -314,6 +316,8 @@ module Aws::Personalize
314
316
  UpdateMetricAttributionResponse = Shapes::StructureShape.new(name: 'UpdateMetricAttributionResponse')
315
317
  UpdateRecommenderRequest = Shapes::StructureShape.new(name: 'UpdateRecommenderRequest')
316
318
  UpdateRecommenderResponse = Shapes::StructureShape.new(name: 'UpdateRecommenderResponse')
319
+ UpdateSolutionRequest = Shapes::StructureShape.new(name: 'UpdateSolutionRequest')
320
+ UpdateSolutionResponse = Shapes::StructureShape.new(name: 'UpdateSolutionResponse')
317
321
 
318
322
  Algorithm.add_member(:name, Shapes::ShapeRef.new(shape: Name, location_name: "name"))
319
323
  Algorithm.add_member(:algorithm_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "algorithmArn"))
@@ -1324,6 +1328,7 @@ module Aws::Personalize
1324
1328
  Solution.add_member(:creation_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "creationDateTime"))
1325
1329
  Solution.add_member(:last_updated_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "lastUpdatedDateTime"))
1326
1330
  Solution.add_member(:latest_solution_version, Shapes::ShapeRef.new(shape: SolutionVersionSummary, location_name: "latestSolutionVersion"))
1331
+ Solution.add_member(:latest_solution_update, Shapes::ShapeRef.new(shape: SolutionUpdateSummary, location_name: "latestSolutionUpdate"))
1327
1332
  Solution.struct_class = Types::Solution
1328
1333
 
1329
1334
  SolutionConfig.add_member(:event_value_threshold, Shapes::ShapeRef.new(shape: EventValueThreshold, location_name: "eventValueThreshold"))
@@ -1344,6 +1349,17 @@ module Aws::Personalize
1344
1349
  SolutionSummary.add_member(:recipe_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "recipeArn"))
1345
1350
  SolutionSummary.struct_class = Types::SolutionSummary
1346
1351
 
1352
+ SolutionUpdateConfig.add_member(:auto_training_config, Shapes::ShapeRef.new(shape: AutoTrainingConfig, location_name: "autoTrainingConfig"))
1353
+ SolutionUpdateConfig.struct_class = Types::SolutionUpdateConfig
1354
+
1355
+ SolutionUpdateSummary.add_member(:solution_update_config, Shapes::ShapeRef.new(shape: SolutionUpdateConfig, location_name: "solutionUpdateConfig"))
1356
+ SolutionUpdateSummary.add_member(:status, Shapes::ShapeRef.new(shape: Status, location_name: "status"))
1357
+ SolutionUpdateSummary.add_member(:perform_auto_training, Shapes::ShapeRef.new(shape: PerformAutoTraining, location_name: "performAutoTraining"))
1358
+ SolutionUpdateSummary.add_member(:creation_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "creationDateTime"))
1359
+ SolutionUpdateSummary.add_member(:last_updated_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "lastUpdatedDateTime"))
1360
+ SolutionUpdateSummary.add_member(:failure_reason, Shapes::ShapeRef.new(shape: FailureReason, location_name: "failureReason"))
1361
+ SolutionUpdateSummary.struct_class = Types::SolutionUpdateSummary
1362
+
1347
1363
  SolutionVersion.add_member(:name, Shapes::ShapeRef.new(shape: Name, location_name: "name"))
1348
1364
  SolutionVersion.add_member(:solution_version_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "solutionVersionArn"))
1349
1365
  SolutionVersion.add_member(:solution_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "solutionArn"))
@@ -1458,6 +1474,14 @@ module Aws::Personalize
1458
1474
  UpdateRecommenderResponse.add_member(:recommender_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "recommenderArn"))
1459
1475
  UpdateRecommenderResponse.struct_class = Types::UpdateRecommenderResponse
1460
1476
 
1477
+ UpdateSolutionRequest.add_member(:solution_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "solutionArn"))
1478
+ UpdateSolutionRequest.add_member(:perform_auto_training, Shapes::ShapeRef.new(shape: PerformAutoTraining, location_name: "performAutoTraining"))
1479
+ UpdateSolutionRequest.add_member(:solution_update_config, Shapes::ShapeRef.new(shape: SolutionUpdateConfig, location_name: "solutionUpdateConfig"))
1480
+ UpdateSolutionRequest.struct_class = Types::UpdateSolutionRequest
1481
+
1482
+ UpdateSolutionResponse.add_member(:solution_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "solutionArn"))
1483
+ UpdateSolutionResponse.struct_class = Types::UpdateSolutionResponse
1484
+
1461
1485
 
1462
1486
  # @api private
1463
1487
  API = Seahorse::Model::Api.new.tap do |api|
@@ -2350,6 +2374,19 @@ module Aws::Personalize
2350
2374
  o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
2351
2375
  o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
2352
2376
  end)
2377
+
2378
+ api.add_operation(:update_solution, Seahorse::Model::Operation.new.tap do |o|
2379
+ o.name = "UpdateSolution"
2380
+ o.http_method = "POST"
2381
+ o.http_request_uri = "/"
2382
+ o.input = Shapes::ShapeRef.new(shape: UpdateSolutionRequest)
2383
+ o.output = Shapes::ShapeRef.new(shape: UpdateSolutionResponse)
2384
+ o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
2385
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
2386
+ o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
2387
+ o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
2388
+ o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
2389
+ end)
2353
2390
  end
2354
2391
 
2355
2392
  end
@@ -992,5 +992,19 @@ module Aws::Personalize
992
992
  end
993
993
  end
994
994
 
995
+ class UpdateSolution
996
+ def self.build(context)
997
+ unless context.config.regional_endpoint
998
+ endpoint = context.config.endpoint.to_s
999
+ end
1000
+ Aws::Personalize::EndpointParameters.new(
1001
+ region: context.config.region,
1002
+ use_dual_stack: context.config.use_dualstack_endpoint,
1003
+ use_fips: context.config.use_fips_endpoint,
1004
+ endpoint: endpoint,
1005
+ )
1006
+ end
1007
+ end
1008
+
995
1009
  end
996
1010
  end
@@ -198,6 +198,8 @@ module Aws::Personalize
198
198
  Aws::Personalize::Endpoints::UpdateMetricAttribution.build(context)
199
199
  when :update_recommender
200
200
  Aws::Personalize::Endpoints::UpdateRecommender.build(context)
201
+ when :update_solution
202
+ Aws::Personalize::Endpoints::UpdateSolution.build(context)
201
203
  end
202
204
  end
203
205
  end
@@ -1673,7 +1673,7 @@ module Aws::Personalize
1673
1673
  # more information about automatic training, see [Configuring
1674
1674
  # automatic training][1].
1675
1675
  #
1676
- # Automatic solution version creation starts one hour after the
1676
+ # Automatic solution version creation starts within one hour after the
1677
1677
  # solution is ACTIVE. If you manually create a solution version within
1678
1678
  # the hour, the solution skips the first automatic training.
1679
1679
  #
@@ -1714,8 +1714,8 @@ module Aws::Personalize
1714
1714
  # @return [String]
1715
1715
  #
1716
1716
  # @!attribute [rw] solution_config
1717
- # The configuration to use with the solution. When `performAutoML` is
1718
- # set to true, Amazon Personalize only evaluates the `autoMLConfig`
1717
+ # The configuration properties for the solution. When `performAutoML`
1718
+ # is set to true, Amazon Personalize only evaluates the `autoMLConfig`
1719
1719
  # section of the solution configuration.
1720
1720
  #
1721
1721
  # <note markdown="1"> Amazon Personalize doesn't support configuring the `hpoObjective`
@@ -5116,17 +5116,11 @@ module Aws::Personalize
5116
5116
  # @return [Time]
5117
5117
  #
5118
5118
  # @!attribute [rw] status
5119
- # The status of the recommender update.
5119
+ # The status of the recommender update. A recommender update can be in
5120
+ # one of the following states:
5120
5121
  #
5121
- # A recommender can be in one of the following states:
5122
- #
5123
- # * CREATE PENDING &gt; CREATE IN\_PROGRESS &gt; ACTIVE -or- CREATE
5124
- # FAILED
5125
- #
5126
- # * STOP PENDING &gt; STOP IN\_PROGRESS &gt; INACTIVE &gt; START
5127
- # PENDING &gt; START IN\_PROGRESS &gt; ACTIVE
5128
- #
5129
- # * DELETE PENDING &gt; DELETE IN\_PROGRESS
5122
+ # CREATE PENDING &gt; CREATE IN\_PROGRESS &gt; ACTIVE -or- CREATE
5123
+ # FAILED
5130
5124
  # @return [String]
5131
5125
  #
5132
5126
  # @!attribute [rw] failure_reason
@@ -5205,12 +5199,11 @@ module Aws::Personalize
5205
5199
  include Aws::Structure
5206
5200
  end
5207
5201
 
5208
- # After you create a solution, you can’t change its configuration. By
5209
- # default, all new solutions use automatic training. With automatic
5210
- # training, you incur training costs while your solution is active. You
5211
- # can't stop automatic training for a solution. To avoid unnecessary
5212
- # costs, make sure to delete the solution when you are finished. For
5213
- # information about training costs, see [Amazon Personalize pricing][1].
5202
+ # By default, all new solutions use automatic training. With automatic
5203
+ # training, you incur training costs while your solution is active. To
5204
+ # avoid unnecessary costs, when you are finished you can [update the
5205
+ # solution][1] to turn off automatic training. For information about
5206
+ # training costs, see [Amazon Personalize pricing][2].
5214
5207
  #
5215
5208
  # An object that provides information about a solution. A solution
5216
5209
  # includes the custom recipe, customized parameters, and trained models
@@ -5218,13 +5211,14 @@ module Aws::Personalize
5218
5211
  # recommendations.
5219
5212
  #
5220
5213
  # After you create a solution, you can’t change its configuration. If
5221
- # you need to make changes, you can [clone the solution][2] with the
5214
+ # you need to make changes, you can [clone the solution][3] with the
5222
5215
  # Amazon Personalize console or create a new one.
5223
5216
  #
5224
5217
  #
5225
5218
  #
5226
- # [1]: https://aws.amazon.com/personalize/pricing/
5227
- # [2]: https://docs.aws.amazon.com/personalize/latest/dg/cloning-solution.html
5219
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html
5220
+ # [2]: https://aws.amazon.com/personalize/pricing/
5221
+ # [3]: https://docs.aws.amazon.com/personalize/latest/dg/cloning-solution.html
5228
5222
  #
5229
5223
  # @!attribute [rw] name
5230
5224
  # The name of the solution.
@@ -5316,6 +5310,10 @@ module Aws::Personalize
5316
5310
  # and the ARN.
5317
5311
  # @return [Types::SolutionVersionSummary]
5318
5312
  #
5313
+ # @!attribute [rw] latest_solution_update
5314
+ # Provides a summary of the latest updates to the solution.
5315
+ # @return [Types::SolutionUpdateSummary]
5316
+ #
5319
5317
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/Solution AWS API Documentation
5320
5318
  #
5321
5319
  class Solution < Struct.new(
@@ -5332,7 +5330,8 @@ module Aws::Personalize
5332
5330
  :status,
5333
5331
  :creation_date_time,
5334
5332
  :last_updated_date_time,
5335
- :latest_solution_version)
5333
+ :latest_solution_version,
5334
+ :latest_solution_update)
5336
5335
  SENSITIVE = []
5337
5336
  include Aws::Structure
5338
5337
  end
@@ -5450,6 +5449,71 @@ module Aws::Personalize
5450
5449
  include Aws::Structure
5451
5450
  end
5452
5451
 
5452
+ # The configuration details of the solution update.
5453
+ #
5454
+ # @!attribute [rw] auto_training_config
5455
+ # The automatic training configuration to use when
5456
+ # `performAutoTraining` is true.
5457
+ # @return [Types::AutoTrainingConfig]
5458
+ #
5459
+ # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/SolutionUpdateConfig AWS API Documentation
5460
+ #
5461
+ class SolutionUpdateConfig < Struct.new(
5462
+ :auto_training_config)
5463
+ SENSITIVE = []
5464
+ include Aws::Structure
5465
+ end
5466
+
5467
+ # Provides a summary of the properties of a solution update. For a
5468
+ # complete listing, call the [DescribeSolution][1] API.
5469
+ #
5470
+ #
5471
+ #
5472
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html
5473
+ #
5474
+ # @!attribute [rw] solution_update_config
5475
+ # The configuration details of the solution.
5476
+ # @return [Types::SolutionUpdateConfig]
5477
+ #
5478
+ # @!attribute [rw] status
5479
+ # The status of the solution update. A solution update can be in one
5480
+ # of the following states:
5481
+ #
5482
+ # CREATE PENDING &gt; CREATE IN\_PROGRESS &gt; ACTIVE -or- CREATE
5483
+ # FAILED
5484
+ # @return [String]
5485
+ #
5486
+ # @!attribute [rw] perform_auto_training
5487
+ # Whether the solution automatically creates solution versions.
5488
+ # @return [Boolean]
5489
+ #
5490
+ # @!attribute [rw] creation_date_time
5491
+ # The date and time (in Unix format) that the solution update was
5492
+ # created.
5493
+ # @return [Time]
5494
+ #
5495
+ # @!attribute [rw] last_updated_date_time
5496
+ # The date and time (in Unix time) that the solution update was last
5497
+ # updated.
5498
+ # @return [Time]
5499
+ #
5500
+ # @!attribute [rw] failure_reason
5501
+ # If a solution update fails, the reason behind the failure.
5502
+ # @return [String]
5503
+ #
5504
+ # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/SolutionUpdateSummary AWS API Documentation
5505
+ #
5506
+ class SolutionUpdateSummary < Struct.new(
5507
+ :solution_update_config,
5508
+ :status,
5509
+ :perform_auto_training,
5510
+ :creation_date_time,
5511
+ :last_updated_date_time,
5512
+ :failure_reason)
5513
+ SENSITIVE = []
5514
+ include Aws::Structure
5515
+ end
5516
+
5453
5517
  # An object that provides information about a specific version of a
5454
5518
  # [Solution][1] in a Custom dataset group.
5455
5519
  #
@@ -6014,5 +6078,59 @@ module Aws::Personalize
6014
6078
  include Aws::Structure
6015
6079
  end
6016
6080
 
6081
+ # @!attribute [rw] solution_arn
6082
+ # The Amazon Resource Name (ARN) of the solution to update.
6083
+ # @return [String]
6084
+ #
6085
+ # @!attribute [rw] perform_auto_training
6086
+ # Whether the solution uses automatic training to create new solution
6087
+ # versions (trained models). You can change the training frequency by
6088
+ # specifying a `schedulingExpression` in the `AutoTrainingConfig` as
6089
+ # part of solution configuration.
6090
+ #
6091
+ # If you turn on automatic training, the first automatic training
6092
+ # starts within one hour after the solution update completes. If you
6093
+ # manually create a solution version within the hour, the solution
6094
+ # skips the first automatic training. For more information about
6095
+ # automatic training, see [Configuring automatic training][1].
6096
+ #
6097
+ # After training starts, you can get the solution version's Amazon
6098
+ # Resource Name (ARN) with the [ListSolutionVersions][2] API
6099
+ # operation. To get its status, use the [DescribeSolutionVersion][3].
6100
+ #
6101
+ #
6102
+ #
6103
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html
6104
+ # [2]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html
6105
+ # [3]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html
6106
+ # @return [Boolean]
6107
+ #
6108
+ # @!attribute [rw] solution_update_config
6109
+ # The new configuration details of the solution.
6110
+ # @return [Types::SolutionUpdateConfig]
6111
+ #
6112
+ # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/UpdateSolutionRequest AWS API Documentation
6113
+ #
6114
+ class UpdateSolutionRequest < Struct.new(
6115
+ :solution_arn,
6116
+ :perform_auto_training,
6117
+ :solution_update_config)
6118
+ SENSITIVE = []
6119
+ include Aws::Structure
6120
+ end
6121
+
6122
+ # @!attribute [rw] solution_arn
6123
+ # The same solution Amazon Resource Name (ARN) as given in the
6124
+ # request.
6125
+ # @return [String]
6126
+ #
6127
+ # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/UpdateSolutionResponse AWS API Documentation
6128
+ #
6129
+ class UpdateSolutionResponse < Struct.new(
6130
+ :solution_arn)
6131
+ SENSITIVE = []
6132
+ include Aws::Structure
6133
+ end
6134
+
6017
6135
  end
6018
6136
  end
@@ -52,6 +52,6 @@ require_relative 'aws-sdk-personalize/customizations'
52
52
  # @!group service
53
53
  module Aws::Personalize
54
54
 
55
- GEM_VERSION = '1.68.0'
55
+ GEM_VERSION = '1.69.0'
56
56
 
57
57
  end
data/sig/client.rbs CHANGED
@@ -1065,6 +1065,22 @@ module Aws
1065
1065
  }
1066
1066
  ) -> _UpdateRecommenderResponseSuccess
1067
1067
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateRecommenderResponseSuccess
1068
+
1069
+ interface _UpdateSolutionResponseSuccess
1070
+ include ::Seahorse::Client::_ResponseSuccess[Types::UpdateSolutionResponse]
1071
+ def solution_arn: () -> ::String
1072
+ end
1073
+ # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Personalize/Client.html#update_solution-instance_method
1074
+ def update_solution: (
1075
+ solution_arn: ::String,
1076
+ ?perform_auto_training: bool,
1077
+ ?solution_update_config: {
1078
+ auto_training_config: {
1079
+ scheduling_expression: ::String?
1080
+ }?
1081
+ }
1082
+ ) -> _UpdateSolutionResponseSuccess
1083
+ | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateSolutionResponseSuccess
1068
1084
  end
1069
1085
  end
1070
1086
  end
data/sig/types.rbs CHANGED
@@ -1312,6 +1312,7 @@ module Aws::Personalize
1312
1312
  attr_accessor creation_date_time: ::Time
1313
1313
  attr_accessor last_updated_date_time: ::Time
1314
1314
  attr_accessor latest_solution_version: Types::SolutionVersionSummary
1315
+ attr_accessor latest_solution_update: Types::SolutionUpdateSummary
1315
1316
  SENSITIVE: []
1316
1317
  end
1317
1318
 
@@ -1337,6 +1338,21 @@ module Aws::Personalize
1337
1338
  SENSITIVE: []
1338
1339
  end
1339
1340
 
1341
+ class SolutionUpdateConfig
1342
+ attr_accessor auto_training_config: Types::AutoTrainingConfig
1343
+ SENSITIVE: []
1344
+ end
1345
+
1346
+ class SolutionUpdateSummary
1347
+ attr_accessor solution_update_config: Types::SolutionUpdateConfig
1348
+ attr_accessor status: ::String
1349
+ attr_accessor perform_auto_training: bool
1350
+ attr_accessor creation_date_time: ::Time
1351
+ attr_accessor last_updated_date_time: ::Time
1352
+ attr_accessor failure_reason: ::String
1353
+ SENSITIVE: []
1354
+ end
1355
+
1340
1356
  class SolutionVersion
1341
1357
  attr_accessor name: ::String
1342
1358
  attr_accessor solution_version_arn: ::String
@@ -1490,5 +1506,17 @@ module Aws::Personalize
1490
1506
  attr_accessor recommender_arn: ::String
1491
1507
  SENSITIVE: []
1492
1508
  end
1509
+
1510
+ class UpdateSolutionRequest
1511
+ attr_accessor solution_arn: ::String
1512
+ attr_accessor perform_auto_training: bool
1513
+ attr_accessor solution_update_config: Types::SolutionUpdateConfig
1514
+ SENSITIVE: []
1515
+ end
1516
+
1517
+ class UpdateSolutionResponse
1518
+ attr_accessor solution_arn: ::String
1519
+ SENSITIVE: []
1520
+ end
1493
1521
  end
1494
1522
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-personalize
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.68.0
4
+ version: 1.69.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-07-02 00:00:00.000000000 Z
11
+ date: 2024-08-29 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core