AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Removes the specified Availability Zones from the set of Availability Zones for the specified load balancer.

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 Balancer Guide.

Note:

For PCL 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

C#
public abstract DisableAvailabilityZonesForLoadBalancerResponse DisableAvailabilityZonesForLoadBalancer(
         DisableAvailabilityZonesForLoadBalancerRequest request
)
Parameters
request
Type: Amazon.ElasticLoadBalancing.Model.DisableAvailabilityZonesForLoadBalancerRequest

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

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

Exceptions

ExceptionCondition
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 response = client.DisableAvailabilityZonesForLoadBalancer(new DisableAvailabilityZonesForLoadBalancerRequest 
{
    AvailabilityZones = new List {
        "us-west-2a"
    },
    LoadBalancerName = "my-load-balancer"
});

List availabilityZones = response.AvailabilityZones;

            

Version Information

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

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also