URL Query Parameter Literal

Category: URL

Purpose: Identifies requests by whether a query string parameter in the requested URL matches a literalThis type of value does not assign a special meaning to characters. The only exception is % which is used for URL encoding. value.

This match condition provides an easy way to specify a parameter name/value combination. Consider using the URL Query Parameter Wildcard match condition for more flexibility when matching a query string parameter.

Key information:

• Parameter name:

  • Query parameter name comparisons are case-insensitive.
  • Replace spaces in the parameter name with %20.
  • Only query parameters whose name is an exact match to the specified value may satisfy this condition.

• Parameter value:

  • The value associated with this match condition may be defined using any combination of numbers, letters, and/or symbols. All characters, with the exception of the % symbol, will be treated as a fixed value and cannot take on a special meaning.

  • Certain characters require URL encoding. Use the percentage symbol to URL encode the following characters:

    Character	URL Encoding
    Space	%20
    &	%26
    %	%25

  • The case-sensitivity of parameter value comparisons is determined by the Ignore Case option.

  • The Result option determines the conditions under which this match condition will be satisfied.

    • Match: Requires the request to contain the specified parameter and its value must match the one defined in this match condition.

    • Does Not Match: Requires that the request satisfy either of the following criteria:

      • It does not contain the specified parameter.
      • It contains the specified parameter, but its value does not match the one defined in this match condition.

• Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:

  • Complete Cache Fill (End-of-Life)
  • Default Internal Max-Age
  • Force Internal Max-Age
  • Ignore Origin No-Cache
  • Internal Max-Stale
  • URL Rewrite

Sample Scenario

A sample scenario is provided below.

The following sample configuration assume that this match condition is satisfied when a request matches the specified value.

Name	Value	Result
User	Joe	This pattern will be satisfied when the query string for a requested URL is "?user=joe."