aws-sdk-autoscaling 1.95.0 → 1.96.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f7101c25795cc4d44eebcd18de78dbf0958d49e159ee41ceafe2b70420cac63
-  data.tar.gz: 87c91e27553e07ee18b76df846fc514a487d0d205a043987aa940f77008a132d
+  metadata.gz: 676b2383ae209c855ce2a5e7d2b87ca9c34e30de771c781a604374fb2258f383
+  data.tar.gz: 585d1e8e238c326a6eea9d22d04fef80c05fc4046d007245d44f52d9c41b4bd7
 SHA512:
-  metadata.gz: 4b126edf79b138b29a29dcf25f15bbc30613307aed1e98efa3309f942df8d302481f377dae780bf7dce8079dc641ea3cbe72b9f3f6e83457625312ff222917a8
-  data.tar.gz: 3675ba45cc4c825e86b96fa23347252450c866c744217b107b06051c4664e542212254e1c4fb3d146a7de6083fe1a69f401bb9dbba3d0348ab28221b611bf397
+  metadata.gz: 91a658aa26d95f697890c82b51c16c02ca04bfdfbf3243b9366490cf362cc0b8a9ee23ba9979133c152aae02862b0441754d164a3e0a09dc78c11faabae719c6
+  data.tar.gz: b3dadc542249cd06b0de3baefb1ce5601171e1786aace132c3068437d251ba947dc6d335a0aef9f48c1da65886c0d7596144b6a0c0c63b5adb959af982b99d55

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.96.0 (2023-07-31)
+------------------
+
+* Feature - You can now configure an instance refresh to set its status to 'failed' when it detects that a specified CloudWatch alarm has gone into the ALARM state. You can also choose to roll back the instance refresh automatically when the alarm threshold is met.
+
 1.95.0 (2023-07-27)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.95.0
+1.96.0

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

@@ -1229,84 +1229,6 @@ module Aws::AutoScaling
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
-    #
-    # @example Example: To create an Auto Scaling group
-    #
-    #   # This example creates an Auto Scaling group.
-    #
-    #   resp = client.create_auto_scaling_group({
-    #     auto_scaling_group_name: "my-auto-scaling-group", 
-    #     launch_template: {
-    #       launch_template_name: "my-template-for-auto-scaling", 
-    #       version: "$Latest", 
-    #     }, 
-    #     max_instance_lifetime: 2592000, 
-    #     max_size: 3, 
-    #     min_size: 1, 
-    #     vpc_zone_identifier: "subnet-057fa0918fEXAMPLE", 
-    #   })
-    #
-    # @example Example: To create an Auto Scaling group with an attached target group
-    #
-    #   # This example creates an Auto Scaling group and attaches the specified target group.
-    #
-    #   resp = client.create_auto_scaling_group({
-    #     auto_scaling_group_name: "my-auto-scaling-group", 
-    #     health_check_grace_period: 300, 
-    #     health_check_type: "ELB", 
-    #     launch_template: {
-    #       launch_template_name: "my-template-for-auto-scaling", 
-    #       version: "$Latest", 
-    #     }, 
-    #     max_size: 3, 
-    #     min_size: 1, 
-    #     target_group_arns: [
-    #       "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", 
-    #     ], 
-    #     vpc_zone_identifier: "subnet-057fa0918fEXAMPLE, subnet-610acd08EXAMPLE", 
-    #   })
-    #
-    # @example Example: To create an Auto Scaling group with a mixed instances policy
-    #
-    #   # This example creates an Auto Scaling group with a mixed instances policy. It specifies the c5.large, c5a.large, and
-    #   # c6g.large instance types and defines a different launch template for the c6g.large instance type.
-    #
-    #   resp = client.create_auto_scaling_group({
-    #     auto_scaling_group_name: "my-asg", 
-    #     desired_capacity: 3, 
-    #     max_size: 5, 
-    #     min_size: 1, 
-    #     mixed_instances_policy: {
-    #       instances_distribution: {
-    #         on_demand_base_capacity: 1, 
-    #         on_demand_percentage_above_base_capacity: 50, 
-    #         spot_allocation_strategy: "capacity-optimized", 
-    #       }, 
-    #       launch_template: {
-    #         launch_template_specification: {
-    #           launch_template_name: "my-launch-template-for-x86", 
-    #           version: "$Latest", 
-    #         }, 
-    #         overrides: [
-    #           {
-    #             instance_type: "c6g.large", 
-    #             launch_template_specification: {
-    #               launch_template_name: "my-launch-template-for-arm", 
-    #               version: "$Latest", 
-    #             }, 
-    #           }, 
-    #           {
-    #             instance_type: "c5.large", 
-    #           }, 
-    #           {
-    #             instance_type: "c5a.large", 
-    #           }, 
-    #         ], 
-    #       }, 
-    #     }, 
-    #     vpc_zone_identifier: "subnet-057fa0918fEXAMPLE, subnet-610acd08EXAMPLE", 
-    #   })
-    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_auto_scaling_group({
@@ -2747,8 +2669,13 @@ module Aws::AutoScaling
     #         instances_to_update: 0, 
     #         percentage_complete: 50, 
     #         preferences: {
+    #           alarm_specification: {
+    #             alarms: [
+    #               "my-alarm", 
+    #             ], 
+    #           }, 
     #           auto_rollback: true, 
-    #           instance_warmup: 60, 
+    #           instance_warmup: 200, 
     #           min_healthy_percentage: 90, 
     #           scale_in_protected_instances: "Ignore", 
     #           skip_matching: false, 
@@ -2765,8 +2692,13 @@ module Aws::AutoScaling
     #         instances_to_update: 0, 
     #         percentage_complete: 100, 
     #         preferences: {
+    #           alarm_specification: {
+    #             alarms: [
+    #               "my-alarm", 
+    #             ], 
+    #           }, 
     #           auto_rollback: true, 
-    #           instance_warmup: 60, 
+    #           instance_warmup: 200, 
     #           min_healthy_percentage: 90, 
     #           scale_in_protected_instances: "Ignore", 
     #           skip_matching: false, 
@@ -2811,6 +2743,8 @@ module Aws::AutoScaling
     #   resp.instance_refreshes[0].preferences.auto_rollback #=> Boolean
     #   resp.instance_refreshes[0].preferences.scale_in_protected_instances #=> String, one of "Refresh", "Ignore", "Wait"
     #   resp.instance_refreshes[0].preferences.standby_instances #=> String, one of "Terminate", "Ignore", "Wait"
+    #   resp.instance_refreshes[0].preferences.alarm_specification.alarms #=> Array
+    #   resp.instance_refreshes[0].preferences.alarm_specification.alarms[0] #=> String
     #   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
@@ -6361,6 +6295,8 @@ module Aws::AutoScaling
     #
     #   * Checkpoints
     #
+    #   * CloudWatch alarms
+    #
     #   * Skip matching
     #
     # @return [Types::StartInstanceRefreshAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -6381,9 +6317,14 @@ module Aws::AutoScaling
     #       }, 
     #     }, 
     #     preferences: {
-    #       instance_warmup: 400, 
+    #       alarm_specification: {
+    #         alarms: [
+    #           "my-alarm", 
+    #         ], 
+    #       }, 
+    #       auto_rollback: true, 
+    #       instance_warmup: 200, 
     #       min_healthy_percentage: 90, 
-    #       skip_matching: true, 
     #     }, 
     #   })
     #
@@ -6493,6 +6434,9 @@ module Aws::AutoScaling
     #       auto_rollback: false,
     #       scale_in_protected_instances: "Refresh", # accepts Refresh, Ignore, Wait
     #       standby_instances: "Terminate", # accepts Terminate, Ignore, Wait
+    #       alarm_specification: {
+    #         alarms: ["XmlStringMaxLen255"],
+    #       },
     #     },
     #   })
     #
@@ -7063,7 +7007,7 @@ module Aws::AutoScaling
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-autoscaling'
-      context[:gem_version] = '1.95.0'
+      context[:gem_version] = '1.96.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -30,6 +30,8 @@ module Aws::AutoScaling
     AdjustmentType = Shapes::StructureShape.new(name: 'AdjustmentType')
     AdjustmentTypes = Shapes::ListShape.new(name: 'AdjustmentTypes')
     Alarm = Shapes::StructureShape.new(name: 'Alarm')
+    AlarmList = Shapes::ListShape.new(name: 'AlarmList')
+    AlarmSpecification = Shapes::StructureShape.new(name: 'AlarmSpecification')
     Alarms = Shapes::ListShape.new(name: 'Alarms')
     AllowedInstanceType = Shapes::StringShape.new(name: 'AllowedInstanceType')
     AllowedInstanceTypes = Shapes::ListShape.new(name: 'AllowedInstanceTypes')
@@ -438,6 +440,11 @@ module Aws::AutoScaling
     Alarm.add_member(:alarm_arn, Shapes::ShapeRef.new(shape: ResourceName, location_name: "AlarmARN"))
     Alarm.struct_class = Types::Alarm
 
+    AlarmList.member = Shapes::ShapeRef.new(shape: XmlStringMaxLen255)
+
+    AlarmSpecification.add_member(:alarms, Shapes::ShapeRef.new(shape: AlarmList, location_name: "Alarms"))
+    AlarmSpecification.struct_class = Types::AlarmSpecification
+
     Alarms.member = Shapes::ShapeRef.new(shape: Alarm)
 
     AllowedInstanceTypes.member = Shapes::ShapeRef.new(shape: AllowedInstanceType)
@@ -1312,6 +1319,7 @@ module Aws::AutoScaling
     RefreshPreferences.add_member(:auto_rollback, Shapes::ShapeRef.new(shape: AutoRollback, location_name: "AutoRollback"))
     RefreshPreferences.add_member(:scale_in_protected_instances, Shapes::ShapeRef.new(shape: ScaleInProtectedInstances, location_name: "ScaleInProtectedInstances"))
     RefreshPreferences.add_member(:standby_instances, Shapes::ShapeRef.new(shape: StandbyInstances, location_name: "StandbyInstances"))
+    RefreshPreferences.add_member(:alarm_specification, Shapes::ShapeRef.new(shape: AlarmSpecification, location_name: "AlarmSpecification"))
     RefreshPreferences.struct_class = Types::RefreshPreferences
 
     ResourceContentionFault.add_member(:message, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "message"))

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

@@ -206,6 +206,22 @@ module Aws::AutoScaling
       include Aws::Structure
     end
 
+    # Specifies the CloudWatch alarm specification to use in an instance
+    # refresh.
+    #
+    # @!attribute [rw] alarms
+    #   The names of one or more CloudWatch alarms to monitor for the
+    #   instance refresh.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AlarmSpecification AWS API Documentation
+    #
+    class AlarmSpecification < Struct.new(
+      :alarms)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # You already have an Auto Scaling group or launch configuration with
     # this name.
     #
@@ -6242,8 +6258,8 @@ module Aws::AutoScaling
     #
     # @!attribute [rw] auto_rollback
     #   (Optional) Indicates whether to roll back the Auto Scaling group to
-    #   its previous configuration if the instance refresh fails. The
-    #   default is `false`.
+    #   its previous configuration if the instance refresh fails or a
+    #   CloudWatch alarm threshold is met. The default is `false`.
     #
     #   A rollback is not supported in the following situations:
     #
@@ -6256,6 +6272,13 @@ module Aws::AutoScaling
     #
     #   * The Auto Scaling group uses the launch template's `$Latest` or
     #     `$Default` version.
+    #
+    #   For more information, see [Undo changes with a rollback][1] in the
+    #   *Amazon EC2 Auto Scaling User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/instance-refresh-rollback.html
     #   @return [Boolean]
     #
     # @!attribute [rw] scale_in_protected_instances
@@ -6304,6 +6327,12 @@ module Aws::AutoScaling
     #     instances to service. Otherwise, the instance refresh will fail.
     #   @return [String]
     #
+    # @!attribute [rw] alarm_specification
+    #   (Optional) The CloudWatch alarm specification. CloudWatch alarms can
+    #   be used to identify any issues and fail the operation if an alarm
+    #   threshold is met.
+    #   @return [Types::AlarmSpecification]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/RefreshPreferences AWS API Documentation
     #
     class RefreshPreferences < Struct.new(
@@ -6314,7 +6343,8 @@ module Aws::AutoScaling
       :skip_matching,
       :auto_rollback,
       :scale_in_protected_instances,
-      :standby_instances)
+      :standby_instances,
+      :alarm_specification)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -6913,6 +6943,8 @@ module Aws::AutoScaling
     #
     #   * Checkpoints
     #
+    #   * CloudWatch alarms
+    #
     #   * Skip matching
     #   @return [Types::RefreshPreferences]
     #

data/lib/aws-sdk-autoscaling.rb

@@ -63,6 +63,6 @@ require_relative 'aws-sdk-autoscaling/customizations'
 # @!group service
 module Aws::AutoScaling
 
-  GEM_VERSION = '1.95.0'
+  GEM_VERSION = '1.96.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-autoscaling
 version: !ruby/object:Gem::Version
-  version: 1.95.0
+  version: 1.96.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-27 00:00:00.000000000 Z
+date: 2023-07-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core