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 default action, use ModifyListener.

Note:

For 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

Syntax

C#
public virtual ModifyRuleResponse ModifyRule(
         ModifyRuleRequest request
)
Parameters
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.

Exceptions

ExceptionCondition
IncompatibleProtocolsException The specified configuration is not valid with this protocol.
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.
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.

Examples

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 {
                "/images/*"
            }
        }
    },
    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