aws-sdk-personalize 1.33.0 → 1.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29ec402cf3be08ce94d03621547d654295d04f51ea6f3fe13a728b80e8256c1d
-  data.tar.gz: 6e2aa65628e3f63029885164be4a34c7d1e673158bc6aa03a923a275fe41b207
+  metadata.gz: 6e351a34dfe7e333ec213937d065de421349693738a6b0a56ba4da8480dfe669
+  data.tar.gz: 89e1e804e33cf31f0b3a4cd8bc744f2d93b02453975e3f778185732e20e1752c
 SHA512:
-  metadata.gz: 4ebda859ea46b6effd9c6accb1d4d1d863e3eb469b55191e12fb79015de23509c2d20a1f9dce2d5690a7284281a568298872e504406390524d590414071575af
-  data.tar.gz: 56abebc6493abb5b1f8bcb6ca8182b0dc656dcc314ae0a41d1c6756b8976a00a338e5e224c211ba3750b26d7042e2fd763ed16f6feeae90c82e57a804f8c53e0
+  metadata.gz: 01d5216167df4ff32f015825687b3a8d4c94d272cd860955f4024f498fa85e976ac2b382d8614b345fdc3acc4c5911019229c3bd7db89440dec803b9eec982d9
+  data.tar.gz: 1add3fd7db9a61a9ea56f71493d0b81f90c0fc4ba59d3c5ce7f8d2ba5ae958e33d72697bc40d546cf4830c3da8d91f0f115f36d4584bc6b6ec3619329c16032a

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.34.0 (2021-11-29)
+------------------
+
+* Feature - This release adds API support for Recommenders and BatchSegmentJobs.
+
 1.33.0 (2021-11-04)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.33.0
+1.34.0

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

@@ -429,7 +429,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 +760,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 +770,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 +827,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 +845,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 +1058,100 @@ 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.
+    #
+    # **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",
+    #       },
+    #     },
+    #   })
+    #
+    # @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 +1167,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 +1181,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 +1377,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 +1594,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 +1772,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 +1973,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 +2184,65 @@ 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.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.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 +2265,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 +2499,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 +2689,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 +2916,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 +2935,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 +2946,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 +2958,66 @@ 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].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 +3050,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 +3255,42 @@ 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",
+    #       },
+    #     },
+    #   })
+    #
+    # @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 +3304,7 @@ module Aws::Personalize
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-personalize'
-      context[:gem_version] = '1.33.0'
+      context[:gem_version] = '1.34.0'
       Seahorse::Client::Request.new(handlers, context)
     end