.. _envoy_api_file_envoy/api/v2/core/http_uri.proto:

HTTP Service URI 
=================


.. _envoy_api_msg_core.HttpUri:

core.HttpUri
------------

`[core.HttpUri proto] <https://github.com/envoyproxy/envoy/blob/v1.13.5/api/envoy/api/v2/core/http_uri.proto#L17>`_

Envoy external URI descriptor

.. code-block:: json

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

.. _envoy_api_field_core.HttpUri.uri:

uri
  (`string <https://developers.google.com/protocol-buffers/docs/proto#scalar>`_, *REQUIRED*) The HTTP server URI. It should be a full FQDN with protocol, host and path.
  
  Example:
  
  .. code-block:: yaml
  
     uri: https://www.googleapis.com/oauth2/v1/certs
  
  
  
.. _envoy_api_field_core.HttpUri.cluster:

cluster
  (`string <https://developers.google.com/protocol-buffers/docs/proto#scalar>`_, *REQUIRED*) A cluster is created in the Envoy "cluster_manager" config
  section. This field specifies the cluster name.
  
  Example:
  
  .. code-block:: yaml
  
     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
  <https://github.com/envoyproxy/envoy/issues/1606>`_.
  
  
.. _envoy_api_field_core.HttpUri.timeout:

timeout
  (`Duration <https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration>`_, *REQUIRED*) Sets the maximum duration in milliseconds that a response can take to arrive upon request.