EnableAvailabilityZonesForLoadBalancer

Amazon Elastic Load Balancing: 2009-05-15

previous page next page

EnableAvailabilityZonesForLoadBalancer

Description

This API is used to add 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, you must ensure that your LoadBalancer is appropriately scaled for each registered Availability Zone.

[Note]Note

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.

In order to successfully call this API, you must provide the same account credentials as those that were used to create the LoadBalancer.

Request Parameters

Name Description Required

AvailabilityZones

List of new Availability Zones for the LoadBalancer. The Availability Zone must be in the same region as the LoadBalancer.

Type: AvailabilityZones

Default: None

[Note]Note

Some API operations take lists of parameters. These lists are specified using the following notation: param.member.n. Values of n are integers starting from 1. All lists of parameters must follow this notation, including lists that only contain one parameter. For example, a Query parameter list looks like this:

&attribute.member.1=this
&attribute.member.2=that

Yes

LoadBalancerName

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

Type: String

Default: None

Constraints: Must only use alphanumeric characters (case sensitive) and dash (-). Dash cannot be first or last character. Maximum length of name is 32 characters (characters are 16-bit Unicode).

Yes

Response Elements

Name Description

AvailabilityZones

Updated list of Availability Zones for the LoadBalancer.

Type: AvailabilityZones

Availability: Always returned

Special Errors

Common errors for all calls are listed and described in a separate section, please see API Error Codes.

Error Description HTTP Status Code SOAP Prefix

LoadBalancerNotFound

LoadBalancer name does not exist for the account in this region. (For more information, please see LoadBalancer.)

400 Bad Request Client

ValidationError

One or more input parameters are invalid.

400 Bad Request Client

Examples

Sample Request

Example Request (Query) 

 https://elasticloadbalancing.amazonaws.com /
 ?AvailabilityZones.member.1=us-east-1c
 &LoadBalancerName=ReferenceAP1
 &Action=EnableAvailabilityZonesForLoadBalancer
 &Version=2009-05-15
 &AWSAccessKeyId=XXX YOUR ACCESS KEY XXX
 &SignatureVersion=2
 &SignatureMethod=HmacSHA1
 &Timestamp=2009-10-17T05%3A13%3A00.000Z
 &Signature=%XXX YOUR SIGNATURE XXX%3D

Sample Response

Example Query Response 

<EnableAvailabilityZonesForLoadBalancerResult>
	<AvailabilityZones>
		<member>us-east-1c</member>
		<member>us-east-1b</member>
		<member>us-east-1a</member>
	</AvailabilityZones>
</EnableAvailabilityZonesForLoadBalancerResult>

previous page start next page