tiered_​distribution

Version: v2025-01-13Includes use: No

Behavior name: Tiered Distribution

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

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" {
  rules_v2025_02_18 {
    name     = "Tiered Distribution"
    comments = "Retrieves cached content from other Akamai servers instead of directly from the origin."
    behavior {
      tiered_distribution {
        enabled = true
      }
    }
  }
}
"behaviors": [
  {
    "name": "tieredDistribution",
    "options": {
      "enabled": true
    }
  }
]

Options

Option Description
enabled
When enabled, activates tiered distribution.
tieredDistributionMap
Optionally map the tiered parent server's location close to your origin. 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. Value is one of:
  • CH2. A global map.
  • CHAPAC. China and the Asian Pacific area.
  • CHEU2. Europe.
  • CHEUS2. Eastern United States.
  • CHCUS2. Central United States.
  • CHWUS2. Western United States.
  • CHAUS. Australia.
  • CH. A global map.
For more information, see Secure property requirements.