aws-sdk-sagemaker 1.12.0 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4bc9398e9b075cc03b7dde79c0172490b5505749
-  data.tar.gz: 1b1a8207370694e13e3cdf89565bd17b351ce889
+  metadata.gz: 3db3d2b7678a1c4907ee07897ea241188ac9b998
+  data.tar.gz: 3c8e7f983b3fb40d00643246902583c95a06018b
 SHA512:
-  metadata.gz: 7de3c26a985699efca5c44924c3449d1c46c508fd4f1d6fea0461367ee1020bc55fb8184e474447f5740620d8645c6ac06bf78a91582ab9cb1e03dd17c52c70e
-  data.tar.gz: bcdb1f14c3ff79b55ab1134fe38ca9a1af219785e7487695b879c7c6cfb56950085fcd82c9a3dcee843e956cf98795b3344fab7ada238e1087fa33bd70610120
+  metadata.gz: a8250dd5c214786fc167ff632700f620bc7339d50dc89d5fd0a1cc9c2b3b94b13087a009083cd341e80950e3c40fc8832899675adf2d28bab9e4fe910a4a954c
+  data.tar.gz: c259358233431991d888795105d95f83a08b6fb8649798f554973bf5d3c719b81931a24f8ca0e2cbe1bb157d481d69a36490ca9d0cd93a1798b6a5eea6a3a0bb

data/lib/aws-sdk-sagemaker.rb

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

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

@@ -1108,8 +1108,9 @@ module Aws::SageMaker
       req.send_request(options)
     end
 
-    # Starts a transform job. After the results are obtained, Amazon
-    # SageMaker saves them to an Amazon S3 location that you specify.
+    # Starts a transform job. A transform job uses a trained model to get
+    # inferences on a dataset and saves these results to an Amazon S3
+    # location that you specify.
     #
     # To perform batch transformations, you create a transform job and use
     # the data that you have readily available.
@@ -1119,7 +1120,9 @@ module Aws::SageMaker
     # * `TransformJobName` - Identifies the transform job. The name must be
     #   unique within an AWS Region in an AWS account.
     #
-    # * `ModelName` - Identifies the model to use.
+    # * `ModelName` - Identifies the model to use. `ModelName` must be the
+    #   name of an existing Amazon SageMaker model within an AWS Region in
+    #   an AWS account.
     #
     # * `TransformInput` - Describes the dataset to be transformed and the
     #   Amazon S3 location where it is stored.
@@ -1143,29 +1146,38 @@ module Aws::SageMaker
     #
     # @option params [required, String] :model_name
     #   The name of the model that you want to use for the transform job.
+    #   `ModelName` must be the name of an existing Amazon SageMaker model
+    #   within an AWS Region in an AWS account.
     #
     # @option params [Integer] :max_concurrent_transforms
-    #   The maximum number of parallel requests on each instance node that can
-    #   be launched in a transform job. The default value is `1`. To allow
-    #   Amazon SageMaker to determine the appropriate number for
+    #   The maximum number of parallel requests that can be sent to each
+    #   instance in a transform job. This is good for algorithms that
+    #   implement multiple workers on larger instances . The default value is
+    #   `1`. To allow Amazon SageMaker to determine the appropriate number for
     #   `MaxConcurrentTransforms`, set the value to `0`.
     #
     # @option params [Integer] :max_payload_in_mb
     #   The maximum payload size allowed, in MB. A payload is the data portion
     #   of a record (without metadata). The value in `MaxPayloadInMB` must be
-    #   greater than the size of a single record.You can approximate the size
-    #   of a record by dividing the size of your dataset by the number of
-    #   records. The value you enter should be proportional to the number of
-    #   records you want per batch. It is recommended to enter a slightly
-    #   higher value to ensure the records will fit within the maximum payload
+    #   greater or equal to the size of a single record. You can approximate
+    #   the size of a record by dividing the size of your dataset by the
+    #   number of records. Then multiply this value by the number of records
+    #   you want in a mini-batch. It is recommended to enter a value slightly
+    #   larger than this to ensure the records fit within the maximum payload
     #   size. The default value is `6` MB. For an unlimited payload size, set
     #   the value to `0`.
     #
     # @option params [String] :batch_strategy
-    #   Determins the number of records included in a single batch.
-    #   `SingleRecord` means only one record is used per batch. `MultiRecord`
-    #   means a batch is set to contain as many records that could possibly
-    #   fit within the `MaxPayloadInMB` limit.
+    #   Determines the number of records included in a single mini-batch.
+    #   `SingleRecord` means only one record is used per mini-batch.
+    #   `MultiRecord` means a mini-batch is set to contain as many records
+    #   that can fit within the `MaxPayloadInMB` limit.
+    #
+    #   Batch transform will automatically split your input data into whatever
+    #   payload size is specified if you set `SplitType` to `Line` and
+    #   `BatchStrategy` to `MultiRecord`. There's no need to split the
+    #   dataset into smaller files or to use larger payload sizes unless the
+    #   records in your dataset are very large.
     #
     # @option params [Hash<String,String>] :environment
     #   The environment variables to set in the Docker container. We support
@@ -1250,6 +1262,14 @@ module Aws::SageMaker
     # Deletes an endpoint. Amazon SageMaker frees up all of the resources
     # that were deployed when the endpoint was created.
     #
+    # Amazon SageMaker retires any custom KMS key grants associated with the
+    # endpoint, meaning you don't need to use the [RevokeGrant][1] API
+    # call.
+    #
+    #
+    #
+    # [1]: http://docs.aws.amazon.com/kms/latest/APIReference/API_RevokeGrant.html
+    #
     # @option params [required, String] :endpoint_name
     #   The name of the endpoint that you want to delete.
     #
@@ -1776,6 +1796,7 @@ module Aws::SageMaker
     #   * {Types::DescribeTrainingJobResponse#training_start_time #training_start_time} => Time
     #   * {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;
     #
     # @example Request syntax with placeholder values
     #
@@ -1790,7 +1811,7 @@ module Aws::SageMaker
     #   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"
+    #   resp.secondary_status #=> String, one of "Starting", "LaunchingMLInstances", "PreparingTrainingStack", "Downloading", "DownloadingTrainingImage", "Training", "Uploading", "Stopping", "Stopped", "MaxRuntimeExceeded", "Completed", "Failed"
     #   resp.failure_reason #=> String
     #   resp.hyper_parameters #=> Hash
     #   resp.hyper_parameters["ParameterKey"] #=> String
@@ -1820,6 +1841,11 @@ module Aws::SageMaker
     #   resp.training_start_time #=> Time
     #   resp.training_end_time #=> Time
     #   resp.last_modified_time #=> Time
+    #   resp.secondary_status_transitions #=> Array
+    #   resp.secondary_status_transitions[0].status #=> String, one of "Starting", "LaunchingMLInstances", "PreparingTrainingStack", "Downloading", "DownloadingTrainingImage", "Training", "Uploading", "Stopping", "Stopped", "MaxRuntimeExceeded", "Completed", "Failed"
+    #   resp.secondary_status_transitions[0].start_time #=> Time
+    #   resp.secondary_status_transitions[0].end_time #=> Time
+    #   resp.secondary_status_transitions[0].status_message #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/DescribeTrainingJob AWS API Documentation
     #
@@ -2979,7 +3005,7 @@ module Aws::SageMaker
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-sagemaker'
-      context[:gem_version] = '1.12.0'
+      context[:gem_version] = '1.13.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -205,6 +205,8 @@ module Aws::SageMaker
     S3DataType = Shapes::StringShape.new(name: 'S3DataType')
     S3Uri = Shapes::StringShape.new(name: 'S3Uri')
     SecondaryStatus = Shapes::StringShape.new(name: 'SecondaryStatus')
+    SecondaryStatusTransition = Shapes::StructureShape.new(name: 'SecondaryStatusTransition')
+    SecondaryStatusTransitions = Shapes::ListShape.new(name: 'SecondaryStatusTransitions')
     SecurityGroupId = Shapes::StringShape.new(name: 'SecurityGroupId')
     SecurityGroupIds = Shapes::ListShape.new(name: 'SecurityGroupIds')
     SessionExpirationDurationInSeconds = Shapes::IntegerShape.new(name: 'SessionExpirationDurationInSeconds')
@@ -212,6 +214,7 @@ module Aws::SageMaker
     SortOrder = Shapes::StringShape.new(name: 'SortOrder')
     SplitType = Shapes::StringShape.new(name: 'SplitType')
     StartNotebookInstanceInput = Shapes::StructureShape.new(name: 'StartNotebookInstanceInput')
+    StatusMessage = Shapes::StringShape.new(name: 'StatusMessage')
     StopHyperParameterTuningJobRequest = Shapes::StructureShape.new(name: 'StopHyperParameterTuningJobRequest')
     StopNotebookInstanceInput = Shapes::StructureShape.new(name: 'StopNotebookInstanceInput')
     StopTrainingJobRequest = Shapes::StructureShape.new(name: 'StopTrainingJobRequest')
@@ -534,6 +537,7 @@ module Aws::SageMaker
     DescribeTrainingJobResponse.add_member(:training_start_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "TrainingStartTime"))
     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.struct_class = Types::DescribeTrainingJobResponse
 
     DescribeTransformJobRequest.add_member(:transform_job_name, Shapes::ShapeRef.new(shape: TransformJobName, required: true, location_name: "TransformJobName"))
@@ -886,6 +890,14 @@ module Aws::SageMaker
     S3DataSource.add_member(:s3_data_distribution_type, Shapes::ShapeRef.new(shape: S3DataDistribution, location_name: "S3DataDistributionType"))
     S3DataSource.struct_class = Types::S3DataSource
 
+    SecondaryStatusTransition.add_member(:status, Shapes::ShapeRef.new(shape: SecondaryStatus, required: true, location_name: "Status"))
+    SecondaryStatusTransition.add_member(:start_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "StartTime"))
+    SecondaryStatusTransition.add_member(:end_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "EndTime"))
+    SecondaryStatusTransition.add_member(:status_message, Shapes::ShapeRef.new(shape: StatusMessage, location_name: "StatusMessage"))
+    SecondaryStatusTransition.struct_class = Types::SecondaryStatusTransition
+
+    SecondaryStatusTransitions.member = Shapes::ShapeRef.new(shape: SecondaryStatusTransition)
+
     SecurityGroupIds.member = Shapes::ShapeRef.new(shape: SecurityGroupId)
 
     StartNotebookInstanceInput.add_member(:notebook_instance_name, Shapes::ShapeRef.new(shape: NotebookInstanceName, required: true, location_name: "NotebookInstanceName"))

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

@@ -1121,32 +1121,41 @@ module Aws::SageMaker
     #
     # @!attribute [rw] model_name
     #   The name of the model that you want to use for the transform job.
+    #   `ModelName` must be the name of an existing Amazon SageMaker model
+    #   within an AWS Region in an AWS account.
     #   @return [String]
     #
     # @!attribute [rw] max_concurrent_transforms
-    #   The maximum number of parallel requests on each instance node that
-    #   can be launched in a transform job. The default value is `1`. To
-    #   allow Amazon SageMaker to determine the appropriate number for
-    #   `MaxConcurrentTransforms`, set the value to `0`.
+    #   The maximum number of parallel requests that can be sent to each
+    #   instance in a transform job. This is good for algorithms that
+    #   implement multiple workers on larger instances . The default value
+    #   is `1`. To allow Amazon SageMaker to determine the appropriate
+    #   number for `MaxConcurrentTransforms`, set the value to `0`.
     #   @return [Integer]
     #
     # @!attribute [rw] max_payload_in_mb
     #   The maximum payload size allowed, in MB. A payload is the data
     #   portion of a record (without metadata). The value in
-    #   `MaxPayloadInMB` must be greater than the size of a single
-    #   record.You can approximate the size of a record by dividing the size
-    #   of your dataset by the number of records. The value you enter should
-    #   be proportional to the number of records you want per batch. It is
-    #   recommended to enter a slightly higher value to ensure the records
-    #   will fit within the maximum payload size. The default value is `6`
-    #   MB. For an unlimited payload size, set the value to `0`.
+    #   `MaxPayloadInMB` must be greater or equal to the size of a single
+    #   record. You can approximate the size of a record by dividing the
+    #   size of your dataset by the number of records. Then multiply this
+    #   value by the number of records you want in a mini-batch. It is
+    #   recommended to enter a value slightly larger than this to ensure the
+    #   records fit within the maximum payload size. The default value is
+    #   `6` MB. For an unlimited payload size, set the value to `0`.
     #   @return [Integer]
     #
     # @!attribute [rw] batch_strategy
-    #   Determins the number of records included in a single batch.
-    #   `SingleRecord` means only one record is used per batch.
-    #   `MultiRecord` means a batch is set to contain as many records that
-    #   could possibly fit within the `MaxPayloadInMB` limit.
+    #   Determines the number of records included in a single mini-batch.
+    #   `SingleRecord` means only one record is used per mini-batch.
+    #   `MultiRecord` means a mini-batch is set to contain as many records
+    #   that can fit within the `MaxPayloadInMB` limit.
+    #
+    #   Batch transform will automatically split your input data into
+    #   whatever payload size is specified if you set `SplitType` to `Line`
+    #   and `BatchStrategy` to `MultiRecord`. There's no need to split the
+    #   dataset into smaller files or to use larger payload sizes unless the
+    #   records in your dataset are very large.
     #   @return [String]
     #
     # @!attribute [rw] environment
@@ -1888,6 +1897,38 @@ module Aws::SageMaker
     # @!attribute [rw] secondary_status
     #   Provides granular information about the system state. For more
     #   information, see `TrainingJobStatus`.
+    #
+    #   * `Starting` - starting the training job.
+    #
+    #   * `LaunchingMLInstances` - launching ML instances for the training
+    #     job.
+    #
+    #   * `PreparingTrainingStack` - preparing the ML instances for the
+    #     training job.
+    #
+    #   * `Downloading` - downloading the input data.
+    #
+    #   * `DownloadingTrainingImage` - downloading the training algorithm
+    #     image.
+    #
+    #   * `Training` - model training is in progress.
+    #
+    #   * `Uploading` - uploading the trained model.
+    #
+    #   * `Stopping` - stopping the training job.
+    #
+    #   * `Stopped` - the training job has stopped.
+    #
+    #   * `MaxRuntimeExceeded` - the training job exceeded the specified max
+    #     run time and has been stopped.
+    #
+    #   * `Completed` - the training job has completed.
+    #
+    #   * `Failed` - the training job has failed. The failure reason is
+    #     provided in the `StatusMessage`.
+    #
+    #   The valid values for `SecondaryStatus` are subject to change. They
+    #   primarily provide information on the progress of the training job.
     #   @return [String]
     #
     # @!attribute [rw] failure_reason
@@ -1960,6 +2001,12 @@ module Aws::SageMaker
     #   last modified.
     #   @return [Time]
     #
+    # @!attribute [rw] secondary_status_transitions
+    #   To give an overview of the training job lifecycle,
+    #   `SecondaryStatusTransitions` is a log of time-ordered secondary
+    #   statuses that a training job has transitioned.
+    #   @return [Array<Types::SecondaryStatusTransition>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/DescribeTrainingJobResponse AWS API Documentation
     #
     class DescribeTrainingJobResponse < Struct.new(
@@ -1981,7 +2028,8 @@ module Aws::SageMaker
       :creation_time,
       :training_start_time,
       :training_end_time,
-      :last_modified_time)
+      :last_modified_time,
+      :secondary_status_transitions)
       include Aws::Structure
     end
 
@@ -2035,8 +2083,8 @@ module Aws::SageMaker
     #
     # @!attribute [rw] batch_strategy
     #   SingleRecord means only one record was used per a batch.
-    #   &lt;code&gt;MultiRecord&lt;/code&gt; means batches contained as many
-    #   records that could possibly fit within the `MaxPayloadInMB` limit.
+    #   `MultiRecord` means batches contained as many records that could
+    #   possibly fit within the `MaxPayloadInMB` limit.
     #   @return [String]
     #
     # @!attribute [rw] environment
@@ -4158,6 +4206,45 @@ module Aws::SageMaker
       include Aws::Structure
     end
 
+    # Specifies a secondary status the job has transitioned into. It
+    # includes a start timestamp and later an end timestamp. The end
+    # timestamp is added either after the job transitions to a different
+    # secondary status or after the job has ended.
+    #
+    # @!attribute [rw] status
+    #   Provides granular information about the system state. For more
+    #   information, see `SecondaryStatus` under the DescribeTrainingJob
+    #   response elements.
+    #   @return [String]
+    #
+    # @!attribute [rw] start_time
+    #   A timestamp that shows when the training job has entered this
+    #   secondary status.
+    #   @return [Time]
+    #
+    # @!attribute [rw] end_time
+    #   A timestamp that shows when the secondary status has ended and the
+    #   job has transitioned into another secondary status. The `EndTime`
+    #   timestamp is also set after the training job has ended.
+    #   @return [Time]
+    #
+    # @!attribute [rw] status_message
+    #   Shows a brief description and other information about the secondary
+    #   status. For example, the `LaunchingMLInstances` secondary status
+    #   could show a status message of "Insufficent capacity error while
+    #   launching instances".
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/SecondaryStatusTransition AWS API Documentation
+    #
+    class SecondaryStatusTransition < Struct.new(
+      :status,
+      :start_time,
+      :end_time,
+      :status_message)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass StartNotebookInstanceInput
     #   data as a hash:
     #
@@ -4454,9 +4541,9 @@ module Aws::SageMaker
     # @!attribute [rw] split_type
     #   The method to use to split the transform job's data into smaller
     #   batches. The default value is `None`. If you don't want to split
-    #   the data, specify (`None`). If you want to split records on a
-    #   newline character boundary, specify `Line`. To split records
-    #   according to the RecordIO format, specify `RecordIO`.
+    #   the data, specify `None`. If you want to split records on a newline
+    #   character boundary, specify `Line`. To split records according to
+    #   the RecordIO format, specify `RecordIO`.
     #
     #   Amazon SageMaker will send maximum number of records per batch in
     #   each request up to the MaxPayloadInMB limit. For more information,
@@ -4548,7 +4635,7 @@ module Aws::SageMaker
     #
     #   For every S3 object used as input for the transform job, the
     #   transformed data is stored in a corresponding subfolder in the
-    #   location under the output prefix.For example, the input data
+    #   location under the output prefix. For example, the input data
     #   `s3://bucket-name/input-name-prefix/dataset01/data.csv` will have
     #   the transformed data stored at
     #   `s3://bucket-name/key-name-prefix/dataset01/`, based on the original
@@ -4563,7 +4650,7 @@ module Aws::SageMaker
     #
     # @!attribute [rw] assemble_with
     #   Defines how to assemble the results of the transform job as a single
-    #   S3 object. You should select a format that is most convienant to
+    #   S3 object. You should select a format that is most convenient to
     #   you. To concatenate the results in binary format, specify `None`. To
     #   add a newline character at the end of every transformed record,
     #   specify `Line`. To assemble the output in RecordIO format, specify

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-sagemaker
 version: !ruby/object:Gem::Version
-  version: 1.12.0
+  version: 1.13.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-07-17 00:00:00.000000000 Z
+date: 2018-07-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core