Class AWS::AutoScaling::Instance
In: lib/aws/auto_scaling/instance.rb
Parent: Core::Resource

A small wrapper around an {EC2::Instance}.

## Getting Auto Scaling Instances

If you know the EC2 instance id, you can use {InstanceCollection#[]} to get the Auto Scaling instance.

    instance = auto_scaling.instances['i-1234578']
    instance.health_statue #=> :healthy
    instance.ec2_instance #=> <AWS::EC2::Instance instance_id:i-1234578>

## Enumerating Auto Scaling Instances

You can enumerate ALL instances like so:

    auto_scaling = AWS::AutoScaling.new
    auto_scaling.instances.each do |auto_scaling_instance|
      # ...
    end

If you want the instances for a single auto scaling group:

    group = auto_scaling.groups['group-name']
    group.auto_scaling_instances.each do |instance|
      # ...
    end

If you prefer {EC2::Instance} objects you should use {Group#ec2_instances} instead.

@attr_reader [String] auto_scaling_group_name

@attr_reader [String] launch_configuration_name

@attr_reader [String] health_status Returns the instance health status

  (e.g. 'Healthly' or 'Unhealthly').

@attr_reader [String] availability_zone_name

@attr_reader [String] lifecycle_state

Methods

External Aliases

instance_id -> id

Attributes

instance_id  [R]  @return [String] instance_id Returns the EC2 id instance.

Public Class methods

Public Instance methods

delete(decrement_desired_capacity)

Alias for terminate

@return [Boolean] Returns true if there exists an Auto Scaling

  instance with this instance id.
group()

Alias for auto_scaling_group

@param [String] status Sets the health status of an instance.

  Valid values inculde 'Healthy' and 'Unhealthy'

@param [Hash] options

@option options [Boolean] :respect_grace_period (false) If true,

  this call should respect the grace period associated with
  this instance's Auto Scaling group.

@return [nil]

Terminates the current Auto Scaling instance.

@param [Boolean] decrement_desired_capacity Specifies whether or not

  terminating this instance should also decrement the size of
  the AutoScalingGroup.

@return [Activity] Returns an activity that represents the

  termination of the instance.

Protected Instance methods

[Validate]