- Property Manager name: Return Cache Status
- Behavior version: The
v2024-08-13
rule format supports thereturn_cache_status
behavior v1.0. - Rule format status: GA, stable
- Access: Read/Write
- Allowed in includes: Yes
Generates a response header with information about cache status. Among other things, this can tell you whether the response came from the Akamai cache, or from the origin. Status values report with either of these forms of syntax, depending for example on whether you're deploying traffic using sure_route
or tiered_distribution
:
{status} from child
{status} from child, {status} from parent
The status
value can be any of the following:
Hit
- the object was retrieved from Akamai's cache.Miss
- the object was not found in the Akamai cache.RefreshHit
- the object was found in Akamai's cache, but was stale, so anIf-Modified-Since
request was made to the customer origin, with 304 as the response code, indicating unmodified content.HitStale
- the object was found in Akamai's cache and was stale, but a more recent object was not available from the customer origin, so the cache served the stale object to the client.Constructed
- theconstruct_response
behavior directly specified the response to the client.Redirect
- the Akamai edge configuration specified a redirect, typically by executing theredirect
,redirectplus
, oredge_redirector
behaviors.Error
- an error occurred, typically when authorization is denied or the request is rejected by WAF.
Option | Type | Description | Requires | |
---|---|---|---|---|
response_header_name | string | Specifies the name of the HTTP header in which to report the cache status value. | {"displayType":"string","tag":"input","type":"text"} |