cache_error
Version: v2025-02-18 | Includes use: Yes |
---|
Behavior name: Cache HTTP Error Responses
Caches the origin's error responses to decrease server load. Applies for 10 seconds by default to the following HTTP codes:
204
305
404
405
501
502
503
504
505
Note: This behavior no longer caches
400
error responses from the origin server. If you need to cache such errors, you can set up a custom variable. See Caching400
responses for more information.
Default behavior
These samples reflect the behavior's default settings. You can use these as is in your configurations or make adjustments based on the behavior's available options.
data "akamai_property_rules_builder" "cache_error" {
rules_v2025_02_18 {
name = "Cache HTTP Error Responses"
comments = "Caches the origin's error responses to decrease server load."
behavior {
cache_error {
enabled = true
ttl = "10s"
preserve_stale = true
}
}
}
}
"behaviors": [
{
"name": "cacheError",
"options": {
"enabled": true,
"ttl": "10s",
"preserveStale": true
}
}
]
Options
Option | Description |
---|---|
enabled |
Activates the error-caching behavior.
|
ttl |
Overrides the default caching duration of
10s . Note that if set to 0 it is equivalent to no-cache which forces revalidation and may cause a traffic spike. This can be counterproductive when, for example, the origin is producing an error code of 500 .
|
preserve_stale |
When enabled, the edge server preserves stale cached objects when the origin returns
500 , 502 , 503 , and 504 error codes. This avoids re-fetching and re-caching content after transient errors.
|
Updated 9 days ago