aws-sdk-personalize 1.22.0 → 1.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 57ca84f91ae09dcd33f95e24bc2bfaa4009361097dc0c55b18144433660b91e4
-  data.tar.gz: 348c41901d08afccb8f9efbbc776b1c465639432fcc2582b25be3287ec4d8dd3
+  metadata.gz: 21861151f0e79d08f061f15dad8a66437420dd0bf285c22b5ba20e2fdec125a7
+  data.tar.gz: 762f5ed0df85e77554b273a07d0f2dd7c00e9172a80e4bd640b585d224148298
 SHA512:
-  metadata.gz: b5804afc266f9b92fe0b6830753a27dddb2b3765e2ef9a5bb5d5a0bd4963c5a15699fed8cb675b6e3ef7adca4750c6787d32e7451ac1c8a0681cfb41d46bd701
-  data.tar.gz: 2eea08fb47af054c148aa86743583545dddd71937b44894babd870e36608d6c77b467cb6195eb0463141cee5e74d1575f4f14c5ee7e2f73ed089fea386ff6b72
+  metadata.gz: e39a706304565fb03c6a41def1616592282bf21d3a958bd042ae34a58c19489b41710c536a1c30b36df13f76fd71394e9f486c459d0e330ec5fe54a11a8fa36a
+  data.tar.gz: 7f411d1b37dd27f65c5de49ea6ae15cd51d332f8996927584a8a1ea3535983aaf01ac1c989d844b8a5bb1fb98153296f60f18c5287bab023b531c29ae52e4a4c

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.23.0 (2021-04-26)
+------------------
+
+* Feature - Added support for exporting data imported into an Amazon Personalize dataset to a specified data source (Amazon S3 bucket).
+
 1.22.0 (2021-03-10)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.22.0
+1.23.0

data/lib/aws-sdk-personalize.rb

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

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

@@ -350,8 +350,12 @@ module Aws::Personalize
     #
     # @option params [String] :filter_arn
     #   The ARN of the filter to apply to the batch inference job. For more
-    #   information on using filters, see Using Filters with Amazon
-    #   Personalize.
+    #   information on using filters, see [Filtering Batch
+    #   Recommendations][1]..
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html
     #
     # @option params [Integer] :num_results
     #   The number of recommendations to retreive.
@@ -366,8 +370,8 @@ module Aws::Personalize
     #
     # @option params [required, String] :role_arn
     #   The ARN of the Amazon Identity and Access Management role that has
-    #   permissions to read and write to your input and out Amazon S3 buckets
-    #   respectively.
+    #   permissions to read and write to your input and output Amazon S3
+    #   buckets respectively.
     #
     # @option params [Types::BatchInferenceJobConfig] :batch_inference_job_config
     #   The configuration details of a batch inference job.
@@ -597,6 +601,87 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Creates a job that exports data from your dataset to an Amazon S3
+    # bucket. To allow Amazon Personalize to export the training data, you
+    # must specify an service-linked AWS Identity and Access Management
+    # (IAM) role that gives Amazon Personalize `PutObject` permissions for
+    # your Amazon S3 bucket. For information, see [Dataset export job
+    # permissions requirements][1] in the Amazon Personalize developer
+    # guide.
+    #
+    # **Status**
+    #
+    # A dataset export job can be in one of the following states:
+    #
+    # * CREATE PENDING > CREATE IN\_PROGRESS > ACTIVE -or- CREATE
+    #   FAILED
+    #
+    # ^
+    #
+    # To get the status of the export job, call DescribeDatasetExportJob,
+    # and specify the Amazon Resource Name (ARN) of the dataset export job.
+    # The dataset export is complete when the status shows as ACTIVE. If the
+    # status shows as CREATE FAILED, the response includes a `failureReason`
+    # key, which describes why the job failed.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/export-permissions.html
+    #
+    # @option params [required, String] :job_name
+    #   The name for the dataset export job.
+    #
+    # @option params [required, String] :dataset_arn
+    #   The Amazon Resource Name (ARN) of the dataset that contains the data
+    #   to export.
+    #
+    # @option params [String] :ingestion_mode
+    #   The data to export, based on how you imported the data. You can choose
+    #   to export only `BULK` data that you imported using a dataset import
+    #   job, only `PUT` data that you imported incrementally (using the
+    #   console, PutEvents, PutUsers and PutItems operations), or `ALL` for
+    #   both types. The default value is `PUT`.
+    #
+    # @option params [required, String] :role_arn
+    #   The Amazon Resource Name (ARN) of the AWS Identity and Access
+    #   Management service role that has permissions to add data to your
+    #   output Amazon S3 bucket.
+    #
+    # @option params [required, Types::DatasetExportJobOutput] :job_output
+    #   The path to the Amazon S3 bucket where the job's output is stored.
+    #
+    # @return [Types::CreateDatasetExportJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateDatasetExportJobResponse#dataset_export_job_arn #dataset_export_job_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_dataset_export_job({
+    #     job_name: "Name", # required
+    #     dataset_arn: "Arn", # required
+    #     ingestion_mode: "BULK", # accepts BULK, PUT, ALL
+    #     role_arn: "RoleArn", # required
+    #     job_output: { # required
+    #       s3_data_destination: { # required
+    #         path: "S3Location", # required
+    #         kms_key_arn: "KmsKeyArn",
+    #       },
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.dataset_export_job_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateDatasetExportJob AWS API Documentation
+    #
+    # @overload create_dataset_export_job(params = {})
+    # @param [Hash] params ({})
+    def create_dataset_export_job(params = {}, options = {})
+      req = build_request(:create_dataset_export_job, params)
+      req.send_request(options)
+    end
+
     # Creates an empty dataset group. A dataset group contains related
     # datasets that supply data for training a model. A dataset group can
     # contain at most three datasets, one for each type of dataset:
@@ -687,9 +772,11 @@ module Aws::Personalize
     # Creates a job that imports training data from your data source (an
     # Amazon S3 bucket) to an Amazon Personalize dataset. To allow Amazon
     # Personalize to import the training data, you must specify an AWS
-    # Identity and Access Management (IAM) role that has permission to read
-    # from the data source, as Amazon Personalize makes a copy of your data
-    # and processes it in an internal AWS system.
+    # Identity and Access Management (IAM) service role that has permission
+    # to read from the data source, as Amazon Personalize makes a copy of
+    # your data and processes it in an internal AWS system. For information
+    # on granting access to your Amazon S3 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.
@@ -720,6 +807,10 @@ module Aws::Personalize
     #
     # * DescribeDatasetImportJob
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/granting-personalize-s3-access.html
+    #
     # @option params [required, String] :job_name
     #   The name for the dataset import job.
     #
@@ -1549,6 +1640,45 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Describes the dataset export job created by CreateDatasetExportJob,
+    # including the export job status.
+    #
+    # @option params [required, String] :dataset_export_job_arn
+    #   The Amazon Resource Name (ARN) of the dataset export job to describe.
+    #
+    # @return [Types::DescribeDatasetExportJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeDatasetExportJobResponse#dataset_export_job #dataset_export_job} => Types::DatasetExportJob
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_dataset_export_job({
+    #     dataset_export_job_arn: "Arn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.dataset_export_job.job_name #=> String
+    #   resp.dataset_export_job.dataset_export_job_arn #=> String
+    #   resp.dataset_export_job.dataset_arn #=> String
+    #   resp.dataset_export_job.ingestion_mode #=> String, one of "BULK", "PUT", "ALL"
+    #   resp.dataset_export_job.role_arn #=> String
+    #   resp.dataset_export_job.status #=> String
+    #   resp.dataset_export_job.job_output.s3_data_destination.path #=> String
+    #   resp.dataset_export_job.job_output.s3_data_destination.kms_key_arn #=> String
+    #   resp.dataset_export_job.creation_date_time #=> Time
+    #   resp.dataset_export_job.last_updated_date_time #=> Time
+    #   resp.dataset_export_job.failure_reason #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeDatasetExportJob AWS API Documentation
+    #
+    # @overload describe_dataset_export_job(params = {})
+    # @param [Hash] params ({})
+    def describe_dataset_export_job(params = {}, options = {})
+      req = build_request(:describe_dataset_export_job, params)
+      req.send_request(options)
+    end
+
     # Describes the given dataset group. For more information on dataset
     # groups, see CreateDatasetGroup.
     #
@@ -2089,6 +2219,59 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Returns a list of dataset export jobs that use the given dataset. When
+    # a dataset is not specified, all the dataset export jobs associated
+    # with the account are listed. The response provides the properties for
+    # each dataset export job, including the Amazon Resource Name (ARN). For
+    # more information on dataset export jobs, see CreateDatasetExportJob.
+    # For more information on datasets, see CreateDataset.
+    #
+    # @option params [String] :dataset_arn
+    #   The Amazon Resource Name (ARN) of the dataset to list the dataset
+    #   export jobs for.
+    #
+    # @option params [String] :next_token
+    #   A token returned from the previous call to `ListDatasetExportJobs` for
+    #   getting the next set of dataset export jobs (if they exist).
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of dataset export jobs to return.
+    #
+    # @return [Types::ListDatasetExportJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListDatasetExportJobsResponse#dataset_export_jobs #dataset_export_jobs} => Array<Types::DatasetExportJobSummary>
+    #   * {Types::ListDatasetExportJobsResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_dataset_export_jobs({
+    #     dataset_arn: "Arn",
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.dataset_export_jobs #=> Array
+    #   resp.dataset_export_jobs[0].dataset_export_job_arn #=> String
+    #   resp.dataset_export_jobs[0].job_name #=> String
+    #   resp.dataset_export_jobs[0].status #=> String
+    #   resp.dataset_export_jobs[0].creation_date_time #=> Time
+    #   resp.dataset_export_jobs[0].last_updated_date_time #=> Time
+    #   resp.dataset_export_jobs[0].failure_reason #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListDatasetExportJobs AWS API Documentation
+    #
+    # @overload list_dataset_export_jobs(params = {})
+    # @param [Hash] params ({})
+    def list_dataset_export_jobs(params = {}, options = {})
+      req = build_request(:list_dataset_export_jobs, params)
+      req.send_request(options)
+    end
+
     # Returns a list of dataset groups. The response provides the properties
     # for each dataset group, including the Amazon Resource Name (ARN). For
     # more information on dataset groups, see CreateDatasetGroup.
@@ -2304,6 +2487,8 @@ module Aws::Personalize
     #   * {Types::ListFiltersResponse#filters #filters} => Array<Types::FilterSummary>
     #   * {Types::ListFiltersResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_filters({
@@ -2593,7 +2778,7 @@ module Aws::Personalize
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-personalize'
-      context[:gem_version] = '1.22.0'
+      context[:gem_version] = '1.23.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -45,6 +45,8 @@ module Aws::Personalize
     CreateBatchInferenceJobResponse = Shapes::StructureShape.new(name: 'CreateBatchInferenceJobResponse')
     CreateCampaignRequest = Shapes::StructureShape.new(name: 'CreateCampaignRequest')
     CreateCampaignResponse = Shapes::StructureShape.new(name: 'CreateCampaignResponse')
+    CreateDatasetExportJobRequest = Shapes::StructureShape.new(name: 'CreateDatasetExportJobRequest')
+    CreateDatasetExportJobResponse = Shapes::StructureShape.new(name: 'CreateDatasetExportJobResponse')
     CreateDatasetGroupRequest = Shapes::StructureShape.new(name: 'CreateDatasetGroupRequest')
     CreateDatasetGroupResponse = Shapes::StructureShape.new(name: 'CreateDatasetGroupResponse')
     CreateDatasetImportJobRequest = Shapes::StructureShape.new(name: 'CreateDatasetImportJobRequest')
@@ -63,6 +65,10 @@ module Aws::Personalize
     CreateSolutionVersionResponse = Shapes::StructureShape.new(name: 'CreateSolutionVersionResponse')
     DataSource = Shapes::StructureShape.new(name: 'DataSource')
     Dataset = Shapes::StructureShape.new(name: 'Dataset')
+    DatasetExportJob = Shapes::StructureShape.new(name: 'DatasetExportJob')
+    DatasetExportJobOutput = Shapes::StructureShape.new(name: 'DatasetExportJobOutput')
+    DatasetExportJobSummary = Shapes::StructureShape.new(name: 'DatasetExportJobSummary')
+    DatasetExportJobs = Shapes::ListShape.new(name: 'DatasetExportJobs')
     DatasetGroup = Shapes::StructureShape.new(name: 'DatasetGroup')
     DatasetGroupSummary = Shapes::StructureShape.new(name: 'DatasetGroupSummary')
     DatasetGroups = Shapes::ListShape.new(name: 'DatasetGroups')
@@ -95,6 +101,8 @@ module Aws::Personalize
     DescribeBatchInferenceJobResponse = Shapes::StructureShape.new(name: 'DescribeBatchInferenceJobResponse')
     DescribeCampaignRequest = Shapes::StructureShape.new(name: 'DescribeCampaignRequest')
     DescribeCampaignResponse = Shapes::StructureShape.new(name: 'DescribeCampaignResponse')
+    DescribeDatasetExportJobRequest = Shapes::StructureShape.new(name: 'DescribeDatasetExportJobRequest')
+    DescribeDatasetExportJobResponse = Shapes::StructureShape.new(name: 'DescribeDatasetExportJobResponse')
     DescribeDatasetGroupRequest = Shapes::StructureShape.new(name: 'DescribeDatasetGroupRequest')
     DescribeDatasetGroupResponse = Shapes::StructureShape.new(name: 'DescribeDatasetGroupResponse')
     DescribeDatasetImportJobRequest = Shapes::StructureShape.new(name: 'DescribeDatasetImportJobRequest')
@@ -140,6 +148,7 @@ module Aws::Personalize
     HPOResourceConfig = Shapes::StructureShape.new(name: 'HPOResourceConfig')
     HyperParameterRanges = Shapes::StructureShape.new(name: 'HyperParameterRanges')
     HyperParameters = Shapes::MapShape.new(name: 'HyperParameters')
+    IngestionMode = Shapes::StringShape.new(name: 'IngestionMode')
     IntegerHyperParameterRange = Shapes::StructureShape.new(name: 'IntegerHyperParameterRange')
     IntegerHyperParameterRanges = Shapes::ListShape.new(name: 'IntegerHyperParameterRanges')
     IntegerMaxValue = Shapes::IntegerShape.new(name: 'IntegerMaxValue')
@@ -152,6 +161,8 @@ module Aws::Personalize
     ListBatchInferenceJobsResponse = Shapes::StructureShape.new(name: 'ListBatchInferenceJobsResponse')
     ListCampaignsRequest = Shapes::StructureShape.new(name: 'ListCampaignsRequest')
     ListCampaignsResponse = Shapes::StructureShape.new(name: 'ListCampaignsResponse')
+    ListDatasetExportJobsRequest = Shapes::StructureShape.new(name: 'ListDatasetExportJobsRequest')
+    ListDatasetExportJobsResponse = Shapes::StructureShape.new(name: 'ListDatasetExportJobsResponse')
     ListDatasetGroupsRequest = Shapes::StructureShape.new(name: 'ListDatasetGroupsRequest')
     ListDatasetGroupsResponse = Shapes::StructureShape.new(name: 'ListDatasetGroupsResponse')
     ListDatasetImportJobsRequest = Shapes::StructureShape.new(name: 'ListDatasetImportJobsRequest')
@@ -344,6 +355,16 @@ module Aws::Personalize
     CreateCampaignResponse.add_member(:campaign_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "campaignArn"))
     CreateCampaignResponse.struct_class = Types::CreateCampaignResponse
 
+    CreateDatasetExportJobRequest.add_member(:job_name, Shapes::ShapeRef.new(shape: Name, required: true, location_name: "jobName"))
+    CreateDatasetExportJobRequest.add_member(:dataset_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "datasetArn"))
+    CreateDatasetExportJobRequest.add_member(:ingestion_mode, Shapes::ShapeRef.new(shape: IngestionMode, location_name: "ingestionMode"))
+    CreateDatasetExportJobRequest.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, required: true, location_name: "roleArn"))
+    CreateDatasetExportJobRequest.add_member(:job_output, Shapes::ShapeRef.new(shape: DatasetExportJobOutput, required: true, location_name: "jobOutput"))
+    CreateDatasetExportJobRequest.struct_class = Types::CreateDatasetExportJobRequest
+
+    CreateDatasetExportJobResponse.add_member(:dataset_export_job_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "datasetExportJobArn"))
+    CreateDatasetExportJobResponse.struct_class = Types::CreateDatasetExportJobResponse
+
     CreateDatasetGroupRequest.add_member(:name, Shapes::ShapeRef.new(shape: Name, required: true, location_name: "name"))
     CreateDatasetGroupRequest.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, location_name: "roleArn"))
     CreateDatasetGroupRequest.add_member(:kms_key_arn, Shapes::ShapeRef.new(shape: KmsKeyArn, location_name: "kmsKeyArn"))
@@ -425,6 +446,31 @@ module Aws::Personalize
     Dataset.add_member(:last_updated_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "lastUpdatedDateTime"))
     Dataset.struct_class = Types::Dataset
 
+    DatasetExportJob.add_member(:job_name, Shapes::ShapeRef.new(shape: Name, location_name: "jobName"))
+    DatasetExportJob.add_member(:dataset_export_job_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "datasetExportJobArn"))
+    DatasetExportJob.add_member(:dataset_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "datasetArn"))
+    DatasetExportJob.add_member(:ingestion_mode, Shapes::ShapeRef.new(shape: IngestionMode, location_name: "ingestionMode"))
+    DatasetExportJob.add_member(:role_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "roleArn"))
+    DatasetExportJob.add_member(:status, Shapes::ShapeRef.new(shape: Status, location_name: "status"))
+    DatasetExportJob.add_member(:job_output, Shapes::ShapeRef.new(shape: DatasetExportJobOutput, location_name: "jobOutput"))
+    DatasetExportJob.add_member(:creation_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "creationDateTime"))
+    DatasetExportJob.add_member(:last_updated_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "lastUpdatedDateTime"))
+    DatasetExportJob.add_member(:failure_reason, Shapes::ShapeRef.new(shape: FailureReason, location_name: "failureReason"))
+    DatasetExportJob.struct_class = Types::DatasetExportJob
+
+    DatasetExportJobOutput.add_member(:s3_data_destination, Shapes::ShapeRef.new(shape: S3DataConfig, required: true, location_name: "s3DataDestination"))
+    DatasetExportJobOutput.struct_class = Types::DatasetExportJobOutput
+
+    DatasetExportJobSummary.add_member(:dataset_export_job_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "datasetExportJobArn"))
+    DatasetExportJobSummary.add_member(:job_name, Shapes::ShapeRef.new(shape: Name, location_name: "jobName"))
+    DatasetExportJobSummary.add_member(:status, Shapes::ShapeRef.new(shape: Status, location_name: "status"))
+    DatasetExportJobSummary.add_member(:creation_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "creationDateTime"))
+    DatasetExportJobSummary.add_member(:last_updated_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "lastUpdatedDateTime"))
+    DatasetExportJobSummary.add_member(:failure_reason, Shapes::ShapeRef.new(shape: FailureReason, location_name: "failureReason"))
+    DatasetExportJobSummary.struct_class = Types::DatasetExportJobSummary
+
+    DatasetExportJobs.member = Shapes::ShapeRef.new(shape: DatasetExportJobSummary)
+
     DatasetGroup.add_member(:name, Shapes::ShapeRef.new(shape: Name, location_name: "name"))
     DatasetGroup.add_member(:dataset_group_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "datasetGroupArn"))
     DatasetGroup.add_member(:status, Shapes::ShapeRef.new(shape: Status, location_name: "status"))
@@ -556,6 +602,12 @@ module Aws::Personalize
     DescribeCampaignResponse.add_member(:campaign, Shapes::ShapeRef.new(shape: Campaign, location_name: "campaign"))
     DescribeCampaignResponse.struct_class = Types::DescribeCampaignResponse
 
+    DescribeDatasetExportJobRequest.add_member(:dataset_export_job_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "datasetExportJobArn"))
+    DescribeDatasetExportJobRequest.struct_class = Types::DescribeDatasetExportJobRequest
+
+    DescribeDatasetExportJobResponse.add_member(:dataset_export_job, Shapes::ShapeRef.new(shape: DatasetExportJob, location_name: "datasetExportJob"))
+    DescribeDatasetExportJobResponse.struct_class = Types::DescribeDatasetExportJobResponse
+
     DescribeDatasetGroupRequest.add_member(:dataset_group_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "datasetGroupArn"))
     DescribeDatasetGroupRequest.struct_class = Types::DescribeDatasetGroupRequest
 
@@ -733,6 +785,15 @@ module Aws::Personalize
     ListCampaignsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
     ListCampaignsResponse.struct_class = Types::ListCampaignsResponse
 
+    ListDatasetExportJobsRequest.add_member(:dataset_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "datasetArn"))
+    ListDatasetExportJobsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
+    ListDatasetExportJobsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "maxResults"))
+    ListDatasetExportJobsRequest.struct_class = Types::ListDatasetExportJobsRequest
+
+    ListDatasetExportJobsResponse.add_member(:dataset_export_jobs, Shapes::ShapeRef.new(shape: DatasetExportJobs, location_name: "datasetExportJobs"))
+    ListDatasetExportJobsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
+    ListDatasetExportJobsResponse.struct_class = Types::ListDatasetExportJobsResponse
+
     ListDatasetGroupsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
     ListDatasetGroupsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "maxResults"))
     ListDatasetGroupsRequest.struct_class = Types::ListDatasetGroupsRequest
@@ -980,6 +1041,19 @@ module Aws::Personalize
         o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
       end)
 
+      api.add_operation(:create_dataset_export_job, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "CreateDatasetExportJob"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: CreateDatasetExportJobRequest)
+        o.output = Shapes::ShapeRef.new(shape: CreateDatasetExportJobResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceAlreadyExistsException)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
+      end)
+
       api.add_operation(:create_dataset_group, Seahorse::Model::Operation.new.tap do |o|
         o.name = "CreateDatasetGroup"
         o.http_method = "POST"
@@ -1182,6 +1256,16 @@ module Aws::Personalize
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
       end)
 
+      api.add_operation(:describe_dataset_export_job, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeDatasetExportJob"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DescribeDatasetExportJobRequest)
+        o.output = Shapes::ShapeRef.new(shape: DescribeDatasetExportJobResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+      end)
+
       api.add_operation(:describe_dataset_group, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeDatasetGroup"
         o.http_method = "POST"
@@ -1315,6 +1399,22 @@ module Aws::Personalize
         )
       end)
 
+      api.add_operation(:list_dataset_export_jobs, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListDatasetExportJobs"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListDatasetExportJobsRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListDatasetExportJobsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:list_dataset_groups, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListDatasetGroups"
         o.http_method = "POST"
@@ -1386,6 +1486,12 @@ module Aws::Personalize
         o.output = Shapes::ShapeRef.new(shape: ListFiltersResponse)
         o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
       end)
 
       api.add_operation(:list_recipes, Seahorse::Model::Operation.new.tap do |o|

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

@@ -244,7 +244,11 @@ module Aws::Personalize
     #   hyperparameters, including `explorationWeight` and
     #   `explorationItemAgeCutOff`, you want to use to configure the amount
     #   of item exploration Amazon Personalize uses when recommending items.
-    #   See native-recipe-new-item-USER\_PERSONALIZATION.
+    #   See [User-Personalization][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html
     #   @return [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/BatchInferenceJobConfig AWS API Documentation
@@ -665,8 +669,12 @@ module Aws::Personalize
     #
     # @!attribute [rw] filter_arn
     #   The ARN of the filter to apply to the batch inference job. For more
-    #   information on using filters, see Using Filters with Amazon
-    #   Personalize.
+    #   information on using filters, see [Filtering Batch
+    #   Recommendations][1]..
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html
     #   @return [String]
     #
     # @!attribute [rw] num_results
@@ -685,7 +693,7 @@ module Aws::Personalize
     #
     # @!attribute [rw] role_arn
     #   The ARN of the Amazon Identity and Access Management role that has
-    #   permissions to read and write to your input and out Amazon S3
+    #   permissions to read and write to your input and output Amazon S3
     #   buckets respectively.
     #   @return [String]
     #
@@ -775,6 +783,73 @@ module Aws::Personalize
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass CreateDatasetExportJobRequest
+    #   data as a hash:
+    #
+    #       {
+    #         job_name: "Name", # required
+    #         dataset_arn: "Arn", # required
+    #         ingestion_mode: "BULK", # accepts BULK, PUT, ALL
+    #         role_arn: "RoleArn", # required
+    #         job_output: { # required
+    #           s3_data_destination: { # required
+    #             path: "S3Location", # required
+    #             kms_key_arn: "KmsKeyArn",
+    #           },
+    #         },
+    #       }
+    #
+    # @!attribute [rw] job_name
+    #   The name for the dataset export job.
+    #   @return [String]
+    #
+    # @!attribute [rw] dataset_arn
+    #   The Amazon Resource Name (ARN) of the dataset that contains the data
+    #   to export.
+    #   @return [String]
+    #
+    # @!attribute [rw] ingestion_mode
+    #   The data to export, based on how you imported the data. You can
+    #   choose to export only `BULK` data that you imported using a dataset
+    #   import job, only `PUT` data that you imported incrementally (using
+    #   the console, PutEvents, PutUsers and PutItems operations), or `ALL`
+    #   for both types. The default value is `PUT`.
+    #   @return [String]
+    #
+    # @!attribute [rw] role_arn
+    #   The Amazon Resource Name (ARN) of the AWS Identity and Access
+    #   Management service role that has permissions to add data to your
+    #   output Amazon S3 bucket.
+    #   @return [String]
+    #
+    # @!attribute [rw] job_output
+    #   The path to the Amazon S3 bucket where the job's output is stored.
+    #   @return [Types::DatasetExportJobOutput]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateDatasetExportJobRequest AWS API Documentation
+    #
+    class CreateDatasetExportJobRequest < Struct.new(
+      :job_name,
+      :dataset_arn,
+      :ingestion_mode,
+      :role_arn,
+      :job_output)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] dataset_export_job_arn
+    #   The Amazon Resource Name (ARN) of the dataset export job.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateDatasetExportJobResponse AWS API Documentation
+    #
+    class CreateDatasetExportJobResponse < Struct.new(
+      :dataset_export_job_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass CreateDatasetGroupRequest
     #   data as a hash:
     #
@@ -1268,7 +1343,7 @@ module Aws::Personalize
     #   The path to the Amazon S3 bucket where the data that you want to
     #   upload to your dataset is stored. For example:
     #
-    #   `s3://bucket-name/training-data.csv`
+    #   `s3://bucket-name/folder-name/`
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DataSource AWS API Documentation
@@ -1342,6 +1417,163 @@ module Aws::Personalize
       include Aws::Structure
     end
 
+    # Describes a job that exports a dataset to an Amazon S3 bucket. For
+    # more information, see CreateDatasetExportJob.
+    #
+    # A dataset export job can be in one of the following states:
+    #
+    # * CREATE PENDING &gt; CREATE IN\_PROGRESS &gt; ACTIVE -or- CREATE
+    #   FAILED
+    #
+    # ^
+    #
+    # @!attribute [rw] job_name
+    #   The name of the export job.
+    #   @return [String]
+    #
+    # @!attribute [rw] dataset_export_job_arn
+    #   The Amazon Resource Name (ARN) of the dataset export job.
+    #   @return [String]
+    #
+    # @!attribute [rw] dataset_arn
+    #   The Amazon Resource Name (ARN) of the dataset to export.
+    #   @return [String]
+    #
+    # @!attribute [rw] ingestion_mode
+    #   The data to export, based on how you imported the data. You can
+    #   choose to export `BULK` data that you imported using a dataset
+    #   import job, `PUT` data that you imported incrementally (using the
+    #   console, PutEvents, PutUsers and PutItems operations), or `ALL` for
+    #   both types. The default value is `PUT`.
+    #   @return [String]
+    #
+    # @!attribute [rw] role_arn
+    #   The Amazon Resource Name (ARN) of the AWS Identity and Access
+    #   Management service role that has permissions to add data to your
+    #   output Amazon S3 bucket.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   The status of the dataset export job.
+    #
+    #   A dataset export job can be in one of the following states:
+    #
+    #   * CREATE PENDING &gt; CREATE IN\_PROGRESS &gt; ACTIVE -or- CREATE
+    #     FAILED
+    #
+    #   ^
+    #   @return [String]
+    #
+    # @!attribute [rw] job_output
+    #   The path to the Amazon S3 bucket where the job's output is stored.
+    #   For example:
+    #
+    #   `s3://bucket-name/folder-name/`
+    #   @return [Types::DatasetExportJobOutput]
+    #
+    # @!attribute [rw] creation_date_time
+    #   The creation date and time (in Unix time) of the dataset export job.
+    #   @return [Time]
+    #
+    # @!attribute [rw] last_updated_date_time
+    #   The date and time (in Unix time) the status of the dataset export
+    #   job was last updated.
+    #   @return [Time]
+    #
+    # @!attribute [rw] failure_reason
+    #   If a dataset export job fails, provides the reason why.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DatasetExportJob AWS API Documentation
+    #
+    class DatasetExportJob < Struct.new(
+      :job_name,
+      :dataset_export_job_arn,
+      :dataset_arn,
+      :ingestion_mode,
+      :role_arn,
+      :status,
+      :job_output,
+      :creation_date_time,
+      :last_updated_date_time,
+      :failure_reason)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The output configuration parameters of a dataset export job.
+    #
+    # @note When making an API call, you may pass DatasetExportJobOutput
+    #   data as a hash:
+    #
+    #       {
+    #         s3_data_destination: { # required
+    #           path: "S3Location", # required
+    #           kms_key_arn: "KmsKeyArn",
+    #         },
+    #       }
+    #
+    # @!attribute [rw] s3_data_destination
+    #   The configuration details of an Amazon S3 input or output bucket.
+    #   @return [Types::S3DataConfig]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DatasetExportJobOutput AWS API Documentation
+    #
+    class DatasetExportJobOutput < Struct.new(
+      :s3_data_destination)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Provides a summary of the properties of a dataset export job. For a
+    # complete listing, call the DescribeDatasetExportJob API.
+    #
+    # @!attribute [rw] dataset_export_job_arn
+    #   The Amazon Resource Name (ARN) of the dataset export job.
+    #   @return [String]
+    #
+    # @!attribute [rw] job_name
+    #   The name of the dataset export job.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   The status of the dataset export job.
+    #
+    #   A dataset export job can be in one of the following states:
+    #
+    #   * CREATE PENDING &gt; CREATE IN\_PROGRESS &gt; ACTIVE -or- CREATE
+    #     FAILED
+    #
+    #   ^
+    #   @return [String]
+    #
+    # @!attribute [rw] creation_date_time
+    #   The date and time (in Unix time) that the dataset export job was
+    #   created.
+    #   @return [Time]
+    #
+    # @!attribute [rw] last_updated_date_time
+    #   The date and time (in Unix time) that the dataset export job status
+    #   was last updated.
+    #   @return [Time]
+    #
+    # @!attribute [rw] failure_reason
+    #   If a dataset export job fails, the reason behind the failure.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DatasetExportJobSummary AWS API Documentation
+    #
+    class DatasetExportJobSummary < Struct.new(
+      :dataset_export_job_arn,
+      :job_name,
+      :status,
+      :creation_date_time,
+      :last_updated_date_time,
+      :failure_reason)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A dataset group is a collection of related datasets (Interactions,
     # User, and Item). You create a dataset group by calling
     # CreateDatasetGroup. You then create a dataset and add it to a dataset
@@ -1556,7 +1788,8 @@ module Aws::Personalize
     #   @return [Time]
     #
     # @!attribute [rw] last_updated_date_time
-    #   The date and time (in Unix time) that the dataset was last updated.
+    #   The date and time (in Unix time) that the dataset import job status
+    #   was last updated.
     #   @return [Time]
     #
     # @!attribute [rw] failure_reason
@@ -2037,6 +2270,48 @@ module Aws::Personalize
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DescribeDatasetExportJobRequest
+    #   data as a hash:
+    #
+    #       {
+    #         dataset_export_job_arn: "Arn", # required
+    #       }
+    #
+    # @!attribute [rw] dataset_export_job_arn
+    #   The Amazon Resource Name (ARN) of the dataset export job to
+    #   describe.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeDatasetExportJobRequest AWS API Documentation
+    #
+    class DescribeDatasetExportJobRequest < Struct.new(
+      :dataset_export_job_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] dataset_export_job
+    #   Information about the dataset export job, including the status.
+    #
+    #   The status is one of the following values:
+    #
+    #   * CREATE PENDING
+    #
+    #   * CREATE IN\_PROGRESS
+    #
+    #   * ACTIVE
+    #
+    #   * CREATE FAILED
+    #   @return [Types::DatasetExportJob]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeDatasetExportJobResponse AWS API Documentation
+    #
+    class DescribeDatasetExportJobResponse < Struct.new(
+      :dataset_export_job)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DescribeDatasetGroupRequest
     #   data as a hash:
     #
@@ -2947,7 +3222,7 @@ module Aws::Personalize
     #   @return [Array<Types::BatchInferenceJobSummary>]
     #
     # @!attribute [rw] next_token
-    #   The token to use to retreive the next page of results. The value is
+    #   The token to use to retrieve the next page of results. The value is
     #   `null` when there are no more results to return.
     #   @return [String]
     #
@@ -3011,6 +3286,57 @@ module Aws::Personalize
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass ListDatasetExportJobsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         dataset_arn: "Arn",
+    #         next_token: "NextToken",
+    #         max_results: 1,
+    #       }
+    #
+    # @!attribute [rw] dataset_arn
+    #   The Amazon Resource Name (ARN) of the dataset to list the dataset
+    #   export jobs for.
+    #   @return [String]
+    #
+    # @!attribute [rw] next_token
+    #   A token returned from the previous call to `ListDatasetExportJobs`
+    #   for getting the next set of dataset export jobs (if they exist).
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of dataset export jobs to return.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListDatasetExportJobsRequest AWS API Documentation
+    #
+    class ListDatasetExportJobsRequest < Struct.new(
+      :dataset_arn,
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] dataset_export_jobs
+    #   The list of dataset export jobs.
+    #   @return [Array<Types::DatasetExportJobSummary>]
+    #
+    # @!attribute [rw] next_token
+    #   A token for getting the next set of dataset export jobs (if they
+    #   exist).
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListDatasetExportJobsResponse AWS API Documentation
+    #
+    class ListDatasetExportJobsResponse < Struct.new(
+      :dataset_export_jobs,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListDatasetGroupsRequest
     #   data as a hash:
     #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-personalize
 version: !ruby/object:Gem::Version
-  version: 1.22.0
+  version: 1.23.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-10 00:00:00.000000000 Z
+date: 2021-04-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -66,8 +66,8 @@ homepage: https://github.com/aws/aws-sdk-ruby
 licenses:
 - Apache-2.0
 metadata:
-  source_code_uri: https://github.com/aws/aws-sdk-ruby/tree/master/gems/aws-sdk-personalize
-  changelog_uri: https://github.com/aws/aws-sdk-ruby/tree/master/gems/aws-sdk-personalize/CHANGELOG.md
+  source_code_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-personalize
+  changelog_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-personalize/CHANGELOG.md
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -83,8 +83,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6.2
+rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
 summary: AWS SDK for Ruby - Amazon Personalize