aws-sdk-autoscaling 1.85.0 → 1.87.0

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

@@ -425,6 +425,16 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
+    # <note markdown="1"> This API call has been replaced with a new "traffic sources" API
+    # call (`AttachTrafficSources`) that can attach multiple traffic sources
+    # types. While we continue to support `AttachLoadBalancerTargetGroups`,
+    # and you can use both the original `AttachLoadBalancerTargetGroups` API
+    # call and the new `AttachTrafficSources` API call on the same Auto
+    # Scaling group, we recommend using the new "traffic sources" API call
+    # to simplify how you manage traffic sources.
+    #
+    #  </note>
+    #
     # Attaches one or more target groups to the specified Auto Scaling
     # group.
     #
@@ -495,9 +505,13 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
-    # <note markdown="1"> To attach an Application Load Balancer, Network Load Balancer, or
-    # Gateway Load Balancer, use the AttachLoadBalancerTargetGroups API
-    # operation instead.
+    # <note markdown="1"> This API call has been replaced with a new "traffic sources" API
+    # call (`AttachTrafficSources`) that can attach multiple traffic sources
+    # types. While we continue to support `AttachLoadBalancers`, and you can
+    # use both the original `AttachLoadBalancers` API call and the new
+    # `AttachTrafficSources` API call on the same Auto Scaling group, we
+    # recommend using the new "traffic sources" API call to simplify how
+    # you manage traffic sources.
     #
     #  </note>
     #
@@ -557,20 +571,30 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
-    # **Reserved for use with Amazon VPC Lattice, which is in preview and
-    # subject to change. Do not use this API for production workloads. This
-    # API is also subject to change.**
-    #
     # Attaches one or more traffic sources to the specified Auto Scaling
     # group.
     #
-    # To describe the traffic sources for an Auto Scaling group, call the
-    # DescribeTrafficSources API. To detach a traffic source from the Auto
-    # Scaling group, call the DetachTrafficSources API.
+    # You can use any of the following as traffic sources for an Auto
+    # Scaling group:
+    #
+    # * Application Load Balancer
+    #
+    # * Classic Load Balancer
+    #
+    # * Network Load Balancer
+    #
+    # * Gateway Load Balancer
+    #
+    # * VPC Lattice
     #
     # This operation is additive and does not detach existing traffic
     # sources from the Auto Scaling group.
     #
+    # After the operation completes, use the DescribeTrafficSources API to
+    # return details about the state of the attachments between traffic
+    # sources and your Auto Scaling group. To detach a traffic source from
+    # the Auto Scaling group, call the DetachTrafficSources API.
+    #
     # @option params [required, String] :auto_scaling_group_name
     #   The name of the Auto Scaling group.
     #
@@ -578,21 +602,34 @@ module Aws::AutoScaling
     #   The unique identifiers of one or more traffic sources. You can specify
     #   up to 10 traffic sources.
     #
-    #   Currently, you must specify an Amazon Resource Name (ARN) for an
-    #   existing VPC Lattice target group. Amazon EC2 Auto Scaling registers
-    #   the running instances with the attached target groups. The target
-    #   groups receive incoming traffic and route requests to one or more
-    #   registered targets.
-    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To attach a target group to an Auto Scaling group
+    #
+    #   # This example attaches the specified target group to the specified Auto Scaling group.
+    #
+    #   resp = client.attach_traffic_sources({
+    #     auto_scaling_group_name: "my-auto-scaling-group", 
+    #     traffic_sources: [
+    #       {
+    #         identifier: "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.attach_traffic_sources({
     #     auto_scaling_group_name: "XmlStringMaxLen255", # required
     #     traffic_sources: [ # required
     #       {
-    #         identifier: "XmlStringMaxLen511",
+    #         identifier: "XmlStringMaxLen511", # required
+    #         type: "XmlStringMaxLen511",
     #       },
     #     ],
     #   })
@@ -690,14 +727,18 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
-    # Cancels an instance refresh operation in progress. Cancellation does
-    # not roll back any replacements that have already been completed, but
-    # it prevents new replacements from being started.
+    # Cancels an instance refresh or rollback that is in progress. If an
+    # instance refresh or rollback is not in progress, an
+    # `ActiveInstanceRefreshNotFound` error occurs.
     #
     # This operation is part of the [instance refresh feature][1] in Amazon
     # EC2 Auto Scaling, which helps you update instances in your Auto
     # Scaling group after you make configuration changes.
     #
+    # When you cancel an instance refresh, this does not roll back any
+    # changes that it made. Use the RollbackInstanceRefresh API to roll back
+    # instead.
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html
@@ -968,7 +1009,8 @@ module Aws::AutoScaling
     # @option params [Array<String>] :load_balancer_names
     #   A list of Classic Load Balancers associated with this Auto Scaling
     #   group. For Application Load Balancers, Network Load Balancers, and
-    #   Gateway Load Balancer, specify the `TargetGroupARNs` property instead.
+    #   Gateway Load Balancers, specify the `TargetGroupARNs` property
+    #   instead.
     #
     # @option params [Array<String>] :target_group_arns
     #   The Amazon Resource Names (ARN) of the Elastic Load Balancing target
@@ -984,14 +1026,12 @@ module Aws::AutoScaling
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html
     #
     # @option params [String] :health_check_type
-    #   Determines whether any additional health checks are performed on the
-    #   instances in this group. Amazon EC2 health checks are always on. For
-    #   more information, see [Health checks for Auto Scaling instances][1] in
-    #   the *Amazon EC2 Auto Scaling User Guide*.
+    #   A comma-separated list of one or more health check types.
     #
-    #   The valid values are `EC2` (default), `ELB`, and `VPC_LATTICE`. The
-    #   `VPC_LATTICE` health check type is reserved for use with VPC Lattice,
-    #   which is in preview release and is subject to change.
+    #   The valid values are `EC2`, `ELB`, and `VPC_LATTICE`. `EC2` is the
+    #   default health check and cannot be disabled. For more information, see
+    #   [Health checks for Auto Scaling instances][1] in the *Amazon EC2 Auto
+    #   Scaling User Guide*.
     #
     #
     #
@@ -1135,24 +1175,25 @@ module Aws::AutoScaling
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-instance-type-requirements.html
     #
     # @option params [Integer] :default_instance_warmup
-    #   The amount of time, in seconds, until a newly launched instance can
-    #   contribute to the Amazon CloudWatch metrics. This delay lets an
-    #   instance finish initializing before Amazon EC2 Auto Scaling aggregates
-    #   instance metrics, resulting in more reliable usage data. Set this
-    #   value equal to the amount of time that it takes for resource
-    #   consumption to become stable after an instance reaches the `InService`
-    #   state. For more information, see [Set the default instance warmup for
-    #   an Auto Scaling group][1] in the *Amazon EC2 Auto Scaling User Guide*.
-    #
-    #   To manage your warm-up settings at the group level, we recommend that
-    #   you set the default instance warmup, *even if its value is set to 0
-    #   seconds*. This also optimizes the performance of scaling policies that
-    #   scale continuously, such as target tracking and step scaling policies.
-    #
-    #    If you need to remove a value that you previously set, include the
+    #   The amount of time, in seconds, until a new instance is considered to
+    #   have finished initializing and resource consumption to become stable
+    #   after it enters the `InService` state.
+    #
+    #   During an instance refresh, Amazon EC2 Auto Scaling waits for the
+    #   warm-up period after it replaces an instance before it moves on to
+    #   replacing the next instance. Amazon EC2 Auto Scaling also waits for
+    #   the warm-up period before aggregating the metrics for new instances
+    #   with existing instances in the Amazon CloudWatch metrics that are used
+    #   for scaling, resulting in more reliable usage data. For more
+    #   information, see [Set the default instance warmup for an Auto Scaling
+    #   group][1] in the *Amazon EC2 Auto Scaling User Guide*.
+    #
+    #   To manage various warm-up settings at the group level, we recommend
+    #   that you set the default instance warmup, *even if it is set to 0
+    #   seconds*. To remove a value that you previously set, include the
     #   property but specify `-1` for the value. However, we strongly
     #   recommend keeping the default instance warmup enabled by specifying a
-    #   minimum value of `0`.
+    #   value of `0` or other nominal value.
     #
     #   Default: None
     #
@@ -1161,17 +1202,10 @@ module Aws::AutoScaling
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-default-instance-warmup.html
     #
     # @option params [Array<Types::TrafficSourceIdentifier>] :traffic_sources
-    #   **Reserved for use with Amazon VPC Lattice, which is in preview
-    #   release and is subject to change. Do not use this parameter for
-    #   production workloads. It is also subject to change.**
-    #
-    #   The unique identifiers of one or more traffic sources.
-    #
-    #   Currently, you must specify an Amazon Resource Name (ARN) for an
-    #   existing VPC Lattice target group. Amazon EC2 Auto Scaling registers
-    #   the running instances with the attached target groups. The target
-    #   groups receive incoming traffic and route requests to one or more
-    #   registered targets.
+    #   The list of traffic sources to attach to this Auto Scaling group. You
+    #   can use any of the following as traffic sources for an Auto Scaling
+    #   group: Classic Load Balancer, Application Load Balancer, Gateway Load
+    #   Balancer, Network Load Balancer, and VPC Lattice.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1385,7 +1419,8 @@ module Aws::AutoScaling
     #     default_instance_warmup: 1,
     #     traffic_sources: [
     #       {
-    #         identifier: "XmlStringMaxLen511",
+    #         identifier: "XmlStringMaxLen511", # required
+    #         type: "XmlStringMaxLen511",
     #       },
     #     ],
     #   })
@@ -2473,6 +2508,7 @@ module Aws::AutoScaling
     #   resp.auto_scaling_groups[0].default_instance_warmup #=> Integer
     #   resp.auto_scaling_groups[0].traffic_sources #=> Array
     #   resp.auto_scaling_groups[0].traffic_sources[0].identifier #=> String
+    #   resp.auto_scaling_groups[0].traffic_sources[0].type #=> String
     #   resp.next_token #=> String
     #
     #
@@ -2623,29 +2659,14 @@ module Aws::AutoScaling
     # EC2 Auto Scaling, which helps you update instances in your Auto
     # Scaling group after you make configuration changes.
     #
-    # To help you determine the status of an instance refresh, this
-    # operation returns information about the instance refreshes you
-    # previously initiated, including their status, end time, the percentage
-    # of the instance refresh that is complete, and the number of instances
-    # remaining to update before the instance refresh is complete.
-    #
-    # The following are the possible statuses:
-    #
-    # * `Pending` - The request was created, but the operation has not
-    #   started.
-    #
-    # * `InProgress` - The operation is in progress.
-    #
-    # * `Successful` - The operation completed successfully.
-    #
-    # * `Failed` - The operation failed to complete. You can troubleshoot
-    #   using the status reason and the scaling activities.
-    #
-    # * `Cancelling` - An ongoing operation is being cancelled. Cancellation
-    #   does not roll back any replacements that have already been
-    #   completed, but it prevents new replacements from being started.
-    #
-    # * `Cancelled` - The operation is cancelled.
+    # To help you determine the status of an instance refresh, Amazon EC2
+    # Auto Scaling returns information about the instance refreshes you
+    # previously initiated, including their status, start time, end time,
+    # the percentage of the instance refresh that is complete, and the
+    # number of instances remaining to update before the instance refresh is
+    # complete. If a rollback is initiated while an instance refresh is in
+    # progress, Amazon EC2 Auto Scaling also returns information about the
+    # rollback of the instance refresh.
     #
     #
     #
@@ -2716,7 +2737,7 @@ module Aws::AutoScaling
     #   resp.instance_refreshes #=> Array
     #   resp.instance_refreshes[0].instance_refresh_id #=> String
     #   resp.instance_refreshes[0].auto_scaling_group_name #=> String
-    #   resp.instance_refreshes[0].status #=> String, one of "Pending", "InProgress", "Successful", "Failed", "Cancelling", "Cancelled"
+    #   resp.instance_refreshes[0].status #=> String, one of "Pending", "InProgress", "Successful", "Failed", "Cancelling", "Cancelled", "RollbackInProgress", "RollbackFailed", "RollbackSuccessful"
     #   resp.instance_refreshes[0].status_reason #=> String
     #   resp.instance_refreshes[0].start_time #=> Time
     #   resp.instance_refreshes[0].end_time #=> Time
@@ -2732,6 +2753,9 @@ module Aws::AutoScaling
     #   resp.instance_refreshes[0].preferences.checkpoint_percentages[0] #=> Integer
     #   resp.instance_refreshes[0].preferences.checkpoint_delay #=> Integer
     #   resp.instance_refreshes[0].preferences.skip_matching #=> Boolean
+    #   resp.instance_refreshes[0].preferences.auto_rollback #=> Boolean
+    #   resp.instance_refreshes[0].preferences.scale_in_protected_instances #=> String, one of "Refresh", "Ignore", "Wait"
+    #   resp.instance_refreshes[0].preferences.standby_instances #=> String, one of "Terminate", "Ignore", "Wait"
     #   resp.instance_refreshes[0].desired_configuration.launch_template.launch_template_id #=> String
     #   resp.instance_refreshes[0].desired_configuration.launch_template.launch_template_name #=> String
     #   resp.instance_refreshes[0].desired_configuration.launch_template.version #=> String
@@ -2790,6 +2814,14 @@ module Aws::AutoScaling
     #   resp.instance_refreshes[0].desired_configuration.mixed_instances_policy.instances_distribution.spot_allocation_strategy #=> String
     #   resp.instance_refreshes[0].desired_configuration.mixed_instances_policy.instances_distribution.spot_instance_pools #=> Integer
     #   resp.instance_refreshes[0].desired_configuration.mixed_instances_policy.instances_distribution.spot_max_price #=> String
+    #   resp.instance_refreshes[0].rollback_details.rollback_reason #=> String
+    #   resp.instance_refreshes[0].rollback_details.rollback_start_time #=> Time
+    #   resp.instance_refreshes[0].rollback_details.percentage_complete_on_rollback #=> Integer
+    #   resp.instance_refreshes[0].rollback_details.instances_to_update_on_rollback #=> Integer
+    #   resp.instance_refreshes[0].rollback_details.progress_details_on_rollback.live_pool_progress.percentage_complete #=> Integer
+    #   resp.instance_refreshes[0].rollback_details.progress_details_on_rollback.live_pool_progress.instances_to_update #=> Integer
+    #   resp.instance_refreshes[0].rollback_details.progress_details_on_rollback.warm_pool_progress.percentage_complete #=> Integer
+    #   resp.instance_refreshes[0].rollback_details.progress_details_on_rollback.warm_pool_progress.instances_to_update #=> Integer
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeInstanceRefreshes AWS API Documentation
@@ -3025,6 +3057,17 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
+    # <note markdown="1"> This API call has been replaced with a new "traffic sources" API
+    # call (`DescribeTrafficSources`) that can describe multiple traffic
+    # sources types. While we continue to support
+    # `DescribeLoadBalancerTargetGroups`, and you can use both the original
+    # `DescribeLoadBalancerTargetGroups` API call and the new
+    # `DescribeTrafficSources` API call on the same Auto Scaling group, we
+    # recommend using the new "traffic sources" API call to simplify how
+    # you manage traffic sources.
+    #
+    #  </note>
+    #
     # Gets information about the Elastic Load Balancing target groups for
     # the specified Auto Scaling group.
     #
@@ -3122,12 +3165,22 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
+    # <note markdown="1"> This API call has been replaced with a new "traffic sources" API
+    # call (`DescribeTrafficSources`) that can describe multiple traffic
+    # sources types. While we continue to support `DescribeLoadBalancers`,
+    # and you can use both the original `DescribeLoadBalancers` API call and
+    # the new `DescribeTrafficSources` API call on the same Auto Scaling
+    # group, we recommend using the new "traffic sources" API call to
+    # simplify how you manage traffic sources.
+    #
+    #  </note>
+    #
     # Gets information about the load balancers for the specified Auto
     # Scaling group.
     #
     # This operation describes only Classic Load Balancers. If you have
     # Application Load Balancers, Network Load Balancers, or Gateway Load
-    # Balancer, use the DescribeLoadBalancerTargetGroups API instead.
+    # Balancers, use the DescribeLoadBalancerTargetGroups API instead.
     #
     # To determine the attachment status of the load balancer, use the
     # `State` element in the response. When you attach a load balancer to an
@@ -3635,7 +3688,7 @@ module Aws::AutoScaling
     #   resp.activities[0].cause #=> String
     #   resp.activities[0].start_time #=> Time
     #   resp.activities[0].end_time #=> Time
-    #   resp.activities[0].status_code #=> String, one of "PendingSpotBidPlacement", "WaitingForSpotInstanceRequestId", "WaitingForSpotInstanceId", "WaitingForInstanceId", "PreInService", "InProgress", "WaitingForELBConnectionDraining", "MidLifecycleAction", "WaitingForInstanceWarmup", "Successful", "Failed", "Cancelled"
+    #   resp.activities[0].status_code #=> String, one of "PendingSpotBidPlacement", "WaitingForSpotInstanceRequestId", "WaitingForSpotInstanceId", "WaitingForInstanceId", "PreInService", "InProgress", "WaitingForELBConnectionDraining", "MidLifecycleAction", "WaitingForInstanceWarmup", "Successful", "Failed", "Cancelled", "WaitingForConnectionDraining"
     #   resp.activities[0].status_message #=> String
     #   resp.activities[0].progress #=> Integer
     #   resp.activities[0].details #=> String
@@ -3964,19 +4017,30 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
-    # **Reserved for use with Amazon VPC Lattice, which is in preview and
-    # subject to change. Do not use this API for production workloads. This
-    # API is also subject to change.**
-    #
     # Gets information about the traffic sources for the specified Auto
     # Scaling group.
     #
+    # You can optionally provide a traffic source type. If you provide a
+    # traffic source type, then the results only include that traffic source
+    # type.
+    #
+    # If you do not provide a traffic source type, then the results include
+    # all the traffic sources for the specified Auto Scaling group.
+    #
     # @option params [required, String] :auto_scaling_group_name
     #   The name of the Auto Scaling group.
     #
-    # @option params [required, String] :traffic_source_type
-    #   The type of traffic source you are describing. Currently, the only
-    #   valid value is `vpc-lattice`.
+    # @option params [String] :traffic_source_type
+    #   The traffic source type that you want to describe.
+    #
+    #   The following lists the valid values:
+    #
+    #   * `elb` if the traffic source is a Classic Load Balancer.
+    #
+    #   * `elbv2` if the traffic source is a Application Load Balancer,
+    #     Gateway Load Balancer, or Network Load Balancer.
+    #
+    #   * `vpc-lattice` if the traffic source is VPC Lattice.
     #
     # @option params [String] :next_token
     #   The token for the next set of items to return. (You received this
@@ -3991,11 +4055,34 @@ module Aws::AutoScaling
     #   * {Types::DescribeTrafficSourcesResponse#traffic_sources #traffic_sources} => Array&lt;Types::TrafficSourceState&gt;
     #   * {Types::DescribeTrafficSourcesResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    #
+    # @example Example: To describe the target groups for an Auto Scaling group
+    #
+    #   # This example describes the target groups attached to the specified Auto Scaling group.
+    #
+    #   resp = client.describe_traffic_sources({
+    #     auto_scaling_group_name: "my-auto-scaling-group", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     next_token: "", 
+    #     traffic_sources: [
+    #       {
+    #         identifier: "arn:aws:vpc-lattice:us-west-2:123456789012:targetgroup/tg-0e2f2665eEXAMPLE", 
+    #         state: "InService", 
+    #         type: "vpc-lattice", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_traffic_sources({
     #     auto_scaling_group_name: "XmlStringMaxLen255", # required
-    #     traffic_source_type: "XmlStringMaxLen255", # required
+    #     traffic_source_type: "XmlStringMaxLen255",
     #     next_token: "XmlString",
     #     max_records: 1,
     #   })
@@ -4005,6 +4092,8 @@ module Aws::AutoScaling
     #   resp.traffic_sources #=> Array
     #   resp.traffic_sources[0].traffic_source #=> String
     #   resp.traffic_sources[0].state #=> String
+    #   resp.traffic_sources[0].identifier #=> String
+    #   resp.traffic_sources[0].type #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeTrafficSources AWS API Documentation
@@ -4161,7 +4250,7 @@ module Aws::AutoScaling
     #   resp.activities[0].cause #=> String
     #   resp.activities[0].start_time #=> Time
     #   resp.activities[0].end_time #=> Time
-    #   resp.activities[0].status_code #=> String, one of "PendingSpotBidPlacement", "WaitingForSpotInstanceRequestId", "WaitingForSpotInstanceId", "WaitingForInstanceId", "PreInService", "InProgress", "WaitingForELBConnectionDraining", "MidLifecycleAction", "WaitingForInstanceWarmup", "Successful", "Failed", "Cancelled"
+    #   resp.activities[0].status_code #=> String, one of "PendingSpotBidPlacement", "WaitingForSpotInstanceRequestId", "WaitingForSpotInstanceId", "WaitingForInstanceId", "PreInService", "InProgress", "WaitingForELBConnectionDraining", "MidLifecycleAction", "WaitingForInstanceWarmup", "Successful", "Failed", "Cancelled", "WaitingForConnectionDraining"
     #   resp.activities[0].status_message #=> String
     #   resp.activities[0].progress #=> Integer
     #   resp.activities[0].details #=> String
@@ -4177,6 +4266,16 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
+    # <note markdown="1"> This API call has been replaced with a new "traffic sources" API
+    # call (`DetachTrafficSources`) that can detach multiple traffic sources
+    # types. While we continue to support `DetachLoadBalancerTargetGroups`,
+    # and you can use both the original `DetachLoadBalancerTargetGroups` API
+    # call and the new `DetachTrafficSources` API call on the same Auto
+    # Scaling group, we recommend using the new "traffic sources" API call
+    # to simplify how you manage traffic sources.
+    #
+    #  </note>
+    #
     # Detaches one or more target groups from the specified Auto Scaling
     # group.
     #
@@ -4229,12 +4328,22 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
+    # <note markdown="1"> This API call has been replaced with a new "traffic sources" API
+    # call (`DetachTrafficSources`) that can detach multiple traffic sources
+    # types. While we continue to support `DetachLoadBalancers`, and you can
+    # use both the original `DetachLoadBalancers` API call and the new
+    # `DetachTrafficSources` API call on the same Auto Scaling group, we
+    # recommend using the new "traffic sources" API call to simplify how
+    # you manage traffic sources.
+    #
+    #  </note>
+    #
     # Detaches one or more Classic Load Balancers from the specified Auto
     # Scaling group.
     #
     # This operation detaches only Classic Load Balancers. If you have
     # Application Load Balancers, Network Load Balancers, or Gateway Load
-    # Balancer, use the DetachLoadBalancerTargetGroups API instead.
+    # Balancers, use the DetachLoadBalancerTargetGroups API instead.
     #
     # When you detach a load balancer, it enters the `Removing` state while
     # deregistering the instances in the group. When all instances are
@@ -4278,13 +4387,14 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
-    # **Reserved for use with Amazon VPC Lattice, which is in preview and
-    # subject to change. Do not use this API for production workloads. This
-    # API is also subject to change.**
-    #
     # Detaches one or more traffic sources from the specified Auto Scaling
     # group.
     #
+    # When you detach a taffic, it enters the `Removing` state while
+    # deregistering the instances in the group. When all instances are
+    # deregistered, then you can no longer describe the traffic source using
+    # the DescribeTrafficSources API call. The instances continue to run.
+    #
     # @option params [required, String] :auto_scaling_group_name
     #   The name of the Auto Scaling group.
     #
@@ -4292,22 +4402,34 @@ module Aws::AutoScaling
     #   The unique identifiers of one or more traffic sources you are
     #   detaching. You can specify up to 10 traffic sources.
     #
-    #   Currently, you must specify an Amazon Resource Name (ARN) for an
-    #   existing VPC Lattice target group. When you detach a target group, it
-    #   enters the `Removing` state while deregistering the instances in the
-    #   group. When all instances are deregistered, then you can no longer
-    #   describe the target group using the DescribeTrafficSources API call.
-    #   The instances continue to run.
-    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To detach a target group from an Auto Scaling group
+    #
+    #   # This example detaches the specified target group from the specified Auto Scaling group.
+    #
+    #   resp = client.detach_traffic_sources({
+    #     auto_scaling_group_name: "my-auto-scaling-group", 
+    #     traffic_sources: [
+    #       {
+    #         identifier: "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.detach_traffic_sources({
     #     auto_scaling_group_name: "XmlStringMaxLen255", # required
     #     traffic_sources: [ # required
     #       {
-    #         identifier: "XmlStringMaxLen511",
+    #         identifier: "XmlStringMaxLen511", # required
+    #         type: "XmlStringMaxLen511",
     #       },
     #     ],
     #   })
@@ -4593,7 +4715,7 @@ module Aws::AutoScaling
     #   resp.activities[0].cause #=> String
     #   resp.activities[0].start_time #=> Time
     #   resp.activities[0].end_time #=> Time
-    #   resp.activities[0].status_code #=> String, one of "PendingSpotBidPlacement", "WaitingForSpotInstanceRequestId", "WaitingForSpotInstanceId", "WaitingForInstanceId", "PreInService", "InProgress", "WaitingForELBConnectionDraining", "MidLifecycleAction", "WaitingForInstanceWarmup", "Successful", "Failed", "Cancelled"
+    #   resp.activities[0].status_code #=> String, one of "PendingSpotBidPlacement", "WaitingForSpotInstanceRequestId", "WaitingForSpotInstanceId", "WaitingForInstanceId", "PreInService", "InProgress", "WaitingForELBConnectionDraining", "MidLifecycleAction", "WaitingForInstanceWarmup", "Successful", "Failed", "Cancelled", "WaitingForConnectionDraining"
     #   resp.activities[0].status_message #=> String
     #   resp.activities[0].progress #=> Integer
     #   resp.activities[0].details #=> String
@@ -4748,7 +4870,7 @@ module Aws::AutoScaling
     #   resp.activities[0].cause #=> String
     #   resp.activities[0].start_time #=> Time
     #   resp.activities[0].end_time #=> Time
-    #   resp.activities[0].status_code #=> String, one of "PendingSpotBidPlacement", "WaitingForSpotInstanceRequestId", "WaitingForSpotInstanceId", "WaitingForInstanceId", "PreInService", "InProgress", "WaitingForELBConnectionDraining", "MidLifecycleAction", "WaitingForInstanceWarmup", "Successful", "Failed", "Cancelled"
+    #   resp.activities[0].status_code #=> String, one of "PendingSpotBidPlacement", "WaitingForSpotInstanceRequestId", "WaitingForSpotInstanceId", "WaitingForInstanceId", "PreInService", "InProgress", "WaitingForELBConnectionDraining", "MidLifecycleAction", "WaitingForInstanceWarmup", "Successful", "Failed", "Cancelled", "WaitingForConnectionDraining"
     #   resp.activities[0].status_message #=> String
     #   resp.activities[0].progress #=> Integer
     #   resp.activities[0].details #=> String
@@ -5865,6 +5987,63 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
+    # Cancels an instance refresh that is in progress and rolls back any
+    # changes that it made. Amazon EC2 Auto Scaling replaces any instances
+    # that were replaced during the instance refresh. This restores your
+    # Auto Scaling group to the configuration that it was using before the
+    # start of the instance refresh.
+    #
+    # This operation is part of the [instance refresh feature][1] in Amazon
+    # EC2 Auto Scaling, which helps you update instances in your Auto
+    # Scaling group after you make configuration changes.
+    #
+    # A rollback is not supported in the following situations:
+    #
+    # * There is no desired configuration specified for the instance
+    #   refresh.
+    #
+    # * The Auto Scaling group has a launch template that uses an Amazon Web
+    #   Services Systems Manager parameter instead of an AMI ID for the
+    #   `ImageId` property.
+    #
+    # * The Auto Scaling group uses the launch template's `$Latest` or
+    #   `$Default` version.
+    #
+    # When you receive a successful response from this operation, Amazon EC2
+    # Auto Scaling immediately begins replacing instances. You can check the
+    # status of this operation through the DescribeInstanceRefreshes API
+    # operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html
+    #
+    # @option params [String] :auto_scaling_group_name
+    #   The name of the Auto Scaling group.
+    #
+    # @return [Types::RollbackInstanceRefreshAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::RollbackInstanceRefreshAnswer#instance_refresh_id #instance_refresh_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.rollback_instance_refresh({
+    #     auto_scaling_group_name: "XmlStringMaxLen255",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.instance_refresh_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/RollbackInstanceRefresh AWS API Documentation
+    #
+    # @overload rollback_instance_refresh(params = {})
+    # @param [Hash] params ({})
+    def rollback_instance_refresh(params = {}, options = {})
+      req = build_request(:rollback_instance_refresh, params)
+      req.send_request(options)
+    end
+
     # Sets the size of the specified Auto Scaling group.
     #
     # If a scale-in activity occurs as a result of a new `DesiredCapacity`
@@ -6053,9 +6232,9 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
-    # Starts a new instance refresh operation. An instance refresh performs
-    # a rolling replacement of all or some instances in an Auto Scaling
-    # group. Each instance is terminated first and then replaced, which
+    # Starts an instance refresh. During an instance refresh, Amazon EC2
+    # Auto Scaling performs a rolling update of instances in an Auto Scaling
+    # group. Instances are terminated first and then replaced, which
     # temporarily reduces the capacity available within your Auto Scaling
     # group.
     #
@@ -6067,12 +6246,26 @@ module Aws::AutoScaling
     # start an instance refresh to immediately begin the process of updating
     # instances in the group.
     #
-    # If the call succeeds, it creates a new instance refresh request with a
-    # unique ID that you can use to track its progress. To query its status,
-    # call the DescribeInstanceRefreshes API. To describe the instance
-    # refreshes that have already run, call the DescribeInstanceRefreshes
-    # API. To cancel an instance refresh operation in progress, use the
-    # CancelInstanceRefresh API.
+    # If successful, the request's response contains a unique ID that you
+    # can use to track the progress of the instance refresh. To query its
+    # status, call the DescribeInstanceRefreshes API. To describe the
+    # instance refreshes that have already run, call the
+    # DescribeInstanceRefreshes API. To cancel an instance refresh that is
+    # in progress, use the CancelInstanceRefresh API.
+    #
+    # An instance refresh might fail for several reasons, such as EC2 launch
+    # failures, misconfigured health checks, or not ignoring or allowing the
+    # termination of instances that are in `Standby` state or protected from
+    # scale in. You can monitor for failed EC2 launches using the scaling
+    # activities. To find the scaling activities, call the
+    # DescribeScalingActivities API.
+    #
+    # If you enable auto rollback, your Auto Scaling group will be rolled
+    # back automatically when the instance refresh fails. You can enable
+    # this feature before starting an instance refresh by specifying the
+    # `AutoRollback` property in the instance refresh preferences.
+    # Otherwise, to roll back an instance refresh before it finishes, use
+    # the RollbackInstanceRefresh API.
     #
     #
     #
@@ -6085,12 +6278,6 @@ module Aws::AutoScaling
     #   The strategy to use for the instance refresh. The only valid value is
     #   `Rolling`.
     #
-    #   A rolling update helps you update your instances gradually. A rolling
-    #   update can fail due to failed health checks or if instances are on
-    #   standby or are protected from scale in. If the rolling update process
-    #   fails, any instances that are replaced are not rolled back to their
-    #   previous configuration.
-    #
     # @option params [Types::DesiredConfiguration] :desired_configuration
     #   The desired configuration. For example, the desired configuration can
     #   specify a new launch template or a new version of the current launch
@@ -6104,14 +6291,24 @@ module Aws::AutoScaling
     #   launch template for your desired configuration, consider enabling the
     #   `SkipMatching` property in preferences. If it's enabled, Amazon EC2
     #   Auto Scaling skips replacing instances that already use the specified
-    #   launch template and version. This can help you reduce the number of
-    #   replacements that are required to apply updates.
+    #   launch template and instance types. This can help you reduce the
+    #   number of replacements that are required to apply updates.
     #
     #    </note>
     #
     # @option params [Types::RefreshPreferences] :preferences
-    #   Set of preferences associated with the instance refresh request. If
-    #   not provided, the default values are used.
+    #   Sets your preferences for the instance refresh so that it performs as
+    #   expected when you start it. Includes the instance warmup time, the
+    #   minimum healthy percentage, and the behaviors that you want Amazon EC2
+    #   Auto Scaling to use if instances that are in `Standby` state or
+    #   protected from scale in are found. You can also choose to enable
+    #   additional features, such as the following:
+    #
+    #   * Auto rollback
+    #
+    #   * Checkpoints
+    #
+    #   * Skip matching
     #
     # @return [Types::StartInstanceRefreshAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6240,6 +6437,9 @@ module Aws::AutoScaling
     #       checkpoint_percentages: [1],
     #       checkpoint_delay: 1,
     #       skip_matching: false,
+    #       auto_rollback: false,
+    #       scale_in_protected_instances: "Refresh", # accepts Refresh, Ignore, Wait
+    #       standby_instances: "Terminate", # accepts Terminate, Ignore, Wait
     #     },
     #   })
     #
@@ -6389,7 +6589,7 @@ module Aws::AutoScaling
     #   resp.activity.cause #=> String
     #   resp.activity.start_time #=> Time
     #   resp.activity.end_time #=> Time
-    #   resp.activity.status_code #=> String, one of "PendingSpotBidPlacement", "WaitingForSpotInstanceRequestId", "WaitingForSpotInstanceId", "WaitingForInstanceId", "PreInService", "InProgress", "WaitingForELBConnectionDraining", "MidLifecycleAction", "WaitingForInstanceWarmup", "Successful", "Failed", "Cancelled"
+    #   resp.activity.status_code #=> String, one of "PendingSpotBidPlacement", "WaitingForSpotInstanceRequestId", "WaitingForSpotInstanceId", "WaitingForInstanceId", "PreInService", "InProgress", "WaitingForELBConnectionDraining", "MidLifecycleAction", "WaitingForInstanceWarmup", "Successful", "Failed", "Cancelled", "WaitingForConnectionDraining"
     #   resp.activity.status_message #=> String
     #   resp.activity.progress #=> Integer
     #   resp.activity.details #=> String
@@ -6431,7 +6631,7 @@ module Aws::AutoScaling
     # performance or availability of your application.
     #
     # Note the following about changing `DesiredCapacity`, `MaxSize`, or
-    # `MinSize`\:
+    # `MinSize`:
     #
     # * If a scale-in activity occurs as a result of a new `DesiredCapacity`
     #   value that is lower than the current size of the group, the Auto
@@ -6514,12 +6714,16 @@ module Aws::AutoScaling
     #   One or more Availability Zones for the group.
     #
     # @option params [String] :health_check_type
-    #   Determines whether any additional health checks are performed on the
-    #   instances in this group. Amazon EC2 health checks are always on.
+    #   A comma-separated list of one or more health check types.
+    #
+    #   The valid values are `EC2`, `ELB`, and `VPC_LATTICE`. `EC2` is the
+    #   default health check and cannot be disabled. For more information, see
+    #   [Health checks for Auto Scaling instances][1] in the *Amazon EC2 Auto
+    #   Scaling User Guide*.
+    #
     #
-    #   The valid values are `EC2` (default), `ELB`, and `VPC_LATTICE`. The
-    #   `VPC_LATTICE` health check type is reserved for use with VPC Lattice,
-    #   which is in preview release and is subject to change.
+    #
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/healthcheck.html
     #
     # @option params [Integer] :health_check_grace_period
     #   The amount of time, in seconds, that Amazon EC2 Auto Scaling waits
@@ -6631,24 +6835,25 @@ module Aws::AutoScaling
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-instance-type-requirements.html
     #
     # @option params [Integer] :default_instance_warmup
-    #   The amount of time, in seconds, until a newly launched instance can
-    #   contribute to the Amazon CloudWatch metrics. This delay lets an
-    #   instance finish initializing before Amazon EC2 Auto Scaling aggregates
-    #   instance metrics, resulting in more reliable usage data. Set this
-    #   value equal to the amount of time that it takes for resource
-    #   consumption to become stable after an instance reaches the `InService`
-    #   state. For more information, see [Set the default instance warmup for
-    #   an Auto Scaling group][1] in the *Amazon EC2 Auto Scaling User Guide*.
-    #
-    #   To manage your warm-up settings at the group level, we recommend that
-    #   you set the default instance warmup, *even if its value is set to 0
-    #   seconds*. This also optimizes the performance of scaling policies that
-    #   scale continuously, such as target tracking and step scaling policies.
-    #
-    #    If you need to remove a value that you previously set, include the
+    #   The amount of time, in seconds, until a new instance is considered to
+    #   have finished initializing and resource consumption to become stable
+    #   after it enters the `InService` state.
+    #
+    #   During an instance refresh, Amazon EC2 Auto Scaling waits for the
+    #   warm-up period after it replaces an instance before it moves on to
+    #   replacing the next instance. Amazon EC2 Auto Scaling also waits for
+    #   the warm-up period before aggregating the metrics for new instances
+    #   with existing instances in the Amazon CloudWatch metrics that are used
+    #   for scaling, resulting in more reliable usage data. For more
+    #   information, see [Set the default instance warmup for an Auto Scaling
+    #   group][1] in the *Amazon EC2 Auto Scaling User Guide*.
+    #
+    #   To manage various warm-up settings at the group level, we recommend
+    #   that you set the default instance warmup, *even if it is set to 0
+    #   seconds*. To remove a value that you previously set, include the
     #   property but specify `-1` for the value. However, we strongly
     #   recommend keeping the default instance warmup enabled by specifying a
-    #   minimum value of `0`.
+    #   value of `0` or other nominal value.
     #
     #
     #
@@ -6803,7 +7008,7 @@ module Aws::AutoScaling
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-autoscaling'
-      context[:gem_version] = '1.85.0'
+      context[:gem_version] = '1.87.0'
       Seahorse::Client::Request.new(handlers, context)
     end