public static final class ScopedRouteConfiguration.Builder extends com.google.protobuf.GeneratedMessageV3.Builder<ScopedRouteConfiguration.Builder> implements ScopedRouteConfigurationOrBuilder
Specifies a routing scope, which associates a
:ref:`Key<envoy_api_msg_ScopedRouteConfiguration.Key>` to a
:ref:`envoy_api_msg_RouteConfiguration` (identified by its resource name).
The HTTP connection manager builds up a table consisting of these Key to
RouteConfiguration mappings, and looks up the RouteConfiguration to use per
request according to the algorithm specified in the
:ref:`scope_key_builder<envoy_api_field_config.filter.network.http_connection_manager.v2.ScopedRoutes.scope_key_builder>`
assigned to the HttpConnectionManager.
For example, with the following configurations (in YAML):
HttpConnectionManager config:
.. code::
...
scoped_routes:
name: foo-scoped-routes
scope_key_builder:
fragments:
- header_value_extractor:
name: X-Route-Selector
element_separator: ,
element:
separator: =
key: vip
ScopedRouteConfiguration resources (specified statically via
:ref:`scoped_route_configurations_list<envoy_api_field_config.filter.network.http_connection_manager.v2.ScopedRoutes.scoped_route_configurations_list>`
or obtained dynamically via SRDS):
.. code::
(1)
name: route-scope1
route_configuration_name: route-config1
key:
fragments:
- string_key: 172.10.10.20
(2)
name: route-scope2
route_configuration_name: route-config2
key:
fragments:
- string_key: 172.20.20.30
A request from a client such as:
.. code::
GET / HTTP/1.1
Host: foo.com
X-Route-Selector: vip=172.10.10.20
would result in the routing table defined by the `route-config1`
RouteConfiguration being assigned to the HTTP request/stream.
Protobuf type envoy.api.v2.ScopedRouteConfiguration| Modifier and Type | Method and Description |
|---|---|
ScopedRouteConfiguration.Builder |
addRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field,
Object value) |
ScopedRouteConfiguration |
build() |
ScopedRouteConfiguration |
buildPartial() |
ScopedRouteConfiguration.Builder |
clear() |
ScopedRouteConfiguration.Builder |
clearField(com.google.protobuf.Descriptors.FieldDescriptor field) |
ScopedRouteConfiguration.Builder |
clearKey()
The key to match against.
|
ScopedRouteConfiguration.Builder |
clearName()
The name assigned to the routing scope.
|
ScopedRouteConfiguration.Builder |
clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof) |
ScopedRouteConfiguration.Builder |
clearRouteConfigurationName()
The resource name to use for a :ref:`envoy_api_msg_DiscoveryRequest` to an
RDS server to fetch the :ref:`envoy_api_msg_RouteConfiguration` associated
with this scope.
|
ScopedRouteConfiguration.Builder |
clone() |
ScopedRouteConfiguration |
getDefaultInstanceForType() |
static com.google.protobuf.Descriptors.Descriptor |
getDescriptor() |
com.google.protobuf.Descriptors.Descriptor |
getDescriptorForType() |
ScopedRouteConfiguration.Key |
getKey()
The key to match against.
|
ScopedRouteConfiguration.Key.Builder |
getKeyBuilder()
The key to match against.
|
ScopedRouteConfiguration.KeyOrBuilder |
getKeyOrBuilder()
The key to match against.
|
String |
getName()
The name assigned to the routing scope.
|
com.google.protobuf.ByteString |
getNameBytes()
The name assigned to the routing scope.
|
String |
getRouteConfigurationName()
The resource name to use for a :ref:`envoy_api_msg_DiscoveryRequest` to an
RDS server to fetch the :ref:`envoy_api_msg_RouteConfiguration` associated
with this scope.
|
com.google.protobuf.ByteString |
getRouteConfigurationNameBytes()
The resource name to use for a :ref:`envoy_api_msg_DiscoveryRequest` to an
RDS server to fetch the :ref:`envoy_api_msg_RouteConfiguration` associated
with this scope.
|
boolean |
hasKey()
The key to match against.
|
protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable |
internalGetFieldAccessorTable() |
boolean |
isInitialized() |
ScopedRouteConfiguration.Builder |
mergeFrom(com.google.protobuf.CodedInputStream input,
com.google.protobuf.ExtensionRegistryLite extensionRegistry) |
ScopedRouteConfiguration.Builder |
mergeFrom(com.google.protobuf.Message other) |
ScopedRouteConfiguration.Builder |
mergeFrom(ScopedRouteConfiguration other) |
ScopedRouteConfiguration.Builder |
mergeKey(ScopedRouteConfiguration.Key value)
The key to match against.
|
ScopedRouteConfiguration.Builder |
mergeUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields) |
ScopedRouteConfiguration.Builder |
setField(com.google.protobuf.Descriptors.FieldDescriptor field,
Object value) |
ScopedRouteConfiguration.Builder |
setKey(ScopedRouteConfiguration.Key.Builder builderForValue)
The key to match against.
|
ScopedRouteConfiguration.Builder |
setKey(ScopedRouteConfiguration.Key value)
The key to match against.
|
ScopedRouteConfiguration.Builder |
setName(String value)
The name assigned to the routing scope.
|
ScopedRouteConfiguration.Builder |
setNameBytes(com.google.protobuf.ByteString value)
The name assigned to the routing scope.
|
ScopedRouteConfiguration.Builder |
setRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field,
int index,
Object value) |
ScopedRouteConfiguration.Builder |
setRouteConfigurationName(String value)
The resource name to use for a :ref:`envoy_api_msg_DiscoveryRequest` to an
RDS server to fetch the :ref:`envoy_api_msg_RouteConfiguration` associated
with this scope.
|
ScopedRouteConfiguration.Builder |
setRouteConfigurationNameBytes(com.google.protobuf.ByteString value)
The resource name to use for a :ref:`envoy_api_msg_DiscoveryRequest` to an
RDS server to fetch the :ref:`envoy_api_msg_RouteConfiguration` associated
with this scope.
|
ScopedRouteConfiguration.Builder |
setUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields) |
getAllFields, getField, getFieldBuilder, getOneofFieldDescriptor, getParentForChildren, getRepeatedField, getRepeatedFieldBuilder, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof, internalGetMapField, internalGetMutableMapField, isClean, markClean, newBuilderForField, onBuilt, onChanged, setUnknownFieldsProto3findInitializationErrors, getInitializationErrorString, internalMergeFrom, mergeDelimitedFrom, mergeDelimitedFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, newUninitializedMessageException, toStringaddAll, addAll, mergeFrom, newUninitializedMessageExceptionequals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitpublic static final com.google.protobuf.Descriptors.Descriptor getDescriptor()
protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessageV3.Builder<ScopedRouteConfiguration.Builder>public ScopedRouteConfiguration.Builder clear()
clear in interface com.google.protobuf.Message.Builderclear in interface com.google.protobuf.MessageLite.Builderclear in class com.google.protobuf.GeneratedMessageV3.Builder<ScopedRouteConfiguration.Builder>public com.google.protobuf.Descriptors.Descriptor getDescriptorForType()
getDescriptorForType in interface com.google.protobuf.Message.BuildergetDescriptorForType in interface com.google.protobuf.MessageOrBuildergetDescriptorForType in class com.google.protobuf.GeneratedMessageV3.Builder<ScopedRouteConfiguration.Builder>public ScopedRouteConfiguration getDefaultInstanceForType()
getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuildergetDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilderpublic ScopedRouteConfiguration build()
build in interface com.google.protobuf.Message.Builderbuild in interface com.google.protobuf.MessageLite.Builderpublic ScopedRouteConfiguration buildPartial()
buildPartial in interface com.google.protobuf.Message.BuilderbuildPartial in interface com.google.protobuf.MessageLite.Builderpublic ScopedRouteConfiguration.Builder clone()
clone in interface com.google.protobuf.Message.Builderclone in interface com.google.protobuf.MessageLite.Builderclone in class com.google.protobuf.GeneratedMessageV3.Builder<ScopedRouteConfiguration.Builder>public ScopedRouteConfiguration.Builder setField(com.google.protobuf.Descriptors.FieldDescriptor field, Object value)
setField in interface com.google.protobuf.Message.BuildersetField in class com.google.protobuf.GeneratedMessageV3.Builder<ScopedRouteConfiguration.Builder>public ScopedRouteConfiguration.Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field)
clearField in interface com.google.protobuf.Message.BuilderclearField in class com.google.protobuf.GeneratedMessageV3.Builder<ScopedRouteConfiguration.Builder>public ScopedRouteConfiguration.Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof)
clearOneof in interface com.google.protobuf.Message.BuilderclearOneof in class com.google.protobuf.GeneratedMessageV3.Builder<ScopedRouteConfiguration.Builder>public ScopedRouteConfiguration.Builder setRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field, int index, Object value)
setRepeatedField in interface com.google.protobuf.Message.BuildersetRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<ScopedRouteConfiguration.Builder>public ScopedRouteConfiguration.Builder addRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field, Object value)
addRepeatedField in interface com.google.protobuf.Message.BuilderaddRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<ScopedRouteConfiguration.Builder>public ScopedRouteConfiguration.Builder mergeFrom(com.google.protobuf.Message other)
mergeFrom in interface com.google.protobuf.Message.BuildermergeFrom in class com.google.protobuf.AbstractMessage.Builder<ScopedRouteConfiguration.Builder>public ScopedRouteConfiguration.Builder mergeFrom(ScopedRouteConfiguration other)
public final boolean isInitialized()
isInitialized in interface com.google.protobuf.MessageLiteOrBuilderisInitialized in class com.google.protobuf.GeneratedMessageV3.Builder<ScopedRouteConfiguration.Builder>public ScopedRouteConfiguration.Builder mergeFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
mergeFrom in interface com.google.protobuf.Message.BuildermergeFrom in interface com.google.protobuf.MessageLite.BuildermergeFrom in class com.google.protobuf.AbstractMessage.Builder<ScopedRouteConfiguration.Builder>IOExceptionpublic String getName()
The name assigned to the routing scope.
string name = 1 [(.validate.rules) = { ... }getName in interface ScopedRouteConfigurationOrBuilderpublic com.google.protobuf.ByteString getNameBytes()
The name assigned to the routing scope.
string name = 1 [(.validate.rules) = { ... }getNameBytes in interface ScopedRouteConfigurationOrBuilderpublic ScopedRouteConfiguration.Builder setName(String value)
The name assigned to the routing scope.
string name = 1 [(.validate.rules) = { ... }public ScopedRouteConfiguration.Builder clearName()
The name assigned to the routing scope.
string name = 1 [(.validate.rules) = { ... }public ScopedRouteConfiguration.Builder setNameBytes(com.google.protobuf.ByteString value)
The name assigned to the routing scope.
string name = 1 [(.validate.rules) = { ... }public String getRouteConfigurationName()
The resource name to use for a :ref:`envoy_api_msg_DiscoveryRequest` to an RDS server to fetch the :ref:`envoy_api_msg_RouteConfiguration` associated with this scope.
string route_configuration_name = 2 [(.validate.rules) = { ... }getRouteConfigurationName in interface ScopedRouteConfigurationOrBuilderpublic com.google.protobuf.ByteString getRouteConfigurationNameBytes()
The resource name to use for a :ref:`envoy_api_msg_DiscoveryRequest` to an RDS server to fetch the :ref:`envoy_api_msg_RouteConfiguration` associated with this scope.
string route_configuration_name = 2 [(.validate.rules) = { ... }getRouteConfigurationNameBytes in interface ScopedRouteConfigurationOrBuilderpublic ScopedRouteConfiguration.Builder setRouteConfigurationName(String value)
The resource name to use for a :ref:`envoy_api_msg_DiscoveryRequest` to an RDS server to fetch the :ref:`envoy_api_msg_RouteConfiguration` associated with this scope.
string route_configuration_name = 2 [(.validate.rules) = { ... }public ScopedRouteConfiguration.Builder clearRouteConfigurationName()
The resource name to use for a :ref:`envoy_api_msg_DiscoveryRequest` to an RDS server to fetch the :ref:`envoy_api_msg_RouteConfiguration` associated with this scope.
string route_configuration_name = 2 [(.validate.rules) = { ... }public ScopedRouteConfiguration.Builder setRouteConfigurationNameBytes(com.google.protobuf.ByteString value)
The resource name to use for a :ref:`envoy_api_msg_DiscoveryRequest` to an RDS server to fetch the :ref:`envoy_api_msg_RouteConfiguration` associated with this scope.
string route_configuration_name = 2 [(.validate.rules) = { ... }public boolean hasKey()
The key to match against.
.envoy.api.v2.ScopedRouteConfiguration.Key key = 3 [(.validate.rules) = { ... }hasKey in interface ScopedRouteConfigurationOrBuilderpublic ScopedRouteConfiguration.Key getKey()
The key to match against.
.envoy.api.v2.ScopedRouteConfiguration.Key key = 3 [(.validate.rules) = { ... }getKey in interface ScopedRouteConfigurationOrBuilderpublic ScopedRouteConfiguration.Builder setKey(ScopedRouteConfiguration.Key value)
The key to match against.
.envoy.api.v2.ScopedRouteConfiguration.Key key = 3 [(.validate.rules) = { ... }public ScopedRouteConfiguration.Builder setKey(ScopedRouteConfiguration.Key.Builder builderForValue)
The key to match against.
.envoy.api.v2.ScopedRouteConfiguration.Key key = 3 [(.validate.rules) = { ... }public ScopedRouteConfiguration.Builder mergeKey(ScopedRouteConfiguration.Key value)
The key to match against.
.envoy.api.v2.ScopedRouteConfiguration.Key key = 3 [(.validate.rules) = { ... }public ScopedRouteConfiguration.Builder clearKey()
The key to match against.
.envoy.api.v2.ScopedRouteConfiguration.Key key = 3 [(.validate.rules) = { ... }public ScopedRouteConfiguration.Key.Builder getKeyBuilder()
The key to match against.
.envoy.api.v2.ScopedRouteConfiguration.Key key = 3 [(.validate.rules) = { ... }public ScopedRouteConfiguration.KeyOrBuilder getKeyOrBuilder()
The key to match against.
.envoy.api.v2.ScopedRouteConfiguration.Key key = 3 [(.validate.rules) = { ... }getKeyOrBuilder in interface ScopedRouteConfigurationOrBuilderpublic final ScopedRouteConfiguration.Builder setUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
setUnknownFields in interface com.google.protobuf.Message.BuildersetUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<ScopedRouteConfiguration.Builder>public final ScopedRouteConfiguration.Builder mergeUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
mergeUnknownFields in interface com.google.protobuf.Message.BuildermergeUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<ScopedRouteConfiguration.Builder>Copyright © 2018–2021 The Envoy Project. All rights reserved.