Set optional conditions based on which the accompanying behaviors execute.

πŸ“˜

Matches available for your property depend on your product and additional modules.

How it works

Rules may specify an optional set of matches that are the IFs in your configuration. They impose certain conditions on the incoming client requests, or in some cases on the responses from the origin. If these conditions are met, the behaviors within the same rule execute.

You can't use matches with default rules, which apply to all requests by design. However, you can explicitly override the default settings by specifying additional rules that contain match criteria.

Why use it?

Matches help you narrow down the cases when certain behaviors should apply. Maybe you'd like to deny access to certain end users based on their IPs? Or filter requests from mobile devices to serve alternate content? In such situations, matches come in handy.

Stage compatibility

The stage is the point in the processing that the match applies to. For example, when the request comes in from the end user client, that is a request stage. When the response comes back from the origin, that is a response stage.

Some behaviors don't work with certain matches because of the potential stage incompatibility. For example, you can't set an origin (to which edge servers will send this request) based on a response code already received from an origin.

Match options

  • Each match includes a true/false operator to identify particular types of requests of responses. You can also invert the result, so that the criteria succeeds if specified values don't match.

  • Matches may also consist of additional operators that filter other types of data, such as the request protocol or query string parameter.

  • When you build a rule, you can use a single match or a combination of matches to create different logic. For example, your rule can read: "all requests must match" (A and B and C and D), or "any request must match" (A or B or C or D).

  • For some matches, you can click the gear icon to configure case sensitivity options and boost match flexibility with wildcards. Use the ? wildcard to replace a single character or * for multiple characters.

Add a match

  1. Go to ☰ > CDN > Properties.

  2. On the Property Groups page, click on the property you want to add matches to. On the Property Details page, either select a non-active property version you want to edit or create a new property version.

  3. In the Property Manager Editor, in the Property Configuration Settings panel, from the left menu select the rule you want to edit.

  4. In the Criteria panel, click +Match and from the dropdown, select the match you want to apply.