aws-sdk-personalize 1.40.0 → 1.43.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: 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