GuideReference
TrainingSupportCommunity

prefresh_​cache

  • Property Manager name: Cache Prefreshing
  • Behavior version: The v2023-01-05 rule format supports the prefresh_​cache behavior v1.2.
  • Rule format status: GA, stable
  • Access: Read-write
  • Allowed in includes: Yes

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.

OptionTypeDescriptionRequires
enabledboolean

Enables the cache prefreshing behavior.

{"displayType":"boolean","tag":"input","type":"checkbox"}
prefreshvalnumber (0-99)

Specifies when the prefresh occurs as a percentage of the TTL. For example, for an object whose cache has 10 minutes left to live, and an origin response that is routinely less than 30 seconds, a percentage of 95 prefreshes the content without unnecessarily increasing load on the origin.

{"displayType":"number","max":[99],"min":[0],"tag":"input","type":"range"}
{"if":{"attribute":"enabled","op":"eq","value":true}}