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 rule.

Any existing properties that you do not modify retain their current values.

To modify the actions for the default rule, use ModifyListener.


For .NET Core and PCL this operation is only available in asynchronous form. Please refer to ModifyRuleAsync.

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


public abstract ModifyRuleResponse ModifyRule(
         ModifyRuleRequest request
Type: Amazon.ElasticLoadBalancingV2.Model.ModifyRuleRequest

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

Return Value
The response from the ModifyRule service method, as returned by ElasticLoadBalancingV2.


IncompatibleProtocolsException The specified configuration is not valid with this protocol.
InvalidLoadBalancerActionException The requested action is not valid.
OperationNotPermittedException This operation is not allowed.
RuleNotFoundException The specified rule does not exist.
TargetGroupAssociationLimitException You've reached the limit on the number of load balancers per target group.
TargetGroupNotFoundException The specified target group does not exist.
TooManyActionsException You've reached the limit on the number of actions per rule.
TooManyRegistrationsForTargetIdException You've reached the limit on the number of times a target can be registered with a load balancer.
TooManyTargetsException You've reached the limit on the number of targets.
UnsupportedProtocolException The specified protocol is not supported.


This example modifies the condition for the specified rule.

To modify a rule

var response = client.ModifyRule(new ModifyRuleRequest 
    Conditions = new List {
        new RuleCondition {
            Field = "path-pattern",
            Values = new List {
    RuleArn = "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee"

List rules = response.Rules;


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