aws-sdk-autoscaling 1.63.0 → 1.67.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fa23b3aa0e790969199b109aea0235abeb79a955ffd8508e4057c9f21a42d0ef
-  data.tar.gz: 7f0f7b1c8b761b32cb5c01e5f62f252de21275b2cdde96dcad41ef30eb099b5a
+  metadata.gz: 5104fda5773433b27e04ae91b9ceddf4e220efcb7049c30b2a71c3955cb93c71
+  data.tar.gz: 6f5ecad26fcc25e403bc01c38dd7a24bb271dc074af15ff60622cd9aae2a6937
 SHA512:
-  metadata.gz: 5dee637f5d1f37ae0ed7abd16c4f3f0a92f99836a01cb8cbe39c6191e37c2e0a5c112d44d64f11027866ebcab40c62bbe27916520228fca76afc395e9cf4a65c
-  data.tar.gz: 865c5ca821e97bf8f3967d838e195b3db94c9c79593efaa491786964b1c6304c40bf0d307ea46d64b28ab45999b1153eab9c0a1349154cd89707073a7cd65f00
+  metadata.gz: 1bdbfe065908ce73e36edb1be45019b45e12a0d1f687003cb7baea5590438095e7eca7463e8aec8b95823e4be226b2dba13237b33d2b00d578cf617e63f68d1c
+  data.tar.gz: f2a8d0f56fcf3da5572279dc4220123c1d55c6169e42f6db0b9b1c1d0f2c33446028418daaabf4b8b93af34cdffb67b98ee1a05b4b73133637325c094399f031

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 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)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.65.0 (2021-07-28)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.64.0 (2021-06-30)
+------------------
+
+* Feature - Amazon EC2 Auto Scaling infrastructure improvements and optimizations.
+
 1.63.0 (2021-06-04)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.63.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.63.0'
+  GEM_VERSION = '1.67.0'
 
 end

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

@@ -212,6 +212,12 @@ module Aws::AutoScaling
       data[:warm_pool_size]
     end
 
+    # Reserved.
+    # @return [String]
+    def context
+      data[:context]
+    end
+
     # @!endgroup
 
     # @return [Client]
@@ -1031,6 +1037,7 @@ module Aws::AutoScaling
     #     service_linked_role_arn: "ResourceName",
     #     max_instance_lifetime: 1,
     #     capacity_rebalance: false,
+    #     context: "Context",
     #   })
     # @param [Hash] options ({})
     # @option options [String] :launch_configuration_name
@@ -1164,6 +1171,8 @@ module Aws::AutoScaling
     #
     #
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/capacity-rebalance.html
+    # @option options [String] :context
+    #   Reserved.
     # @return [AutoScalingGroup]
     def update(options = {})
       options = options.merge(auto_scaling_group_name: @name)

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

@@ -989,7 +989,7 @@ module Aws::AutoScaling
     #   The Amazon Resource Name (ARN) of the service-linked role that the
     #   Auto Scaling group uses to call other Amazon Web Services on your
     #   behalf. By default, Amazon EC2 Auto Scaling uses a service-linked role
-    #   named AWSServiceRoleForAutoScaling, which it creates if it does not
+    #   named `AWSServiceRoleForAutoScaling`, which it creates if it does not
     #   exist. For more information, see [Service-linked roles][1] in the
     #   *Amazon EC2 Auto Scaling User Guide*.
     #
@@ -1008,6 +1008,9 @@ module Aws::AutoScaling
     #
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-max-instance-lifetime.html
     #
+    # @option params [String] :context
+    #   Reserved.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     #
@@ -1163,6 +1166,7 @@ module Aws::AutoScaling
     #     ],
     #     service_linked_role_arn: "ResourceName",
     #     max_instance_lifetime: 1,
+    #     context: "Context",
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateAutoScalingGroup AWS API Documentation
@@ -1913,9 +1917,11 @@ module Aws::AutoScaling
     # Describes the current Amazon EC2 Auto Scaling resource quotas for your
     # account.
     #
-    # For information about requesting an increase, see [Amazon EC2 Auto
-    # Scaling service quotas][1] in the *Amazon EC2 Auto Scaling User
-    # Guide*.
+    # When you establish an account, the account has initial quotas on the
+    # maximum number of Auto Scaling groups and launch configurations that
+    # you can create in a given Region. For more information, see [Amazon
+    # EC2 Auto Scaling service quotas][1] in the *Amazon EC2 Auto Scaling
+    # User Guide*.
     #
     #
     #
@@ -2180,6 +2186,7 @@ module Aws::AutoScaling
     #   resp.auto_scaling_groups[0].warm_pool_configuration.pool_state #=> String, one of "Stopped", "Running"
     #   resp.auto_scaling_groups[0].warm_pool_configuration.status #=> String, one of "PendingDelete"
     #   resp.auto_scaling_groups[0].warm_pool_size #=> Integer
+    #   resp.auto_scaling_groups[0].context #=> String
     #   resp.next_token #=> String
     #
     #
@@ -2433,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
@@ -5355,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,
@@ -5381,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.
+    #   fails, any instances that are replaced are not rolled back to their
+    #   previous configuration.
     #
-    # @option params [Types::RefreshPreferences] :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.
+    # @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:
     #
@@ -5430,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,
     #     },
     #   })
     #
@@ -5800,6 +5879,9 @@ module Aws::AutoScaling
     #
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/capacity-rebalance.html
     #
+    # @option params [String] :context
+    #   Reserved.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     #
@@ -5883,6 +5965,7 @@ module Aws::AutoScaling
     #     service_linked_role_arn: "ResourceName",
     #     max_instance_lifetime: 1,
     #     capacity_rebalance: false,
+    #     context: "Context",
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/UpdateAutoScalingGroup AWS API Documentation
@@ -5907,7 +5990,7 @@ module Aws::AutoScaling
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-autoscaling'
-      context[:gem_version] = '1.63.0'
+      context[:gem_version] = '1.67.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -67,6 +67,7 @@ module Aws::AutoScaling
     ClassicLinkVPCSecurityGroups = Shapes::ListShape.new(name: 'ClassicLinkVPCSecurityGroups')
     CompleteLifecycleActionAnswer = Shapes::StructureShape.new(name: 'CompleteLifecycleActionAnswer')
     CompleteLifecycleActionType = Shapes::StructureShape.new(name: 'CompleteLifecycleActionType')
+    Context = Shapes::StringShape.new(name: 'Context')
     Cooldown = Shapes::IntegerShape.new(name: 'Cooldown')
     CreateAutoScalingGroupType = Shapes::StructureShape.new(name: 'CreateAutoScalingGroupType')
     CreateLaunchConfigurationType = Shapes::StructureShape.new(name: 'CreateLaunchConfigurationType')
@@ -104,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')
@@ -281,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')
@@ -407,6 +410,7 @@ module Aws::AutoScaling
     AutoScalingGroup.add_member(:capacity_rebalance, Shapes::ShapeRef.new(shape: CapacityRebalanceEnabled, location_name: "CapacityRebalance"))
     AutoScalingGroup.add_member(:warm_pool_configuration, Shapes::ShapeRef.new(shape: WarmPoolConfiguration, location_name: "WarmPoolConfiguration"))
     AutoScalingGroup.add_member(:warm_pool_size, Shapes::ShapeRef.new(shape: WarmPoolSize, location_name: "WarmPoolSize"))
+    AutoScalingGroup.add_member(:context, Shapes::ShapeRef.new(shape: Context, location_name: "Context"))
     AutoScalingGroup.struct_class = Types::AutoScalingGroup
 
     AutoScalingGroupNames.member = Shapes::ShapeRef.new(shape: XmlStringMaxLen255)
@@ -512,6 +516,7 @@ module Aws::AutoScaling
     CreateAutoScalingGroupType.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "Tags"))
     CreateAutoScalingGroupType.add_member(:service_linked_role_arn, Shapes::ShapeRef.new(shape: ResourceName, location_name: "ServiceLinkedRoleARN"))
     CreateAutoScalingGroupType.add_member(:max_instance_lifetime, Shapes::ShapeRef.new(shape: MaxInstanceLifetime, location_name: "MaxInstanceLifetime"))
+    CreateAutoScalingGroupType.add_member(:context, Shapes::ShapeRef.new(shape: Context, location_name: "Context"))
     CreateAutoScalingGroupType.struct_class = Types::CreateAutoScalingGroupType
 
     CreateLaunchConfigurationType.add_member(:launch_configuration_name, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, required: true, location_name: "LaunchConfigurationName"))
@@ -684,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
 
@@ -804,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)
@@ -1093,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"))
@@ -1188,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
 
@@ -1258,6 +1271,7 @@ module Aws::AutoScaling
     UpdateAutoScalingGroupType.add_member(:service_linked_role_arn, Shapes::ShapeRef.new(shape: ResourceName, location_name: "ServiceLinkedRoleARN"))
     UpdateAutoScalingGroupType.add_member(:max_instance_lifetime, Shapes::ShapeRef.new(shape: MaxInstanceLifetime, location_name: "MaxInstanceLifetime"))
     UpdateAutoScalingGroupType.add_member(:capacity_rebalance, Shapes::ShapeRef.new(shape: CapacityRebalanceEnabled, location_name: "CapacityRebalance"))
+    UpdateAutoScalingGroupType.add_member(:context, Shapes::ShapeRef.new(shape: Context, location_name: "Context"))
     UpdateAutoScalingGroupType.struct_class = Types::UpdateAutoScalingGroupType
 
     Values.member = Shapes::ShapeRef.new(shape: XmlString)

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

@@ -110,6 +110,7 @@ module Aws::AutoScaling
     #     ],
     #     service_linked_role_arn: "ResourceName",
     #     max_instance_lifetime: 1,
+    #     context: "Context",
     #   })
     # @param [Hash] options ({})
     # @option options [required, String] :auto_scaling_group_name
@@ -321,7 +322,7 @@ module Aws::AutoScaling
     #   The Amazon Resource Name (ARN) of the service-linked role that the
     #   Auto Scaling group uses to call other Amazon Web Services on your
     #   behalf. By default, Amazon EC2 Auto Scaling uses a service-linked role
-    #   named AWSServiceRoleForAutoScaling, which it creates if it does not
+    #   named `AWSServiceRoleForAutoScaling`, which it creates if it does not
     #   exist. For more information, see [Service-linked roles][1] in the
     #   *Amazon EC2 Auto Scaling User Guide*.
     #
@@ -338,6 +339,8 @@ module Aws::AutoScaling
     #
     #
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-max-instance-lifetime.html
+    # @option options [String] :context
+    #   Reserved.
     # @return [AutoScalingGroup]
     def create_group(options = {})
       @client.create_auto_scaling_group(options)

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

@@ -407,6 +407,10 @@ module Aws::AutoScaling
     #   The current size of the warm pool.
     #   @return [Integer]
     #
+    # @!attribute [rw] context
+    #   Reserved.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AutoScalingGroup AWS API Documentation
     #
     class AutoScalingGroup < Struct.new(
@@ -439,7 +443,8 @@ module Aws::AutoScaling
       :max_instance_lifetime,
       :capacity_rebalance,
       :warm_pool_configuration,
-      :warm_pool_size)
+      :warm_pool_size,
+      :context)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -939,6 +944,7 @@ module Aws::AutoScaling
     #         ],
     #         service_linked_role_arn: "ResourceName",
     #         max_instance_lifetime: 1,
+    #         context: "Context",
     #       }
     #
     # @!attribute [rw] auto_scaling_group_name
@@ -1197,9 +1203,9 @@ module Aws::AutoScaling
     #   The Amazon Resource Name (ARN) of the service-linked role that the
     #   Auto Scaling group uses to call other Amazon Web Services on your
     #   behalf. By default, Amazon EC2 Auto Scaling uses a service-linked
-    #   role named AWSServiceRoleForAutoScaling, which it creates if it does
-    #   not exist. For more information, see [Service-linked roles][1] in
-    #   the *Amazon EC2 Auto Scaling User Guide*.
+    #   role named `AWSServiceRoleForAutoScaling`, which it creates if it
+    #   does not exist. For more information, see [Service-linked roles][1]
+    #   in the *Amazon EC2 Auto Scaling User Guide*.
     #
     #
     #
@@ -1219,6 +1225,10 @@ module Aws::AutoScaling
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-max-instance-lifetime.html
     #   @return [Integer]
     #
+    # @!attribute [rw] context
+    #   Reserved.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateAutoScalingGroupType AWS API Documentation
     #
     class CreateAutoScalingGroupType < Struct.new(
@@ -1244,7 +1254,8 @@ module Aws::AutoScaling
       :lifecycle_hook_specification_list,
       :tags,
       :service_linked_role_arn,
-      :max_instance_lifetime)
+      :max_instance_lifetime,
+      :context)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2532,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.
@@ -2798,16 +2886,16 @@ module Aws::AutoScaling
     #   encryption value. Volumes that are created from encrypted snapshots
     #   are automatically encrypted, and volumes that are created from
     #   unencrypted snapshots are automatically unencrypted. By default,
-    #   encrypted snapshots use the AWS managed CMK that is used for EBS
-    #   encryption, but you can specify a custom CMK when you create the
-    #   snapshot. The ability to encrypt a snapshot during copying also
-    #   allows you to apply a new CMK to an already-encrypted snapshot.
-    #   Volumes restored from the resulting copy are only accessible using
-    #   the new CMK.
+    #   encrypted snapshots use the Amazon Web Services managed CMK that is
+    #   used for EBS encryption, but you can specify a custom CMK when you
+    #   create the snapshot. The ability to encrypt a snapshot during
+    #   copying also allows you to apply a new CMK to an already-encrypted
+    #   snapshot. Volumes restored from the resulting copy are only
+    #   accessible using the new CMK.
     #
     #    Enabling [encryption by default][2] results in all EBS volumes being
-    #   encrypted with the AWS managed CMK or a customer managed CMK,
-    #   whether or not the snapshot was encrypted.
+    #   encrypted with the Amazon Web Services managed CMK or a customer
+    #   managed CMK, whether or not the snapshot was encrypted.
     #
     #    </note>
     #
@@ -3473,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(
@@ -3484,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
@@ -3584,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:
@@ -3998,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:
@@ -4125,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:
@@ -4602,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*.
     #
     #
     #
@@ -4651,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
@@ -4775,16 +4866,20 @@ module Aws::AutoScaling
     #   @return [String]
     #
     # @!attribute [rw] resource_label
-    #   Identifies the resource associated with the metric type. You can't
-    #   specify a resource label unless the metric type is
-    #   `ALBRequestCountPerTarget` and there is a target group attached to
-    #   the Auto Scaling group.
+    #   A label that uniquely identifies a specific Application Load
+    #   Balancer target group from which to determine the average request
+    #   count served by your Auto Scaling group. You can't specify a
+    #   resource label unless the target group is attached to the Auto
+    #   Scaling group.
     #
     #   You create the resource label by appending the final portion of the
     #   load balancer ARN and the final portion of the target group ARN into
-    #   a single value, separated by a forward slash (/). The format is
-    #   app/&lt;load-balancer-name&gt;/&lt;load-balancer-id&gt;/targetgroup/&lt;target-group-name&gt;/&lt;target-group-id&gt;,
-    #   where:
+    #   a single value, separated by a forward slash (/). The format of the
+    #   resource label is:
+    #
+    #   `app/my-alb/778d41231b141a0f/targetgroup/my-alb-target-group/943f017f100becff`.
+    #
+    #   Where:
     #
     #   * app/&lt;load-balancer-name&gt;/&lt;load-balancer-id&gt; is the
     #     final portion of the load balancer ARN
@@ -4792,9 +4887,6 @@ module Aws::AutoScaling
     #   * targetgroup/&lt;target-group-name&gt;/&lt;target-group-id&gt; is
     #     the final portion of the target group ARN.
     #
-    #   This is an example:
-    #   app/EC2Co-EcsEl-1TKLTMITMM0EO/f37c06a68c1748aa/targetgroup/EC2Co-Defau-LDNM7Q3ZH1ZN/6d4ea56ca2d6a18d.
-    #
     #   To find the ARN for an Application Load Balancer, use the
     #   [DescribeLoadBalancers][1] API operation. To find the ARN for the
     #   target group, use the [DescribeTargetGroups][2] API operation.
@@ -5034,7 +5126,7 @@ module Aws::AutoScaling
     #   a single value, separated by a forward slash (/). The format of the
     #   resource label is:
     #
-    #   `app/EC2Co-EcsEl-1TKLTMITMM0EO/f37c06a68c1748aa/targetgroup/EC2Co-Defau-LDNM7Q3ZH1ZN/6d4ea56ca2d6a18d`.
+    #   `app/my-alb/778d41231b141a0f/targetgroup/my-alb-target-group/943f017f100becff`.
     #
     #   Where:
     #
@@ -5084,16 +5176,17 @@ module Aws::AutoScaling
     #
     # @!attribute [rw] resource_label
     #   A label that uniquely identifies a specific Application Load
-    #   Balancer target group from which to determine the request count
-    #   served by your Auto Scaling group. You can't specify a resource
-    #   label unless the target group is attached to the Auto Scaling group.
+    #   Balancer target group from which to determine the total and average
+    #   request count served by your Auto Scaling group. You can't specify
+    #   a resource label unless the target group is attached to the Auto
+    #   Scaling group.
     #
     #   You create the resource label by appending the final portion of the
     #   load balancer ARN and the final portion of the target group ARN into
     #   a single value, separated by a forward slash (/). The format of the
     #   resource label is:
     #
-    #   `app/EC2Co-EcsEl-1TKLTMITMM0EO/f37c06a68c1748aa/targetgroup/EC2Co-Defau-LDNM7Q3ZH1ZN/6d4ea56ca2d6a18d`.
+    #   `app/my-alb/778d41231b141a0f/targetgroup/my-alb-target-group/943f017f100becff`.
     #
     #   Where:
     #
@@ -5142,16 +5235,17 @@ module Aws::AutoScaling
     #
     # @!attribute [rw] resource_label
     #   A label that uniquely identifies a specific Application Load
-    #   Balancer target group from which to determine the request count
-    #   served by your Auto Scaling group. You can't specify a resource
-    #   label unless the target group is attached to the Auto Scaling group.
+    #   Balancer target group from which to determine the average request
+    #   count served by your Auto Scaling group. You can't specify a
+    #   resource label unless the target group is attached to the Auto
+    #   Scaling group.
     #
     #   You create the resource label by appending the final portion of the
     #   load balancer ARN and the final portion of the target group ARN into
     #   a single value, separated by a forward slash (/). The format of the
     #   resource label is:
     #
-    #   `app/EC2Co-EcsEl-1TKLTMITMM0EO/f37c06a68c1748aa/targetgroup/EC2Co-Defau-LDNM7Q3ZH1ZN/6d4ea56ca2d6a18d`.
+    #   `app/my-alb/778d41231b141a0f/targetgroup/my-alb-target-group/943f017f100becff`.
     #
     #   Where:
     #
@@ -5842,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:
@@ -5856,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
@@ -5895,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
@@ -6449,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,
     #         },
     #       }
     #
@@ -6465,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
@@ -6494,6 +6644,7 @@ module Aws::AutoScaling
     class StartInstanceRefreshType < Struct.new(
       :auto_scaling_group_name,
       :strategy,
+      :desired_configuration,
       :preferences)
       SENSITIVE = []
       include Aws::Structure
@@ -6849,6 +7000,7 @@ module Aws::AutoScaling
     #         service_linked_role_arn: "ResourceName",
     #         max_instance_lifetime: 1,
     #         capacity_rebalance: false,
+    #         context: "Context",
     #       }
     #
     # @!attribute [rw] auto_scaling_group_name
@@ -7020,6 +7172,10 @@ module Aws::AutoScaling
     #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/capacity-rebalance.html
     #   @return [Boolean]
     #
+    # @!attribute [rw] context
+    #   Reserved.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/UpdateAutoScalingGroupType AWS API Documentation
     #
     class UpdateAutoScalingGroupType < Struct.new(
@@ -7040,7 +7196,8 @@ module Aws::AutoScaling
       :new_instances_protected_from_scale_in,
       :service_linked_role_arn,
       :max_instance_lifetime,
-      :capacity_rebalance)
+      :capacity_rebalance,
+      :context)
       SENSITIVE = []
       include Aws::Structure
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-autoscaling
 version: !ruby/object:Gem::Version
-  version: 1.63.0
+  version: 1.67.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-06-04 00:00:00.000000000 Z
+date: 2021-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.112.0
+        version: 3.119.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.112.0
+        version: 3.119.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement