aws-sdk-sagemaker 1.101.0 → 1.102.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d68b52ff175bb17ce59d762c185ebf1cb0822e98565b10c6e5ca31108f8d0013
-  data.tar.gz: 3576fd7d2bed584f296999fc57fdd3ec50c7fe0eb4fb44d915a4390ba435eed2
+  metadata.gz: 6b9b7691675ddc58bc162b9dad9acc3fd9a159acd50424880279fe258d0d5a8d
+  data.tar.gz: 61b8af61d77012aeb0f1a12f7b626f18f7d4cf7f18a20ca8beaef6298b8bb3ea
 SHA512:
-  metadata.gz: b09b3641a5b879d3fe3f0ae125d4ba2e4b08c0668059abc1d922befb77aab8983f43b3e78fa01b03f63e4d42e39afec8eecda3756114205fdd54344de4457bac
-  data.tar.gz: 05f8404813b263b36bef2d076b25447acad0ba614130fbab237c45b479dec550e146e1f1e3f1ba84b73611852bd2cbfffac83c7bfef75c92fb4c04cefdedbcc3
+  metadata.gz: 5a0a3ddea0cda2b13cf49aa42aece24d0210c9321aa92a78b4a4baaa2db57514740ae7688298b374755a6fcbe4ed2cbf60ae7c820b52432f815c221a7005288c
+  data.tar.gz: a760abc7e2450c9fc1db83e4e24551b14fb9e2238b7a9ff06ca9a07199df77b50e5e3734ffd701de33c25d5eb8e66247dfd2dd93e63210eb0c5150691d490353

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.102.0 (2021-10-06)
+------------------
+
+* Feature - This release adds a new TrainingInputMode FastFile for SageMaker Training APIs.
+
 1.101.0 (2021-09-16)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.101.0
+1.102.0

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

@@ -709,7 +709,7 @@ module Aws::SageMaker
     #           is_required: false,
     #           supported_content_types: ["ContentType"], # required
     #           supported_compression_types: ["None"], # accepts None, Gzip
-    #           supported_input_modes: ["Pipe"], # required, accepts Pipe, File
+    #           supported_input_modes: ["Pipe"], # required, accepts Pipe, File, FastFile
     #         },
     #       ],
     #       supported_tuning_job_objective_metrics: [
@@ -743,7 +743,7 @@ module Aws::SageMaker
     #         {
     #           profile_name: "EntityName", # required
     #           training_job_definition: { # required
-    #             training_input_mode: "Pipe", # required, accepts Pipe, File
+    #             training_input_mode: "Pipe", # required, accepts Pipe, File, FastFile
     #             hyper_parameters: {
     #               "HyperParameterKey" => "HyperParameterValue",
     #             },
@@ -767,7 +767,7 @@ module Aws::SageMaker
     #                 content_type: "ContentType",
     #                 compression_type: "None", # accepts None, Gzip
     #                 record_wrapper_type: "None", # accepts None, RecordIO
-    #                 input_mode: "Pipe", # accepts Pipe, File
+    #                 input_mode: "Pipe", # accepts Pipe, File, FastFile
     #                 shuffle_config: {
     #                   seed: 1, # required
     #                 },
@@ -1964,7 +1964,7 @@ module Aws::SageMaker
     # and CreateEndpointConfig API operations, add the following policies to
     # the role.
     #
-    #  * Option 1: For a full Amazon SageMaker access, search and attach the
+    #  * Option 1: For a full SageMaker access, search and attach the
     #   `AmazonSageMakerFullAccess` policy.
     #
     # * Option 2: For granting a limited access to an IAM role, paste the
@@ -1982,8 +1982,8 @@ module Aws::SageMaker
     #
     #   `]`
     #
-    #   For more information, see [Amazon SageMaker API Permissions:
-    #   Actions, Permissions, and Resources Reference][5].
+    #   For more information, see [SageMaker API Permissions: Actions,
+    #   Permissions, and Resources Reference][5].
     #
     #  </note>
     #
@@ -2401,13 +2401,20 @@ module Aws::SageMaker
     #     `OfflineStore`.
     #
     #   * A configuration for an Amazon Web Services Glue or Amazon Web
-    #     Services Hive data cataolgue.
+    #     Services Hive data catalog.
     #
     #   * An KMS encryption key to encrypt the Amazon S3 location used for
-    #     `OfflineStore`.
+    #     `OfflineStore`. If KMS encryption key is not specified, by default
+    #     we encrypt all data at rest using Amazon Web Services KMS key. By
+    #     defining your [bucket-level key][1] for SSE, you can reduce Amazon
+    #     Web Services KMS requests costs by up to 99 percent.
     #
     #   To learn more about this parameter, see OfflineStoreConfig.
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-key.html
+    #
     # @option params [String] :role_arn
     #   The Amazon Resource Name (ARN) of the IAM execution role used to
     #   persist data into the `OfflineStore` if an `OfflineStoreConfig` is
@@ -2767,7 +2774,7 @@ module Aws::SageMaker
     #       },
     #       algorithm_specification: { # required
     #         training_image: "AlgorithmImage",
-    #         training_input_mode: "Pipe", # required, accepts Pipe, File
+    #         training_input_mode: "Pipe", # required, accepts Pipe, File, FastFile
     #         algorithm_name: "ArnOrName",
     #         metric_definitions: [
     #           {
@@ -2797,7 +2804,7 @@ module Aws::SageMaker
     #           content_type: "ContentType",
     #           compression_type: "None", # accepts None, Gzip
     #           record_wrapper_type: "None", # accepts None, RecordIO
-    #           input_mode: "Pipe", # accepts Pipe, File
+    #           input_mode: "Pipe", # accepts Pipe, File, FastFile
     #           shuffle_config: {
     #             seed: 1, # required
     #           },
@@ -2868,7 +2875,7 @@ module Aws::SageMaker
     #         },
     #         algorithm_specification: { # required
     #           training_image: "AlgorithmImage",
-    #           training_input_mode: "Pipe", # required, accepts Pipe, File
+    #           training_input_mode: "Pipe", # required, accepts Pipe, File, FastFile
     #           algorithm_name: "ArnOrName",
     #           metric_definitions: [
     #             {
@@ -2898,7 +2905,7 @@ module Aws::SageMaker
     #             content_type: "ContentType",
     #             compression_type: "None", # accepts None, Gzip
     #             record_wrapper_type: "None", # accepts None, RecordIO
-    #             input_mode: "Pipe", # accepts Pipe, File
+    #             input_mode: "Pipe", # accepts Pipe, File, FastFile
     #             shuffle_config: {
     #               seed: 1, # required
     #             },
@@ -5417,7 +5424,7 @@ module Aws::SageMaker
     #     algorithm_specification: { # required
     #       training_image: "AlgorithmImage",
     #       algorithm_name: "ArnOrName",
-    #       training_input_mode: "Pipe", # required, accepts Pipe, File
+    #       training_input_mode: "Pipe", # required, accepts Pipe, File, FastFile
     #       metric_definitions: [
     #         {
     #           name: "MetricName", # required
@@ -5447,7 +5454,7 @@ module Aws::SageMaker
     #         content_type: "ContentType",
     #         compression_type: "None", # accepts None, Gzip
     #         record_wrapper_type: "None", # accepts None, RecordIO
-    #         input_mode: "Pipe", # accepts Pipe, File
+    #         input_mode: "Pipe", # accepts Pipe, File, FastFile
     #         shuffle_config: {
     #           seed: 1, # required
     #         },
@@ -7479,7 +7486,7 @@ module Aws::SageMaker
     #   resp.training_specification.training_channels[0].supported_compression_types #=> Array
     #   resp.training_specification.training_channels[0].supported_compression_types[0] #=> String, one of "None", "Gzip"
     #   resp.training_specification.training_channels[0].supported_input_modes #=> Array
-    #   resp.training_specification.training_channels[0].supported_input_modes[0] #=> String, one of "Pipe", "File"
+    #   resp.training_specification.training_channels[0].supported_input_modes[0] #=> String, one of "Pipe", "File", "FastFile"
     #   resp.training_specification.supported_tuning_job_objective_metrics #=> Array
     #   resp.training_specification.supported_tuning_job_objective_metrics[0].type #=> String, one of "Maximize", "Minimize"
     #   resp.training_specification.supported_tuning_job_objective_metrics[0].metric_name #=> String
@@ -7502,7 +7509,7 @@ module Aws::SageMaker
     #   resp.validation_specification.validation_role #=> String
     #   resp.validation_specification.validation_profiles #=> Array
     #   resp.validation_specification.validation_profiles[0].profile_name #=> String
-    #   resp.validation_specification.validation_profiles[0].training_job_definition.training_input_mode #=> String, one of "Pipe", "File"
+    #   resp.validation_specification.validation_profiles[0].training_job_definition.training_input_mode #=> String, one of "Pipe", "File", "FastFile"
     #   resp.validation_specification.validation_profiles[0].training_job_definition.hyper_parameters #=> Hash
     #   resp.validation_specification.validation_profiles[0].training_job_definition.hyper_parameters["HyperParameterKey"] #=> String
     #   resp.validation_specification.validation_profiles[0].training_job_definition.input_data_config #=> Array
@@ -7519,7 +7526,7 @@ module Aws::SageMaker
     #   resp.validation_specification.validation_profiles[0].training_job_definition.input_data_config[0].content_type #=> String
     #   resp.validation_specification.validation_profiles[0].training_job_definition.input_data_config[0].compression_type #=> String, one of "None", "Gzip"
     #   resp.validation_specification.validation_profiles[0].training_job_definition.input_data_config[0].record_wrapper_type #=> String, one of "None", "RecordIO"
-    #   resp.validation_specification.validation_profiles[0].training_job_definition.input_data_config[0].input_mode #=> String, one of "Pipe", "File"
+    #   resp.validation_specification.validation_profiles[0].training_job_definition.input_data_config[0].input_mode #=> String, one of "Pipe", "File", "FastFile"
     #   resp.validation_specification.validation_profiles[0].training_job_definition.input_data_config[0].shuffle_config.seed #=> Integer
     #   resp.validation_specification.validation_profiles[0].training_job_definition.output_data_config.kms_key_id #=> String
     #   resp.validation_specification.validation_profiles[0].training_job_definition.output_data_config.s3_output_path #=> String
@@ -8766,7 +8773,7 @@ module Aws::SageMaker
     #   resp.training_job_definition.static_hyper_parameters #=> Hash
     #   resp.training_job_definition.static_hyper_parameters["HyperParameterKey"] #=> 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.training_input_mode #=> String, one of "Pipe", "File", "FastFile"
     #   resp.training_job_definition.algorithm_specification.algorithm_name #=> String
     #   resp.training_job_definition.algorithm_specification.metric_definitions #=> Array
     #   resp.training_job_definition.algorithm_specification.metric_definitions[0].name #=> String
@@ -8786,7 +8793,7 @@ module Aws::SageMaker
     #   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.input_data_config[0].input_mode #=> String, one of "Pipe", "File"
+    #   resp.training_job_definition.input_data_config[0].input_mode #=> String, one of "Pipe", "File", "FastFile"
     #   resp.training_job_definition.input_data_config[0].shuffle_config.seed #=> Integer
     #   resp.training_job_definition.vpc_config.security_group_ids #=> Array
     #   resp.training_job_definition.vpc_config.security_group_ids[0] #=> String
@@ -8827,7 +8834,7 @@ module Aws::SageMaker
     #   resp.training_job_definitions[0].static_hyper_parameters #=> Hash
     #   resp.training_job_definitions[0].static_hyper_parameters["HyperParameterKey"] #=> String
     #   resp.training_job_definitions[0].algorithm_specification.training_image #=> String
-    #   resp.training_job_definitions[0].algorithm_specification.training_input_mode #=> String, one of "Pipe", "File"
+    #   resp.training_job_definitions[0].algorithm_specification.training_input_mode #=> String, one of "Pipe", "File", "FastFile"
     #   resp.training_job_definitions[0].algorithm_specification.algorithm_name #=> String
     #   resp.training_job_definitions[0].algorithm_specification.metric_definitions #=> Array
     #   resp.training_job_definitions[0].algorithm_specification.metric_definitions[0].name #=> String
@@ -8847,7 +8854,7 @@ module Aws::SageMaker
     #   resp.training_job_definitions[0].input_data_config[0].content_type #=> String
     #   resp.training_job_definitions[0].input_data_config[0].compression_type #=> String, one of "None", "Gzip"
     #   resp.training_job_definitions[0].input_data_config[0].record_wrapper_type #=> String, one of "None", "RecordIO"
-    #   resp.training_job_definitions[0].input_data_config[0].input_mode #=> String, one of "Pipe", "File"
+    #   resp.training_job_definitions[0].input_data_config[0].input_mode #=> String, one of "Pipe", "File", "FastFile"
     #   resp.training_job_definitions[0].input_data_config[0].shuffle_config.seed #=> Integer
     #   resp.training_job_definitions[0].vpc_config.security_group_ids #=> Array
     #   resp.training_job_definitions[0].vpc_config.security_group_ids[0] #=> String
@@ -10282,7 +10289,7 @@ module Aws::SageMaker
     #   resp.hyper_parameters["HyperParameterKey"] #=> String
     #   resp.algorithm_specification.training_image #=> String
     #   resp.algorithm_specification.algorithm_name #=> String
-    #   resp.algorithm_specification.training_input_mode #=> String, one of "Pipe", "File"
+    #   resp.algorithm_specification.training_input_mode #=> String, one of "Pipe", "File", "FastFile"
     #   resp.algorithm_specification.metric_definitions #=> Array
     #   resp.algorithm_specification.metric_definitions[0].name #=> String
     #   resp.algorithm_specification.metric_definitions[0].regex #=> String
@@ -10302,7 +10309,7 @@ module Aws::SageMaker
     #   resp.input_data_config[0].content_type #=> String
     #   resp.input_data_config[0].compression_type #=> String, one of "None", "Gzip"
     #   resp.input_data_config[0].record_wrapper_type #=> String, one of "None", "RecordIO"
-    #   resp.input_data_config[0].input_mode #=> String, one of "Pipe", "File"
+    #   resp.input_data_config[0].input_mode #=> String, one of "Pipe", "File", "FastFile"
     #   resp.input_data_config[0].shuffle_config.seed #=> Integer
     #   resp.output_data_config.kms_key_id #=> String
     #   resp.output_data_config.s3_output_path #=> String
@@ -15345,7 +15352,7 @@ module Aws::SageMaker
     #   resp.results[0].training_job.hyper_parameters["HyperParameterKey"] #=> String
     #   resp.results[0].training_job.algorithm_specification.training_image #=> String
     #   resp.results[0].training_job.algorithm_specification.algorithm_name #=> String
-    #   resp.results[0].training_job.algorithm_specification.training_input_mode #=> String, one of "Pipe", "File"
+    #   resp.results[0].training_job.algorithm_specification.training_input_mode #=> String, one of "Pipe", "File", "FastFile"
     #   resp.results[0].training_job.algorithm_specification.metric_definitions #=> Array
     #   resp.results[0].training_job.algorithm_specification.metric_definitions[0].name #=> String
     #   resp.results[0].training_job.algorithm_specification.metric_definitions[0].regex #=> String
@@ -15365,7 +15372,7 @@ module Aws::SageMaker
     #   resp.results[0].training_job.input_data_config[0].content_type #=> String
     #   resp.results[0].training_job.input_data_config[0].compression_type #=> String, one of "None", "Gzip"
     #   resp.results[0].training_job.input_data_config[0].record_wrapper_type #=> String, one of "None", "RecordIO"
-    #   resp.results[0].training_job.input_data_config[0].input_mode #=> String, one of "Pipe", "File"
+    #   resp.results[0].training_job.input_data_config[0].input_mode #=> String, one of "Pipe", "File", "FastFile"
     #   resp.results[0].training_job.input_data_config[0].shuffle_config.seed #=> Integer
     #   resp.results[0].training_job.output_data_config.kms_key_id #=> String
     #   resp.results[0].training_job.output_data_config.s3_output_path #=> String
@@ -15534,7 +15541,7 @@ module Aws::SageMaker
     #   resp.results[0].trial_component.source_detail.training_job.hyper_parameters["HyperParameterKey"] #=> String
     #   resp.results[0].trial_component.source_detail.training_job.algorithm_specification.training_image #=> String
     #   resp.results[0].trial_component.source_detail.training_job.algorithm_specification.algorithm_name #=> String
-    #   resp.results[0].trial_component.source_detail.training_job.algorithm_specification.training_input_mode #=> String, one of "Pipe", "File"
+    #   resp.results[0].trial_component.source_detail.training_job.algorithm_specification.training_input_mode #=> String, one of "Pipe", "File", "FastFile"
     #   resp.results[0].trial_component.source_detail.training_job.algorithm_specification.metric_definitions #=> Array
     #   resp.results[0].trial_component.source_detail.training_job.algorithm_specification.metric_definitions[0].name #=> String
     #   resp.results[0].trial_component.source_detail.training_job.algorithm_specification.metric_definitions[0].regex #=> String
@@ -15554,7 +15561,7 @@ module Aws::SageMaker
     #   resp.results[0].trial_component.source_detail.training_job.input_data_config[0].content_type #=> String
     #   resp.results[0].trial_component.source_detail.training_job.input_data_config[0].compression_type #=> String, one of "None", "Gzip"
     #   resp.results[0].trial_component.source_detail.training_job.input_data_config[0].record_wrapper_type #=> String, one of "None", "RecordIO"
-    #   resp.results[0].trial_component.source_detail.training_job.input_data_config[0].input_mode #=> String, one of "Pipe", "File"
+    #   resp.results[0].trial_component.source_detail.training_job.input_data_config[0].input_mode #=> String, one of "Pipe", "File", "FastFile"
     #   resp.results[0].trial_component.source_detail.training_job.input_data_config[0].shuffle_config.seed #=> Integer
     #   resp.results[0].trial_component.source_detail.training_job.output_data_config.kms_key_id #=> String
     #   resp.results[0].trial_component.source_detail.training_job.output_data_config.s3_output_path #=> String
@@ -18032,7 +18039,7 @@ module Aws::SageMaker
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-sagemaker'
-      context[:gem_version] = '1.101.0'
+      context[:gem_version] = '1.102.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -260,7 +260,7 @@ module Aws::SageMaker
     #       {
     #         training_image: "AlgorithmImage",
     #         algorithm_name: "ArnOrName",
-    #         training_input_mode: "Pipe", # required, accepts Pipe, File
+    #         training_input_mode: "Pipe", # required, accepts Pipe, File, FastFile
     #         metric_definitions: [
     #           {
     #             name: "MetricName", # required
@@ -293,27 +293,45 @@ module Aws::SageMaker
     #   @return [String]
     #
     # @!attribute [rw] training_input_mode
-    #   The input mode that the algorithm supports. For the input modes that
-    #   Amazon SageMaker algorithms support, see [Algorithms][1]. If an
-    #   algorithm supports the `File` input mode, Amazon SageMaker downloads
-    #   the training data from S3 to the provisioned ML storage Volume, and
-    #   mounts the directory to docker volume for training container. If an
-    #   algorithm supports the `Pipe` input mode, Amazon SageMaker streams
-    #   data directly from S3 to the container.
-    #
-    #   In File mode, make sure you provision ML storage volume with
-    #   sufficient capacity to accommodate the data download from S3. In
-    #   addition to the training data, the ML storage volume also stores the
-    #   output model. The algorithm container use ML storage volume to also
-    #   store intermediate information, if any.
-    #
-    #   For distributed algorithms using File mode, training data is
-    #   distributed uniformly, and your training duration is predictable if
-    #   the input data objects size is approximately same. Amazon SageMaker
-    #   does not split the files any further for model training. If the
-    #   object sizes are skewed, training won't be optimal as the data
-    #   distribution is also skewed where one host in a training cluster is
-    #   overloaded, thus becoming bottleneck in training.
+    #   The training input mode that the algorithm supports. For more
+    #   information about input modes, see [Algorithms][1].
+    #
+    #   **Pipe mode**
+    #
+    #   If an algorithm supports `Pipe` mode, Amazon SageMaker streams data
+    #   directly from Amazon S3 to the container.
+    #
+    #   **File mode**
+    #
+    #   If an algorithm supports `File` mode, SageMaker downloads the
+    #   training data from S3 to the provisioned ML storage volume, and
+    #   mounts the directory to the Docker volume for the training
+    #   container.
+    #
+    #   You must provision the ML storage volume with sufficient capacity to
+    #   accommodate the data downloaded from S3. In addition to the training
+    #   data, the ML storage volume also stores the output model. The
+    #   algorithm container uses the ML storage volume to also store
+    #   intermediate information, if any.
+    #
+    #   For distributed algorithms, training data is distributed uniformly.
+    #   Your training duration is predictable if the input data objects
+    #   sizes are approximately the same. SageMaker does not split the files
+    #   any further for model training. If the object sizes are skewed,
+    #   training won't be optimal as the data distribution is also skewed
+    #   when one host in a training cluster is overloaded, thus becoming a
+    #   bottleneck in training.
+    #
+    #   **FastFile mode**
+    #
+    #   If an algorithm supports `FastFile` mode, SageMaker streams data
+    #   directly from S3 to the container with no code changes, and provides
+    #   file system access to the data. Users can author their training
+    #   script to interact with these files as if they were stored on disk.
+    #
+    #   `FastFile` mode works best when the data is read sequentially.
+    #   Augmented manifest files aren't supported. The startup time is
+    #   lower when there are fewer files in the S3 bucket provided.
     #
     #
     #
@@ -451,7 +469,7 @@ module Aws::SageMaker
     #       {
     #         profile_name: "EntityName", # required
     #         training_job_definition: { # required
-    #           training_input_mode: "Pipe", # required, accepts Pipe, File
+    #           training_input_mode: "Pipe", # required, accepts Pipe, File, FastFile
     #           hyper_parameters: {
     #             "HyperParameterKey" => "HyperParameterValue",
     #           },
@@ -475,7 +493,7 @@ module Aws::SageMaker
     #               content_type: "ContentType",
     #               compression_type: "None", # accepts None, Gzip
     #               record_wrapper_type: "None", # accepts None, RecordIO
-    #               input_mode: "Pipe", # accepts Pipe, File
+    #               input_mode: "Pipe", # accepts Pipe, File, FastFile
     #               shuffle_config: {
     #                 seed: 1, # required
     #               },
@@ -565,7 +583,7 @@ module Aws::SageMaker
     #           {
     #             profile_name: "EntityName", # required
     #             training_job_definition: { # required
-    #               training_input_mode: "Pipe", # required, accepts Pipe, File
+    #               training_input_mode: "Pipe", # required, accepts Pipe, File, FastFile
     #               hyper_parameters: {
     #                 "HyperParameterKey" => "HyperParameterValue",
     #               },
@@ -589,7 +607,7 @@ module Aws::SageMaker
     #                   content_type: "ContentType",
     #                   compression_type: "None", # accepts None, Gzip
     #                   record_wrapper_type: "None", # accepts None, RecordIO
-    #                   input_mode: "Pipe", # accepts Pipe, File
+    #                   input_mode: "Pipe", # accepts Pipe, File, FastFile
     #                   shuffle_config: {
     #                     seed: 1, # required
     #                   },
@@ -2063,12 +2081,20 @@ module Aws::SageMaker
     #   @return [Integer]
     #
     # @!attribute [rw] max_runtime_per_training_job_in_seconds
-    #   The maximum time, in seconds, a training job is allowed to run as
-    #   part of an AutoML job.
+    #   The maximum time, in seconds, that each training job is allowed to
+    #   run as part of a hyperparameter tuning job. For more information,
+    #   see the used by the action.
     #   @return [Integer]
     #
     # @!attribute [rw] max_auto_ml_job_runtime_in_seconds
     #   The maximum runtime, in seconds, an AutoML job has to complete.
+    #
+    #   If an AutoML job exceeds the maximum runtime, the job is stopped
+    #   automatically and its processing is ended gracefully. The AutoML job
+    #   identifies the best model whose training was completed and marks it
+    #   as the best-performing model. Any unfinished steps of the job, such
+    #   as automatic one-click Autopilot model deployment, will not be
+    #   completed.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/AutoMLJobCompletionCriteria AWS API Documentation
@@ -2676,7 +2702,7 @@ module Aws::SageMaker
     #         content_type: "ContentType",
     #         compression_type: "None", # accepts None, Gzip
     #         record_wrapper_type: "None", # accepts None, RecordIO
-    #         input_mode: "Pipe", # accepts Pipe, File
+    #         input_mode: "Pipe", # accepts Pipe, File, FastFile
     #         shuffle_config: {
     #           seed: 1, # required
     #         },
@@ -2775,7 +2801,7 @@ module Aws::SageMaker
     #         is_required: false,
     #         supported_content_types: ["ContentType"], # required
     #         supported_compression_types: ["None"], # accepts None, Gzip
-    #         supported_input_modes: ["Pipe"], # required, accepts Pipe, File
+    #         supported_input_modes: ["Pipe"], # required, accepts Pipe, File, FastFile
     #       }
     #
     # @!attribute [rw] name
@@ -3549,7 +3575,7 @@ module Aws::SageMaker
     #               is_required: false,
     #               supported_content_types: ["ContentType"], # required
     #               supported_compression_types: ["None"], # accepts None, Gzip
-    #               supported_input_modes: ["Pipe"], # required, accepts Pipe, File
+    #               supported_input_modes: ["Pipe"], # required, accepts Pipe, File, FastFile
     #             },
     #           ],
     #           supported_tuning_job_objective_metrics: [
@@ -3583,7 +3609,7 @@ module Aws::SageMaker
     #             {
     #               profile_name: "EntityName", # required
     #               training_job_definition: { # required
-    #                 training_input_mode: "Pipe", # required, accepts Pipe, File
+    #                 training_input_mode: "Pipe", # required, accepts Pipe, File, FastFile
     #                 hyper_parameters: {
     #                   "HyperParameterKey" => "HyperParameterValue",
     #                 },
@@ -3607,7 +3633,7 @@ module Aws::SageMaker
     #                     content_type: "ContentType",
     #                     compression_type: "None", # accepts None, Gzip
     #                     record_wrapper_type: "None", # accepts None, RecordIO
-    #                     input_mode: "Pipe", # accepts Pipe, File
+    #                     input_mode: "Pipe", # accepts Pipe, File, FastFile
     #                     shuffle_config: {
     #                       seed: 1, # required
     #                     },
@@ -5255,12 +5281,19 @@ module Aws::SageMaker
     #     `OfflineStore`.
     #
     #   * A configuration for an Amazon Web Services Glue or Amazon Web
-    #     Services Hive data cataolgue.
+    #     Services Hive data catalog.
     #
     #   * An KMS encryption key to encrypt the Amazon S3 location used for
-    #     `OfflineStore`.
+    #     `OfflineStore`. If KMS encryption key is not specified, by default
+    #     we encrypt all data at rest using Amazon Web Services KMS key. By
+    #     defining your [bucket-level key][1] for SSE, you can reduce Amazon
+    #     Web Services KMS requests costs by up to 99 percent.
     #
     #   To learn more about this parameter, see OfflineStoreConfig.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-key.html
     #   @return [Types::OfflineStoreConfig]
     #
     # @!attribute [rw] role_arn
@@ -5544,7 +5577,7 @@ module Aws::SageMaker
     #           },
     #           algorithm_specification: { # required
     #             training_image: "AlgorithmImage",
-    #             training_input_mode: "Pipe", # required, accepts Pipe, File
+    #             training_input_mode: "Pipe", # required, accepts Pipe, File, FastFile
     #             algorithm_name: "ArnOrName",
     #             metric_definitions: [
     #               {
@@ -5574,7 +5607,7 @@ module Aws::SageMaker
     #               content_type: "ContentType",
     #               compression_type: "None", # accepts None, Gzip
     #               record_wrapper_type: "None", # accepts None, RecordIO
-    #               input_mode: "Pipe", # accepts Pipe, File
+    #               input_mode: "Pipe", # accepts Pipe, File, FastFile
     #               shuffle_config: {
     #                 seed: 1, # required
     #               },
@@ -5645,7 +5678,7 @@ module Aws::SageMaker
     #             },
     #             algorithm_specification: { # required
     #               training_image: "AlgorithmImage",
-    #               training_input_mode: "Pipe", # required, accepts Pipe, File
+    #               training_input_mode: "Pipe", # required, accepts Pipe, File, FastFile
     #               algorithm_name: "ArnOrName",
     #               metric_definitions: [
     #                 {
@@ -5675,7 +5708,7 @@ module Aws::SageMaker
     #                 content_type: "ContentType",
     #                 compression_type: "None", # accepts None, Gzip
     #                 record_wrapper_type: "None", # accepts None, RecordIO
-    #                 input_mode: "Pipe", # accepts Pipe, File
+    #                 input_mode: "Pipe", # accepts Pipe, File, FastFile
     #                 shuffle_config: {
     #                   seed: 1, # required
     #                 },
@@ -8048,7 +8081,7 @@ module Aws::SageMaker
     #         algorithm_specification: { # required
     #           training_image: "AlgorithmImage",
     #           algorithm_name: "ArnOrName",
-    #           training_input_mode: "Pipe", # required, accepts Pipe, File
+    #           training_input_mode: "Pipe", # required, accepts Pipe, File, FastFile
     #           metric_definitions: [
     #             {
     #               name: "MetricName", # required
@@ -8078,7 +8111,7 @@ module Aws::SageMaker
     #             content_type: "ContentType",
     #             compression_type: "None", # accepts None, Gzip
     #             record_wrapper_type: "None", # accepts None, RecordIO
-    #             input_mode: "Pipe", # accepts Pipe, File
+    #             input_mode: "Pipe", # accepts Pipe, File, FastFile
     #             shuffle_config: {
     #               seed: 1, # required
     #             },
@@ -9383,19 +9416,18 @@ module Aws::SageMaker
     #   specify `OutputFilter` as an additional filter to select a portion
     #   of the joined dataset and store it in the output file.
     #
-    #   For JSON or JSONLines objects, such as a JSON array, Amazon
-    #   SageMaker adds the transformed data to the input JSON object in an
-    #   attribute called `SageMakerOutput`. The joined result for JSON must
-    #   be a key-value pair object. If the input is not a key-value pair
-    #   object, Amazon SageMaker creates a new JSON file. In the new JSON
-    #   file, and the input data is stored under the `SageMakerInput` key
-    #   and the results are stored in `SageMakerOutput`.
+    #   For JSON or JSONLines objects, such as a JSON array, SageMaker adds
+    #   the transformed data to the input JSON object in an attribute called
+    #   `SageMakerOutput`. The joined result for JSON must be a key-value
+    #   pair object. If the input is not a key-value pair object, SageMaker
+    #   creates a new JSON file. In the new JSON file, and the input data is
+    #   stored under the `SageMakerInput` key and the results are stored in
+    #   `SageMakerOutput`.
     #
-    #   For CSV data, Amazon SageMaker takes each row as a JSON array and
-    #   joins the transformed data with the input by appending each
-    #   transformed row to the end of the input. The joined data has the
-    #   original input data followed by the transformed data and the output
-    #   is a CSV file.
+    #   For CSV data, SageMaker takes each row as a JSON array and joins the
+    #   transformed data with the input by appending each transformed row to
+    #   the end of the input. The joined data has the original input data
+    #   followed by the transformed data and the output is a CSV file.
     #
     #   For information on how joining in applied, see [Workflow for
     #   Associating Inferences with Input Records][1].
@@ -11173,6 +11205,9 @@ module Aws::SageMaker
     #
     # @!attribute [rw] last_user_activity_timestamp
     #   The timestamp of the last user's activity.
+    #   `LastUserActivityTimestamp` is also updated when SageMaker performs
+    #   health checks without user activity. As a result, this value is set
+    #   to the same value as `LastHealthCheckTimestamp`.
     #   @return [Time]
     #
     # @!attribute [rw] creation_time
@@ -14777,8 +14812,8 @@ module Aws::SageMaker
     #
     #   Multiply `BillableTimeInSeconds` by the number of instances
     #   (`InstanceCount`) in your training cluster to get the total compute
-    #   time Amazon SageMaker will bill you if you run distributed training.
-    #   The formula is as follows: `BillableTimeInSeconds * InstanceCount` .
+    #   time SageMaker will bill you if you run distributed training. The
+    #   formula is as follows: `BillableTimeInSeconds * InstanceCount` .
     #
     #   You can calculate the savings from using managed spot training using
     #   the formula `(1 - BillableTimeInSeconds / TrainingTimeInSeconds) *
@@ -16072,7 +16107,7 @@ module Aws::SageMaker
     #
     # @!attribute [rw] s3_input_mode
     #   Whether the `Pipe` or `File` is used as the input mode for
-    #   transfering data for the monitoring job. `Pipe` mode is recommended
+    #   transferring data for the monitoring job. `Pipe` mode is recommended
     #   for large datasets. `File` mode is useful for small files that fit
     #   in memory. Defaults to `File`.
     #   @return [String]
@@ -18383,7 +18418,7 @@ module Aws::SageMaker
     #
     #       {
     #         training_image: "AlgorithmImage",
-    #         training_input_mode: "Pipe", # required, accepts Pipe, File
+    #         training_input_mode: "Pipe", # required, accepts Pipe, File, FastFile
     #         algorithm_name: "ArnOrName",
     #         metric_definitions: [
     #           {
@@ -18409,21 +18444,45 @@ module Aws::SageMaker
     #   @return [String]
     #
     # @!attribute [rw] training_input_mode
-    #   The input mode that the algorithm supports: File or Pipe. In File
-    #   input mode, Amazon SageMaker downloads the training data from Amazon
-    #   S3 to the storage volume that is attached to the training instance
-    #   and mounts the directory to the Docker volume for the training
-    #   container. In Pipe input mode, Amazon SageMaker streams data
+    #   The training input mode that the algorithm supports. For more
+    #   information about input modes, see [Algorithms][1].
+    #
+    #   **Pipe mode**
+    #
+    #   If an algorithm supports `Pipe` mode, Amazon SageMaker streams data
     #   directly from Amazon S3 to the container.
     #
-    #   If you specify File mode, make sure that you provision the storage
-    #   volume that is attached to the training instance with enough
-    #   capacity to accommodate the training data downloaded from Amazon S3,
-    #   the model artifacts, and intermediate information.
+    #   **File mode**
+    #
+    #   If an algorithm supports `File` mode, SageMaker downloads the
+    #   training data from S3 to the provisioned ML storage volume, and
+    #   mounts the directory to the Docker volume for the training
+    #   container.
     #
+    #   You must provision the ML storage volume with sufficient capacity to
+    #   accommodate the data downloaded from S3. In addition to the training
+    #   data, the ML storage volume also stores the output model. The
+    #   algorithm container uses the ML storage volume to also store
+    #   intermediate information, if any.
     #
+    #   For distributed algorithms, training data is distributed uniformly.
+    #   Your training duration is predictable if the input data objects
+    #   sizes are approximately the same. SageMaker does not split the files
+    #   any further for model training. If the object sizes are skewed,
+    #   training won't be optimal as the data distribution is also skewed
+    #   when one host in a training cluster is overloaded, thus becoming a
+    #   bottleneck in training.
     #
-    #   For more information about input modes, see [Algorithms][1].
+    #   **FastFile mode**
+    #
+    #   If an algorithm supports `FastFile` mode, SageMaker streams data
+    #   directly from S3 to the container with no code changes, and provides
+    #   file system access to the data. Users can author their training
+    #   script to interact with these files as if they were stored on disk.
+    #
+    #   `FastFile` mode works best when the data is read sequentially.
+    #   Augmented manifest files aren't supported. The startup time is
+    #   lower when there are fewer files in the S3 bucket provided.
     #
     #
     #
@@ -18564,7 +18623,7 @@ module Aws::SageMaker
     #         },
     #         algorithm_specification: { # required
     #           training_image: "AlgorithmImage",
-    #           training_input_mode: "Pipe", # required, accepts Pipe, File
+    #           training_input_mode: "Pipe", # required, accepts Pipe, File, FastFile
     #           algorithm_name: "ArnOrName",
     #           metric_definitions: [
     #             {
@@ -18594,7 +18653,7 @@ module Aws::SageMaker
     #             content_type: "ContentType",
     #             compression_type: "None", # accepts None, Gzip
     #             record_wrapper_type: "None", # accepts None, RecordIO
-    #             input_mode: "Pipe", # accepts Pipe, File
+    #             input_mode: "Pipe", # accepts Pipe, File, FastFile
     #             shuffle_config: {
     #               seed: 1, # required
     #             },
@@ -32422,11 +32481,11 @@ module Aws::SageMaker
       include Aws::Structure
     end
 
-    # Specifies a limit to how long a model training job, model compilation
-    # job, or hyperparameter tuning job can run. It also specifies how long
-    # a managed Spot training job has to complete. When the job reaches the
-    # time limit, Amazon SageMaker ends the training or compilation job. Use
-    # this API to cap model training costs.
+    # Specifies a limit to how long a model training job or model
+    # compilation job can run. It also specifies how long a managed spot
+    # training job has to complete. When the job reaches the time limit,
+    # Amazon SageMaker ends the training or compilation job. Use this API to
+    # cap model training costs.
     #
     # To stop a training job, Amazon SageMaker sends the algorithm the
     # `SIGTERM` signal, which delays job termination for 120 seconds.
@@ -32588,12 +32647,12 @@ module Aws::SageMaker
     end
 
     # A tag object that consists of a key and an optional value, used to
-    # manage metadata for Amazon SageMaker Amazon Web Services resources.
+    # manage metadata for SageMaker Amazon Web Services resources.
     #
     # You can add tags to notebook instances, training jobs, hyperparameter
     # tuning jobs, batch transform jobs, models, labeling jobs, work teams,
     # endpoint configurations, and endpoints. For more information on adding
-    # tags to Amazon SageMaker resources, see AddTags.
+    # tags to SageMaker resources, see AddTags.
     #
     # For more information on adding metadata to your Amazon Web Services
     # resources with tagging, see [Tagging Amazon Web Services
@@ -33122,7 +33181,7 @@ module Aws::SageMaker
     #   data as a hash:
     #
     #       {
-    #         training_input_mode: "Pipe", # required, accepts Pipe, File
+    #         training_input_mode: "Pipe", # required, accepts Pipe, File, FastFile
     #         hyper_parameters: {
     #           "HyperParameterKey" => "HyperParameterValue",
     #         },
@@ -33146,7 +33205,7 @@ module Aws::SageMaker
     #             content_type: "ContentType",
     #             compression_type: "None", # accepts None, Gzip
     #             record_wrapper_type: "None", # accepts None, RecordIO
-    #             input_mode: "Pipe", # accepts Pipe, File
+    #             input_mode: "Pipe", # accepts Pipe, File, FastFile
     #             shuffle_config: {
     #               seed: 1, # required
     #             },
@@ -33169,15 +33228,45 @@ module Aws::SageMaker
     #       }
     #
     # @!attribute [rw] training_input_mode
-    #   The input mode used by the algorithm for the training job. For the
-    #   input modes that Amazon SageMaker algorithms support, see
-    #   [Algorithms][1].
+    #   The training input mode that the algorithm supports. For more
+    #   information about input modes, see [Algorithms][1].
+    #
+    #   **Pipe mode**
+    #
+    #   If an algorithm supports `Pipe` mode, Amazon SageMaker streams data
+    #   directly from Amazon S3 to the container.
+    #
+    #   **File mode**
+    #
+    #   If an algorithm supports `File` mode, SageMaker downloads the
+    #   training data from S3 to the provisioned ML storage volume, and
+    #   mounts the directory to the Docker volume for the training
+    #   container.
+    #
+    #   You must provision the ML storage volume with sufficient capacity to
+    #   accommodate the data downloaded from S3. In addition to the training
+    #   data, the ML storage volume also stores the output model. The
+    #   algorithm container uses the ML storage volume to also store
+    #   intermediate information, if any.
+    #
+    #   For distributed algorithms, training data is distributed uniformly.
+    #   Your training duration is predictable if the input data objects
+    #   sizes are approximately the same. SageMaker does not split the files
+    #   any further for model training. If the object sizes are skewed,
+    #   training won't be optimal as the data distribution is also skewed
+    #   when one host in a training cluster is overloaded, thus becoming a
+    #   bottleneck in training.
+    #
+    #   **FastFile mode**
+    #
+    #   If an algorithm supports `FastFile` mode, SageMaker streams data
+    #   directly from S3 to the container with no code changes, and provides
+    #   file system access to the data. Users can author their training
+    #   script to interact with these files as if they were stored on disk.
     #
-    #   If an algorithm supports the `File` input mode, Amazon SageMaker
-    #   downloads the training data from S3 to the provisioned ML storage
-    #   Volume, and mounts the directory to docker volume for training
-    #   container. If an algorithm supports the `Pipe` input mode, Amazon
-    #   SageMaker streams data directly from S3 to the container.
+    #   `FastFile` mode works best when the data is read sequentially.
+    #   Augmented manifest files aren't supported. The startup time is
+    #   lower when there are fewer files in the S3 bucket provided.
     #
     #
     #
@@ -33371,7 +33460,7 @@ module Aws::SageMaker
     #             is_required: false,
     #             supported_content_types: ["ContentType"], # required
     #             supported_compression_types: ["None"], # accepts None, Gzip
-    #             supported_input_modes: ["Pipe"], # required, accepts Pipe, File
+    #             supported_input_modes: ["Pipe"], # required, accepts Pipe, File, FastFile
     #           },
     #         ],
     #         supported_tuning_job_objective_metrics: [

data/lib/aws-sdk-sagemaker.rb

@@ -49,6 +49,6 @@ require_relative 'aws-sdk-sagemaker/customizations'
 # @!group service
 module Aws::SageMaker
 
-  GEM_VERSION = '1.101.0'
+  GEM_VERSION = '1.102.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-sagemaker
 version: !ruby/object:Gem::Version
-  version: 1.101.0
+  version: 1.102.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-16 00:00:00.000000000 Z
+date: 2021-10-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core