aws-sdk-autoscaling 1.65.0 → 1.69.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d3092901b216e6cd877b639c47dda76d58315e677b618e98ed1671da6fb1afbd
-  data.tar.gz: d8fe24366da1b8727911fa38ad5a13ce034969f8bb0938424386284f5a6bffef
+  metadata.gz: 9b9ff5bc88028376ad5cc02aa0b988c65d9ece01837e44f92e657b8d9d2af551
+  data.tar.gz: 240a86297df3cbd5bf659130c297cea40add4ca3bb6fda8f3925dfd1e001a97d
 SHA512:
-  metadata.gz: 3fc4e3942db9d4d21c079c7f3930910415873a5ba8e94b40e9de01bcca7d89de76763066b3f3a401832733bc902fbdaa771b6bb52374822cc2399712edb10338
-  data.tar.gz: a40bb2506cd80f58fd39af33e4972a505c743baea7042a2dcc78310c451add0eb6413eb1677971d4192fa43f8633c58bab14f5bf5d566347a4ad7b487ba5fbd0
+  metadata.gz: b1354d94c9b4ffc007265ccef28dc63af56470abdee62bf54c131d91756a89652660f23595ac4a48d70a078b33d280ed34f412ed712cac8318c9c0630d1af4b4
+  data.tar.gz: d57738e711bc5966b2b1ff89dee240abbaefebdc0d69559ca4f2c6e0b4f33f65867b0071615547838a111d90dcfff3f71eec43e04ed94a3d61aa14c03c1d0e6b

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 Unreleased Changes
 ------------------
 
+1.69.0 (2021-10-14)
+------------------
+
+* Feature - Amazon EC2 Auto Scaling now supports filtering describe Auto Scaling groups API using tags
+
+1.68.0 (2021-09-01)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+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)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.65.0
+1.69.0

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

@@ -1375,7 +1375,7 @@ module Aws::AutoScaling
     #   provide optimal I/O performance. This optimization is not available
     #   with all instance types. Additional fees are incurred when you enable
     #   EBS optimization for an instance type that is not EBS-optimized by
-    #   default. For more information, see [Amazon EBS-Optimized Instances][1]
+    #   default. For more information, see [Amazon EBS-optimized instances][1]
     #   in the *Amazon EC2 User Guide for Linux Instances*.
     #
     #   The default value is `false`.
@@ -1917,11 +1917,11 @@ module Aws::AutoScaling
     # Describes the current Amazon EC2 Auto Scaling resource quotas for your
     # account.
     #
-    # 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*.
+    # When you establish an Amazon Web Services 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*.
     #
     #
     #
@@ -2021,9 +2021,16 @@ module Aws::AutoScaling
     # Gets information about the Auto Scaling groups in the account and
     # Region.
     #
-    # This operation returns information about instances in Auto Scaling
-    # groups. To retrieve information about the instances in a warm pool,
-    # you must call the DescribeWarmPool API.
+    # If you specify Auto Scaling group names, the output includes
+    # information for only the specified Auto Scaling groups. If you specify
+    # filters, the output includes information for only those Auto Scaling
+    # groups that meet the filter criteria. If you do not specify group
+    # names or filters, the output includes information for all Auto Scaling
+    # groups.
+    #
+    # This operation also returns information about instances in Auto
+    # Scaling groups. To retrieve information about the instances in a warm
+    # pool, you must call the DescribeWarmPool API.
     #
     # @option params [Array<String>] :auto_scaling_group_names
     #   The names of the Auto Scaling groups. By default, you can only specify
@@ -2040,6 +2047,9 @@ module Aws::AutoScaling
     #   The maximum number of items to return with this call. The default
     #   value is `50` and the maximum value is `100`.
     #
+    # @option params [Array<Types::Filter>] :filters
+    #   One or more filters to limit the results based on specific tags.
+    #
     # @return [Types::AutoScalingGroupsType] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::AutoScalingGroupsType#auto_scaling_groups #auto_scaling_groups} => Array&lt;Types::AutoScalingGroup&gt;
@@ -2108,6 +2118,12 @@ module Aws::AutoScaling
     #     auto_scaling_group_names: ["XmlStringMaxLen255"],
     #     next_token: "XmlString",
     #     max_records: 1,
+    #     filters: [
+    #       {
+    #         name: "XmlString",
+    #         values: ["XmlString"],
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -2440,6 +2456,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 +5402,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 +5434,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:
     #
@@ -5437,11 +5489,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 +6006,7 @@ module Aws::AutoScaling
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-autoscaling'
-      context[:gem_version] = '1.65.0'
+      context[:gem_version] = '1.69.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')
@@ -416,6 +418,7 @@ module Aws::AutoScaling
     AutoScalingGroupNamesType.add_member(:auto_scaling_group_names, Shapes::ShapeRef.new(shape: AutoScalingGroupNames, location_name: "AutoScalingGroupNames"))
     AutoScalingGroupNamesType.add_member(:next_token, Shapes::ShapeRef.new(shape: XmlString, location_name: "NextToken"))
     AutoScalingGroupNamesType.add_member(:max_records, Shapes::ShapeRef.new(shape: MaxRecords, location_name: "MaxRecords"))
+    AutoScalingGroupNamesType.add_member(:filters, Shapes::ShapeRef.new(shape: Filters, location_name: "Filters"))
     AutoScalingGroupNamesType.struct_class = Types::AutoScalingGroupNamesType
 
     AutoScalingGroups.member = Shapes::ShapeRef.new(shape: AutoScalingGroup)
@@ -687,6 +690,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 +814,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 +1105,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 +1201,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
 
@@ -1584,6 +1595,7 @@ module Aws::AutoScaling
         o.input = Shapes::ShapeRef.new(shape: DescribeLoadBalancerTargetGroupsRequest)
         o.output = Shapes::ShapeRef.new(shape: DescribeLoadBalancerTargetGroupsResponse)
         o.errors << Shapes::ShapeRef.new(shape: ResourceContentionFault)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidNextToken)
       end)
 
       api.add_operation(:describe_load_balancers, Seahorse::Model::Operation.new.tap do |o|
@@ -1593,6 +1605,7 @@ module Aws::AutoScaling
         o.input = Shapes::ShapeRef.new(shape: DescribeLoadBalancersRequest)
         o.output = Shapes::ShapeRef.new(shape: DescribeLoadBalancersResponse)
         o.errors << Shapes::ShapeRef.new(shape: ResourceContentionFault)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidNextToken)
       end)
 
       api.add_operation(:describe_metric_collection_types, Seahorse::Model::Operation.new.tap do |o|

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

@@ -562,7 +562,7 @@ module Aws::AutoScaling
     #   provide optimal I/O performance. This optimization is not available
     #   with all instance types. Additional fees are incurred when you enable
     #   EBS optimization for an instance type that is not EBS-optimized by
-    #   default. For more information, see [Amazon EBS-Optimized Instances][1]
+    #   default. For more information, see [Amazon EBS-optimized instances][1]
     #   in the *Amazon EC2 User Guide for Linux Instances*.
     #
     #   The default value is `false`.
@@ -694,6 +694,12 @@ module Aws::AutoScaling
     #
     #   groups = auto_scaling.groups({
     #     auto_scaling_group_names: ["XmlStringMaxLen255"],
+    #     filters: [
+    #       {
+    #         name: "XmlString",
+    #         values: ["XmlString"],
+    #       },
+    #     ],
     #   })
     # @param [Hash] options ({})
     # @option options [Array<String>] :auto_scaling_group_names
@@ -702,6 +708,8 @@ module Aws::AutoScaling
     #   `MaxRecords` parameter.
     #
     #   If you omit this parameter, all Auto Scaling groups are described.
+    # @option options [Array<Types::Filter>] :filters
+    #   One or more filters to limit the results based on specific tags.
     # @return [AutoScalingGroup::Collection]
     def groups(options = {})
       batches = Enumerator.new do |y|

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

@@ -456,6 +456,12 @@ module Aws::AutoScaling
     #         auto_scaling_group_names: ["XmlStringMaxLen255"],
     #         next_token: "XmlString",
     #         max_records: 1,
+    #         filters: [
+    #           {
+    #             name: "XmlString",
+    #             values: ["XmlString"],
+    #           },
+    #         ],
     #       }
     #
     # @!attribute [rw] auto_scaling_group_names
@@ -476,12 +482,17 @@ module Aws::AutoScaling
     #   value is `50` and the maximum value is `100`.
     #   @return [Integer]
     #
+    # @!attribute [rw] filters
+    #   One or more filters to limit the results based on specific tags.
+    #   @return [Array<Types::Filter>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AutoScalingGroupNamesType AWS API Documentation
     #
     class AutoScalingGroupNamesType < Struct.new(
       :auto_scaling_group_names,
       :next_token,
-      :max_records)
+      :max_records,
+      :filters)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1506,7 +1517,7 @@ module Aws::AutoScaling
     #   with all instance types. Additional fees are incurred when you
     #   enable EBS optimization for an instance type that is not
     #   EBS-optimized by default. For more information, see [Amazon
-    #   EBS-Optimized Instances][1] in the *Amazon EC2 User Guide for Linux
+    #   EBS-optimized instances][1] in the *Amazon EC2 User Guide for Linux
     #   Instances*.
     #
     #   The default value is `false`.
@@ -2543,6 +2554,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.
@@ -2755,8 +2843,8 @@ module Aws::AutoScaling
     #   @return [Integer]
     #
     # @!attribute [rw] volume_type
-    #   The volume type. For more information, see [Amazon EBS Volume
-    #   Types][1] in the *Amazon EC2 User Guide for Linux Instances*.
+    #   The volume type. For more information, see [Amazon EBS volume
+    #   types][1] in the *Amazon EC2 User Guide for Linux Instances*.
     #
     #   Valid Values: `standard` \| `io1` \| `gp2` \| `st1` \| `sc1` \|
     #   `gp3`
@@ -2801,38 +2889,29 @@ module Aws::AutoScaling
     # @!attribute [rw] encrypted
     #   Specifies whether the volume should be encrypted. Encrypted EBS
     #   volumes can only be attached to instances that support Amazon EBS
-    #   encryption. For more information, see [Supported Instance Types][1].
+    #   encryption. For more information, see [Supported instance types][1].
     #   If your AMI uses encrypted volumes, you can also only launch it on
     #   supported instance types.
     #
-    #   <note markdown="1"> If you are creating a volume from a snapshot, you cannot specify an
-    #   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 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 Amazon Web Services managed CMK or a customer
-    #   managed CMK, whether or not the snapshot was encrypted.
+    #   <note markdown="1"> If you are creating a volume from a snapshot, you cannot create an
+    #   unencrypted volume from an encrypted snapshot. Also, you cannot
+    #   specify a KMS key ID when using a launch configuration.
     #
-    #    </note>
+    #    If you enable encryption by default, the EBS volumes that you create
+    #   are always encrypted, either using the Amazon Web Services managed
+    #   KMS key or a customer-managed KMS key, regardless of whether the
+    #   snapshot was encrypted.
     #
-    #   For more information, see [Using Encryption with EBS-Backed AMIs][3]
-    #   in the *Amazon EC2 User Guide for Linux Instances* and [Required CMK
-    #   key policy for use with encrypted volumes][4] in the *Amazon EC2
-    #   Auto Scaling User Guide*.
+    #    For more information, see [Using Amazon Web Services KMS keys to
+    #   encrypt Amazon EBS volumes][2] in the *Amazon EC2 Auto Scaling User
+    #   Guide*.
+    #
+    #    </note>
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSEncryption.html#EBSEncryption_supported_instances
-    #   [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSEncryption.html#encryption-by-default
-    #   [3]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIEncryption.html
-    #   [4]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/key-policy-requirements-EBS-encryption.html
+    #   [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-data-protection.html#encryption
     #   @return [Boolean]
     #
     # @!attribute [rw] throughput
@@ -3164,7 +3243,11 @@ module Aws::AutoScaling
     end
 
     # Describes a filter that is used to return a more specific list of
-    # results when describing tags.
+    # results from a describe operation.
+    #
+    # If you specify multiple filters, the filters are joined with an `AND`,
+    # and the request returns only results that match all of the specified
+    # filters.
     #
     # For more information, see [Tagging Auto Scaling groups and
     # instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
@@ -3182,12 +3265,58 @@ module Aws::AutoScaling
     #       }
     #
     # @!attribute [rw] name
-    #   The name of the filter. The valid values are: `auto-scaling-group`,
-    #   `key`, `value`, and `propagate-at-launch`.
+    #   The name of the filter.
+    #
+    #   The valid values for `Name` depend on the API operation that you are
+    #   including the filter in, DescribeAutoScalingGroups or DescribeTags.
+    #
+    #   **DescribeAutoScalingGroups**
+    #
+    #   Valid values for `Name` include the following:
+    #
+    #   * `tag-key` - Accepts tag keys. The results will only include
+    #     information about the Auto Scaling groups associated with these
+    #     tag keys.
+    #
+    #   * `tag-value` - Accepts tag values. The results will only include
+    #     information about the Auto Scaling groups associated with these
+    #     tag values.
+    #
+    #   * `tag:<key>` - Accepts the key/value combination of the tag. Use
+    #     the tag key in the filter name and the tag value as the filter
+    #     value. The results will only include information about the Auto
+    #     Scaling groups associated with the specified key/value
+    #     combination.
+    #
+    #   **DescribeTags**
+    #
+    #   Valid values for `Name` include the following:
+    #
+    #   * `auto-scaling-group` - Accepts the names of Auto Scaling groups.
+    #     The results will only include information about the tags
+    #     associated with these Auto Scaling groups.
+    #
+    #   * `key` - Accepts tag keys. The results will only include
+    #     information about the tags associated with these tag keys.
+    #
+    #   * `value` - Accepts tag values. The results will only include
+    #     information about the tags associated with these tag values.
+    #
+    #   * `propagate-at-launch` - Accepts a boolean value, which specifies
+    #     whether tags propagate to instances at launch. The results will
+    #     only include information about the tags associated with the
+    #     specified boolean value.
     #   @return [String]
     #
     # @!attribute [rw] values
     #   One or more filter values. Filter values are case-sensitive.
+    #
+    #   If you specify multiple values for a filter, the values are joined
+    #   with an `OR`, and the request returns all results that match any of
+    #   the specified values. For example, specify "tag:environment" for
+    #   the filter name and "production,development" for the filter values
+    #   to find Auto Scaling groups with the tag "environment=production"
+    #   or "environment=development".
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/Filter AWS API Documentation
@@ -3484,6 +3613,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 +3632,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 +3734,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 +4149,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 +4277,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 +4750,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 +4794,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 +5988,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 +5998,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 +6043,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 +6607,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 +6659,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.
+    # @!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.
     #
-    #   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.
-    #
-    #   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 +6696,7 @@ module Aws::AutoScaling
     class StartInstanceRefreshType < Struct.new(
       :auto_scaling_group_name,
       :strategy,
+      :desired_configuration,
       :preferences)
       SENSITIVE = []
       include Aws::Structure

data/lib/aws-sdk-autoscaling.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-autoscaling
 version: !ruby/object:Gem::Version
-  version: 1.65.0
+  version: 1.69.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-28 00:00:00.000000000 Z
+date: 2021-10-14 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.118.0
+        version: 3.120.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.118.0
+        version: 3.120.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement
@@ -87,7 +87,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="