aws-sdk-sagemaker 1.156.0 → 1.158.0

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

@@ -2015,66 +2015,171 @@ module Aws::SageMaker
     #
     #   Here are the options:
     #
-    #   * `MSE`\: The mean squared error (MSE) is the average of the squared
-    #     differences between the predicted and actual values. It is used
-    #     for regression. MSE values are always positive: the better a model
-    #     is at predicting the actual values, the smaller the MSE value is.
-    #     When the data contains outliers, they tend to dominate the MSE,
-    #     which might cause subpar prediction performance.
-    #
-    #   * `Accuracy`\: The ratio of the number of correctly classified items
-    #     to the total number of (correctly and incorrectly) classified
-    #     items. It is used for binary and multiclass classification. It
-    #     measures how close the predicted class values are to the actual
-    #     values. Accuracy values vary between zero and one: one indicates
-    #     perfect accuracy and zero indicates perfect inaccuracy.
-    #
-    #   * `F1`\: The F1 score is the harmonic mean of the precision and
-    #     recall. It is used for binary classification into classes
+    #   Accuracy
+    #
+    #   : The ratio of the number of correctly classified items to the total
+    #     number of (correctly and incorrectly) classified items. It is used
+    #     for both binary and multiclass classification. Accuracy measures
+    #     how close the predicted class values are to the actual values.
+    #     Values for accuracy metrics vary between zero (0) and one (1). A
+    #     value of 1 indicates perfect accuracy, and 0 indicates perfect
+    #     inaccuracy.
+    #
+    #   AUC
+    #
+    #   : The area under the curve (AUC) metric is used to compare and
+    #     evaluate binary classification by algorithms that return
+    #     probabilities, such as logistic regression. To map the
+    #     probabilities into classifications, these are compared against a
+    #     threshold value.
+    #
+    #     The relevant curve is the receiver operating characteristic curve
+    #     (ROC curve). The ROC curve plots the true positive rate (TPR) of
+    #     predictions (or recall) against the false positive rate (FPR) as a
+    #     function of the threshold value, above which a prediction is
+    #     considered positive. Increasing the threshold results in fewer
+    #     false positives, but more false negatives.
+    #
+    #     AUC is the area under this ROC curve. Therefore, AUC provides an
+    #     aggregated measure of the model performance across all possible
+    #     classification thresholds. AUC scores vary between 0 and 1. A
+    #     score of 1 indicates perfect accuracy, and a score of one half
+    #     (0.5) indicates that the prediction is not better than a random
+    #     classifier.
+    #
+    #   BalancedAccuracy
+    #
+    #   : `BalancedAccuracy` is a metric that measures the ratio of accurate
+    #     predictions to all predictions. This ratio is calculated after
+    #     normalizing true positives (TP) and true negatives (TN) by the
+    #     total number of positive (P) and negative (N) values. It is used
+    #     in both binary and multiclass classification and is defined as
+    #     follows: 0.5*((TP/P)+(TN/N)), with values ranging from 0 to 1.
+    #     `BalancedAccuracy` gives a better measure of accuracy when the
+    #     number of positives or negatives differ greatly from each other in
+    #     an imbalanced dataset. For example, when only 1% of email is spam.
+    #
+    #   F1
+    #
+    #   : The `F1` score is the harmonic mean of the precision and recall,
+    #     defined as follows: F1 = 2 * (precision * recall) / (precision +
+    #     recall). It is used for binary classification into classes
     #     traditionally referred to as positive and negative. Predictions
-    #     are said to be true when they match their actual (correct) class
-    #     and false when they do not. Precision is the ratio of the true
-    #     positive predictions to all positive predictions (including the
-    #     false positives) in a data set and measures the quality of the
-    #     prediction when it predicts the positive class. Recall (or
-    #     sensitivity) is the ratio of the true positive predictions to all
-    #     actual positive instances and measures how completely a model
-    #     predicts the actual class members in a data set. The standard F1
-    #     score weighs precision and recall equally. But which metric is
-    #     paramount typically depends on specific aspects of a problem. F1
-    #     scores vary between zero and one: one indicates the best possible
-    #     performance and zero the worst.
-    #
-    #   * `AUC`\: The area under the curve (AUC) metric is used to compare
-    #     and evaluate binary classification by algorithms such as logistic
-    #     regression that return probabilities. A threshold is needed to map
-    #     the probabilities into classifications. The relevant curve is the
-    #     receiver operating characteristic curve that plots the true
-    #     positive rate (TPR) of predictions (or recall) against the false
-    #     positive rate (FPR) as a function of the threshold value, above
-    #     which a prediction is considered positive. Increasing the
-    #     threshold results in fewer false positives but more false
-    #     negatives. AUC is the area under this receiver operating
-    #     characteristic curve and so provides an aggregated measure of the
-    #     model performance across all possible classification thresholds.
-    #     The AUC score can also be interpreted as the probability that a
-    #     randomly selected positive data point is more likely to be
-    #     predicted positive than a randomly selected negative example. AUC
-    #     scores vary between zero and one: a score of one indicates perfect
-    #     accuracy and a score of one half indicates that the prediction is
-    #     not better than a random classifier. Values under one half predict
-    #     less accurately than a random predictor. But such consistently bad
-    #     predictors can simply be inverted to obtain better than random
-    #     predictors.
-    #
-    #   * `F1macro`\: The F1macro score applies F1 scoring to multiclass
-    #     classification. In this context, you have multiple classes to
-    #     predict. You just calculate the precision and recall for each
-    #     class as you did for the positive class in binary classification.
-    #     Then, use these values to calculate the F1 score for each class
-    #     and average them to obtain the F1macro score. F1macro scores vary
-    #     between zero and one: one indicates the best possible performance
-    #     and zero the worst.
+    #     are said to be true when they match their actual (correct) class,
+    #     and false when they do not.
+    #
+    #     Precision is the ratio of the true positive predictions to all
+    #     positive predictions, and it includes the false positives in a
+    #     dataset. Precision measures the quality of the prediction when it
+    #     predicts the positive class.
+    #
+    #     Recall (or sensitivity) is the ratio of the true positive
+    #     predictions to all actual positive instances. Recall measures how
+    #     completely a model predicts the actual class members in a dataset.
+    #
+    #     F1 scores vary between 0 and 1. A score of 1 indicates the best
+    #     possible performance, and 0 indicates the worst.
+    #
+    #   F1macro
+    #
+    #   : The `F1macro` score applies F1 scoring to multiclass
+    #     classification problems. It does this by calculating the precision
+    #     and recall, and then taking their harmonic mean to calculate the
+    #     F1 score for each class. Lastly, the F1macro averages the
+    #     individual scores to obtain the `F1macro` score. `F1macro` scores
+    #     vary between 0 and 1. A score of 1 indicates the best possible
+    #     performance, and 0 indicates the worst.
+    #
+    #   MAE
+    #
+    #   : The mean absolute error (MAE) is a measure of how different the
+    #     predicted and actual values are, when they're averaged over all
+    #     values. MAE is commonly used in regression analysis to understand
+    #     model prediction error. If there is linear regression, MAE
+    #     represents the average distance from a predicted line to the
+    #     actual value. MAE is defined as the sum of absolute errors divided
+    #     by the number of observations. Values range from 0 to infinity,
+    #     with smaller numbers indicating a better model fit to the data.
+    #
+    #   MSE
+    #
+    #   : The mean squared error (MSE) is the average of the squared
+    #     differences between the predicted and actual values. It is used
+    #     for regression. MSE values are always positive. The better a model
+    #     is at predicting the actual values, the smaller the MSE value is
+    #
+    #   Precision
+    #
+    #   : Precision measures how well an algorithm predicts the true
+    #     positives (TP) out of all of the positives that it identifies. It
+    #     is defined as follows: Precision = TP/(TP+FP), with values ranging
+    #     from zero (0) to one (1), and is used in binary classification.
+    #     Precision is an important metric when the cost of a false positive
+    #     is high. For example, the cost of a false positive is very high if
+    #     an airplane safety system is falsely deemed safe to fly. A false
+    #     positive (FP) reflects a positive prediction that is actually
+    #     negative in the data.
+    #
+    #   PrecisionMacro
+    #
+    #   : The precision macro computes precision for multiclass
+    #     classification problems. It does this by calculating precision for
+    #     each class and averaging scores to obtain precision for several
+    #     classes. `PrecisionMacro` scores range from zero (0) to one (1).
+    #     Higher scores reflect the model's ability to predict true
+    #     positives (TP) out of all of the positives that it identifies,
+    #     averaged across multiple classes.
+    #
+    #   R2
+    #
+    #   : R2, also known as the coefficient of determination, is used in
+    #     regression to quantify how much a model can explain the variance
+    #     of a dependent variable. Values range from one (1) to negative one
+    #     (-1). Higher numbers indicate a higher fraction of explained
+    #     variability. `R2` values close to zero (0) indicate that very
+    #     little of the dependent variable can be explained by the model.
+    #     Negative values indicate a poor fit and that the model is
+    #     outperformed by a constant function. For linear regression, this
+    #     is a horizontal line.
+    #
+    #   Recall
+    #
+    #   : Recall measures how well an algorithm correctly predicts all of
+    #     the true positives (TP) in a dataset. A true positive is a
+    #     positive prediction that is also an actual positive value in the
+    #     data. Recall is defined as follows: Recall = TP/(TP+FN), with
+    #     values ranging from 0 to 1. Higher scores reflect a better ability
+    #     of the model to predict true positives (TP) in the data, and is
+    #     used in binary classification.
+    #
+    #     Recall is important when testing for cancer because it's used to
+    #     find all of the true positives. A false positive (FP) reflects a
+    #     positive prediction that is actually negative in the data. It is
+    #     often insufficient to measure only recall, because predicting
+    #     every output as a true positive will yield a perfect recall score.
+    #
+    #   RecallMacro
+    #
+    #   : The RecallMacro computes recall for multiclass classification
+    #     problems by calculating recall for each class and averaging scores
+    #     to obtain recall for several classes. RecallMacro scores range
+    #     from 0 to 1. Higher scores reflect the model's ability to predict
+    #     true positives (TP) in a dataset. Whereas, a true positive
+    #     reflects a positive prediction that is also an actual positive
+    #     value in the data. It is often insufficient to measure only
+    #     recall, because predicting every output as a true positive will
+    #     yield a perfect recall score.
+    #
+    #   RMSE
+    #
+    #   : Root mean squared error (RMSE) measures the square root of the
+    #     squared difference between predicted and actual values, and it's
+    #     averaged over all values. It is used in regression analysis to
+    #     understand model prediction error. It's an important metric to
+    #     indicate the presence of large model errors and outliers. Values
+    #     range from zero (0) to infinity, with smaller numbers indicating a
+    #     better model fit to the data. RMSE is dependent on scale, and
+    #     should not be used to compare datasets of different sizes.
     #
     #   If you do not specify a metric explicitly, the default behavior is
     #   to automatically use:
@@ -5381,8 +5486,8 @@ module Aws::SageMaker
     #   @return [String]
     #
     # @!attribute [rw] role_arn
-    #   The Amazon Resource Name (ARN) of an IAM role that enables Amazon
-    #   SageMaker to perform tasks on your behalf.
+    #   The ARN of an IAM role that enables Amazon SageMaker to perform
+    #   tasks on your behalf.
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -5402,7 +5507,7 @@ module Aws::SageMaker
     end
 
     # @!attribute [rw] image_arn
-    #   The Amazon Resource Name (ARN) of the image.
+    #   The ARN of the image.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/CreateImageResponse AWS API Documentation
@@ -5435,18 +5540,83 @@ module Aws::SageMaker
     #   The `ImageName` of the `Image` to create a version of.
     #   @return [String]
     #
+    # @!attribute [rw] aliases
+    #   A list of aliases created with the image version.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] vendor_guidance
+    #   The stability of the image version, specified by the maintainer.
+    #
+    #   * `NOT_PROVIDED`\: The maintainers did not provide a status for
+    #     image version stability.
+    #
+    #   * `STABLE`\: The image version is stable.
+    #
+    #   * `TO_BE_ARCHIVED`\: The image version is set to be archived. Custom
+    #     image versions that are set to be archived are automatically
+    #     archived after three months.
+    #
+    #   * `ARCHIVED`\: The image version is archived. Archived image
+    #     versions are not searchable and are no longer actively supported.
+    #   @return [String]
+    #
+    # @!attribute [rw] job_type
+    #   Indicates SageMaker job type compatibility.
+    #
+    #   * `TRAINING`\: The image version is compatible with SageMaker
+    #     training jobs.
+    #
+    #   * `INFERENCE`\: The image version is compatible with SageMaker
+    #     inference jobs.
+    #
+    #   * `NOTEBOOK_KERNEL`\: The image version is compatible with SageMaker
+    #     notebook kernels.
+    #   @return [String]
+    #
+    # @!attribute [rw] ml_framework
+    #   The machine learning framework vended in the image version.
+    #   @return [String]
+    #
+    # @!attribute [rw] programming_lang
+    #   The supported programming language and its version.
+    #   @return [String]
+    #
+    # @!attribute [rw] processor
+    #   Indicates CPU or GPU compatibility.
+    #
+    #   * `CPU`\: The image version is compatible with CPU.
+    #
+    #   * `GPU`\: The image version is compatible with GPU.
+    #   @return [String]
+    #
+    # @!attribute [rw] horovod
+    #   Indicates Horovod compatibility.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] release_notes
+    #   The maintainer description of the image version.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/CreateImageVersionRequest AWS API Documentation
     #
     class CreateImageVersionRequest < Struct.new(
       :base_image,
       :client_token,
-      :image_name)
+      :image_name,
+      :aliases,
+      :vendor_guidance,
+      :job_type,
+      :ml_framework,
+      :programming_lang,
+      :processor,
+      :horovod,
+      :release_notes)
       SENSITIVE = []
       include Aws::Structure
     end
 
     # @!attribute [rw] image_version_arn
-    #   The Amazon Resource Name (ARN) of the image version.
+    #   The ARN of the image version.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/CreateImageVersionResponse AWS API Documentation
@@ -8931,18 +9101,23 @@ module Aws::SageMaker
     class DeleteImageResponse < Aws::EmptyStructure; end
 
     # @!attribute [rw] image_name
-    #   The name of the image.
+    #   The name of the image to delete.
     #   @return [String]
     #
     # @!attribute [rw] version
     #   The version to delete.
     #   @return [Integer]
     #
+    # @!attribute [rw] alias
+    #   The alias of the image to delete.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/DeleteImageVersionRequest AWS API Documentation
     #
     class DeleteImageVersionRequest < Struct.new(
       :image_name,
-      :version)
+      :version,
+      :alias)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -9906,7 +10081,13 @@ module Aws::SageMaker
     #   @return [Array<Types::AutoMLPartialFailureReason>]
     #
     # @!attribute [rw] best_candidate
-    #   Returns the job's best `AutoMLCandidate`.
+    #   The best model candidate selected by SageMaker Autopilot using both
+    #   the best objective metric and lowest [InferenceLatency][1] for an
+    #   experiment.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/sagemaker/latest/dg/autopilot-metrics-validation.html
     #   @return [Types::AutoMLCandidate]
     #
     # @!attribute [rw] auto_ml_job_status
@@ -11707,7 +11888,7 @@ module Aws::SageMaker
     #   @return [String]
     #
     # @!attribute [rw] image_arn
-    #   The Amazon Resource Name (ARN) of the image.
+    #   The ARN of the image.
     #   @return [String]
     #
     # @!attribute [rw] image_name
@@ -11723,8 +11904,8 @@ module Aws::SageMaker
     #   @return [Time]
     #
     # @!attribute [rw] role_arn
-    #   The Amazon Resource Name (ARN) of the IAM role that enables Amazon
-    #   SageMaker to perform tasks on your behalf.
+    #   The ARN of the IAM role that enables Amazon SageMaker to perform
+    #   tasks on your behalf.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/DescribeImageResponse AWS API Documentation
@@ -11752,11 +11933,16 @@ module Aws::SageMaker
     #   described.
     #   @return [Integer]
     #
+    # @!attribute [rw] alias
+    #   The alias of the image version.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/DescribeImageVersionRequest AWS API Documentation
     #
     class DescribeImageVersionRequest < Struct.new(
       :image_name,
-      :version)
+      :version,
+      :alias)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -11780,7 +11966,7 @@ module Aws::SageMaker
     #   @return [String]
     #
     # @!attribute [rw] image_arn
-    #   The Amazon Resource Name (ARN) of the image the version is based on.
+    #   The ARN of the image the version is based on.
     #   @return [String]
     #
     # @!attribute [rw] image_version_arn
@@ -11799,6 +11985,59 @@ module Aws::SageMaker
     #   The version number.
     #   @return [Integer]
     #
+    # @!attribute [rw] vendor_guidance
+    #   The stability of the image version specified by the maintainer.
+    #
+    #   * `NOT_PROVIDED`\: The maintainers did not provide a status for
+    #     image version stability.
+    #
+    #   * `STABLE`\: The image version is stable.
+    #
+    #   * `TO_BE_ARCHIVED`\: The image version is set to be archived. Custom
+    #     image versions that are set to be archived are automatically
+    #     archived after three months.
+    #
+    #   * `ARCHIVED`\: The image version is archived. Archived image
+    #     versions are not searchable and are no longer actively supported.
+    #   @return [String]
+    #
+    # @!attribute [rw] job_type
+    #   Indicates SageMaker job type compatibility.
+    #
+    #   * `TRAINING`\: The image version is compatible with SageMaker
+    #     training jobs.
+    #
+    #   * `INFERENCE`\: The image version is compatible with SageMaker
+    #     inference jobs.
+    #
+    #   * `NOTEBOOK_KERNEL`\: The image version is compatible with SageMaker
+    #     notebook kernels.
+    #   @return [String]
+    #
+    # @!attribute [rw] ml_framework
+    #   The machine learning framework vended in the image version.
+    #   @return [String]
+    #
+    # @!attribute [rw] programming_lang
+    #   The supported programming language and its version.
+    #   @return [String]
+    #
+    # @!attribute [rw] processor
+    #   Indicates CPU or GPU compatibility.
+    #
+    #   * `CPU`\: The image version is compatible with CPU.
+    #
+    #   * `GPU`\: The image version is compatible with GPU.
+    #   @return [String]
+    #
+    # @!attribute [rw] horovod
+    #   Indicates Horovod compatibility.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] release_notes
+    #   The maintainer description of the image version.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/DescribeImageVersionResponse AWS API Documentation
     #
     class DescribeImageVersionResponse < Struct.new(
@@ -11810,7 +12049,14 @@ module Aws::SageMaker
       :image_version_arn,
       :image_version_status,
       :last_modified_time,
-      :version)
+      :version,
+      :vendor_guidance,
+      :job_type,
+      :ml_framework,
+      :programming_lang,
+      :processor,
+      :horovod,
+      :release_notes)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -14519,8 +14765,8 @@ module Aws::SageMaker
     #   @return [String]
     #
     # @!attribute [rw] sources
-    #   A list of the Amazon Resource Name (ARN) and, if applicable, job
-    #   type for multiple sources of an experiment run.
+    #   A list of ARNs and, if applicable, job types for multiple sources of
+    #   an experiment run.
     #   @return [Array<Types::TrialComponentSource>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/DescribeTrialComponentResponse AWS API Documentation
@@ -16201,8 +16447,8 @@ module Aws::SageMaker
     # * CreateTransformJob
     #
     # @!attribute [rw] experiment_name
-    #   The name of an existing experiment to associate the trial component
-    #   with.
+    #   The name of an existing experiment to associate with the trial
+    #   component.
     #   @return [String]
     #
     # @!attribute [rw] trial_name
@@ -16216,8 +16462,8 @@ module Aws::SageMaker
     #   @return [String]
     #
     # @!attribute [rw] run_name
-    #   The name of the experiment run to associate the trial component
-    #   with.
+    #   The name of the experiment run to associate with the trial
+    #   component.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/ExperimentConfig AWS API Documentation
@@ -18899,8 +19145,8 @@ module Aws::SageMaker
     # @!attribute [rw] parameter_ranges
     #   The ParameterRanges object that specifies the ranges of
     #   hyperparameters that this tuning job searches over to find the
-    #   optimal configuration for the highest model performance against
-    #   .your chosen objective metric.
+    #   optimal configuration for the highest model performance against your
+    #   chosen objective metric.
     #   @return [Types::ParameterRanges]
     #
     # @!attribute [rw] training_job_early_stopping_type
@@ -19464,7 +19710,7 @@ module Aws::SageMaker
     #   @return [String]
     #
     # @!attribute [rw] image_arn
-    #   The Amazon Resource Name (ARN) of the image.
+    #   The ARN of the image.
     #   @return [String]
     #
     # @!attribute [rw] image_name
@@ -19536,7 +19782,7 @@ module Aws::SageMaker
     #   @return [String]
     #
     # @!attribute [rw] image_arn
-    #   The Amazon Resource Name (ARN) of the image the version is based on.
+    #   The ARN of the image the version is based on.
     #   @return [String]
     #
     # @!attribute [rw] image_version_arn
@@ -21163,6 +21409,58 @@ module Aws::SageMaker
       include Aws::Structure
     end
 
+    # @!attribute [rw] image_name
+    #   The name of the image.
+    #   @return [String]
+    #
+    # @!attribute [rw] alias
+    #   The alias of the image version.
+    #   @return [String]
+    #
+    # @!attribute [rw] version
+    #   The version of the image. If image version is not specified, the
+    #   aliases of all versions of the image are listed.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of aliases to return.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   If the previous call to `ListAliases` didn't return the full set of
+    #   aliases, the call returns a token for retrieving the next set of
+    #   aliases.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/ListAliasesRequest AWS API Documentation
+    #
+    class ListAliasesRequest < Struct.new(
+      :image_name,
+      :alias,
+      :version,
+      :max_results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] sage_maker_image_version_aliases
+    #   A list of SageMaker image version aliases.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] next_token
+    #   A token for getting the next set of aliases, if more aliases exist.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/ListAliasesResponse AWS API Documentation
+    #
+    class ListAliasesResponse < Struct.new(
+      :sage_maker_image_version_aliases,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] max_results
     #   The maximum number of AppImageConfigs to return in the response. The
     #   default value is 10.
@@ -37235,8 +37533,8 @@ module Aws::SageMaker
     #   @return [String]
     #
     # @!attribute [rw] role_arn
-    #   The new Amazon Resource Name (ARN) for the IAM role that enables
-    #   Amazon SageMaker to perform tasks on your behalf.
+    #   The new ARN for the IAM role that enables Amazon SageMaker to
+    #   perform tasks on your behalf.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/UpdateImageRequest AWS API Documentation
@@ -37252,7 +37550,7 @@ module Aws::SageMaker
     end
 
     # @!attribute [rw] image_arn
-    #   The Amazon Resource Name (ARN) of the image.
+    #   The ARN of the image.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/UpdateImageResponse AWS API Documentation
@@ -37263,6 +37561,110 @@ module Aws::SageMaker
       include Aws::Structure
     end
 
+    # @!attribute [rw] image_name
+    #   The name of the image.
+    #   @return [String]
+    #
+    # @!attribute [rw] alias
+    #   The alias of the image version.
+    #   @return [String]
+    #
+    # @!attribute [rw] version
+    #   The version of the image.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] aliases_to_add
+    #   A list of aliases to add.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] aliases_to_delete
+    #   A list of aliases to delete.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] vendor_guidance
+    #   The availability of the image version specified by the maintainer.
+    #
+    #   * `NOT_PROVIDED`\: The maintainers did not provide a status for
+    #     image version stability.
+    #
+    #   * `STABLE`\: The image version is stable.
+    #
+    #   * `TO_BE_ARCHIVED`\: The image version is set to be archived. Custom
+    #     image versions that are set to be archived are automatically
+    #     archived after three months.
+    #
+    #   * `ARCHIVED`\: The image version is archived. Archived image
+    #     versions are not searchable and are no longer actively supported.
+    #   @return [String]
+    #
+    # @!attribute [rw] job_type
+    #   Indicates SageMaker job type compatibility.
+    #
+    #   * `TRAINING`\: The image version is compatible with SageMaker
+    #     training jobs.
+    #
+    #   * `INFERENCE`\: The image version is compatible with SageMaker
+    #     inference jobs.
+    #
+    #   * `NOTEBOOK_KERNEL`\: The image version is compatible with SageMaker
+    #     notebook kernels.
+    #   @return [String]
+    #
+    # @!attribute [rw] ml_framework
+    #   The machine learning framework vended in the image version.
+    #   @return [String]
+    #
+    # @!attribute [rw] programming_lang
+    #   The supported programming language and its version.
+    #   @return [String]
+    #
+    # @!attribute [rw] processor
+    #   Indicates CPU or GPU compatibility.
+    #
+    #   * `CPU`\: The image version is compatible with CPU.
+    #
+    #   * `GPU`\: The image version is compatible with GPU.
+    #   @return [String]
+    #
+    # @!attribute [rw] horovod
+    #   Indicates Horovod compatibility.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] release_notes
+    #   The maintainer description of the image version.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/UpdateImageVersionRequest AWS API Documentation
+    #
+    class UpdateImageVersionRequest < Struct.new(
+      :image_name,
+      :alias,
+      :version,
+      :aliases_to_add,
+      :aliases_to_delete,
+      :vendor_guidance,
+      :job_type,
+      :ml_framework,
+      :programming_lang,
+      :processor,
+      :horovod,
+      :release_notes)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] image_version_arn
+    #   The ARN of the image version.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/UpdateImageVersionResponse AWS API Documentation
+    #
+    class UpdateImageVersionResponse < Struct.new(
+      :image_version_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] name
     #   The name of the inference experiment to be updated.
     #   @return [String]