URL Query Wildcard

Category: URL

Purpose: Identifies requests by whether the query string of the requested URL matches a pattern defined by a wildcardThis type of value supports the use of special characters to establish a pattern. For example, specifying an asterisk within this type of value will match one or more characters. value.

Key information:

• The value associated with this match condition will be compared against the entire request's query string.
• For the purposes of this option, a query string starts with the first character after the question mark (?) delimiter for the query string. Therefore, the text specified in the Value option should not include a leading question mark (?).

• The value(s) associated with this match condition may be defined using any combination of numbers, letters, and/or symbols. This type of value also supports the use of special characters.

  Each specified value may contain one or more asterisks. Each asterisk will match a sequence of one or more characters.

• The case-sensitivity of query string comparisons is determined by the Ignore Case option.

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

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

• Matching against URLs that contain non-US-ASCII characters requires that you specify encoded Unicode characters (e.g., %E3%81%93).

  • Encode all Unicode characters before setting the Value option. This match condition only accepts encoded Unicode characters.

    Example:

    You should include the following characters instead of こんにちは when defining this match condition's value:

    %E3%81%93%E3%82%93%E3%81%AB%E3%81%A1%E3%81%AF

  • The majority of user agents (e.g., web browsers) encode non-US-ASCII characters in the request's query string before submitting the request to our CDN. By default, our CDN service does not decode those characters.

    Curl does not encode non-US-ASCII characters. If you would like to test this match condition using curl, then you will need to create a mutually exclusive match section (i.e., IF / ELSE IF). Each conditional expression within that statement should contain this match condition with the Encoded option set to different values.

  • Use the Encoded option to determine whether your match value, as defined in the Value option, will be decoded prior to comparison with the request's query string. You must set this option to Yes when either of the following conditions are true:

    • A URL normalization customization has been applied to your traffic.
    • The request's query string contains encoded Unicode characters (e.g., %E3%81%93).

    Enabling this option ensures that your match value remains encoded.

    If both of the above conditions are not applicable, then you should use the default configuration (i.e., No) which allows our service to decode your match value.

• Specify multiple values by delimiting each one with a single space.

  Example:

  *Parameter1=ValueA* *ValueB* *Parameter1=ValueC&Parameter2=ValueD*

• 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

Edgecast CDN