Supported Matches
The following is a listing of matches supported in the current version of the API.
| Match | Description | Examples |
|---|---|---|
| http-method | Compares the request method with the listed methods The match is case-sensitive Valid values: GET HEAD POST PUT DELETE OPTIONS TRACE CONNECT |
"name":"http-method", "value":"POST PUT" |
| url-scheme | Compares the scheme (HTTP or HTTPS) of the incoming request | "name":"url-scheme", "value":"HTTP" |
| url-path | Compares each token in the space-separated list in the supplied "value" to the first path component in the incoming request URL. Wildcard characters are not supported. The match is case-sensitive | "name":"url-path", "value": "static static2" Wildcard URI paths that begin with "/static/*" and "/static2/*"). |
| url-wildcard | Compares the incoming request path (excluding query string) to the space-separated list of tokens in the match "value". Only the "*" wildcard (zero or more bytes) is supported at this time. Complete URL paths without any wildcards are also supported and are more precise than overlapping paths with wildcards. The match is case-sensitive | "name":"url-wildcard", "value":"/styles/* /images/logo.png" Would match any request whose URI path begins with "/styles/" or the exact URI path "/images/logo.png". |
| url-filename | Compare the listed filenames (including extension) to the filename of the incoming request. The match is recursive, meaning the filename can be in any sub-directory/URI path (e.g. - /filename.ext or /path/to/filename.ext both match a value of "filename.ext"). The match is case-sensitive | "name":"url-filename", "value":"crossdomain.xml logo.jpg" |
| url-extension | Compares the listed file extensions to the extension in the incoming request. Empty values are not supported at this time, so URI paths that do not include file extensions cannot use this match condition. The match is case-sensitive | "name":"url-extension", "value":"jpg png gif exe" Would match any of wildcard URI paths "*.jpg", "*.png", "*.gif" or "*.exe". |
| header | Checks for the presence or value of an incoming request header (case insensitive). The format is header-name header-values. The match on header-name is case-insensitive. header-values is a space-separated list of strings to match against. The match is case-sensitive. | "name":"header", "value":"user-agent" would match if the "user-agent" header is present |