aws-sdk-personalize 1.40.0 → 1.43.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: 2137f455dff05dcf6f85d52adef29761b2f95d37b65332d0fbd2dcdef767c30b
4
- data.tar.gz: 44f7465a1a172df66f8fef62bcc0228c1d6ba4fc5fc243db3824c53217e1760a
3
+ metadata.gz: b7edd0851f01831788bae9768fa224c5f7ef20f9d4562cceb562ad6876f9abb7
4
+ data.tar.gz: c06b3758b0783bf773cb6ef1fa4f976da683db704907a1b25280eadec2eb758c
5
5
  SHA512:
6
- metadata.gz: 61372af08f199a3d33e73cf09b4b784ddcf3ca385e7be2eae416bad5bbcec5f10d6def7ad9ebb58872fe913f0609a4935e28ba64f80e03d47ea6f441f94055d4
7
- data.tar.gz: 1436a4955cbe6ae913b297d488065f8ebbe6a7fd73cd5b6205c24faa701167f8296cd56f7efbd3acbd1b0c98d34c4f0712ccf59fba9a2ec77f7999974677c7c1
6
+ metadata.gz: b91e363f2c8552d2fe685307d9fe4a1c13359614e3c608bc28cc2fc1bbfe419169c760cd7ee8ca679c47c4e3cc425bc9a416fe54d49fc188924c910384eac8ec
7
+ data.tar.gz: 320d1995371797f6002bcf864ca5dde647aeb36f99c48f258f27aa516a08bd0236e28806be0bd09542121668c33ccd47365118c5a16ad6d2ef0a0557e7f1b2c3
data/CHANGELOG.md CHANGED
@@ -1,6 +1,21 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.43.0 (2022-08-02)
5
+ ------------------
6
+
7
+ * Feature - This release adds support for incremental bulk ingestion for the Personalize CreateDatasetImportJob API.
8
+
9
+ 1.42.0 (2022-05-23)
10
+ ------------------
11
+
12
+ * Feature - Adding modelMetrics as part of DescribeRecommender API response for Personalize.
13
+
14
+ 1.41.0 (2022-04-19)
15
+ ------------------
16
+
17
+ * Feature - Adding StartRecommender and StopRecommender APIs for Personalize.
18
+
4
19
  1.40.0 (2022-04-07)
5
20
  ------------------
6
21
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.40.0
1
+ 1.43.0
@@ -1002,8 +1002,10 @@ module Aws::Personalize
1002
1002
  # bucket, see [Giving Amazon Personalize Access to Amazon S3
1003
1003
  # Resources][1].
1004
1004
  #
1005
- # The dataset import job replaces any existing data in the dataset that
1006
- # you imported in bulk.
1005
+ # By default, a dataset import job replaces any existing data in the
1006
+ # dataset that you imported in bulk. To add new records without
1007
+ # replacing existing data, specify INCREMENTAL for the import mode in
1008
+ # the CreateDatasetImportJob operation.
1007
1009
  #
1008
1010
  # **Status**
1009
1011
  #
@@ -1058,6 +1060,18 @@ module Aws::Personalize
1058
1060
  #
1059
1061
  # [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
1060
1062
  #
1063
+ # @option params [String] :import_mode
1064
+ # Specify how to add the new records to an existing dataset. The default
1065
+ # import mode is `FULL`. If you haven't imported bulk records into the
1066
+ # dataset previously, you can only specify `FULL`.
1067
+ #
1068
+ # * Specify `FULL` to overwrite all existing bulk data in your dataset.
1069
+ # Data you imported individually is not replaced.
1070
+ #
1071
+ # * Specify `INCREMENTAL` to append the new records to the existing data
1072
+ # in your dataset. Amazon Personalize replaces any record with the
1073
+ # same ID with the new one.
1074
+ #
1061
1075
  # @return [Types::CreateDatasetImportJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1062
1076
  #
1063
1077
  # * {Types::CreateDatasetImportJobResponse#dataset_import_job_arn #dataset_import_job_arn} => String
@@ -1077,6 +1091,7 @@ module Aws::Personalize
1077
1091
  # tag_value: "TagValue", # required
1078
1092
  # },
1079
1093
  # ],
1094
+ # import_mode: "FULL", # accepts FULL, INCREMENTAL
1080
1095
  # })
1081
1096
  #
1082
1097
  # @example Response structure
@@ -1282,6 +1297,9 @@ module Aws::Personalize
1282
1297
  # * CREATE PENDING > CREATE IN\_PROGRESS > ACTIVE -or- CREATE
1283
1298
  # FAILED
1284
1299
  #
1300
+ # * STOP PENDING > STOP IN\_PROGRESS > INACTIVE > START PENDING
1301
+ # > START IN\_PROGRESS > ACTIVE
1302
+ #
1285
1303
  # * DELETE PENDING > DELETE IN\_PROGRESS
1286
1304
  #
1287
1305
  # To get the recommender status, call [DescribeRecommender][2].
@@ -2330,6 +2348,7 @@ module Aws::Personalize
2330
2348
  # resp.dataset_import_job.creation_date_time #=> Time
2331
2349
  # resp.dataset_import_job.last_updated_date_time #=> Time
2332
2350
  # resp.dataset_import_job.failure_reason #=> String
2351
+ # resp.dataset_import_job.import_mode #=> String, one of "FULL", "INCREMENTAL"
2333
2352
  #
2334
2353
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeDatasetImportJob AWS API Documentation
2335
2354
  #
@@ -2515,11 +2534,17 @@ module Aws::Personalize
2515
2534
  # * CREATE PENDING > CREATE IN\_PROGRESS > ACTIVE -or- CREATE
2516
2535
  # FAILED
2517
2536
  #
2537
+ # * STOP PENDING > STOP IN\_PROGRESS > INACTIVE > START PENDING
2538
+ # > START IN\_PROGRESS > ACTIVE
2539
+ #
2518
2540
  # * DELETE PENDING > DELETE IN\_PROGRESS
2519
2541
  #
2520
2542
  # When the `status` is `CREATE FAILED`, the response includes the
2521
2543
  # `failureReason` key, which describes why.
2522
2544
  #
2545
+ # The `modelMetrics` key is null when the recommender is being created
2546
+ # or deleted.
2547
+ #
2523
2548
  # For more information on recommenders, see [CreateRecommender][1].
2524
2549
  #
2525
2550
  #
@@ -2559,6 +2584,8 @@ module Aws::Personalize
2559
2584
  # resp.recommender.latest_recommender_update.last_updated_date_time #=> Time
2560
2585
  # resp.recommender.latest_recommender_update.status #=> String
2561
2586
  # resp.recommender.latest_recommender_update.failure_reason #=> String
2587
+ # resp.recommender.model_metrics #=> Hash
2588
+ # resp.recommender.model_metrics["MetricName"] #=> Float
2562
2589
  #
2563
2590
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeRecommender AWS API Documentation
2564
2591
  #
@@ -3106,6 +3133,7 @@ module Aws::Personalize
3106
3133
  # resp.dataset_import_jobs[0].creation_date_time #=> Time
3107
3134
  # resp.dataset_import_jobs[0].last_updated_date_time #=> Time
3108
3135
  # resp.dataset_import_jobs[0].failure_reason #=> String
3136
+ # resp.dataset_import_jobs[0].import_mode #=> String, one of "FULL", "INCREMENTAL"
3109
3137
  # resp.next_token #=> String
3110
3138
  #
3111
3139
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListDatasetImportJobs AWS API Documentation
@@ -3575,6 +3603,65 @@ module Aws::Personalize
3575
3603
  req.send_request(options)
3576
3604
  end
3577
3605
 
3606
+ # Starts a recommender that is INACTIVE. Starting a recommender does not
3607
+ # create any new models, but resumes billing and automatic retraining
3608
+ # for the recommender.
3609
+ #
3610
+ # @option params [required, String] :recommender_arn
3611
+ # The Amazon Resource Name (ARN) of the recommender to start.
3612
+ #
3613
+ # @return [Types::StartRecommenderResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3614
+ #
3615
+ # * {Types::StartRecommenderResponse#recommender_arn #recommender_arn} => String
3616
+ #
3617
+ # @example Request syntax with placeholder values
3618
+ #
3619
+ # resp = client.start_recommender({
3620
+ # recommender_arn: "Arn", # required
3621
+ # })
3622
+ #
3623
+ # @example Response structure
3624
+ #
3625
+ # resp.recommender_arn #=> String
3626
+ #
3627
+ # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/StartRecommender AWS API Documentation
3628
+ #
3629
+ # @overload start_recommender(params = {})
3630
+ # @param [Hash] params ({})
3631
+ def start_recommender(params = {}, options = {})
3632
+ req = build_request(:start_recommender, params)
3633
+ req.send_request(options)
3634
+ end
3635
+
3636
+ # Stops a recommender that is ACTIVE. Stopping a recommender halts
3637
+ # billing and automatic retraining for the recommender.
3638
+ #
3639
+ # @option params [required, String] :recommender_arn
3640
+ # The Amazon Resource Name (ARN) of the recommender to stop.
3641
+ #
3642
+ # @return [Types::StopRecommenderResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3643
+ #
3644
+ # * {Types::StopRecommenderResponse#recommender_arn #recommender_arn} => String
3645
+ #
3646
+ # @example Request syntax with placeholder values
3647
+ #
3648
+ # resp = client.stop_recommender({
3649
+ # recommender_arn: "Arn", # required
3650
+ # })
3651
+ #
3652
+ # @example Response structure
3653
+ #
3654
+ # resp.recommender_arn #=> String
3655
+ #
3656
+ # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/StopRecommender AWS API Documentation
3657
+ #
3658
+ # @overload stop_recommender(params = {})
3659
+ # @param [Hash] params ({})
3660
+ def stop_recommender(params = {}, options = {})
3661
+ req = build_request(:stop_recommender, params)
3662
+ req.send_request(options)
3663
+ end
3664
+
3578
3665
  # Stops creating a solution version that is in a state of
3579
3666
  # CREATE\_PENDING or CREATE IN\_PROGRESS.
3580
3667
  #
@@ -3685,8 +3772,10 @@ module Aws::Personalize
3685
3772
  # FAILED. Check the campaign status using the [DescribeCampaign][1]
3686
3773
  # operation.
3687
3774
  #
3688
- # <note markdown="1"> You must wait until the `status` of the updated campaign is `ACTIVE`
3689
- # before asking the campaign for recommendations.
3775
+ # <note markdown="1"> You can still get recommendations from a campaign while an update is
3776
+ # in progress. The campaign will use the previous solution version and
3777
+ # campaign configuration to generate recommendations until the latest
3778
+ # campaign update status is `Active`.
3690
3779
  #
3691
3780
  # </note>
3692
3781
  #
@@ -3790,7 +3879,7 @@ module Aws::Personalize
3790
3879
  params: params,
3791
3880
  config: config)
3792
3881
  context[:gem_name] = 'aws-sdk-personalize'
3793
- context[:gem_version] = '1.40.0'
3882
+ context[:gem_version] = '1.43.0'
3794
3883
  Seahorse::Client::Request.new(handlers, context)
3795
3884
  end
3796
3885
 
@@ -163,6 +163,7 @@ module Aws::Personalize
163
163
  HPOResourceConfig = Shapes::StructureShape.new(name: 'HPOResourceConfig')
164
164
  HyperParameterRanges = Shapes::StructureShape.new(name: 'HyperParameterRanges')
165
165
  HyperParameters = Shapes::MapShape.new(name: 'HyperParameters')
166
+ ImportMode = Shapes::StringShape.new(name: 'ImportMode')
166
167
  IngestionMode = Shapes::StringShape.new(name: 'IngestionMode')
167
168
  IntegerHyperParameterRange = Shapes::StructureShape.new(name: 'IntegerHyperParameterRange')
168
169
  IntegerHyperParameterRanges = Shapes::ListShape.new(name: 'IntegerHyperParameterRanges')
@@ -242,7 +243,11 @@ module Aws::Personalize
242
243
  SolutionVersionSummary = Shapes::StructureShape.new(name: 'SolutionVersionSummary')
243
244
  SolutionVersions = Shapes::ListShape.new(name: 'SolutionVersions')
244
245
  Solutions = Shapes::ListShape.new(name: 'Solutions')
246
+ StartRecommenderRequest = Shapes::StructureShape.new(name: 'StartRecommenderRequest')
247
+ StartRecommenderResponse = Shapes::StructureShape.new(name: 'StartRecommenderResponse')
245
248
  Status = Shapes::StringShape.new(name: 'Status')
249
+ StopRecommenderRequest = Shapes::StructureShape.new(name: 'StopRecommenderRequest')
250
+ StopRecommenderResponse = Shapes::StructureShape.new(name: 'StopRecommenderResponse')
246
251
  StopSolutionVersionCreationRequest = Shapes::StructureShape.new(name: 'StopSolutionVersionCreationRequest')
247
252
  Tag = Shapes::StructureShape.new(name: 'Tag')
248
253
  TagKey = Shapes::StringShape.new(name: 'TagKey')
@@ -471,6 +476,7 @@ module Aws::Personalize
471
476
  CreateDatasetImportJobRequest.add_member(:data_source, Shapes::ShapeRef.new(shape: DataSource, required: true, location_name: "dataSource"))
472
477
  CreateDatasetImportJobRequest.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, required: true, location_name: "roleArn"))
473
478
  CreateDatasetImportJobRequest.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "tags"))
479
+ CreateDatasetImportJobRequest.add_member(:import_mode, Shapes::ShapeRef.new(shape: ImportMode, location_name: "importMode"))
474
480
  CreateDatasetImportJobRequest.struct_class = Types::CreateDatasetImportJobRequest
475
481
 
476
482
  CreateDatasetImportJobResponse.add_member(:dataset_import_job_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "datasetImportJobArn"))
@@ -612,6 +618,7 @@ module Aws::Personalize
612
618
  DatasetImportJob.add_member(:creation_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "creationDateTime"))
613
619
  DatasetImportJob.add_member(:last_updated_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "lastUpdatedDateTime"))
614
620
  DatasetImportJob.add_member(:failure_reason, Shapes::ShapeRef.new(shape: FailureReason, location_name: "failureReason"))
621
+ DatasetImportJob.add_member(:import_mode, Shapes::ShapeRef.new(shape: ImportMode, location_name: "importMode"))
615
622
  DatasetImportJob.struct_class = Types::DatasetImportJob
616
623
 
617
624
  DatasetImportJobSummary.add_member(:dataset_import_job_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "datasetImportJobArn"))
@@ -620,6 +627,7 @@ module Aws::Personalize
620
627
  DatasetImportJobSummary.add_member(:creation_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "creationDateTime"))
621
628
  DatasetImportJobSummary.add_member(:last_updated_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "lastUpdatedDateTime"))
622
629
  DatasetImportJobSummary.add_member(:failure_reason, Shapes::ShapeRef.new(shape: FailureReason, location_name: "failureReason"))
630
+ DatasetImportJobSummary.add_member(:import_mode, Shapes::ShapeRef.new(shape: ImportMode, location_name: "importMode"))
623
631
  DatasetImportJobSummary.struct_class = Types::DatasetImportJobSummary
624
632
 
625
633
  DatasetImportJobs.member = Shapes::ShapeRef.new(shape: DatasetImportJobSummary)
@@ -1065,6 +1073,7 @@ module Aws::Personalize
1065
1073
  Recommender.add_member(:status, Shapes::ShapeRef.new(shape: Status, location_name: "status"))
1066
1074
  Recommender.add_member(:failure_reason, Shapes::ShapeRef.new(shape: FailureReason, location_name: "failureReason"))
1067
1075
  Recommender.add_member(:latest_recommender_update, Shapes::ShapeRef.new(shape: RecommenderUpdateSummary, location_name: "latestRecommenderUpdate"))
1076
+ Recommender.add_member(:model_metrics, Shapes::ShapeRef.new(shape: Metrics, location_name: "modelMetrics"))
1068
1077
  Recommender.struct_class = Types::Recommender
1069
1078
 
1070
1079
  RecommenderConfig.add_member(:item_exploration_config, Shapes::ShapeRef.new(shape: HyperParameters, location_name: "itemExplorationConfig"))
@@ -1166,6 +1175,18 @@ module Aws::Personalize
1166
1175
 
1167
1176
  Solutions.member = Shapes::ShapeRef.new(shape: SolutionSummary)
1168
1177
 
1178
+ StartRecommenderRequest.add_member(:recommender_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "recommenderArn"))
1179
+ StartRecommenderRequest.struct_class = Types::StartRecommenderRequest
1180
+
1181
+ StartRecommenderResponse.add_member(:recommender_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "recommenderArn"))
1182
+ StartRecommenderResponse.struct_class = Types::StartRecommenderResponse
1183
+
1184
+ StopRecommenderRequest.add_member(:recommender_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "recommenderArn"))
1185
+ StopRecommenderRequest.struct_class = Types::StopRecommenderRequest
1186
+
1187
+ StopRecommenderResponse.add_member(:recommender_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "recommenderArn"))
1188
+ StopRecommenderResponse.struct_class = Types::StopRecommenderResponse
1189
+
1169
1190
  StopSolutionVersionCreationRequest.add_member(:solution_version_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "solutionVersionArn"))
1170
1191
  StopSolutionVersionCreationRequest.struct_class = Types::StopSolutionVersionCreationRequest
1171
1192
 
@@ -1366,6 +1387,7 @@ module Aws::Personalize
1366
1387
  o.errors << Shapes::ShapeRef.new(shape: ResourceAlreadyExistsException)
1367
1388
  o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
1368
1389
  o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
1390
+ o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
1369
1391
  o.errors << Shapes::ShapeRef.new(shape: TooManyTagsException)
1370
1392
  end)
1371
1393
 
@@ -1900,6 +1922,28 @@ module Aws::Personalize
1900
1922
  o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
1901
1923
  end)
1902
1924
 
1925
+ api.add_operation(:start_recommender, Seahorse::Model::Operation.new.tap do |o|
1926
+ o.name = "StartRecommender"
1927
+ o.http_method = "POST"
1928
+ o.http_request_uri = "/"
1929
+ o.input = Shapes::ShapeRef.new(shape: StartRecommenderRequest)
1930
+ o.output = Shapes::ShapeRef.new(shape: StartRecommenderResponse)
1931
+ o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
1932
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
1933
+ o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
1934
+ end)
1935
+
1936
+ api.add_operation(:stop_recommender, Seahorse::Model::Operation.new.tap do |o|
1937
+ o.name = "StopRecommender"
1938
+ o.http_method = "POST"
1939
+ o.http_request_uri = "/"
1940
+ o.input = Shapes::ShapeRef.new(shape: StopRecommenderRequest)
1941
+ o.output = Shapes::ShapeRef.new(shape: StopRecommenderResponse)
1942
+ o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
1943
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
1944
+ o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
1945
+ end)
1946
+
1903
1947
  api.add_operation(:stop_solution_version_creation, Seahorse::Model::Operation.new.tap do |o|
1904
1948
  o.name = "StopSolutionVersionCreation"
1905
1949
  o.http_method = "POST"
@@ -1310,6 +1310,7 @@ module Aws::Personalize
1310
1310
  # tag_value: "TagValue", # required
1311
1311
  # },
1312
1312
  # ],
1313
+ # import_mode: "FULL", # accepts FULL, INCREMENTAL
1313
1314
  # }
1314
1315
  #
1315
1316
  # @!attribute [rw] job_name
@@ -1337,6 +1338,19 @@ module Aws::Personalize
1337
1338
  # [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
1338
1339
  # @return [Array<Types::Tag>]
1339
1340
  #
1341
+ # @!attribute [rw] import_mode
1342
+ # Specify how to add the new records to an existing dataset. The
1343
+ # default import mode is `FULL`. If you haven't imported bulk records
1344
+ # into the dataset previously, you can only specify `FULL`.
1345
+ #
1346
+ # * Specify `FULL` to overwrite all existing bulk data in your
1347
+ # dataset. Data you imported individually is not replaced.
1348
+ #
1349
+ # * Specify `INCREMENTAL` to append the new records to the existing
1350
+ # data in your dataset. Amazon Personalize replaces any record with
1351
+ # the same ID with the new one.
1352
+ # @return [String]
1353
+ #
1340
1354
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateDatasetImportJobRequest AWS API Documentation
1341
1355
  #
1342
1356
  class CreateDatasetImportJobRequest < Struct.new(
@@ -1344,7 +1358,8 @@ module Aws::Personalize
1344
1358
  :dataset_arn,
1345
1359
  :data_source,
1346
1360
  :role_arn,
1347
- :tags)
1361
+ :tags,
1362
+ :import_mode)
1348
1363
  SENSITIVE = []
1349
1364
  include Aws::Structure
1350
1365
  end
@@ -2358,6 +2373,11 @@ module Aws::Personalize
2358
2373
  # If a dataset import job fails, provides the reason why.
2359
2374
  # @return [String]
2360
2375
  #
2376
+ # @!attribute [rw] import_mode
2377
+ # The import mode used by the dataset import job to import new
2378
+ # records.
2379
+ # @return [String]
2380
+ #
2361
2381
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DatasetImportJob AWS API Documentation
2362
2382
  #
2363
2383
  class DatasetImportJob < Struct.new(
@@ -2369,7 +2389,8 @@ module Aws::Personalize
2369
2389
  :status,
2370
2390
  :creation_date_time,
2371
2391
  :last_updated_date_time,
2372
- :failure_reason)
2392
+ :failure_reason,
2393
+ :import_mode)
2373
2394
  SENSITIVE = []
2374
2395
  include Aws::Structure
2375
2396
  end
@@ -2414,6 +2435,16 @@ module Aws::Personalize
2414
2435
  # If a dataset import job fails, the reason behind the failure.
2415
2436
  # @return [String]
2416
2437
  #
2438
+ # @!attribute [rw] import_mode
2439
+ # The import mode the dataset import job used to update the data in
2440
+ # the dataset. For more information see [Updating existing bulk
2441
+ # data][1].
2442
+ #
2443
+ #
2444
+ #
2445
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/updating-existing-bulk-data.html
2446
+ # @return [String]
2447
+ #
2417
2448
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DatasetImportJobSummary AWS API Documentation
2418
2449
  #
2419
2450
  class DatasetImportJobSummary < Struct.new(
@@ -2422,7 +2453,8 @@ module Aws::Personalize
2422
2453
  :status,
2423
2454
  :creation_date_time,
2424
2455
  :last_updated_date_time,
2425
- :failure_reason)
2456
+ :failure_reason,
2457
+ :import_mode)
2426
2458
  SENSITIVE = []
2427
2459
  include Aws::Structure
2428
2460
  end
@@ -3644,7 +3676,12 @@ module Aws::Personalize
3644
3676
  # @return [String]
3645
3677
  #
3646
3678
  # @!attribute [rw] metrics
3647
- # The metrics for the solution version.
3679
+ # The metrics for the solution version. For more information, see [
3680
+ # Evaluating a solution version with metrics ][1].
3681
+ #
3682
+ #
3683
+ #
3684
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/working-with-training-metrics.html
3648
3685
  # @return [Hash<String,Float>]
3649
3686
  #
3650
3687
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/GetSolutionMetricsResponse AWS API Documentation
@@ -4844,6 +4881,9 @@ module Aws::Personalize
4844
4881
  # * CREATE PENDING &gt; CREATE IN\_PROGRESS &gt; ACTIVE -or- CREATE
4845
4882
  # FAILED
4846
4883
  #
4884
+ # * STOP PENDING &gt; STOP IN\_PROGRESS &gt; INACTIVE &gt; START
4885
+ # PENDING &gt; START IN\_PROGRESS &gt; ACTIVE
4886
+ #
4847
4887
  # * DELETE PENDING &gt; DELETE IN\_PROGRESS
4848
4888
  # @return [String]
4849
4889
  #
@@ -4855,6 +4895,16 @@ module Aws::Personalize
4855
4895
  # Provides a summary of the latest updates to the recommender.
4856
4896
  # @return [Types::RecommenderUpdateSummary]
4857
4897
  #
4898
+ # @!attribute [rw] model_metrics
4899
+ # Provides evaluation metrics that help you determine the performance
4900
+ # of a recommender. For more information, see [ Evaluating a
4901
+ # recommender][1].
4902
+ #
4903
+ #
4904
+ #
4905
+ # [1]: https://docs.aws.amazon.com/personalize/latest/dg/evaluating-recommenders.html
4906
+ # @return [Hash<String,Float>]
4907
+ #
4858
4908
  # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/Recommender AWS API Documentation
4859
4909
  #
4860
4910
  class Recommender < Struct.new(
@@ -4867,7 +4917,8 @@ module Aws::Personalize
4867
4917
  :last_updated_date_time,
4868
4918
  :status,
4869
4919
  :failure_reason,
4870
- :latest_recommender_update)
4920
+ :latest_recommender_update,
4921
+ :model_metrics)
4871
4922
  SENSITIVE = []
4872
4923
  include Aws::Structure
4873
4924
  end
@@ -4938,6 +4989,9 @@ module Aws::Personalize
4938
4989
  # * CREATE PENDING &gt; CREATE IN\_PROGRESS &gt; ACTIVE -or- CREATE
4939
4990
  # FAILED
4940
4991
  #
4992
+ # * STOP PENDING &gt; STOP IN\_PROGRESS &gt; INACTIVE &gt; START
4993
+ # PENDING &gt; START IN\_PROGRESS &gt; ACTIVE
4994
+ #
4941
4995
  # * DELETE PENDING &gt; DELETE IN\_PROGRESS
4942
4996
  # @return [String]
4943
4997
  #
@@ -4994,6 +5048,9 @@ module Aws::Personalize
4994
5048
  # * CREATE PENDING &gt; CREATE IN\_PROGRESS &gt; ACTIVE -or- CREATE
4995
5049
  # FAILED
4996
5050
  #
5051
+ # * STOP PENDING &gt; STOP IN\_PROGRESS &gt; INACTIVE &gt; START
5052
+ # PENDING &gt; START IN\_PROGRESS &gt; ACTIVE
5053
+ #
4997
5054
  # * DELETE PENDING &gt; DELETE IN\_PROGRESS
4998
5055
  # @return [String]
4999
5056
  #
@@ -5499,6 +5556,68 @@ module Aws::Personalize
5499
5556
  include Aws::Structure
5500
5557
  end
5501
5558
 
5559
+ # @note When making an API call, you may pass StartRecommenderRequest
5560
+ # data as a hash:
5561
+ #
5562
+ # {
5563
+ # recommender_arn: "Arn", # required
5564
+ # }
5565
+ #
5566
+ # @!attribute [rw] recommender_arn
5567
+ # The Amazon Resource Name (ARN) of the recommender to start.
5568
+ # @return [String]
5569
+ #
5570
+ # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/StartRecommenderRequest AWS API Documentation
5571
+ #
5572
+ class StartRecommenderRequest < Struct.new(
5573
+ :recommender_arn)
5574
+ SENSITIVE = []
5575
+ include Aws::Structure
5576
+ end
5577
+
5578
+ # @!attribute [rw] recommender_arn
5579
+ # The Amazon Resource Name (ARN) of the recommender you started.
5580
+ # @return [String]
5581
+ #
5582
+ # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/StartRecommenderResponse AWS API Documentation
5583
+ #
5584
+ class StartRecommenderResponse < Struct.new(
5585
+ :recommender_arn)
5586
+ SENSITIVE = []
5587
+ include Aws::Structure
5588
+ end
5589
+
5590
+ # @note When making an API call, you may pass StopRecommenderRequest
5591
+ # data as a hash:
5592
+ #
5593
+ # {
5594
+ # recommender_arn: "Arn", # required
5595
+ # }
5596
+ #
5597
+ # @!attribute [rw] recommender_arn
5598
+ # The Amazon Resource Name (ARN) of the recommender to stop.
5599
+ # @return [String]
5600
+ #
5601
+ # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/StopRecommenderRequest AWS API Documentation
5602
+ #
5603
+ class StopRecommenderRequest < Struct.new(
5604
+ :recommender_arn)
5605
+ SENSITIVE = []
5606
+ include Aws::Structure
5607
+ end
5608
+
5609
+ # @!attribute [rw] recommender_arn
5610
+ # The Amazon Resource Name (ARN) of the recommender you stopped.
5611
+ # @return [String]
5612
+ #
5613
+ # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/StopRecommenderResponse AWS API Documentation
5614
+ #
5615
+ class StopRecommenderResponse < Struct.new(
5616
+ :recommender_arn)
5617
+ SENSITIVE = []
5618
+ include Aws::Structure
5619
+ end
5620
+
5502
5621
  # @note When making an API call, you may pass StopSolutionVersionCreationRequest
5503
5622
  # data as a hash:
5504
5623
  #
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-personalize/customizations'
48
48
  # @!group service
49
49
  module Aws::Personalize
50
50
 
51
- GEM_VERSION = '1.40.0'
51
+ GEM_VERSION = '1.43.0'
52
52
 
53
53
  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.40.0
4
+ version: 1.43.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: 2022-04-07 00:00:00.000000000 Z
11
+ date: 2022-08-02 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core