The input for the DeleteLoadBalancerListeners action.

]]> The mnemonic name associated with the LoadBalancer.

]]> The client port number(s) of the LoadBalancerListener(s) to be removed.

]]> The output for the DeleteLoadBalancerListeners action.

]]> The input for the SetLoadBalancerPoliciesOfListener action.

]]> The name associated with the LoadBalancer. The name must be unique within the client AWS account.

]]> The external port of the LoadBalancer with which this policy applies to.

]]> List of policies to be associated with the listener. Currently this list can have at most one policy. If the list is empty, the current policy is removed from the listener.

]]> The output for the SetLoadBalancerPoliciesOfListener action.

]]> The input for the EnableAvailabilityZonesForLoadBalancer action.

]]> The name associated with the LoadBalancer. The name must be unique within the client AWS account.

]]> A list of new Availability Zones for the LoadBalancer. Each Availability Zone must be in the same Region as the LoadBalancer.

]]> The output for the EnableAvailabilityZonesForLoadBalancer action.

]]> An updated list of Availability Zones for the LoadBalancer.

]]> The input for the DeregisterInstancesFromLoadBalancer action.

]]> The name associated with the LoadBalancer. The name must be unique within the client AWS account.

]]> A list of EC2 instance IDs consisting of all instances to be deregistered.

]]> The output for the DeregisterInstancesFromLoadBalancer action.

]]> An updated list of remaining instances registered with the LoadBalancer.

]]> The mnemonic name associated with the LoadBalancer. If no name is specified, the operation returns the attributes of either all the sample policies pre-defined by Elastic Load Balancing or the specified sample polices.

]]> The names of LoadBalancer policies you've created or Elastic Load Balancing sample policy names.

]]> The output for the DescribeLoadBalancerPolicies action.

]]> A list of policy description structures.

]]> Specifies the name of the policy types. If no names are specified, returns the description of all the policy types defined by Elastic Load Balancing service.

]]> The output for the DescribeLoadBalancerPolicyTypes action.

]]> List of policy type description structures of the specified policy type. If no policy type names are specified, returns the description of all the policy types defined by Elastic Load Balancing service.

]]> The input for the SetLoadBalancerListenerSSLCertificate action.

]]> The name of the the LoadBalancer.

]]> The port that uses the specified SSL certificate.

]]> The ID of the SSL certificate chain to use. For more information on SSL certificates, see Managing Server Certificates in the AWS Identity and Access Management documentation.

]]> The output for the SetLoadBalancerListenerSSLCertificate action.

]]> The input for the CreateLBCookieStickinessPolicy action.

]]> The name associated with the LoadBalancer. The name must be unique within the client AWS account.

]]> The name of the policy being created. The name must be unique within the set of policies for this LoadBalancer.

]]> The time period in seconds after which the cookie should be considered stale. Not specifying this parameter indicates that the sticky session will last for the duration of the browser session.

]]> The output for the CreateLBCookieStickinessPolicy action.

]]> The input for the DeleteLoadBalancerPolicy action.

]]> The mnemonic name associated with the LoadBalancer. The name must be unique within your AWS account.

]]> The mnemonic name for the policy being deleted.

]]> The output for the DeleteLoadBalancerPolicy action.

]]> The input for the RegisterInstancesWithLoadBalancer action.

]]> The name associated with the LoadBalancer. The name must be unique within the client AWS account.

]]> A list of instance IDs that should be registered with the LoadBalancer.

If you stop and then restart the instance, the instance ID changes. Elastic Load Balancing cannot recognize the new ID, which prevents it from routing traffic to your instance. We recommend you de-register and then register your the new instance ID with the load balancer after you restart your instance. To de-register your instances from load balancer, use DeregisterInstancesFromLoadBalancer action. ]]> The output for the RegisterInstancesWithLoadBalancer action.

]]> An updated list of instances for the LoadBalancer.

]]> Input for the ConfigureHealthCheck action.

]]> The mnemonic name associated with the LoadBalancer. This name must be unique within the client AWS account.

]]> A structure containing the configuration information for the new healthcheck.

]]> The output for the ConfigureHealthCheck action.

]]> The updated healthcheck for the instances.

]]> The input for the DescribeLoadBalancers action.

]]> A list of names associated with the LoadBalancers at creation time.

]]> An optional parameter reserved for future use.

]]> The output for the DescribeLoadBalancers action.

]]> A list of LoadBalancer description structures.

]]> An optional parameter reserved for future use.

]]> Returns the current state of the instances of the specified LoadBalancer. If no instances are specified, the state of all the instances for the LoadBalancer is returned.

]]> The name associated with the LoadBalancer. The name must be unique within the client AWS account.

]]> A list of instance IDs whose states are being queried.

]]> The output for the DescribeInstanceHealth action.

]]> A list containing health information for the specified instances.

]]> The input for the AttachLoadBalancerToSubnets action.

]]> The name associated with the LoadBalancer. The name must be unique within the client AWS account.

]]> A list of subnet IDs to add for the LoadBalancer.

]]> The output for the AttachLoadBalancerToSubnets action.

]]> A list of subnet IDs added for the LoadBalancer.

]]> The input for the DisableAvailabilityZonesForLoadBalancer action.

]]> The name associated with the LoadBalancer. The name must be unique within the client AWS account.

]]> A list of Availability Zones to be removed from the LoadBalancer.

There must be at least one Availability Zone registered with a LoadBalancer at all times. The client cannot remove all the Availability Zones from a LoadBalancer. Specified Availability Zones must be in the same Region. ]]> The output for the DisableAvailabilityZonesForLoadBalancer action.

]]> A list of updated Availability Zones for the LoadBalancer.

]]> The input for the CreateLoadBalancerListeners action.

]]> The name of the new LoadBalancer. The name must be unique within your AWS account.

]]> A list of LoadBalancerPort, InstancePort, Protocol, and SSLCertificateId items.

]]> The output for the CreateLoadBalancerListeners action.

]]> The name associated with the LoadBalancer for which the policy is being created. This name must be unique within the client AWS account.

]]> The name of the LoadBalancer policy being created. The name must be unique within the set of policies for this LoadBalancer.

]]> The name of the base policy type being used to create this policy. To get the list of policy types, use the DescribeLoadBalancerPolicyTypes action.

]]> A list of attributes associated with the policy being created.

]]> The output for the CreateLoadBalancerPolicy action.

]]> The mnemonic name associated with the LoadBalancer. This name must be unique within the client AWS account.

]]> The port number associated with the back-end server.

]]> List of policy names to be set. If the list is empty, then all current polices are removed from the back-end server.

]]> The output for the SetLoadBalancerPoliciesForBackendServer action.

]]> The input for the DetachLoadBalancerFromSubnets action.

]]> The name associated with the LoadBalancer to be detached. The name must be unique within the client AWS account.

]]> A list of subnet IDs to remove from the set of configured subnets for the LoadBalancer.

]]> The output for the DetachLoadBalancerFromSubnets action.

]]> A list of subnet IDs removed from the configured set of subnets for the LoadBalancer.

]]> The input for the ApplySecurityGroupsToLoadBalancer action.

]]> The name associated with the LoadBalancer. The name must be unique within the client AWS account.

]]> A list of security group IDs to associate with your LoadBalancer in VPC. The security group IDs must be provided as the ID and not the security group name (For example, sg-1234).

]]> The out for the ApplySecurityGroupsToLoadBalancer action.

]]> A list of security group IDs associated with your LoadBalancer.

]]> The input for the DeleteLoadBalancer action.

]]> The name associated with the LoadBalancer. The name must be unique within the client AWS account.

]]> The output for the DeleteLoadBalander action.

]]> The input for the CreateLoadBalancer action.

]]> The name associated with the LoadBalancer. The name must be unique within your set of LoadBalancers.

]]> A list of the following tuples: LoadBalancerPort, InstancePort, and Protocol.

]]> A list of Availability Zones.

At least one Availability Zone must be specified. Specified Availability Zones must be in the same EC2 Region as the LoadBalancer. Traffic will be equally distributed across all zones.

This list can be modified after the creation of the LoadBalancer.

]]> A list of subnet IDs in your VPC to attach to your LoadBalancer.

]]> The security groups assigned to your LoadBalancer within your VPC.

]]> The output for the CreateLoadBalancer action.

]]> The DNS name for the LoadBalancer.

]]> The input for the CreateAppCookieStickinessPolicy action.

]]> The name associated with the LoadBalancer. The name must be unique within the client AWS account.

]]> The name of the policy being created. The name must be unique within the set of policies for this LoadBalancer.

]]> Name of the application cookie used for stickiness.

]]> The output for the CreateAppCookieStickinessPolicy action.

]]> The policies data type.

]]> A list of the AppCookieStickinessPolicy objects created with CreateAppCookieStickinessPolicy.

]]> A list of LBCookieStickinessPolicy objects created with CreateAppCookieStickinessPolicy.

]]> A list of policy names other than the stickiness policies.

]]> The PolicyAttributeDescription data type. This data type is used to describe the attributes and values associated with a policy.

]]> The name of the attribute associated with the policy.

]]> The value of the attribute associated with the policy.

]]> The PolicyAttributeTypeDescription data type. This data type is used to describe values that are acceptable for the policy attribute.

]]> The name of the attribute associated with the policy type.

]]> The type of attribute. For example, Boolean, Integer, etc.

]]> A human-readable description of the attribute.

]]> The default value of the attribute, if applicable.

]]> The cardinality of the attribute. Valid Values:

ONE(1) : Single value required
ZERO_OR_ONE(0..1) : Up to one value can be supplied
ZERO_OR_MORE(0..*) : Optional. Multiple values are allowed
ONE_OR_MORE(1..*0) : Required. Multiple values are allowed

]]> The HealthCheck data type.

]]> Specifies the instance being checked. The protocol is either TCP, HTTP, HTTPS, or SSL. The range of valid ports is one (1) through 65535.

TCP is the default, specified as a TCP: port pair, for example "TCP:5000". In this case a healthcheck simply attempts to open a TCP connection to the instance on the specified port. Failure to connect within the configured timeout is considered unhealthy.

SSL is also specified as SSL: port pair, for example, SSL:5000.

For HTTP or HTTPS protocol, the situation is different. You have to include a ping path in the string. HTTP is specified as a HTTP:port;/;PathToPing; grouping, for example "HTTP:80/weather/us/wa/seattle". In this case, a HTTP GET request is issued to the instance on the given port and path. Any answer other than "200 OK" within the timeout period is considered unhealthy.

The total length of the HTTP ping target needs to be 1024 16-bit Unicode characters or less.

]]> Specifies the approximate interval, in seconds, between health checks of an individual instance.

]]> Specifies the amount of time, in seconds, during which no response means a failed health probe.

This value must be less than the Interval value. ]]> Specifies the number of consecutive health probe failures required before moving the instance to the Unhealthy state.

]]> Specifies the number of consecutive health probe successes required before moving the instance to the Healthy state.

]]> The PolicyAttribute data type. This data type contains a key/value pair that defines properties of a specific policy.

]]> The name of the attribute associated with the policy.

]]> The value of the attribute associated with the policy.

]]> The Instance data type.

]]> Provides an EC2 instance ID.

]]> The ListenerDescription data type.

]]> A list of policies enabled for this listener. An empty list indicates that no policies are enabled.

]]> The Listener data type.

]]> Specifies the LoadBalancer transport protocol to use for routing - HTTP, HTTPS, TCP or SSL. This property cannot be modified for the life of the LoadBalancer.

]]> Specifies the external LoadBalancer port number. This property cannot be modified for the life of the LoadBalancer.

]]> Specifies the protocol to use for routing traffic to back-end instances - HTTP, HTTPS, TCP, or SSL. This property cannot be modified for the life of the LoadBalancer.

If the front-end protocol is HTTP or HTTPS, InstanceProtocol has to be at the same protocol layer, i.e., HTTP or HTTPS. Likewise, if the front-end protocol is TCP or SSL, InstanceProtocol has to be TCP or SSL. If there is another listener with the same InstancePort whose InstanceProtocol is secure, i.e., HTTPS or SSL, the listener's InstanceProtocol has to be secure, i.e., HTTPS or SSL. If there is another listener with the same InstancePort whose InstanceProtocol is HTTP or TCP, the listener's InstanceProtocol must be either HTTP or TCP. ]]> Specifies the TCP port on which the instance server is listening. This property cannot be modified for the life of the LoadBalancer.

]]> The ARN string of the server certificate. To get the ARN of the server certificate, call the AWS Identity and Access Management UploadServerCertificate API.

]]> The PolicyDescription data type.

]]> The name mof the policy associated with the LoadBalancer.

]]> The name of the policy type associated with the LoadBalancer.

]]> A list of policy attribute description structures.

]]> The AppCookieStickinessPolicy data type.

]]> The mnemonic name for the policy being created. The name must be unique within a set of policies for this LoadBalancer.

]]> The name of the application cookie used for stickiness.

]]> The PolicyTypeDescription data type.

]]> The name of the policy type.

]]> A human-readable description of the policy type.

]]> The description of the policy attributes associated with the LoadBalancer policies defined by the Elastic Load Balancing service.

]]> This data type is used as a response element in the DescribeLoadBalancers action. For information about Elastic Load Balancing security groups, go to Using Security Groups With Elastic Load Balancing in the Elastic Load Balancing Developer Guide.

]]> Owner of the source security group. Use this value for the --source-group-user parameter of the ec2-authorize command in the Amazon EC2 command line tool.

]]> Name of the source security group. Use this value for the --source-group parameter of the ec2-authorize command in the Amazon EC2 command line tool.

]]> Contains the result of a successful invocation of DescribeLoadBalancers.

]]> Specifies the name associated with the LoadBalancer.

]]> Specifies the external DNS name associated with the LoadBalancer.

]]> Provides the name of the Amazon Route 53 hosted zone that is associated with the LoadBalancer. For information on how to associate your load balancer with a hosted zone, go to Using Domain Names With Elastic Load Balancing in the Elastic Load Balancing Developer Guide.

]]> Provides the ID of the Amazon Route 53 hosted zone name that is associated with the LoadBalancer. For information on how to associate or disassociate your load balancer with a hosted zone, go to Using Domain Names With Elastic Load Balancing in the Elastic Load Balancing Developer Guide.

]]> LoadBalancerPort, InstancePort, Protocol, InstanceProtocol, and PolicyNames are returned in a list of tuples in the ListenerDescriptions element.

]]> Provides a list of policies defined for the LoadBalancer.

]]> Contains a list of back-end server descriptions.

]]> Specifies a list of Availability Zones.

]]> Provides a list of VPC subnet IDs for the LoadBalancer.

]]> Provides the ID of the VPC attached to the LoadBalancer.

]]> Provides a list of EC2 instance IDs for the LoadBalancer.

]]> Specifies information regarding the various health probes conducted on the LoadBalancer.

]]> The security group that you can use as part of your inbound rules for your LoadBalancer's back-end Amazon EC2 application instances. To only allow traffic from LoadBalancers, add a security group rule to your back end instance that specifies this source security group as the inbound source.

]]> The security groups the LoadBalancer is a member of (VPC only).

]]> Provides the date and time the LoadBalancer was created.

]]> The LBCookieStickinessPolicy data type.

]]> The name for the policy being created. The name must be unique within the set of policies for this LoadBalancer.

]]> The time period in seconds after which the cookie should be considered stale. Not specifying this parameter indicates that the stickiness session will last for the duration of the browser session.

]]> This data type is used as a response element in the DescribeLoadBalancers action to describe the configuration of the back-end server.

]]> Provides the port on which the back-end server is listening.

]]> Provides a list of policy names enabled for the back-end server.

]]> The InstanceState data type.

]]> Provides an EC2 instance ID.

]]> Specifies the current status of the instance.

]]> Provides information about the cause of OutOfService instances. Specifically, it indicates whether the cause is Elastic Load Balancing or the instance behind the LoadBalancer.

]]> Provides a description of the instance.

]]> Deletes listeners from the LoadBalancer for the specified port.

]]> Associates, updates, or disables a policy with a listener on the LoadBalancer. You can associate multiple policies with a listener.

]]> Adds one or more EC2 Availability Zones to the LoadBalancer.

The LoadBalancer evenly distributes requests across all its registered Availability Zones that contain instances. As a result, the client must ensure that its LoadBalancer is appropriately scaled for each registered Availability Zone.

The new EC2 Availability Zones to be added must be in the same EC2 Region as the Availability Zones for which the LoadBalancer was created. ]]> Deregisters instances from the LoadBalancer. Once the instance is deregistered, it will stop receiving traffic from the LoadBalancer.

In order to successfully call this API, the same account credentials as those used to create the LoadBalancer must be provided.

]]> Returns detailed descriptions of the policies. If you specify a LoadBalancer name, the operation returns either the descriptions of the specified policies, or descriptions of all the policies created for the LoadBalancer. If you don't specify a LoadBalancer name, the operation returns descriptions of the specified sample policies, or descriptions of all the sample policies. The names of the sample policies have the ELBSample- prefix.

]]> Returns meta-information on the specified LoadBalancer policies defined by the Elastic Load Balancing service. The policy types that are returned from this action can be used in a CreateLoadBalancerPolicy action to instantiate specific policy configurations that will be applied to an Elastic LoadBalancer.

]]> Sets the certificate that terminates the specified listener's SSL connections. The specified certificate replaces any prior certificate that was used on the same LoadBalancer and port.

]]> 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.

When a LoadBalancer implements this policy, the LoadBalancer uses a special cookie to track the backend server instance for each request. When the LoadBalancer receives a request, it first checks to see if this cookie is present in the request. If so, the LoadBalancer sends the request to the application server specified in the cookie. If not, the LoadBalancer sends the request to a server that is chosen based on the existing load balancing algorithm.

A cookie is inserted into the response for binding subsequent requests from the same user to that server. The validity of the cookie is based on the cookie expiration time, which is specified in the policy configuration.

]]> Deletes a policy from the LoadBalancer. The specified policy must not be enabled for any listeners.

]]> Adds new instances to the LoadBalancer.

Once the instance is registered, it starts receiving traffic and requests from the LoadBalancer. Any instance that is not in any of the Availability Zones registered for the LoadBalancer will be moved to the OutOfService state. It will move to the InService state when the Availability Zone is added to the LoadBalancer.

In order for this call to be successful, the client must have created the LoadBalancer. The client must provide the same account credentials as those that were used to create the LoadBalancer. Completion of this API does not guarantee that operation has completed. Rather, it means that the request has been registered and the changes will happen shortly. ]]> Enables the client to define an application healthcheck for the instances.

]]> Returns detailed configuration information for the specified LoadBalancers. If no LoadBalancers are specified, the operation returns configuration information for all LoadBalancers created by the caller.

The client must have created the specified input LoadBalancers in order to retrieve this information; the client must provide the same account credentials as those that were used to create the LoadBalancer. ]]> Returns the current state of the instances of the specified LoadBalancer. If no instances are specified, the state of all the instances for the LoadBalancer is returned.

The client must have created the specified input LoadBalancer in order to retrieve this information; the client must provide the same account credentials as those that were used to create the LoadBalancer. ]]> Adds one or more subnets to the set of configured subnets in the VPC for the LoadBalancer.

The Loadbalancers evenly distribute requests across all of the registered subnets.

]]> Removes the specified EC2 Availability Zones from the set of configured Availability Zones for the LoadBalancer.

There must be at least one Availability Zone registered with a LoadBalancer at all times. A client cannot remove all the Availability Zones from a LoadBalancer. Once an Availability Zone is removed, all the instances registered with the LoadBalancer that are in the removed Availability Zone go into the OutOfService state. Upon Availability Zone removal, the LoadBalancer attempts to equally balance the traffic among its remaining usable Availability Zones. Trying to remove an Availability Zone that was not associated with the LoadBalancer does nothing.

In order for this call to be successful, the client must have created the LoadBalancer. The client must provide the same account credentials as those that were used to create the LoadBalancer. ]]> Creates one or more listeners on a LoadBalancer 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.

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

]]> 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 using CreateLoadBalancerPolicy, 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.

]]> Removes subnets from the set of configured subnets in the VPC for the LoadBalancer.

After a subnet is removed all of the EndPoints registered with the LoadBalancer that are in the removed subnet will go into the OutOfService state. When a subnet is removed, the LoadBalancer will balance the traffic among the remaining routable subnets for the LoadBalancer.

]]> Associates one or more security groups with your LoadBalancer in VPC. The provided security group IDs will override any currently applied security groups.

]]> Deletes the specified LoadBalancer.

If attempting to recreate the LoadBalancer, the client must reconfigure all the settings. The DNS name associated with a deleted LoadBalancer will no longer be usable. Once deleted, the name and associated DNS record of the LoadBalancer no longer exist and traffic sent to any of its IP addresses will no longer be delivered to client instances. The client will not receive the same DNS name even if a new LoadBalancer with same LoadBalancerName is created.

To successfully call this API, the client must provide the same account credentials as were used to create the LoadBalancer.

By design, if the LoadBalancer does not exist or has already been deleted, DeleteLoadBalancer still succeeds. ]]> Creates a new LoadBalancer.

After the call has completed successfully, a new LoadBalancer is created; however, it will not be usable until at least one instance has been registered. When the LoadBalancer creation is completed, the client can check whether or not it is usable by using the DescribeInstanceHealth API. The LoadBalancer is usable as soon as any registered instance is InService.

Currently, the client's quota of LoadBalancers is limited to ten per Region.

LoadBalancer DNS names vary depending on the Region they're created in. For LoadBalancers created in the United States, the DNS name ends with:

us-east-1.elb.amazonaws.com (for the US Standard Region)
us-west-1.elb.amazonaws.com (for the Northern California Region)

For LoadBalancers created in the EU (Ireland) Region, the DNS name ends with:

eu-west-1.elb.amazonaws.com

]]> Generates a stickiness policy with sticky session lifetimes that follow that of an application-generated cookie. This policy can be associated only with HTTP/HTTPS listeners.

This policy is similar to the policy created by CreateLBCookieStickinessPolicy, except that the lifetime of the special Elastic Load Balancing cookie follows the lifetime of the application-generated cookie specified in the policy configuration. The LoadBalancer only inserts a new stickiness cookie when the application response includes a new application cookie.

If the application cookie is explicitly removed or expires, the session stops being sticky until a new application cookie is issued.

An application client must receive and send two cookies: the application-generated cookie and the special Elastic Load Balancing cookie named AWSELB. This is the default behavior for many common web browsers. ]]> Elastic Load Balancing

Elastic Load Balancing is a cost-effective and easy to use web service to help you improve availability and scalability of your application. It makes it easy for you to distribute application loads between two or more EC2 instances. Elastic Load Balancing enables availability through redundancy and supports traffic growth of your application.

]]>