AWS::ElasticLoadBalancingV2::ListenerRule RuleCondition - AWS CloudFormation (original) (raw)

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

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

Required: No

Type: HostHeaderConfig

Update requires: No interruption

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

Required: Conditional

Type: HttpHeaderConfig

Update requires: No interruption

HttpRequestMethodConfig

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

Required: Conditional

Type: HttpRequestMethodConfig

Update requires: No interruption

PathPatternConfig

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

Required: No

Type: PathPatternConfig

Update requires: No interruption

QueryStringConfig

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

Required: Conditional

Type: QueryStringConfig

Update requires: No interruption

SourceIpConfig

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

Required: Conditional

Type: SourceIpConfig

Update requires: No interruption

Values

The condition value. Specify only when Field is host-header orpath-pattern. Alternatively, to specify multiple host names or multiple path patterns, use HostHeaderConfig or PathPatternConfig.

If Field is host-header and you're not usingHostHeaderConfig, 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 and you're not usingPathPatternConfig, 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: Array of String

Update requires: No interruption

RedirectConfig

SourceIpConfig

Did this page help you? - Yes

Thanks for letting us know we're doing a good job!

If you've got a moment, please tell us what we did right so we can do more of it.

Did this page help you? - No

Thanks for letting us know this page needs work. We're sorry we let you down.

If you've got a moment, please tell us how we can make the documentation better.