DisableAvailabilityZonesForLoadBalancer

Amazon Elastic Load Balancing: 2009-05-15

previous page next page

DisableAvailabilityZonesForLoadBalancer

Description

This API removes the specified EC2 Availability Zones from the set of configured Availability Zones for the 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.

There must be at least one Availability Zone registered with a LoadBalancer at all times. You cannot remove all the Availability Zones from a LoadBalancer.

In order for this call to be successful, you must have created the LoadBalancer. In other words, 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

NameDescriptionRequired

AvailabilityZones

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. You cannot remove all the Availability Zones from a LoadBalancer. Specified Availability Zones must be in the same region.

Default: None

Type:

AvailabilityZones
[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

List of updated Availability Zones for the LoadBalancer.

Type: AvailabilityZones

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

InvalidConfigurationRequest

Requested configuration change is invalid. This error is returned if you attempt to remove all the registered Availability Zones for the LoadBalancer.

409 Conflict 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-1a
 &LoadBalancerName=ReferenceAP2
 &Action=DisableAvailabilityZonesForLoadBalancer
 &Version=2009-05-15
 &AWSAccessKeyId=XXX YOUR ACCESS KEY XXX
 &SignatureVersion=2
 &SignatureMethod=HmacSHA1
 &Timestamp=2009-10-17T05%3A13%3A43.000Z
 &Signature=%XXX YOUR SIGNATURE XXX%3D

Sample Response

Example Query Response 

<DisableAvailabilityZonesForLoadBalancerResult>
	<AvailabilityZones>
		<member>us-east-1c</member>
	</AvailabilityZones>
</DisableAvailabilityZonesForLoadBalancerResult>

EnableAvailabilityZonesForLoadBalancer

previous page start next page