Package io.envoyproxy.envoy.extensions.network.dns_resolver.cares.v3

Class CaresDnsResolverConfig.Builder

java.lang.Object
com.google.protobuf.AbstractMessageLite.Builder
com.google.protobuf.AbstractMessage.Builder<BuilderT>
com.google.protobuf.GeneratedMessageV3.Builder<CaresDnsResolverConfig.Builder>
io.envoyproxy.envoy.extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.Builder
All Implemented Interfaces:
com.google.protobuf.Message.Builder, com.google.protobuf.MessageLite.Builder, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, CaresDnsResolverConfigOrBuilder, Cloneable
Enclosing class:
CaresDnsResolverConfig
public static final class CaresDnsResolverConfig.Builder extends com.google.protobuf.GeneratedMessageV3.Builder<CaresDnsResolverConfig.Builder> implements CaresDnsResolverConfigOrBuilder
 Configuration for c-ares DNS resolver.
 [#next-free-field: 12]
Protobuf type envoy.extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig

  • Method Details

    • getDescriptor

      public static final com.google.protobuf.Descriptors.Descriptor getDescriptor()

    • internalGetFieldAccessorTable

      protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
      Specified by:
      internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessageV3.Builder<CaresDnsResolverConfig.Builder>

    • clear

      public CaresDnsResolverConfig.Builder clear()
      Specified by:
      clear in interface com.google.protobuf.Message.Builder
      Specified by:
      clear in interface com.google.protobuf.MessageLite.Builder
      Overrides:
      clear in class com.google.protobuf.GeneratedMessageV3.Builder<CaresDnsResolverConfig.Builder>

    • getDescriptorForType

      public com.google.protobuf.Descriptors.Descriptor getDescriptorForType()
      Specified by:
      getDescriptorForType in interface com.google.protobuf.Message.Builder
      Specified by:
      getDescriptorForType in interface com.google.protobuf.MessageOrBuilder
      Overrides:
      getDescriptorForType in class com.google.protobuf.GeneratedMessageV3.Builder<CaresDnsResolverConfig.Builder>

    • getDefaultInstanceForType

      public CaresDnsResolverConfig getDefaultInstanceForType()
      Specified by:
      getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuilder
      Specified by:
      getDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilder

    • build

      public CaresDnsResolverConfig build()
      Specified by:
      build in interface com.google.protobuf.Message.Builder
      Specified by:
      build in interface com.google.protobuf.MessageLite.Builder

    • buildPartial

      public CaresDnsResolverConfig buildPartial()
      Specified by:
      buildPartial in interface com.google.protobuf.Message.Builder
      Specified by:
      buildPartial in interface com.google.protobuf.MessageLite.Builder

    • clone

      public CaresDnsResolverConfig.Builder clone()
      Specified by:
      clone in interface com.google.protobuf.Message.Builder
      Specified by:
      clone in interface com.google.protobuf.MessageLite.Builder
      Overrides:
      clone in class com.google.protobuf.GeneratedMessageV3.Builder<CaresDnsResolverConfig.Builder>

    • setField

      public CaresDnsResolverConfig.Builder setField(com.google.protobuf.Descriptors.FieldDescriptor field, Object value)
      Specified by:
      setField in interface com.google.protobuf.Message.Builder
      Overrides:
      setField in class com.google.protobuf.GeneratedMessageV3.Builder<CaresDnsResolverConfig.Builder>

    • clearField

      public CaresDnsResolverConfig.Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field)
      Specified by:
      clearField in interface com.google.protobuf.Message.Builder
      Overrides:
      clearField in class com.google.protobuf.GeneratedMessageV3.Builder<CaresDnsResolverConfig.Builder>

    • clearOneof

      public CaresDnsResolverConfig.Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof)
      Specified by:
      clearOneof in interface com.google.protobuf.Message.Builder
      Overrides:
      clearOneof in class com.google.protobuf.GeneratedMessageV3.Builder<CaresDnsResolverConfig.Builder>

    • setRepeatedField

      public CaresDnsResolverConfig.Builder setRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field, int index, Object value)
      Specified by:
      setRepeatedField in interface com.google.protobuf.Message.Builder
      Overrides:
      setRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<CaresDnsResolverConfig.Builder>

    • addRepeatedField

      public CaresDnsResolverConfig.Builder addRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field, Object value)
      Specified by:
      addRepeatedField in interface com.google.protobuf.Message.Builder
      Overrides:
      addRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<CaresDnsResolverConfig.Builder>

    • mergeFrom

      public CaresDnsResolverConfig.Builder mergeFrom(com.google.protobuf.Message other)
      Specified by:
      mergeFrom in interface com.google.protobuf.Message.Builder
      Overrides:
      mergeFrom in class com.google.protobuf.AbstractMessage.Builder<CaresDnsResolverConfig.Builder>

    • mergeFrom

      public CaresDnsResolverConfig.Builder mergeFrom(CaresDnsResolverConfig other)

    • isInitialized

      public final boolean isInitialized()
      Specified by:
      isInitialized in interface com.google.protobuf.MessageLiteOrBuilder
      Overrides:
      isInitialized in class com.google.protobuf.GeneratedMessageV3.Builder<CaresDnsResolverConfig.Builder>

    • mergeFrom

      public CaresDnsResolverConfig.Builder mergeFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Specified by:
      mergeFrom in interface com.google.protobuf.Message.Builder
      Specified by:
      mergeFrom in interface com.google.protobuf.MessageLite.Builder
      Overrides:
      mergeFrom in class com.google.protobuf.AbstractMessage.Builder<CaresDnsResolverConfig.Builder>
      Throws:
      IOException

    • getResolversList

      public List<Address> getResolversList()
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;
      Specified by:
      getResolversList in interface CaresDnsResolverConfigOrBuilder

    • getResolversCount

      public int getResolversCount()
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;
      Specified by:
      getResolversCount in interface CaresDnsResolverConfigOrBuilder

    • getResolvers

      public Address getResolvers(int index)
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;
      Specified by:
      getResolvers in interface CaresDnsResolverConfigOrBuilder

    • setResolvers

      public CaresDnsResolverConfig.Builder setResolvers(int index, Address value)
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;

    • setResolvers

      public CaresDnsResolverConfig.Builder setResolvers(int index, Address.Builder builderForValue)
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;

    • addResolvers

      public CaresDnsResolverConfig.Builder addResolvers(Address value)
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;

    • addResolvers

      public CaresDnsResolverConfig.Builder addResolvers(int index, Address value)
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;

    • addResolvers

      public CaresDnsResolverConfig.Builder addResolvers(Address.Builder builderForValue)
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;

    • addResolvers

      public CaresDnsResolverConfig.Builder addResolvers(int index, Address.Builder builderForValue)
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;

    • addAllResolvers

      public CaresDnsResolverConfig.Builder addAllResolvers(Iterable<? extends Address> values)
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;

    • clearResolvers

      public CaresDnsResolverConfig.Builder clearResolvers()
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;

    • removeResolvers

      public CaresDnsResolverConfig.Builder removeResolvers(int index)
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;

    • getResolversBuilder

      public Address.Builder getResolversBuilder(int index)
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;

    • getResolversOrBuilder

      public AddressOrBuilder getResolversOrBuilder(int index)
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;
      Specified by:
      getResolversOrBuilder in interface CaresDnsResolverConfigOrBuilder

    • getResolversOrBuilderList

      public List<? extends AddressOrBuilder> getResolversOrBuilderList()
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;
      Specified by:
      getResolversOrBuilderList in interface CaresDnsResolverConfigOrBuilder

    • addResolversBuilder

      public Address.Builder addResolversBuilder()
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;

    • addResolversBuilder

      public Address.Builder addResolversBuilder(int index)
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;

    • getResolversBuilderList

      public List<Address.Builder> getResolversBuilderList()
       A list of DNS resolver addresses.
 :ref:`use_resolvers_as_fallback <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.use_resolvers_as_fallback>`
 below dictates if the DNS client should override system defaults or only use the provided
 resolvers if the system defaults are not available, i.e., as a fallback.
      repeated .envoy.config.core.v3.Address resolvers = 1;

    • getUseResolversAsFallback

      public boolean getUseResolversAsFallback()
       If true use the resolvers listed in the
 :ref:`resolvers <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.resolvers>`
 field only if c-ares is unable to obtain a
 nameserver from the system (e.g., ``/etc/resolv.conf``).
 Otherwise, the resolvers listed in the resolvers list will override the default system
 resolvers. Defaults to false.
      bool use_resolvers_as_fallback = 3;
      Specified by:
      getUseResolversAsFallback in interface CaresDnsResolverConfigOrBuilder
      Returns:
      The useResolversAsFallback.

    • setUseResolversAsFallback

      public CaresDnsResolverConfig.Builder setUseResolversAsFallback(boolean value)
       If true use the resolvers listed in the
 :ref:`resolvers <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.resolvers>`
 field only if c-ares is unable to obtain a
 nameserver from the system (e.g., ``/etc/resolv.conf``).
 Otherwise, the resolvers listed in the resolvers list will override the default system
 resolvers. Defaults to false.
      bool use_resolvers_as_fallback = 3;
      Parameters:
      value - The useResolversAsFallback to set.
      Returns:
      This builder for chaining.

    • clearUseResolversAsFallback

      public CaresDnsResolverConfig.Builder clearUseResolversAsFallback()
       If true use the resolvers listed in the
 :ref:`resolvers <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.resolvers>`
 field only if c-ares is unable to obtain a
 nameserver from the system (e.g., ``/etc/resolv.conf``).
 Otherwise, the resolvers listed in the resolvers list will override the default system
 resolvers. Defaults to false.
      bool use_resolvers_as_fallback = 3;
      Returns:
      This builder for chaining.

    • getFilterUnroutableFamilies

      public boolean getFilterUnroutableFamilies()
       The resolver will query available network interfaces and determine if there are no available
 interfaces for a given IP family. It will then filter these addresses from the results it
 presents. e.g., if there are no available IPv4 network interfaces, the resolver will not
 provide IPv4 addresses.
      bool filter_unroutable_families = 4;
      Specified by:
      getFilterUnroutableFamilies in interface CaresDnsResolverConfigOrBuilder
      Returns:
      The filterUnroutableFamilies.

    • setFilterUnroutableFamilies

      public CaresDnsResolverConfig.Builder setFilterUnroutableFamilies(boolean value)
       The resolver will query available network interfaces and determine if there are no available
 interfaces for a given IP family. It will then filter these addresses from the results it
 presents. e.g., if there are no available IPv4 network interfaces, the resolver will not
 provide IPv4 addresses.
      bool filter_unroutable_families = 4;
      Parameters:
      value - The filterUnroutableFamilies to set.
      Returns:
      This builder for chaining.

    • clearFilterUnroutableFamilies

      public CaresDnsResolverConfig.Builder clearFilterUnroutableFamilies()
       The resolver will query available network interfaces and determine if there are no available
 interfaces for a given IP family. It will then filter these addresses from the results it
 presents. e.g., if there are no available IPv4 network interfaces, the resolver will not
 provide IPv4 addresses.
      bool filter_unroutable_families = 4;
      Returns:
      This builder for chaining.

    • hasDnsResolverOptions

      public boolean hasDnsResolverOptions()
       Configuration of DNS resolver option flags which control the behavior of the DNS resolver.
      .envoy.config.core.v3.DnsResolverOptions dns_resolver_options = 2;
      Specified by:
      hasDnsResolverOptions in interface CaresDnsResolverConfigOrBuilder
      Returns:
      Whether the dnsResolverOptions field is set.

    • getDnsResolverOptions

      public DnsResolverOptions getDnsResolverOptions()
       Configuration of DNS resolver option flags which control the behavior of the DNS resolver.
      .envoy.config.core.v3.DnsResolverOptions dns_resolver_options = 2;
      Specified by:
      getDnsResolverOptions in interface CaresDnsResolverConfigOrBuilder
      Returns:
      The dnsResolverOptions.

    • setDnsResolverOptions

      public CaresDnsResolverConfig.Builder setDnsResolverOptions(DnsResolverOptions value)
       Configuration of DNS resolver option flags which control the behavior of the DNS resolver.
      .envoy.config.core.v3.DnsResolverOptions dns_resolver_options = 2;

    • setDnsResolverOptions

      public CaresDnsResolverConfig.Builder setDnsResolverOptions(DnsResolverOptions.Builder builderForValue)
       Configuration of DNS resolver option flags which control the behavior of the DNS resolver.
      .envoy.config.core.v3.DnsResolverOptions dns_resolver_options = 2;

    • mergeDnsResolverOptions

      public CaresDnsResolverConfig.Builder mergeDnsResolverOptions(DnsResolverOptions value)
       Configuration of DNS resolver option flags which control the behavior of the DNS resolver.
      .envoy.config.core.v3.DnsResolverOptions dns_resolver_options = 2;

    • clearDnsResolverOptions

      public CaresDnsResolverConfig.Builder clearDnsResolverOptions()
       Configuration of DNS resolver option flags which control the behavior of the DNS resolver.
      .envoy.config.core.v3.DnsResolverOptions dns_resolver_options = 2;

    • getDnsResolverOptionsBuilder

      public DnsResolverOptions.Builder getDnsResolverOptionsBuilder()
       Configuration of DNS resolver option flags which control the behavior of the DNS resolver.
      .envoy.config.core.v3.DnsResolverOptions dns_resolver_options = 2;

    • getDnsResolverOptionsOrBuilder

      public DnsResolverOptionsOrBuilder getDnsResolverOptionsOrBuilder()
       Configuration of DNS resolver option flags which control the behavior of the DNS resolver.
      .envoy.config.core.v3.DnsResolverOptions dns_resolver_options = 2;
      Specified by:
      getDnsResolverOptionsOrBuilder in interface CaresDnsResolverConfigOrBuilder

    • hasUdpMaxQueries

      public boolean hasUdpMaxQueries()
       This option allows the number of UDP based DNS queries to be capped.

 .. note::
   This is only applicable to c-ares DNS resolver currently.
      .google.protobuf.UInt32Value udp_max_queries = 5;
      Specified by:
      hasUdpMaxQueries in interface CaresDnsResolverConfigOrBuilder
      Returns:
      Whether the udpMaxQueries field is set.

    • getUdpMaxQueries

      public com.google.protobuf.UInt32Value getUdpMaxQueries()
       This option allows the number of UDP based DNS queries to be capped.

 .. note::
   This is only applicable to c-ares DNS resolver currently.
      .google.protobuf.UInt32Value udp_max_queries = 5;
      Specified by:
      getUdpMaxQueries in interface CaresDnsResolverConfigOrBuilder
      Returns:
      The udpMaxQueries.

    • setUdpMaxQueries

      public CaresDnsResolverConfig.Builder setUdpMaxQueries(com.google.protobuf.UInt32Value value)
       This option allows the number of UDP based DNS queries to be capped.

 .. note::
   This is only applicable to c-ares DNS resolver currently.
      .google.protobuf.UInt32Value udp_max_queries = 5;

    • setUdpMaxQueries

      public CaresDnsResolverConfig.Builder setUdpMaxQueries(com.google.protobuf.UInt32Value.Builder builderForValue)
       This option allows the number of UDP based DNS queries to be capped.

 .. note::
   This is only applicable to c-ares DNS resolver currently.
      .google.protobuf.UInt32Value udp_max_queries = 5;

    • mergeUdpMaxQueries

      public CaresDnsResolverConfig.Builder mergeUdpMaxQueries(com.google.protobuf.UInt32Value value)
       This option allows the number of UDP based DNS queries to be capped.

 .. note::
   This is only applicable to c-ares DNS resolver currently.
      .google.protobuf.UInt32Value udp_max_queries = 5;

    • clearUdpMaxQueries

      public CaresDnsResolverConfig.Builder clearUdpMaxQueries()
       This option allows the number of UDP based DNS queries to be capped.

 .. note::
   This is only applicable to c-ares DNS resolver currently.
      .google.protobuf.UInt32Value udp_max_queries = 5;

    • getUdpMaxQueriesBuilder

      public com.google.protobuf.UInt32Value.Builder getUdpMaxQueriesBuilder()
       This option allows the number of UDP based DNS queries to be capped.

 .. note::
   This is only applicable to c-ares DNS resolver currently.
      .google.protobuf.UInt32Value udp_max_queries = 5;

    • getUdpMaxQueriesOrBuilder

      public com.google.protobuf.UInt32ValueOrBuilder getUdpMaxQueriesOrBuilder()
       This option allows the number of UDP based DNS queries to be capped.

 .. note::
   This is only applicable to c-ares DNS resolver currently.
      .google.protobuf.UInt32Value udp_max_queries = 5;
      Specified by:
      getUdpMaxQueriesOrBuilder in interface CaresDnsResolverConfigOrBuilder

    • hasQueryTimeoutSeconds

      public boolean hasQueryTimeoutSeconds()
       The number of seconds each name server is given to respond to a query on the first try of any given server.

 .. note::
   While the c-ares library defaults to 2 seconds, Envoy's default (if this field is unset) is 5 seconds.
   This adjustment was made to maintain the previous behavior after users reported an increase in DNS resolution times.
      .google.protobuf.UInt64Value query_timeout_seconds = 6 [(.validate.rules) = { ... }
      Specified by:
      hasQueryTimeoutSeconds in interface CaresDnsResolverConfigOrBuilder
      Returns:
      Whether the queryTimeoutSeconds field is set.

    • getQueryTimeoutSeconds

      public com.google.protobuf.UInt64Value getQueryTimeoutSeconds()
       The number of seconds each name server is given to respond to a query on the first try of any given server.

 .. note::
   While the c-ares library defaults to 2 seconds, Envoy's default (if this field is unset) is 5 seconds.
   This adjustment was made to maintain the previous behavior after users reported an increase in DNS resolution times.
      .google.protobuf.UInt64Value query_timeout_seconds = 6 [(.validate.rules) = { ... }
      Specified by:
      getQueryTimeoutSeconds in interface CaresDnsResolverConfigOrBuilder
      Returns:
      The queryTimeoutSeconds.

    • setQueryTimeoutSeconds

      public CaresDnsResolverConfig.Builder setQueryTimeoutSeconds(com.google.protobuf.UInt64Value value)
       The number of seconds each name server is given to respond to a query on the first try of any given server.

 .. note::
   While the c-ares library defaults to 2 seconds, Envoy's default (if this field is unset) is 5 seconds.
   This adjustment was made to maintain the previous behavior after users reported an increase in DNS resolution times.
      .google.protobuf.UInt64Value query_timeout_seconds = 6 [(.validate.rules) = { ... }

    • setQueryTimeoutSeconds

      public CaresDnsResolverConfig.Builder setQueryTimeoutSeconds(com.google.protobuf.UInt64Value.Builder builderForValue)
       The number of seconds each name server is given to respond to a query on the first try of any given server.

 .. note::
   While the c-ares library defaults to 2 seconds, Envoy's default (if this field is unset) is 5 seconds.
   This adjustment was made to maintain the previous behavior after users reported an increase in DNS resolution times.
      .google.protobuf.UInt64Value query_timeout_seconds = 6 [(.validate.rules) = { ... }

    • mergeQueryTimeoutSeconds

      public CaresDnsResolverConfig.Builder mergeQueryTimeoutSeconds(com.google.protobuf.UInt64Value value)
       The number of seconds each name server is given to respond to a query on the first try of any given server.

 .. note::
   While the c-ares library defaults to 2 seconds, Envoy's default (if this field is unset) is 5 seconds.
   This adjustment was made to maintain the previous behavior after users reported an increase in DNS resolution times.
      .google.protobuf.UInt64Value query_timeout_seconds = 6 [(.validate.rules) = { ... }

    • clearQueryTimeoutSeconds

      public CaresDnsResolverConfig.Builder clearQueryTimeoutSeconds()
       The number of seconds each name server is given to respond to a query on the first try of any given server.

 .. note::
   While the c-ares library defaults to 2 seconds, Envoy's default (if this field is unset) is 5 seconds.
   This adjustment was made to maintain the previous behavior after users reported an increase in DNS resolution times.
      .google.protobuf.UInt64Value query_timeout_seconds = 6 [(.validate.rules) = { ... }

    • getQueryTimeoutSecondsBuilder

      public com.google.protobuf.UInt64Value.Builder getQueryTimeoutSecondsBuilder()
       The number of seconds each name server is given to respond to a query on the first try of any given server.

 .. note::
   While the c-ares library defaults to 2 seconds, Envoy's default (if this field is unset) is 5 seconds.
   This adjustment was made to maintain the previous behavior after users reported an increase in DNS resolution times.
      .google.protobuf.UInt64Value query_timeout_seconds = 6 [(.validate.rules) = { ... }

    • getQueryTimeoutSecondsOrBuilder

      public com.google.protobuf.UInt64ValueOrBuilder getQueryTimeoutSecondsOrBuilder()
       The number of seconds each name server is given to respond to a query on the first try of any given server.

 .. note::
   While the c-ares library defaults to 2 seconds, Envoy's default (if this field is unset) is 5 seconds.
   This adjustment was made to maintain the previous behavior after users reported an increase in DNS resolution times.
      .google.protobuf.UInt64Value query_timeout_seconds = 6 [(.validate.rules) = { ... }
      Specified by:
      getQueryTimeoutSecondsOrBuilder in interface CaresDnsResolverConfigOrBuilder

    • hasQueryTries

      public boolean hasQueryTries()
       The maximum number of query attempts the resolver will make before giving up.
 Each attempt may use a different name server.

 .. note::
   While the c-ares library defaults to 3 attempts, Envoy's default (if this field is unset) is 4 attempts.
   This adjustment was made to maintain the previous behavior after users reported an increase in DNS resolution times.
      .google.protobuf.UInt32Value query_tries = 7 [(.validate.rules) = { ... }
      Specified by:
      hasQueryTries in interface CaresDnsResolverConfigOrBuilder
      Returns:
      Whether the queryTries field is set.

    • getQueryTries

      public com.google.protobuf.UInt32Value getQueryTries()
       The maximum number of query attempts the resolver will make before giving up.
 Each attempt may use a different name server.

 .. note::
   While the c-ares library defaults to 3 attempts, Envoy's default (if this field is unset) is 4 attempts.
   This adjustment was made to maintain the previous behavior after users reported an increase in DNS resolution times.
      .google.protobuf.UInt32Value query_tries = 7 [(.validate.rules) = { ... }
      Specified by:
      getQueryTries in interface CaresDnsResolverConfigOrBuilder
      Returns:
      The queryTries.

    • setQueryTries

      public CaresDnsResolverConfig.Builder setQueryTries(com.google.protobuf.UInt32Value value)
       The maximum number of query attempts the resolver will make before giving up.
 Each attempt may use a different name server.

 .. note::
   While the c-ares library defaults to 3 attempts, Envoy's default (if this field is unset) is 4 attempts.
   This adjustment was made to maintain the previous behavior after users reported an increase in DNS resolution times.
      .google.protobuf.UInt32Value query_tries = 7 [(.validate.rules) = { ... }

    • setQueryTries

      public CaresDnsResolverConfig.Builder setQueryTries(com.google.protobuf.UInt32Value.Builder builderForValue)
       The maximum number of query attempts the resolver will make before giving up.
 Each attempt may use a different name server.

 .. note::
   While the c-ares library defaults to 3 attempts, Envoy's default (if this field is unset) is 4 attempts.
   This adjustment was made to maintain the previous behavior after users reported an increase in DNS resolution times.
      .google.protobuf.UInt32Value query_tries = 7 [(.validate.rules) = { ... }

    • mergeQueryTries

      public CaresDnsResolverConfig.Builder mergeQueryTries(com.google.protobuf.UInt32Value value)
       The maximum number of query attempts the resolver will make before giving up.
 Each attempt may use a different name server.

 .. note::
   While the c-ares library defaults to 3 attempts, Envoy's default (if this field is unset) is 4 attempts.
   This adjustment was made to maintain the previous behavior after users reported an increase in DNS resolution times.
      .google.protobuf.UInt32Value query_tries = 7 [(.validate.rules) = { ... }

    • clearQueryTries

      public CaresDnsResolverConfig.Builder clearQueryTries()
       The maximum number of query attempts the resolver will make before giving up.
 Each attempt may use a different name server.

 .. note::
   While the c-ares library defaults to 3 attempts, Envoy's default (if this field is unset) is 4 attempts.
   This adjustment was made to maintain the previous behavior after users reported an increase in DNS resolution times.
      .google.protobuf.UInt32Value query_tries = 7 [(.validate.rules) = { ... }

    • getQueryTriesBuilder

      public com.google.protobuf.UInt32Value.Builder getQueryTriesBuilder()
       The maximum number of query attempts the resolver will make before giving up.
 Each attempt may use a different name server.

 .. note::
   While the c-ares library defaults to 3 attempts, Envoy's default (if this field is unset) is 4 attempts.
   This adjustment was made to maintain the previous behavior after users reported an increase in DNS resolution times.
      .google.protobuf.UInt32Value query_tries = 7 [(.validate.rules) = { ... }

    • getQueryTriesOrBuilder

      public com.google.protobuf.UInt32ValueOrBuilder getQueryTriesOrBuilder()
       The maximum number of query attempts the resolver will make before giving up.
 Each attempt may use a different name server.

 .. note::
   While the c-ares library defaults to 3 attempts, Envoy's default (if this field is unset) is 4 attempts.
   This adjustment was made to maintain the previous behavior after users reported an increase in DNS resolution times.
      .google.protobuf.UInt32Value query_tries = 7 [(.validate.rules) = { ... }
      Specified by:
      getQueryTriesOrBuilder in interface CaresDnsResolverConfigOrBuilder

    • getRotateNameservers

      public boolean getRotateNameservers()
       Enable round-robin selection of name servers for DNS resolution. When enabled, the resolver will cycle through the
 list of name servers for each resolution request. This can help distribute the query load across multiple name
 servers. If disabled (default), the resolver will try name servers in the order they are configured.

 .. note::
   This setting overrides any system configuration for name server rotation.
      bool rotate_nameservers = 8;
      Specified by:
      getRotateNameservers in interface CaresDnsResolverConfigOrBuilder
      Returns:
      The rotateNameservers.

    • setRotateNameservers

      public CaresDnsResolverConfig.Builder setRotateNameservers(boolean value)
       Enable round-robin selection of name servers for DNS resolution. When enabled, the resolver will cycle through the
 list of name servers for each resolution request. This can help distribute the query load across multiple name
 servers. If disabled (default), the resolver will try name servers in the order they are configured.

 .. note::
   This setting overrides any system configuration for name server rotation.
      bool rotate_nameservers = 8;
      Parameters:
      value - The rotateNameservers to set.
      Returns:
      This builder for chaining.

    • clearRotateNameservers

      public CaresDnsResolverConfig.Builder clearRotateNameservers()
       Enable round-robin selection of name servers for DNS resolution. When enabled, the resolver will cycle through the
 list of name servers for each resolution request. This can help distribute the query load across multiple name
 servers. If disabled (default), the resolver will try name servers in the order they are configured.

 .. note::
   This setting overrides any system configuration for name server rotation.
      bool rotate_nameservers = 8;
      Returns:
      This builder for chaining.

    • hasEdns0MaxPayloadSize

      public boolean hasEdns0MaxPayloadSize()
       Maximum EDNS0 UDP payload size in bytes.
 If set, c-ares will include EDNS0 in DNS queries and use this value as the maximum UDP response size.

 Recommended values:

 * **1232**: Safe default (avoids fragmentation).
 * **4096**: Maximum allowed.

 If unset, c-ares uses its internal default (usually 1232).
      .google.protobuf.UInt32Value edns0_max_payload_size = 9 [(.validate.rules) = { ... }
      Specified by:
      hasEdns0MaxPayloadSize in interface CaresDnsResolverConfigOrBuilder
      Returns:
      Whether the edns0MaxPayloadSize field is set.

    • getEdns0MaxPayloadSize

      public com.google.protobuf.UInt32Value getEdns0MaxPayloadSize()
       Maximum EDNS0 UDP payload size in bytes.
 If set, c-ares will include EDNS0 in DNS queries and use this value as the maximum UDP response size.

 Recommended values:

 * **1232**: Safe default (avoids fragmentation).
 * **4096**: Maximum allowed.

 If unset, c-ares uses its internal default (usually 1232).
      .google.protobuf.UInt32Value edns0_max_payload_size = 9 [(.validate.rules) = { ... }
      Specified by:
      getEdns0MaxPayloadSize in interface CaresDnsResolverConfigOrBuilder
      Returns:
      The edns0MaxPayloadSize.

    • setEdns0MaxPayloadSize

      public CaresDnsResolverConfig.Builder setEdns0MaxPayloadSize(com.google.protobuf.UInt32Value value)
       Maximum EDNS0 UDP payload size in bytes.
 If set, c-ares will include EDNS0 in DNS queries and use this value as the maximum UDP response size.

 Recommended values:

 * **1232**: Safe default (avoids fragmentation).
 * **4096**: Maximum allowed.

 If unset, c-ares uses its internal default (usually 1232).
      .google.protobuf.UInt32Value edns0_max_payload_size = 9 [(.validate.rules) = { ... }

    • setEdns0MaxPayloadSize

      public CaresDnsResolverConfig.Builder setEdns0MaxPayloadSize(com.google.protobuf.UInt32Value.Builder builderForValue)
       Maximum EDNS0 UDP payload size in bytes.
 If set, c-ares will include EDNS0 in DNS queries and use this value as the maximum UDP response size.

 Recommended values:

 * **1232**: Safe default (avoids fragmentation).
 * **4096**: Maximum allowed.

 If unset, c-ares uses its internal default (usually 1232).
      .google.protobuf.UInt32Value edns0_max_payload_size = 9 [(.validate.rules) = { ... }

    • mergeEdns0MaxPayloadSize

      public CaresDnsResolverConfig.Builder mergeEdns0MaxPayloadSize(com.google.protobuf.UInt32Value value)
       Maximum EDNS0 UDP payload size in bytes.
 If set, c-ares will include EDNS0 in DNS queries and use this value as the maximum UDP response size.

 Recommended values:

 * **1232**: Safe default (avoids fragmentation).
 * **4096**: Maximum allowed.

 If unset, c-ares uses its internal default (usually 1232).
      .google.protobuf.UInt32Value edns0_max_payload_size = 9 [(.validate.rules) = { ... }

    • clearEdns0MaxPayloadSize

      public CaresDnsResolverConfig.Builder clearEdns0MaxPayloadSize()
       Maximum EDNS0 UDP payload size in bytes.
 If set, c-ares will include EDNS0 in DNS queries and use this value as the maximum UDP response size.

 Recommended values:

 * **1232**: Safe default (avoids fragmentation).
 * **4096**: Maximum allowed.

 If unset, c-ares uses its internal default (usually 1232).
      .google.protobuf.UInt32Value edns0_max_payload_size = 9 [(.validate.rules) = { ... }

    • getEdns0MaxPayloadSizeBuilder

      public com.google.protobuf.UInt32Value.Builder getEdns0MaxPayloadSizeBuilder()
       Maximum EDNS0 UDP payload size in bytes.
 If set, c-ares will include EDNS0 in DNS queries and use this value as the maximum UDP response size.

 Recommended values:

 * **1232**: Safe default (avoids fragmentation).
 * **4096**: Maximum allowed.

 If unset, c-ares uses its internal default (usually 1232).
      .google.protobuf.UInt32Value edns0_max_payload_size = 9 [(.validate.rules) = { ... }

    • getEdns0MaxPayloadSizeOrBuilder

      public com.google.protobuf.UInt32ValueOrBuilder getEdns0MaxPayloadSizeOrBuilder()
       Maximum EDNS0 UDP payload size in bytes.
 If set, c-ares will include EDNS0 in DNS queries and use this value as the maximum UDP response size.

 Recommended values:

 * **1232**: Safe default (avoids fragmentation).
 * **4096**: Maximum allowed.

 If unset, c-ares uses its internal default (usually 1232).
      .google.protobuf.UInt32Value edns0_max_payload_size = 9 [(.validate.rules) = { ... }
      Specified by:
      getEdns0MaxPayloadSizeOrBuilder in interface CaresDnsResolverConfigOrBuilder

    • hasMaxUdpChannelDuration

      public boolean hasMaxUdpChannelDuration()
       The maximum duration for which a UDP channel will be kept alive before being refreshed.

 If set, the DNS resolver will periodically reinitialize its c-ares channel after the
 specified duration. This can help with avoiding stale socket states, and providing
 better load distribution across UDP ports.

 If not specified, no periodic refresh will be performed.
      .google.protobuf.Duration max_udp_channel_duration = 10 [(.validate.rules) = { ... }
      Specified by:
      hasMaxUdpChannelDuration in interface CaresDnsResolverConfigOrBuilder
      Returns:
      Whether the maxUdpChannelDuration field is set.

    • getMaxUdpChannelDuration

      public com.google.protobuf.Duration getMaxUdpChannelDuration()
       The maximum duration for which a UDP channel will be kept alive before being refreshed.

 If set, the DNS resolver will periodically reinitialize its c-ares channel after the
 specified duration. This can help with avoiding stale socket states, and providing
 better load distribution across UDP ports.

 If not specified, no periodic refresh will be performed.
      .google.protobuf.Duration max_udp_channel_duration = 10 [(.validate.rules) = { ... }
      Specified by:
      getMaxUdpChannelDuration in interface CaresDnsResolverConfigOrBuilder
      Returns:
      The maxUdpChannelDuration.

    • setMaxUdpChannelDuration

      public CaresDnsResolverConfig.Builder setMaxUdpChannelDuration(com.google.protobuf.Duration value)
       The maximum duration for which a UDP channel will be kept alive before being refreshed.

 If set, the DNS resolver will periodically reinitialize its c-ares channel after the
 specified duration. This can help with avoiding stale socket states, and providing
 better load distribution across UDP ports.

 If not specified, no periodic refresh will be performed.
      .google.protobuf.Duration max_udp_channel_duration = 10 [(.validate.rules) = { ... }

    • setMaxUdpChannelDuration

      public CaresDnsResolverConfig.Builder setMaxUdpChannelDuration(com.google.protobuf.Duration.Builder builderForValue)
       The maximum duration for which a UDP channel will be kept alive before being refreshed.

 If set, the DNS resolver will periodically reinitialize its c-ares channel after the
 specified duration. This can help with avoiding stale socket states, and providing
 better load distribution across UDP ports.

 If not specified, no periodic refresh will be performed.
      .google.protobuf.Duration max_udp_channel_duration = 10 [(.validate.rules) = { ... }

    • mergeMaxUdpChannelDuration

      public CaresDnsResolverConfig.Builder mergeMaxUdpChannelDuration(com.google.protobuf.Duration value)
       The maximum duration for which a UDP channel will be kept alive before being refreshed.

 If set, the DNS resolver will periodically reinitialize its c-ares channel after the
 specified duration. This can help with avoiding stale socket states, and providing
 better load distribution across UDP ports.

 If not specified, no periodic refresh will be performed.
      .google.protobuf.Duration max_udp_channel_duration = 10 [(.validate.rules) = { ... }

    • clearMaxUdpChannelDuration

      public CaresDnsResolverConfig.Builder clearMaxUdpChannelDuration()
       The maximum duration for which a UDP channel will be kept alive before being refreshed.

 If set, the DNS resolver will periodically reinitialize its c-ares channel after the
 specified duration. This can help with avoiding stale socket states, and providing
 better load distribution across UDP ports.

 If not specified, no periodic refresh will be performed.
      .google.protobuf.Duration max_udp_channel_duration = 10 [(.validate.rules) = { ... }

    • getMaxUdpChannelDurationBuilder

      public com.google.protobuf.Duration.Builder getMaxUdpChannelDurationBuilder()
       The maximum duration for which a UDP channel will be kept alive before being refreshed.

 If set, the DNS resolver will periodically reinitialize its c-ares channel after the
 specified duration. This can help with avoiding stale socket states, and providing
 better load distribution across UDP ports.

 If not specified, no periodic refresh will be performed.
      .google.protobuf.Duration max_udp_channel_duration = 10 [(.validate.rules) = { ... }

    • getMaxUdpChannelDurationOrBuilder

      public com.google.protobuf.DurationOrBuilder getMaxUdpChannelDurationOrBuilder()
       The maximum duration for which a UDP channel will be kept alive before being refreshed.

 If set, the DNS resolver will periodically reinitialize its c-ares channel after the
 specified duration. This can help with avoiding stale socket states, and providing
 better load distribution across UDP ports.

 If not specified, no periodic refresh will be performed.
      .google.protobuf.Duration max_udp_channel_duration = 10 [(.validate.rules) = { ... }
      Specified by:
      getMaxUdpChannelDurationOrBuilder in interface CaresDnsResolverConfigOrBuilder

    • getReinitChannelOnTimeout

      public boolean getReinitChannelOnTimeout()
       If true, reinitialize the c-ares channel when a DNS query fails with ``ARES_ETIMEOUT``.

 This can help recover from rare cases where the UDP sockets held by the c-ares
 channel become unusable after timeouts, causing subsequent queries to fail or
 Envoy to keep serving stale DNS results. When enabled, a timeout-triggered
 reinitialization attempts to restore healthy state quickly. In environments
 where timeouts are caused by intermittent network issues, enabling this may
 increase channel churn; consider using
 :ref:`max_udp_channel_duration <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.max_udp_channel_duration>`
 for periodic refresh instead.

 Default is false.
      bool reinit_channel_on_timeout = 11;
      Specified by:
      getReinitChannelOnTimeout in interface CaresDnsResolverConfigOrBuilder
      Returns:
      The reinitChannelOnTimeout.

    • setReinitChannelOnTimeout

      public CaresDnsResolverConfig.Builder setReinitChannelOnTimeout(boolean value)
       If true, reinitialize the c-ares channel when a DNS query fails with ``ARES_ETIMEOUT``.

 This can help recover from rare cases where the UDP sockets held by the c-ares
 channel become unusable after timeouts, causing subsequent queries to fail or
 Envoy to keep serving stale DNS results. When enabled, a timeout-triggered
 reinitialization attempts to restore healthy state quickly. In environments
 where timeouts are caused by intermittent network issues, enabling this may
 increase channel churn; consider using
 :ref:`max_udp_channel_duration <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.max_udp_channel_duration>`
 for periodic refresh instead.

 Default is false.
      bool reinit_channel_on_timeout = 11;
      Parameters:
      value - The reinitChannelOnTimeout to set.
      Returns:
      This builder for chaining.

    • clearReinitChannelOnTimeout

      public CaresDnsResolverConfig.Builder clearReinitChannelOnTimeout()
       If true, reinitialize the c-ares channel when a DNS query fails with ``ARES_ETIMEOUT``.

 This can help recover from rare cases where the UDP sockets held by the c-ares
 channel become unusable after timeouts, causing subsequent queries to fail or
 Envoy to keep serving stale DNS results. When enabled, a timeout-triggered
 reinitialization attempts to restore healthy state quickly. In environments
 where timeouts are caused by intermittent network issues, enabling this may
 increase channel churn; consider using
 :ref:`max_udp_channel_duration <envoy_v3_api_field_extensions.network.dns_resolver.cares.v3.CaresDnsResolverConfig.max_udp_channel_duration>`
 for periodic refresh instead.

 Default is false.
      bool reinit_channel_on_timeout = 11;
      Returns:
      This builder for chaining.

    • setUnknownFields

      public final CaresDnsResolverConfig.Builder setUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
      Specified by:
      setUnknownFields in interface com.google.protobuf.Message.Builder
      Overrides:
      setUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<CaresDnsResolverConfig.Builder>

    • mergeUnknownFields

      public final CaresDnsResolverConfig.Builder mergeUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
      Specified by:
      mergeUnknownFields in interface com.google.protobuf.Message.Builder
      Overrides:
      mergeUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<CaresDnsResolverConfig.Builder>