- Delivery Manager name: Downstream Cacheability
- Behavior version: The
latestrule format supports thedownstreamCachebehavior v1.2.
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. | |||
allowBehavior | 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 | allowBehavior is FROM_VALUE | {"displayType":"string","tag":"input","type":"text"}{"if":{"attribute":"allowBehavior","op":"eq","value":"FROM_VALUE"}} |
sendHeaders | 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 | |||
sendPrivate | boolean | Adds a | behavior is either: ALLOW, MUST_REVALIDATEAND sendHeaders 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"}]}} |
