cache_​error

Version: v2025-02-18Includes 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 Caching 400 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 0it 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.