elasticloadbalancingv2/aws.sdk.kotlin.services.elasticloadbalancingv2/ElasticLoadBalancingV2Client/createRule

createRule

abstract suspend fun createRule(input: CreateRuleRequest): CreateRuleResponse

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.

Samples

import aws.sdk.kotlin.services.elasticloadbalancingv2.model.Action
import aws.sdk.kotlin.services.elasticloadbalancingv2.model.ActionTypeEnum
import aws.sdk.kotlin.services.elasticloadbalancingv2.model.RuleCondition

fun main() { 
   //sampleStart 
   // This example creates a rule that forwards requests to the specified target group if the URL contains
// the specified pattern (for example, /img/*).
val resp = elasticLoadBalancingV2Client.createRule {
    listenerArn = "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2"
    conditions = listOf<RuleCondition>(
        RuleCondition {
            field = "path-pattern"
            values = listOf<String>(
                "/img/*"
            )
        }            
    )
    priority = 10
    actions = listOf<Action>(
        Action {
            type = ActionTypeEnum.fromValue("forward")
            targetGroupArn = "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067"
        }            
    )
} 
   //sampleEnd
}