AWS::WAFv2::WebACL JsonMatchPattern - Amazon CloudFormation
SyntaxPropertiesExamples
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::WAFv2::WebACL JsonMatchPattern

The patterns to look for in the JSON body. Amazon WAF inspects the results of these pattern matches against the rule inspection criteria. This is used with the FieldToMatch option JsonBody.

Syntax

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

JSON

{
  "All" : Json,
  "IncludedPaths" : [ String, ... ]
}

YAML

  All: Json
  IncludedPaths: 
    - String

Properties

All

Match all of the elements. See also MatchScope in the JsonBody FieldToMatch specification.

You must specify either this setting or the IncludedPaths setting, but not both.

Required: No

Type: Json

Update requires: No interruption

IncludedPaths

Match only the specified include paths. See also MatchScope in the JsonBody FieldToMatch specification.

Provide the include paths using JSON Pointer syntax. For example, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. For information about this syntax, see the Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer.

You must specify either this setting or the All setting, but not both.

Note

Don't use this option to include all paths. Instead, use the All setting.

Required: No

Type: Array of String

Minimum: 1

Update requires: No interruption

Examples

Set a JSON match pattern for all paths

The following shows an example JSON match pattern specification for all paths.

YAML

MatchPattern:
  All: {}

JSON

"MatchPattern": {
  "All": {}
}

Set a JSON match pattern with included paths

The following shows an example JSON match pattern specification with included paths.

YAML

MatchPattern:
  IncludedPaths:
    - "/dogs/0/name"
    - "/cats/0/name"

JSON

"MatchPattern": {
  "IncludedPaths": [
    "/dogs/0/name",
    "/cats/0/name"
  ]
}