aws-sdk-personalize 1.42.0 → 1.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a053164e6a8cd6d9a1228c0a3546ed5c0a10d8dd82bcc205a976c1bc1410e385
-  data.tar.gz: bb3009ede7c94c464e53fb901890233054c51f779c08a0e60746b7bee1ddc4f0
+  metadata.gz: b7edd0851f01831788bae9768fa224c5f7ef20f9d4562cceb562ad6876f9abb7
+  data.tar.gz: c06b3758b0783bf773cb6ef1fa4f976da683db704907a1b25280eadec2eb758c
 SHA512:
-  metadata.gz: c91d120040907df7f153185af96f7f5f187aca39cb4d113fa195ac5fc6b37ad391d45be93f75babac7c337974c888715582de470fd1321945469baa7ca8f35e4
-  data.tar.gz: 666a6dd7a770baae5e714dda97f4bb59fed8b067ce0f83ee7359aae60da6327887a3c3f01898488076f6d40f3317ee96e0f4f19fcf6fc5f5e831a1d80e1bf0c1
+  metadata.gz: b91e363f2c8552d2fe685307d9fe4a1c13359614e3c608bc28cc2fc1bbfe419169c760cd7ee8ca679c47c4e3cc425bc9a416fe54d49fc188924c910384eac8ec
+  data.tar.gz: 320d1995371797f6002bcf864ca5dde647aeb36f99c48f258f27aa516a08bd0236e28806be0bd09542121668c33ccd47365118c5a16ad6d2ef0a0557e7f1b2c3

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.43.0 (2022-08-02)
+------------------
+
+* Feature - This release adds support for incremental bulk ingestion for the Personalize CreateDatasetImportJob API.
+
 1.42.0 (2022-05-23)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.42.0
+1.43.0

data/lib/aws-sdk-personalize/client.rb

@@ -1002,8 +1002,10 @@ module Aws::Personalize
     # bucket, see [Giving Amazon Personalize Access to Amazon S3
     # Resources][1].
     #
-    # The dataset import job replaces any existing data in the dataset that
-    # you imported in bulk.
+    # By default, a dataset import job replaces any existing data in the
+    # dataset that you imported in bulk. To add new records without
+    # replacing existing data, specify INCREMENTAL for the import mode in
+    # the CreateDatasetImportJob operation.
     #
     # **Status**
     #
@@ -1058,6 +1060,18 @@ module Aws::Personalize
     #
     #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
     #
+    # @option params [String] :import_mode
+    #   Specify how to add the new records to an existing dataset. The default
+    #   import mode is `FULL`. If you haven't imported bulk records into the
+    #   dataset previously, you can only specify `FULL`.
+    #
+    #   * Specify `FULL` to overwrite all existing bulk data in your dataset.
+    #     Data you imported individually is not replaced.
+    #
+    #   * Specify `INCREMENTAL` to append the new records to the existing data
+    #     in your dataset. Amazon Personalize replaces any record with the
+    #     same ID with the new one.
+    #
     # @return [Types::CreateDatasetImportJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateDatasetImportJobResponse#dataset_import_job_arn #dataset_import_job_arn} => String
@@ -1077,6 +1091,7 @@ module Aws::Personalize
     #         tag_value: "TagValue", # required
     #       },
     #     ],
+    #     import_mode: "FULL", # accepts FULL, INCREMENTAL
     #   })
     #
     # @example Response structure
@@ -2333,6 +2348,7 @@ module Aws::Personalize
     #   resp.dataset_import_job.creation_date_time #=> Time
     #   resp.dataset_import_job.last_updated_date_time #=> Time
     #   resp.dataset_import_job.failure_reason #=> String
+    #   resp.dataset_import_job.import_mode #=> String, one of "FULL", "INCREMENTAL"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeDatasetImportJob AWS API Documentation
     #
@@ -3117,6 +3133,7 @@ module Aws::Personalize
     #   resp.dataset_import_jobs[0].creation_date_time #=> Time
     #   resp.dataset_import_jobs[0].last_updated_date_time #=> Time
     #   resp.dataset_import_jobs[0].failure_reason #=> String
+    #   resp.dataset_import_jobs[0].import_mode #=> String, one of "FULL", "INCREMENTAL"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListDatasetImportJobs AWS API Documentation
@@ -3862,7 +3879,7 @@ module Aws::Personalize
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-personalize'
-      context[:gem_version] = '1.42.0'
+      context[:gem_version] = '1.43.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-personalize/client_api.rb

@@ -163,6 +163,7 @@ module Aws::Personalize
     HPOResourceConfig = Shapes::StructureShape.new(name: 'HPOResourceConfig')
     HyperParameterRanges = Shapes::StructureShape.new(name: 'HyperParameterRanges')
     HyperParameters = Shapes::MapShape.new(name: 'HyperParameters')
+    ImportMode = Shapes::StringShape.new(name: 'ImportMode')
     IngestionMode = Shapes::StringShape.new(name: 'IngestionMode')
     IntegerHyperParameterRange = Shapes::StructureShape.new(name: 'IntegerHyperParameterRange')
     IntegerHyperParameterRanges = Shapes::ListShape.new(name: 'IntegerHyperParameterRanges')
@@ -475,6 +476,7 @@ module Aws::Personalize
     CreateDatasetImportJobRequest.add_member(:data_source, Shapes::ShapeRef.new(shape: DataSource, required: true, location_name: "dataSource"))
     CreateDatasetImportJobRequest.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, required: true, location_name: "roleArn"))
     CreateDatasetImportJobRequest.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "tags"))
+    CreateDatasetImportJobRequest.add_member(:import_mode, Shapes::ShapeRef.new(shape: ImportMode, location_name: "importMode"))
     CreateDatasetImportJobRequest.struct_class = Types::CreateDatasetImportJobRequest
 
     CreateDatasetImportJobResponse.add_member(:dataset_import_job_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "datasetImportJobArn"))
@@ -616,6 +618,7 @@ module Aws::Personalize
     DatasetImportJob.add_member(:creation_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "creationDateTime"))
     DatasetImportJob.add_member(:last_updated_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "lastUpdatedDateTime"))
     DatasetImportJob.add_member(:failure_reason, Shapes::ShapeRef.new(shape: FailureReason, location_name: "failureReason"))
+    DatasetImportJob.add_member(:import_mode, Shapes::ShapeRef.new(shape: ImportMode, location_name: "importMode"))
     DatasetImportJob.struct_class = Types::DatasetImportJob
 
     DatasetImportJobSummary.add_member(:dataset_import_job_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "datasetImportJobArn"))
@@ -624,6 +627,7 @@ module Aws::Personalize
     DatasetImportJobSummary.add_member(:creation_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "creationDateTime"))
     DatasetImportJobSummary.add_member(:last_updated_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "lastUpdatedDateTime"))
     DatasetImportJobSummary.add_member(:failure_reason, Shapes::ShapeRef.new(shape: FailureReason, location_name: "failureReason"))
+    DatasetImportJobSummary.add_member(:import_mode, Shapes::ShapeRef.new(shape: ImportMode, location_name: "importMode"))
     DatasetImportJobSummary.struct_class = Types::DatasetImportJobSummary
 
     DatasetImportJobs.member = Shapes::ShapeRef.new(shape: DatasetImportJobSummary)

data/lib/aws-sdk-personalize/types.rb

@@ -1310,6 +1310,7 @@ module Aws::Personalize
     #             tag_value: "TagValue", # required
     #           },
     #         ],
+    #         import_mode: "FULL", # accepts FULL, INCREMENTAL
     #       }
     #
     # @!attribute [rw] job_name
@@ -1337,6 +1338,19 @@ module Aws::Personalize
     #   [1]: https://docs.aws.amazon.com/personalize/latest/dev/tagging-resources.html
     #   @return [Array<Types::Tag>]
     #
+    # @!attribute [rw] import_mode
+    #   Specify how to add the new records to an existing dataset. The
+    #   default import mode is `FULL`. If you haven't imported bulk records
+    #   into the dataset previously, you can only specify `FULL`.
+    #
+    #   * Specify `FULL` to overwrite all existing bulk data in your
+    #     dataset. Data you imported individually is not replaced.
+    #
+    #   * Specify `INCREMENTAL` to append the new records to the existing
+    #     data in your dataset. Amazon Personalize replaces any record with
+    #     the same ID with the new one.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateDatasetImportJobRequest AWS API Documentation
     #
     class CreateDatasetImportJobRequest < Struct.new(
@@ -1344,7 +1358,8 @@ module Aws::Personalize
       :dataset_arn,
       :data_source,
       :role_arn,
-      :tags)
+      :tags,
+      :import_mode)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2358,6 +2373,11 @@ module Aws::Personalize
     #   If a dataset import job fails, provides the reason why.
     #   @return [String]
     #
+    # @!attribute [rw] import_mode
+    #   The import mode used by the dataset import job to import new
+    #   records.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DatasetImportJob AWS API Documentation
     #
     class DatasetImportJob < Struct.new(
@@ -2369,7 +2389,8 @@ module Aws::Personalize
       :status,
       :creation_date_time,
       :last_updated_date_time,
-      :failure_reason)
+      :failure_reason,
+      :import_mode)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2414,6 +2435,16 @@ module Aws::Personalize
     #   If a dataset import job fails, the reason behind the failure.
     #   @return [String]
     #
+    # @!attribute [rw] import_mode
+    #   The import mode the dataset import job used to update the data in
+    #   the dataset. For more information see [Updating existing bulk
+    #   data][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/updating-existing-bulk-data.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DatasetImportJobSummary AWS API Documentation
     #
     class DatasetImportJobSummary < Struct.new(
@@ -2422,7 +2453,8 @@ module Aws::Personalize
       :status,
       :creation_date_time,
       :last_updated_date_time,
-      :failure_reason)
+      :failure_reason,
+      :import_mode)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-personalize.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-personalize/customizations'
 # @!group service
 module Aws::Personalize
 
-  GEM_VERSION = '1.42.0'
+  GEM_VERSION = '1.43.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-personalize
 version: !ruby/object:Gem::Version
-  version: 1.42.0
+  version: 1.43.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-05-23 00:00:00.000000000 Z
+date: 2022-08-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core