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.

Modifies the attributes of the specified load balancer.

You can modify the load balancer attributes, such as AccessLogs, ConnectionDraining, and CrossZoneLoadBalancing by either enabling or disabling them. Or, you can modify the load balancer attribute ConnectionSettings by specifying an idle connection timeout value for your load balancer.

For more information, see the following in the Classic Load Balancer Guide:

Note:

For PCL this operation is only available in asynchronous form. Please refer to ModifyLoadBalancerAttributesAsync.

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

Syntax

C#
public abstract ModifyLoadBalancerAttributesResponse ModifyLoadBalancerAttributes(
         ModifyLoadBalancerAttributesRequest request
)
Parameters
request
Type: Amazon.ElasticLoadBalancing.Model.ModifyLoadBalancerAttributesRequest

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

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

Exceptions

ExceptionCondition
AccessPointNotFoundException The specified load balancer does not exist.
InvalidConfigurationRequestException The requested configuration change is not valid.
LoadBalancerAttributeNotFoundException The specified load balancer attribute does not exist.

Examples

This example enables cross-zone load balancing for the specified load balancer.

To enable cross-zone load balancing


var response = client.ModifyLoadBalancerAttributes(new ModifyLoadBalancerAttributesRequest 
{
    LoadBalancerAttributes = new LoadBalancerAttributes { CrossZoneLoadBalancing = new CrossZoneLoadBalancing { Enabled = true } },
    LoadBalancerName = "my-load-balancer"
});

LoadBalancerAttributes loadBalancerAttributes = response.LoadBalancerAttributes;
string loadBalancerName = response.LoadBalancerName;

            

This example enables connection draining for the specified load balancer.

To enable connection draining


var response = client.ModifyLoadBalancerAttributes(new ModifyLoadBalancerAttributesRequest 
{
    LoadBalancerAttributes = new LoadBalancerAttributes { ConnectionDraining = new ConnectionDraining {
        Enabled = true,
        Timeout = 300
    } },
    LoadBalancerName = "my-load-balancer"
});

LoadBalancerAttributes loadBalancerAttributes = response.LoadBalancerAttributes;
string loadBalancerName = response.LoadBalancerName;

            

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