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 specified attributes of the specified Application Load Balancer or Network Load Balancer.

If any of the specified attributes can't be modified as requested, the call fails. Any existing attributes that you do not modify retain their current values.

Note:

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

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

Syntax

C#
public virtual ModifyLoadBalancerAttributesResponse ModifyLoadBalancerAttributes(
         ModifyLoadBalancerAttributesRequest request
)
Parameters
request
Type: Amazon.ElasticLoadBalancingV2.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 ElasticLoadBalancingV2.

Exceptions

ExceptionCondition
InvalidConfigurationRequestException The requested configuration is not valid.
LoadBalancerNotFoundException The specified load balancer does not exist.

Examples

This example enables deletion protection for the specified load balancer.

To enable deletion protection


var response = client.ModifyLoadBalancerAttributes(new ModifyLoadBalancerAttributesRequest 
{
    Attributes = new List {
        new LoadBalancerAttribute {
            Key = "deletion_protection.enabled",
            Value = "true"
        }
    },
    LoadBalancerArn = "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"
});

List attributes = response.Attributes;

            

This example changes the idle timeout value for the specified load balancer.

To change the idle timeout


var response = client.ModifyLoadBalancerAttributes(new ModifyLoadBalancerAttributesRequest 
{
    Attributes = new List {
        new LoadBalancerAttribute {
            Key = "idle_timeout.timeout_seconds",
            Value = "30"
        }
    },
    LoadBalancerArn = "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"
});

List attributes = response.Attributes;

            

This example enables access logs for the specified load balancer. Note that the S3 bucket must exist in the same region as the load balancer and must have a policy attached that grants access to the Elastic Load Balancing service.

To enable access logs


var response = client.ModifyLoadBalancerAttributes(new ModifyLoadBalancerAttributesRequest 
{
    Attributes = new List {
        new LoadBalancerAttribute {
            Key = "access_logs.s3.enabled",
            Value = "true"
        },
        new LoadBalancerAttribute {
            Key = "access_logs.s3.bucket",
            Value = "my-loadbalancer-logs"
        },
        new LoadBalancerAttribute {
            Key = "access_logs.s3.prefix",
            Value = "myapp"
        }
    },
    LoadBalancerArn = "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"
});

List attributes = response.Attributes;

            

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