HTTP Cache Filter¶
This extension may be referenced by the qualified name envoy.filters.http.cache
Note
This extension is work-in-progress. Functionality is incomplete and it is not intended for production use.
This extension is intended to be robust against both untrusted downstream and upstream traffic.
Warning
This API is work-in-progress and is subject to breaking changes.
config.filter.http.cache.v2alpha.CacheConfig¶
[config.filter.http.cache.v2alpha.CacheConfig proto]
{
"typed_config": "{...}",
"allowed_vary_headers": []
}
- typed_config
(Any) Config specific to the cache storage implementation.
- allowed_vary_headers
(repeated type.matcher.StringMatcher) List of matching rules that defines allowed Vary headers.
The vary response header holds a list of header names that affect the contents of a response, as described by https://httpwg.org/specs/rfc7234.html#caching.negotiated.responses.
During insertion, allowed_vary_headers acts as a allowlist: if a response’s vary header mentions any header names that aren’t matched by any rules in allowed_vary_headers, that response will not be cached.
During lookup, allowed_vary_headers controls what request headers will be sent to the cache storage implementation.