aws-sdk-sagemaker 1.22.0 → 1.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 23a230a548063d7b4c4b79fec12f854b7a1a31ae
-  data.tar.gz: 36f05d0d9a75480a1f6290b595fe4debcfbabc5c
+  metadata.gz: b36f98d5a8bf9da7a4732b5ee418bcc9c071f43c
+  data.tar.gz: 65b6f7b2adc03ed424c38b4d55a95decc199de4e
 SHA512:
-  metadata.gz: 91cfc944da0e803b7608aaa675f1980f17b4ceaaa1b7c913e6659315382fbc8472520d3e2f187f2bddff7e8bd4c492a673bca33db7ef82e3b02e3e3b77f74c6c
-  data.tar.gz: 7b4884efa994f9b28b35cd1ae311e2dcdb9bd2b0957074a10fe1dff6b15d928b30335981dab160685d4dceaf5857212a7665129d1ff5800351a46b138871cac3
+  metadata.gz: d07b58e6dde5d44477871bacbf073b0e93526d4b8a98fabc9f5820c8a95e9daa9daa4df89d9e7079ca829e494ebcb1261b0b0272f32ad214f650d27b6bf14c16
+  data.tar.gz: 5bf7f05103eb6d57a54de1a44748efd16bddf1f89efa440b17ea2f34617c2ec612f1c1ac0a32436e808fa8a1661cf56df251985d46b0c1033e13a08f2aa4611b

data/lib/aws-sdk-sagemaker.rb

@@ -43,6 +43,6 @@ require_relative 'aws-sdk-sagemaker/customizations'
 # @service
 module Aws::SageMaker
 
-  GEM_VERSION = '1.22.0'
+  GEM_VERSION = '1.23.0'
 
 end

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

@@ -15,6 +15,7 @@ require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
 require 'aws-sdk-core/plugins/retry_errors.rb'
 require 'aws-sdk-core/plugins/global_configuration.rb'
 require 'aws-sdk-core/plugins/regional_endpoint.rb'
+require 'aws-sdk-core/plugins/endpoint_discovery.rb'
 require 'aws-sdk-core/plugins/response_paging.rb'
 require 'aws-sdk-core/plugins/stub_responses.rb'
 require 'aws-sdk-core/plugins/idempotency_token.rb'
@@ -45,6 +46,7 @@ module Aws::SageMaker
     add_plugin(Aws::Plugins::RetryErrors)
     add_plugin(Aws::Plugins::GlobalConfiguration)
     add_plugin(Aws::Plugins::RegionalEndpoint)
+    add_plugin(Aws::Plugins::EndpointDiscovery)
     add_plugin(Aws::Plugins::ResponsePaging)
     add_plugin(Aws::Plugins::StubResponses)
     add_plugin(Aws::Plugins::IdempotencyToken)
@@ -98,6 +100,10 @@ module Aws::SageMaker
     #
     #   @option options [String] :access_key_id
     #
+    #   @option options [Boolean] :active_endpoint_cache (false)
+    #     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] :client_side_monitoring (false)
     #     When `true`, client-side metrics will be collected for all API requests from
     #     this client.
@@ -123,6 +129,21 @@ module Aws::SageMaker
     #     option. You should only configure an `:endpoint` when connecting
     #     to test endpoints. This should be avalid HTTP(S) URI.
     #
+    #   @option options [Integer] :endpoint_cache_max_entries (1000)
+    #     Used for the maximum size limit of the LRU cache storing endpoints data
+    #     for endpoint discovery enabled operations. Defaults to 1000.
+    #
+    #   @option options [Integer] :endpoint_cache_max_threads (10)
+    #     Used for the maximum threads in use for polling endpoints to be cached, defaults to 10.
+    #
+    #   @option options [Integer] :endpoint_cache_poll_interval (60)
+    #     When :endpoint_discovery and :active_endpoint_cache is enabled,
+    #     Use this option to config the time interval in seconds for making
+    #     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`.
+    #
     #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
     #     The log formatter.
     #
@@ -437,19 +458,26 @@ module Aws::SageMaker
       req.send_request(options)
     end
 
-    # Starts a hyperparameter tuning job.
+    # Starts a hyperparameter tuning job. A hyperparameter tuning job finds
+    # the best version of a model by running many training jobs on your
+    # dataset using the algorithm you choose and values for hyperparameters
+    # within ranges that you specify. It then chooses the hyperparameter
+    # values that result in a model that performs the best, as measured by
+    # an objective metric that you choose.
     #
     # @option params [required, String] :hyper_parameter_tuning_job_name
     #   The name of the tuning job. This name is the prefix for the names of
     #   all training jobs that this tuning job launches. The name must be
-    #   unique within the same AWS account and AWS Region. Names are not case
-    #   sensitive, and must be between 1-32 characters.
+    #   unique within the same AWS account and AWS Region. The name must have
+    #   \\\{ \\} to \\\{ \\} characters. Valid characters are a-z, A-Z, 0-9,
+    #   and : + = @ \_ % - (hyphen). The name is not case sensitive.
     #
     # @option params [required, Types::HyperParameterTuningJobConfig] :hyper_parameter_tuning_job_config
     #   The HyperParameterTuningJobConfig object that describes the tuning
-    #   job, including the search strategy, metric used to evaluate training
-    #   jobs, ranges of parameters to search, and resource limits for the
-    #   tuning job.
+    #   job, including the search strategy, the objective metric used to
+    #   evaluate training jobs, ranges of parameters to search, and resource
+    #   limits for the tuning job. For more information, see
+    #   automatic-model-tuning
     #
     # @option params [required, Types::HyperParameterTrainingJobDefinition] :training_job_definition
     #   The HyperParameterTrainingJobDefinition object that describes the
@@ -457,6 +485,27 @@ module Aws::SageMaker
     #   hyperparameters, input data configuration, output data configuration,
     #   resource configuration, and stopping condition.
     #
+    # @option params [Types::HyperParameterTuningJobWarmStartConfig] :warm_start_config
+    #   Specifies configuration for starting the hyperparameter tuning job
+    #   using one or more previous tuning jobs as a starting point. The
+    #   results of previous tuning jobs are used to inform which combinations
+    #   of hyperparameters to search over in the new tuning job.
+    #
+    #   All training jobs launched by the new hyperparameter tuning job are
+    #   evaluated by using the objective metric. If you specify
+    #   `IDENTICAL_DATA_AND_ALGORITHM` as the `WarmStartType` for the warm
+    #   start configuration, the training job that performs the best in the
+    #   new tuning job is compared to the best training jobs from the parent
+    #   tuning jobs. From these, the training job that performs the best as
+    #   measured by the objective metric is returned as the overall best
+    #   training job.
+    #
+    #   <note markdown="1"> All training jobs launched by parent hyperparameter tuning jobs and
+    #   the new hyperparameter tuning jobs count against the limit of training
+    #   jobs for the tuning job.
+    #
+    #    </note>
+    #
     # @option params [Array<Types::Tag>] :tags
     #   An array of key-value pairs. You can use tags to categorize your AWS
     #   resources in different ways, for example, by purpose, owner, or
@@ -515,7 +564,7 @@ module Aws::SageMaker
     #         "ParameterKey" => "ParameterValue",
     #       },
     #       algorithm_specification: { # required
-    #         training_image: "AlgorithmImage", # required
+    #         training_image: "AlgorithmImage",
     #         training_input_mode: "Pipe", # required, accepts Pipe, File
     #         metric_definitions: [
     #           {
@@ -525,7 +574,7 @@ module Aws::SageMaker
     #         ],
     #       },
     #       role_arn: "RoleArn", # required
-    #       input_data_config: [ # required
+    #       input_data_config: [
     #         {
     #           channel_name: "ChannelName", # required
     #           data_source: { # required
@@ -559,6 +608,14 @@ module Aws::SageMaker
     #         max_runtime_in_seconds: 1,
     #       },
     #     },
+    #     warm_start_config: {
+    #       parent_hyper_parameter_tuning_jobs: [ # required
+    #         {
+    #           hyper_parameter_tuning_job_name: "HyperParameterTuningJobName",
+    #         },
+    #       ],
+    #       warm_start_type: "IdenticalDataAndAlgorithm", # required, accepts IdenticalDataAndAlgorithm, TransferLearning
+    #     },
     #     tags: [
     #       {
     #         key: "TagKey", # required
@@ -778,7 +835,13 @@ module Aws::SageMaker
     # @option params [String] :kms_key_id
     #   If you provide a AWS KMS key ID, Amazon SageMaker uses it to encrypt
     #   data at rest on the ML storage volume that is attached to your
-    #   notebook instance.
+    #   notebook instance. The KMS key you provide must be enabled. For
+    #   information, see [Enabling and Disabling Keys][1] in the *AWS Key
+    #   Management Service Developer Guide*.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/kms/latest/developerguide/enabling-keys.html
     #
     # @option params [Array<Types::Tag>] :tags
     #   A list of tags to associate with the notebook instance. You can add
@@ -810,7 +873,7 @@ module Aws::SageMaker
     #
     # @option params [Integer] :volume_size_in_gb
     #   The size, in GB, of the ML storage volume to attach to the notebook
-    #   instance.
+    #   instance. The default value is 5 GB.
     #
     # @return [Types::CreateNotebookInstanceOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -820,7 +883,7 @@ module Aws::SageMaker
     #
     #   resp = client.create_notebook_instance({
     #     notebook_instance_name: "NotebookInstanceName", # required
-    #     instance_type: "ml.t2.medium", # required, accepts ml.t2.medium, ml.t2.large, ml.t2.xlarge, ml.t2.2xlarge, ml.m4.xlarge, ml.m4.2xlarge, ml.m4.4xlarge, ml.m4.10xlarge, ml.m4.16xlarge, ml.p2.xlarge, ml.p2.8xlarge, ml.p2.16xlarge, ml.p3.2xlarge, ml.p3.8xlarge, ml.p3.16xlarge
+    #     instance_type: "ml.t2.medium", # required, accepts ml.t2.medium, ml.t2.large, ml.t2.xlarge, ml.t2.2xlarge, ml.t3.medium, ml.t3.large, ml.t3.xlarge, ml.t3.2xlarge, ml.m4.xlarge, ml.m4.2xlarge, ml.m4.4xlarge, ml.m4.10xlarge, ml.m4.16xlarge, ml.m5.xlarge, ml.m5.2xlarge, ml.m5.4xlarge, ml.m5.12xlarge, ml.m5.24xlarge, ml.c4.xlarge, ml.c4.2xlarge, ml.c4.4xlarge, ml.c4.8xlarge, ml.c5.xlarge, ml.c5.2xlarge, ml.c5.4xlarge, ml.c5.9xlarge, ml.c5.18xlarge, ml.c5d.xlarge, ml.c5d.2xlarge, ml.c5d.4xlarge, ml.c5d.9xlarge, ml.c5d.18xlarge, ml.p2.xlarge, ml.p2.8xlarge, ml.p2.16xlarge, ml.p3.2xlarge, ml.p3.8xlarge, ml.p3.16xlarge
     #     subnet_id: "SubnetId",
     #     security_group_ids: ["SecurityGroupId"],
     #     role_arn: "RoleArn", # required
@@ -936,7 +999,7 @@ module Aws::SageMaker
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/https:/docs.aws.amazon.com/sagemaker/latest/dg/howitworks-access-ws.html#nbi-ip-filter
+    # [1]: http://docs.aws.amazon.com/sagemaker/latest/dg/howitworks-access-ws.html#nbi-ip-filter
     #
     # @option params [required, String] :notebook_instance_name
     #   The name of the notebook instance.
@@ -1140,8 +1203,14 @@ module Aws::SageMaker
     #       "ParameterKey" => "ParameterValue",
     #     },
     #     algorithm_specification: { # required
-    #       training_image: "AlgorithmImage", # required
+    #       training_image: "AlgorithmImage",
     #       training_input_mode: "Pipe", # required, accepts Pipe, File
+    #       metric_definitions: [
+    #         {
+    #           name: "MetricName", # required
+    #           regex: "MetricRegex", # required
+    #         },
+    #       ],
     #     },
     #     role_arn: "RoleArn", # required
     #     input_data_config: [
@@ -1631,6 +1700,8 @@ module Aws::SageMaker
     #   * {Types::DescribeHyperParameterTuningJobResponse#training_job_status_counters #training_job_status_counters} => Types::TrainingJobStatusCounters
     #   * {Types::DescribeHyperParameterTuningJobResponse#objective_status_counters #objective_status_counters} => Types::ObjectiveStatusCounters
     #   * {Types::DescribeHyperParameterTuningJobResponse#best_training_job #best_training_job} => Types::HyperParameterTrainingJobSummary
+    #   * {Types::DescribeHyperParameterTuningJobResponse#overall_best_training_job #overall_best_training_job} => Types::HyperParameterTrainingJobSummary
+    #   * {Types::DescribeHyperParameterTuningJobResponse#warm_start_config #warm_start_config} => Types::HyperParameterTuningJobWarmStartConfig
     #   * {Types::DescribeHyperParameterTuningJobResponse#failure_reason #failure_reason} => String
     #
     # @example Request syntax with placeholder values
@@ -1702,6 +1773,7 @@ module Aws::SageMaker
     #   resp.objective_status_counters.failed #=> Integer
     #   resp.best_training_job.training_job_name #=> String
     #   resp.best_training_job.training_job_arn #=> String
+    #   resp.best_training_job.tuning_job_name #=> String
     #   resp.best_training_job.creation_time #=> Time
     #   resp.best_training_job.training_start_time #=> Time
     #   resp.best_training_job.training_end_time #=> Time
@@ -1713,6 +1785,23 @@ module Aws::SageMaker
     #   resp.best_training_job.final_hyper_parameter_tuning_job_objective_metric.metric_name #=> String
     #   resp.best_training_job.final_hyper_parameter_tuning_job_objective_metric.value #=> Float
     #   resp.best_training_job.objective_status #=> String, one of "Succeeded", "Pending", "Failed"
+    #   resp.overall_best_training_job.training_job_name #=> String
+    #   resp.overall_best_training_job.training_job_arn #=> String
+    #   resp.overall_best_training_job.tuning_job_name #=> String
+    #   resp.overall_best_training_job.creation_time #=> Time
+    #   resp.overall_best_training_job.training_start_time #=> Time
+    #   resp.overall_best_training_job.training_end_time #=> Time
+    #   resp.overall_best_training_job.training_job_status #=> String, one of "InProgress", "Completed", "Failed", "Stopping", "Stopped"
+    #   resp.overall_best_training_job.tuned_hyper_parameters #=> Hash
+    #   resp.overall_best_training_job.tuned_hyper_parameters["ParameterKey"] #=> String
+    #   resp.overall_best_training_job.failure_reason #=> String
+    #   resp.overall_best_training_job.final_hyper_parameter_tuning_job_objective_metric.type #=> String, one of "Maximize", "Minimize"
+    #   resp.overall_best_training_job.final_hyper_parameter_tuning_job_objective_metric.metric_name #=> String
+    #   resp.overall_best_training_job.final_hyper_parameter_tuning_job_objective_metric.value #=> Float
+    #   resp.overall_best_training_job.objective_status #=> String, one of "Succeeded", "Pending", "Failed"
+    #   resp.warm_start_config.parent_hyper_parameter_tuning_jobs #=> Array
+    #   resp.warm_start_config.parent_hyper_parameter_tuning_jobs[0].hyper_parameter_tuning_job_name #=> String
+    #   resp.warm_start_config.warm_start_type #=> String, one of "IdenticalDataAndAlgorithm", "TransferLearning"
     #   resp.failure_reason #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/DescribeHyperParameterTuningJob AWS API Documentation
@@ -1806,7 +1895,7 @@ module Aws::SageMaker
     #   resp.notebook_instance_status #=> String, one of "Pending", "InService", "Stopping", "Stopped", "Failed", "Deleting", "Updating"
     #   resp.failure_reason #=> String
     #   resp.url #=> String
-    #   resp.instance_type #=> String, one of "ml.t2.medium", "ml.t2.large", "ml.t2.xlarge", "ml.t2.2xlarge", "ml.m4.xlarge", "ml.m4.2xlarge", "ml.m4.4xlarge", "ml.m4.10xlarge", "ml.m4.16xlarge", "ml.p2.xlarge", "ml.p2.8xlarge", "ml.p2.16xlarge", "ml.p3.2xlarge", "ml.p3.8xlarge", "ml.p3.16xlarge"
+    #   resp.instance_type #=> String, one of "ml.t2.medium", "ml.t2.large", "ml.t2.xlarge", "ml.t2.2xlarge", "ml.t3.medium", "ml.t3.large", "ml.t3.xlarge", "ml.t3.2xlarge", "ml.m4.xlarge", "ml.m4.2xlarge", "ml.m4.4xlarge", "ml.m4.10xlarge", "ml.m4.16xlarge", "ml.m5.xlarge", "ml.m5.2xlarge", "ml.m5.4xlarge", "ml.m5.12xlarge", "ml.m5.24xlarge", "ml.c4.xlarge", "ml.c4.2xlarge", "ml.c4.4xlarge", "ml.c4.8xlarge", "ml.c5.xlarge", "ml.c5.2xlarge", "ml.c5.4xlarge", "ml.c5.9xlarge", "ml.c5.18xlarge", "ml.c5d.xlarge", "ml.c5d.2xlarge", "ml.c5d.4xlarge", "ml.c5d.9xlarge", "ml.c5d.18xlarge", "ml.p2.xlarge", "ml.p2.8xlarge", "ml.p2.16xlarge", "ml.p3.2xlarge", "ml.p3.8xlarge", "ml.p3.16xlarge"
     #   resp.subnet_id #=> String
     #   resp.security_groups #=> Array
     #   resp.security_groups[0] #=> String
@@ -1902,6 +1991,7 @@ module Aws::SageMaker
     #   * {Types::DescribeTrainingJobResponse#training_end_time #training_end_time} => Time
     #   * {Types::DescribeTrainingJobResponse#last_modified_time #last_modified_time} => Time
     #   * {Types::DescribeTrainingJobResponse#secondary_status_transitions #secondary_status_transitions} => Array&lt;Types::SecondaryStatusTransition&gt;
+    #   * {Types::DescribeTrainingJobResponse#final_metric_data_list #final_metric_data_list} => Array&lt;Types::MetricData&gt;
     #
     # @example Request syntax with placeholder values
     #
@@ -1922,6 +2012,9 @@ module Aws::SageMaker
     #   resp.hyper_parameters["ParameterKey"] #=> String
     #   resp.algorithm_specification.training_image #=> String
     #   resp.algorithm_specification.training_input_mode #=> String, one of "Pipe", "File"
+    #   resp.algorithm_specification.metric_definitions #=> Array
+    #   resp.algorithm_specification.metric_definitions[0].name #=> String
+    #   resp.algorithm_specification.metric_definitions[0].regex #=> String
     #   resp.role_arn #=> String
     #   resp.input_data_config #=> Array
     #   resp.input_data_config[0].channel_name #=> String
@@ -1952,6 +2045,10 @@ module Aws::SageMaker
     #   resp.secondary_status_transitions[0].start_time #=> Time
     #   resp.secondary_status_transitions[0].end_time #=> Time
     #   resp.secondary_status_transitions[0].status_message #=> String
+    #   resp.final_metric_data_list #=> Array
+    #   resp.final_metric_data_list[0].metric_name #=> String
+    #   resp.final_metric_data_list[0].value #=> Float
+    #   resp.final_metric_data_list[0].timestamp #=> Time
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/DescribeTrainingJob AWS API Documentation
     #
@@ -2483,7 +2580,7 @@ module Aws::SageMaker
     #   resp.notebook_instances[0].notebook_instance_arn #=> String
     #   resp.notebook_instances[0].notebook_instance_status #=> String, one of "Pending", "InService", "Stopping", "Stopped", "Failed", "Deleting", "Updating"
     #   resp.notebook_instances[0].url #=> String
-    #   resp.notebook_instances[0].instance_type #=> String, one of "ml.t2.medium", "ml.t2.large", "ml.t2.xlarge", "ml.t2.2xlarge", "ml.m4.xlarge", "ml.m4.2xlarge", "ml.m4.4xlarge", "ml.m4.10xlarge", "ml.m4.16xlarge", "ml.p2.xlarge", "ml.p2.8xlarge", "ml.p2.16xlarge", "ml.p3.2xlarge", "ml.p3.8xlarge", "ml.p3.16xlarge"
+    #   resp.notebook_instances[0].instance_type #=> String, one of "ml.t2.medium", "ml.t2.large", "ml.t2.xlarge", "ml.t2.2xlarge", "ml.t3.medium", "ml.t3.large", "ml.t3.xlarge", "ml.t3.2xlarge", "ml.m4.xlarge", "ml.m4.2xlarge", "ml.m4.4xlarge", "ml.m4.10xlarge", "ml.m4.16xlarge", "ml.m5.xlarge", "ml.m5.2xlarge", "ml.m5.4xlarge", "ml.m5.12xlarge", "ml.m5.24xlarge", "ml.c4.xlarge", "ml.c4.2xlarge", "ml.c4.4xlarge", "ml.c4.8xlarge", "ml.c5.xlarge", "ml.c5.2xlarge", "ml.c5.4xlarge", "ml.c5.9xlarge", "ml.c5.18xlarge", "ml.c5d.xlarge", "ml.c5d.2xlarge", "ml.c5d.4xlarge", "ml.c5d.9xlarge", "ml.c5d.18xlarge", "ml.p2.xlarge", "ml.p2.8xlarge", "ml.p2.16xlarge", "ml.p3.2xlarge", "ml.p3.8xlarge", "ml.p3.16xlarge"
     #   resp.notebook_instances[0].creation_time #=> Time
     #   resp.notebook_instances[0].last_modified_time #=> Time
     #   resp.notebook_instances[0].notebook_instance_lifecycle_config_name #=> String
@@ -2668,6 +2765,7 @@ module Aws::SageMaker
     #   resp.training_job_summaries #=> Array
     #   resp.training_job_summaries[0].training_job_name #=> String
     #   resp.training_job_summaries[0].training_job_arn #=> String
+    #   resp.training_job_summaries[0].tuning_job_name #=> String
     #   resp.training_job_summaries[0].creation_time #=> Time
     #   resp.training_job_summaries[0].training_start_time #=> Time
     #   resp.training_job_summaries[0].training_end_time #=> Time
@@ -3054,7 +3152,7 @@ module Aws::SageMaker
     #
     # @option params [Integer] :volume_size_in_gb
     #   The size, in GB, of the ML storage volume to attach to the notebook
-    #   instance.
+    #   instance. The default value is 5 GB.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -3062,7 +3160,7 @@ module Aws::SageMaker
     #
     #   resp = client.update_notebook_instance({
     #     notebook_instance_name: "NotebookInstanceName", # required
-    #     instance_type: "ml.t2.medium", # accepts ml.t2.medium, ml.t2.large, ml.t2.xlarge, ml.t2.2xlarge, ml.m4.xlarge, ml.m4.2xlarge, ml.m4.4xlarge, ml.m4.10xlarge, ml.m4.16xlarge, ml.p2.xlarge, ml.p2.8xlarge, ml.p2.16xlarge, ml.p3.2xlarge, ml.p3.8xlarge, ml.p3.16xlarge
+    #     instance_type: "ml.t2.medium", # accepts ml.t2.medium, ml.t2.large, ml.t2.xlarge, ml.t2.2xlarge, ml.t3.medium, ml.t3.large, ml.t3.xlarge, ml.t3.2xlarge, ml.m4.xlarge, ml.m4.2xlarge, ml.m4.4xlarge, ml.m4.10xlarge, ml.m4.16xlarge, ml.m5.xlarge, ml.m5.2xlarge, ml.m5.4xlarge, ml.m5.12xlarge, ml.m5.24xlarge, ml.c4.xlarge, ml.c4.2xlarge, ml.c4.4xlarge, ml.c4.8xlarge, ml.c5.xlarge, ml.c5.2xlarge, ml.c5.4xlarge, ml.c5.9xlarge, ml.c5.18xlarge, ml.c5d.xlarge, ml.c5d.2xlarge, ml.c5d.4xlarge, ml.c5d.9xlarge, ml.c5d.18xlarge, ml.p2.xlarge, ml.p2.8xlarge, ml.p2.16xlarge, ml.p3.2xlarge, ml.p3.8xlarge, ml.p3.16xlarge
     #     role_arn: "RoleArn",
     #     lifecycle_config_name: "NotebookInstanceLifecycleConfigName",
     #     disassociate_lifecycle_config: false,
@@ -3132,7 +3230,7 @@ module Aws::SageMaker
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-sagemaker'
-      context[:gem_version] = '1.22.0'
+      context[:gem_version] = '1.23.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -95,6 +95,8 @@ module Aws::SageMaker
     EnvironmentValue = Shapes::StringShape.new(name: 'EnvironmentValue')
     FailureReason = Shapes::StringShape.new(name: 'FailureReason')
     FinalHyperParameterTuningJobObjectiveMetric = Shapes::StructureShape.new(name: 'FinalHyperParameterTuningJobObjectiveMetric')
+    FinalMetricDataList = Shapes::ListShape.new(name: 'FinalMetricDataList')
+    Float = Shapes::FloatShape.new(name: 'Float')
     HyperParameterAlgorithmSpecification = Shapes::StructureShape.new(name: 'HyperParameterAlgorithmSpecification')
     HyperParameterTrainingJobDefinition = Shapes::StructureShape.new(name: 'HyperParameterTrainingJobDefinition')
     HyperParameterTrainingJobSummaries = Shapes::ListShape.new(name: 'HyperParameterTrainingJobSummaries')
@@ -109,6 +111,8 @@ module Aws::SageMaker
     HyperParameterTuningJobStrategyType = Shapes::StringShape.new(name: 'HyperParameterTuningJobStrategyType')
     HyperParameterTuningJobSummaries = Shapes::ListShape.new(name: 'HyperParameterTuningJobSummaries')
     HyperParameterTuningJobSummary = Shapes::StructureShape.new(name: 'HyperParameterTuningJobSummary')
+    HyperParameterTuningJobWarmStartConfig = Shapes::StructureShape.new(name: 'HyperParameterTuningJobWarmStartConfig')
+    HyperParameterTuningJobWarmStartType = Shapes::StringShape.new(name: 'HyperParameterTuningJobWarmStartType')
     HyperParameters = Shapes::MapShape.new(name: 'HyperParameters')
     Image = Shapes::StringShape.new(name: 'Image')
     InputDataConfig = Shapes::ListShape.new(name: 'InputDataConfig')
@@ -144,6 +148,7 @@ module Aws::SageMaker
     MaxPayloadInMB = Shapes::IntegerShape.new(name: 'MaxPayloadInMB')
     MaxResults = Shapes::IntegerShape.new(name: 'MaxResults')
     MaxRuntimeInSeconds = Shapes::IntegerShape.new(name: 'MaxRuntimeInSeconds')
+    MetricData = Shapes::StructureShape.new(name: 'MetricData')
     MetricDefinition = Shapes::StructureShape.new(name: 'MetricDefinition')
     MetricDefinitionList = Shapes::ListShape.new(name: 'MetricDefinitionList')
     MetricName = Shapes::StringShape.new(name: 'MetricName')
@@ -189,6 +194,8 @@ module Aws::SageMaker
     ParameterRanges = Shapes::StructureShape.new(name: 'ParameterRanges')
     ParameterValue = Shapes::StringShape.new(name: 'ParameterValue')
     ParameterValues = Shapes::ListShape.new(name: 'ParameterValues')
+    ParentHyperParameterTuningJob = Shapes::StructureShape.new(name: 'ParentHyperParameterTuningJob')
+    ParentHyperParameterTuningJobs = Shapes::ListShape.new(name: 'ParentHyperParameterTuningJobs')
     ProductionVariant = Shapes::StructureShape.new(name: 'ProductionVariant')
     ProductionVariantInstanceType = Shapes::StringShape.new(name: 'ProductionVariantInstanceType')
     ProductionVariantList = Shapes::ListShape.new(name: 'ProductionVariantList')
@@ -279,8 +286,9 @@ module Aws::SageMaker
     AddTagsOutput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
     AddTagsOutput.struct_class = Types::AddTagsOutput
 
-    AlgorithmSpecification.add_member(:training_image, Shapes::ShapeRef.new(shape: AlgorithmImage, required: true, location_name: "TrainingImage"))
+    AlgorithmSpecification.add_member(:training_image, Shapes::ShapeRef.new(shape: AlgorithmImage, location_name: "TrainingImage"))
     AlgorithmSpecification.add_member(:training_input_mode, Shapes::ShapeRef.new(shape: TrainingInputMode, required: true, location_name: "TrainingInputMode"))
+    AlgorithmSpecification.add_member(:metric_definitions, Shapes::ShapeRef.new(shape: MetricDefinitionList, location_name: "MetricDefinitions"))
     AlgorithmSpecification.struct_class = Types::AlgorithmSpecification
 
     CategoricalParameterRange.add_member(:name, Shapes::ShapeRef.new(shape: ParameterKey, required: true, location_name: "Name"))
@@ -330,6 +338,7 @@ module Aws::SageMaker
     CreateHyperParameterTuningJobRequest.add_member(:hyper_parameter_tuning_job_name, Shapes::ShapeRef.new(shape: HyperParameterTuningJobName, required: true, location_name: "HyperParameterTuningJobName"))
     CreateHyperParameterTuningJobRequest.add_member(:hyper_parameter_tuning_job_config, Shapes::ShapeRef.new(shape: HyperParameterTuningJobConfig, required: true, location_name: "HyperParameterTuningJobConfig"))
     CreateHyperParameterTuningJobRequest.add_member(:training_job_definition, Shapes::ShapeRef.new(shape: HyperParameterTrainingJobDefinition, required: true, location_name: "TrainingJobDefinition"))
+    CreateHyperParameterTuningJobRequest.add_member(:warm_start_config, Shapes::ShapeRef.new(shape: HyperParameterTuningJobWarmStartConfig, location_name: "WarmStartConfig"))
     CreateHyperParameterTuningJobRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
     CreateHyperParameterTuningJobRequest.struct_class = Types::CreateHyperParameterTuningJobRequest
 
@@ -474,6 +483,8 @@ module Aws::SageMaker
     DescribeHyperParameterTuningJobResponse.add_member(:training_job_status_counters, Shapes::ShapeRef.new(shape: TrainingJobStatusCounters, required: true, location_name: "TrainingJobStatusCounters"))
     DescribeHyperParameterTuningJobResponse.add_member(:objective_status_counters, Shapes::ShapeRef.new(shape: ObjectiveStatusCounters, required: true, location_name: "ObjectiveStatusCounters"))
     DescribeHyperParameterTuningJobResponse.add_member(:best_training_job, Shapes::ShapeRef.new(shape: HyperParameterTrainingJobSummary, location_name: "BestTrainingJob"))
+    DescribeHyperParameterTuningJobResponse.add_member(:overall_best_training_job, Shapes::ShapeRef.new(shape: HyperParameterTrainingJobSummary, location_name: "OverallBestTrainingJob"))
+    DescribeHyperParameterTuningJobResponse.add_member(:warm_start_config, Shapes::ShapeRef.new(shape: HyperParameterTuningJobWarmStartConfig, location_name: "WarmStartConfig"))
     DescribeHyperParameterTuningJobResponse.add_member(:failure_reason, Shapes::ShapeRef.new(shape: FailureReason, location_name: "FailureReason"))
     DescribeHyperParameterTuningJobResponse.struct_class = Types::DescribeHyperParameterTuningJobResponse
 
@@ -543,6 +554,7 @@ module Aws::SageMaker
     DescribeTrainingJobResponse.add_member(:training_end_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "TrainingEndTime"))
     DescribeTrainingJobResponse.add_member(:last_modified_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "LastModifiedTime"))
     DescribeTrainingJobResponse.add_member(:secondary_status_transitions, Shapes::ShapeRef.new(shape: SecondaryStatusTransitions, location_name: "SecondaryStatusTransitions"))
+    DescribeTrainingJobResponse.add_member(:final_metric_data_list, Shapes::ShapeRef.new(shape: FinalMetricDataList, location_name: "FinalMetricDataList"))
     DescribeTrainingJobResponse.struct_class = Types::DescribeTrainingJobResponse
 
     DescribeTransformJobRequest.add_member(:transform_job_name, Shapes::ShapeRef.new(shape: TransformJobName, required: true, location_name: "TransformJobName"))
@@ -596,7 +608,9 @@ module Aws::SageMaker
     FinalHyperParameterTuningJobObjectiveMetric.add_member(:value, Shapes::ShapeRef.new(shape: MetricValue, required: true, location_name: "Value"))
     FinalHyperParameterTuningJobObjectiveMetric.struct_class = Types::FinalHyperParameterTuningJobObjectiveMetric
 
-    HyperParameterAlgorithmSpecification.add_member(:training_image, Shapes::ShapeRef.new(shape: AlgorithmImage, required: true, location_name: "TrainingImage"))
+    FinalMetricDataList.member = Shapes::ShapeRef.new(shape: MetricData)
+
+    HyperParameterAlgorithmSpecification.add_member(:training_image, Shapes::ShapeRef.new(shape: AlgorithmImage, location_name: "TrainingImage"))
     HyperParameterAlgorithmSpecification.add_member(:training_input_mode, Shapes::ShapeRef.new(shape: TrainingInputMode, required: true, location_name: "TrainingInputMode"))
     HyperParameterAlgorithmSpecification.add_member(:metric_definitions, Shapes::ShapeRef.new(shape: MetricDefinitionList, location_name: "MetricDefinitions"))
     HyperParameterAlgorithmSpecification.struct_class = Types::HyperParameterAlgorithmSpecification
@@ -604,7 +618,7 @@ module Aws::SageMaker
     HyperParameterTrainingJobDefinition.add_member(:static_hyper_parameters, Shapes::ShapeRef.new(shape: HyperParameters, location_name: "StaticHyperParameters"))
     HyperParameterTrainingJobDefinition.add_member(:algorithm_specification, Shapes::ShapeRef.new(shape: HyperParameterAlgorithmSpecification, required: true, location_name: "AlgorithmSpecification"))
     HyperParameterTrainingJobDefinition.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, required: true, location_name: "RoleArn"))
-    HyperParameterTrainingJobDefinition.add_member(:input_data_config, Shapes::ShapeRef.new(shape: InputDataConfig, required: true, location_name: "InputDataConfig"))
+    HyperParameterTrainingJobDefinition.add_member(:input_data_config, Shapes::ShapeRef.new(shape: InputDataConfig, location_name: "InputDataConfig"))
     HyperParameterTrainingJobDefinition.add_member(:vpc_config, Shapes::ShapeRef.new(shape: VpcConfig, location_name: "VpcConfig"))
     HyperParameterTrainingJobDefinition.add_member(:output_data_config, Shapes::ShapeRef.new(shape: OutputDataConfig, required: true, location_name: "OutputDataConfig"))
     HyperParameterTrainingJobDefinition.add_member(:resource_config, Shapes::ShapeRef.new(shape: ResourceConfig, required: true, location_name: "ResourceConfig"))
@@ -615,6 +629,7 @@ module Aws::SageMaker
 
     HyperParameterTrainingJobSummary.add_member(:training_job_name, Shapes::ShapeRef.new(shape: TrainingJobName, required: true, location_name: "TrainingJobName"))
     HyperParameterTrainingJobSummary.add_member(:training_job_arn, Shapes::ShapeRef.new(shape: TrainingJobArn, required: true, location_name: "TrainingJobArn"))
+    HyperParameterTrainingJobSummary.add_member(:tuning_job_name, Shapes::ShapeRef.new(shape: HyperParameterTuningJobName, location_name: "TuningJobName"))
     HyperParameterTrainingJobSummary.add_member(:creation_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "CreationTime"))
     HyperParameterTrainingJobSummary.add_member(:training_start_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "TrainingStartTime"))
     HyperParameterTrainingJobSummary.add_member(:training_end_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "TrainingEndTime"))
@@ -649,6 +664,10 @@ module Aws::SageMaker
     HyperParameterTuningJobSummary.add_member(:resource_limits, Shapes::ShapeRef.new(shape: ResourceLimits, location_name: "ResourceLimits"))
     HyperParameterTuningJobSummary.struct_class = Types::HyperParameterTuningJobSummary
 
+    HyperParameterTuningJobWarmStartConfig.add_member(:parent_hyper_parameter_tuning_jobs, Shapes::ShapeRef.new(shape: ParentHyperParameterTuningJobs, required: true, location_name: "ParentHyperParameterTuningJobs"))
+    HyperParameterTuningJobWarmStartConfig.add_member(:warm_start_type, Shapes::ShapeRef.new(shape: HyperParameterTuningJobWarmStartType, required: true, location_name: "WarmStartType"))
+    HyperParameterTuningJobWarmStartConfig.struct_class = Types::HyperParameterTuningJobWarmStartConfig
+
     HyperParameters.key = Shapes::ShapeRef.new(shape: ParameterKey)
     HyperParameters.value = Shapes::ShapeRef.new(shape: ParameterValue)
 
@@ -804,6 +823,11 @@ module Aws::SageMaker
     ListTransformJobsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
     ListTransformJobsResponse.struct_class = Types::ListTransformJobsResponse
 
+    MetricData.add_member(:metric_name, Shapes::ShapeRef.new(shape: MetricName, location_name: "MetricName"))
+    MetricData.add_member(:value, Shapes::ShapeRef.new(shape: Float, location_name: "Value"))
+    MetricData.add_member(:timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "Timestamp"))
+    MetricData.struct_class = Types::MetricData
+
     MetricDefinition.add_member(:name, Shapes::ShapeRef.new(shape: MetricName, required: true, location_name: "Name"))
     MetricDefinition.add_member(:regex, Shapes::ShapeRef.new(shape: MetricRegex, required: true, location_name: "Regex"))
     MetricDefinition.struct_class = Types::MetricDefinition
@@ -861,6 +885,11 @@ module Aws::SageMaker
 
     ParameterValues.member = Shapes::ShapeRef.new(shape: ParameterValue)
 
+    ParentHyperParameterTuningJob.add_member(:hyper_parameter_tuning_job_name, Shapes::ShapeRef.new(shape: HyperParameterTuningJobName, location_name: "HyperParameterTuningJobName"))
+    ParentHyperParameterTuningJob.struct_class = Types::ParentHyperParameterTuningJob
+
+    ParentHyperParameterTuningJobs.member = Shapes::ShapeRef.new(shape: ParentHyperParameterTuningJob)
+
     ProductionVariant.add_member(:variant_name, Shapes::ShapeRef.new(shape: VariantName, required: true, location_name: "VariantName"))
     ProductionVariant.add_member(:model_name, Shapes::ShapeRef.new(shape: ModelName, required: true, location_name: "ModelName"))
     ProductionVariant.add_member(:initial_instance_count, Shapes::ShapeRef.new(shape: TaskCount, required: true, location_name: "InitialInstanceCount"))

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

@@ -67,8 +67,14 @@ module Aws::SageMaker
     #   data as a hash:
     #
     #       {
-    #         training_image: "AlgorithmImage", # required
+    #         training_image: "AlgorithmImage",
     #         training_input_mode: "Pipe", # required, accepts Pipe, File
+    #         metric_definitions: [
+    #           {
+    #             name: "MetricName", # required
+    #             regex: "MetricRegex", # required
+    #           },
+    #         ],
     #       }
     #
     # @!attribute [rw] training_image
@@ -110,11 +116,18 @@ module Aws::SageMaker
     #   [1]: http://docs.aws.amazon.com/sagemaker/latest/dg/algos.html
     #   @return [String]
     #
+    # @!attribute [rw] metric_definitions
+    #   A list of metric definition objects. Each object specifies the
+    #   metric name and regular expressions used to parse algorithm logs.
+    #   Amazon SageMaker publishes each metric to Amazon CloudWatch.
+    #   @return [Array<Types::MetricDefinition>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/AlgorithmSpecification AWS API Documentation
     #
     class AlgorithmSpecification < Struct.new(
       :training_image,
-      :training_input_mode)
+      :training_input_mode,
+      :metric_definitions)
       include Aws::Structure
     end
 
@@ -201,6 +214,18 @@ module Aws::SageMaker
     #   @return [String]
     #
     # @!attribute [rw] input_mode
+    #   (Optional) The input mode to use for the data channel in a training
+    #   job. If you don't set a value for `InputMode`, Amazon SageMaker
+    #   uses the value set for `TrainingInputMode`. Use this parameter to
+    #   override the `TrainingInputMode` setting in a AlgorithmSpecification
+    #   request when you have a channel that needs a different input mode
+    #   from the training job's general setting. To download the data from
+    #   Amazon Simple Storage Service (Amazon S3) to the provisioned ML
+    #   storage volume, and mount the directory to a Docker volume, use
+    #   `File` input mode. To stream data directly from Amazon S3 to the
+    #   container, choose `Pipe` input mode.
+    #
+    #   To use a model for incremental training, choose `File` input model.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/Channel AWS API Documentation
@@ -258,7 +283,7 @@ module Aws::SageMaker
     #   you provide. AWS STS is activated in your IAM user account by
     #   default. If you previously deactivated AWS STS for a region, you
     #   need to reactivate AWS STS for that region. For more information,
-    #   see [Activating and Deactivating AWS STS i an AWS Region][1] in the
+    #   see [Activating and Deactivating AWS STS in an AWS Region][1] in the
     #   *AWS Identity and Access Management User Guide*.
     #
     #
@@ -492,7 +517,7 @@ module Aws::SageMaker
     #             "ParameterKey" => "ParameterValue",
     #           },
     #           algorithm_specification: { # required
-    #             training_image: "AlgorithmImage", # required
+    #             training_image: "AlgorithmImage",
     #             training_input_mode: "Pipe", # required, accepts Pipe, File
     #             metric_definitions: [
     #               {
@@ -502,7 +527,7 @@ module Aws::SageMaker
     #             ],
     #           },
     #           role_arn: "RoleArn", # required
-    #           input_data_config: [ # required
+    #           input_data_config: [
     #             {
     #               channel_name: "ChannelName", # required
     #               data_source: { # required
@@ -536,6 +561,14 @@ module Aws::SageMaker
     #             max_runtime_in_seconds: 1,
     #           },
     #         },
+    #         warm_start_config: {
+    #           parent_hyper_parameter_tuning_jobs: [ # required
+    #             {
+    #               hyper_parameter_tuning_job_name: "HyperParameterTuningJobName",
+    #             },
+    #           ],
+    #           warm_start_type: "IdenticalDataAndAlgorithm", # required, accepts IdenticalDataAndAlgorithm, TransferLearning
+    #         },
     #         tags: [
     #           {
     #             key: "TagKey", # required
@@ -547,15 +580,17 @@ module Aws::SageMaker
     # @!attribute [rw] hyper_parameter_tuning_job_name
     #   The name of the tuning job. This name is the prefix for the names of
     #   all training jobs that this tuning job launches. The name must be
-    #   unique within the same AWS account and AWS Region. Names are not
-    #   case sensitive, and must be between 1-32 characters.
+    #   unique within the same AWS account and AWS Region. The name must
+    #   have \\\{ \\} to \\\{ \\} characters. Valid characters are a-z, A-Z,
+    #   0-9, and : + = @ \_ % - (hyphen). The name is not case sensitive.
     #   @return [String]
     #
     # @!attribute [rw] hyper_parameter_tuning_job_config
     #   The HyperParameterTuningJobConfig object that describes the tuning
-    #   job, including the search strategy, metric used to evaluate training
-    #   jobs, ranges of parameters to search, and resource limits for the
-    #   tuning job.
+    #   job, including the search strategy, the objective metric used to
+    #   evaluate training jobs, ranges of parameters to search, and resource
+    #   limits for the tuning job. For more information, see
+    #   automatic-model-tuning
     #   @return [Types::HyperParameterTuningJobConfig]
     #
     # @!attribute [rw] training_job_definition
@@ -565,6 +600,29 @@ module Aws::SageMaker
     #   configuration, resource configuration, and stopping condition.
     #   @return [Types::HyperParameterTrainingJobDefinition]
     #
+    # @!attribute [rw] warm_start_config
+    #   Specifies configuration for starting the hyperparameter tuning job
+    #   using one or more previous tuning jobs as a starting point. The
+    #   results of previous tuning jobs are used to inform which
+    #   combinations of hyperparameters to search over in the new tuning
+    #   job.
+    #
+    #   All training jobs launched by the new hyperparameter tuning job are
+    #   evaluated by using the objective metric. If you specify
+    #   `IDENTICAL_DATA_AND_ALGORITHM` as the `WarmStartType` for the warm
+    #   start configuration, the training job that performs the best in the
+    #   new tuning job is compared to the best training jobs from the parent
+    #   tuning jobs. From these, the training job that performs the best as
+    #   measured by the objective metric is returned as the overall best
+    #   training job.
+    #
+    #   <note markdown="1"> All training jobs launched by parent hyperparameter tuning jobs and
+    #   the new hyperparameter tuning jobs count against the limit of
+    #   training jobs for the tuning job.
+    #
+    #    </note>
+    #   @return [Types::HyperParameterTuningJobWarmStartConfig]
+    #
     # @!attribute [rw] tags
     #   An array of key-value pairs. You can use tags to categorize your AWS
     #   resources in different ways, for example, by purpose, owner, or
@@ -584,12 +642,14 @@ module Aws::SageMaker
       :hyper_parameter_tuning_job_name,
       :hyper_parameter_tuning_job_config,
       :training_job_definition,
+      :warm_start_config,
       :tags)
       include Aws::Structure
     end
 
     # @!attribute [rw] hyper_parameter_tuning_job_arn
-    #   The Amazon Resource Name (ARN) of the tuning job.
+    #   The Amazon Resource Name (ARN) of the tuning job. Amazon SageMaker
+    #   assigns an ARN to a hyperparameter tuning job when you create it.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/CreateHyperParameterTuningJobResponse AWS API Documentation
@@ -703,7 +763,7 @@ module Aws::SageMaker
     #
     #       {
     #         notebook_instance_name: "NotebookInstanceName", # required
-    #         instance_type: "ml.t2.medium", # required, accepts ml.t2.medium, ml.t2.large, ml.t2.xlarge, ml.t2.2xlarge, ml.m4.xlarge, ml.m4.2xlarge, ml.m4.4xlarge, ml.m4.10xlarge, ml.m4.16xlarge, ml.p2.xlarge, ml.p2.8xlarge, ml.p2.16xlarge, ml.p3.2xlarge, ml.p3.8xlarge, ml.p3.16xlarge
+    #         instance_type: "ml.t2.medium", # required, accepts ml.t2.medium, ml.t2.large, ml.t2.xlarge, ml.t2.2xlarge, ml.t3.medium, ml.t3.large, ml.t3.xlarge, ml.t3.2xlarge, ml.m4.xlarge, ml.m4.2xlarge, ml.m4.4xlarge, ml.m4.10xlarge, ml.m4.16xlarge, ml.m5.xlarge, ml.m5.2xlarge, ml.m5.4xlarge, ml.m5.12xlarge, ml.m5.24xlarge, ml.c4.xlarge, ml.c4.2xlarge, ml.c4.4xlarge, ml.c4.8xlarge, ml.c5.xlarge, ml.c5.2xlarge, ml.c5.4xlarge, ml.c5.9xlarge, ml.c5.18xlarge, ml.c5d.xlarge, ml.c5d.2xlarge, ml.c5d.4xlarge, ml.c5d.9xlarge, ml.c5d.18xlarge, ml.p2.xlarge, ml.p2.8xlarge, ml.p2.16xlarge, ml.p3.2xlarge, ml.p3.8xlarge, ml.p3.16xlarge
     #         subnet_id: "SubnetId",
     #         security_group_ids: ["SecurityGroupId"],
     #         role_arn: "RoleArn", # required
@@ -759,7 +819,13 @@ module Aws::SageMaker
     # @!attribute [rw] kms_key_id
     #   If you provide a AWS KMS key ID, Amazon SageMaker uses it to encrypt
     #   data at rest on the ML storage volume that is attached to your
-    #   notebook instance.
+    #   notebook instance. The KMS key you provide must be enabled. For
+    #   information, see [Enabling and Disabling Keys][1] in the *AWS Key
+    #   Management Service Developer Guide*.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/kms/latest/developerguide/enabling-keys.html
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -795,7 +861,7 @@ module Aws::SageMaker
     #
     # @!attribute [rw] volume_size_in_gb
     #   The size, in GB, of the ML storage volume to attach to the notebook
-    #   instance.
+    #   instance. The default value is 5 GB.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/CreateNotebookInstanceInput AWS API Documentation
@@ -921,8 +987,14 @@ module Aws::SageMaker
     #           "ParameterKey" => "ParameterValue",
     #         },
     #         algorithm_specification: { # required
-    #           training_image: "AlgorithmImage", # required
+    #           training_image: "AlgorithmImage",
     #           training_input_mode: "Pipe", # required, accepts Pipe, File
+    #           metric_definitions: [
+    #             {
+    #               name: "MetricName", # required
+    #               regex: "MetricRegex", # required
+    #             },
+    #           ],
     #         },
     #         role_arn: "RoleArn", # required
     #         input_data_config: [
@@ -1660,6 +1732,22 @@ module Aws::SageMaker
     #   completed with the best current HyperParameterTuningJobObjective.
     #   @return [Types::HyperParameterTrainingJobSummary]
     #
+    # @!attribute [rw] overall_best_training_job
+    #   If the hyperparameter tuning job is an incremental tuning job with a
+    #   `WarmStartType` of `IDENTICAL_DATA_AND_ALGORITHM`, this is the
+    #   TrainingJobSummary for the training job with the best objective
+    #   metric value of all training jobs launched by this tuning job and
+    #   all parent jobs specified for the incremental tuning job.
+    #   @return [Types::HyperParameterTrainingJobSummary]
+    #
+    # @!attribute [rw] warm_start_config
+    #   The configuration for starting the hyperparameter parameter tuning
+    #   job using one or more previous tuning jobs as a starting point. The
+    #   results of previous tuning jobs are used to inform which
+    #   combinations of hyperparameters to search over in the new tuning
+    #   job.
+    #   @return [Types::HyperParameterTuningJobWarmStartConfig]
+    #
     # @!attribute [rw] failure_reason
     #   If the tuning job failed, the reason it failed.
     #   @return [String]
@@ -1678,6 +1766,8 @@ module Aws::SageMaker
       :training_job_status_counters,
       :objective_status_counters,
       :best_training_job,
+      :overall_best_training_job,
+      :warm_start_config,
       :failure_reason)
       include Aws::Structure
     end
@@ -2121,6 +2211,12 @@ module Aws::SageMaker
     #   transitioned through.
     #   @return [Array<Types::SecondaryStatusTransition>]
     #
+    # @!attribute [rw] final_metric_data_list
+    #   A collection of `MetricData` objects that specify the names, values,
+    #   and dates and times that the training algorithm emitted to Amazon
+    #   CloudWatch.
+    #   @return [Array<Types::MetricData>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/DescribeTrainingJobResponse AWS API Documentation
     #
     class DescribeTrainingJobResponse < Struct.new(
@@ -2143,7 +2239,8 @@ module Aws::SageMaker
       :training_start_time,
       :training_end_time,
       :last_modified_time,
-      :secondary_status_transitions)
+      :secondary_status_transitions,
+      :final_metric_data_list)
       include Aws::Structure
     end
 
@@ -2413,7 +2510,7 @@ module Aws::SageMaker
     #   data as a hash:
     #
     #       {
-    #         training_image: "AlgorithmImage", # required
+    #         training_image: "AlgorithmImage",
     #         training_input_mode: "Pipe", # required, accepts Pipe, File
     #         metric_definitions: [
     #           {
@@ -2480,7 +2577,7 @@ module Aws::SageMaker
     #           "ParameterKey" => "ParameterValue",
     #         },
     #         algorithm_specification: { # required
-    #           training_image: "AlgorithmImage", # required
+    #           training_image: "AlgorithmImage",
     #           training_input_mode: "Pipe", # required, accepts Pipe, File
     #           metric_definitions: [
     #             {
@@ -2490,7 +2587,7 @@ module Aws::SageMaker
     #           ],
     #         },
     #         role_arn: "RoleArn", # required
-    #         input_data_config: [ # required
+    #         input_data_config: [
     #           {
     #             channel_name: "ChannelName", # required
     #             data_source: { # required
@@ -2611,6 +2708,9 @@ module Aws::SageMaker
     #   The Amazon Resource Name (ARN) of the training job.
     #   @return [String]
     #
+    # @!attribute [rw] tuning_job_name
+    #   @return [String]
+    #
     # @!attribute [rw] creation_time
     #   The date and time that the training job was created.
     #   @return [Time]
@@ -2671,6 +2771,7 @@ module Aws::SageMaker
     class HyperParameterTrainingJobSummary < Struct.new(
       :training_job_name,
       :training_job_arn,
+      :tuning_job_name,
       :creation_time,
       :training_start_time,
       :training_end_time,
@@ -2846,6 +2947,84 @@ module Aws::SageMaker
       include Aws::Structure
     end
 
+    # Specifies the configuration for a hyperparameter tuning job that uses
+    # one or more previous hyperparameter tuning jobs as a starting point.
+    # The results of previous tuning jobs are used to inform which
+    # combinations of hyperparameters to search over in the new tuning job.
+    #
+    # All training jobs launched by the new hyperparameter tuning job are
+    # evaluated by using the objective metric, and the training job that
+    # performs the best is compared to the best training jobs from the
+    # parent tuning jobs. From these, the training job that performs the
+    # best as measured by the objective metric is returned as the overall
+    # best training job.
+    #
+    # <note markdown="1"> All training jobs launched by parent hyperparameter tuning jobs and
+    # the new hyperparameter tuning jobs count against the limit of training
+    # jobs for the tuning job.
+    #
+    #  </note>
+    #
+    # @note When making an API call, you may pass HyperParameterTuningJobWarmStartConfig
+    #   data as a hash:
+    #
+    #       {
+    #         parent_hyper_parameter_tuning_jobs: [ # required
+    #           {
+    #             hyper_parameter_tuning_job_name: "HyperParameterTuningJobName",
+    #           },
+    #         ],
+    #         warm_start_type: "IdenticalDataAndAlgorithm", # required, accepts IdenticalDataAndAlgorithm, TransferLearning
+    #       }
+    #
+    # @!attribute [rw] parent_hyper_parameter_tuning_jobs
+    #   An array of hyperparameter tuning jobs that are used as the starting
+    #   point for the new hyperparameter tuning job. For more information
+    #   about warm starting a hyperparameter tuning job, see [Using a
+    #   Previous Hyperparameter Tuning Job as a Starting Point][1].
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/automatic-model-tuning-incremental
+    #   @return [Array<Types::ParentHyperParameterTuningJob>]
+    #
+    # @!attribute [rw] warm_start_type
+    #   Specifies one of the following:
+    #
+    #   IDENTICAL\_DATA\_AND\_ALGORITHM
+    #
+    #   : The new hyperparameter tuning job uses the same input data and
+    #     training image as the parent tuning jobs. You can change the
+    #     hyperparameter ranges to search and the maximum number of training
+    #     jobs that the hyperparameter tuning job launches. You cannot use a
+    #     new version of the training algorithm, unless the changes in the
+    #     new version do not affect the algorithm itself. For example,
+    #     changes that improve logging or adding support for a different
+    #     data format are allowed. The objective metric for the new tuning
+    #     job must be the same as for all parent jobs.
+    #
+    #   TRANSFER\_LEARNING
+    #
+    #   : The new hyperparameter tuning job can include input data,
+    #     hyperparameter ranges, maximum number of concurrent training jobs,
+    #     and maximum number of training jobs that are different than those
+    #     of its parent hyperparameter tuning jobs. The training image can
+    #     also be a different versionfrom the version used in the parent
+    #     hyperparameter tuning job. You can also change hyperparameters
+    #     from tunable to static, and from static to tunable, but the total
+    #     number of static plus tunable hyperparameters must remain the same
+    #     as it is in all parent jobs. The objective metric for the new
+    #     tuning job must be the same as for all parent jobs.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/HyperParameterTuningJobWarmStartConfig AWS API Documentation
+    #
+    class HyperParameterTuningJobWarmStartConfig < Struct.new(
+      :parent_hyper_parameter_tuning_jobs,
+      :warm_start_type)
+      include Aws::Structure
+    end
+
     # For a hyperparameter of the integer type, specifies the range that a
     # hyperparameter tuning job searches.
     #
@@ -3764,6 +3943,30 @@ module Aws::SageMaker
       include Aws::Structure
     end
 
+    # The name, value, and date and time of a metric that was emitted to
+    # Amazon CloudWatch.
+    #
+    # @!attribute [rw] metric_name
+    #   The name of the metric.
+    #   @return [String]
+    #
+    # @!attribute [rw] value
+    #   The value of the metric.
+    #   @return [Float]
+    #
+    # @!attribute [rw] timestamp
+    #   The date and time that the algorithm emitted the metric.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/MetricData AWS API Documentation
+    #
+    class MetricData < Struct.new(
+      :metric_name,
+      :value,
+      :timestamp)
+      include Aws::Structure
+    end
+
     # Specifies a metric that the training algorithm writes to `stderr` or
     # `stdout`. Amazon SageMakerhyperparameter tuning captures all defined
     # metrics. You specify one metric that a hyperparameter tuning job uses
@@ -4064,7 +4267,17 @@ module Aws::SageMaker
     end
 
     # Specifies ranges of integer, continuous, and categorical
-    # hyperparameters that a hyperparameter tuning job searches.
+    # hyperparameters that a hyperparameter tuning job searches. The
+    # hyperparameter tuning job launches training jobs with hyperparameter
+    # values within these ranges to find the combination of values that
+    # result in the training job with the best performance as measured by
+    # the objective metric of the hyperparameter tuning job.
+    #
+    # <note markdown="1"> You can specify a maximum of 20 hyperparameters that a hyperparameter
+    # tuning job can search over. Every possible value of a categorical
+    # parameter range counts against this limit.
+    #
+    #  </note>
     #
     # @note When making an API call, you may pass ParameterRanges
     #   data as a hash:
@@ -4118,6 +4331,28 @@ module Aws::SageMaker
       include Aws::Structure
     end
 
+    # A previously completed or stopped hyperparameter tuning job to be used
+    # as a starting point for a new hyperparameter tuning job.
+    #
+    # @note When making an API call, you may pass ParentHyperParameterTuningJob
+    #   data as a hash:
+    #
+    #       {
+    #         hyper_parameter_tuning_job_name: "HyperParameterTuningJobName",
+    #       }
+    #
+    # @!attribute [rw] hyper_parameter_tuning_job_name
+    #   The name of the hyperparameter tuning job to be used as a starting
+    #   point for a new hyperparameter tuning job.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/ParentHyperParameterTuningJob AWS API Documentation
+    #
+    class ParentHyperParameterTuningJob < Struct.new(
+      :hyper_parameter_tuning_job_name)
+      include Aws::Structure
+    end
+
     # Identifies a model that you want to host and the resources to deploy
     # for hosting it. If you are deploying multiple models, tell Amazon
     # SageMaker how to distribute traffic among the models by specifying
@@ -4358,7 +4593,7 @@ module Aws::SageMaker
     #
     #     `s3://customer_bucket/some/prefix/relative/path/to/custdata-1`
     #
-    #     `s3://customer_bucket/some/prefix/relative/path/custdata-1`
+    #     `s3://customer_bucket/some/prefix/relative/path/custdata-2`
     #
     #     `...`
     #
@@ -4678,7 +4913,7 @@ module Aws::SageMaker
     # categorized by status.
     #
     # @!attribute [rw] completed
-    #   The number of completed training jobs launched by a hyperparameter
+    #   The number of completed training jobs launched by the hyperparameter
     #   tuning job.
     #   @return [Integer]
     #
@@ -5178,7 +5413,7 @@ module Aws::SageMaker
     #
     #       {
     #         notebook_instance_name: "NotebookInstanceName", # required
-    #         instance_type: "ml.t2.medium", # accepts ml.t2.medium, ml.t2.large, ml.t2.xlarge, ml.t2.2xlarge, ml.m4.xlarge, ml.m4.2xlarge, ml.m4.4xlarge, ml.m4.10xlarge, ml.m4.16xlarge, ml.p2.xlarge, ml.p2.8xlarge, ml.p2.16xlarge, ml.p3.2xlarge, ml.p3.8xlarge, ml.p3.16xlarge
+    #         instance_type: "ml.t2.medium", # accepts ml.t2.medium, ml.t2.large, ml.t2.xlarge, ml.t2.2xlarge, ml.t3.medium, ml.t3.large, ml.t3.xlarge, ml.t3.2xlarge, ml.m4.xlarge, ml.m4.2xlarge, ml.m4.4xlarge, ml.m4.10xlarge, ml.m4.16xlarge, ml.m5.xlarge, ml.m5.2xlarge, ml.m5.4xlarge, ml.m5.12xlarge, ml.m5.24xlarge, ml.c4.xlarge, ml.c4.2xlarge, ml.c4.4xlarge, ml.c4.8xlarge, ml.c5.xlarge, ml.c5.2xlarge, ml.c5.4xlarge, ml.c5.9xlarge, ml.c5.18xlarge, ml.c5d.xlarge, ml.c5d.2xlarge, ml.c5d.4xlarge, ml.c5d.9xlarge, ml.c5d.18xlarge, ml.p2.xlarge, ml.p2.8xlarge, ml.p2.16xlarge, ml.p3.2xlarge, ml.p3.8xlarge, ml.p3.16xlarge
     #         role_arn: "RoleArn",
     #         lifecycle_config_name: "NotebookInstanceLifecycleConfigName",
     #         disassociate_lifecycle_config: false,
@@ -5225,7 +5460,7 @@ module Aws::SageMaker
     #
     # @!attribute [rw] volume_size_in_gb
     #   The size, in GB, of the ML storage volume to attach to the notebook
-    #   instance.
+    #   instance. The default value is 5 GB.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/UpdateNotebookInstanceInput AWS API Documentation

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-sagemaker
 version: !ruby/object:Gem::Version
-  version: 1.22.0
+  version: 1.23.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-10-26 00:00:00.000000000 Z
+date: 2018-11-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core