Azure Content Delivery Network from Edgio Premium rules engine match conditions

This article lists detailed descriptions of the available match conditions for the Azure content delivery network from Edgio Premium rules engine.

The second part of a rule is the match condition. A match condition identifies specific types of requests for which a set of features is performed.

For example, you can use a match condition to:

  • Filter requests for content at a particular location.
  • Filter requests generated from a particular IP address or country/region.
  • Filter requests by header information.

Match Conditions

Always

The Always match condition is designed to apply a default set of features to all requests.

Device

These match conditions are designed to identify requests based on the client's user agent.

Name Purpose
Brand Name Identifies requests by whether the device's brand name matches a:
- Specific value (Brand Name Literal)
- Regular expression (Brand Name Regex)
- Specific pattern (Brand Name Wildcard)
Device OS Identifies requests by whether the device's OS matches a:
- Specific value (Device OS Literal)
- Regular expression (Device OS Regex)
- Specific pattern (Device OS Wildcard)
Device OS Version Identifies requests by whether the device's OS version matches a:
- Specific value (Device OS Version Literal)
- Regular expression (Device OS Version Regex)
- Specific pattern (Device OS Version Wildcard)
Dual Orientation? Identifies requests by whether the device supports dual orientation.
HTML Preferred DTD Identifies requests by whether the device's HTML preferred DTD matches a:
- Specific value (HTML Preferred DTD Literal)
- Regular expression (HTML Preferred DTD Regex)
- Specific pattern (HTML Preferred DTD Wildcard)
Image Inlining? Identifies requests by whether the device supports Base64 encoded images.
Is Android? Identifies requests by whether the device uses the Android OS.
Is App? Identifies requests by whether a native application requested content.
Is Full Desktop? Identifies requests by whether the device provides a full desktop experience.
Is iOS? Identifies requests by whether the device uses iOS.
Is Robot? Identifies requests by whether the device is considered to be an automated HTTP client (for example, a robot crawler).
Is Smart TV? Identifies requests by whether the device is a smart TV.
Is Smartphone? Identifies requests by whether the device is a smartphone.
Is Tablet? Identifies requests by whether the device is a tablet.
Is Touchscreen? Identifies requests by whether the device's primary pointing device is a touchscreen.
Is Windows Phone? Identifies requests by whether the device is a Windows Mobile 6.5/ Windows Phone 7 or higher.
Is Wireless Device? Identifies requests by whether the device is wireless.
Marketing Name Identifies requests by whether the device's marketing name matches a:
- Specific value (Marketing Name Literal)
- Regular expression (Marketing Name Regex)
- Specific pattern (Marketing Name Wildcard)
Mobile Browser Identifies requests by whether the device's browser matches a:
- Specific value (Mobile Browser Literal)
- Regular expression (Mobile Browser Regex)
- Specific pattern (Mobile Browser Wildcard)
Mobile Browser Version Identifies requests by whether the device's browser version matches a:
- Specific value (Mobile Browser Version Literal)
- Regular expression (Mobile Browser Version Regex)
- Specific pattern (Mobile Browser Version Wildcard)
Model Name Identifies requests by whether the device's model name matches a:
- Specific value (Model Name Literal)
- Regular expression (Model Name Regex)
- Specific pattern (Model Name Wildcard)
Progressive Download? Identifies requests by whether the device supports progressive download.
Release Date Identifies requests by whether the device's release date matches a:
- Specific value (Release Date Literal)
- Regular expression (Release Date Regex)
- Specific pattern (Release Date Wildcard)
Resolution Height Identifies requests by the device's height.
Resolution Width Identifies requests by the device's width.

Back to Top

Location

These match conditions are designed to identify requests based on the requester's location.

Name Purpose
AS Number Identifies requests that originate from a particular network.
City Name Identifies requests by whether they originate from a city whose name matches a:
- Specific value (City Name Literal)
- Regular expression (City Name Regex)
Continent Identifies requests that originate from the specified continents.
Country Identifies requests that originate from the specified countries/regions.
Direct memory access (DMA) Code Identifies requests that originate from the specified metros (Designated Market Areas).
Latitude Identifies requests that originate from the specified latitudes.
Longitude Identifies requests that originate from the specified longitudes.
Metro Code Identifies requests that originate from the specified metros (Designated Market Areas).
Postal Code Identifies requests that originate from the specified postal codes.
Region Code Identifies requests that originate from the specified regions.

Note

Should I use Metro Code or DMA Code?
Both of these match conditions provide the same capability. However, we recommend the use of the Metro Code match condition to identify requests by DMA.

Back to Top

Origin

These match conditions are designed to identify requests that point to content delivery network storage or a customer origin server.

Name Purpose
Content delivery network Origin Identifies requests for content stored on content delivery network storage.
Customer Origin Identifies requests for content stored on a specific customer origin server.

Back to Top

Request

These match conditions are designed to identify requests based on their properties.

Name Purpose
Client IP Address Identifies requests that originate from a particular IP address.
Cookie Parameter Identifies a request by whether it contains a cookie that matches a:
- Specific Value (Cookie Parameter Literal)
- Regular expression (Cookie Parameter Regex
- Specific pattern (Cookie Parameter Wildcard)
Edge CNAME Identifies requests that point to a specific edge CNAME.
Referring Domain Identifies a request by whether it gets referred by a hostname that matches a:
- Specific value (Referring Domain Literal)
- Specific pattern (Referring Domain Wildcard)
Request Header Identifies a request by whether it contains a header that matches a:
- Specific value (Request Header Literal)
- Regular expression (Request Header Regex)
- Specific pattern (Request Header Wildcard)
Request Method Identifies requests by their HTTP method.
Request Scheme Identifies requests by their HTTP protocol.

Back to Top

URL

Name Purpose
URL Path Identifies requests by whether their relative path, including filename, matches a:
- Specific value (URL Path Literal)
- Regular expression (URL Path Regex)
- Specific pattern (URL Path Wildcard)
URL Path Directory Identifies requests by whether their relative path matches a:
- Specific value (URL Path Directory Literal)
- Specific pattern (URL Path Directory Wildcard)
URL Path Extension Identifies requests by whether their file extension matches a:
- Specific value (URL Path Extension Literal)
- Specific pattern (URL Path Extension Wildcard)
URL Path Filename Identifies requests by whether their filename matches a:
- Specific value (URL Path Filename Literal)
- Specific pattern (URL Path Filename Wildcard)
URL Query Identifies requests by whether their query string matches a:
- Specific value (URL Query Literal)
- Regular expression (URL Query Regex)
- Specific pattern (URL Query Wildcard)
URL Query Parameter Identifies requests by whether they contain a query string parameter set to a value that matches a:
- Specific value (URL Query Parameter Literal)
- Specific pattern (URL Query Parameter Wildcard)

Back to Top

For the most recent match conditions, see the Edgio Rules Engine documentation.

Next steps