aws-sdk-autoscaling 1.72.0 → 1.76.0

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

@@ -393,7 +393,7 @@ module Aws::AutoScaling
     # @!attribute [rw] health_check_grace_period
     #   The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
     #   before checking the health status of an EC2 instance that has come
-    #   into service.
+    #   into service and marking it unhealthy due to a failed health check.
     #   @return [Integer]
     #
     # @!attribute [rw] instances
@@ -916,7 +916,7 @@ module Aws::AutoScaling
     # data points.
     #
     # @!attribute [rw] timestamps
-    #   The time stamps for the data points, in UTC format.
+    #   The timestamps for the data points, in UTC format.
     #   @return [Array<Time>]
     #
     # @!attribute [rw] values
@@ -1152,7 +1152,7 @@ module Aws::AutoScaling
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-mixed-instances-groups.html
     #   @return [Types::MixedInstancesPolicy]
     #
     # @!attribute [rw] instance_id
@@ -1255,10 +1255,9 @@ module Aws::AutoScaling
     # @!attribute [rw] health_check_grace_period
     #   The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
     #   before checking the health status of an EC2 instance that has come
-    #   into service. During this time, any health check failures for the
-    #   instance are ignored. The default value is `0`. For more
-    #   information, see [Health check grace period][1] in the *Amazon EC2
-    #   Auto Scaling User Guide*.
+    #   into service and marking it unhealthy due to a failed health check.
+    #   The default value is `0`. For more information, see [Health check
+    #   grace period][1] in the *Amazon EC2 Auto Scaling User Guide*.
     #
     #   Conditional: Required if you are adding an `ELB` health check.
     #
@@ -1307,12 +1306,12 @@ module Aws::AutoScaling
     #   Indicates whether newly launched instances are protected from
     #   termination by Amazon EC2 Auto Scaling when scaling in. For more
     #   information about preventing instances from terminating on scale in,
-    #   see [Instance scale-in protection][1] in the *Amazon EC2 Auto
+    #   see [Using instance scale-in protection][1] in the *Amazon EC2 Auto
     #   Scaling User Guide*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html#instance-protection
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-instance-protection.html
     #   @return [Boolean]
     #
     # @!attribute [rw] capacity_rebalance
@@ -1327,7 +1326,7 @@ module Aws::AutoScaling
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/capacity-rebalance.html
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-capacity-rebalancing.html
     #   @return [Boolean]
     #
     # @!attribute [rw] lifecycle_hook_specification_list
@@ -1806,7 +1805,7 @@ module Aws::AutoScaling
     # * Add values for each required parameter from CloudWatch. You can use
     #   an existing metric, or a new metric that you create. To use your own
     #   metric, you must first publish the metric to CloudWatch. For more
-    #   information, see [Publish Custom Metrics][1] in the *Amazon
+    #   information, see [Publish custom metrics][1] in the *Amazon
     #   CloudWatch User Guide*.
     #
     # * Choose a metric that changes proportionally with capacity. The value
@@ -1814,13 +1813,21 @@ module Aws::AutoScaling
     #   the number of capacity units. That is, the value of the metric
     #   should decrease when capacity increases.
     #
-    # For more information about CloudWatch, see [Amazon CloudWatch
-    # Concepts][2].
+    # For more information about the CloudWatch terminology below, see
+    # [Amazon CloudWatch concepts][2].
+    #
+    # <note markdown="1"> Each individual service provides information about the metrics,
+    # namespace, and dimensions they use. For more information, see [Amazon
+    # Web Services services that publish CloudWatch metrics][3] in the
+    # *Amazon CloudWatch User Guide*.
+    #
+    #  </note>
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/publishingMetrics.html
     # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html
+    # [3]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/aws-services-cloudwatch-metrics.html
     #
     # @note When making an API call, you may pass CustomizedMetricSpecification
     #   data as a hash:
@@ -1839,7 +1846,14 @@ module Aws::AutoScaling
     #       }
     #
     # @!attribute [rw] metric_name
-    #   The name of the metric.
+    #   The name of the metric. To get the exact metric name, namespace, and
+    #   dimensions, inspect the [Metric][1] object that is returned by a
+    #   call to [ListMetrics][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_Metric.html
+    #   [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_ListMetrics.html
     #   @return [String]
     #
     # @!attribute [rw] namespace
@@ -1858,7 +1872,13 @@ module Aws::AutoScaling
     #   @return [String]
     #
     # @!attribute [rw] unit
-    #   The unit of the metric.
+    #   The unit of the metric. For a complete list of the units that
+    #   CloudWatch supports, see the [MetricDatum][1] data type in the
+    #   *Amazon CloudWatch API Reference*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CustomizedMetricSpecification AWS API Documentation
@@ -1943,8 +1963,7 @@ module Aws::AutoScaling
     #   @return [String]
     #
     # @!attribute [rw] topic_arn
-    #   The Amazon Resource Name (ARN) of the Amazon Simple Notification
-    #   Service (Amazon SNS) topic.
+    #   The Amazon Resource Name (ARN) of the Amazon SNS topic.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteNotificationConfigurationType AWS API Documentation
@@ -2827,7 +2846,7 @@ module Aws::AutoScaling
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-mixed-instances-groups.html
     #   @return [Types::MixedInstancesPolicy]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DesiredConfiguration AWS API Documentation
@@ -4790,7 +4809,7 @@ module Aws::AutoScaling
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-override-options.html
+    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-configuring-overrides.html
     #
     # @note When making an API call, you may pass LaunchTemplateOverrides
     #   data as a hash:
@@ -4880,7 +4899,7 @@ module Aws::AutoScaling
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-weighting.html
+    #   [1]: https://docs.aws.amazon.com/ec2-auto-scaling-mixed-instances-groups-instance-weighting.html
     #   @return [String]
     #
     # @!attribute [rw] launch_template_specification
@@ -4894,7 +4913,7 @@ module Aws::AutoScaling
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-launch-template-overrides.html
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-mixed-instances-groups-launch-template-overrides.html
     #   @return [Types::LaunchTemplateSpecification]
     #
     # @!attribute [rw] instance_requirements
@@ -4991,9 +5010,9 @@ module Aws::AutoScaling
       include Aws::Structure
     end
 
-    # Describes a lifecycle hook, which tells Amazon EC2 Auto Scaling that
-    # you want to perform an action whenever it launches instances or
-    # terminates instances.
+    # Describes a lifecycle hook, which enables an Auto Scaling group to be
+    # aware of events in the Auto Scaling instance lifecycle, and then
+    # perform a custom action when the corresponding lifecycle event occurs.
     #
     # @!attribute [rw] lifecycle_hook_name
     #   The name of the lifecycle hook.
@@ -5068,31 +5087,6 @@ module Aws::AutoScaling
     # Describes information used to specify a lifecycle hook for an Auto
     # Scaling group.
     #
-    # A lifecycle hook tells Amazon EC2 Auto Scaling to perform an action on
-    # an instance when the instance launches (before it is put into service)
-    # or as the instance terminates (before it is fully terminated).
-    #
-    # This step is a part of the procedure for creating a lifecycle hook for
-    # an Auto Scaling group:
-    #
-    # 1.  (Optional) Create a Lambda function and a rule that allows
-    #     CloudWatch Events to invoke your Lambda function when Amazon EC2
-    #     Auto Scaling launches or terminates instances.
-    #
-    # 2.  (Optional) Create a notification target and an IAM role. The
-    #     target can be either an Amazon SQS queue or an Amazon SNS topic.
-    #     The role allows Amazon EC2 Auto Scaling to publish lifecycle
-    #     notifications to the target.
-    #
-    # 3.  **Create the lifecycle hook. Specify whether the hook is used when
-    #     the instances launch or terminate.**
-    #
-    # 4.  If you need more time, record the lifecycle action heartbeat to
-    #     keep the instance in a pending state.
-    #
-    # 5.  If you finish before the timeout period ends, complete the
-    #     lifecycle action.
-    #
     # For more information, see [Amazon EC2 Auto Scaling lifecycle hooks][1]
     # in the *Amazon EC2 Auto Scaling User Guide*.
     #
@@ -5273,7 +5267,7 @@ module Aws::AutoScaling
     # the metric specification.
     #
     # @!attribute [rw] timestamps
-    #   The time stamps for the data points, in UTC format.
+    #   The timestamps for the data points, in UTC format.
     #   @return [Array<Time>]
     #
     # @!attribute [rw] values
@@ -5350,6 +5344,60 @@ module Aws::AutoScaling
       include Aws::Structure
     end
 
+    # Represents a specific metric.
+    #
+    # @note When making an API call, you may pass Metric
+    #   data as a hash:
+    #
+    #       {
+    #         namespace: "MetricNamespace", # required
+    #         metric_name: "MetricName", # required
+    #         dimensions: [
+    #           {
+    #             name: "MetricDimensionName", # required
+    #             value: "MetricDimensionValue", # required
+    #           },
+    #         ],
+    #       }
+    #
+    # @!attribute [rw] namespace
+    #   The namespace of the metric. For more information, see the table in
+    #   [Amazon Web Services services that publish CloudWatch metrics ][1]
+    #   in the *Amazon CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/aws-services-cloudwatch-metrics.html
+    #   @return [String]
+    #
+    # @!attribute [rw] metric_name
+    #   The name of the metric.
+    #   @return [String]
+    #
+    # @!attribute [rw] dimensions
+    #   The dimensions for the metric. For the list of available dimensions,
+    #   see the Amazon Web Services documentation available from the table
+    #   in [Amazon Web Services services that publish CloudWatch metrics
+    #   ][1] in the *Amazon CloudWatch User Guide*.
+    #
+    #   Conditional: If you published your metric with dimensions, you must
+    #   specify the same dimensions in your scaling policy.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/aws-services-cloudwatch-metrics.html
+    #   @return [Array<Types::MetricDimension>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/Metric AWS API Documentation
+    #
+    class Metric < Struct.new(
+      :namespace,
+      :metric_name,
+      :dimensions)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describes a metric.
     #
     # @!attribute [rw] metric
@@ -5404,6 +5452,103 @@ module Aws::AutoScaling
       include Aws::Structure
     end
 
+    # The metric data to return. Also defines whether this call is returning
+    # data for one metric only, or whether it is performing a math
+    # expression on the values of returned metric statistics to create a new
+    # time series. A time series is a series of data points, each of which
+    # is associated with a timestamp.
+    #
+    # For more information and examples, see [Advanced predictive scaling
+    # policy configurations using custom metrics][1] in the *Amazon EC2 Auto
+    # Scaling User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/predictive-scaling-customized-metric-specification.html
+    #
+    # @note When making an API call, you may pass MetricDataQuery
+    #   data as a hash:
+    #
+    #       {
+    #         id: "XmlStringMaxLen255", # required
+    #         expression: "XmlStringMaxLen1023",
+    #         metric_stat: {
+    #           metric: { # required
+    #             namespace: "MetricNamespace", # required
+    #             metric_name: "MetricName", # required
+    #             dimensions: [
+    #               {
+    #                 name: "MetricDimensionName", # required
+    #                 value: "MetricDimensionValue", # required
+    #               },
+    #             ],
+    #           },
+    #           stat: "XmlStringMetricStat", # required
+    #           unit: "MetricUnit",
+    #         },
+    #         label: "XmlStringMetricLabel",
+    #         return_data: false,
+    #       }
+    #
+    # @!attribute [rw] id
+    #   A short name that identifies the object's results in the response.
+    #   This name must be unique among all `MetricDataQuery` objects
+    #   specified for a single scaling policy. If you are performing math
+    #   expressions on this set of data, this name represents that data and
+    #   can serve as a variable in the mathematical expression. The valid
+    #   characters are letters, numbers, and underscores. The first
+    #   character must be a lowercase letter.
+    #   @return [String]
+    #
+    # @!attribute [rw] expression
+    #   The math expression to perform on the returned data, if this object
+    #   is performing a math expression. This expression can use the `Id` of
+    #   the other metrics to refer to those metrics, and can also use the
+    #   `Id` of other expressions to use the result of those expressions.
+    #
+    #   Conditional: Within each `MetricDataQuery` object, you must specify
+    #   either `Expression` or `MetricStat`, but not both.
+    #   @return [String]
+    #
+    # @!attribute [rw] metric_stat
+    #   Information about the metric data to return.
+    #
+    #   Conditional: Within each `MetricDataQuery` object, you must specify
+    #   either `Expression` or `MetricStat`, but not both.
+    #   @return [Types::MetricStat]
+    #
+    # @!attribute [rw] label
+    #   A human-readable label for this metric or expression. This is
+    #   especially useful if this is a math expression, so that you know
+    #   what the value represents.
+    #   @return [String]
+    #
+    # @!attribute [rw] return_data
+    #   Indicates whether to return the timestamps and raw data values of
+    #   this metric.
+    #
+    #   If you use any math expressions, specify `true` for this value for
+    #   only the final math expression that the metric specification is
+    #   based on. You must specify `false` for `ReturnData` for all the
+    #   other metrics and expressions used in the metric specification.
+    #
+    #   If you are only retrieving metrics and not performing any math
+    #   expressions, do not specify anything for `ReturnData`. This sets it
+    #   to its default (`true`).
+    #   @return [Boolean]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/MetricDataQuery AWS API Documentation
+    #
+    class MetricDataQuery < Struct.new(
+      :id,
+      :expression,
+      :metric_stat,
+      :label,
+      :return_data)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describes the dimension of a metric.
     #
     # @note When making an API call, you may pass MetricDimension
@@ -5445,6 +5590,79 @@ module Aws::AutoScaling
       include Aws::Structure
     end
 
+    # This structure defines the CloudWatch metric to return, along with the
+    # statistic, period, and unit.
+    #
+    # For more information about the CloudWatch terminology below, see
+    # [Amazon CloudWatch concepts][1] in the *Amazon CloudWatch User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html
+    #
+    # @note When making an API call, you may pass MetricStat
+    #   data as a hash:
+    #
+    #       {
+    #         metric: { # required
+    #           namespace: "MetricNamespace", # required
+    #           metric_name: "MetricName", # required
+    #           dimensions: [
+    #             {
+    #               name: "MetricDimensionName", # required
+    #               value: "MetricDimensionValue", # required
+    #             },
+    #           ],
+    #         },
+    #         stat: "XmlStringMetricStat", # required
+    #         unit: "MetricUnit",
+    #       }
+    #
+    # @!attribute [rw] metric
+    #   The CloudWatch metric to return, including the metric name,
+    #   namespace, and dimensions. To get the exact metric name, namespace,
+    #   and dimensions, inspect the [Metric][1] object that is returned by a
+    #   call to [ListMetrics][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_Metric.html
+    #   [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_ListMetrics.html
+    #   @return [Types::Metric]
+    #
+    # @!attribute [rw] stat
+    #   The statistic to return. It can include any CloudWatch statistic or
+    #   extended statistic. For a list of valid values, see the table in
+    #   [Statistics][1] in the *Amazon CloudWatch User Guide*.
+    #
+    #   The most commonly used metrics for predictive scaling are `Average`
+    #   and `Sum`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Statistic
+    #   @return [String]
+    #
+    # @!attribute [rw] unit
+    #   The unit to use for the returned data points. For a complete list of
+    #   the units that CloudWatch supports, see the [MetricDatum][1] data
+    #   type in the *Amazon CloudWatch API Reference*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/MetricStat AWS API Documentation
+    #
+    class MetricStat < Struct.new(
+      :metric,
+      :stat,
+      :unit)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describes a mixed instances policy. A mixed instances policy contains
     # the instance types that Amazon EC2 Auto Scaling can launch and other
     # information that Amazon EC2 Auto Scaling can use to launch instances
@@ -5454,7 +5672,7 @@ module Aws::AutoScaling
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
+    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-mixed-instances-groups.html
     #
     # @note When making an API call, you may pass MixedInstancesPolicy
     #   data as a hash:
@@ -5591,8 +5809,7 @@ module Aws::AutoScaling
     #   @return [String]
     #
     # @!attribute [rw] topic_arn
-    #   The Amazon Resource Name (ARN) of the Amazon Simple Notification
-    #   Service (Amazon SNS) topic.
+    #   The Amazon Resource Name (ARN) of the Amazon SNS topic.
     #   @return [String]
     #
     # @!attribute [rw] notification_type
@@ -5750,6 +5967,78 @@ module Aws::AutoScaling
     #               predefined_metric_type: "ASGTotalCPUUtilization", # required, accepts ASGTotalCPUUtilization, ASGTotalNetworkIn, ASGTotalNetworkOut, ALBTargetGroupRequestCount
     #               resource_label: "XmlStringMaxLen1023",
     #             },
+    #             customized_scaling_metric_specification: {
+    #               metric_data_queries: [ # required
+    #                 {
+    #                   id: "XmlStringMaxLen255", # required
+    #                   expression: "XmlStringMaxLen1023",
+    #                   metric_stat: {
+    #                     metric: { # required
+    #                       namespace: "MetricNamespace", # required
+    #                       metric_name: "MetricName", # required
+    #                       dimensions: [
+    #                         {
+    #                           name: "MetricDimensionName", # required
+    #                           value: "MetricDimensionValue", # required
+    #                         },
+    #                       ],
+    #                     },
+    #                     stat: "XmlStringMetricStat", # required
+    #                     unit: "MetricUnit",
+    #                   },
+    #                   label: "XmlStringMetricLabel",
+    #                   return_data: false,
+    #                 },
+    #               ],
+    #             },
+    #             customized_load_metric_specification: {
+    #               metric_data_queries: [ # required
+    #                 {
+    #                   id: "XmlStringMaxLen255", # required
+    #                   expression: "XmlStringMaxLen1023",
+    #                   metric_stat: {
+    #                     metric: { # required
+    #                       namespace: "MetricNamespace", # required
+    #                       metric_name: "MetricName", # required
+    #                       dimensions: [
+    #                         {
+    #                           name: "MetricDimensionName", # required
+    #                           value: "MetricDimensionValue", # required
+    #                         },
+    #                       ],
+    #                     },
+    #                     stat: "XmlStringMetricStat", # required
+    #                     unit: "MetricUnit",
+    #                   },
+    #                   label: "XmlStringMetricLabel",
+    #                   return_data: false,
+    #                 },
+    #               ],
+    #             },
+    #             customized_capacity_metric_specification: {
+    #               metric_data_queries: [ # required
+    #                 {
+    #                   id: "XmlStringMaxLen255", # required
+    #                   expression: "XmlStringMaxLen1023",
+    #                   metric_stat: {
+    #                     metric: { # required
+    #                       namespace: "MetricNamespace", # required
+    #                       metric_name: "MetricName", # required
+    #                       dimensions: [
+    #                         {
+    #                           name: "MetricDimensionName", # required
+    #                           value: "MetricDimensionValue", # required
+    #                         },
+    #                       ],
+    #                     },
+    #                     stat: "XmlStringMetricStat", # required
+    #                     unit: "MetricUnit",
+    #                   },
+    #                   label: "XmlStringMetricLabel",
+    #                   return_data: false,
+    #                 },
+    #               ],
+    #             },
     #           },
     #         ],
     #         mode: "ForecastAndScale", # accepts ForecastAndScale, ForecastOnly
@@ -5832,6 +6121,139 @@ module Aws::AutoScaling
       include Aws::Structure
     end
 
+    # Describes a customized capacity metric for a predictive scaling
+    # policy.
+    #
+    # @note When making an API call, you may pass PredictiveScalingCustomizedCapacityMetric
+    #   data as a hash:
+    #
+    #       {
+    #         metric_data_queries: [ # required
+    #           {
+    #             id: "XmlStringMaxLen255", # required
+    #             expression: "XmlStringMaxLen1023",
+    #             metric_stat: {
+    #               metric: { # required
+    #                 namespace: "MetricNamespace", # required
+    #                 metric_name: "MetricName", # required
+    #                 dimensions: [
+    #                   {
+    #                     name: "MetricDimensionName", # required
+    #                     value: "MetricDimensionValue", # required
+    #                   },
+    #                 ],
+    #               },
+    #               stat: "XmlStringMetricStat", # required
+    #               unit: "MetricUnit",
+    #             },
+    #             label: "XmlStringMetricLabel",
+    #             return_data: false,
+    #           },
+    #         ],
+    #       }
+    #
+    # @!attribute [rw] metric_data_queries
+    #   One or more metric data queries to provide the data points for a
+    #   capacity metric. Use multiple metric data queries only if you are
+    #   performing a math expression on returned data.
+    #   @return [Array<Types::MetricDataQuery>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PredictiveScalingCustomizedCapacityMetric AWS API Documentation
+    #
+    class PredictiveScalingCustomizedCapacityMetric < Struct.new(
+      :metric_data_queries)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Describes a custom load metric for a predictive scaling policy.
+    #
+    # @note When making an API call, you may pass PredictiveScalingCustomizedLoadMetric
+    #   data as a hash:
+    #
+    #       {
+    #         metric_data_queries: [ # required
+    #           {
+    #             id: "XmlStringMaxLen255", # required
+    #             expression: "XmlStringMaxLen1023",
+    #             metric_stat: {
+    #               metric: { # required
+    #                 namespace: "MetricNamespace", # required
+    #                 metric_name: "MetricName", # required
+    #                 dimensions: [
+    #                   {
+    #                     name: "MetricDimensionName", # required
+    #                     value: "MetricDimensionValue", # required
+    #                   },
+    #                 ],
+    #               },
+    #               stat: "XmlStringMetricStat", # required
+    #               unit: "MetricUnit",
+    #             },
+    #             label: "XmlStringMetricLabel",
+    #             return_data: false,
+    #           },
+    #         ],
+    #       }
+    #
+    # @!attribute [rw] metric_data_queries
+    #   One or more metric data queries to provide the data points for a
+    #   load metric. Use multiple metric data queries only if you are
+    #   performing a math expression on returned data.
+    #   @return [Array<Types::MetricDataQuery>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PredictiveScalingCustomizedLoadMetric AWS API Documentation
+    #
+    class PredictiveScalingCustomizedLoadMetric < Struct.new(
+      :metric_data_queries)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Describes a custom scaling metric for a predictive scaling policy.
+    #
+    # @note When making an API call, you may pass PredictiveScalingCustomizedScalingMetric
+    #   data as a hash:
+    #
+    #       {
+    #         metric_data_queries: [ # required
+    #           {
+    #             id: "XmlStringMaxLen255", # required
+    #             expression: "XmlStringMaxLen1023",
+    #             metric_stat: {
+    #               metric: { # required
+    #                 namespace: "MetricNamespace", # required
+    #                 metric_name: "MetricName", # required
+    #                 dimensions: [
+    #                   {
+    #                     name: "MetricDimensionName", # required
+    #                     value: "MetricDimensionValue", # required
+    #                   },
+    #                 ],
+    #               },
+    #               stat: "XmlStringMetricStat", # required
+    #               unit: "MetricUnit",
+    #             },
+    #             label: "XmlStringMetricLabel",
+    #             return_data: false,
+    #           },
+    #         ],
+    #       }
+    #
+    # @!attribute [rw] metric_data_queries
+    #   One or more metric data queries to provide the data points for a
+    #   scaling metric. Use multiple metric data queries only if you are
+    #   performing a math expression on returned data.
+    #   @return [Array<Types::MetricDataQuery>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PredictiveScalingCustomizedScalingMetric AWS API Documentation
+    #
+    class PredictiveScalingCustomizedScalingMetric < Struct.new(
+      :metric_data_queries)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # This structure specifies the metrics and target utilization settings
     # for a predictive scaling policy.
     #
@@ -5872,6 +6294,14 @@ module Aws::AutoScaling
     #   requests received by each instance is as close to 1000 requests per
     #   minute as possible at all times.
     #
+    # For information about using custom metrics with predictive scaling,
+    # see [Advanced predictive scaling policy configurations using custom
+    # metrics][1] in the *Amazon EC2 Auto Scaling User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/predictive-scaling-customized-metric-specification.html
+    #
     # @note When making an API call, you may pass PredictiveScalingMetricSpecification
     #   data as a hash:
     #
@@ -5889,32 +6319,129 @@ module Aws::AutoScaling
     #           predefined_metric_type: "ASGTotalCPUUtilization", # required, accepts ASGTotalCPUUtilization, ASGTotalNetworkIn, ASGTotalNetworkOut, ALBTargetGroupRequestCount
     #           resource_label: "XmlStringMaxLen1023",
     #         },
+    #         customized_scaling_metric_specification: {
+    #           metric_data_queries: [ # required
+    #             {
+    #               id: "XmlStringMaxLen255", # required
+    #               expression: "XmlStringMaxLen1023",
+    #               metric_stat: {
+    #                 metric: { # required
+    #                   namespace: "MetricNamespace", # required
+    #                   metric_name: "MetricName", # required
+    #                   dimensions: [
+    #                     {
+    #                       name: "MetricDimensionName", # required
+    #                       value: "MetricDimensionValue", # required
+    #                     },
+    #                   ],
+    #                 },
+    #                 stat: "XmlStringMetricStat", # required
+    #                 unit: "MetricUnit",
+    #               },
+    #               label: "XmlStringMetricLabel",
+    #               return_data: false,
+    #             },
+    #           ],
+    #         },
+    #         customized_load_metric_specification: {
+    #           metric_data_queries: [ # required
+    #             {
+    #               id: "XmlStringMaxLen255", # required
+    #               expression: "XmlStringMaxLen1023",
+    #               metric_stat: {
+    #                 metric: { # required
+    #                   namespace: "MetricNamespace", # required
+    #                   metric_name: "MetricName", # required
+    #                   dimensions: [
+    #                     {
+    #                       name: "MetricDimensionName", # required
+    #                       value: "MetricDimensionValue", # required
+    #                     },
+    #                   ],
+    #                 },
+    #                 stat: "XmlStringMetricStat", # required
+    #                 unit: "MetricUnit",
+    #               },
+    #               label: "XmlStringMetricLabel",
+    #               return_data: false,
+    #             },
+    #           ],
+    #         },
+    #         customized_capacity_metric_specification: {
+    #           metric_data_queries: [ # required
+    #             {
+    #               id: "XmlStringMaxLen255", # required
+    #               expression: "XmlStringMaxLen1023",
+    #               metric_stat: {
+    #                 metric: { # required
+    #                   namespace: "MetricNamespace", # required
+    #                   metric_name: "MetricName", # required
+    #                   dimensions: [
+    #                     {
+    #                       name: "MetricDimensionName", # required
+    #                       value: "MetricDimensionValue", # required
+    #                     },
+    #                   ],
+    #                 },
+    #                 stat: "XmlStringMetricStat", # required
+    #                 unit: "MetricUnit",
+    #               },
+    #               label: "XmlStringMetricLabel",
+    #               return_data: false,
+    #             },
+    #           ],
+    #         },
     #       }
     #
     # @!attribute [rw] target_value
     #   Specifies the target utilization.
+    #
+    #   <note markdown="1"> Some metrics are based on a count instead of a percentage, such as
+    #   the request count for an Application Load Balancer or the number of
+    #   messages in an SQS queue. If the scaling policy specifies one of
+    #   these metrics, specify the target utilization as the optimal average
+    #   request or message count per instance during any one-minute
+    #   interval.
+    #
+    #    </note>
     #   @return [Float]
     #
     # @!attribute [rw] predefined_metric_pair_specification
-    #   The metric pair specification from which Amazon EC2 Auto Scaling
-    #   determines the appropriate scaling metric and load metric to use.
+    #   The predefined metric pair specification from which Amazon EC2 Auto
+    #   Scaling determines the appropriate scaling metric and load metric to
+    #   use.
     #   @return [Types::PredictiveScalingPredefinedMetricPair]
     #
     # @!attribute [rw] predefined_scaling_metric_specification
-    #   The scaling metric specification.
+    #   The predefined scaling metric specification.
     #   @return [Types::PredictiveScalingPredefinedScalingMetric]
     #
     # @!attribute [rw] predefined_load_metric_specification
-    #   The load metric specification.
+    #   The predefined load metric specification.
     #   @return [Types::PredictiveScalingPredefinedLoadMetric]
     #
+    # @!attribute [rw] customized_scaling_metric_specification
+    #   The customized scaling metric specification.
+    #   @return [Types::PredictiveScalingCustomizedScalingMetric]
+    #
+    # @!attribute [rw] customized_load_metric_specification
+    #   The customized load metric specification.
+    #   @return [Types::PredictiveScalingCustomizedLoadMetric]
+    #
+    # @!attribute [rw] customized_capacity_metric_specification
+    #   The customized capacity metric specification.
+    #   @return [Types::PredictiveScalingCustomizedCapacityMetric]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PredictiveScalingMetricSpecification AWS API Documentation
     #
     class PredictiveScalingMetricSpecification < Struct.new(
       :target_value,
       :predefined_metric_pair_specification,
       :predefined_scaling_metric_specification,
-      :predefined_load_metric_specification)
+      :predefined_load_metric_specification,
+      :customized_scaling_metric_specification,
+      :customized_load_metric_specification,
+      :customized_capacity_metric_specification)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -6264,8 +6791,7 @@ module Aws::AutoScaling
     #   @return [String]
     #
     # @!attribute [rw] topic_arn
-    #   The Amazon Resource Name (ARN) of the Amazon Simple Notification
-    #   Service (Amazon SNS) topic.
+    #   The Amazon Resource Name (ARN) of the Amazon SNS topic.
     #   @return [String]
     #
     # @!attribute [rw] notification_types
@@ -6342,6 +6868,78 @@ module Aws::AutoScaling
     #                 predefined_metric_type: "ASGTotalCPUUtilization", # required, accepts ASGTotalCPUUtilization, ASGTotalNetworkIn, ASGTotalNetworkOut, ALBTargetGroupRequestCount
     #                 resource_label: "XmlStringMaxLen1023",
     #               },
+    #               customized_scaling_metric_specification: {
+    #                 metric_data_queries: [ # required
+    #                   {
+    #                     id: "XmlStringMaxLen255", # required
+    #                     expression: "XmlStringMaxLen1023",
+    #                     metric_stat: {
+    #                       metric: { # required
+    #                         namespace: "MetricNamespace", # required
+    #                         metric_name: "MetricName", # required
+    #                         dimensions: [
+    #                           {
+    #                             name: "MetricDimensionName", # required
+    #                             value: "MetricDimensionValue", # required
+    #                           },
+    #                         ],
+    #                       },
+    #                       stat: "XmlStringMetricStat", # required
+    #                       unit: "MetricUnit",
+    #                     },
+    #                     label: "XmlStringMetricLabel",
+    #                     return_data: false,
+    #                   },
+    #                 ],
+    #               },
+    #               customized_load_metric_specification: {
+    #                 metric_data_queries: [ # required
+    #                   {
+    #                     id: "XmlStringMaxLen255", # required
+    #                     expression: "XmlStringMaxLen1023",
+    #                     metric_stat: {
+    #                       metric: { # required
+    #                         namespace: "MetricNamespace", # required
+    #                         metric_name: "MetricName", # required
+    #                         dimensions: [
+    #                           {
+    #                             name: "MetricDimensionName", # required
+    #                             value: "MetricDimensionValue", # required
+    #                           },
+    #                         ],
+    #                       },
+    #                       stat: "XmlStringMetricStat", # required
+    #                       unit: "MetricUnit",
+    #                     },
+    #                     label: "XmlStringMetricLabel",
+    #                     return_data: false,
+    #                   },
+    #                 ],
+    #               },
+    #               customized_capacity_metric_specification: {
+    #                 metric_data_queries: [ # required
+    #                   {
+    #                     id: "XmlStringMaxLen255", # required
+    #                     expression: "XmlStringMaxLen1023",
+    #                     metric_stat: {
+    #                       metric: { # required
+    #                         namespace: "MetricNamespace", # required
+    #                         metric_name: "MetricName", # required
+    #                         dimensions: [
+    #                           {
+    #                             name: "MetricDimensionName", # required
+    #                             value: "MetricDimensionValue", # required
+    #                           },
+    #                         ],
+    #                       },
+    #                       stat: "XmlStringMetricStat", # required
+    #                       unit: "MetricUnit",
+    #                     },
+    #                     label: "XmlStringMetricLabel",
+    #                     return_data: false,
+    #                   },
+    #                 ],
+    #               },
     #             },
     #           ],
     #           mode: "ForecastAndScale", # accepts ForecastAndScale, ForecastOnly
@@ -6466,7 +7064,7 @@ module Aws::AutoScaling
     #
     # @!attribute [rw] target_tracking_configuration
     #   A target tracking scaling policy. Provides support for predefined or
-    #   customized metrics.
+    #   custom metrics.
     #
     #   The following predefined metrics are available:
     #
@@ -6504,11 +7102,11 @@ module Aws::AutoScaling
     #   @return [Boolean]
     #
     # @!attribute [rw] predictive_scaling_configuration
-    #   A predictive scaling policy. Provides support for only predefined
-    #   metrics.
+    #   A predictive scaling policy. Provides support for predefined and
+    #   custom metrics.
     #
-    #   Predictive scaling works with CPU utilization, network in/out, and
-    #   the Application Load Balancer request count.
+    #   Predefined metrics include CPU utilization, network in/out, and the
+    #   Application Load Balancer request count.
     #
     #   For more information, see [PredictiveScalingConfiguration][1] in the
     #   *Amazon EC2 Auto Scaling API Reference*.
@@ -7972,7 +8570,7 @@ module Aws::AutoScaling
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-mixed-instances-groups.html
     #   @return [Types::MixedInstancesPolicy]
     #
     # @!attribute [rw] min_size
@@ -8027,9 +8625,9 @@ module Aws::AutoScaling
     # @!attribute [rw] health_check_grace_period
     #   The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
     #   before checking the health status of an EC2 instance that has come
-    #   into service. The default value is `0`. For more information, see
-    #   [Health check grace period][1] in the *Amazon EC2 Auto Scaling User
-    #   Guide*.
+    #   into service and marking it unhealthy due to a failed health check.
+    #   The default value is `0`. For more information, see [Health check
+    #   grace period][1] in the *Amazon EC2 Auto Scaling User Guide*.
     #
     #   Conditional: Required if you are adding an `ELB` health check.
     #
@@ -8074,12 +8672,12 @@ module Aws::AutoScaling
     #   Indicates whether newly launched instances are protected from
     #   termination by Amazon EC2 Auto Scaling when scaling in. For more
     #   information about preventing instances from terminating on scale in,
-    #   see [Instance scale-in protection][1] in the *Amazon EC2 Auto
+    #   see [Using instance scale-in protection][1] in the *Amazon EC2 Auto
     #   Scaling User Guide*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html#instance-protection
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-instance-protection.html
     #   @return [Boolean]
     #
     # @!attribute [rw] service_linked_role_arn
@@ -8113,7 +8711,7 @@ module Aws::AutoScaling
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/capacity-rebalance.html
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-capacity-rebalancing.html
     #   @return [Boolean]
     #
     # @!attribute [rw] context