HTTP Cache Filter

Warning

This API is work-in-progress and is subject to breaking changes.

extensions.filters.http.cache.v3alpha.CacheConfig

[extensions.filters.http.cache.v3alpha.CacheConfig proto]

This extension may be referenced by the qualified name envoy.filters.http.cache.simple_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.

Tip

This extension extends and can be used with the following extension categories:

{
  "typed_config": "{...}",
  "allowed_vary_headers": []
}
typed_config

(Any) Config specific to the cache storage implementation.

allowed_vary_headers

(repeated type.matcher.v3.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.