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, Network Load Balancer, or Gateway 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 .NET Core 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 client = new AmazonElasticLoadBalancingV2Client();
var response = client.ModifyLoadBalancerAttributes(new ModifyLoadBalancerAttributesRequest 
{
    Attributes = new List<LoadBalancerAttribute> {
        new LoadBalancerAttribute {
            Key = "deletion_protection.enabled",
            Value = "true"
        }
    },
    LoadBalancerArn = "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"
});

List<LoadBalancerAttribute> attributes = response.Attributes;

            

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

To change the idle timeout


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

List<LoadBalancerAttribute> 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 client = new AmazonElasticLoadBalancingV2Client();
var response = client.ModifyLoadBalancerAttributes(new ModifyLoadBalancerAttributesRequest 
{
    Attributes = new List<LoadBalancerAttribute> {
        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<LoadBalancerAttribute> attributes = response.Attributes;

            

Version Information

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

See Also