VM::EC2::ELB:InstanceState - Object describing the state of an instance attached to a load balancer. It
Contents
Description
This object is used to describe the parameters returned by a DescribeInstanceHealth API call.
Methods
The following object methods are supported:
InstanceId -- The Instance ID of the instance attached to the load balancer
State -- Specifies the current status of the instance
ReasonCode -- Provides information about the cause of OutOfService instances.
Specifically, it indicates whether the cause is Elastic Load Balancing
or the instance behind the load balancer
Description -- Description of why the instance is in the current state
The following convenience methods are supported:
instance -- Provides an L<VM::EC2::Instance> object
Name
VM::EC2::ELB:InstanceState - Object describing the state of an instance attached to a load balancer. It
is the result of a DescribeInstanceHealth API call.
See Also
VM::EC2 VM::EC2::Generic VM::EC2::ELB
String Overloading
When used in a string context, this object will interpolate the instance state.
Synopsis
use VM::EC2;
my $ec2 = VM::EC2->new(...);
my $lb = $ec2->describe_load_balancers('my-lb');
my @instance_ids = map { $_->InstanceId } $lb->Instances();
my @states = $lb->describe_instance_health(-instances => \@instance_ids);
my @down_ids = map { $_->InstanceId } grep { $_->State eq 'OutOfService' } @states;
