aws-sdk-personalize 1.68.0 → 1.69.0

Sign up to get free protection for your applications and to get access to all the features.
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