URL Path Literal

Applies To:

HTTP LargeThis platform has been optimized to cache and deliver static content (e.g., HTML, CSS, JavaScript, ISO, multimedia, and software downloads, etc.) over HTTP or HTTPS.

HTTP SmallLegacy. If you are currently serving traffic over this platform, then you may continue to do so. However, we recommend that you serve your traffic over our more robust HTTP Large platform.

ADNThe Application Delivery Network platform has been optimized to deliver dynamic content (e.g., login credentials, account information, etc.) over HTTP or HTTPS. Typically, user-specific and database-driven content are served over this platform.

Rules EngineAllows the customization of how requests are handled by our CDN service. It may be used to override the default response provided by an origin server, CDN settings, and the default edge server behavior. - Basic

Category: URL

Purpose: Identifies requests by whether the requested URL points to a relative path that 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 relative path includes the filename of the requested assetA file is the most commonly known example of an asset. Refers to any collection of data that is typically stored as a single unit on a storage unit (e.g., disk drive). An example of an asset that is not physically stored on a disk drive occurs when dynamically generated content is not cached..

Choosing the right URL path match condition.

Key information:

The Relative to option determines whether the URL comparison will start before or after the content access pointThis URL segment of a CDN URL identifies where the request should be directed. This relative path starts directly after the CDN hostname. The proper syntax for a content access point is "/yyAN," where "yy" stands for the origin identifier and "AN" stands for a customer account number. A content access point for a customer origin also includes a directory that identifies it..

What is a content access point?

The content access point is the portion of the path that appears between the CDN hostname and the relative path to the requested asset (e.g., /800001/CustomerOrigin). It identifies a location by server type (e.g., CDN or customer origin) and your customer account number.

The available values for this option are explained below.
- Root: Indicates that the URL comparison will start directly after the CDN hostname.
  
  Example:
  
  http://wpc.0001.edgecastcdn.net/800001/myorigin/myfolder/index.htm
- Origin: Indicates that the URL comparison will start after the content access point (e.g., /000001 or /800001/myorigin).
  
  Example:
  
  http://wpc.0001.edgecastcdn.net/800001/myorigin/myfolder/index.htm
An edge CNAME URL will be rewritten to a CDN URL prior to URL comparison.

Example:

Both of the following URLs point to the same asset and therefore have the same URL path.

CDN URL:

http://wpc.0001.edgecastcdn.net/800001/CustomerOrigin/path/asset.htm

Edge CNAME URL:

http://my.domain.com/path/asset.htm

URL path (Relative to Root):

/800001/CustomerOrigin/path/asset.htm

URL path (Relative to Origin):

/path/asset.htm
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.
For the purpose of satisfying this condition, query strings in the URL are ignored.
The case-sensitivity of URL comparisons is determined by the Ignore Case option.
Replace spaces in the URL path with %20.
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 URL before submitting the request to our CDN. By default, our CDN service then decodes those characters before the comparison for this match condition is performed.
- 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 URL path.
  - URL Normalization: You must set this option to Yes when a URL normalization customization has been applied to your traffic. This configuration ensures that your match value remains encoded.
  - Standard: Use the default configuration (i.e., No) which allows our service to decode your match value.
This match condition is satisfied when the relative URL path, including filename, is either an exact match (i.e., match) or does not match the specified value.