Internal Max-Stale

This feature controls how long past the normal expiration time a cached asset may be served from an edge server when the edge server is unable to revalidate the cached asset with the origin server.

Normally, when an asset's max-age time expires, the edge server will send a revalidation request to the origin server. The origin server will then respond with either a "304 Not Modified" to give the edge server a fresh lease on the cached asset, or else with "200 OK" to provide the edge server with an updated version of the cached asset.

If the edge server is unable to establish a connection with the origin server while attempting such a revalidation, then this Internal Max-Stale feature controls whether, and for how long, the edge server may continue to serve the now-stale asset.

Note that this time interval starts when the asset's max-age expires, not when the failed revalidation occurs. Therefore, the maximum period during which an asset can be served without successful revalidation is the amount of time specified by the combination of max-age plus max-stale. For example, if an asset was cached at 9:00 with a max-age of 30 minutes and a max-stale of 15 minutes, then a failed revalidation attempt at 9:44 would result in an end-user receiving the stale cached asset, while a failed revalidation attempt at 9:46 would result in the end user receiving a "504 Gateway Timeout."

Any value configured for this feature is superseded by Cache-Control:must-revalidate or Cache-Control:proxy-revalidate headers received from the origin server. If either of those headers is received from the origin server when an asset is initially cached, then the edge server will not serve a stale cached asset. In such a case, if the edge server is unable to revalidate with the origin when the asset's max-age interval has expired, then the edge server will return a "504 Gateway Timeout."

Key information:

• Configure this feature by:
  • Selecting the status code for which a max-stale will be applied.
  • Specifying an integer value and then selecting the desired time unit (i.e., seconds, minutes, hours, etc.). This value defines the internal max-stale that will be applied.
• Setting the time unit to "Off" will disable this feature. A cached asset will not be served beyond its normal expiration time.

Default Behavior: 2 minutes

Note: Due to the manner in which cache settings are tracked, this feature cannot be associated with the following match options: Edge Cname, Request Header Literal, Request Header Wildcard, URL Query Literal, and URL Query Wildcard.