HTTP Service URI

This documentation is for the Envoy v3 API.

As of Envoy v1.18 the v2 API has been removed and is no longer supported.

If you are upgrading from v2 API config you may wish to view the v2 API documentation:

api/v2/core/http_uri.proto

config.core.v3.HttpUri

[config.core.v3.HttpUri proto]

Envoy external URI descriptor

{
  "uri": "...",
  "cluster": "...",
  "timeout": "{...}"
}

uri

(string, REQUIRED) The HTTP server URI. It should be a full FQDN with protocol, host and path.

Example:

uri: https://www.googleapis.com/oauth2/v1/certs

cluster

(string, REQUIRED) A cluster is created in the Envoy “cluster_manager” config section. This field specifies the cluster name.

Example:

cluster: jwks_cluster

Specify how uri is to be fetched. Today, this requires an explicit cluster, but in the future we may support dynamic cluster creation or inline DNS resolution. See issue.

timeout

(Duration, REQUIRED) Sets the maximum duration in milliseconds that a response can take to arrive upon request.