prefresh_cache

Property Manager name: Cache Prefreshing
Behavior version: The v2024-10-21 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.

Option Type Description Requires

Option	Type	Description	Requires
`enabled`	boolean	Enables the cache prefreshing behavior.		{"displayType":"boolean","tag":"input","type":"checkbox"}
`prefreshval`	number (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}}

enabled

boolean

Enables the cache prefreshing behavior.

{"displayType":"boolean","tag":"input","type":"checkbox"}

prefreshval

number (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}}