aws-sdk-autoscaling 1.75.0 → 1.99.0

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

@@ -31,6 +31,7 @@ module Aws::AutoScaling
   # * {AlreadyExistsFault}
   # * {InstanceRefreshInProgressFault}
   # * {InvalidNextToken}
+  # * {IrreversibleInstanceRefreshFault}
   # * {LimitExceededFault}
   # * {ResourceContentionFault}
   # * {ResourceInUseFault}
@@ -103,6 +104,21 @@ module Aws::AutoScaling
       end
     end
 
+    class IrreversibleInstanceRefreshFault < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::AutoScaling::Types::IrreversibleInstanceRefreshFault] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
     class LimitExceededFault < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -60,7 +60,7 @@ module Aws::AutoScaling
     # used. For information about lifecycle states, see [Instance
     # lifecycle][1] in the *Amazon EC2 Auto Scaling User Guide*.
     #
-    # Valid Values: `Pending` \| `Pending:Wait` \| `Pending:Proceed` \|
+    # Valid values: `Pending` \| `Pending:Wait` \| `Pending:Proceed` \|
     # `Quarantined` \| `InService` \| `Terminating` \| `Terminating:Wait` \|
     # `Terminating:Proceed` \| `Terminated` \| `Detaching` \| `Detached` \|
     # `EnteringStandby` \| `Standby` \| `Warmed:Pending` \|
@@ -77,10 +77,10 @@ module Aws::AutoScaling
       data[:lifecycle_state]
     end
 
-    # The last reported health status of this instance. "Healthy" means
-    # that the instance is healthy and should remain in service.
-    # "Unhealthy" means that the instance is unhealthy and Amazon EC2 Auto
-    # Scaling should terminate and replace it.
+    # The last reported health status of this instance. `Healthy` means that
+    # the instance is healthy and should remain in service. `Unhealthy`
+    # means that the instance is unhealthy and Amazon EC2 Auto Scaling
+    # should terminate and replace it.
     # @return [String]
     def health_status
       data[:health_status]
@@ -129,7 +129,9 @@ module Aws::AutoScaling
     #
     # @return [self]
     def load
-      resp = @client.describe_auto_scaling_instances(instance_ids: [@id])
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.describe_auto_scaling_instances(instance_ids: [@id])
+      end
       @data = resp.auto_scaling_instances[0]
       self
     end
@@ -244,7 +246,9 @@ module Aws::AutoScaling
           :retry
         end
       end
-      Aws::Waiters::Waiter.new(options).wait({})
+      Aws::Plugins::UserAgent.feature('resource') do
+        Aws::Waiters::Waiter.new(options).wait({})
+      end
     end
 
     # @!group Actions
@@ -259,7 +263,9 @@ module Aws::AutoScaling
         auto_scaling_group_name: @group_name,
         instance_ids: [@id]
       )
-      resp = @client.attach_instances(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.attach_instances(options)
+      end
       resp.data
     end
 
@@ -279,7 +285,9 @@ module Aws::AutoScaling
         auto_scaling_group_name: @group_name,
         instance_ids: [@id]
       )
-      resp = @client.detach_instances(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.detach_instances(options)
+      end
       resp.data.activities.each do |a|
         batch << Activity.new(
           id: a.activity_id,
@@ -306,7 +314,9 @@ module Aws::AutoScaling
         auto_scaling_group_name: @group_name,
         instance_ids: [@id]
       )
-      resp = @client.enter_standby(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.enter_standby(options)
+      end
       resp.data.activities.each do |a|
         batch << Activity.new(
           id: a.activity_id,
@@ -328,7 +338,9 @@ module Aws::AutoScaling
         auto_scaling_group_name: @group_name,
         instance_ids: [@id]
       )
-      resp = @client.exit_standby(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.exit_standby(options)
+      end
       resp.data.activities.each do |a|
         batch << Activity.new(
           id: a.activity_id,
@@ -367,7 +379,9 @@ module Aws::AutoScaling
     # @return [EmptyStructure]
     def set_health(options = {})
       options = options.merge(instance_id: @id)
-      resp = @client.set_instance_health(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.set_instance_health(options)
+      end
       resp.data
     end
 
@@ -383,7 +397,9 @@ module Aws::AutoScaling
     # @return [Activity]
     def terminate(options = {})
       options = options.merge(instance_id: @id)
-      resp = @client.terminate_instance_in_auto_scaling_group(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.terminate_instance_in_auto_scaling_group(options)
+      end
       Activity.new(
         id: resp.data.activity.activity_id,
         data: resp.data.activity,
@@ -461,7 +477,9 @@ module Aws::AutoScaling
           batch.each do |item|
             params[:instance_ids] << item.id
           end
-          batch[0].client.attach_instances(params)
+          Aws::Plugins::UserAgent.feature('resource') do
+            batch[0].client.attach_instances(params)
+          end
         end
         nil
       end
@@ -484,7 +502,9 @@ module Aws::AutoScaling
           batch.each do |item|
             params[:instance_ids] << item.id
           end
-          batch[0].client.detach_instances(params)
+          Aws::Plugins::UserAgent.feature('resource') do
+            batch[0].client.detach_instances(params)
+          end
         end
         nil
       end
@@ -507,7 +527,9 @@ module Aws::AutoScaling
           batch.each do |item|
             params[:instance_ids] << item.id
           end
-          batch[0].client.enter_standby(params)
+          Aws::Plugins::UserAgent.feature('resource') do
+            batch[0].client.enter_standby(params)
+          end
         end
         nil
       end
@@ -522,7 +544,9 @@ module Aws::AutoScaling
           batch.each do |item|
             params[:instance_ids] << item.id
           end
-          batch[0].client.exit_standby(params)
+          Aws::Plugins::UserAgent.feature('resource') do
+            batch[0].client.exit_standby(params)
+          end
         end
         nil
       end

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

@@ -42,7 +42,7 @@ module Aws::AutoScaling
     end
 
     # The ID of the Amazon Machine Image (AMI) to use to launch your EC2
-    # instances. For more information, see [Finding an AMI][1] in the
+    # instances. For more information, see [Find a Linux AMI][1] in the
     # *Amazon EC2 User Guide for Linux Instances*.
     #
     #
@@ -78,31 +78,13 @@ module Aws::AutoScaling
       data[:security_groups]
     end
 
-    # The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances
-    # to. For more information, see [ClassicLink][1] in the *Amazon EC2 User
-    # Guide for Linux Instances* and [Linking EC2-Classic instances to a
-    # VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
-    # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
+    # Available for backward compatibility.
     # @return [String]
     def classic_link_vpc_id
       data[:classic_link_vpc_id]
     end
 
-    # The IDs of one or more security groups for the VPC specified in
-    # `ClassicLinkVPCId`.
-    #
-    # For more information, see [ClassicLink][1] in the *Amazon EC2 User
-    # Guide for Linux Instances* and [Linking EC2-Classic instances to a
-    # VPC][2] in the *Amazon EC2 Auto Scaling User Guide*.
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
-    # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-ClassicLink
+    # Available for backward compatibility.
     # @return [Array<String>]
     def classic_link_vpc_security_groups
       data[:classic_link_vpc_security_groups]
@@ -124,10 +106,9 @@ module Aws::AutoScaling
       data[:user_data]
     end
 
-    # The instance type for the instances.
-    #
-    # For information about available instance types, see [Available
-    # Instance Types][1] in the *Amazon EC2 User Guide for Linux Instances*.
+    # The instance type for the instances. For information about available
+    # instance types, see [Available instance types][1] in the *Amazon EC2
+    # User Guide for Linux Instances*.
     #
     #
     #
@@ -149,9 +130,11 @@ module Aws::AutoScaling
       data[:ramdisk_id]
     end
 
-    # A block device mapping, which specifies the block devices for the
-    # instance. For more information, see [Block Device Mapping][1] in the
-    # *Amazon EC2 User Guide for Linux Instances*.
+    # The block device mapping entries that define the block devices to
+    # attach to the instances at launch. By default, the block devices
+    # specified in the block device mapping for the AMI are used. For more
+    # information, see [Block Device Mapping][1] in the *Amazon EC2 User
+    # Guide for Linux Instances*.
     #
     #
     #
@@ -222,10 +205,15 @@ module Aws::AutoScaling
       data[:ebs_optimized]
     end
 
-    # For Auto Scaling groups that are running in a VPC, specifies whether
-    # to assign a public IP address to the group's instances. For more
-    # information, see [Launching Auto Scaling instances in a VPC][1] in the
-    # *Amazon EC2 Auto Scaling User Guide*.
+    # Specifies whether to assign a public IPv4 address to the group's
+    # instances. If the instance is launched into a default subnet, the
+    # default is to assign a public IPv4 address, unless you disabled the
+    # option to assign a public IPv4 address on the subnet. If the instance
+    # is launched into a nondefault subnet, the default is not to assign a
+    # public IPv4 address, unless you enabled the option to assign a public
+    # IPv4 address on the subnet. For more information, see [Launching Auto
+    # Scaling instances in a VPC][1] in the *Amazon EC2 Auto Scaling User
+    # Guide*.
     #
     #
     #
@@ -276,7 +264,9 @@ module Aws::AutoScaling
     #
     # @return [self]
     def load
-      resp = @client.describe_launch_configurations(launch_configuration_names: [@name])
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.describe_launch_configurations(launch_configuration_names: [@name])
+      end
       @data = resp.launch_configurations[0]
       self
     end
@@ -391,7 +381,9 @@ module Aws::AutoScaling
           :retry
         end
       end
-      Aws::Waiters::Waiter.new(options).wait({})
+      Aws::Plugins::UserAgent.feature('resource') do
+        Aws::Waiters::Waiter.new(options).wait({})
+      end
     end
 
     # @!group Actions
@@ -403,7 +395,9 @@ module Aws::AutoScaling
     # @return [EmptyStructure]
     def delete(options = {})
       options = options.merge(launch_configuration_name: @name)
-      resp = @client.delete_launch_configuration(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.delete_launch_configuration(options)
+      end
       resp.data
     end
 

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

@@ -44,27 +44,25 @@ module Aws::AutoScaling
     end
     alias :lifecycle_hook_name :name
 
-    # The state of the EC2 instance to which to attach the lifecycle hook.
-    # The following are possible values:
+    # The lifecycle transition.
     #
-    # * autoscaling:EC2\_INSTANCE\_LAUNCHING
-    #
-    # * autoscaling:EC2\_INSTANCE\_TERMINATING
+    # Valid values: `autoscaling:EC2_INSTANCE_LAUNCHING` \|
+    # `autoscaling:EC2_INSTANCE_TERMINATING`
     # @return [String]
     def lifecycle_transition
       data[:lifecycle_transition]
     end
 
     # The ARN of the target that Amazon EC2 Auto Scaling sends notifications
-    # to when an instance is in the transition state for the lifecycle hook.
-    # The notification target can be either an SQS queue or an SNS topic.
+    # to when an instance is in a wait state for the lifecycle hook.
     # @return [String]
     def notification_target_arn
       data[:notification_target_arn]
     end
 
     # The ARN of the IAM role that allows the Auto Scaling group to publish
-    # to the specified notification target.
+    # to the specified notification target (an Amazon SNS topic or an Amazon
+    # SQS queue).
     # @return [String]
     def role_arn
       data[:role_arn]
@@ -80,24 +78,24 @@ module Aws::AutoScaling
     # The maximum time, in seconds, that can elapse before the lifecycle
     # hook times out. If the lifecycle hook times out, Amazon EC2 Auto
     # Scaling performs the action that you specified in the `DefaultResult`
-    # parameter.
+    # property.
     # @return [Integer]
     def heartbeat_timeout
       data[:heartbeat_timeout]
     end
 
-    # The maximum time, in seconds, that an instance can remain in a
-    # `Pending:Wait` or `Terminating:Wait` state. The maximum is 172800
-    # seconds (48 hours) or 100 times `HeartbeatTimeout`, whichever is
-    # smaller.
+    # The maximum time, in seconds, that an instance can remain in a wait
+    # state. The maximum is 172800 seconds (48 hours) or 100 times
+    # `HeartbeatTimeout`, whichever is smaller.
     # @return [Integer]
     def global_timeout
       data[:global_timeout]
     end
 
-    # Defines the action the Auto Scaling group should take when the
-    # lifecycle hook timeout elapses or if an unexpected failure occurs. The
-    # possible values are `CONTINUE` and `ABANDON`.
+    # The action the Auto Scaling group takes when the lifecycle hook
+    # timeout elapses or if an unexpected failure occurs.
+    #
+    # Valid values: `CONTINUE` \| `ABANDON`
     # @return [String]
     def default_result
       data[:default_result]
@@ -117,10 +115,12 @@ module Aws::AutoScaling
     #
     # @return [self]
     def load
-      resp = @client.describe_lifecycle_hooks(
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.describe_lifecycle_hooks(
         auto_scaling_group_name: @group_name,
         lifecycle_hook_names: [@name]
       )
+      end
       @data = resp.lifecycle_hooks[0]
       self
     end
@@ -235,7 +235,9 @@ module Aws::AutoScaling
           :retry
         end
       end
-      Aws::Waiters::Waiter.new(options).wait({})
+      Aws::Plugins::UserAgent.feature('resource') do
+        Aws::Waiters::Waiter.new(options).wait({})
+      end
     end
 
     # @!group Actions
@@ -254,8 +256,8 @@ module Aws::AutoScaling
     #   sends this token to the notification target you specified when you
     #   created the lifecycle hook.
     # @option options [required, String] :lifecycle_action_result
-    #   The action for the group to take. This parameter can be either
-    #   `CONTINUE` or `ABANDON`.
+    #   The action for the group to take. You can specify either `CONTINUE` or
+    #   `ABANDON`.
     # @option options [String] :instance_id
     #   The ID of the instance.
     # @return [Types::CompleteLifecycleActionAnswer]
@@ -264,7 +266,9 @@ module Aws::AutoScaling
         auto_scaling_group_name: @group_name,
         lifecycle_hook_name: @name
       )
-      resp = @client.complete_lifecycle_action(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.complete_lifecycle_action(options)
+      end
       resp.data
     end
 
@@ -278,7 +282,9 @@ module Aws::AutoScaling
         auto_scaling_group_name: @group_name,
         lifecycle_hook_name: @name
       )
-      resp = @client.delete_lifecycle_hook(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.delete_lifecycle_hook(options)
+      end
       resp.data
     end
 
@@ -288,33 +294,35 @@ module Aws::AutoScaling
     #     lifecycle_transition: "LifecycleTransition",
     #     role_arn: "XmlStringMaxLen255",
     #     notification_target_arn: "NotificationTargetResourceName",
-    #     notification_metadata: "XmlStringMaxLen1023",
+    #     notification_metadata: "AnyPrintableAsciiStringMaxLen4000",
     #     heartbeat_timeout: 1,
     #     default_result: "LifecycleActionResult",
     #   })
     # @param [Hash] options ({})
     # @option options [String] :lifecycle_transition
-    #   The instance state to which you want to attach the lifecycle hook. The
-    #   valid values are:
+    #   The lifecycle transition. For Auto Scaling groups, there are two major
+    #   lifecycle transitions.
     #
-    #   * autoscaling:EC2\_INSTANCE\_LAUNCHING
+    #   * To create a lifecycle hook for scale-out events, specify
+    #     `autoscaling:EC2_INSTANCE_LAUNCHING`.
     #
-    #   * autoscaling:EC2\_INSTANCE\_TERMINATING
+    #   * To create a lifecycle hook for scale-in events, specify
+    #     `autoscaling:EC2_INSTANCE_TERMINATING`.
     #
     #   Required for new lifecycle hooks, but optional when updating existing
     #   hooks.
     # @option options [String] :role_arn
     #   The ARN of the IAM role that allows the Auto Scaling group to publish
-    #   to the specified notification target, for example, an Amazon SNS topic
-    #   or an Amazon SQS queue.
+    #   to the specified notification target.
     #
-    #   Required for new lifecycle hooks, but optional when updating existing
-    #   hooks.
+    #   Valid only if the notification target is an Amazon SNS topic or an
+    #   Amazon SQS queue. Required for new lifecycle hooks, but optional when
+    #   updating existing hooks.
     # @option options [String] :notification_target_arn
-    #   The ARN of the notification target that Amazon EC2 Auto Scaling uses
-    #   to notify you when an instance is in the transition state for the
-    #   lifecycle hook. This target can be either an SQS queue or an SNS
-    #   topic.
+    #   The Amazon Resource Name (ARN) of the notification target that Amazon
+    #   EC2 Auto Scaling uses to notify you when an instance is in a wait
+    #   state for the lifecycle hook. You can specify either an Amazon SNS
+    #   topic or an Amazon SQS queue.
     #
     #   If you specify an empty string, this overrides the current ARN.
     #
@@ -332,23 +340,21 @@ module Aws::AutoScaling
     #   The maximum time, in seconds, that can elapse before the lifecycle
     #   hook times out. The range is from `30` to `7200` seconds. The default
     #   value is `3600` seconds (1 hour).
-    #
-    #   If the lifecycle hook times out, Amazon EC2 Auto Scaling performs the
-    #   action that you specified in the `DefaultResult` parameter. You can
-    #   prevent the lifecycle hook from timing out by calling the
-    #   RecordLifecycleActionHeartbeat API.
     # @option options [String] :default_result
-    #   Defines the action the Auto Scaling group should take when the
-    #   lifecycle hook timeout elapses or if an unexpected failure occurs.
-    #   This parameter can be either `CONTINUE` or `ABANDON`. The default
-    #   value is `ABANDON`.
+    #   The action the Auto Scaling group takes when the lifecycle hook
+    #   timeout elapses or if an unexpected failure occurs. The default value
+    #   is `ABANDON`.
+    #
+    #   Valid values: `CONTINUE` \| `ABANDON`
     # @return [Types::PutLifecycleHookAnswer]
     def put(options = {})
       options = options.merge(
         auto_scaling_group_name: @group_name,
         lifecycle_hook_name: @name
       )
-      resp = @client.put_lifecycle_hook(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.put_lifecycle_hook(options)
+      end
       resp.data
     end
 
@@ -372,7 +378,9 @@ module Aws::AutoScaling
         auto_scaling_group_name: @group_name,
         lifecycle_hook_name: @name
       )
-      resp = @client.record_lifecycle_action_heartbeat(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.record_lifecycle_action_heartbeat(options)
+      end
       resp.data
     end
 

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

@@ -190,7 +190,9 @@ module Aws::AutoScaling
           :retry
         end
       end
-      Aws::Waiters::Waiter.new(options).wait({})
+      Aws::Plugins::UserAgent.feature('resource') do
+        Aws::Waiters::Waiter.new(options).wait({})
+      end
     end
 
     # @!group Actions
@@ -205,7 +207,9 @@ module Aws::AutoScaling
         auto_scaling_group_name: @group_name,
         load_balancer_names: [@name]
       )
-      resp = @client.attach_load_balancers(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.attach_load_balancers(options)
+      end
       resp.data
     end
 
@@ -219,7 +223,9 @@ module Aws::AutoScaling
         auto_scaling_group_name: @group_name,
         load_balancer_names: [@name]
       )
-      resp = @client.detach_load_balancers(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.detach_load_balancers(options)
+      end
       resp.data
     end
 
@@ -281,7 +287,9 @@ module Aws::AutoScaling
           batch.each do |item|
             params[:load_balancer_names] << item.name
           end
-          batch[0].client.attach_load_balancers(params)
+          Aws::Plugins::UserAgent.feature('resource') do
+            batch[0].client.attach_load_balancers(params)
+          end
         end
         nil
       end
@@ -296,7 +304,9 @@ module Aws::AutoScaling
           batch.each do |item|
             params[:load_balancer_names] << item.name
           end
-          batch[0].client.detach_load_balancers(params)
+          Aws::Plugins::UserAgent.feature('resource') do
+            batch[0].client.detach_load_balancers(params)
+          end
         end
         nil
       end

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

@@ -176,7 +176,9 @@ module Aws::AutoScaling
           :retry
         end
       end
-      Aws::Waiters::Waiter.new(options).wait({})
+      Aws::Plugins::UserAgent.feature('resource') do
+        Aws::Waiters::Waiter.new(options).wait({})
+      end
     end
 
     # @!group Actions
@@ -191,7 +193,9 @@ module Aws::AutoScaling
         auto_scaling_group_name: @group_name,
         topic_arn: @topic_arn
       )
-      resp = @client.delete_notification_configuration(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.delete_notification_configuration(options)
+      end
       resp.data
     end
 
@@ -206,7 +210,9 @@ module Aws::AutoScaling
         topic_arn: @topic_arn,
         notification_types: [@notification_type]
       )
-      resp = @client.put_notification_configuration(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.put_notification_configuration(options)
+      end
       resp.data
     end
 
@@ -281,7 +287,9 @@ module Aws::AutoScaling
           batch.each do |item|
             params[:notification_types] << item.notification_type
           end
-          batch[0].client.put_notification_configuration(params)
+          Aws::Plugins::UserAgent.feature('resource') do
+            batch[0].client.put_notification_configuration(params)
+          end
         end
         nil
       end