package envoy.config.filter.http.cache.v2alpha

Get desktop application:
View/edit binary Protocol Buffers messages

• optional google.protobuf.Any typed_config = 1

  Config specific to the cache storage implementation.

• repeated type.matcher.StringMatcher allowed_vary_headers = 2

  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.

• optional CacheConfig.KeyCreatorParams key_creator_params = 3

  [#not-implemented-hide:] <TODO(toddmgreer) implement key customization> Modifies cache key creation by restricting which parts of the URL are included.

• uint32 max_body_bytes = 4

  [#not-implemented-hide:] <TODO(toddmgreer) implement size limit> Max body size the cache filter will insert into a cache. 0 means unlimited (though the cache storage implementation may have its own limit beyond which it will reject insertions).

[#not-implemented-hide:] Modifies cache key creation by restricting which parts of the URL are included.

Used in: CacheConfig

• bool exclude_scheme = 1

  If true, exclude the URL scheme from the cache key. Set to true if your origins always produce the same response for http and https requests.

• bool exclude_host = 2

  If true, exclude the host from the cache key. Set to true if your origins' responses don't ever depend on host.

• repeated api.v2.route.QueryParameterMatcher query_parameters_included = 3

  If *query_parameters_included* is nonempty, only query parameters matched by one or more of its matchers are included in the cache key. Any other query params will not affect cache lookup.

• repeated api.v2.route.QueryParameterMatcher query_parameters_excluded = 4

  If *query_parameters_excluded* is nonempty, query parameters matched by one or more of its matchers are excluded from the cache key (even if also matched by *query_parameters_included*), and will not affect cache lookup.