Region Code

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.

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. - Advanced

Category: Location

Purpose: Identifies requests by the code for the region (e.g., state or province) from which the request was issued.

Key information:

Identify the desired region by its region code. A region code, which consists of 1 to 3 alphanumeric characters, identifies a subdivision of a country by the region segment of the corresponding ISO 3166-2 code.

View ISO 3166-2 codes. (Wikipedia)

View ISO 3166-2 codes. (UNECE)

Example:

The ISO 3166-2 code for California is US-CA. Therefore, the region code for California is CA.
Certain regions have two levels of subdivisions. The specified value will be compared against the most specific region code.

Example:

A request that originates from the Devon (aka Devonshire) county of England, which is part of the United Kingdom (UK), has the following subdivisions: GB and DEV. Requests from this county will be matched against DEV.
Region codes are only unique within a country. In order to prevent false positives, we strongly recommend that you nest this match condition under the Country match condition.

Example:

Requests from the following regions will report the same region code (i.e., SP).
- São Paulo, Brazil (BR-SP)
- La Spezia, Italy (IT-SP)
- Sandy Point, Bahamas (BS-SP)
Specify multiple region codes by delimiting each one with a single space.
Wildcards are not supported when specifying a region code.
Certain requests may not return a valid region code. A question mark (i.e., ?) will match requests for which a valid region code could not be determined.
The Result option determines when this condition will be met.
- Match: This condition is satisfied when the request originates from one of the specified region codes.
- Does Not Match: This condition is satisfied when the request does not originate from one of the specified region codes.
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