aws-sdk-personalize 1.7.0 → 1.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ba039375af63cb4543ace6efb8b88a697bf1eacc
-  data.tar.gz: d284796db16f4d705ed1a00a12939dbcbd3ead72
+SHA256:
+  metadata.gz: c19c1c9271cb6cabf94b32c458927b8401f5ab163751b150188f37c0c4495dfb
+  data.tar.gz: 988d920bd5b44f11c9b9445aed8d47e5f80f766712ae02262bc9e539e9b2604f
 SHA512:
-  metadata.gz: e09bc30db52b5f442affbfec4cf48816fa4963cdaf6dcd8b9084f75928a1a039cf8ea4b12a58929ef27681a1ba1e867b20d77ad632ea69b02e633060d03d8aea
-  data.tar.gz: ff58a356beda3ab9ef9898d24e01affebd796f1363d60241fa8f9a4d3dafc30c40d579caae1ebd7c0ed3a019be3a9f8b2d2b0a6535f0548c77f974fd44dd70b3
+  metadata.gz: 9e64869d87dfc0ec152e2c3c7f0a0f5c7c769796c80615c39fcd4fdec711a90444eb5398fc84d8f40c1b3ff3df8f23958eeb7fcb02e5d98f226328a4289419ca
+  data.tar.gz: 209667e0405b44a2b9d662eeccd6e37237ef1e13237be8f28ee11fbcdea409364b19821961211085e619e780eaee9480285ea426a397ede7ae1e971f6b25bd21

data/lib/aws-sdk-personalize.rb

@@ -24,17 +24,20 @@ require_relative 'aws-sdk-personalize/customizations'
 # methods each accept a hash of request parameters and return a response
 # structure.
 #
+#     personalize = Aws::Personalize::Client.new
+#     resp = personalize.create_batch_inference_job(params)
+#
 # See {Client} for more information.
 #
 # # Errors
 #
-# Errors returned from Amazon Personalize all
-# extend {Errors::ServiceError}.
+# Errors returned from Amazon Personalize are defined in the
+# {Errors} module and all extend {Errors::ServiceError}.
 #
 #     begin
 #       # do stuff
 #     rescue Aws::Personalize::Errors::ServiceError
-#       # rescues all service API errors
+#       # rescues all Amazon Personalize API errors
 #     end
 #
 # See {Errors} for more information.
@@ -42,6 +45,6 @@ require_relative 'aws-sdk-personalize/customizations'
 # @service
 module Aws::Personalize
 
-  GEM_VERSION = '1.7.0'
+  GEM_VERSION = '1.12.0'
 
 end

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

@@ -30,6 +30,18 @@ require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 Aws::Plugins::GlobalConfiguration.add_identifier(:personalize)
 
 module Aws::Personalize
+  # An API client for Personalize.  To construct a client, you need to configure a `:region` and `:credentials`.
+  #
+  #     client = Aws::Personalize::Client.new(
+  #       region: region_name,
+  #       credentials: credentials,
+  #       # ...
+  #     )
+  #
+  # For details on configuring region and credentials see
+  # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
+  #
+  # See {#initialize} for a full list of supported configuration options.
   class Client < Seahorse::Client::Base
 
     include Aws::ClientStubs
@@ -93,7 +105,7 @@ module Aws::Personalize
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
     #     used to determine the service `:endpoint`. When not passed,
-    #     a default `:region` is search for in the following locations:
+    #     a default `:region` is searched for in the following locations:
     #
     #     * `Aws.config[:region]`
     #     * `ENV['AWS_REGION']`
@@ -108,6 +120,12 @@ module Aws::Personalize
     #     When set to `true`, a thread polling for endpoints will be running in
     #     the background every 60 secs (default). Defaults to `false`.
     #
+    #   @option options [Boolean] :adaptive_retry_wait_to_fill (true)
+    #     Used only in `adaptive` retry mode.  When true, the request will sleep
+    #     until there is sufficent client side capacity to retry the request.
+    #     When false, the request will raise a `RetryCapacityNotAvailableError` and will
+    #     not retry instead of sleeping.
+    #
     #   @option options [Boolean] :client_side_monitoring (false)
     #     When `true`, client-side metrics will be collected for all API requests from
     #     this client.
@@ -132,6 +150,10 @@ module Aws::Personalize
     #     When `true`, an attempt is made to coerce request parameters into
     #     the required types.
     #
+    #   @option options [Boolean] :correct_clock_skew (true)
+    #     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 [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -139,7 +161,7 @@ module Aws::Personalize
     #   @option options [String] :endpoint
     #     The client endpoint is normally constructed from the `:region`
     #     option. You should only configure an `:endpoint` when connecting
-    #     to test endpoints. This should be avalid HTTP(S) URI.
+    #     to test endpoints. This should be a valid HTTP(S) URI.
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -154,7 +176,7 @@ module Aws::Personalize
     #     requests fetching endpoints information. Defaults to 60 sec.
     #
     #   @option options [Boolean] :endpoint_discovery (false)
-    #     When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
+    #     When set to `true`, endpoint discovery will be enabled for operations when available.
     #
     #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
     #     The log formatter.
@@ -166,15 +188,29 @@ module Aws::Personalize
     #     The Logger instance to send log messages to.  If this option
     #     is not set, logging will be disabled.
     #
+    #   @option options [Integer] :max_attempts (3)
+    #     An integer representing the maximum number attempts that will be made for
+    #     a single request, including the initial attempt.  For example,
+    #     setting this value to 5 will result in a request being retried up to
+    #     4 times. Used in `standard` and `adaptive` retry modes.
+    #
     #   @option options [String] :profile ("default")
     #     Used when loading credentials from the shared credentials file
     #     at HOME/.aws/credentials.  When not specified, 'default' is used.
     #
+    #   @option options [Proc] :retry_backoff
+    #     A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
+    #     This option is only used in the `legacy` retry mode.
+    #
     #   @option options [Float] :retry_base_delay (0.3)
-    #     The base delay in seconds used by the default backoff function.
+    #     The base delay in seconds used by the default backoff function. This option
+    #     is only used in the `legacy` retry mode.
     #
     #   @option options [Symbol] :retry_jitter (:none)
-    #     A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number.
+    #     A delay randomiser function used by the default backoff function.
+    #     Some predefined functions can be referenced by name - :none, :equal, :full,
+    #     otherwise a Proc that takes and returns a number. This option is only used
+    #     in the `legacy` retry mode.
     #
     #     @see https://www.awsarchitectureblog.com/2015/03/backoff.html
     #
@@ -182,11 +218,30 @@ module Aws::Personalize
     #     The maximum number of times to retry failed requests.  Only
     #     ~ 500 level server errors and certain ~ 400 level client errors
     #     are retried.  Generally, these are throttling errors, data
-    #     checksum errors, networking errors, timeout errors and auth
-    #     errors from expired credentials.
+    #     checksum errors, networking errors, timeout errors, auth errors,
+    #     endpoint discovery, and errors from expired credentials.
+    #     This option is only used in the `legacy` retry mode.
     #
     #   @option options [Integer] :retry_max_delay (0)
-    #     The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function.
+    #     The maximum number of seconds to delay between retries (0 for no limit)
+    #     used by the default backoff function. This option is only used in the
+    #     `legacy` retry mode.
+    #
+    #   @option options [String] :retry_mode ("legacy")
+    #     Specifies which retry algorithm to use. Values are:
+    #
+    #     * `legacy` - The pre-existing retry behavior.  This is default value if
+    #       no retry mode is provided.
+    #
+    #     * `standard` - A standardized set of retry rules across the AWS SDKs.
+    #       This includes support for retry quotas, which limit the number of
+    #       unsuccessful retries a client can make.
+    #
+    #     * `adaptive` - An experimental retry mode that includes all the
+    #       functionality of `standard` mode along with automatic client side
+    #       throttling.  This is a provisional mode that may change behavior
+    #       in the future.
+    #
     #
     #   @option options [String] :secret_access_key
     #
@@ -219,16 +274,15 @@ module Aws::Personalize
     #     requests through.  Formatted like 'http://proxy.com:123'.
     #
     #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before rasing a
+    #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
     #   @option options [Integer] :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 yeidled by {#session_for}.
+    #     safely be set per-request on the session.
     #
     #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idble before it is
+    #     seconds a connection is allowed to sit idle before it is
     #     considered stale.  Stale connections are closed and removed
     #     from the pool before making a request.
     #
@@ -237,7 +291,7 @@ module Aws::Personalize
     #     request body.  This option has no effect unless the request has
     #     "Expect" header set to "100-continue".  Defaults to `nil` which
     #     disables this behaviour.  This value can safely be set per
-    #     request on the session yeidled by {#session_for}.
+    #     request on the session.
     #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
@@ -264,6 +318,71 @@ module Aws::Personalize
 
     # @!group API Operations
 
+    # Creates a batch inference 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 inference job to create.
+    #
+    # @option params [required, String] :solution_version_arn
+    #   The Amazon Resource Name (ARN) of the solution version that will be
+    #   used to generate the batch inference recommendations.
+    #
+    # @option params [Integer] :num_results
+    #   The number of recommendations to retreive.
+    #
+    # @option params [required, Types::BatchInferenceJobInput] :job_input
+    #   The Amazon S3 path that leads to the input file to base your
+    #   recommendations on. The input material must be in JSON format.
+    #
+    # @option params [required, Types::BatchInferenceJobOutput] :job_output
+    #   The path to the Amazon S3 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 out Amazon S3 buckets
+    #   respectively.
+    #
+    # @return [Types::CreateBatchInferenceJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateBatchInferenceJobResponse#batch_inference_job_arn #batch_inference_job_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_batch_inference_job({
+    #     job_name: "Name", # required
+    #     solution_version_arn: "Arn", # required
+    #     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_inference_job_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateBatchInferenceJob AWS API Documentation
+    #
+    # @overload create_batch_inference_job(params = {})
+    # @param [Hash] params ({})
+    def create_batch_inference_job(params = {}, options = {})
+      req = build_request(:create_batch_inference_job, params)
+      req.send_request(options)
+    end
+
     # Creates a campaign by deploying a solution version. When a client
     # calls the [GetRecommendations][1] and [GetPersonalizedRanking][2]
     # APIs, a campaign is specified in the request.
@@ -1168,6 +1287,48 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Gets the properties of a batch inference job including name, Amazon
+    # Resource Name (ARN), status, input and output configurations, and the
+    # ARN of the solution version used to generate the recommendations.
+    #
+    # @option params [required, String] :batch_inference_job_arn
+    #   The ARN of the batch inference job to describe.
+    #
+    # @return [Types::DescribeBatchInferenceJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeBatchInferenceJobResponse#batch_inference_job #batch_inference_job} => Types::BatchInferenceJob
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_batch_inference_job({
+    #     batch_inference_job_arn: "Arn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.batch_inference_job.job_name #=> String
+    #   resp.batch_inference_job.batch_inference_job_arn #=> String
+    #   resp.batch_inference_job.failure_reason #=> String
+    #   resp.batch_inference_job.solution_version_arn #=> String
+    #   resp.batch_inference_job.num_results #=> Integer
+    #   resp.batch_inference_job.job_input.s3_data_source.path #=> String
+    #   resp.batch_inference_job.job_input.s3_data_source.kms_key_arn #=> String
+    #   resp.batch_inference_job.job_output.s3_data_destination.path #=> String
+    #   resp.batch_inference_job.job_output.s3_data_destination.kms_key_arn #=> String
+    #   resp.batch_inference_job.role_arn #=> String
+    #   resp.batch_inference_job.status #=> String
+    #   resp.batch_inference_job.creation_date_time #=> Time
+    #   resp.batch_inference_job.last_updated_date_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeBatchInferenceJob AWS API Documentation
+    #
+    # @overload describe_batch_inference_job(params = {})
+    # @param [Hash] params ({})
+    def describe_batch_inference_job(params = {}, options = {})
+      req = build_request(:describe_batch_inference_job, params)
+      req.send_request(options)
+    end
+
     # Describes the given campaign, including its status.
     #
     # A campaign can be in one of the following states:
@@ -1611,6 +1772,8 @@ module Aws::Personalize
     #   resp.solution_version.solution_config.auto_ml_config.recipe_list[0] #=> String
     #   resp.solution_version.training_hours #=> Float
     #   resp.solution_version.training_mode #=> String, one of "FULL", "UPDATE"
+    #   resp.solution_version.tuned_hpo_params.algorithm_hyper_parameters #=> Hash
+    #   resp.solution_version.tuned_hpo_params.algorithm_hyper_parameters["ParameterName"] #=> String
     #   resp.solution_version.status #=> String
     #   resp.solution_version.failure_reason #=> String
     #   resp.solution_version.creation_date_time #=> Time
@@ -1657,6 +1820,56 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Gets a list of the batch inference jobs that have been performed off
+    # of a solution version.
+    #
+    # @option params [String] :solution_version_arn
+    #   The Amazon Resource Name (ARN) of the solution version from which the
+    #   batch inference jobs were created.
+    #
+    # @option params [String] :next_token
+    #   The token to request the next page of results.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of batch inference job results to return in each
+    #   page. The default value is 100.
+    #
+    # @return [Types::ListBatchInferenceJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListBatchInferenceJobsResponse#batch_inference_jobs #batch_inference_jobs} => Array&lt;Types::BatchInferenceJobSummary&gt;
+    #   * {Types::ListBatchInferenceJobsResponse#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_inference_jobs({
+    #     solution_version_arn: "Arn",
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.batch_inference_jobs #=> Array
+    #   resp.batch_inference_jobs[0].batch_inference_job_arn #=> String
+    #   resp.batch_inference_jobs[0].job_name #=> String
+    #   resp.batch_inference_jobs[0].status #=> String
+    #   resp.batch_inference_jobs[0].creation_date_time #=> Time
+    #   resp.batch_inference_jobs[0].last_updated_date_time #=> Time
+    #   resp.batch_inference_jobs[0].failure_reason #=> String
+    #   resp.batch_inference_jobs[0].solution_version_arn #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListBatchInferenceJobs AWS API Documentation
+    #
+    # @overload list_batch_inference_jobs(params = {})
+    # @param [Hash] params ({})
+    def list_batch_inference_jobs(params = {}, options = {})
+      req = build_request(:list_batch_inference_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
@@ -1680,6 +1893,8 @@ module Aws::Personalize
     #   * {Types::ListCampaignsResponse#campaigns #campaigns} => Array&lt;Types::CampaignSummary&gt;
     #   * {Types::ListCampaignsResponse#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_campaigns({
@@ -1724,6 +1939,8 @@ module Aws::Personalize
     #   * {Types::ListDatasetGroupsResponse#dataset_groups #dataset_groups} => Array&lt;Types::DatasetGroupSummary&gt;
     #   * {Types::ListDatasetGroupsResponse#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_groups({
@@ -1774,6 +1991,8 @@ module Aws::Personalize
     #   * {Types::ListDatasetImportJobsResponse#dataset_import_jobs #dataset_import_jobs} => Array&lt;Types::DatasetImportJobSummary&gt;
     #   * {Types::ListDatasetImportJobsResponse#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_import_jobs({
@@ -1823,6 +2042,8 @@ module Aws::Personalize
     #   * {Types::ListDatasetsResponse#datasets #datasets} => Array&lt;Types::DatasetSummary&gt;
     #   * {Types::ListDatasetsResponse#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_datasets({
@@ -1871,6 +2092,8 @@ module Aws::Personalize
     #   * {Types::ListEventTrackersResponse#event_trackers #event_trackers} => Array&lt;Types::EventTrackerSummary&gt;
     #   * {Types::ListEventTrackersResponse#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_event_trackers({
@@ -1917,6 +2140,8 @@ module Aws::Personalize
     #   * {Types::ListRecipesResponse#recipes #recipes} => Array&lt;Types::RecipeSummary&gt;
     #   * {Types::ListRecipesResponse#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_recipes({
@@ -1960,6 +2185,8 @@ module Aws::Personalize
     #   * {Types::ListSchemasResponse#schemas #schemas} => Array&lt;Types::DatasetSchemaSummary&gt;
     #   * {Types::ListSchemasResponse#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_schemas({
@@ -2006,6 +2233,8 @@ module Aws::Personalize
     #   * {Types::ListSolutionVersionsResponse#solution_versions #solution_versions} => Array&lt;Types::SolutionVersionSummary&gt;
     #   * {Types::ListSolutionVersionsResponse#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_solution_versions({
@@ -2054,6 +2283,8 @@ module Aws::Personalize
     #   * {Types::ListSolutionsResponse#solutions #solutions} => Array&lt;Types::SolutionSummary&gt;
     #   * {Types::ListSolutionsResponse#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_solutions({
@@ -2142,7 +2373,7 @@ module Aws::Personalize
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-personalize'
-      context[:gem_version] = '1.7.0'
+      context[:gem_version] = '1.12.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -19,6 +19,11 @@ module Aws::Personalize
     AutoMLConfig = Shapes::StructureShape.new(name: 'AutoMLConfig')
     AutoMLResult = Shapes::StructureShape.new(name: 'AutoMLResult')
     AvroSchema = Shapes::StringShape.new(name: 'AvroSchema')
+    BatchInferenceJob = Shapes::StructureShape.new(name: 'BatchInferenceJob')
+    BatchInferenceJobInput = Shapes::StructureShape.new(name: 'BatchInferenceJobInput')
+    BatchInferenceJobOutput = Shapes::StructureShape.new(name: 'BatchInferenceJobOutput')
+    BatchInferenceJobSummary = Shapes::StructureShape.new(name: 'BatchInferenceJobSummary')
+    BatchInferenceJobs = Shapes::ListShape.new(name: 'BatchInferenceJobs')
     Boolean = Shapes::BooleanShape.new(name: 'Boolean')
     Campaign = Shapes::StructureShape.new(name: 'Campaign')
     CampaignSummary = Shapes::StructureShape.new(name: 'CampaignSummary')
@@ -32,6 +37,8 @@ module Aws::Personalize
     ContinuousHyperParameterRanges = Shapes::ListShape.new(name: 'ContinuousHyperParameterRanges')
     ContinuousMaxValue = Shapes::FloatShape.new(name: 'ContinuousMaxValue')
     ContinuousMinValue = Shapes::FloatShape.new(name: 'ContinuousMinValue')
+    CreateBatchInferenceJobRequest = Shapes::StructureShape.new(name: 'CreateBatchInferenceJobRequest')
+    CreateBatchInferenceJobResponse = Shapes::StructureShape.new(name: 'CreateBatchInferenceJobResponse')
     CreateCampaignRequest = Shapes::StructureShape.new(name: 'CreateCampaignRequest')
     CreateCampaignResponse = Shapes::StructureShape.new(name: 'CreateCampaignResponse')
     CreateDatasetGroupRequest = Shapes::StructureShape.new(name: 'CreateDatasetGroupRequest')
@@ -77,6 +84,8 @@ module Aws::Personalize
     DeleteSolutionRequest = Shapes::StructureShape.new(name: 'DeleteSolutionRequest')
     DescribeAlgorithmRequest = Shapes::StructureShape.new(name: 'DescribeAlgorithmRequest')
     DescribeAlgorithmResponse = Shapes::StructureShape.new(name: 'DescribeAlgorithmResponse')
+    DescribeBatchInferenceJobRequest = Shapes::StructureShape.new(name: 'DescribeBatchInferenceJobRequest')
+    DescribeBatchInferenceJobResponse = Shapes::StructureShape.new(name: 'DescribeBatchInferenceJobResponse')
     DescribeCampaignRequest = Shapes::StructureShape.new(name: 'DescribeCampaignRequest')
     DescribeCampaignResponse = Shapes::StructureShape.new(name: 'DescribeCampaignResponse')
     DescribeDatasetGroupRequest = Shapes::StructureShape.new(name: 'DescribeDatasetGroupRequest')
@@ -126,6 +135,8 @@ module Aws::Personalize
     InvalidNextTokenException = Shapes::StructureShape.new(name: 'InvalidNextTokenException')
     KmsKeyArn = Shapes::StringShape.new(name: 'KmsKeyArn')
     LimitExceededException = Shapes::StructureShape.new(name: 'LimitExceededException')
+    ListBatchInferenceJobsRequest = Shapes::StructureShape.new(name: 'ListBatchInferenceJobsRequest')
+    ListBatchInferenceJobsResponse = Shapes::StructureShape.new(name: 'ListBatchInferenceJobsResponse')
     ListCampaignsRequest = Shapes::StructureShape.new(name: 'ListCampaignsRequest')
     ListCampaignsResponse = Shapes::StructureShape.new(name: 'ListCampaignsResponse')
     ListDatasetGroupsRequest = Shapes::StructureShape.new(name: 'ListDatasetGroupsRequest')
@@ -151,6 +162,7 @@ module Aws::Personalize
     Metrics = Shapes::MapShape.new(name: 'Metrics')
     Name = Shapes::StringShape.new(name: 'Name')
     NextToken = Shapes::StringShape.new(name: 'NextToken')
+    NumBatchResults = Shapes::IntegerShape.new(name: 'NumBatchResults')
     ParameterName = Shapes::StringShape.new(name: 'ParameterName')
     ParameterValue = Shapes::StringShape.new(name: 'ParameterValue')
     PerformAutoML = Shapes::BooleanShape.new(name: 'PerformAutoML')
@@ -165,6 +177,7 @@ module Aws::Personalize
     ResourceInUseException = Shapes::StructureShape.new(name: 'ResourceInUseException')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     RoleArn = Shapes::StringShape.new(name: 'RoleArn')
+    S3DataConfig = Shapes::StructureShape.new(name: 'S3DataConfig')
     S3Location = Shapes::StringShape.new(name: 'S3Location')
     Schemas = Shapes::ListShape.new(name: 'Schemas')
     Solution = Shapes::StructureShape.new(name: 'Solution')
@@ -181,6 +194,7 @@ module Aws::Personalize
     TrainingMode = Shapes::StringShape.new(name: 'TrainingMode')
     TransactionsPerSecond = Shapes::IntegerShape.new(name: 'TransactionsPerSecond')
     Tunable = Shapes::BooleanShape.new(name: 'Tunable')
+    TunedHPOParams = Shapes::StructureShape.new(name: 'TunedHPOParams')
     UpdateCampaignRequest = Shapes::StructureShape.new(name: 'UpdateCampaignRequest')
     UpdateCampaignResponse = Shapes::StructureShape.new(name: 'UpdateCampaignResponse')
 
@@ -209,6 +223,36 @@ module Aws::Personalize
     AutoMLResult.add_member(:best_recipe_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "bestRecipeArn"))
     AutoMLResult.struct_class = Types::AutoMLResult
 
+    BatchInferenceJob.add_member(:job_name, Shapes::ShapeRef.new(shape: Name, location_name: "jobName"))
+    BatchInferenceJob.add_member(:batch_inference_job_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "batchInferenceJobArn"))
+    BatchInferenceJob.add_member(:failure_reason, Shapes::ShapeRef.new(shape: FailureReason, location_name: "failureReason"))
+    BatchInferenceJob.add_member(:solution_version_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "solutionVersionArn"))
+    BatchInferenceJob.add_member(:num_results, Shapes::ShapeRef.new(shape: NumBatchResults, location_name: "numResults"))
+    BatchInferenceJob.add_member(:job_input, Shapes::ShapeRef.new(shape: BatchInferenceJobInput, location_name: "jobInput"))
+    BatchInferenceJob.add_member(:job_output, Shapes::ShapeRef.new(shape: BatchInferenceJobOutput, location_name: "jobOutput"))
+    BatchInferenceJob.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, location_name: "roleArn"))
+    BatchInferenceJob.add_member(:status, Shapes::ShapeRef.new(shape: Status, location_name: "status"))
+    BatchInferenceJob.add_member(:creation_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "creationDateTime"))
+    BatchInferenceJob.add_member(:last_updated_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "lastUpdatedDateTime"))
+    BatchInferenceJob.struct_class = Types::BatchInferenceJob
+
+    BatchInferenceJobInput.add_member(:s3_data_source, Shapes::ShapeRef.new(shape: S3DataConfig, required: true, location_name: "s3DataSource"))
+    BatchInferenceJobInput.struct_class = Types::BatchInferenceJobInput
+
+    BatchInferenceJobOutput.add_member(:s3_data_destination, Shapes::ShapeRef.new(shape: S3DataConfig, required: true, location_name: "s3DataDestination"))
+    BatchInferenceJobOutput.struct_class = Types::BatchInferenceJobOutput
+
+    BatchInferenceJobSummary.add_member(:batch_inference_job_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "batchInferenceJobArn"))
+    BatchInferenceJobSummary.add_member(:job_name, Shapes::ShapeRef.new(shape: Name, location_name: "jobName"))
+    BatchInferenceJobSummary.add_member(:status, Shapes::ShapeRef.new(shape: Status, location_name: "status"))
+    BatchInferenceJobSummary.add_member(:creation_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "creationDateTime"))
+    BatchInferenceJobSummary.add_member(:last_updated_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "lastUpdatedDateTime"))
+    BatchInferenceJobSummary.add_member(:failure_reason, Shapes::ShapeRef.new(shape: FailureReason, location_name: "failureReason"))
+    BatchInferenceJobSummary.add_member(:solution_version_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "solutionVersionArn"))
+    BatchInferenceJobSummary.struct_class = Types::BatchInferenceJobSummary
+
+    BatchInferenceJobs.member = Shapes::ShapeRef.new(shape: BatchInferenceJobSummary)
+
     Campaign.add_member(:name, Shapes::ShapeRef.new(shape: Name, location_name: "name"))
     Campaign.add_member(:campaign_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "campaignArn"))
     Campaign.add_member(:solution_version_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "solutionVersionArn"))
@@ -253,6 +297,17 @@ module Aws::Personalize
 
     ContinuousHyperParameterRanges.member = Shapes::ShapeRef.new(shape: ContinuousHyperParameterRange)
 
+    CreateBatchInferenceJobRequest.add_member(:job_name, Shapes::ShapeRef.new(shape: Name, required: true, location_name: "jobName"))
+    CreateBatchInferenceJobRequest.add_member(:solution_version_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "solutionVersionArn"))
+    CreateBatchInferenceJobRequest.add_member(:num_results, Shapes::ShapeRef.new(shape: NumBatchResults, location_name: "numResults"))
+    CreateBatchInferenceJobRequest.add_member(:job_input, Shapes::ShapeRef.new(shape: BatchInferenceJobInput, required: true, location_name: "jobInput"))
+    CreateBatchInferenceJobRequest.add_member(:job_output, Shapes::ShapeRef.new(shape: BatchInferenceJobOutput, required: true, location_name: "jobOutput"))
+    CreateBatchInferenceJobRequest.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, required: true, location_name: "roleArn"))
+    CreateBatchInferenceJobRequest.struct_class = Types::CreateBatchInferenceJobRequest
+
+    CreateBatchInferenceJobResponse.add_member(:batch_inference_job_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "batchInferenceJobArn"))
+    CreateBatchInferenceJobResponse.struct_class = Types::CreateBatchInferenceJobResponse
+
     CreateCampaignRequest.add_member(:name, Shapes::ShapeRef.new(shape: Name, required: true, location_name: "name"))
     CreateCampaignRequest.add_member(:solution_version_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "solutionVersionArn"))
     CreateCampaignRequest.add_member(:min_provisioned_tps, Shapes::ShapeRef.new(shape: TransactionsPerSecond, required: true, location_name: "minProvisionedTPS"))
@@ -450,6 +505,12 @@ module Aws::Personalize
     DescribeAlgorithmResponse.add_member(:algorithm, Shapes::ShapeRef.new(shape: Algorithm, location_name: "algorithm"))
     DescribeAlgorithmResponse.struct_class = Types::DescribeAlgorithmResponse
 
+    DescribeBatchInferenceJobRequest.add_member(:batch_inference_job_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "batchInferenceJobArn"))
+    DescribeBatchInferenceJobRequest.struct_class = Types::DescribeBatchInferenceJobRequest
+
+    DescribeBatchInferenceJobResponse.add_member(:batch_inference_job, Shapes::ShapeRef.new(shape: BatchInferenceJob, location_name: "batchInferenceJob"))
+    DescribeBatchInferenceJobResponse.struct_class = Types::DescribeBatchInferenceJobResponse
+
     DescribeCampaignRequest.add_member(:campaign_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "campaignArn"))
     DescribeCampaignRequest.struct_class = Types::DescribeCampaignRequest
 
@@ -588,6 +649,15 @@ module Aws::Personalize
     LimitExceededException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "message"))
     LimitExceededException.struct_class = Types::LimitExceededException
 
+    ListBatchInferenceJobsRequest.add_member(:solution_version_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "solutionVersionArn"))
+    ListBatchInferenceJobsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
+    ListBatchInferenceJobsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "maxResults"))
+    ListBatchInferenceJobsRequest.struct_class = Types::ListBatchInferenceJobsRequest
+
+    ListBatchInferenceJobsResponse.add_member(:batch_inference_jobs, Shapes::ShapeRef.new(shape: BatchInferenceJobs, location_name: "batchInferenceJobs"))
+    ListBatchInferenceJobsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
+    ListBatchInferenceJobsResponse.struct_class = Types::ListBatchInferenceJobsResponse
+
     ListCampaignsRequest.add_member(:solution_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "solutionArn"))
     ListCampaignsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
     ListCampaignsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "maxResults"))
@@ -702,6 +772,10 @@ module Aws::Personalize
     ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "message"))
     ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
 
+    S3DataConfig.add_member(:path, Shapes::ShapeRef.new(shape: S3Location, required: true, location_name: "path"))
+    S3DataConfig.add_member(:kms_key_arn, Shapes::ShapeRef.new(shape: KmsKeyArn, location_name: "kmsKeyArn"))
+    S3DataConfig.struct_class = Types::S3DataConfig
+
     Schemas.member = Shapes::ShapeRef.new(shape: DatasetSchemaSummary)
 
     Solution.add_member(:name, Shapes::ShapeRef.new(shape: Name, location_name: "name"))
@@ -743,6 +817,7 @@ module Aws::Personalize
     SolutionVersion.add_member(:solution_config, Shapes::ShapeRef.new(shape: SolutionConfig, location_name: "solutionConfig"))
     SolutionVersion.add_member(:training_hours, Shapes::ShapeRef.new(shape: TrainingHours, location_name: "trainingHours"))
     SolutionVersion.add_member(:training_mode, Shapes::ShapeRef.new(shape: TrainingMode, location_name: "trainingMode"))
+    SolutionVersion.add_member(:tuned_hpo_params, Shapes::ShapeRef.new(shape: TunedHPOParams, location_name: "tunedHPOParams"))
     SolutionVersion.add_member(:status, Shapes::ShapeRef.new(shape: Status, location_name: "status"))
     SolutionVersion.add_member(:failure_reason, Shapes::ShapeRef.new(shape: FailureReason, location_name: "failureReason"))
     SolutionVersion.add_member(:creation_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "creationDateTime"))
@@ -760,6 +835,9 @@ module Aws::Personalize
 
     Solutions.member = Shapes::ShapeRef.new(shape: SolutionSummary)
 
+    TunedHPOParams.add_member(:algorithm_hyper_parameters, Shapes::ShapeRef.new(shape: HyperParameters, location_name: "algorithmHyperParameters"))
+    TunedHPOParams.struct_class = Types::TunedHPOParams
+
     UpdateCampaignRequest.add_member(:campaign_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "campaignArn"))
     UpdateCampaignRequest.add_member(:solution_version_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "solutionVersionArn"))
     UpdateCampaignRequest.add_member(:min_provisioned_tps, Shapes::ShapeRef.new(shape: TransactionsPerSecond, location_name: "minProvisionedTPS"))
@@ -787,6 +865,19 @@ module Aws::Personalize
         "uid" => "personalize-2018-05-22",
       }
 
+      api.add_operation(:create_batch_inference_job, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "CreateBatchInferenceJob"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: CreateBatchInferenceJobRequest)
+        o.output = Shapes::ShapeRef.new(shape: CreateBatchInferenceJobResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceAlreadyExistsException)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
+      end)
+
       api.add_operation(:create_campaign, Seahorse::Model::Operation.new.tap do |o|
         o.name = "CreateCampaign"
         o.http_method = "POST"
@@ -961,6 +1052,16 @@ module Aws::Personalize
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
       end)
 
+      api.add_operation(:describe_batch_inference_job, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeBatchInferenceJob"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DescribeBatchInferenceJobRequest)
+        o.output = Shapes::ShapeRef.new(shape: DescribeBatchInferenceJobResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+      end)
+
       api.add_operation(:describe_campaign, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeCampaign"
         o.http_method = "POST"
@@ -1072,6 +1173,22 @@ module Aws::Personalize
         o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
       end)
 
+      api.add_operation(:list_batch_inference_jobs, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListBatchInferenceJobs"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListBatchInferenceJobsRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListBatchInferenceJobsResponse)
+        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_campaigns, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListCampaigns"
         o.http_method = "POST"

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

@@ -6,6 +6,34 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::Personalize
+
+  # When Personalize returns an error response, the Ruby SDK constructs and raises an error.
+  # These errors all extend Aws::Personalize::Errors::ServiceError < {Aws::Errors::ServiceError}
+  #
+  # You can rescue all Personalize errors using ServiceError:
+  #
+  #     begin
+  #       # do stuff
+  #     rescue Aws::Personalize::Errors::ServiceError
+  #       # rescues all Personalize API errors
+  #     end
+  #
+  #
+  # ## Request Context
+  # ServiceError objects have a {Aws::Errors::ServiceError#context #context} method that returns
+  # information about the request that generated the error.
+  # See {Seahorse::Client::RequestContext} for more information.
+  #
+  # ## Error Classes
+  # * {InvalidInputException}
+  # * {InvalidNextTokenException}
+  # * {LimitExceededException}
+  # * {ResourceAlreadyExistsException}
+  # * {ResourceInUseException}
+  # * {ResourceNotFoundException}
+  #
+  # Additionally, error classes are dynamically generated for service errors based on the error code
+  # if they are not defined above.
   module Errors
 
     extend Aws::Errors::DynamicErrors
@@ -23,7 +51,6 @@ module Aws::Personalize
       def message
         @message || @data[:message]
       end
-
     end
 
     class InvalidNextTokenException < ServiceError
@@ -39,7 +66,6 @@ module Aws::Personalize
       def message
         @message || @data[:message]
       end
-
     end
 
     class LimitExceededException < ServiceError
@@ -55,7 +81,6 @@ module Aws::Personalize
       def message
         @message || @data[:message]
       end
-
     end
 
     class ResourceAlreadyExistsException < ServiceError
@@ -71,7 +96,6 @@ module Aws::Personalize
       def message
         @message || @data[:message]
       end
-
     end
 
     class ResourceInUseException < ServiceError
@@ -87,7 +111,6 @@ module Aws::Personalize
       def message
         @message || @data[:message]
       end
-
     end
 
     class ResourceNotFoundException < ServiceError
@@ -103,7 +126,6 @@ module Aws::Personalize
       def message
         @message || @data[:message]
       end
-
     end
 
   end

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

@@ -6,6 +6,7 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::Personalize
+
   class Resource
 
     # @param options ({})

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

@@ -132,6 +132,187 @@ module Aws::Personalize
       include Aws::Structure
     end
 
+    # Contains information on a batch inference job.
+    #
+    # @!attribute [rw] job_name
+    #   The name of the batch inference job.
+    #   @return [String]
+    #
+    # @!attribute [rw] batch_inference_job_arn
+    #   The Amazon Resource Name (ARN) of the batch inference job.
+    #   @return [String]
+    #
+    # @!attribute [rw] failure_reason
+    #   If the batch inference job failed, the reason for the failure.
+    #   @return [String]
+    #
+    # @!attribute [rw] solution_version_arn
+    #   The Amazon Resource Name (ARN) of the solution version from which
+    #   the batch inference job was created.
+    #   @return [String]
+    #
+    # @!attribute [rw] num_results
+    #   The number of recommendations generated by the batch inference job.
+    #   This number includes the error messages generated for failed input
+    #   records.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] job_input
+    #   The Amazon S3 path that leads to the input data used to generate the
+    #   batch inference job.
+    #   @return [Types::BatchInferenceJobInput]
+    #
+    # @!attribute [rw] job_output
+    #   The Amazon S3 bucket that contains the output data generated by the
+    #   batch inference job.
+    #   @return [Types::BatchInferenceJobOutput]
+    #
+    # @!attribute [rw] role_arn
+    #   The ARN of the Amazon Identity and Access Management (IAM) role that
+    #   requested the batch inference job.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   The status of the batch inference job. The status is one of the
+    #   following values:
+    #
+    #   * PENDING
+    #
+    #   * IN PROGRESS
+    #
+    #   * ACTIVE
+    #
+    #   * CREATE FAILED
+    #   @return [String]
+    #
+    # @!attribute [rw] creation_date_time
+    #   The time at which the batch inference job was created.
+    #   @return [Time]
+    #
+    # @!attribute [rw] last_updated_date_time
+    #   The time at which the batch inference job was last updated.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/BatchInferenceJob AWS API Documentation
+    #
+    class BatchInferenceJob < Struct.new(
+      :job_name,
+      :batch_inference_job_arn,
+      :failure_reason,
+      :solution_version_arn,
+      :num_results,
+      :job_input,
+      :job_output,
+      :role_arn,
+      :status,
+      :creation_date_time,
+      :last_updated_date_time)
+      include Aws::Structure
+    end
+
+    # The input configuration of a batch inference job.
+    #
+    # @note When making an API call, you may pass BatchInferenceJobInput
+    #   data as a hash:
+    #
+    #       {
+    #         s3_data_source: { # required
+    #           path: "S3Location", # required
+    #           kms_key_arn: "KmsKeyArn",
+    #         },
+    #       }
+    #
+    # @!attribute [rw] s3_data_source
+    #   The URI of the Amazon S3 location that contains your input data. The
+    #   Amazon S3 bucket must be in the same region as the API endpoint you
+    #   are calling.
+    #   @return [Types::S3DataConfig]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/BatchInferenceJobInput AWS API Documentation
+    #
+    class BatchInferenceJobInput < Struct.new(
+      :s3_data_source)
+      include Aws::Structure
+    end
+
+    # The output configuration parameters of a batch inference job.
+    #
+    # @note When making an API call, you may pass BatchInferenceJobOutput
+    #   data as a hash:
+    #
+    #       {
+    #         s3_data_destination: { # required
+    #           path: "S3Location", # required
+    #           kms_key_arn: "KmsKeyArn",
+    #         },
+    #       }
+    #
+    # @!attribute [rw] s3_data_destination
+    #   Information on the Amazon S3 bucket in which the batch inference
+    #   job's output is stored.
+    #   @return [Types::S3DataConfig]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/BatchInferenceJobOutput AWS API Documentation
+    #
+    class BatchInferenceJobOutput < Struct.new(
+      :s3_data_destination)
+      include Aws::Structure
+    end
+
+    # A truncated version of the BatchInferenceJob datatype. The
+    # ListBatchInferenceJobs operation returns a list of batch inference job
+    # summaries.
+    #
+    # @!attribute [rw] batch_inference_job_arn
+    #   The Amazon Resource Name (ARN) of the batch inference job.
+    #   @return [String]
+    #
+    # @!attribute [rw] job_name
+    #   The name of the batch inference job.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   The status of the batch inference job. The status is one of the
+    #   following values:
+    #
+    #   * PENDING
+    #
+    #   * IN PROGRESS
+    #
+    #   * ACTIVE
+    #
+    #   * CREATE FAILED
+    #   @return [String]
+    #
+    # @!attribute [rw] creation_date_time
+    #   The time at which the batch inference job was created.
+    #   @return [Time]
+    #
+    # @!attribute [rw] last_updated_date_time
+    #   The time at which the batch inference job was last updated.
+    #   @return [Time]
+    #
+    # @!attribute [rw] failure_reason
+    #   If the batch inference job failed, the reason for the failure.
+    #   @return [String]
+    #
+    # @!attribute [rw] solution_version_arn
+    #   The ARN of the solution version used by the batch inference job.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/BatchInferenceJobSummary AWS API Documentation
+    #
+    class BatchInferenceJobSummary < Struct.new(
+      :batch_inference_job_arn,
+      :job_name,
+      :status,
+      :creation_date_time,
+      :last_updated_date_time,
+      :failure_reason,
+      :solution_version_arn)
+      include Aws::Structure
+    end
+
     # Describes a deployed solution version, otherwise known as a campaign.
     # For more information on campaigns, see CreateCampaign.
     #
@@ -350,6 +531,80 @@ module Aws::Personalize
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass CreateBatchInferenceJobRequest
+    #   data as a hash:
+    #
+    #       {
+    #         job_name: "Name", # required
+    #         solution_version_arn: "Arn", # required
+    #         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
+    #       }
+    #
+    # @!attribute [rw] job_name
+    #   The name of the batch inference job to create.
+    #   @return [String]
+    #
+    # @!attribute [rw] solution_version_arn
+    #   The Amazon Resource Name (ARN) of the solution version that will be
+    #   used to generate the batch inference recommendations.
+    #   @return [String]
+    #
+    # @!attribute [rw] num_results
+    #   The number of recommendations to retreive.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] job_input
+    #   The Amazon S3 path that leads to the input file to base your
+    #   recommendations on. The input material must be in JSON format.
+    #   @return [Types::BatchInferenceJobInput]
+    #
+    # @!attribute [rw] job_output
+    #   The path to the Amazon S3 bucket where the job's output will be
+    #   stored.
+    #   @return [Types::BatchInferenceJobOutput]
+    #
+    # @!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
+    #   buckets respectively.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateBatchInferenceJobRequest AWS API Documentation
+    #
+    class CreateBatchInferenceJobRequest < Struct.new(
+      :job_name,
+      :solution_version_arn,
+      :num_results,
+      :job_input,
+      :job_output,
+      :role_arn)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] batch_inference_job_arn
+    #   The ARN of the batch inference job.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateBatchInferenceJobResponse AWS API Documentation
+    #
+    class CreateBatchInferenceJobResponse < Struct.new(
+      :batch_inference_job_arn)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass CreateCampaignRequest
     #   data as a hash:
     #
@@ -1480,6 +1735,35 @@ module Aws::Personalize
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DescribeBatchInferenceJobRequest
+    #   data as a hash:
+    #
+    #       {
+    #         batch_inference_job_arn: "Arn", # required
+    #       }
+    #
+    # @!attribute [rw] batch_inference_job_arn
+    #   The ARN of the batch inference job to describe.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeBatchInferenceJobRequest AWS API Documentation
+    #
+    class DescribeBatchInferenceJobRequest < Struct.new(
+      :batch_inference_job_arn)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] batch_inference_job
+    #   Information on the specified batch inference job.
+    #   @return [Types::BatchInferenceJob]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeBatchInferenceJobResponse AWS API Documentation
+    #
+    class DescribeBatchInferenceJobResponse < Struct.new(
+      :batch_inference_job)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DescribeCampaignRequest
     #   data as a hash:
     #
@@ -2045,7 +2329,7 @@ module Aws::Personalize
     #       }
     #
     # @!attribute [rw] type
-    #   The data type of the metric.
+    #   The type of the metric. Valid values are `Maximize` and `Minimize`.
     #   @return [String]
     #
     # @!attribute [rw] metric_name
@@ -2214,6 +2498,55 @@ module Aws::Personalize
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass ListBatchInferenceJobsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         solution_version_arn: "Arn",
+    #         next_token: "NextToken",
+    #         max_results: 1,
+    #       }
+    #
+    # @!attribute [rw] solution_version_arn
+    #   The Amazon Resource Name (ARN) of the solution version from which
+    #   the batch inference jobs were created.
+    #   @return [String]
+    #
+    # @!attribute [rw] next_token
+    #   The token to request the next page of results.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of batch inference job results to return in each
+    #   page. The default value is 100.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListBatchInferenceJobsRequest AWS API Documentation
+    #
+    class ListBatchInferenceJobsRequest < Struct.new(
+      :solution_version_arn,
+      :next_token,
+      :max_results)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] batch_inference_jobs
+    #   A list containing information on each job that is returned.
+    #   @return [Array<Types::BatchInferenceJobSummary>]
+    #
+    # @!attribute [rw] next_token
+    #   The token to use to retreive the next page of results. The value is
+    #   `null` when there are no more results to return.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListBatchInferenceJobsResponse AWS API Documentation
+    #
+    class ListBatchInferenceJobsResponse < Struct.new(
+      :batch_inference_jobs,
+      :next_token)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListCampaignsRequest
     #   data as a hash:
     #
@@ -2764,6 +3097,34 @@ module Aws::Personalize
       include Aws::Structure
     end
 
+    # The configuration details of an Amazon S3 input or output bucket.
+    #
+    # @note When making an API call, you may pass S3DataConfig
+    #   data as a hash:
+    #
+    #       {
+    #         path: "S3Location", # required
+    #         kms_key_arn: "KmsKeyArn",
+    #       }
+    #
+    # @!attribute [rw] path
+    #   The file path of the Amazon S3 bucket.
+    #   @return [String]
+    #
+    # @!attribute [rw] kms_key_arn
+    #   The Amazon Resource Name (ARN) of the Amazon Key Management Service
+    #   (KMS) key that Amazon Personalize uses to encrypt or decrypt the
+    #   input and output files of a batch inference job.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/S3DataConfig AWS API Documentation
+    #
+    class S3DataConfig < Struct.new(
+      :path,
+      :kms_key_arn)
+      include Aws::Structure
+    end
+
     # An object that provides information about a solution. A solution is a
     # trained model that can be deployed as a campaign.
     #
@@ -2910,9 +3271,7 @@ module Aws::Personalize
     #   @return [String]
     #
     # @!attribute [rw] hpo_config
-    #   Describes the properties for hyperparameter optimization (HPO). For
-    #   use with the bring-your-own-recipe feature. Not used with Amazon
-    #   Personalize predefined recipes.
+    #   Describes the properties for hyperparameter optimization (HPO).
     #   @return [Types::HPOConfig]
     #
     # @!attribute [rw] algorithm_hyper_parameters
@@ -3040,6 +3399,11 @@ module Aws::Personalize
     #   uses the native-recipe-hrnn-coldstart.
     #   @return [String]
     #
+    # @!attribute [rw] tuned_hpo_params
+    #   If hyperparameter optimization was performed, contains the
+    #   hyperparameter values of the best performing model.
+    #   @return [Types::TunedHPOParams]
+    #
     # @!attribute [rw] status
     #   The status of the solution version.
     #
@@ -3080,6 +3444,7 @@ module Aws::Personalize
       :solution_config,
       :training_hours,
       :training_mode,
+      :tuned_hpo_params,
       :status,
       :failure_reason,
       :creation_date_time,
@@ -3130,6 +3495,20 @@ module Aws::Personalize
       include Aws::Structure
     end
 
+    # If hyperparameter optimization (HPO) was performed, contains the
+    # hyperparameter values of the best performing model.
+    #
+    # @!attribute [rw] algorithm_hyper_parameters
+    #   A list of the hyperparameter values of the best performing model.
+    #   @return [Hash<String,String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/TunedHPOParams AWS API Documentation
+    #
+    class TunedHPOParams < Struct.new(
+      :algorithm_hyper_parameters)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass UpdateCampaignRequest
     #   data as a hash:
     #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-personalize
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.12.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-10-23 00:00:00.000000000 Z
+date: 2020-05-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -81,7 +81,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.2.3
+rubygems_version: 2.7.6.2
 signing_key: 
 specification_version: 4
 summary: AWS SDK for Ruby - Amazon Personalize