aws-sdk-sagemaker 1.8.0 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8ad9be1b29f0f5dc29d0dbd9250b1168e155a0a5
-  data.tar.gz: 1887551b57d6aa95516cbd0680af9fd33a2eb439
+  metadata.gz: e09e0703f83088e0e2786a3b3d85c9eef5ef2178
+  data.tar.gz: 7826516a35e3b855c68b2a63ac7eab75784363d9
 SHA512:
-  metadata.gz: 8193d8cab265584cdadfe2bbbb871d8543902c8524c0ad3cb899bafbaab42988930888be55962365f7776faa48712e61f42a1c10fa64af0fa31c60c2398f37ef
-  data.tar.gz: 723f595bafcaeae232beee20fb9998871552a1ce7757f2d8f0c557fee0fbda37418a6bec2f9ddc90e77117a4d0dfceb60a30bf6f4bf1a603b437c58c0be8c7c5
+  metadata.gz: cf93fea2da9f1ccb6b1de1ed880620514a437c4f5f7c371817b1fb052fed084b8911035c83245f3e9cca976c444b4e7058ecb1052a35d8d4802a05e08e07bcff
+  data.tar.gz: 212d0aca54f4d5709f9f528cd0265bfd5aafe13126f1a7617b4bcbaf678556e31289764d541122174180efc90331dab77a90085ff2e1b594b5fc1386ef4430f0

data/lib/aws-sdk-sagemaker.rb

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

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

@@ -382,6 +382,145 @@ module Aws::SageMaker
       req.send_request(options)
     end
 
+    # Starts a hyperparameter tuning job.
+    #
+    # @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.
+    #
+    # @option params [required, Types::HyperParameterTuningJobConfig] :hyper_parameter_tuning_job_config
+    #   The 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.
+    #
+    # @option params [required, Types::HyperParameterTrainingJobDefinition] :training_job_definition
+    #   The object that describes the training jobs that this tuning job
+    #   launches, including static hyperparameters, input data configuration,
+    #   output data configuration, resource configuration, and stopping
+    #   condition.
+    #
+    # @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
+    #   environment. For more information, see [Using Cost Allocation Tags][1]
+    #   in the *AWS Billing and Cost Management User Guide*.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com//awsaccountbilling/latest/aboutv2/cost-alloc-tags.html#allocation-what
+    #
+    # @return [Types::CreateHyperParameterTuningJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateHyperParameterTuningJobResponse#hyper_parameter_tuning_job_arn #hyper_parameter_tuning_job_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_hyper_parameter_tuning_job({
+    #     hyper_parameter_tuning_job_name: "HyperParameterTuningJobName", # required
+    #     hyper_parameter_tuning_job_config: { # required
+    #       strategy: "Bayesian", # required, accepts Bayesian
+    #       hyper_parameter_tuning_job_objective: { # required
+    #         type: "Maximize", # required, accepts Maximize, Minimize
+    #         metric_name: "MetricName", # required
+    #       },
+    #       resource_limits: { # required
+    #         max_number_of_training_jobs: 1, # required
+    #         max_parallel_training_jobs: 1, # required
+    #       },
+    #       parameter_ranges: { # required
+    #         integer_parameter_ranges: [
+    #           {
+    #             name: "ParameterKey", # required
+    #             min_value: "ParameterValue", # required
+    #             max_value: "ParameterValue", # required
+    #           },
+    #         ],
+    #         continuous_parameter_ranges: [
+    #           {
+    #             name: "ParameterKey", # required
+    #             min_value: "ParameterValue", # required
+    #             max_value: "ParameterValue", # required
+    #           },
+    #         ],
+    #         categorical_parameter_ranges: [
+    #           {
+    #             name: "ParameterKey", # required
+    #             values: ["ParameterValue"], # required
+    #           },
+    #         ],
+    #       },
+    #     },
+    #     training_job_definition: { # required
+    #       static_hyper_parameters: {
+    #         "ParameterKey" => "ParameterValue",
+    #       },
+    #       algorithm_specification: { # required
+    #         training_image: "AlgorithmImage", # required
+    #         training_input_mode: "Pipe", # required, accepts Pipe, File
+    #         metric_definitions: [
+    #           {
+    #             name: "MetricName", # required
+    #             regex: "MetricRegex", # required
+    #           },
+    #         ],
+    #       },
+    #       role_arn: "RoleArn", # required
+    #       input_data_config: [ # required
+    #         {
+    #           channel_name: "ChannelName", # required
+    #           data_source: { # required
+    #             s3_data_source: { # required
+    #               s3_data_type: "ManifestFile", # required, accepts ManifestFile, S3Prefix
+    #               s3_uri: "S3Uri", # required
+    #               s3_data_distribution_type: "FullyReplicated", # accepts FullyReplicated, ShardedByS3Key
+    #             },
+    #           },
+    #           content_type: "ContentType",
+    #           compression_type: "None", # accepts None, Gzip
+    #           record_wrapper_type: "None", # accepts None, RecordIO
+    #         },
+    #       ],
+    #       vpc_config: {
+    #         security_group_ids: ["SecurityGroupId"], # required
+    #         subnets: ["SubnetId"], # required
+    #       },
+    #       output_data_config: { # required
+    #         kms_key_id: "KmsKeyId",
+    #         s3_output_path: "S3Uri", # required
+    #       },
+    #       resource_config: { # required
+    #         instance_type: "ml.m4.xlarge", # required, accepts ml.m4.xlarge, ml.m4.2xlarge, ml.m4.4xlarge, ml.m4.10xlarge, ml.m4.16xlarge, ml.m5.large, 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.p2.xlarge, ml.p2.8xlarge, ml.p2.16xlarge, ml.p3.2xlarge, ml.p3.8xlarge, ml.p3.16xlarge, ml.c5.xlarge, ml.c5.2xlarge, ml.c5.4xlarge, ml.c5.9xlarge, ml.c5.18xlarge
+    #         instance_count: 1, # required
+    #         volume_size_in_gb: 1, # required
+    #         volume_kms_key_id: "KmsKeyId",
+    #       },
+    #       stopping_condition: { # required
+    #         max_runtime_in_seconds: 1,
+    #       },
+    #     },
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.hyper_parameter_tuning_job_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/CreateHyperParameterTuningJob AWS API Documentation
+    #
+    # @overload create_hyper_parameter_tuning_job(params = {})
+    # @param [Hash] params ({})
+    def create_hyper_parameter_tuning_job(params = {}, options = {})
+      req = build_request(:create_hyper_parameter_tuning_job, params)
+      req.send_request(options)
+    end
+
     # Creates a model in Amazon SageMaker. In the request, you name the
     # model and describe one or more containers. For each container, you
     # specify the docker image containing inference code, artifacts (from
@@ -420,6 +559,11 @@ module Aws::SageMaker
     #   on ML compute instances. Deploying on ML compute instances is part of
     #   model hosting. For more information, see [Amazon SageMaker Roles][1].
     #
+    #   <note markdown="1"> To be able to pass this role to Amazon SageMaker, the caller of this
+    #   API must have the `iam:PassRole` permission.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: http://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-roles.html
@@ -435,8 +579,8 @@ module Aws::SageMaker
     #
     # @option params [Types::VpcConfig] :vpc_config
     #   A object that specifies the VPC that you want your model to connect
-    #   to. Control access to and from your training container by configuring
-    #   the VPC. For more information, see host-vpc.
+    #   to. Control access to and from your model container by configuring the
+    #   VPC. For more information, see host-vpc.
     #
     # @return [Types::CreateModelOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -549,6 +693,11 @@ module Aws::SageMaker
     #   assume this role. For more information, see [Amazon SageMaker
     #   Roles][1].
     #
+    #   <note markdown="1"> To be able to pass this role to Amazon SageMaker, the caller of this
+    #   API must have the `iam:PassRole` permission.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: http://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-roles.html
@@ -678,7 +827,7 @@ module Aws::SageMaker
       req.send_request(options)
     end
 
-    # Returns a URL that you can use to connect to the Juypter server from a
+    # Returns a URL that you can use to connect to the Jupyter server from a
     # notebook instance. In the Amazon SageMaker console, when you choose
     # `Open` next to a notebook instance, Amazon SageMaker opens a new tab
     # showing the Jupyter server home page from the notebook instance. The
@@ -765,10 +914,10 @@ module Aws::SageMaker
     #   Region in an AWS account. It appears in the Amazon SageMaker console.
     #
     # @option params [Hash<String,String>] :hyper_parameters
-    #   Algorithm-specific parameters. You set hyperparameters before you
-    #   start the learning process. Hyperparameters influence the quality of
-    #   the model. For a list of hyperparameters for each training algorithm
-    #   provided by Amazon SageMaker, see [Algorithms][1].
+    #   Algorithm-specific parameters that influence the quality of the model.
+    #   You set hyperparameters before you start the learning process. For a
+    #   list of hyperparameters for each training algorithm provided by Amazon
+    #   SageMaker, see [Algorithms][1].
     #
     #   You can specify a maximum of 100 hyperparameters. Each hyperparameter
     #   is a key-value pair. Each key and value is limited to 256 characters,
@@ -800,6 +949,11 @@ module Aws::SageMaker
     #   grant permissions for all of these tasks to an IAM role. For more
     #   information, see [Amazon SageMaker Roles][1].
     #
+    #   <note markdown="1"> To be able to pass this role to Amazon SageMaker, the caller of this
+    #   API must have the `iam:PassRole` permission.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: http://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-roles.html
@@ -955,7 +1109,7 @@ module Aws::SageMaker
       req.send_request(options)
     end
 
-    # Deletes an endpoint configuration. The `DeleteEndpoingConfig` API
+    # Deletes an endpoint configuration. The `DeleteEndpointConfig` API
     # deletes only the specified configuration. It does not delete endpoints
     # created using the configuration.
     #
@@ -1176,6 +1330,116 @@ module Aws::SageMaker
       req.send_request(options)
     end
 
+    # Gets a description of a hyperparameter tuning job.
+    #
+    # @option params [required, String] :hyper_parameter_tuning_job_name
+    #   The name of the tuning job to describe.
+    #
+    # @return [Types::DescribeHyperParameterTuningJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeHyperParameterTuningJobResponse#hyper_parameter_tuning_job_name #hyper_parameter_tuning_job_name} => String
+    #   * {Types::DescribeHyperParameterTuningJobResponse#hyper_parameter_tuning_job_arn #hyper_parameter_tuning_job_arn} => String
+    #   * {Types::DescribeHyperParameterTuningJobResponse#hyper_parameter_tuning_job_config #hyper_parameter_tuning_job_config} => Types::HyperParameterTuningJobConfig
+    #   * {Types::DescribeHyperParameterTuningJobResponse#training_job_definition #training_job_definition} => Types::HyperParameterTrainingJobDefinition
+    #   * {Types::DescribeHyperParameterTuningJobResponse#hyper_parameter_tuning_job_status #hyper_parameter_tuning_job_status} => String
+    #   * {Types::DescribeHyperParameterTuningJobResponse#creation_time #creation_time} => Time
+    #   * {Types::DescribeHyperParameterTuningJobResponse#hyper_parameter_tuning_end_time #hyper_parameter_tuning_end_time} => Time
+    #   * {Types::DescribeHyperParameterTuningJobResponse#last_modified_time #last_modified_time} => Time
+    #   * {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#failure_reason #failure_reason} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_hyper_parameter_tuning_job({
+    #     hyper_parameter_tuning_job_name: "HyperParameterTuningJobName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.hyper_parameter_tuning_job_name #=> String
+    #   resp.hyper_parameter_tuning_job_arn #=> String
+    #   resp.hyper_parameter_tuning_job_config.strategy #=> String, one of "Bayesian"
+    #   resp.hyper_parameter_tuning_job_config.hyper_parameter_tuning_job_objective.type #=> String, one of "Maximize", "Minimize"
+    #   resp.hyper_parameter_tuning_job_config.hyper_parameter_tuning_job_objective.metric_name #=> String
+    #   resp.hyper_parameter_tuning_job_config.resource_limits.max_number_of_training_jobs #=> Integer
+    #   resp.hyper_parameter_tuning_job_config.resource_limits.max_parallel_training_jobs #=> Integer
+    #   resp.hyper_parameter_tuning_job_config.parameter_ranges.integer_parameter_ranges #=> Array
+    #   resp.hyper_parameter_tuning_job_config.parameter_ranges.integer_parameter_ranges[0].name #=> String
+    #   resp.hyper_parameter_tuning_job_config.parameter_ranges.integer_parameter_ranges[0].min_value #=> String
+    #   resp.hyper_parameter_tuning_job_config.parameter_ranges.integer_parameter_ranges[0].max_value #=> String
+    #   resp.hyper_parameter_tuning_job_config.parameter_ranges.continuous_parameter_ranges #=> Array
+    #   resp.hyper_parameter_tuning_job_config.parameter_ranges.continuous_parameter_ranges[0].name #=> String
+    #   resp.hyper_parameter_tuning_job_config.parameter_ranges.continuous_parameter_ranges[0].min_value #=> String
+    #   resp.hyper_parameter_tuning_job_config.parameter_ranges.continuous_parameter_ranges[0].max_value #=> String
+    #   resp.hyper_parameter_tuning_job_config.parameter_ranges.categorical_parameter_ranges #=> Array
+    #   resp.hyper_parameter_tuning_job_config.parameter_ranges.categorical_parameter_ranges[0].name #=> String
+    #   resp.hyper_parameter_tuning_job_config.parameter_ranges.categorical_parameter_ranges[0].values #=> Array
+    #   resp.hyper_parameter_tuning_job_config.parameter_ranges.categorical_parameter_ranges[0].values[0] #=> String
+    #   resp.training_job_definition.static_hyper_parameters #=> Hash
+    #   resp.training_job_definition.static_hyper_parameters["ParameterKey"] #=> String
+    #   resp.training_job_definition.algorithm_specification.training_image #=> String
+    #   resp.training_job_definition.algorithm_specification.training_input_mode #=> String, one of "Pipe", "File"
+    #   resp.training_job_definition.algorithm_specification.metric_definitions #=> Array
+    #   resp.training_job_definition.algorithm_specification.metric_definitions[0].name #=> String
+    #   resp.training_job_definition.algorithm_specification.metric_definitions[0].regex #=> String
+    #   resp.training_job_definition.role_arn #=> String
+    #   resp.training_job_definition.input_data_config #=> Array
+    #   resp.training_job_definition.input_data_config[0].channel_name #=> String
+    #   resp.training_job_definition.input_data_config[0].data_source.s3_data_source.s3_data_type #=> String, one of "ManifestFile", "S3Prefix"
+    #   resp.training_job_definition.input_data_config[0].data_source.s3_data_source.s3_uri #=> String
+    #   resp.training_job_definition.input_data_config[0].data_source.s3_data_source.s3_data_distribution_type #=> String, one of "FullyReplicated", "ShardedByS3Key"
+    #   resp.training_job_definition.input_data_config[0].content_type #=> String
+    #   resp.training_job_definition.input_data_config[0].compression_type #=> String, one of "None", "Gzip"
+    #   resp.training_job_definition.input_data_config[0].record_wrapper_type #=> String, one of "None", "RecordIO"
+    #   resp.training_job_definition.vpc_config.security_group_ids #=> Array
+    #   resp.training_job_definition.vpc_config.security_group_ids[0] #=> String
+    #   resp.training_job_definition.vpc_config.subnets #=> Array
+    #   resp.training_job_definition.vpc_config.subnets[0] #=> String
+    #   resp.training_job_definition.output_data_config.kms_key_id #=> String
+    #   resp.training_job_definition.output_data_config.s3_output_path #=> String
+    #   resp.training_job_definition.resource_config.instance_type #=> String, one of "ml.m4.xlarge", "ml.m4.2xlarge", "ml.m4.4xlarge", "ml.m4.10xlarge", "ml.m4.16xlarge", "ml.m5.large", "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.p2.xlarge", "ml.p2.8xlarge", "ml.p2.16xlarge", "ml.p3.2xlarge", "ml.p3.8xlarge", "ml.p3.16xlarge", "ml.c5.xlarge", "ml.c5.2xlarge", "ml.c5.4xlarge", "ml.c5.9xlarge", "ml.c5.18xlarge"
+    #   resp.training_job_definition.resource_config.instance_count #=> Integer
+    #   resp.training_job_definition.resource_config.volume_size_in_gb #=> Integer
+    #   resp.training_job_definition.resource_config.volume_kms_key_id #=> String
+    #   resp.training_job_definition.stopping_condition.max_runtime_in_seconds #=> Integer
+    #   resp.hyper_parameter_tuning_job_status #=> String, one of "Completed", "InProgress", "Failed", "Stopped", "Stopping"
+    #   resp.creation_time #=> Time
+    #   resp.hyper_parameter_tuning_end_time #=> Time
+    #   resp.last_modified_time #=> Time
+    #   resp.training_job_status_counters.completed #=> Integer
+    #   resp.training_job_status_counters.in_progress #=> Integer
+    #   resp.training_job_status_counters.retryable_error #=> Integer
+    #   resp.training_job_status_counters.non_retryable_error #=> Integer
+    #   resp.training_job_status_counters.stopped #=> Integer
+    #   resp.objective_status_counters.succeeded #=> Integer
+    #   resp.objective_status_counters.pending #=> Integer
+    #   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.creation_time #=> Time
+    #   resp.best_training_job.training_start_time #=> Time
+    #   resp.best_training_job.training_end_time #=> Time
+    #   resp.best_training_job.training_job_status #=> String, one of "InProgress", "Completed", "Failed", "Stopping", "Stopped"
+    #   resp.best_training_job.tuned_hyper_parameters #=> Hash
+    #   resp.best_training_job.tuned_hyper_parameters["ParameterKey"] #=> String
+    #   resp.best_training_job.failure_reason #=> String
+    #   resp.best_training_job.final_hyper_parameter_tuning_job_objective_metric.type #=> String, one of "Maximize", "Minimize"
+    #   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.failure_reason #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/DescribeHyperParameterTuningJob AWS API Documentation
+    #
+    # @overload describe_hyper_parameter_tuning_job(params = {})
+    # @param [Hash] params ({})
+    def describe_hyper_parameter_tuning_job(params = {}, options = {})
+      req = build_request(:describe_hyper_parameter_tuning_job, params)
+      req.send_request(options)
+    end
+
     # Describes a model that you created using the `CreateModel` API.
     #
     # @option params [required, String] :model_name
@@ -1330,6 +1594,7 @@ module Aws::SageMaker
     #
     #   * {Types::DescribeTrainingJobResponse#training_job_name #training_job_name} => String
     #   * {Types::DescribeTrainingJobResponse#training_job_arn #training_job_arn} => String
+    #   * {Types::DescribeTrainingJobResponse#tuning_job_arn #tuning_job_arn} => String
     #   * {Types::DescribeTrainingJobResponse#model_artifacts #model_artifacts} => Types::ModelArtifacts
     #   * {Types::DescribeTrainingJobResponse#training_job_status #training_job_status} => String
     #   * {Types::DescribeTrainingJobResponse#secondary_status #secondary_status} => String
@@ -1357,6 +1622,7 @@ module Aws::SageMaker
     #
     #   resp.training_job_name #=> String
     #   resp.training_job_arn #=> String
+    #   resp.tuning_job_arn #=> String
     #   resp.model_artifacts.s3_model_artifacts #=> String
     #   resp.training_job_status #=> String, one of "InProgress", "Completed", "Failed", "Stopping", "Stopped"
     #   resp.secondary_status #=> String, one of "Starting", "Downloading", "Training", "Uploading", "Stopping", "Stopped", "MaxRuntimeExceeded", "Completed", "Failed"
@@ -1539,6 +1805,97 @@ module Aws::SageMaker
       req.send_request(options)
     end
 
+    # Gets a list of objects that describe the hyperparameter tuning jobs
+    # launched in your account.
+    #
+    # @option params [String] :next_token
+    #   If the result of the previous `ListHyperParameterTuningJobs` request
+    #   was truncated, the response includes a `NextToken`. To retrieve the
+    #   next set of tuning jobs, use the token in the next request.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of tuning jobs to return.
+    #
+    # @option params [String] :sort_by
+    #   The field to sort results by. The default is `Name`.
+    #
+    # @option params [String] :sort_order
+    #   The sort order for results. The default is `Ascending`.
+    #
+    # @option params [String] :name_contains
+    #   A string in the tuning job name. This filter returns only tuning jobs
+    #   whose name contains the specified string.
+    #
+    # @option params [Time,DateTime,Date,Integer,String] :creation_time_after
+    #   A filter that returns only tuning jobs that were created after the
+    #   specified time.
+    #
+    # @option params [Time,DateTime,Date,Integer,String] :creation_time_before
+    #   A filter that returns only tuning jobs that were created before the
+    #   specified time.
+    #
+    # @option params [Time,DateTime,Date,Integer,String] :last_modified_time_after
+    #   A filter that returns only tuning jobs that were modified after the
+    #   specified time.
+    #
+    # @option params [Time,DateTime,Date,Integer,String] :last_modified_time_before
+    #   A filter that returns only tuning jobs that were modified before the
+    #   specified time.
+    #
+    # @option params [String] :status_equals
+    #   A filter that returns only tuning jobs with the specified status.
+    #
+    # @return [Types::ListHyperParameterTuningJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListHyperParameterTuningJobsResponse#hyper_parameter_tuning_job_summaries #hyper_parameter_tuning_job_summaries} => Array&lt;Types::HyperParameterTuningJobSummary&gt;
+    #   * {Types::ListHyperParameterTuningJobsResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_hyper_parameter_tuning_jobs({
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #     sort_by: "Name", # accepts Name, Status, CreationTime
+    #     sort_order: "Ascending", # accepts Ascending, Descending
+    #     name_contains: "NameContains",
+    #     creation_time_after: Time.now,
+    #     creation_time_before: Time.now,
+    #     last_modified_time_after: Time.now,
+    #     last_modified_time_before: Time.now,
+    #     status_equals: "Completed", # accepts Completed, InProgress, Failed, Stopped, Stopping
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.hyper_parameter_tuning_job_summaries #=> Array
+    #   resp.hyper_parameter_tuning_job_summaries[0].hyper_parameter_tuning_job_name #=> String
+    #   resp.hyper_parameter_tuning_job_summaries[0].hyper_parameter_tuning_job_arn #=> String
+    #   resp.hyper_parameter_tuning_job_summaries[0].hyper_parameter_tuning_job_status #=> String, one of "Completed", "InProgress", "Failed", "Stopped", "Stopping"
+    #   resp.hyper_parameter_tuning_job_summaries[0].strategy #=> String, one of "Bayesian"
+    #   resp.hyper_parameter_tuning_job_summaries[0].creation_time #=> Time
+    #   resp.hyper_parameter_tuning_job_summaries[0].hyper_parameter_tuning_end_time #=> Time
+    #   resp.hyper_parameter_tuning_job_summaries[0].last_modified_time #=> Time
+    #   resp.hyper_parameter_tuning_job_summaries[0].training_job_status_counters.completed #=> Integer
+    #   resp.hyper_parameter_tuning_job_summaries[0].training_job_status_counters.in_progress #=> Integer
+    #   resp.hyper_parameter_tuning_job_summaries[0].training_job_status_counters.retryable_error #=> Integer
+    #   resp.hyper_parameter_tuning_job_summaries[0].training_job_status_counters.non_retryable_error #=> Integer
+    #   resp.hyper_parameter_tuning_job_summaries[0].training_job_status_counters.stopped #=> Integer
+    #   resp.hyper_parameter_tuning_job_summaries[0].objective_status_counters.succeeded #=> Integer
+    #   resp.hyper_parameter_tuning_job_summaries[0].objective_status_counters.pending #=> Integer
+    #   resp.hyper_parameter_tuning_job_summaries[0].objective_status_counters.failed #=> Integer
+    #   resp.hyper_parameter_tuning_job_summaries[0].resource_limits.max_number_of_training_jobs #=> Integer
+    #   resp.hyper_parameter_tuning_job_summaries[0].resource_limits.max_parallel_training_jobs #=> Integer
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/ListHyperParameterTuningJobs AWS API Documentation
+    #
+    # @overload list_hyper_parameter_tuning_jobs(params = {})
+    # @param [Hash] params ({})
+    def list_hyper_parameter_tuning_jobs(params = {}, options = {})
+      req = build_request(:list_hyper_parameter_tuning_jobs, params)
+      req.send_request(options)
+    end
+
     # Lists models created with the [CreateModel][1] API.
     #
     #
@@ -1846,8 +2203,8 @@ module Aws::SageMaker
     #   time (timestamp).
     #
     # @option params [String] :name_contains
-    #   A string in the training job name. This filter returns only models
-    #   whose name contains the specified string.
+    #   A string in the training job name. This filter returns only training
+    #   jobs whose name contains the specified string.
     #
     # @option params [String] :status_equals
     #   A filter that retrieves only training jobs with a specific status.
@@ -1898,6 +2255,73 @@ module Aws::SageMaker
       req.send_request(options)
     end
 
+    # Gets a list of objects that describe the training jobs that a
+    # hyperparameter tuning job launched.
+    #
+    # @option params [required, String] :hyper_parameter_tuning_job_name
+    #   The name of the tuning job whose training jobs you want to list.
+    #
+    # @option params [String] :next_token
+    #   If the result of the previous
+    #   `ListTrainingJobsForHyperParameterTuningJob` request was truncated,
+    #   the response includes a `NextToken`. To retrieve the next set of
+    #   training jobs, use the token in the next request.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of training jobs to return.
+    #
+    # @option params [String] :status_equals
+    #   A filter that returns only training jobs with the specified status.
+    #
+    # @option params [String] :sort_by
+    #   The field to sort results by. The default is `Name`.
+    #
+    # @option params [String] :sort_order
+    #   The sort order for results. The default is `Ascending`.
+    #
+    # @return [Types::ListTrainingJobsForHyperParameterTuningJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListTrainingJobsForHyperParameterTuningJobResponse#training_job_summaries #training_job_summaries} => Array&lt;Types::HyperParameterTrainingJobSummary&gt;
+    #   * {Types::ListTrainingJobsForHyperParameterTuningJobResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_training_jobs_for_hyper_parameter_tuning_job({
+    #     hyper_parameter_tuning_job_name: "HyperParameterTuningJobName", # required
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #     status_equals: "InProgress", # accepts InProgress, Completed, Failed, Stopping, Stopped
+    #     sort_by: "Name", # accepts Name, CreationTime, Status, FinalObjectiveMetricValue
+    #     sort_order: "Ascending", # accepts Ascending, Descending
+    #   })
+    #
+    # @example Response structure
+    #
+    #   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].creation_time #=> Time
+    #   resp.training_job_summaries[0].training_start_time #=> Time
+    #   resp.training_job_summaries[0].training_end_time #=> Time
+    #   resp.training_job_summaries[0].training_job_status #=> String, one of "InProgress", "Completed", "Failed", "Stopping", "Stopped"
+    #   resp.training_job_summaries[0].tuned_hyper_parameters #=> Hash
+    #   resp.training_job_summaries[0].tuned_hyper_parameters["ParameterKey"] #=> String
+    #   resp.training_job_summaries[0].failure_reason #=> String
+    #   resp.training_job_summaries[0].final_hyper_parameter_tuning_job_objective_metric.type #=> String, one of "Maximize", "Minimize"
+    #   resp.training_job_summaries[0].final_hyper_parameter_tuning_job_objective_metric.metric_name #=> String
+    #   resp.training_job_summaries[0].final_hyper_parameter_tuning_job_objective_metric.value #=> Float
+    #   resp.training_job_summaries[0].objective_status #=> String, one of "Succeeded", "Pending", "Failed"
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/ListTrainingJobsForHyperParameterTuningJob AWS API Documentation
+    #
+    # @overload list_training_jobs_for_hyper_parameter_tuning_job(params = {})
+    # @param [Hash] params ({})
+    def list_training_jobs_for_hyper_parameter_tuning_job(params = {}, options = {})
+      req = build_request(:list_training_jobs_for_hyper_parameter_tuning_job, params)
+      req.send_request(options)
+    end
+
     # Launches an ML compute instance with the latest version of the
     # libraries and attaches your ML storage volume. After configuring the
     # notebook instance, Amazon SageMaker sets the notebook instance status
@@ -1924,6 +2348,35 @@ module Aws::SageMaker
       req.send_request(options)
     end
 
+    # Stops a running hyperparameter tuning job and all running training
+    # jobs that the tuning job launched.
+    #
+    # All model artifacts output from the training jobs are stored in Amazon
+    # Simple Storage Service (Amazon S3). All data that the training jobs
+    # write toAmazon CloudWatch Logs are still available in CloudWatch.
+    # After the tuning job moves to the `Stopped` state, it releases all
+    # reserved resources for the tuning job.
+    #
+    # @option params [required, String] :hyper_parameter_tuning_job_name
+    #   The name of the tuning job to stop.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.stop_hyper_parameter_tuning_job({
+    #     hyper_parameter_tuning_job_name: "HyperParameterTuningJobName", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/StopHyperParameterTuningJob AWS API Documentation
+    #
+    # @overload stop_hyper_parameter_tuning_job(params = {})
+    # @param [Hash] params ({})
+    def stop_hyper_parameter_tuning_job(params = {}, options = {})
+      req = build_request(:stop_hyper_parameter_tuning_job, params)
+      req.send_request(options)
+    end
+
     # Terminates the ML compute instance. Before terminating the instance,
     # Amazon SageMaker disconnects the ML storage volume from it. Amazon
     # SageMaker preserves the ML storage volume.
@@ -2091,8 +2544,18 @@ module Aws::SageMaker
     #   The Amazon ML compute instance type.
     #
     # @option params [String] :role_arn
-    #   Amazon Resource Name (ARN) of the IAM role to associate with the
-    #   instance.
+    #   The Amazon Resource Name (ARN) of the IAM role that Amazon SageMaker
+    #   can assume to access the notebook instance. For more information, see
+    #   [Amazon SageMaker Roles][1].
+    #
+    #   <note markdown="1"> To be able to pass this role to Amazon SageMaker, the caller of this
+    #   API must have the `iam:PassRole` permission.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-roles.html
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -2167,7 +2630,7 @@ module Aws::SageMaker
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-sagemaker'
-      context[:gem_version] = '1.8.0'
+      context[:gem_version] = '1.9.0'
       Seahorse::Client::Request.new(handlers, context)
     end