AWS CloudFormation
User Guide (Version )

AWS::ElasticLoadBalancingV2::ListenerRule RuleCondition

Specifies a condition for a listener rule.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

Properties

Field

The field in the HTTP request. The following are the possible values:

  • http-header

  • http-request-method

  • host-header

  • path-pattern

  • query-string

  • source-ip

Required: No

Type: String

Maximum: 64

Update requires: No interruption

HostHeaderConfig

Information for a host header condition. Specify only when Field is host-header.

Required: No

Type: HostHeaderConfig

Update requires: No interruption

HttpHeaderConfig

Information for an HTTP header condition. Specify only when Field is http-header.

Required: No

Type: HttpHeaderConfig

Update requires: No interruption

HttpRequestMethodConfig

Information for an HTTP method condition. Specify only when Field is http-request-method.

Required: No

Type: HttpRequestMethodConfig

Update requires: No interruption

PathPatternConfig

Information for a path pattern condition. Specify only when Field is path-pattern.

Conditional: Required if HttpHeaderConfig is used.

Required: No

Type: PathPatternConfig

Update requires: No interruption

QueryStringConfig

Information for a query string condition. Specify only when Field is query-string.

Conditional: Required if HttpHeaderConfig is used.

Required: No

Type: QueryStringConfig

Update requires: No interruption

SourceIpConfig

Information for a source IP condition. Specify only when Field is source-ip.

Conditional: Required if HttpHeaderConfig is used.

Required: No

Type: SourceIpConfig

Update requires: No interruption

Values

The condition value.

You can only use Values if the condition type is host-header and path-pattern. You can not specify both Values and HostHeaderConfig at the same time.

If Field is host-header, you can specify a single host name (for example, my.example.com). A host name is case insensitive, can be up to 128 characters in length, and can contain any of the following characters.

  • A-Z, a-z, 0-9

  • - .

  • * (matches 0 or more characters)

  • ? (matches exactly 1 character)

If Field is path-pattern, you can specify a single path pattern (for example, /img/*). A path pattern is case-sensitive, can be up to 128 characters in length, and can contain any of the following characters.

  • A-Z, a-z, 0-9

  • _ - . $ / ~ " ' @ : +

  • & (using &)

  • * (matches 0 or more characters)

  • ? (matches exactly 1 character)

Required: No

Type: List of String

Update requires: No interruption

On this page: