aws-sdk-personalize 1.68.0 → 1.70.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: ad8e80f1beb2d391286aac3fff569f5e8bf75a6b1483388167ccc747391170d7
4
+ data.tar.gz: 17bf47d5aa860b7f059089ce1ac17112f30f62e490a11d1487ad93776bb15003
5
5
  SHA512:
6
- metadata.gz: 8fe7c9f7f5bf99e5e8dd316cdd97a8c9138d0ef7caa0def9ea4e6a8ded5c9bbcc4943245f3a0738552d06e8e9069a5c650c696f6beff6f333154f12fcf877f54
7
- data.tar.gz: ce589405b84ca6cb50c235f763e2cba1964a8f92b7571b3b85a8a08f16c87d2bd2177ba0ffedb635ea6ed33b946a4e4a34d009351068204e03836a440182a7c7
6
+ metadata.gz: b6fd398e7be0ff69ee36cdb76db4292d85837aaa03b72ae913d841d54021f65cec64b5247e2053e563d6d07e4a01d6d7cb58712b39e4379eacfd6593870dcca4
7
+ data.tar.gz: af28af395e7b246143e9f38de482bd089669a5ddab697a3616553c49b7cbee5a9b74c8d706be8e4fa0d6ba077f3aa016530548e83bc0ff05c4183ab8b92b34b8
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.70.0 (2024-09-03)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.69.0 (2024-08-29)
10
+ ------------------
11
+
12
+ * Feature - This releases ability to update automatic training scheduler for customer solutions
13
+
4
14
  1.68.0 (2024-07-02)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.68.0
1
+ 1.70.0
@@ -32,6 +32,7 @@ require 'aws-sdk-core/plugins/checksum_algorithm.rb'
32
32
  require 'aws-sdk-core/plugins/request_compression.rb'
33
33
  require 'aws-sdk-core/plugins/defaults_mode.rb'
34
34
  require 'aws-sdk-core/plugins/recursion_detection.rb'
35
+ require 'aws-sdk-core/plugins/telemetry.rb'
35
36
  require 'aws-sdk-core/plugins/sign.rb'
36
37
  require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
37
38
 
@@ -83,6 +84,7 @@ module Aws::Personalize
83
84
  add_plugin(Aws::Plugins::RequestCompression)
84
85
  add_plugin(Aws::Plugins::DefaultsMode)
85
86
  add_plugin(Aws::Plugins::RecursionDetection)
87
+ add_plugin(Aws::Plugins::Telemetry)
86
88
  add_plugin(Aws::Plugins::Sign)
87
89
  add_plugin(Aws::Plugins::Protocols::JsonRpc)
88
90
  add_plugin(Aws::Personalize::Plugins::Endpoints)
@@ -337,6 +339,16 @@ module Aws::Personalize
337
339
  # ** Please note ** When response stubbing is enabled, no HTTP
338
340
  # requests are made, and retries are disabled.
339
341
  #
342
+ # @option options [Aws::Telemetry::TelemetryProviderBase] :telemetry_provider (Aws::Telemetry::NoOpTelemetryProvider)
343
+ # Allows you to provide a telemetry provider, which is used to
344
+ # emit telemetry data. By default, uses `NoOpTelemetryProvider` which
345
+ # will not record or emit any telemetry data. The SDK supports the
346
+ # following telemetry providers:
347
+ #
348
+ # * OpenTelemetry (OTel) - To use the OTel provider, install and require the
349
+ # `opentelemetry-sdk` gem and then, pass in an instance of a
350
+ # `Aws::Telemetry::OTelProvider` for telemetry provider.
351
+ #
340
352
  # @option options [Aws::TokenProvider] :token_provider
341
353
  # A Bearer Token Provider. This can be an instance of any one of the
342
354
  # following classes:
@@ -1817,40 +1829,39 @@ module Aws::Personalize
1817
1829
  req.send_request(options)
1818
1830
  end
1819
1831
 
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].
1832
+ # By default, all new solutions use automatic training. With automatic
1833
+ # training, you incur training costs while your solution is active. To
1834
+ # avoid unnecessary costs, when you are finished you can [update the
1835
+ # solution][1] to turn off automatic training. For information about
1836
+ # training costs, see [Amazon Personalize pricing][2].
1826
1837
  #
1827
1838
  # Creates the configuration for training a model (creating a solution
1828
1839
  # version). This configuration includes the recipe to use for model
1829
1840
  # training and optional training configuration, such as columns to use
1830
1841
  # in training and feature transformation parameters. For more
1831
1842
  # information about configuring a solution, see [Creating and
1832
- # configuring a solution][2].
1843
+ # configuring a solution][3].
1833
1844
  #
1834
1845
  # By default, new solutions use automatic training to create solution
1835
1846
  # 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].
1847
+ # Automatic solution version creation starts within one hour after the
1848
+ # solution is ACTIVE. If you manually create a solution version within
1849
+ # the hour, the solution skips the first automatic training. For more
1850
+ # information, see [Configuring automatic training][4].
1840
1851
  #
1841
1852
  # To turn off automatic training, set `performAutoTraining` to false. If
1842
1853
  # you turn off automatic training, you must manually create a solution
1843
- # version by calling the [CreateSolutionVersion][4] operation.
1854
+ # version by calling the [CreateSolutionVersion][5] operation.
1844
1855
  #
1845
1856
  # 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].
1857
+ # Resource Name (ARN) with the [ListSolutionVersions][6] API operation.
1858
+ # To get its status, use the [DescribeSolutionVersion][7].
1848
1859
  #
1849
1860
  # 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
1861
+ # [GetSolutionMetrics][8]. When you are satisfied with the solution
1862
+ # version, you deploy it using [CreateCampaign][9]. The campaign
1852
1863
  # provides recommendations to a client through the
1853
- # [GetRecommendations][9] API.
1864
+ # [GetRecommendations][10] API.
1854
1865
  #
1855
1866
  # <note markdown="1"> Amazon Personalize doesn't support configuring the `hpoObjective` for
1856
1867
  # solution hyperparameter optimization at this time.
@@ -1866,39 +1877,42 @@ module Aws::Personalize
1866
1877
  #
1867
1878
  # * DELETE PENDING &gt; DELETE IN\_PROGRESS
1868
1879
  #
1869
- # To get the status of the solution, call [DescribeSolution][10]. If you
1880
+ # To get the status of the solution, call [DescribeSolution][11]. If you
1870
1881
  # use manual training, the status must be ACTIVE before you call
1871
1882
  # `CreateSolutionVersion`.
1872
1883
  #
1873
1884
  # **Related APIs**
1874
1885
  #
1875
- # * [ListSolutions][11]
1886
+ # * [UpdateSolution][1]
1876
1887
  #
1877
- # * [CreateSolutionVersion][4]
1888
+ # * [ListSolutions][12]
1878
1889
  #
1879
- # * [DescribeSolution][10]
1890
+ # * [CreateSolutionVersion][5]
1880
1891
  #
1881
- # * [DeleteSolution][12]
1892
+ # * [DescribeSolution][11]
1893
+ #
1894
+ # * [DeleteSolution][13]
1882
1895
  # ^
1883
1896
  #
1884
- # * [ListSolutionVersions][5]
1897
+ # * [ListSolutionVersions][6]
1885
1898
  #
1886
- # * [DescribeSolutionVersion][6]
1899
+ # * [DescribeSolutionVersion][7]
1887
1900
  #
1888
1901
  #
1889
1902
  #
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
1903
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html
1904
+ # [2]: https://aws.amazon.com/personalize/pricing/
1905
+ # [3]: https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html
1906
+ # [4]: https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html
1907
+ # [5]: https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html
1908
+ # [6]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html
1909
+ # [7]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html
1910
+ # [8]: https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html
1911
+ # [9]: https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html
1912
+ # [10]: https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html
1913
+ # [11]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html
1914
+ # [12]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html
1915
+ # [13]: https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html
1902
1916
  #
1903
1917
  # @option params [required, String] :name
1904
1918
  # The name for the solution.
@@ -1938,9 +1952,9 @@ module Aws::Personalize
1938
1952
  # more information about automatic training, see [Configuring automatic
1939
1953
  # training][1].
1940
1954
  #
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.
1955
+ # Automatic solution version creation starts within one hour after the
1956
+ # solution is ACTIVE. If you manually create a solution version within
1957
+ # the hour, the solution skips the first automatic training.
1944
1958
  #
1945
1959
  # After training starts, you can get the solution version's Amazon
1946
1960
  # Resource Name (ARN) with the [ListSolutionVersions][2] API operation.
@@ -1975,7 +1989,7 @@ module Aws::Personalize
1975
1989
  # interactions for training with equal weight regardless of type.
1976
1990
  #
1977
1991
  # @option params [Types::SolutionConfig] :solution_config
1978
- # The configuration to use with the solution. When `performAutoML` is
1992
+ # The configuration properties for the solution. When `performAutoML` is
1979
1993
  # set to true, Amazon Personalize only evaluates the `autoMLConfig`
1980
1994
  # section of the solution configuration.
1981
1995
  #
@@ -3271,6 +3285,12 @@ module Aws::Personalize
3271
3285
  # resp.solution.latest_solution_version.creation_date_time #=> Time
3272
3286
  # resp.solution.latest_solution_version.last_updated_date_time #=> Time
3273
3287
  # resp.solution.latest_solution_version.failure_reason #=> String
3288
+ # resp.solution.latest_solution_update.solution_update_config.auto_training_config.scheduling_expression #=> String
3289
+ # resp.solution.latest_solution_update.status #=> String
3290
+ # resp.solution.latest_solution_update.perform_auto_training #=> Boolean
3291
+ # resp.solution.latest_solution_update.creation_date_time #=> Time
3292
+ # resp.solution.latest_solution_update.last_updated_date_time #=> Time
3293
+ # resp.solution.latest_solution_update.failure_reason #=> String
3274
3294
  #
3275
3295
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeSolution AWS API Documentation
3276
3296
  #
@@ -4743,20 +4763,100 @@ module Aws::Personalize
4743
4763
  req.send_request(options)
4744
4764
  end
4745
4765
 
4766
+ # Updates an Amazon Personalize solution to use a different automatic
4767
+ # training configuration. When you update a solution, you can change
4768
+ # whether the solution uses automatic training, and you can change the
4769
+ # training frequency. For more information about updating a solution,
4770
+ # see [Updating a solution][1].
4771
+ #
4772
+ # A solution update can be in one of the following states:
4773
+ #
4774
+ # CREATE PENDING &gt; CREATE IN\_PROGRESS &gt; ACTIVE -or- CREATE FAILED
4775
+ #
4776
+ # To get the status of a solution update, call the [DescribeSolution][2]
4777
+ # API operation and find the status in the `latestSolutionUpdate`.
4778
+ #
4779
+ #
4780
+ #
4781
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/updating-solution.html
4782
+ # [2]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html
4783
+ #
4784
+ # @option params [required, String] :solution_arn
4785
+ # The Amazon Resource Name (ARN) of the solution to update.
4786
+ #
4787
+ # @option params [Boolean] :perform_auto_training
4788
+ # Whether the solution uses automatic training to create new solution
4789
+ # versions (trained models). You can change the training frequency by
4790
+ # specifying a `schedulingExpression` in the `AutoTrainingConfig` as
4791
+ # part of solution configuration.
4792
+ #
4793
+ # If you turn on automatic training, the first automatic training starts
4794
+ # within one hour after the solution update completes. If you manually
4795
+ # create a solution version within the hour, the solution skips the
4796
+ # first automatic training. For more information about automatic
4797
+ # training, see [Configuring automatic training][1].
4798
+ #
4799
+ # After training starts, you can get the solution version's Amazon
4800
+ # Resource Name (ARN) with the [ListSolutionVersions][2] API operation.
4801
+ # To get its status, use the [DescribeSolutionVersion][3].
4802
+ #
4803
+ #
4804
+ #
4805
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html
4806
+ # [2]: https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html
4807
+ # [3]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html
4808
+ #
4809
+ # @option params [Types::SolutionUpdateConfig] :solution_update_config
4810
+ # The new configuration details of the solution.
4811
+ #
4812
+ # @return [Types::UpdateSolutionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4813
+ #
4814
+ # * {Types::UpdateSolutionResponse#solution_arn #solution_arn} => String
4815
+ #
4816
+ # @example Request syntax with placeholder values
4817
+ #
4818
+ # resp = client.update_solution({
4819
+ # solution_arn: "Arn", # required
4820
+ # perform_auto_training: false,
4821
+ # solution_update_config: {
4822
+ # auto_training_config: {
4823
+ # scheduling_expression: "SchedulingExpression",
4824
+ # },
4825
+ # },
4826
+ # })
4827
+ #
4828
+ # @example Response structure
4829
+ #
4830
+ # resp.solution_arn #=> String
4831
+ #
4832
+ # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/UpdateSolution AWS API Documentation
4833
+ #
4834
+ # @overload update_solution(params = {})
4835
+ # @param [Hash] params ({})
4836
+ def update_solution(params = {}, options = {})
4837
+ req = build_request(:update_solution, params)
4838
+ req.send_request(options)
4839
+ end
4840
+
4746
4841
  # @!endgroup
4747
4842
 
4748
4843
  # @param params ({})
4749
4844
  # @api private
4750
4845
  def build_request(operation_name, params = {})
4751
4846
  handlers = @handlers.for(operation_name)
4847
+ tracer = config.telemetry_provider.tracer_provider.tracer(
4848
+ Aws::Telemetry.module_to_tracer_name('Aws::Personalize')
4849
+ )
4752
4850
  context = Seahorse::Client::RequestContext.new(
4753
4851
  operation_name: operation_name,
4754
4852
  operation: config.api.operation(operation_name),
4755
4853
  client: self,
4756
4854
  params: params,
4757
- config: config)
4855
+ config: config,
4856
+ tracer: tracer
4857
+ )
4758
4858
  context[:gem_name] = 'aws-sdk-personalize'
4759
- context[:gem_version] = '1.68.0'
4859
+ context[:gem_version] = '1.70.0'
4760
4860
  Seahorse::Client::Request.new(handlers, context)
4761
4861
  end
4762
4862
 
@@ -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.70.0'
56
56
 
57
57
  end
data/sig/client.rbs CHANGED
@@ -51,6 +51,7 @@ module Aws
51
51
  ?sigv4a_signing_region_set: Array[String],
52
52
  ?simple_json: bool,
53
53
  ?stub_responses: untyped,
54
+ ?telemetry_provider: Aws::Telemetry::TelemetryProviderBase,
54
55
  ?token_provider: untyped,
55
56
  ?use_dualstack_endpoint: bool,
56
57
  ?use_fips_endpoint: bool,
@@ -1065,6 +1066,22 @@ module Aws
1065
1066
  }
1066
1067
  ) -> _UpdateRecommenderResponseSuccess
1067
1068
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateRecommenderResponseSuccess
1069
+
1070
+ interface _UpdateSolutionResponseSuccess
1071
+ include ::Seahorse::Client::_ResponseSuccess[Types::UpdateSolutionResponse]
1072
+ def solution_arn: () -> ::String
1073
+ end
1074
+ # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Personalize/Client.html#update_solution-instance_method
1075
+ def update_solution: (
1076
+ solution_arn: ::String,
1077
+ ?perform_auto_training: bool,
1078
+ ?solution_update_config: {
1079
+ auto_training_config: {
1080
+ scheduling_expression: ::String?
1081
+ }?
1082
+ }
1083
+ ) -> _UpdateSolutionResponseSuccess
1084
+ | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateSolutionResponseSuccess
1068
1085
  end
1069
1086
  end
1070
1087
  end
data/sig/resource.rbs CHANGED
@@ -51,6 +51,7 @@ module Aws
51
51
  ?sigv4a_signing_region_set: Array[String],
52
52
  ?simple_json: bool,
53
53
  ?stub_responses: untyped,
54
+ ?telemetry_provider: Aws::Telemetry::TelemetryProviderBase,
54
55
  ?token_provider: untyped,
55
56
  ?use_dualstack_endpoint: bool,
56
57
  ?use_fips_endpoint: bool,
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.70.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-09-03 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.201.0
22
+ version: 3.203.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.201.0
32
+ version: 3.203.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement