On Demand Discovery (proto)

This extension has the qualified name envoy.filters.http.on_demand

Note

This extension is intended to be robust against untrusted downstream traffic. It assumes that the upstream is trusted.

Tip

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

This extension must be configured with one of the following type URLs:

On Demand Discovery configuration overview.

Warning

Envoy currently only supports On-demand CDS when using Incremental-xDS and not State-of-the-World.

extensions.filters.http.on_demand.v3.OnDemandCds

[extensions.filters.http.on_demand.v3.OnDemandCds proto]

Configuration of on-demand CDS.

{
  "source": {...},
  "resources_locator": ...,
  "timeout": {...}
}
source

(config.core.v3.ConfigSource, REQUIRED) A configuration source for the service that will be used for on-demand cluster discovery.

resources_locator

(string) xdstp:// resource locator for on-demand cluster collection.

timeout

(Duration) The timeout for on demand cluster lookup. If not set, defaults to 5 seconds.

extensions.filters.http.on_demand.v3.OnDemand

[extensions.filters.http.on_demand.v3.OnDemand proto]

On Demand Discovery filter config.

{
  "odcds": {...}
}
odcds

(extensions.filters.http.on_demand.v3.OnDemandCds) An optional configuration for on-demand cluster discovery service. If not specified, the on-demand cluster discovery will be disabled. When it’s specified, the filter will pause the request to an unknown cluster and will begin a cluster discovery process. When the discovery is finished (successfully or not), the request will be resumed for further processing.

extensions.filters.http.on_demand.v3.PerRouteConfig

[extensions.filters.http.on_demand.v3.PerRouteConfig proto]

Per-route configuration for On Demand Discovery.

{
  "odcds": {...}
}
odcds

(extensions.filters.http.on_demand.v3.OnDemandCds) An optional configuration for on-demand cluster discovery service. If not specified, the on-demand cluster discovery will be disabled. When it’s specified, the filter will pause the request to an unknown cluster and will begin a cluster discovery process. When the discovery is finished (successfully or not), the request will be resumed for further processing.