aws-sdk-personalize 1.33.0 → 1.37.0

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

@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 
@@ -73,6 +74,7 @@ module Aws::Personalize
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
 
@@ -119,7 +121,9 @@ module Aws::Personalize
     #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
     #       are very aggressive. Construct and pass an instance of
     #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
-    #       enable retries and extended timeouts.
+    #       enable retries and extended timeouts. Instance profile credential
+    #       fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
+    #       to true.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -173,6 +177,10 @@ module Aws::Personalize
     #     Used only in `standard` and adaptive retry modes. Specifies whether to apply
     #     a clock skew correction and retry requests with skewed client clocks.
     #
+    #   @option options [String] :defaults_mode ("legacy")
+    #     See {Aws::DefaultsModeConfiguration} for a list of the
+    #     accepted modes and the configuration defaults that are included.
+    #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -305,7 +313,7 @@ module Aws::Personalize
     #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
-    #   @option options [Integer] :http_read_timeout (60) The default
+    #   @option options [Float] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
     #     safely be set per-request on the session.
     #
@@ -321,6 +329,9 @@ module Aws::Personalize
     #     disables this behaviour.  This value can safely be set per
     #     request on the session.
     #
+    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
+    #     in seconds.
+    #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
     #
@@ -429,7 +440,78 @@ module Aws::Personalize
       req.send_request(options)
     end
 
-    # Creates a campaign by deploying a solution version. When a client
+    # Creates a batch segment job. The operation can handle up to 50 million
+    # records and the input file must be in JSON format. For more
+    # information, see recommendations-batch.
+    #
+    # @option params [required, String] :job_name
+    #   The name of the batch segment job to create.
+    #
+    # @option params [required, String] :solution_version_arn
+    #   The Amazon Resource Name (ARN) of the solution version you want the
+    #   batch segment job to use to generate batch segments.
+    #
+    # @option params [String] :filter_arn
+    #   The ARN of the filter to apply to the batch segment job. For more
+    #   information on using filters, see filter-batch.
+    #
+    # @option params [Integer] :num_results
+    #   The number of predicted users generated by the batch segment job for
+    #   each line of input data.
+    #
+    # @option params [required, Types::BatchSegmentJobInput] :job_input
+    #   The Amazon S3 path for the input data used to generate the batch
+    #   segment job.
+    #
+    # @option params [required, Types::BatchSegmentJobOutput] :job_output
+    #   The Amazon S3 path for the bucket where the job's output will be
+    #   stored.
+    #
+    # @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 output Amazon S3
+    #   buckets respectively.
+    #
+    # @return [Types::CreateBatchSegmentJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateBatchSegmentJobResponse#batch_segment_job_arn #batch_segment_job_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_batch_segment_job({
+    #     job_name: "Name", # required
+    #     solution_version_arn: "Arn", # required
+    #     filter_arn: "Arn",
+    #     num_results: 1,
+    #     job_input: { # required
+    #       s3_data_source: { # required
+    #         path: "S3Location", # required
+    #         kms_key_arn: "KmsKeyArn",
+    #       },
+    #     },
+    #     job_output: { # required
+    #       s3_data_destination: { # required
+    #         path: "S3Location", # required
+    #         kms_key_arn: "KmsKeyArn",
+    #       },
+    #     },
+    #     role_arn: "RoleArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.batch_segment_job_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateBatchSegmentJob AWS API Documentation
+    #
+    # @overload create_batch_segment_job(params = {})
+    # @param [Hash] params ({})
+    def create_batch_segment_job(params = {}, options = {})
+      req = build_request(:create_batch_segment_job, params)
+      req.send_request(options)
+    end
+
+    # Creates a campaign that deploys a solution version. When a client
     # calls the [GetRecommendations][1] and [GetPersonalizedRanking][2]
     # APIs, a campaign is specified in the request.
     #
@@ -689,9 +771,9 @@ module Aws::Personalize
       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:
+    # Creates an empty dataset group. A dataset group is a container for
+    # Amazon Personalize resources. A dataset group can contain at most
+    # three datasets, one for each type of dataset:
     #
     # * Interactions
     #
@@ -699,9 +781,13 @@ module Aws::Personalize
     #
     # * Users
     #
-    # To train a model (create a solution), a dataset group that contains an
-    # `Interactions` dataset is required. Call CreateDataset to add a
-    # dataset to the group.
+    # A dataset group can be a Domain dataset group, where you specify a
+    # domain and use pre-configured resources like recommenders, or a Custom
+    # dataset group, where you use custom resources, such as a solution with
+    # a solution version, that you deploy with a campaign. If you start with
+    # a Domain dataset group, you can still add custom resources such as
+    # solutions and solution versions trained with recipes for custom use
+    # cases and deployed with campaigns.
     #
     # A dataset group can be in one of the following states:
     #
@@ -752,9 +838,17 @@ module Aws::Personalize
     #   The Amazon Resource Name (ARN) of a Key Management Service (KMS) key
     #   used to encrypt the datasets.
     #
+    # @option params [String] :domain
+    #   The domain of the dataset group. Specify a domain to create a Domain
+    #   dataset group. The domain you specify determines the default schemas
+    #   for datasets and the use cases available for recommenders. If you
+    #   don't specify a domain, you create a Custom dataset group with
+    #   solution versions that you deploy with a campaign.
+    #
     # @return [Types::CreateDatasetGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateDatasetGroupResponse#dataset_group_arn #dataset_group_arn} => String
+    #   * {Types::CreateDatasetGroupResponse#domain #domain} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -762,11 +856,13 @@ module Aws::Personalize
     #     name: "Name", # required
     #     role_arn: "RoleArn",
     #     kms_key_arn: "KmsKeyArn",
+    #     domain: "ECOMMERCE", # accepts ECOMMERCE, VIDEO_ON_DEMAND
     #   })
     #
     # @example Response structure
     #
     #   resp.dataset_group_arn #=> String
+    #   resp.domain #=> String, one of "ECOMMERCE", "VIDEO_ON_DEMAND"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateDatasetGroup AWS API Documentation
     #
@@ -973,12 +1069,127 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Creates a recommender with the recipe (a Domain dataset group use
+    # case) you specify. You create recommenders for a Domain dataset group
+    # and specify the recommender's Amazon Resource Name (ARN) when you
+    # make a [GetRecommendations][1] request.
+    #
+    # **Minimum recommendation requests per second**
+    #
+    # When you create a recommender, you can configure the recommender's
+    # minimum recommendation requests per second. The minimum recommendation
+    # requests per second (`minRecommendationRequestsPerSecond`) specifies
+    # the baseline recommendation request throughput provisioned by Amazon
+    # Personalize. The default minRecommendationRequestsPerSecond is `1`. A
+    # recommendation request is a single `GetRecommendations` operation.
+    # Request throughput is measured in requests per second and Amazon
+    # Personalize uses your requests per second to derive your requests per
+    # hour and the price of your recommender usage.
+    #
+    # If your requests per second increases beyond
+    # `minRecommendationRequestsPerSecond`, Amazon Personalize auto-scales
+    # the provisioned capacity up and down, but never below
+    # `minRecommendationRequestsPerSecond`. There's a short time delay
+    # while the capacity is increased that might cause loss of requests.
+    #
+    # Your bill is the greater of either the minimum requests per hour
+    # (based on minRecommendationRequestsPerSecond) or the actual number of
+    # requests. The actual request throughput used is calculated as the
+    # average requests/second within a one-hour window. We recommend
+    # starting with the default `minRecommendationRequestsPerSecond`, track
+    # your usage using Amazon CloudWatch metrics, and then increase the
+    # `minRecommendationRequestsPerSecond` as necessary.
+    #
+    # **Status**
+    #
+    # A recommender can be in one of the following states:
+    #
+    # * CREATE PENDING > CREATE IN\_PROGRESS > ACTIVE -or- CREATE
+    #   FAILED
+    #
+    # * DELETE PENDING > DELETE IN\_PROGRESS
+    #
+    # To get the recommender status, call DescribeRecommender.
+    #
+    # <note markdown="1"> Wait until the `status` of the recommender is `ACTIVE` before asking
+    # the recommender for recommendations.
+    #
+    #  </note>
+    #
+    # **Related APIs**
+    #
+    # * ListRecommenders
+    #
+    # * DescribeRecommender
+    #
+    # * UpdateRecommender
+    #
+    # * DeleteRecommender
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html
+    #
+    # @option params [required, String] :name
+    #   The name of the recommender.
+    #
+    # @option params [required, String] :dataset_group_arn
+    #   The Amazon Resource Name (ARN) of the destination domain dataset group
+    #   for the recommender.
+    #
+    # @option params [required, String] :recipe_arn
+    #   The Amazon Resource Name (ARN) of the recipe that the recommender will
+    #   use. For a recommender, a recipe is a Domain dataset group use case.
+    #   Only Domain dataset group use cases can be used to create a
+    #   recommender. For information about use cases see [Choosing recommender
+    #   use cases][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html
+    #
+    # @option params [Types::RecommenderConfig] :recommender_config
+    #   The configuration details of the recommender.
+    #
+    # @return [Types::CreateRecommenderResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateRecommenderResponse#recommender_arn #recommender_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_recommender({
+    #     name: "Name", # required
+    #     dataset_group_arn: "Arn", # required
+    #     recipe_arn: "Arn", # required
+    #     recommender_config: {
+    #       item_exploration_config: {
+    #         "ParameterName" => "ParameterValue",
+    #       },
+    #       min_recommendation_requests_per_second: 1,
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.recommender_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateRecommender AWS API Documentation
+    #
+    # @overload create_recommender(params = {})
+    # @param [Hash] params ({})
+    def create_recommender(params = {}, options = {})
+      req = build_request(:create_recommender, params)
+      req.send_request(options)
+    end
+
     # Creates an Amazon Personalize schema from the specified schema string.
     # The schema you create must be in Avro JSON format.
     #
     # Amazon Personalize recognizes three schema variants. Each schema is
     # associated with a dataset type and has a set of required field and
-    # keywords. You specify a schema when you call CreateDataset.
+    # keywords. If you are creating a schema for a dataset in a Domain
+    # dataset group, you provide the domain of the Domain dataset group. You
+    # specify a schema when you call CreateDataset.
     #
     # **Related APIs**
     #
@@ -994,6 +1205,11 @@ module Aws::Personalize
     # @option params [required, String] :schema
     #   A schema in Avro JSON format.
     #
+    # @option params [String] :domain
+    #   The domain for the schema. If you are creating a schema for a dataset
+    #   in a Domain dataset group, specify the domain you chose when you
+    #   created the Domain dataset group.
+    #
     # @return [Types::CreateSchemaResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateSchemaResponse#schema_arn #schema_arn} => String
@@ -1003,6 +1219,7 @@ module Aws::Personalize
     #   resp = client.create_schema({
     #     name: "Name", # required
     #     schema: "AvroSchema", # required
+    #     domain: "ECOMMERCE", # accepts ECOMMERCE, VIDEO_ON_DEMAND
     #   })
     #
     # @example Response structure
@@ -1198,10 +1415,10 @@ module Aws::Personalize
       req.send_request(options)
     end
 
-    # Trains or retrains an active solution. A solution is created using the
-    # CreateSolution operation and must be in the ACTIVE state before
-    # calling `CreateSolutionVersion`. A new version of the solution is
-    # created every time you call this operation.
+    # Trains or retrains an active solution in a Custom dataset group. A
+    # solution is created using the CreateSolution operation and must be in
+    # the ACTIVE state before calling `CreateSolutionVersion`. A new version
+    # of the solution is created every time you call this operation.
     #
     # **Status**
     #
@@ -1415,6 +1632,33 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Deactivates and removes a recommender. A deleted recommender can no
+    # longer be specified in a [GetRecommendations][1] request.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html
+    #
+    # @option params [required, String] :recommender_arn
+    #   The Amazon Resource Name (ARN) of the recommender to delete.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_recommender({
+    #     recommender_arn: "Arn", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DeleteRecommender AWS API Documentation
+    #
+    # @overload delete_recommender(params = {})
+    # @param [Hash] params ({})
+    def delete_recommender(params = {}, options = {})
+      req = build_request(:delete_recommender, params)
+      req.send_request(options)
+    end
+
     # Deletes a schema. Before deleting a schema, you must delete all
     # datasets referencing the schema. For more information on schemas, see
     # CreateSchema.
@@ -1566,6 +1810,49 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Gets the properties of a batch segment job including name, Amazon
+    # Resource Name (ARN), status, input and output configurations, and the
+    # ARN of the solution version used to generate segments.
+    #
+    # @option params [required, String] :batch_segment_job_arn
+    #   The ARN of the batch segment job to describe.
+    #
+    # @return [Types::DescribeBatchSegmentJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeBatchSegmentJobResponse#batch_segment_job #batch_segment_job} => Types::BatchSegmentJob
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_batch_segment_job({
+    #     batch_segment_job_arn: "Arn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.batch_segment_job.job_name #=> String
+    #   resp.batch_segment_job.batch_segment_job_arn #=> String
+    #   resp.batch_segment_job.filter_arn #=> String
+    #   resp.batch_segment_job.failure_reason #=> String
+    #   resp.batch_segment_job.solution_version_arn #=> String
+    #   resp.batch_segment_job.num_results #=> Integer
+    #   resp.batch_segment_job.job_input.s3_data_source.path #=> String
+    #   resp.batch_segment_job.job_input.s3_data_source.kms_key_arn #=> String
+    #   resp.batch_segment_job.job_output.s3_data_destination.path #=> String
+    #   resp.batch_segment_job.job_output.s3_data_destination.kms_key_arn #=> String
+    #   resp.batch_segment_job.role_arn #=> String
+    #   resp.batch_segment_job.status #=> String
+    #   resp.batch_segment_job.creation_date_time #=> Time
+    #   resp.batch_segment_job.last_updated_date_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeBatchSegmentJob AWS API Documentation
+    #
+    # @overload describe_batch_segment_job(params = {})
+    # @param [Hash] params ({})
+    def describe_batch_segment_job(params = {}, options = {})
+      req = build_request(:describe_batch_segment_job, params)
+      req.send_request(options)
+    end
+
     # Describes the given campaign, including its status.
     #
     # A campaign can be in one of the following states:
@@ -1724,6 +2011,7 @@ module Aws::Personalize
     #   resp.dataset_group.creation_date_time #=> Time
     #   resp.dataset_group.last_updated_date_time #=> Time
     #   resp.dataset_group.failure_reason #=> String
+    #   resp.dataset_group.domain #=> String, one of "ECOMMERCE", "VIDEO_ON_DEMAND"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeDatasetGroup AWS API Documentation
     #
@@ -1934,6 +2222,67 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Describes the given recommender, including its status.
+    #
+    # A recommender can be in one of the following states:
+    #
+    # * CREATE PENDING &gt; CREATE IN\_PROGRESS &gt; ACTIVE -or- CREATE
+    #   FAILED
+    #
+    # * DELETE PENDING &gt; DELETE IN\_PROGRESS
+    #
+    # When the `status` is `CREATE FAILED`, the response includes the
+    # `failureReason` key, which describes why.
+    #
+    # For more information on recommenders, see [CreateRecommender][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/API_CreateRecommender.html
+    #
+    # @option params [required, String] :recommender_arn
+    #   The Amazon Resource Name (ARN) of the recommender to describe.
+    #
+    # @return [Types::DescribeRecommenderResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeRecommenderResponse#recommender #recommender} => Types::Recommender
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_recommender({
+    #     recommender_arn: "Arn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.recommender.recommender_arn #=> String
+    #   resp.recommender.dataset_group_arn #=> String
+    #   resp.recommender.name #=> String
+    #   resp.recommender.recipe_arn #=> String
+    #   resp.recommender.recommender_config.item_exploration_config #=> Hash
+    #   resp.recommender.recommender_config.item_exploration_config["ParameterName"] #=> String
+    #   resp.recommender.recommender_config.min_recommendation_requests_per_second #=> Integer
+    #   resp.recommender.creation_date_time #=> Time
+    #   resp.recommender.last_updated_date_time #=> Time
+    #   resp.recommender.status #=> String
+    #   resp.recommender.failure_reason #=> String
+    #   resp.recommender.latest_recommender_update.recommender_config.item_exploration_config #=> Hash
+    #   resp.recommender.latest_recommender_update.recommender_config.item_exploration_config["ParameterName"] #=> String
+    #   resp.recommender.latest_recommender_update.recommender_config.min_recommendation_requests_per_second #=> Integer
+    #   resp.recommender.latest_recommender_update.creation_date_time #=> Time
+    #   resp.recommender.latest_recommender_update.last_updated_date_time #=> Time
+    #   resp.recommender.latest_recommender_update.status #=> String
+    #   resp.recommender.latest_recommender_update.failure_reason #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeRecommender AWS API Documentation
+    #
+    # @overload describe_recommender(params = {})
+    # @param [Hash] params ({})
+    def describe_recommender(params = {}, options = {})
+      req = build_request(:describe_recommender, params)
+      req.send_request(options)
+    end
+
     # Describes a schema. For more information on schemas, see CreateSchema.
     #
     # @option params [required, String] :schema_arn
@@ -1956,6 +2305,7 @@ module Aws::Personalize
     #   resp.schema.schema #=> String
     #   resp.schema.creation_date_time #=> Time
     #   resp.schema.last_updated_date_time #=> Time
+    #   resp.schema.domain #=> String, one of "ECOMMERCE", "VIDEO_ON_DEMAND"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeSchema AWS API Documentation
     #
@@ -2189,6 +2539,56 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Gets a list of the batch segment jobs that have been performed off of
+    # a solution version that you specify.
+    #
+    # @option params [String] :solution_version_arn
+    #   The Amazon Resource Name (ARN) of the solution version that the batch
+    #   segment jobs used to generate batch segments.
+    #
+    # @option params [String] :next_token
+    #   The token to request the next page of results.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of batch segment job results to return in each
+    #   page. The default value is 100.
+    #
+    # @return [Types::ListBatchSegmentJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListBatchSegmentJobsResponse#batch_segment_jobs #batch_segment_jobs} => Array&lt;Types::BatchSegmentJobSummary&gt;
+    #   * {Types::ListBatchSegmentJobsResponse#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_batch_segment_jobs({
+    #     solution_version_arn: "Arn",
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.batch_segment_jobs #=> Array
+    #   resp.batch_segment_jobs[0].batch_segment_job_arn #=> String
+    #   resp.batch_segment_jobs[0].job_name #=> String
+    #   resp.batch_segment_jobs[0].status #=> String
+    #   resp.batch_segment_jobs[0].creation_date_time #=> Time
+    #   resp.batch_segment_jobs[0].last_updated_date_time #=> Time
+    #   resp.batch_segment_jobs[0].failure_reason #=> String
+    #   resp.batch_segment_jobs[0].solution_version_arn #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListBatchSegmentJobs AWS API Documentation
+    #
+    # @overload list_batch_segment_jobs(params = {})
+    # @param [Hash] params ({})
+    def list_batch_segment_jobs(params = {}, options = {})
+      req = build_request(:list_batch_segment_jobs, params)
+      req.send_request(options)
+    end
+
     # Returns a list of campaigns that use the given solution. When a
     # solution is not specified, all the campaigns associated with the
     # account are listed. The response provides the properties for each
@@ -2329,6 +2729,7 @@ module Aws::Personalize
     #   resp.dataset_groups[0].creation_date_time #=> Time
     #   resp.dataset_groups[0].last_updated_date_time #=> Time
     #   resp.dataset_groups[0].failure_reason #=> String
+    #   resp.dataset_groups[0].domain #=> String, one of "ECOMMERCE", "VIDEO_ON_DEMAND"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListDatasetGroups AWS API Documentation
@@ -2555,6 +2956,12 @@ module Aws::Personalize
     # @option params [Integer] :max_results
     #   The maximum number of recipes to return.
     #
+    # @option params [String] :domain
+    #   Filters returned recipes by domain for a Domain dataset group. Only
+    #   recipes (Domain dataset group use cases) for this domain are included
+    #   in the response. If you don't specify a domain, only non-domain
+    #   recipes are returned.
+    #
     # @return [Types::ListRecipesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListRecipesResponse#recipes #recipes} => Array&lt;Types::RecipeSummary&gt;
@@ -2568,6 +2975,7 @@ module Aws::Personalize
     #     recipe_provider: "SERVICE", # accepts SERVICE
     #     next_token: "NextToken",
     #     max_results: 1,
+    #     domain: "ECOMMERCE", # accepts ECOMMERCE, VIDEO_ON_DEMAND
     #   })
     #
     # @example Response structure
@@ -2578,6 +2986,7 @@ module Aws::Personalize
     #   resp.recipes[0].status #=> String
     #   resp.recipes[0].creation_date_time #=> Time
     #   resp.recipes[0].last_updated_date_time #=> Time
+    #   resp.recipes[0].domain #=> String, one of "ECOMMERCE", "VIDEO_ON_DEMAND"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListRecipes AWS API Documentation
@@ -2589,6 +2998,67 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Returns a list of recommenders in a given Domain dataset group. When a
+    # Domain dataset group is not specified, all the recommenders associated
+    # with the account are listed. The response provides the properties for
+    # each recommender, including the Amazon Resource Name (ARN). For more
+    # information on recommenders, see [CreateRecommender][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/API_CreateRecommender.html
+    #
+    # @option params [String] :dataset_group_arn
+    #   The Amazon Resource Name (ARN) of the Domain dataset group to list the
+    #   recommenders for. When a Domain dataset group is not specified, all
+    #   the recommenders associated with the account are listed.
+    #
+    # @option params [String] :next_token
+    #   A token returned from the previous call to `ListRecommenders` for
+    #   getting the next set of recommenders (if they exist).
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of recommenders to return.
+    #
+    # @return [Types::ListRecommendersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListRecommendersResponse#recommenders #recommenders} => Array&lt;Types::RecommenderSummary&gt;
+    #   * {Types::ListRecommendersResponse#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_recommenders({
+    #     dataset_group_arn: "Arn",
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.recommenders #=> Array
+    #   resp.recommenders[0].name #=> String
+    #   resp.recommenders[0].recommender_arn #=> String
+    #   resp.recommenders[0].dataset_group_arn #=> String
+    #   resp.recommenders[0].recipe_arn #=> String
+    #   resp.recommenders[0].recommender_config.item_exploration_config #=> Hash
+    #   resp.recommenders[0].recommender_config.item_exploration_config["ParameterName"] #=> String
+    #   resp.recommenders[0].recommender_config.min_recommendation_requests_per_second #=> Integer
+    #   resp.recommenders[0].status #=> String
+    #   resp.recommenders[0].creation_date_time #=> Time
+    #   resp.recommenders[0].last_updated_date_time #=> Time
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListRecommenders AWS API Documentation
+    #
+    # @overload list_recommenders(params = {})
+    # @param [Hash] params ({})
+    def list_recommenders(params = {}, options = {})
+      req = build_request(:list_recommenders, params)
+      req.send_request(options)
+    end
+
     # Returns the list of schemas associated with the account. The response
     # provides the properties for each schema, including the Amazon Resource
     # Name (ARN). For more information on schemas, see CreateSchema.
@@ -2621,6 +3091,7 @@ module Aws::Personalize
     #   resp.schemas[0].schema_arn #=> String
     #   resp.schemas[0].creation_date_time #=> Time
     #   resp.schemas[0].last_updated_date_time #=> Time
+    #   resp.schemas[0].domain #=> String, one of "ECOMMERCE", "VIDEO_ON_DEMAND"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListSchemas AWS API Documentation
@@ -2825,6 +3296,43 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Updates the recommender to modify the recommender configuration.
+    #
+    # @option params [required, String] :recommender_arn
+    #   The Amazon Resource Name (ARN) of the recommender to modify.
+    #
+    # @option params [required, Types::RecommenderConfig] :recommender_config
+    #   The configuration details of the recommender.
+    #
+    # @return [Types::UpdateRecommenderResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateRecommenderResponse#recommender_arn #recommender_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_recommender({
+    #     recommender_arn: "Arn", # required
+    #     recommender_config: { # required
+    #       item_exploration_config: {
+    #         "ParameterName" => "ParameterValue",
+    #       },
+    #       min_recommendation_requests_per_second: 1,
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.recommender_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/UpdateRecommender AWS API Documentation
+    #
+    # @overload update_recommender(params = {})
+    # @param [Hash] params ({})
+    def update_recommender(params = {}, options = {})
+      req = build_request(:update_recommender, params)
+      req.send_request(options)
+    end
+
     # @!endgroup
 
     # @param params ({})
@@ -2838,7 +3346,7 @@ module Aws::Personalize
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-personalize'
-      context[:gem_version] = '1.33.0'
+      context[:gem_version] = '1.37.0'
       Seahorse::Client::Request.new(handlers, context)
     end