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.
Container for the parameters to the CreateRule operation. Creates a rule for the specified listener. The listener must be associated with an Application Load Balancer.
Each rule consists of a priority, one or more actions, and one or more conditions. Rules are evaluated in priority order, from the lowest value to the highest value. When the conditions for a rule are met, its actions are performed. If the conditions for no rules are met, the actions for the default rule are performed. For more information, see Listener rules in the Application Load Balancers Guide.
Namespace: Amazon.ElasticLoadBalancingV2.Model
Assembly: AWSSDK.ElasticLoadBalancingV2.dll
Version: 3.x.y.z
public class CreateRuleRequest : AmazonElasticLoadBalancingV2Request IAmazonWebServiceRequest
The CreateRuleRequest type exposes the following members
Name | Description | |
---|---|---|
CreateRuleRequest() |
Name | Type | Description | |
---|---|---|---|
Actions | System.Collections.Generic.List<Amazon.ElasticLoadBalancingV2.Model.Action> |
Gets and sets the property Actions. The actions. |
|
Conditions | System.Collections.Generic.List<Amazon.ElasticLoadBalancingV2.Model.RuleCondition> |
Gets and sets the property Conditions. The conditions. |
|
ListenerArn | System.String |
Gets and sets the property ListenerArn. The Amazon Resource Name (ARN) of the listener. |
|
Priority | System.Int32 |
Gets and sets the property Priority. The rule priority. A listener can't have multiple rules with the same priority. |
|
Tags | System.Collections.Generic.List<Amazon.ElasticLoadBalancingV2.Model.Tag> |
Gets and sets the property Tags. The tags to assign to the rule. |
This example creates a rule that forwards requests to the specified target group if the URL contains the specified pattern (for example, /img/*).
var client = new AmazonElasticLoadBalancingV2Client(); var response = client.CreateRule(new CreateRuleRequest { Actions = new List<Action> { new Action { TargetGroupArn = "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067", Type = "forward" } }, Conditions = new List<RuleCondition> { new RuleCondition { Field = "path-pattern", Values = new List<string> { "/img/*" } } }, ListenerArn = "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2", Priority = 10 }); List<Rule> rules = response.Rules;
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer, 3.5