RuleCondition

Information about a condition for a rule.

Each rule can optionally include up to one of each of the following conditions: http-request-method, host-header, path-pattern, and source-ip. Each rule can also optionally include one or more of each of the following conditions: http-header and query-string. Note that the value for a condition can't be empty.

For more information, see Quotas for your Application Load Balancers.

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

Type: String

Length Constraints: Maximum length of 64.

Required: No

HostHeaderConfig

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

Type: HostHeaderConditionConfig object

Required: No

HttpHeaderConfig

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

Type: HttpHeaderConditionConfig object

Required: No

HttpRequestMethodConfig

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

Type: HttpRequestMethodConditionConfig object

Required: No

PathPatternConfig

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

Type: PathPatternConditionConfig object

Required: No

QueryStringConfig

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

Type: QueryStringConditionConfig object

Required: No

RegexValues.member.N

The regular expressions to match against the condition field. The maximum length of each string is 128 characters. Specify only when Field is http-header, host-header, or path-pattern.

Type: Array of strings

Required: No

SourceIpConfig

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

Type: SourceIpConditionConfig object

Required: No

Values.member.N

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

If Field is host-header and you are not using HostHeaderConfig, you can specify a single host name (for example, my.example.com) in Values. 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 are not using PathPatternConfig, you can specify a single path pattern (for example, /img/*) in Values. 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)

Type: Array of strings

Required: No

RuleCondition

Contents

See Also