prefresh_​cache

Behavior name: Cache Prefreshing

Refresh cached content before its time-to-live (TTL) expires, to keep end users from having to wait for the origin to provide fresh content.

Prefreshing starts asynchronously based on a percentage of remaining TTL. The edge serves the prefreshed content only after the TTL expires. If the percentage is set too high, and there is not enough time to retrieve the object, the end user waits for it to refresh from the origin, as is true by default without this prefresh behavior enabled. The edge does not serve stale content.

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" "prefresh_cache" {
  rules_v2025_02_18 {
    name     = "Cache Prefreshing"
    comments = "Serves the prefreshed content only after the TTL expires."
    behavior {
      prefresh_cache {
        enabled     = true
        prefreshval = 90
      }
    }
  }
}

"behaviors": [
  {
    "name": "prefreshCache",
    "options": {
      "enabled": true,
      "prefreshval": 90
    }
  }
]

Options