Region Code

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:

  • Default Internal Max-Age
  • Force Internal Max-Age
  • Ignore Origin No-Cache
  • Internal Max-Stale

Edgecast CDN