aws-sdk-personalize 1.68.0 → 1.70.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: 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