Class: Aws::AutoScaling::Instance

Inherits:

Resources::Resource

• Object
• Resources::Resource
• Aws::AutoScaling::Instance

Defined in:

(unknown)

Instance Attribute Summary

• #auto_scaling_group_name ⇒ String readonly

  The name of the Auto Scaling group for the instance.

• #availability_zone ⇒ String readonly

  The Availability Zone for the instance.

• #group_name ⇒ String readonly
• #health_status ⇒ String readonly

  The last reported health status of this instance.

• #id ⇒ String readonly
• #instance_id ⇒ String readonly

  The ID of the instance.

• #instance_type ⇒ String readonly

  The instance type of the EC2 instance.

• #launch_configuration_name ⇒ String readonly

  The launch configuration used to launch the instance.

• #launch_template ⇒ Types::LaunchTemplateSpecification readonly

  The launch template for the instance.

• #lifecycle_state ⇒ String readonly

  The lifecycle state for the instance.

• #protected_from_scale_in ⇒ Boolean readonly

  Indicates whether the instance is protected from termination by Amazon EC2 Auto Scaling when scaling in.

• #weighted_capacity ⇒ String readonly

  The number of capacity units contributed by the instance based on its instance type.

Attributes inherited from Resources::Resource

#client, #identifiers

Instance Method Summary

• #attach ⇒ Struct

  Attaches one or more EC2 instances to the specified Auto Scaling group.

  When you attach instances, Amazon EC2 Auto Scaling increases the desired capacity of the group by the number of instances being attached.

• #detach(options = {}) ⇒ Array<Activity>
• #enter_standby(options = {}) ⇒ Array<Activity>
• #exit_standby ⇒ Array<Activity>
• #group ⇒ AutoScalingGroup
• #initialize ⇒ Object constructor
• #launch_configuration ⇒ LaunchConfiguration^?
• #set_health(options = {}) ⇒ Struct

  Sets the health status of the specified instance.

  For more information, see Health checks for Auto Scaling instances in the Amazon EC2 Auto Scaling User Guide.

  .

• #terminate(options = {}) ⇒ Activity

Methods inherited from Resources::Resource

add_data_attribute, add_identifier, #data, data_attributes, #data_loaded?, identifiers, #load, #wait_until

Methods included from Resources::OperationMethods

#add_batch_operation, #add_operation, #batch_operation, #batch_operation_names, #batch_operations, #operation, #operation_names, #operations

Constructor Details

#initialize(group_name, id, options = {}) ⇒ Object #initialize(options = {}) ⇒ Object

Overloads:

• #initialize(group_name, id, options = {}) ⇒ Object

  Parameters:

  • group_name (String)
  • id (String)

  Options Hash (options):

  • :client (Client) —

    When `:client is not given, the options hash is used to construct a new Client object.

• #initialize(options = {}) ⇒ Object

  Options Hash (options):

  • :group_name (required, String)
  • :id (required, String)
  • :client (Client) —

    When `:client is not given, the options hash is used to construct a new Client object.

Instance Attribute Details

#auto_scaling_group_name ⇒ String (readonly)

The name of the Auto Scaling group for the instance.

Returns:

• (String) —

  The name of the Auto Scaling group for the instance.

#availability_zone ⇒ String (readonly)

The Availability Zone for the instance.

Returns:

• (String) —

  The Availability Zone for the instance.

#group_name ⇒ String (readonly)

Returns:

• (String)

#health_status ⇒ String (readonly)

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.

Returns:

• (String) —

  The last reported health status of this instance.

#id ⇒ String (readonly)

Returns:

• (String)

#instance_id ⇒ String (readonly)

The ID of the instance.

Returns:

• (String) —

  The ID of the instance.

#instance_type ⇒ String (readonly)

The instance type of the EC2 instance.

Returns:

• (String) —

  The instance type of the EC2 instance.

#launch_configuration_name ⇒ String (readonly)

The launch configuration used to launch the instance. This value is not available if you attached the instance to the Auto Scaling group.

Returns:

• (String) —

  The launch configuration used to launch the instance.

#launch_template ⇒ Types::LaunchTemplateSpecification (readonly)

The launch template for the instance.

Returns:

• (Types::LaunchTemplateSpecification) —

  The launch template for the instance.

#lifecycle_state ⇒ String (readonly)

The lifecycle state for the instance.

Returns:

• (String) —

  The lifecycle state for the instance.

#protected_from_scale_in ⇒ Boolean (readonly)

Indicates whether the instance is protected from termination by Amazon EC2 Auto Scaling when scaling in.

Returns:

• (Boolean) —

  Indicates whether the instance is protected from termination by Amazon EC2 Auto Scaling when scaling in.

#weighted_capacity ⇒ String (readonly)

The number of capacity units contributed by the instance based on its instance type.

Valid Range: Minimum value of 1. Maximum value of 999.

Returns:

• (String) —

  The number of capacity units contributed by the instance based on its instance type.

Instance Method Details

#attach ⇒ Struct

Attaches one or more EC2 instances to the specified Auto Scaling group.

When you attach instances, Amazon EC2 Auto Scaling increases the desired capacity of the group by the number of instances being attached. If the number of instances being attached plus the desired capacity of the group exceeds the maximum size of the group, the operation fails.

If there is a Classic Load Balancer attached to your Auto Scaling group, the instances are also registered with the load balancer. If there are target groups attached to your Auto Scaling group, the instances are also registered with the target groups.

For more information, see Attach EC2 instances to your Auto Scaling group in the Amazon EC2 Auto Scaling User Guide.

Examples:

Request syntax example with placeholder values

instance.attach()

Returns:

• (Struct) —

  Returns an empty response.

See Also:

• Client#attach_instances

#detach(options = {}) ⇒ Array<Activity>

Examples:

Request syntax example with placeholder values

instance.detach({
  should_decrement_desired_capacity: false, # required
})

Basic usage

activitys = instance.detach(options)
activitys.map(&:id)
#=> ["activity-id", ...]

Options Hash (options):

• :should_decrement_desired_capacity (required, Boolean) —

  Indicates whether the Auto Scaling group decrements the desired capacity value by the number of instances detached.

Returns:

• (Array<Activity>)

See Also:

• #enter_standby
• #exit_standby
• #terminate
• Client#detach_instances

#enter_standby(options = {}) ⇒ Array<Activity>

Examples:

Request syntax example with placeholder values

instance.enter_standby({
  should_decrement_desired_capacity: false, # required
})

Basic usage

activitys = instance.enter_standby(options)
activitys.map(&:id)
#=> ["activity-id", ...]

Options Hash (options):

• :should_decrement_desired_capacity (required, Boolean) —

  Indicates whether to decrement the desired capacity of the Auto Scaling group by the number of instances moved to Standby mode.

Returns:

• (Array<Activity>)

See Also:

• #detach
• #exit_standby
• #terminate
• Client#enter_standby

#exit_standby ⇒ Array<Activity>

Examples:

Request syntax example with placeholder values

instance.exit_standby()

Basic usage

activitys = instance.exit_standby(options)
activitys.map(&:id)
#=> ["activity-id", ...]

Returns:

• (Array<Activity>)

See Also:

• #detach
• #enter_standby
• #terminate
• Client#exit_standby

#group ⇒ AutoScalingGroup

Returns:

• (AutoScalingGroup)

#launch_configuration ⇒ LaunchConfiguration^?

Returns:

• (LaunchConfiguration, nil)

#set_health(options = {}) ⇒ Struct

Sets the health status of the specified instance.

For more information, see Health checks for Auto Scaling instances in the Amazon EC2 Auto Scaling User Guide.

Examples:

Request syntax example with placeholder values

instance.set_health({
  health_status: "XmlStringMaxLen32", # required
  should_respect_grace_period: false,
})

Options Hash (options):

• :health_status (required, String) —

  The health status of the instance. Set to Healthy to have the instance remain in service. Set to Unhealthy to have the instance be out of service. Amazon EC2 Auto Scaling terminates and replaces the unhealthy instance.

• :should_respect_grace_period (Boolean) —

  If the Auto Scaling group of the specified instance has a HealthCheckGracePeriod specified for the group, by default, this call respects the grace period. Set this to False, to have the call not respect the grace period associated with the group.

  For more information about the health check grace period, see CreateAutoScalingGroup in the Amazon EC2 Auto Scaling API Reference.

Returns:

• (Struct) —

  Returns an empty response.

See Also:

• Client#set_instance_health

#terminate(options = {}) ⇒ Activity

Examples:

Request syntax example with placeholder values

instance.terminate({
  should_decrement_desired_capacity: false, # required
})

Basic usage

activity = instance.terminate(options)
activity.id
#=> "activity-id"

Options Hash (options):

• :should_decrement_desired_capacity (required, Boolean) —

  Indicates whether terminating the instance also decrements the size of the Auto Scaling group.

Returns:

• (Activity)

See Also:

• #detach
• #enter_standby
• #exit_standby
• Client#terminate_instance_in_auto_scaling_group