Elastic Load Balancing

Amazon describes the service as:

Elastic Load Balancing automatically distributes incoming application traffic across multiple Amazon EC2 instances. It enables you to achieve even greater fault tolerance in your applications, seamlessly providing the amount of load balancing capacity needed in response to incoming application traffic. Elastic Load Balancing detects unhealthy instances within a pool and automatically reroutes traffic to healthy instances until the unhealthy instances have been restored. Customers can enable Elastic Load Balancing within a single Availability Zone or across multiple zones for even more consistent application performance. Amazon

Service List

elb-configure-healthcheck
elb-create-lb
elb-delete-lb
elb-deregister-instances-from-lb
elb-describe-instance-health
elb-describe-lbs
elb-disable-zones-for-lb
elb-enable-zones-for-lb
elb-register-instances-with-lb
elb-version

elb-configure-healthcheck

Service List | Table of Contents

SYNOPSIS
elb-configure-healthcheck
LoadBalancerName --healthy-threshold value --interval value
--target value --timeout value --unhealthy-threshold value
[General Options]

DESCRIPTION
Configure the parameters for checking the health of instances registered
with a LoadBalancer. When the instance fails to respond within timeout
seconds to unhealthy-threshold number of consecutive healthcheck requests,
the instance will be marked as OutOfService. Likewise, when an instance
responds within the specified timeout to healthy-threshold number of
consecutive healthcheck requests, it is marked as InService. target
specifies the protocol and port, and in the case of HTTP.

ARGUMENTS
LoadBalancerName
Name of the LoadBalancer. You can also set this value using "--lb".
Required.

SPECIFIC OPTIONS
--healthy-threshold VALUE
Number of consecutive successful healthchecks that will mark an instance
as InService. Required.

--interval VALUE
Healthcheck interval in seconds. Required.

-t, --target VALUE
Target for healthcheck. : or :/.
Required.

--timeout VALUE
Healthcheck timeout in seconds. Required.

--unhealthy-threshold VALUE
Number of consecutive failed healthchecks that will mark an instance as
OutOfService. Required.

GENERAL OPTIONS
--aws-credential-file VALUE
Location of the file with your AWS credentials. This value can be set by
using the environment variable 'AWS_CREDENTIAL_FILE'.

--connection-timeout VALUE
Specify a connection timeout VALUE (in seconds). The default value is
'30'.

--delimiter VALUE
What delimiter to use when displaying delimited (long) results.

--ec2-cert-file-path VALUE
Location of the file with your EC2 X509 certificate. This value can be
set by using the environment variable 'EC2_CERT'.

--ec2-private-key-file-path VALUE
Location of the file with your EC2 private key. This value can be set by
using the environment variable 'EC2_PRIVATE_KEY'.

--headers
If you are displaying tabular or delimited results, it includes the
column headers. If you are showing xml results, it returns the HTTP
headers from the service request, if applicable. This is off by default.

-I, --access-key-id VALUE
Specify VALUE as the AWS Access Id to use.

--region VALUE
Specify region VALUE as the web service region to use. This value can be
set by using the environment variable 'EC2_REGION'.

-S, --secret-key VALUE
Specify VALUE as the AWS Secret Key to use.

--show-empty-fields
Show empty fields and rows, using a "(nil)" value. The default is to not
show empty fields or columns.

--show-request
Displays the URL the tools used to call the AWS Service. The default
value is 'false'.

--show-table, --show-long, --show-xml, --quiet
Specify how the results are displayed: tabular, delimited (long), xml, or
no output (quiet). Tabular shows a subset of the data in fixed
column-width form, while long shows all of the returned values delimited
by a character. The xml is the raw return from the service, while quiet
suppresses all standard output. The default is tabular, or 'show-table'.

-U, --url VALUE
This option will override the URL for the service call with VALUE. This
value can be set by using the environment variable 'AWS_ELB_URL'.

INPUT EXAMPLES

Configure a TCP healthcheck with target port 8080
$PROMPT> elb-configure-healthcheck example-lb --headers --target "TCP:8080" --interval 5 --timeout 3 --unhealthy-threshold 2 --healthy-threshold 2

Configure an HTTP healthcheck with target port 80 with a path
$PROMPT> elb-configure-healthcheck example-lb --headers --target "HTTP:80/status" --interval 5 --timeout 3 --unhealthy-threshold 2 --healthy-threshold 2

OUTPUT
This command returns a table that contains the following:
* TARGET - Healthcheck target.
* INTERVAL - Interval between healthchecks in seconds.
* TIMEOUT - Healthcheck timeout in seconds.
* HEALTHY-THRESHOLD - Configured number of consecutive successful
healthchecks that will mark an instance as InService.
* UNHEALTHY-THRESHOLD - Configured number of consecutive failed healthchecks
that will mark an instance as OutOfService.

OUTPUT EXAMPLES

HEALTH-CHECK TARGET INTERVAL TIMEOUT HEALTHY-THRESHOLD UNHEALTHY-THRESHOLD
HEALTH-CHECK HTTP:8080/status 5 3 2 2

elb-create-lb

Service List | Table of Contents

SYNOPSIS
elb-create-lb
LoadBalancerName --availability-zones value[,value...] --listener
"protocol=value, lb-port=value, instance-port=value" [ --listener
"protocol=value, lb-port=value, instance-port=value" ...]
[General Options]

DESCRIPTION
Create a new LoadBalancer

ARGUMENTS
LoadBalancerName
Name of the LoadBalancer. You can also set this value using "--lb".
Required.

SPECIFIC OPTIONS
-l, --listener "protocol=value, lb-port=value, instance-port=value" [ --listener "protocol=value, lb-port=value, instance-port=value" ...]
Port and protocol configuration for the LoadBalancer. For Windows, each
listener must be surrounded in quotes. Required.

-z, --availability-zones VALUE1,VALUE2,VALUE3...
Availability zones configured for the LoadBalancer. Required.