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

(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.