- Property Manager name: Downstream Cacheability
- Behavior version: The
v2023-01-05
rule format supports thedownstream_cache
behavior v1.2. - Rule format status: GA, stable
- Access: Read/Write
- Allowed in includes: Yes
Specify the caching instructions the edge server sends to the end user's client or client proxies. By default, the cache's duration is whichever is less: the remaining lifetime of the edge cache, or what the origin's header specifies. If the origin is set to no-store
or bypass-cache
, edge servers send cache-busting headers downstream to prevent downstream caching.
Option | Type | Description | Requires | |
---|---|---|---|---|
behavior | enum | Specify the caching instructions the edge server sends to the end user's client. | {"displayType":"enum","options":["ALLOW","MUST_REVALIDATE","BUST","TUNNEL_ORIGIN","NONE"],"tag":"select"} | |
ALLOW | The value of | |||
MUST_REVALIDATE | This equates to a | |||
BUST | Sends cache-busting headers downstream. | |||
TUNNEL_ORIGIN | This passes | |||
NONE | Don't send any caching headers. Allow client browsers to cache content according to their own default settings. | |||
allow_behavior | enum | Specify how the edge server calculates the downstream cache by setting the value of the | behavior is ALLOW | {"displayType":"enum","options":["LESSER","GREATER","REMAINING_LIFETIME","FROM_MAX_AGE","FROM_VALUE","PASS_ORIGIN"],"tag":"select"} {"if":{"attribute":"behavior","op":"eq","value":"ALLOW"}} |
LESSER | Sends the lesser value of what the origin specifies and the edge cache's remaining duration. This is the default behavior. | |||
GREATER | Sends the greater value of what the origin specifies and the edge cache's remaining duration. | |||
REMAINING_LIFETIME | Sends the value of the edge cache's remaining duration, without comparing it to the origin's headers. | |||
FROM_MAX_AGE | Sends the | |||
FROM_VALUE | Sends the value of the edge cache's duration. | |||
PASS_ORIGIN | Sends the value of the origin's header, without evaluating the edge cache's duration. | |||
ttl | string (duration) | Sets the duration of the cache. Setting the value to | allow_behavior is FROM_VALUE | {"displayType":"string","tag":"input","type":"text"} {"if":{"attribute":"allowBehavior","op":"eq","value":"FROM_VALUE"}} |
send_headers | enum | Specifies the HTTP headers to include in the response to the client. | behavior is ALLOW | {"displayType":"enum","options":["CACHE_CONTROL_AND_EXPIRES","CACHE_CONTROL","EXPIRES","PASS_ORIGIN"],"tag":"select"} {"if":{"attribute":"behavior","op":"eq","value":"ALLOW"}} |
CACHE_CONTROL_AND_EXPIRES | Sends both | |||
CACHE_CONTROL | Sends only the origin's | |||
EXPIRES | Sends only the origin's | |||
PASS_ORIGIN | Sends the same set of | |||
send_private | boolean | Adds a | behavior is either: ALLOW , MUST_REVALIDATE AND send_headers is not EXPIRES | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"op":"and","params":[{"attribute":"behavior","op":"in","value":["ALLOW","MUST_REVALIDATE"]},{"attribute":"sendHeaders","op":"neq","value":"EXPIRES"}]}} |