aws-sdk-autoscaling 1.66.0 → 1.67.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4702ef6e1a335ae90ba305208649171d24bc42d537b219ee01c7c04bd903cbf9
-  data.tar.gz: 6b89a9111eb65fda1e887a100bdf92f5047303d885feea6e203fd1c091b392ef
+  metadata.gz: 5104fda5773433b27e04ae91b9ceddf4e220efcb7049c30b2a71c3955cb93c71
+  data.tar.gz: 6f5ecad26fcc25e403bc01c38dd7a24bb271dc074af15ff60622cd9aae2a6937
 SHA512:
-  metadata.gz: 5e136023a7a45e2e98cae02b2ef42446c3bb09a70e6a9d921c6367870afa447de18ffb262f8a8d0b3bf3d2d48829b1f92fc1d081d4568db0d1215dcaa1feafc8
-  data.tar.gz: 5c02f08fb1157e8ec0659a1125db97a4ad63cc5bc3c9e65ab309d35eb6d7c8a28c27ca2975d27e1a3c203b41aa6c258a4dccc863bce1575c7a4d430c433153b1
+  metadata.gz: 1bdbfe065908ce73e36edb1be45019b45e12a0d1f687003cb7baea5590438095e7eca7463e8aec8b95823e4be226b2dba13237b33d2b00d578cf617e63f68d1c
+  data.tar.gz: f2a8d0f56fcf3da5572279dc4220123c1d55c6169e42f6db0b9b1c1d0f2c33446028418daaabf4b8b93af34cdffb67b98ee1a05b4b73133637325c094399f031

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.67.0 (2021-08-05)
+------------------
+
+* Feature - EC2 Auto Scaling adds configuration checks and Launch Template validation to Instance Refresh.
+
 1.66.0 (2021-07-30)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.66.0
+1.67.0

data/lib/aws-sdk-autoscaling.rb

@@ -59,6 +59,6 @@ require_relative 'aws-sdk-autoscaling/customizations'
 # @!group service
 module Aws::AutoScaling
 
-  GEM_VERSION = '1.66.0'
+  GEM_VERSION = '1.67.0'
 
 end

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

@@ -2440,6 +2440,30 @@ module Aws::AutoScaling
     #   resp.instance_refreshes[0].progress_details.live_pool_progress.instances_to_update #=> Integer
     #   resp.instance_refreshes[0].progress_details.warm_pool_progress.percentage_complete #=> Integer
     #   resp.instance_refreshes[0].progress_details.warm_pool_progress.instances_to_update #=> Integer
+    #   resp.instance_refreshes[0].preferences.min_healthy_percentage #=> Integer
+    #   resp.instance_refreshes[0].preferences.instance_warmup #=> Integer
+    #   resp.instance_refreshes[0].preferences.checkpoint_percentages #=> Array
+    #   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].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
+    #   resp.instance_refreshes[0].desired_configuration.mixed_instances_policy.launch_template.launch_template_specification.launch_template_id #=> String
+    #   resp.instance_refreshes[0].desired_configuration.mixed_instances_policy.launch_template.launch_template_specification.launch_template_name #=> String
+    #   resp.instance_refreshes[0].desired_configuration.mixed_instances_policy.launch_template.launch_template_specification.version #=> String
+    #   resp.instance_refreshes[0].desired_configuration.mixed_instances_policy.launch_template.overrides #=> Array
+    #   resp.instance_refreshes[0].desired_configuration.mixed_instances_policy.launch_template.overrides[0].instance_type #=> String
+    #   resp.instance_refreshes[0].desired_configuration.mixed_instances_policy.launch_template.overrides[0].weighted_capacity #=> String
+    #   resp.instance_refreshes[0].desired_configuration.mixed_instances_policy.launch_template.overrides[0].launch_template_specification.launch_template_id #=> String
+    #   resp.instance_refreshes[0].desired_configuration.mixed_instances_policy.launch_template.overrides[0].launch_template_specification.launch_template_name #=> String
+    #   resp.instance_refreshes[0].desired_configuration.mixed_instances_policy.launch_template.overrides[0].launch_template_specification.version #=> String
+    #   resp.instance_refreshes[0].desired_configuration.mixed_instances_policy.instances_distribution.on_demand_allocation_strategy #=> String
+    #   resp.instance_refreshes[0].desired_configuration.mixed_instances_policy.instances_distribution.on_demand_base_capacity #=> Integer
+    #   resp.instance_refreshes[0].desired_configuration.mixed_instances_policy.instances_distribution.on_demand_percentage_above_base_capacity #=> Integer
+    #   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.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeInstanceRefreshes AWS API Documentation
@@ -5362,13 +5386,19 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
-    # Starts a new instance refresh operation, which triggers a rolling
-    # replacement of previously launched instances in the Auto Scaling group
-    # with a new group of instances.
+    # 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
+    # temporarily reduces the capacity available within your Auto Scaling
+    # group.
     #
     # 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.
+    # Scaling group. This feature is helpful, for example, when you have a
+    # new AMI or a new user data script. You just need to create a new
+    # launch template that specifies the new AMI or user data script. Then
+    # 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,
@@ -5388,27 +5418,33 @@ module Aws::AutoScaling
     #   The strategy to use for the instance refresh. The only valid value is
     #   `Rolling`.
     #
-    #   A rolling update is an update that is applied to all instances in an
-    #   Auto Scaling group until all instances have been updated. A 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 were already replaced are not rolled back to
-    #   their previous configuration.
-    #
-    # @option params [Types::RefreshPreferences] :preferences
-    #   Set of preferences associated with the instance refresh request.
+    #   fails, any instances that are replaced are not rolled back to their
+    #   previous configuration.
     #
-    #   If not provided, the default values are used. For
-    #   `MinHealthyPercentage`, the default value is `90`. For
-    #   `InstanceWarmup`, the default is to use the value specified for the
-    #   health check grace period for the Auto Scaling group.
+    # @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
+    #   template.
     #
-    #   For more information, see [RefreshPreferences][1] in the *Amazon EC2
-    #   Auto Scaling API Reference*.
+    #   Once the instance refresh succeeds, Amazon EC2 Auto Scaling updates
+    #   the settings of the Auto Scaling group to reflect the new desired
+    #   configuration.
     #
+    #   <note markdown="1"> When you specify a new launch template or a new version of the current
+    #   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.
     #
+    #    </note>
     #
-    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_RefreshPreferences.html
+    # @option params [Types::RefreshPreferences] :preferences
+    #   Set of preferences associated with the instance refresh request. If
+    #   not provided, the default values are used.
     #
     # @return [Types::StartInstanceRefreshAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5437,11 +5473,47 @@ module Aws::AutoScaling
     #   resp = client.start_instance_refresh({
     #     auto_scaling_group_name: "XmlStringMaxLen255", # required
     #     strategy: "Rolling", # accepts Rolling
+    #     desired_configuration: {
+    #       launch_template: {
+    #         launch_template_id: "XmlStringMaxLen255",
+    #         launch_template_name: "LaunchTemplateName",
+    #         version: "XmlStringMaxLen255",
+    #       },
+    #       mixed_instances_policy: {
+    #         launch_template: {
+    #           launch_template_specification: {
+    #             launch_template_id: "XmlStringMaxLen255",
+    #             launch_template_name: "LaunchTemplateName",
+    #             version: "XmlStringMaxLen255",
+    #           },
+    #           overrides: [
+    #             {
+    #               instance_type: "XmlStringMaxLen255",
+    #               weighted_capacity: "XmlStringMaxLen32",
+    #               launch_template_specification: {
+    #                 launch_template_id: "XmlStringMaxLen255",
+    #                 launch_template_name: "LaunchTemplateName",
+    #                 version: "XmlStringMaxLen255",
+    #               },
+    #             },
+    #           ],
+    #         },
+    #         instances_distribution: {
+    #           on_demand_allocation_strategy: "XmlString",
+    #           on_demand_base_capacity: 1,
+    #           on_demand_percentage_above_base_capacity: 1,
+    #           spot_allocation_strategy: "XmlString",
+    #           spot_instance_pools: 1,
+    #           spot_max_price: "MixedInstanceSpotPrice",
+    #         },
+    #       },
+    #     },
     #     preferences: {
     #       min_healthy_percentage: 1,
     #       instance_warmup: 1,
     #       checkpoint_percentages: [1],
     #       checkpoint_delay: 1,
+    #       skip_matching: false,
     #     },
     #   })
     #
@@ -5918,7 +5990,7 @@ module Aws::AutoScaling
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-autoscaling'
-      context[:gem_version] = '1.66.0'
+      context[:gem_version] = '1.67.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -105,6 +105,7 @@ module Aws::AutoScaling
     DescribeTerminationPolicyTypesAnswer = Shapes::StructureShape.new(name: 'DescribeTerminationPolicyTypesAnswer')
     DescribeWarmPoolAnswer = Shapes::StructureShape.new(name: 'DescribeWarmPoolAnswer')
     DescribeWarmPoolType = Shapes::StructureShape.new(name: 'DescribeWarmPoolType')
+    DesiredConfiguration = Shapes::StructureShape.new(name: 'DesiredConfiguration')
     DetachInstancesAnswer = Shapes::StructureShape.new(name: 'DetachInstancesAnswer')
     DetachInstancesQuery = Shapes::StructureShape.new(name: 'DetachInstancesQuery')
     DetachLoadBalancerTargetGroupsResultType = Shapes::StructureShape.new(name: 'DetachLoadBalancerTargetGroupsResultType')
@@ -282,6 +283,7 @@ module Aws::AutoScaling
     SetInstanceProtectionQuery = Shapes::StructureShape.new(name: 'SetInstanceProtectionQuery')
     ShouldDecrementDesiredCapacity = Shapes::BooleanShape.new(name: 'ShouldDecrementDesiredCapacity')
     ShouldRespectGracePeriod = Shapes::BooleanShape.new(name: 'ShouldRespectGracePeriod')
+    SkipMatching = Shapes::BooleanShape.new(name: 'SkipMatching')
     SpotInstancePools = Shapes::IntegerShape.new(name: 'SpotInstancePools')
     SpotPrice = Shapes::StringShape.new(name: 'SpotPrice')
     StartInstanceRefreshAnswer = Shapes::StructureShape.new(name: 'StartInstanceRefreshAnswer')
@@ -687,6 +689,10 @@ module Aws::AutoScaling
     DescribeWarmPoolType.add_member(:next_token, Shapes::ShapeRef.new(shape: XmlString, location_name: "NextToken"))
     DescribeWarmPoolType.struct_class = Types::DescribeWarmPoolType
 
+    DesiredConfiguration.add_member(:launch_template, Shapes::ShapeRef.new(shape: LaunchTemplateSpecification, location_name: "LaunchTemplate"))
+    DesiredConfiguration.add_member(:mixed_instances_policy, Shapes::ShapeRef.new(shape: MixedInstancesPolicy, location_name: "MixedInstancesPolicy"))
+    DesiredConfiguration.struct_class = Types::DesiredConfiguration
+
     DetachInstancesAnswer.add_member(:activities, Shapes::ShapeRef.new(shape: Activities, location_name: "Activities"))
     DetachInstancesAnswer.struct_class = Types::DetachInstancesAnswer
 
@@ -807,6 +813,8 @@ module Aws::AutoScaling
     InstanceRefresh.add_member(:percentage_complete, Shapes::ShapeRef.new(shape: IntPercent, location_name: "PercentageComplete"))
     InstanceRefresh.add_member(:instances_to_update, Shapes::ShapeRef.new(shape: InstancesToUpdate, location_name: "InstancesToUpdate"))
     InstanceRefresh.add_member(:progress_details, Shapes::ShapeRef.new(shape: InstanceRefreshProgressDetails, location_name: "ProgressDetails"))
+    InstanceRefresh.add_member(:preferences, Shapes::ShapeRef.new(shape: RefreshPreferences, location_name: "Preferences"))
+    InstanceRefresh.add_member(:desired_configuration, Shapes::ShapeRef.new(shape: DesiredConfiguration, location_name: "DesiredConfiguration"))
     InstanceRefresh.struct_class = Types::InstanceRefresh
 
     InstanceRefreshIds.member = Shapes::ShapeRef.new(shape: XmlStringMaxLen255)
@@ -1096,6 +1104,7 @@ module Aws::AutoScaling
     RefreshPreferences.add_member(:instance_warmup, Shapes::ShapeRef.new(shape: RefreshInstanceWarmup, location_name: "InstanceWarmup"))
     RefreshPreferences.add_member(:checkpoint_percentages, Shapes::ShapeRef.new(shape: CheckpointPercentages, location_name: "CheckpointPercentages"))
     RefreshPreferences.add_member(:checkpoint_delay, Shapes::ShapeRef.new(shape: CheckpointDelay, location_name: "CheckpointDelay"))
+    RefreshPreferences.add_member(:skip_matching, Shapes::ShapeRef.new(shape: SkipMatching, location_name: "SkipMatching"))
     RefreshPreferences.struct_class = Types::RefreshPreferences
 
     ResourceContentionFault.add_member(:message, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "message"))
@@ -1191,6 +1200,7 @@ module Aws::AutoScaling
 
     StartInstanceRefreshType.add_member(:auto_scaling_group_name, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, required: true, location_name: "AutoScalingGroupName"))
     StartInstanceRefreshType.add_member(:strategy, Shapes::ShapeRef.new(shape: RefreshStrategy, location_name: "Strategy"))
+    StartInstanceRefreshType.add_member(:desired_configuration, Shapes::ShapeRef.new(shape: DesiredConfiguration, location_name: "DesiredConfiguration"))
     StartInstanceRefreshType.add_member(:preferences, Shapes::ShapeRef.new(shape: RefreshPreferences, location_name: "Preferences"))
     StartInstanceRefreshType.struct_class = Types::StartInstanceRefreshType
 

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

@@ -2543,6 +2543,83 @@ module Aws::AutoScaling
       include Aws::Structure
     end
 
+    # Describes the desired configuration for an instance refresh.
+    #
+    # If you specify a desired configuration, you must specify either a
+    # `LaunchTemplate` or a `MixedInstancesPolicy`.
+    #
+    # @note When making an API call, you may pass DesiredConfiguration
+    #   data as a hash:
+    #
+    #       {
+    #         launch_template: {
+    #           launch_template_id: "XmlStringMaxLen255",
+    #           launch_template_name: "LaunchTemplateName",
+    #           version: "XmlStringMaxLen255",
+    #         },
+    #         mixed_instances_policy: {
+    #           launch_template: {
+    #             launch_template_specification: {
+    #               launch_template_id: "XmlStringMaxLen255",
+    #               launch_template_name: "LaunchTemplateName",
+    #               version: "XmlStringMaxLen255",
+    #             },
+    #             overrides: [
+    #               {
+    #                 instance_type: "XmlStringMaxLen255",
+    #                 weighted_capacity: "XmlStringMaxLen32",
+    #                 launch_template_specification: {
+    #                   launch_template_id: "XmlStringMaxLen255",
+    #                   launch_template_name: "LaunchTemplateName",
+    #                   version: "XmlStringMaxLen255",
+    #                 },
+    #               },
+    #             ],
+    #           },
+    #           instances_distribution: {
+    #             on_demand_allocation_strategy: "XmlString",
+    #             on_demand_base_capacity: 1,
+    #             on_demand_percentage_above_base_capacity: 1,
+    #             spot_allocation_strategy: "XmlString",
+    #             spot_instance_pools: 1,
+    #             spot_max_price: "MixedInstanceSpotPrice",
+    #           },
+    #         },
+    #       }
+    #
+    # @!attribute [rw] launch_template
+    #   Describes the launch template and the version of the launch template
+    #   that Amazon EC2 Auto Scaling uses to launch Amazon EC2 instances.
+    #   For more information about launch templates, see [Launch
+    #   templates][1] in the *Amazon EC2 Auto Scaling User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/LaunchTemplates.html
+    #   @return [Types::LaunchTemplateSpecification]
+    #
+    # @!attribute [rw] mixed_instances_policy
+    #   Describes a mixed instances policy. A mixed instances policy
+    #   contains the instance types Amazon EC2 Auto Scaling can launch, and
+    #   other information Amazon EC2 Auto Scaling can use to launch
+    #   instances to help you optimize your costs. For more information, see
+    #   [Auto Scaling groups with multiple instance types and purchase
+    #   options][1] in the *Amazon EC2 Auto Scaling User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
+    #   @return [Types::MixedInstancesPolicy]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DesiredConfiguration AWS API Documentation
+    #
+    class DesiredConfiguration < Struct.new(
+      :launch_template,
+      :mixed_instances_policy)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] activities
     #   The activities related to detaching the instances from the Auto
     #   Scaling group.
@@ -3484,6 +3561,14 @@ module Aws::AutoScaling
     #   warm pool.
     #   @return [Types::InstanceRefreshProgressDetails]
     #
+    # @!attribute [rw] preferences
+    #   Describes the preferences for an instance refresh.
+    #   @return [Types::RefreshPreferences]
+    #
+    # @!attribute [rw] desired_configuration
+    #   Describes the specific update you want to deploy.
+    #   @return [Types::DesiredConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/InstanceRefresh AWS API Documentation
     #
     class InstanceRefresh < Struct.new(
@@ -3495,7 +3580,9 @@ module Aws::AutoScaling
       :end_time,
       :percentage_complete,
       :instances_to_update,
-      :progress_details)
+      :progress_details,
+      :preferences,
+      :desired_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3595,14 +3682,15 @@ module Aws::AutoScaling
     # Instances, and how the Auto Scaling group allocates instance types to
     # fulfill On-Demand and Spot capacities.
     #
-    # When you update `SpotAllocationStrategy`, `SpotInstancePools`, or
-    # `SpotMaxPrice`, this update action does not deploy any changes across
-    # the running Amazon EC2 instances in the group. Your existing Spot
-    # Instances continue to run as long as the maximum price for those
-    # instances is higher than the current Spot price. When scale out
-    # occurs, Amazon EC2 Auto Scaling launches instances based on the new
-    # settings. When scale in occurs, Amazon EC2 Auto Scaling terminates
-    # instances according to the group's termination policies.
+    # When you modify `SpotAllocationStrategy`, `SpotInstancePools`, or
+    # `SpotMaxPrice` in the UpdateAutoScalingGroup API call, this update
+    # action does not deploy any changes across the running Amazon EC2
+    # instances in the group. Your existing Spot Instances continue to run
+    # as long as the maximum price for those instances is higher than the
+    # current Spot price. When scale out occurs, Amazon EC2 Auto Scaling
+    # launches instances based on the new settings. When scale in occurs,
+    # Amazon EC2 Auto Scaling terminates instances according to the group's
+    # termination policies.
     #
     # @note When making an API call, you may pass InstancesDistribution
     #   data as a hash:
@@ -4009,11 +4097,12 @@ module Aws::AutoScaling
     #
     # You specify these properties as part of a mixed instances policy.
     #
-    # When you update the launch template or overrides, existing Amazon EC2
-    # instances continue to run. When scale out occurs, Amazon EC2 Auto
-    # Scaling launches instances to match the new settings. When scale in
-    # occurs, Amazon EC2 Auto Scaling terminates instances according to the
-    # group's termination policies.
+    # When you update the launch template or overrides in the
+    # UpdateAutoScalingGroup API call, existing Amazon EC2 instances
+    # continue to run. When scale out occurs, Amazon EC2 Auto Scaling
+    # launches instances to match the new settings. When scale in occurs,
+    # Amazon EC2 Auto Scaling terminates instances according to the group's
+    # termination policies.
     #
     # @note When making an API call, you may pass LaunchTemplate
     #   data as a hash:
@@ -4136,18 +4225,14 @@ module Aws::AutoScaling
       include Aws::Structure
     end
 
-    # Describes the Amazon EC2 launch template and the launch template
-    # version that can be used by an Auto Scaling group to configure Amazon
-    # EC2 instances.
-    #
-    # The launch template that is specified must be configured for use with
-    # an Auto Scaling group. For more information, see [Creating a launch
-    # template for an Auto Scaling group][1] in the *Amazon EC2 Auto Scaling
-    # User Guide*.
+    # Describes the launch template and the version of the launch template
+    # that Amazon EC2 Auto Scaling uses to launch Amazon EC2 instances. For
+    # more information about launch templates, see [Launch templates][1] in
+    # the *Amazon EC2 Auto Scaling User Guide*.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-template.html
+    # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/LaunchTemplates.html
     #
     # @note When making an API call, you may pass LaunchTemplateSpecification
     #   data as a hash:
@@ -4613,17 +4698,12 @@ module Aws::AutoScaling
       include Aws::Structure
     end
 
-    # Describes a mixed instances policy for an Auto Scaling group. With
-    # mixed instances, your Auto Scaling group can provision a combination
-    # of On-Demand Instances and Spot Instances across multiple instance
-    # types. For more information, see [Auto Scaling groups with multiple
-    # instance types and purchase options][1] in the *Amazon EC2 Auto
-    # Scaling User Guide*.
-    #
-    # You can create a mixed instances policy for a new Auto Scaling group,
-    # or you can create it for an existing group by updating the group to
-    # specify `MixedInstancesPolicy` as the top-level property instead of a
-    # launch configuration or launch template.
+    # Describes a mixed instances policy. A mixed instances policy contains
+    # the instance types Amazon EC2 Auto Scaling can launch, and other
+    # information Amazon EC2 Auto Scaling can use to launch instances to
+    # help you optimize your costs. For more information, see [Auto Scaling
+    # groups with multiple instance types and purchase options][1] in the
+    # *Amazon EC2 Auto Scaling User Guide*.
     #
     #
     #
@@ -4662,10 +4742,10 @@ module Aws::AutoScaling
     #       }
     #
     # @!attribute [rw] launch_template
-    #   Specifies the launch template to use and optionally the instance
-    #   types (overrides) that are used to provision EC2 instances to
-    #   fulfill On-Demand and Spot capacities. Required when creating a
-    #   mixed instances policy.
+    #   Specifies the launch template to use and the instance types
+    #   (overrides) that are used to provision EC2 instances to fulfill
+    #   On-Demand and Spot capacities. Required when creating a mixed
+    #   instances policy.
     #   @return [Types::LaunchTemplate]
     #
     # @!attribute [rw] instances_distribution
@@ -5856,11 +5936,7 @@ module Aws::AutoScaling
       include Aws::Structure
     end
 
-    # Describes information used to start an instance refresh.
-    #
-    # All properties are optional. However, if you specify a value for
-    # `CheckpointDelay`, you must also provide a value for
-    # `CheckpointPercentages`.
+    # Describes the preferences for an instance refresh.
     #
     # @note When making an API call, you may pass RefreshPreferences
     #   data as a hash:
@@ -5870,14 +5946,20 @@ module Aws::AutoScaling
     #         instance_warmup: 1,
     #         checkpoint_percentages: [1],
     #         checkpoint_delay: 1,
+    #         skip_matching: false,
     #       }
     #
     # @!attribute [rw] min_healthy_percentage
     #   The amount of capacity in the Auto Scaling group that must remain
     #   healthy during an instance refresh to allow the operation to
-    #   continue, as a percentage of the desired capacity of the Auto
-    #   Scaling group (rounded up to the nearest integer). The default is
-    #   `90`.
+    #   continue. The value is expressed as a percentage of the desired
+    #   capacity of the Auto Scaling group (rounded up to the nearest
+    #   integer). The default is `90`.
+    #
+    #   Setting the minimum healthy percentage to 100 percent limits the
+    #   rate of replacement to one instance at a time. In contrast, setting
+    #   it to 0 percent has the effect of replacing all instances at the
+    #   same time.
     #   @return [Integer]
     #
     # @!attribute [rw] instance_warmup
@@ -5909,13 +5991,23 @@ module Aws::AutoScaling
     #   hour).
     #   @return [Integer]
     #
+    # @!attribute [rw] skip_matching
+    #   A boolean value that indicates whether skip matching is enabled. If
+    #   true, then Amazon EC2 Auto Scaling skips replacing instances that
+    #   match the desired configuration. If no desired configuration is
+    #   specified, then it skips replacing instances that have the same
+    #   configuration that is already set on the group. The default is
+    #   `false`.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/RefreshPreferences AWS API Documentation
     #
     class RefreshPreferences < Struct.new(
       :min_healthy_percentage,
       :instance_warmup,
       :checkpoint_percentages,
-      :checkpoint_delay)
+      :checkpoint_delay,
+      :skip_matching)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -6463,11 +6555,47 @@ module Aws::AutoScaling
     #       {
     #         auto_scaling_group_name: "XmlStringMaxLen255", # required
     #         strategy: "Rolling", # accepts Rolling
+    #         desired_configuration: {
+    #           launch_template: {
+    #             launch_template_id: "XmlStringMaxLen255",
+    #             launch_template_name: "LaunchTemplateName",
+    #             version: "XmlStringMaxLen255",
+    #           },
+    #           mixed_instances_policy: {
+    #             launch_template: {
+    #               launch_template_specification: {
+    #                 launch_template_id: "XmlStringMaxLen255",
+    #                 launch_template_name: "LaunchTemplateName",
+    #                 version: "XmlStringMaxLen255",
+    #               },
+    #               overrides: [
+    #                 {
+    #                   instance_type: "XmlStringMaxLen255",
+    #                   weighted_capacity: "XmlStringMaxLen32",
+    #                   launch_template_specification: {
+    #                     launch_template_id: "XmlStringMaxLen255",
+    #                     launch_template_name: "LaunchTemplateName",
+    #                     version: "XmlStringMaxLen255",
+    #                   },
+    #                 },
+    #               ],
+    #             },
+    #             instances_distribution: {
+    #               on_demand_allocation_strategy: "XmlString",
+    #               on_demand_base_capacity: 1,
+    #               on_demand_percentage_above_base_capacity: 1,
+    #               spot_allocation_strategy: "XmlString",
+    #               spot_instance_pools: 1,
+    #               spot_max_price: "MixedInstanceSpotPrice",
+    #             },
+    #           },
+    #         },
     #         preferences: {
     #           min_healthy_percentage: 1,
     #           instance_warmup: 1,
     #           checkpoint_percentages: [1],
     #           checkpoint_delay: 1,
+    #           skip_matching: false,
     #         },
     #       }
     #
@@ -6479,28 +6607,36 @@ module Aws::AutoScaling
     #   The strategy to use for the instance refresh. The only valid value
     #   is `Rolling`.
     #
-    #   A rolling update is an update that is applied to all instances in an
-    #   Auto Scaling group until all instances have been updated. 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 were already replaced are not
-    #   rolled back to their previous configuration.
+    #   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.
     #   @return [String]
     #
-    # @!attribute [rw] preferences
-    #   Set of preferences associated with the instance refresh request.
-    #
-    #   If not provided, the default values are used. For
-    #   `MinHealthyPercentage`, the default value is `90`. For
-    #   `InstanceWarmup`, the default is to use the value specified for the
-    #   health check grace period for the Auto Scaling group.
+    # @!attribute [rw] desired_configuration
+    #   The desired configuration. For example, the desired configuration
+    #   can specify a new launch template or a new version of the current
+    #   launch template.
     #
-    #   For more information, see [RefreshPreferences][1] in the *Amazon EC2
-    #   Auto Scaling API Reference*.
+    #   Once the instance refresh succeeds, Amazon EC2 Auto Scaling updates
+    #   the settings of the Auto Scaling group to reflect the new desired
+    #   configuration.
     #
+    #   <note markdown="1"> When you specify a new launch template or a new version of the
+    #   current 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.
     #
+    #    </note>
+    #   @return [Types::DesiredConfiguration]
     #
-    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_RefreshPreferences.html
+    # @!attribute [rw] preferences
+    #   Set of preferences associated with the instance refresh request. If
+    #   not provided, the default values are used.
     #   @return [Types::RefreshPreferences]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/StartInstanceRefreshType AWS API Documentation
@@ -6508,6 +6644,7 @@ module Aws::AutoScaling
     class StartInstanceRefreshType < Struct.new(
       :auto_scaling_group_name,
       :strategy,
+      :desired_configuration,
       :preferences)
       SENSITIVE = []
       include Aws::Structure

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-autoscaling
 version: !ruby/object:Gem::Version
-  version: 1.66.0
+  version: 1.67.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-30 00:00:00.000000000 Z
+date: 2021-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core