aws-sdk-autoscaling 1.0.0.rc1

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

@@ -0,0 +1,7 @@
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing for info on making contributions:
+# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+

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

@@ -0,0 +1,23 @@
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing for info on making contributions:
+# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+module Aws
+  module AutoScaling
+    module Errors
+
+      extend Aws::Errors::DynamicErrors
+
+      # Raised when calling #load or #data on a resource class that can not be
+      # loaded.  This can happen when:
+      #
+      # * A resource class has identifiers, but no data attributes.
+      # * Resource data is only available when making an API call that
+      # enumerates all resources of that type.
+      class ResourceNotLoadable < RuntimeError; end
+    end
+  end
+end

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

@@ -0,0 +1,416 @@
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing for info on making contributions:
+# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+module Aws
+  module AutoScaling
+    class Instance
+
+      extend Aws::Deprecations
+
+      # @overload def initialize(group_name, id, options = {})
+      #   @param [String] group_name
+      #   @param [String] id
+      #   @option options [Client] :client
+      # @overload def initialize(options = {})
+      #   @option options [required, String] :group_name
+      #   @option options [required, String] :id
+      #   @option options [Client] :client
+      def initialize(*args)
+        options = Hash === args.last ? args.pop.dup : {}
+        @group_name = extract_group_name(args, options)
+        @id = extract_id(args, options)
+        @data = options.delete(:data)
+        @client = options.delete(:client) || Client.new(options)
+      end
+
+      # @!group Read-Only Attributes
+
+      # @return [String]
+      def group_name
+        @group_name
+      end
+      alias :auto_scaling_group_name :group_name
+
+      # @return [String]
+      def id
+        @id
+      end
+      alias :instance_id :id
+
+      # The Availability Zone for the instance.
+      # @return [String]
+      def availability_zone
+        data.availability_zone
+      end
+
+      # The lifecycle state for the instance. For more information, see [Auto
+      # Scaling Lifecycle][1] in the *Auto Scaling User Guide*.
+      #
+      #
+      #
+      # [1]: http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroupLifecycle.html
+      # @return [String]
+      def lifecycle_state
+        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 Auto Scaling
+      # should terminate and replace it.
+      # @return [String]
+      def health_status
+        data.health_status
+      end
+
+      # The launch configuration associated with the instance.
+      # @return [String]
+      def launch_configuration_name
+        data.launch_configuration_name
+      end
+
+      # Indicates whether the instance is protected from termination by Auto
+      # Scaling when scaling in.
+      # @return [Boolean]
+      def protected_from_scale_in
+        data.protected_from_scale_in
+      end
+
+      # @!endgroup
+
+      # @return [Client]
+      def client
+        @client
+      end
+
+      # Loads, or reloads {#data} for the current {Instance}.
+      # Returns `self` making it possible to chain methods.
+      #
+      #     instance.reload.data
+      #
+      # @return [self]
+      def load
+        resp = @client.describe_auto_scaling_instances(instance_ids: [@id])
+        @data = resp.autoscalinginstances[0]
+        self
+      end
+      alias :reload :load
+
+      # @return [Types::AutoScalingInstanceDetails]
+      #   Returns the data for this {Instance}. Calls
+      #   {Client#describe_auto_scaling_instances} if {#data_loaded?} is `false`.
+      def data
+        load unless @data
+        @data
+      end
+
+      # @return [Boolean]
+      #   Returns `true` if this resource is loaded.  Accessing attributes or
+      #   {#data} on an unloaded resource will trigger a call to {#load}.
+      def data_loaded?
+        !!@data
+      end
+
+      # @!group Actions
+
+      # @example Request syntax with placeholder values
+      #
+      #   instance.attach()
+      # @param [Hash] options ({})
+      # @return [EmptyStructure]
+      def attach(options = {})
+        options = Aws::Util.deep_merge(options,
+          auto_scaling_group_name: @group_name,
+          instance_ids: [@id]
+        )
+        resp = @client.attach_instances(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   activity = instance.detach({
+      #     should_decrement_desired_capacity: false, # required
+      #   })
+      # @param [Hash] options ({})
+      # @option options [required, Boolean] :should_decrement_desired_capacity
+      #   If `True`, the Auto Scaling group decrements the desired capacity
+      #   value by the number of instances detached.
+      # @return [Activity::Collection]
+      def detach(options = {})
+        batch = []
+        options = Aws::Util.deep_merge(options,
+          auto_scaling_group_name: @group_name,
+          instance_ids: [@id]
+        )
+        resp = @client.detach_instances(options)
+        resp.data.activities.each do |a|
+          batch << Activity.new(
+            id: a.activity_id,
+            data: a,
+            client: @client
+          )
+        end
+        Activity::Collection.new([batch], size: batch.size)
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   activity = instance.enter_standby({
+      #     should_decrement_desired_capacity: false, # required
+      #   })
+      # @param [Hash] options ({})
+      # @option options [required, Boolean] :should_decrement_desired_capacity
+      #   Specifies whether the instances moved to `Standby` mode count as part
+      #   of the Auto Scaling group's desired capacity. If set, the desired
+      #   capacity for the Auto Scaling group decrements by the number of
+      #   instances moved to `Standby` mode.
+      # @return [Activity::Collection]
+      def enter_standby(options = {})
+        batch = []
+        options = Aws::Util.deep_merge(options,
+          auto_scaling_group_name: @group_name,
+          instance_ids: [@id]
+        )
+        resp = @client.enter_standby(options)
+        resp.data.activities.each do |a|
+          batch << Activity.new(
+            id: a.activity_id,
+            data: a,
+            client: @client
+          )
+        end
+        Activity::Collection.new([batch], size: batch.size)
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   activity = instance.exit_standby()
+      # @param [Hash] options ({})
+      # @return [Activity::Collection]
+      def exit_standby(options = {})
+        batch = []
+        options = Aws::Util.deep_merge(options,
+          auto_scaling_group_name: @group_name,
+          instance_ids: [@id]
+        )
+        resp = @client.exit_standby(options)
+        resp.data.activities.each do |a|
+          batch << Activity.new(
+            id: a.activity_id,
+            data: a,
+            client: @client
+          )
+        end
+        Activity::Collection.new([batch], size: batch.size)
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   instance.set_health({
+      #     health_status: "XmlStringMaxLen32", # required
+      #     should_respect_grace_period: false,
+      #   })
+      # @param [Hash] options ({})
+      # @option options [required, String] :health_status
+      #   The health status of the instance. Set to `Healthy` if you want the
+      #   instance to remain in service. Set to `Unhealthy` if you want the
+      #   instance to be out of service. Auto Scaling will terminate and replace
+      #   the unhealthy instance.
+      # @option options [Boolean] :should_respect_grace_period
+      #   If the Auto Scaling group of the specified instance has a
+      #   `HealthCheckGracePeriod` specified for the group, by default, this
+      #   call will respect the grace period. Set this to `False`, if you do not
+      #   want the call to respect the grace period associated with the group.
+      #
+      #   For more information, see the description of the health check grace
+      #   period for CreateAutoScalingGroup.
+      # @return [EmptyStructure]
+      def set_health(options = {})
+        options = options.merge(instance_id: @id)
+        resp = @client.set_instance_health(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   activity = instance.terminate({
+      #     should_decrement_desired_capacity: false, # required
+      #   })
+      # @param [Hash] options ({})
+      # @option options [required, Boolean] :should_decrement_desired_capacity
+      #   If `true`, terminating the instance also decrements the size of the
+      #   Auto Scaling group.
+      # @return [Activity]
+      def terminate(options = {})
+        options = options.merge(instance_id: @id)
+        resp = @client.terminate_instance_in_auto_scaling_group(options)
+        Activity.new(
+          id: resp.data.activity.activity_id,
+          data: resp.data.activity,
+          client: @client
+        )
+      end
+
+      # @!group Associations
+
+      # @return [AutoScalingGroup]
+      def group
+        AutoScalingGroup.new(
+          name: @group_name,
+          client: @client
+        )
+      end
+
+      # @return [LaunchConfiguration, nil]
+      def launch_configuration
+        if data.launch_configuration_name
+          LaunchConfiguration.new(
+            name: data.launch_configuration_name,
+            client: @client
+          )
+        else
+          nil
+        end
+      end
+
+      # @deprecated
+      # @api private
+      def identifiers
+        {
+          group_name: @group_name,
+          id: @id
+        }
+      end
+      deprecated(:identifiers)
+
+      private
+
+      def extract_group_name(args, options)
+        value = args[0] || options.delete(:group_name)
+        case value
+        when String then value
+        when nil then raise ArgumentError, "missing required option :group_name"
+        else
+          msg = "expected :group_name to be a String, got #{value.class}"
+          raise ArgumentError, msg
+        end
+      end
+
+      def extract_id(args, options)
+        value = args[1] || options.delete(:id)
+        case value
+        when String then value
+        when nil then raise ArgumentError, "missing required option :id"
+        else
+          msg = "expected :id to be a String, got #{value.class}"
+          raise ArgumentError, msg
+        end
+      end
+
+      class Collection < Aws::Resources::Collection
+
+        # @!group Batch Actions
+
+        # @example Request syntax with placeholder values
+        #
+        #   instance.batch_attach()
+        # @param options ({})
+        # @return [void]
+        def batch_attach(options = {})
+          batch_enum.each do |batch|
+            params = Aws::Util.copy_hash(options)
+            params[:auto_scaling_group_name] = batch[0].group_name
+            params[:instance_ids] ||= []
+            batch.each do |item|
+              params[:instance_ids] << {
+                id: item.id
+              }
+            end
+            batch[0].client.attach_instances(params)
+          end
+          nil
+        end
+
+        # @example Request syntax with placeholder values
+        #
+        #   instance.batch_detach({
+        #     should_decrement_desired_capacity: false, # required
+        #   })
+        # @param options ({})
+        # @option options [required, Boolean] :should_decrement_desired_capacity
+        #   If `True`, the Auto Scaling group decrements the desired capacity
+        #   value by the number of instances detached.
+        # @return [void]
+        def batch_detach(options = {})
+          batch_enum.each do |batch|
+            params = Aws::Util.copy_hash(options)
+            params[:auto_scaling_group_name] = batch[0].group_name
+            params[:instance_ids] ||= []
+            batch.each do |item|
+              params[:instance_ids] << {
+                id: item.id
+              }
+            end
+            batch[0].client.detach_instances(params)
+          end
+          nil
+        end
+
+        # @example Request syntax with placeholder values
+        #
+        #   instance.batch_enter_standby({
+        #     should_decrement_desired_capacity: false, # required
+        #   })
+        # @param options ({})
+        # @option options [required, Boolean] :should_decrement_desired_capacity
+        #   Specifies whether the instances moved to `Standby` mode count as part
+        #   of the Auto Scaling group's desired capacity. If set, the desired
+        #   capacity for the Auto Scaling group decrements by the number of
+        #   instances moved to `Standby` mode.
+        # @return [void]
+        def batch_enter_standby(options = {})
+          batch_enum.each do |batch|
+            params = Aws::Util.copy_hash(options)
+            params[:auto_scaling_group_name] = batch[0].group_name
+            params[:instance_ids] ||= []
+            batch.each do |item|
+              params[:instance_ids] << {
+                id: item.id
+              }
+            end
+            batch[0].client.enter_standby(params)
+          end
+          nil
+        end
+
+        # @example Request syntax with placeholder values
+        #
+        #   instance.batch_exit_standby()
+        # @param options ({})
+        # @return [void]
+        def batch_exit_standby(options = {})
+          batch_enum.each do |batch|
+            params = Aws::Util.copy_hash(options)
+            params[:auto_scaling_group_name] = batch[0].group_name
+            params[:instance_ids] ||= []
+            batch.each do |item|
+              params[:instance_ids] << {
+                id: item.id
+              }
+            end
+            batch[0].client.exit_standby(params)
+          end
+          nil
+        end
+
+        # @!endgroup
+
+      end
+    end
+  end
+end

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

@@ -0,0 +1,236 @@
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing for info on making contributions:
+# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+module Aws
+  module AutoScaling
+    class LaunchConfiguration
+
+      extend Aws::Deprecations
+
+      # @overload def initialize(name, options = {})
+      #   @param [String] name
+      #   @option options [Client] :client
+      # @overload def initialize(options = {})
+      #   @option options [required, String] :name
+      #   @option options [Client] :client
+      def initialize(*args)
+        options = Hash === args.last ? args.pop.dup : {}
+        @name = extract_name(args, options)
+        @data = options.delete(:data)
+        @client = options.delete(:client) || Client.new(options)
+      end
+
+      # @!group Read-Only Attributes
+
+      # @return [String]
+      def name
+        @name
+      end
+      alias :launch_configuration_name :name
+
+      # The Amazon Resource Name (ARN) of the launch configuration.
+      # @return [String]
+      def launch_configuration_arn
+        data.launch_configuration_arn
+      end
+
+      # The ID of the Amazon Machine Image (AMI).
+      # @return [String]
+      def image_id
+        data.image_id
+      end
+
+      # The name of the key pair.
+      # @return [String]
+      def key_name
+        data.key_name
+      end
+
+      # The security groups to associate with the instances.
+      # @return [Array<String>]
+      def security_groups
+        data.security_groups
+      end
+
+      # The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances
+      # to. This parameter can only be used if you are launching EC2-Classic
+      # instances. For more information, see [ClassicLink][1] in the *Amazon
+      # Elastic Compute Cloud User Guide*.
+      #
+      #
+      #
+      # [1]: http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
+      # @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`. This parameter is required if you specify a
+      # ClassicLink-enabled VPC, and cannot be used otherwise. For more
+      # information, see [ClassicLink][1] in the *Amazon Elastic Compute Cloud
+      # User Guide*.
+      #
+      #
+      #
+      # [1]: http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html
+      # @return [Array<String>]
+      def classic_link_vpc_security_groups
+        data.classic_link_vpc_security_groups
+      end
+
+      # The user data available to the instances.
+      # @return [String]
+      def user_data
+        data.user_data
+      end
+
+      # The instance type for the instances.
+      # @return [String]
+      def instance_type
+        data.instance_type
+      end
+
+      # The ID of the kernel associated with the AMI.
+      # @return [String]
+      def kernel_id
+        data.kernel_id
+      end
+
+      # The ID of the RAM disk associated with the AMI.
+      # @return [String]
+      def ramdisk_id
+        data.ramdisk_id
+      end
+
+      # A block device mapping, which specifies the block devices for the
+      # instance.
+      # @return [Array<Types::BlockDeviceMapping>]
+      def block_device_mappings
+        data.block_device_mappings
+      end
+
+      # Controls whether instances in this group are launched with detailed
+      # (`true`) or basic (`false`) monitoring.
+      # @return [Types::InstanceMonitoring]
+      def instance_monitoring
+        data.instance_monitoring
+      end
+
+      # The price to bid when launching Spot Instances.
+      # @return [String]
+      def spot_price
+        data.spot_price
+      end
+
+      # The name or Amazon Resource Name (ARN) of the instance profile
+      # associated with the IAM role for the instance.
+      # @return [String]
+      def iam_instance_profile
+        data.iam_instance_profile
+      end
+
+      # The creation date and time for the launch configuration.
+      # @return [Time]
+      def created_time
+        data.created_time
+      end
+
+      # Controls whether the instance is optimized for EBS I/O (`true`) or not
+      # (`false`).
+      # @return [Boolean]
+      def ebs_optimized
+        data.ebs_optimized
+      end
+
+      # \[EC2-VPC\] Indicates whether to assign a public IP address to each
+      # instance.
+      # @return [Boolean]
+      def associate_public_ip_address
+        data.associate_public_ip_address
+      end
+
+      # The tenancy of the instance, either `default` or `dedicated`. An
+      # instance with `dedicated` tenancy runs in an isolated, single-tenant
+      # hardware and can only be launched into a VPC.
+      # @return [String]
+      def placement_tenancy
+        data.placement_tenancy
+      end
+
+      # @!endgroup
+
+      # @return [Client]
+      def client
+        @client
+      end
+
+      # Loads, or reloads {#data} for the current {LaunchConfiguration}.
+      # Returns `self` making it possible to chain methods.
+      #
+      #     launch_configuration.reload.data
+      #
+      # @return [self]
+      def load
+        resp = @client.describe_launch_configurations(launch_configuration_names: [@name])
+        @data = resp.launchconfigurations[0]
+        self
+      end
+      alias :reload :load
+
+      # @return [Types::LaunchConfiguration]
+      #   Returns the data for this {LaunchConfiguration}. Calls
+      #   {Client#describe_launch_configurations} if {#data_loaded?} is `false`.
+      def data
+        load unless @data
+        @data
+      end
+
+      # @return [Boolean]
+      #   Returns `true` if this resource is loaded.  Accessing attributes or
+      #   {#data} on an unloaded resource will trigger a call to {#load}.
+      def data_loaded?
+        !!@data
+      end
+
+      # @!group Actions
+
+      # @example Request syntax with placeholder values
+      #
+      #   launch_configuration.delete()
+      # @param [Hash] options ({})
+      # @return [EmptyStructure]
+      def delete(options = {})
+        options = options.merge(launch_configuration_name: @name)
+        resp = @client.delete_launch_configuration(options)
+        resp.data
+      end
+
+      # @deprecated
+      # @api private
+      def identifiers
+        { name: @name }
+      end
+      deprecated(:identifiers)
+
+      private
+
+      def extract_name(args, options)
+        value = args[0] || options.delete(:name)
+        case value
+        when String then value
+        when nil then raise ArgumentError, "missing required option :name"
+        else
+          msg = "expected :name to be a String, got #{value.class}"
+          raise ArgumentError, msg
+        end
+      end
+
+      class Collection < Aws::Resources::Collection; end
+    end
+  end
+end