Package io.envoyproxy.envoy.api.v2.route

Interface RouteOrBuilder

  • All Superinterfaces:
    com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder
    All Known Implementing Classes:
    Route, Route.Builder
    public interface RouteOrBuilder
extends com.google.protobuf.MessageOrBuilder

    • Method Detail

      • getName

        String getName()
         Name for the route.
        string name = 14;
        Returns:
        The name.

      • getNameBytes

        com.google.protobuf.ByteString getNameBytes()
         Name for the route.
        string name = 14;
        Returns:
        The bytes for name.

      • hasMatch

        boolean hasMatch()
         Route matching parameters.
        .envoy.api.v2.route.RouteMatch match = 1 [(.validate.rules) = { ... }
        Returns:
        Whether the match field is set.

      • getMatch

        RouteMatch getMatch()
         Route matching parameters.
        .envoy.api.v2.route.RouteMatch match = 1 [(.validate.rules) = { ... }
        Returns:
        The match.

      • getMatchOrBuilder

        RouteMatchOrBuilder getMatchOrBuilder()
         Route matching parameters.
        .envoy.api.v2.route.RouteMatch match = 1 [(.validate.rules) = { ... }

      • hasRoute

        boolean hasRoute()
         Route request to some upstream cluster.
        .envoy.api.v2.route.RouteAction route = 2;
        Returns:
        Whether the route field is set.

      • getRoute

        RouteAction getRoute()
         Route request to some upstream cluster.
        .envoy.api.v2.route.RouteAction route = 2;
        Returns:
        The route.

      • getRouteOrBuilder

        RouteActionOrBuilder getRouteOrBuilder()
         Route request to some upstream cluster.
        .envoy.api.v2.route.RouteAction route = 2;

      • hasRedirect

        boolean hasRedirect()
         Return a redirect.
        .envoy.api.v2.route.RedirectAction redirect = 3;
        Returns:
        Whether the redirect field is set.

      • getRedirect

        RedirectAction getRedirect()
         Return a redirect.
        .envoy.api.v2.route.RedirectAction redirect = 3;
        Returns:
        The redirect.

      • getRedirectOrBuilder

        RedirectActionOrBuilder getRedirectOrBuilder()
         Return a redirect.
        .envoy.api.v2.route.RedirectAction redirect = 3;

      • hasDirectResponse

        boolean hasDirectResponse()
         Return an arbitrary HTTP response directly, without proxying.
        .envoy.api.v2.route.DirectResponseAction direct_response = 7;
        Returns:
        Whether the directResponse field is set.

      • getDirectResponse

        DirectResponseAction getDirectResponse()
         Return an arbitrary HTTP response directly, without proxying.
        .envoy.api.v2.route.DirectResponseAction direct_response = 7;
        Returns:
        The directResponse.

      • getDirectResponseOrBuilder

        DirectResponseActionOrBuilder getDirectResponseOrBuilder()
         Return an arbitrary HTTP response directly, without proxying.
        .envoy.api.v2.route.DirectResponseAction direct_response = 7;

      • hasFilterAction

        boolean hasFilterAction()
         [#not-implemented-hide:]
 If true, a filter will define the action (e.g., it could dynamically generate the
 RouteAction).
        .envoy.api.v2.route.FilterAction filter_action = 17;
        Returns:
        Whether the filterAction field is set.

      • getFilterAction

        FilterAction getFilterAction()
         [#not-implemented-hide:]
 If true, a filter will define the action (e.g., it could dynamically generate the
 RouteAction).
        .envoy.api.v2.route.FilterAction filter_action = 17;
        Returns:
        The filterAction.

      • getFilterActionOrBuilder

        FilterActionOrBuilder getFilterActionOrBuilder()
         [#not-implemented-hide:]
 If true, a filter will define the action (e.g., it could dynamically generate the
 RouteAction).
        .envoy.api.v2.route.FilterAction filter_action = 17;

      • hasMetadata

        boolean hasMetadata()
         The Metadata field can be used to provide additional information
 about the route. It can be used for configuration, stats, and logging.
 The metadata should go under the filter namespace that will need it.
 For instance, if the metadata is intended for the Router filter,
 the filter name should be specified as *envoy.filters.http.router*.
        .envoy.api.v2.core.Metadata metadata = 4;
        Returns:
        Whether the metadata field is set.

      • getMetadata

        Metadata getMetadata()
         The Metadata field can be used to provide additional information
 about the route. It can be used for configuration, stats, and logging.
 The metadata should go under the filter namespace that will need it.
 For instance, if the metadata is intended for the Router filter,
 the filter name should be specified as *envoy.filters.http.router*.
        .envoy.api.v2.core.Metadata metadata = 4;
        Returns:
        The metadata.

      • getMetadataOrBuilder

        MetadataOrBuilder getMetadataOrBuilder()
         The Metadata field can be used to provide additional information
 about the route. It can be used for configuration, stats, and logging.
 The metadata should go under the filter namespace that will need it.
 For instance, if the metadata is intended for the Router filter,
 the filter name should be specified as *envoy.filters.http.router*.
        .envoy.api.v2.core.Metadata metadata = 4;

      • hasDecorator

        boolean hasDecorator()
         Decorator for the matched route.
        .envoy.api.v2.route.Decorator decorator = 5;
        Returns:
        Whether the decorator field is set.

      • getDecorator

        Decorator getDecorator()
         Decorator for the matched route.
        .envoy.api.v2.route.Decorator decorator = 5;
        Returns:
        The decorator.

      • getDecoratorOrBuilder

        DecoratorOrBuilder getDecoratorOrBuilder()
         Decorator for the matched route.
        .envoy.api.v2.route.Decorator decorator = 5;

      • getPerFilterConfigCount

        @Deprecated
int getPerFilterConfigCount()
        Deprecated.
         The per_filter_config field can be used to provide route-specific
 configurations for filters. The key should match the filter name, such as
 *envoy.filters.http.buffer* for the HTTP buffer filter. Use of this field is filter
 specific; see the :ref:`HTTP filter documentation <config_http_filters>` for
 if and how it is utilized.
        map<string, .google.protobuf.Struct> per_filter_config = 8 [deprecated = true];

      • containsPerFilterConfig

        @Deprecated
boolean containsPerFilterConfig​(String key)
        Deprecated.
         The per_filter_config field can be used to provide route-specific
 configurations for filters. The key should match the filter name, such as
 *envoy.filters.http.buffer* for the HTTP buffer filter. Use of this field is filter
 specific; see the :ref:`HTTP filter documentation <config_http_filters>` for
 if and how it is utilized.
        map<string, .google.protobuf.Struct> per_filter_config = 8 [deprecated = true];

      • getPerFilterConfigMap

        @Deprecated
Map<String,​com.google.protobuf.Struct> getPerFilterConfigMap()
        Deprecated.
         The per_filter_config field can be used to provide route-specific
 configurations for filters. The key should match the filter name, such as
 *envoy.filters.http.buffer* for the HTTP buffer filter. Use of this field is filter
 specific; see the :ref:`HTTP filter documentation <config_http_filters>` for
 if and how it is utilized.
        map<string, .google.protobuf.Struct> per_filter_config = 8 [deprecated = true];

      • getPerFilterConfigOrDefault

        @Deprecated
com.google.protobuf.Struct getPerFilterConfigOrDefault​(String key,
                                                       com.google.protobuf.Struct defaultValue)
        Deprecated.
         The per_filter_config field can be used to provide route-specific
 configurations for filters. The key should match the filter name, such as
 *envoy.filters.http.buffer* for the HTTP buffer filter. Use of this field is filter
 specific; see the :ref:`HTTP filter documentation <config_http_filters>` for
 if and how it is utilized.
        map<string, .google.protobuf.Struct> per_filter_config = 8 [deprecated = true];

      • getPerFilterConfigOrThrow

        @Deprecated
com.google.protobuf.Struct getPerFilterConfigOrThrow​(String key)
        Deprecated.
         The per_filter_config field can be used to provide route-specific
 configurations for filters. The key should match the filter name, such as
 *envoy.filters.http.buffer* for the HTTP buffer filter. Use of this field is filter
 specific; see the :ref:`HTTP filter documentation <config_http_filters>` for
 if and how it is utilized.
        map<string, .google.protobuf.Struct> per_filter_config = 8 [deprecated = true];

      • getTypedPerFilterConfigCount

        int getTypedPerFilterConfigCount()
         The typed_per_filter_config field can be used to provide route-specific
 configurations for filters. The key should match the filter name, such as
 *envoy.filters.http.buffer* for the HTTP buffer filter. Use of this field is filter
 specific; see the :ref:`HTTP filter documentation <config_http_filters>` for
 if and how it is utilized.
        map<string, .google.protobuf.Any> typed_per_filter_config = 13;

      • containsTypedPerFilterConfig

        boolean containsTypedPerFilterConfig​(String key)
         The typed_per_filter_config field can be used to provide route-specific
 configurations for filters. The key should match the filter name, such as
 *envoy.filters.http.buffer* for the HTTP buffer filter. Use of this field is filter
 specific; see the :ref:`HTTP filter documentation <config_http_filters>` for
 if and how it is utilized.
        map<string, .google.protobuf.Any> typed_per_filter_config = 13;

      • getTypedPerFilterConfigMap

        Map<String,​com.google.protobuf.Any> getTypedPerFilterConfigMap()
         The typed_per_filter_config field can be used to provide route-specific
 configurations for filters. The key should match the filter name, such as
 *envoy.filters.http.buffer* for the HTTP buffer filter. Use of this field is filter
 specific; see the :ref:`HTTP filter documentation <config_http_filters>` for
 if and how it is utilized.
        map<string, .google.protobuf.Any> typed_per_filter_config = 13;

      • getTypedPerFilterConfigOrDefault

        com.google.protobuf.Any getTypedPerFilterConfigOrDefault​(String key,
                                                         com.google.protobuf.Any defaultValue)
         The typed_per_filter_config field can be used to provide route-specific
 configurations for filters. The key should match the filter name, such as
 *envoy.filters.http.buffer* for the HTTP buffer filter. Use of this field is filter
 specific; see the :ref:`HTTP filter documentation <config_http_filters>` for
 if and how it is utilized.
        map<string, .google.protobuf.Any> typed_per_filter_config = 13;

      • getTypedPerFilterConfigOrThrow

        com.google.protobuf.Any getTypedPerFilterConfigOrThrow​(String key)
         The typed_per_filter_config field can be used to provide route-specific
 configurations for filters. The key should match the filter name, such as
 *envoy.filters.http.buffer* for the HTTP buffer filter. Use of this field is filter
 specific; see the :ref:`HTTP filter documentation <config_http_filters>` for
 if and how it is utilized.
        map<string, .google.protobuf.Any> typed_per_filter_config = 13;

      • getRequestHeadersToAddList

        List<HeaderValueOption> getRequestHeadersToAddList()
         Specifies a set of headers that will be added to requests matching this
 route. Headers specified at this level are applied before headers from the
 enclosing :ref:`envoy_api_msg_route.VirtualHost` and
 :ref:`envoy_api_msg_RouteConfiguration`. For more information, including details on
 header value syntax, see the documentation on :ref:`custom request headers
 <config_http_conn_man_headers_custom_request_headers>`.
        repeated .envoy.api.v2.core.HeaderValueOption request_headers_to_add = 9 [(.validate.rules) = { ... }

      • getRequestHeadersToAdd

        HeaderValueOption getRequestHeadersToAdd​(int index)
         Specifies a set of headers that will be added to requests matching this
 route. Headers specified at this level are applied before headers from the
 enclosing :ref:`envoy_api_msg_route.VirtualHost` and
 :ref:`envoy_api_msg_RouteConfiguration`. For more information, including details on
 header value syntax, see the documentation on :ref:`custom request headers
 <config_http_conn_man_headers_custom_request_headers>`.
        repeated .envoy.api.v2.core.HeaderValueOption request_headers_to_add = 9 [(.validate.rules) = { ... }

      • getRequestHeadersToAddCount

        int getRequestHeadersToAddCount()
         Specifies a set of headers that will be added to requests matching this
 route. Headers specified at this level are applied before headers from the
 enclosing :ref:`envoy_api_msg_route.VirtualHost` and
 :ref:`envoy_api_msg_RouteConfiguration`. For more information, including details on
 header value syntax, see the documentation on :ref:`custom request headers
 <config_http_conn_man_headers_custom_request_headers>`.
        repeated .envoy.api.v2.core.HeaderValueOption request_headers_to_add = 9 [(.validate.rules) = { ... }

      • getRequestHeadersToAddOrBuilderList

        List<? extends HeaderValueOptionOrBuilder> getRequestHeadersToAddOrBuilderList()
         Specifies a set of headers that will be added to requests matching this
 route. Headers specified at this level are applied before headers from the
 enclosing :ref:`envoy_api_msg_route.VirtualHost` and
 :ref:`envoy_api_msg_RouteConfiguration`. For more information, including details on
 header value syntax, see the documentation on :ref:`custom request headers
 <config_http_conn_man_headers_custom_request_headers>`.
        repeated .envoy.api.v2.core.HeaderValueOption request_headers_to_add = 9 [(.validate.rules) = { ... }

      • getRequestHeadersToAddOrBuilder

        HeaderValueOptionOrBuilder getRequestHeadersToAddOrBuilder​(int index)
         Specifies a set of headers that will be added to requests matching this
 route. Headers specified at this level are applied before headers from the
 enclosing :ref:`envoy_api_msg_route.VirtualHost` and
 :ref:`envoy_api_msg_RouteConfiguration`. For more information, including details on
 header value syntax, see the documentation on :ref:`custom request headers
 <config_http_conn_man_headers_custom_request_headers>`.
        repeated .envoy.api.v2.core.HeaderValueOption request_headers_to_add = 9 [(.validate.rules) = { ... }

      • getRequestHeadersToRemoveList

        List<String> getRequestHeadersToRemoveList()
         Specifies a list of HTTP headers that should be removed from each request
 matching this route.
        repeated string request_headers_to_remove = 12;
        Returns:
        A list containing the requestHeadersToRemove.

      • getRequestHeadersToRemoveCount

        int getRequestHeadersToRemoveCount()
         Specifies a list of HTTP headers that should be removed from each request
 matching this route.
        repeated string request_headers_to_remove = 12;
        Returns:
        The count of requestHeadersToRemove.

      • getRequestHeadersToRemove

        String getRequestHeadersToRemove​(int index)
         Specifies a list of HTTP headers that should be removed from each request
 matching this route.
        repeated string request_headers_to_remove = 12;
        Parameters:
        index - The index of the element to return.
        Returns:
        The requestHeadersToRemove at the given index.

      • getRequestHeadersToRemoveBytes

        com.google.protobuf.ByteString getRequestHeadersToRemoveBytes​(int index)
         Specifies a list of HTTP headers that should be removed from each request
 matching this route.
        repeated string request_headers_to_remove = 12;
        Parameters:
        index - The index of the value to return.
        Returns:
        The bytes of the requestHeadersToRemove at the given index.

      • getResponseHeadersToAddList

        List<HeaderValueOption> getResponseHeadersToAddList()
         Specifies a set of headers that will be added to responses to requests
 matching this route. Headers specified at this level are applied before
 headers from the enclosing :ref:`envoy_api_msg_route.VirtualHost` and
 :ref:`envoy_api_msg_RouteConfiguration`. For more information, including
 details on header value syntax, see the documentation on
 :ref:`custom request headers <config_http_conn_man_headers_custom_request_headers>`.
        repeated .envoy.api.v2.core.HeaderValueOption response_headers_to_add = 10 [(.validate.rules) = { ... }

      • getResponseHeadersToAdd

        HeaderValueOption getResponseHeadersToAdd​(int index)
         Specifies a set of headers that will be added to responses to requests
 matching this route. Headers specified at this level are applied before
 headers from the enclosing :ref:`envoy_api_msg_route.VirtualHost` and
 :ref:`envoy_api_msg_RouteConfiguration`. For more information, including
 details on header value syntax, see the documentation on
 :ref:`custom request headers <config_http_conn_man_headers_custom_request_headers>`.
        repeated .envoy.api.v2.core.HeaderValueOption response_headers_to_add = 10 [(.validate.rules) = { ... }

      • getResponseHeadersToAddCount

        int getResponseHeadersToAddCount()
         Specifies a set of headers that will be added to responses to requests
 matching this route. Headers specified at this level are applied before
 headers from the enclosing :ref:`envoy_api_msg_route.VirtualHost` and
 :ref:`envoy_api_msg_RouteConfiguration`. For more information, including
 details on header value syntax, see the documentation on
 :ref:`custom request headers <config_http_conn_man_headers_custom_request_headers>`.
        repeated .envoy.api.v2.core.HeaderValueOption response_headers_to_add = 10 [(.validate.rules) = { ... }

      • getResponseHeadersToAddOrBuilderList

        List<? extends HeaderValueOptionOrBuilder> getResponseHeadersToAddOrBuilderList()
         Specifies a set of headers that will be added to responses to requests
 matching this route. Headers specified at this level are applied before
 headers from the enclosing :ref:`envoy_api_msg_route.VirtualHost` and
 :ref:`envoy_api_msg_RouteConfiguration`. For more information, including
 details on header value syntax, see the documentation on
 :ref:`custom request headers <config_http_conn_man_headers_custom_request_headers>`.
        repeated .envoy.api.v2.core.HeaderValueOption response_headers_to_add = 10 [(.validate.rules) = { ... }

      • getResponseHeadersToAddOrBuilder

        HeaderValueOptionOrBuilder getResponseHeadersToAddOrBuilder​(int index)
         Specifies a set of headers that will be added to responses to requests
 matching this route. Headers specified at this level are applied before
 headers from the enclosing :ref:`envoy_api_msg_route.VirtualHost` and
 :ref:`envoy_api_msg_RouteConfiguration`. For more information, including
 details on header value syntax, see the documentation on
 :ref:`custom request headers <config_http_conn_man_headers_custom_request_headers>`.
        repeated .envoy.api.v2.core.HeaderValueOption response_headers_to_add = 10 [(.validate.rules) = { ... }

      • getResponseHeadersToRemoveList

        List<String> getResponseHeadersToRemoveList()
         Specifies a list of HTTP headers that should be removed from each response
 to requests matching this route.
        repeated string response_headers_to_remove = 11;
        Returns:
        A list containing the responseHeadersToRemove.

      • getResponseHeadersToRemoveCount

        int getResponseHeadersToRemoveCount()
         Specifies a list of HTTP headers that should be removed from each response
 to requests matching this route.
        repeated string response_headers_to_remove = 11;
        Returns:
        The count of responseHeadersToRemove.

      • getResponseHeadersToRemove

        String getResponseHeadersToRemove​(int index)
         Specifies a list of HTTP headers that should be removed from each response
 to requests matching this route.
        repeated string response_headers_to_remove = 11;
        Parameters:
        index - The index of the element to return.
        Returns:
        The responseHeadersToRemove at the given index.

      • getResponseHeadersToRemoveBytes

        com.google.protobuf.ByteString getResponseHeadersToRemoveBytes​(int index)
         Specifies a list of HTTP headers that should be removed from each response
 to requests matching this route.
        repeated string response_headers_to_remove = 11;
        Parameters:
        index - The index of the value to return.
        Returns:
        The bytes of the responseHeadersToRemove at the given index.

      • hasTracing

        boolean hasTracing()
         Presence of the object defines whether the connection manager's tracing configuration
 is overridden by this route specific instance.
        .envoy.api.v2.route.Tracing tracing = 15;
        Returns:
        Whether the tracing field is set.

      • getTracing

        Tracing getTracing()
         Presence of the object defines whether the connection manager's tracing configuration
 is overridden by this route specific instance.
        .envoy.api.v2.route.Tracing tracing = 15;
        Returns:
        The tracing.

      • getTracingOrBuilder

        TracingOrBuilder getTracingOrBuilder()
         Presence of the object defines whether the connection manager's tracing configuration
 is overridden by this route specific instance.
        .envoy.api.v2.route.Tracing tracing = 15;

      • hasPerRequestBufferLimitBytes

        boolean hasPerRequestBufferLimitBytes()
         The maximum bytes which will be buffered for retries and shadowing.
 If set, the bytes actually buffered will be the minimum value of this and the
 listener per_connection_buffer_limit_bytes.
        .google.protobuf.UInt32Value per_request_buffer_limit_bytes = 16;
        Returns:
        Whether the perRequestBufferLimitBytes field is set.

      • getPerRequestBufferLimitBytes

        com.google.protobuf.UInt32Value getPerRequestBufferLimitBytes()
         The maximum bytes which will be buffered for retries and shadowing.
 If set, the bytes actually buffered will be the minimum value of this and the
 listener per_connection_buffer_limit_bytes.
        .google.protobuf.UInt32Value per_request_buffer_limit_bytes = 16;
        Returns:
        The perRequestBufferLimitBytes.

      • getPerRequestBufferLimitBytesOrBuilder

        com.google.protobuf.UInt32ValueOrBuilder getPerRequestBufferLimitBytesOrBuilder()
         The maximum bytes which will be buffered for retries and shadowing.
 If set, the bytes actually buffered will be the minimum value of this and the
 listener per_connection_buffer_limit_bytes.
        .google.protobuf.UInt32Value per_request_buffer_limit_bytes = 16;