tiered_​distribution_​advanced

Version: v2025-01-13Includes use: Yes

Behavior name: Tiered Distribution (Advanced)

This behavior allows Akamai edge servers to retrieve cached content from other Akamai servers, rather than directly from the origin. These interim parent servers in the cache hierarchy (CH) are positioned close to the origin, and fall along the path from the origin to the edge server. Tiered Distribution typically reduces the origin server's load, and reduces the time it takes for edge servers to refresh content. This advanced behavior provides a wider set of options than tiered_distribution.

Related behaviors:

Default behavior

These samples reflect the behavior's default settings. You can use these as is in your configurations or make adjustments based on the behavior's available options.

data "akamai_property_rules_builder" "tiered_distribution_advanced" {
  rules_v2025_02_18 {
    name     = "Tiered Distribution (Advanced)"
    comments = "Allows Akamai edge servers to retrieve cached content from other Akamai servers, rather than directly from the origin."
    behavior {
      tiered_distribution_advanced {
        enabled                 = true
        method                  = "SERIAL_PREPEND"
        policy                  = "PERFORMANCE"
        tiered_distribution_map = "ch2"
        allowall                = true
      }
    }
  }
}
"behaviors": [
  {
    "name": "tieredDistributionAdvanced",
    "options": {
      "enabled": true,
      "method": "SERIAL_PREPEND",
      "policy": "PERFORMANCE",
      "tieredDistributionMap": "ch2",
      "allowall": true
    }
  }
]

Options

Option Description
enabled
When enabled, activates tiered distribution.
tiered_distribution_map
The tiered parent server's location close to your origin. Value is one of:
  • CHEU2. Europe.
  • CHAUS. Australia.
  • CHAPAC. China and the Asian Pacific area.
  • CHWUS2, CHCUS2 and CHEUS2. Locations within the United States.
  • CH or CH2. A global map.
A narrower local map minimizes the origin server's load, and increases the likelihood the requested object is cached. A wider global map reduces end-user latency, but decreases the likelihood the requested object is in any given parent server's cache. This option cannot apply if the property is marked as secure. For more information, see Secure property requirements.