IAmazonElasticLoadBalancingV2.ModifyRule Method (ModifyRuleRequest)

Replaces the specified properties of the specified rule. Any properties that you do not specify are unchanged.

To add an item to a list, remove an item from a list, or update an item in a list, you must provide the entire list. For example, to add an action, specify a list with the current actions plus the new action.

Note:

For .NET Core 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

public abstract ModifyRuleResponse ModifyRule(
         ModifyRuleRequest request
)

Parameters

request: Type: Amazon.ElasticLoadBalancingV2.Model.ModifyRuleRequest

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

Return Value

Type: ModifyRuleResponse

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

Exceptions

Exception	Condition
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.
TooManyUniqueTargetGroupsPerLoadBalancerException	You've reached the limit on the number of unique target groups per load balancer across all listeners. If a target group is used by multiple actions for a load balancer, it is counted as only one use.
UnsupportedProtocolException	The specified protocol is not supported.

Examples

This example modifies the condition for the specified rule.

To modify a rule


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

List<Rule> rules = response.Rules;

Version Information

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

IAmazonElasticLoadBalancingV2.ModifyRule (ModifyRuleRequest)

Method