ApplicationListenerRuleProps

class aws_cdk.aws_elasticloadbalancingv2.ApplicationListenerRuleProps(*, priority, action=None, conditions=None, fixed_response=None, host_header=None, path_pattern=None, path_patterns=None, redirect_response=None, target_groups=None, listener)

Bases: aws_cdk.aws_elasticloadbalancingv2.BaseApplicationListenerRuleProps

Properties for defining a listener rule.

Parameters
  • priority (Union[int, float]) – Priority of the rule. The rule with the lowest priority will be used for every request. Priorities must be unique.

  • action (Optional[ListenerAction]) – Action to perform when requests are received. Only one of action, fixedResponse, redirectResponse or targetGroups can be specified. Default: - No action

  • conditions (Optional[List[ListenerCondition]]) – Rule applies if matches the conditions. Default: - No conditions.

  • fixed_response (Optional[FixedResponse]) – (deprecated) Fixed response to return. Only one of action, fixedResponse, redirectResponse or targetGroups can be specified. Default: - No fixed response.

  • host_header (Optional[str]) – (deprecated) Rule applies if the requested host matches the indicated host. May contain up to three ‘*’ wildcards. Default: - No host condition.

  • path_pattern (Optional[str]) – (deprecated) Rule applies if the requested path matches the given path pattern. Default: - No path condition.

  • path_patterns (Optional[List[str]]) – (deprecated) Rule applies if the requested path matches any of the given patterns. Paths may contain up to three ‘*’ wildcards. Default: - No path conditions.

  • redirect_response (Optional[RedirectResponse]) – (deprecated) Redirect response to return. Only one of action, fixedResponse, redirectResponse or targetGroups can be specified. Default: - No redirect response.

  • target_groups (Optional[List[IApplicationTargetGroup]]) – Target groups to forward requests to. Only one of action, fixedResponse, redirectResponse or targetGroups can be specified. Implies a forward action. Default: - No target groups.

  • listener (IApplicationListener) – The listener to attach the rule to.

Attributes

action

Action to perform when requests are received.

Only one of action, fixedResponse, redirectResponse or targetGroups can be specified.

Default
  • No action

Return type

Optional[ListenerAction]

conditions

Rule applies if matches the conditions.

Default
  • No conditions.

See

https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-listeners.html

Return type

Optional[List[ListenerCondition]]

fixed_response

(deprecated) Fixed response to return.

Only one of action, fixedResponse, redirectResponse or targetGroups can be specified.

Default
  • No fixed response.

Deprecated

Use action instead.

Stability

deprecated

Return type

Optional[FixedResponse]

host_header

(deprecated) Rule applies if the requested host matches the indicated host.

May contain up to three ‘*’ wildcards.

Default
  • No host condition.

Deprecated

Use conditions instead.

See

https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-listeners.html#host-conditions

Stability

deprecated

Return type

Optional[str]

listener

The listener to attach the rule to.

Return type

IApplicationListener

path_pattern

(deprecated) Rule applies if the requested path matches the given path pattern.

Default
  • No path condition.

Deprecated

Use conditions instead.

See

https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-listeners.html#path-conditions

Stability

deprecated

Return type

Optional[str]

path_patterns

(deprecated) Rule applies if the requested path matches any of the given patterns.

Paths may contain up to three ‘*’ wildcards.

Default
  • No path conditions.

Deprecated

Use conditions instead.

See

https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-listeners.html#path-conditions

Stability

deprecated

Return type

Optional[List[str]]

priority

Priority of the rule.

The rule with the lowest priority will be used for every request.

Priorities must be unique.

Return type

Union[int, float]

redirect_response

(deprecated) Redirect response to return.

Only one of action, fixedResponse, redirectResponse or targetGroups can be specified.

Default
  • No redirect response.

Deprecated

Use action instead.

Stability

deprecated

Return type

Optional[RedirectResponse]

target_groups

Target groups to forward requests to.

Only one of action, fixedResponse, redirectResponse or targetGroups can be specified.

Implies a forward action.

Default
  • No target groups.

Return type

Optional[List[IApplicationTargetGroup]]