View a markdown version of this page

RegexMatchStatement - AWS WAFV2

RegexMatchStatement

A rule statement used to search web request components for a match against a single regular expression.

Contents

FieldToMatch

The part of the web request that you want AWS WAF to inspect.

Type: FieldToMatch object

Required: Yes

RegexString

The string representing the regular expression. AWS WAF enforces a quota on the maximum number of characters in a regex pattern. For the current limit, see AWS WAF quotas in the AWS WAF Developer Guide.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 512.

Pattern: .*

Required: Yes

TextTransformations

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they're used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, AWS WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

Type: Array of TextTransformation objects

Array Members: Minimum number of 1 item.

Required: Yes

PreParseTextTransformations

Pre-parse text transformations normalize the raw query string before AWS WAF parses it into individual query arguments. They are applied before the standard text transformations. Pre-parse text transformations are only supported when FieldToMatch is SingleQueryArgument or AllQueryArguments. You can specify up to 10 pre-parse text transformations per rule statement.

Type: Array of PreParseTextTransformation objects

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: