This object represents an Amazon Elastic Load Balancer and is returned by VM::EC2->describe_load_balancers() and VM::EC2->create_load_balancer(). In addition to methods to query the ELB's attributes, there are methods that manage the ELB's lifecycle and properties.

AvailabilityZones -- The enabled availability zones for the ELB in the
form of an array of L<VM::EC2::AvailabilityZone>
objects.
BackendServerDescriptions -- The backend server descriptions.
CreatedTime -- The creation date of the ELB.
DNSName -- The DNS name of the ELB.
HealthCheck -- The health check associated with the ELB in the
form of a L<VM::EC2::ELB::HealthCheck> object.
Instances -- The instances that the ELB points to, in the form
of an array of L<VM::EC2::Instance> objects.
ListenerDescriptions -- An array of L<VM::EC2::ELB::ListenerDescription>
objects.
LoadBalancerName -- The name of the ELB
Policies -- The policies of the ELB in the form of a
L<VM::EC2::ELB::Policies> object.
Scheme -- Specifies the type of ELB ('internal' is for VPC
only.)
SecurityGroups -- The security groups the ELB is a member of (VPC
only) in the form of L<VM::EC2::SecurityGroup>
objects.
SourceSecurityGroup -- The security group that the ELB is a member of
Subnets -- Provides an array of VPC subnet objects
(L<VM::EC2::VPC::Subnet>) that the ELB is part of.
VPCId -- Provides the ID of the VPC attached to the ELB.

CanonicalHostedZoneName -- The name of the Amazon Route 53 hosted zone that
is associated with the ELB.
CanonicalHostedZoneNameID -- The ID of the Amazon Route 53 hosted zone name
that is associated with the ELB.

The following convenience methods are supported;

active_policies -- Returns the policies that are actively in use by
the ELB in the form of L<VM::EC2::ELB::PolicyDescription>
objects.
all_policies -- Returns all policies that are associated with the
ELB in the form of L<VM::EC2::ELB::PolicyDescription>
objects.
listeners -- Provides the L<VM::EC2::ELB::Listener> objects
associated with the ELB

Generates a stickiness policy with sticky session lifetimes controlled by the lifetime of the browser (user-agent) or a specified expiration period. This policy can be associated only with HTTP/HTTPS listeners. Returns true on success.

Creates one or more listeners on a ELB for the specified port. If a listener with the given port does not already exist, it will be created; otherwise, the properties of the new listener must match the properties of the existing listener. Returns true on success.

The passed argument must either be a VM::EC2::ELB:Listener object (or arrayref of objects) or a hash (or arrayref of hashes) containing the following keys:

Adds new instances to the ELB. If the instance is in an availability zone that is not registered with the ELB will be in the OutOfService state. Once the zone is added to the ELB the instance will go into the InService state. Returns an array of instance IDs now associated with the ELB.

Provides the current state of the instances of the specified LoadBalancer. If no instances are specified, the state of all the instances for the ELB is returned. Returns an array of VM::EC2::ELB::InstanceState objects.

Creates a new policy that contains the necessary attributes depending on the policy type. Policies are settings that are saved for your ELB and that can be applied to the front-end listener, or the back-end application server, depending on your policy type. Returns true on success.

This method configures the health check for a particular target service.

-target must be in the format Protocol:Port[/PathToPing]: - Valid Protocol types are: HTTP, HTTPS, TCP, SSL - Port must be in range 0-65535 - PathToPing is only applicable to HTTP or HTTPS protocol types and must be 1024 characters long or fewer.

Replaces the current set of policies associated with a port on which the back- end server is listening with a new set of policies. After the policies have been created, they can be applied here as a list. At this time, only the back- end server authentication policy type can be applied to the back-end ports; this policy type is composed of multiple public key policies. Returns true on success.

This package and its accompanying libraries is free software; you can redistribute it and/or modify it under the terms of the GPL (either version 1, or at your option, any later version) or the Artistic License 2.0. Refer to LICENSE for the full license text. In addition, please see DISCLAIMER.txt for disclaimers of warranty.