AmazonElasticLoadBalancingClient.DisableAvailabilityZonesForLoadBalancer Method (DisableAvailabilityZonesForLoadBalancerRequest)

Removes the specified Availability Zones from the set of Availability Zones for the specified load balancer in EC2-Classic or a default VPC.

For load balancers in a non-default VPC, use DetachLoadBalancerFromSubnets.

There must be at least one Availability Zone registered with a load balancer at all times. After an Availability Zone is removed, all instances registered with the load balancer that are in the removed Availability Zone go into the OutOfService state. Then, the load balancer attempts to equally balance the traffic among its remaining Availability Zones.

For more information, see Add or Remove Availability Zones in the Classic Load Balancers Guide.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to DisableAvailabilityZonesForLoadBalancerAsync.

Namespace: Amazon.ElasticLoadBalancing
Assembly: AWSSDK.ElasticLoadBalancing.dll
Version: 3.x.y.z

Syntax

public virtual DisableAvailabilityZonesForLoadBalancerResponse DisableAvailabilityZonesForLoadBalancer(
         DisableAvailabilityZonesForLoadBalancerRequest request
)

Parameters

request: Type: Amazon.ElasticLoadBalancing.Model.DisableAvailabilityZonesForLoadBalancerRequest

Container for the necessary parameters to execute the DisableAvailabilityZonesForLoadBalancer service method.

Return Value

Type: DisableAvailabilityZonesForLoadBalancerResponse

The response from the DisableAvailabilityZonesForLoadBalancer service method, as returned by ElasticLoadBalancing.

Exceptions

Exception	Condition
AccessPointNotFoundException	The specified load balancer does not exist.
InvalidConfigurationRequestException	The requested configuration change is not valid.

Examples

This example removes the specified Availability Zone from the set of Availability Zones for the specified load balancer.

To disable an Availability Zone for a load balancer


var client = new AmazonElasticLoadBalancingClient();
var response = client.DisableAvailabilityZonesForLoadBalancer(new DisableAvailabilityZonesForLoadBalancerRequest 
{
    AvailabilityZones = new List<string> {
        "us-west-2a"
    },
    LoadBalancerName = "my-load-balancer"
});

List<string> availabilityZones = response.AvailabilityZones;

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

AmazonElasticLoadBalancingClient.DisableAvailabilityZonesForLoadBalancer (DisableAvailabilityZonesForLoadBalancerRequest)

Method