Documentation
¶
Index ¶
- Variables
- type DnsTable
- func (*DnsTable) Descriptor() ([]byte, []int)deprecated
- func (x *DnsTable) GetExternalRetryCount() uint32
- func (x *DnsTable) GetKnownSuffixes() []*v3.StringMatcherdeprecated
- func (x *DnsTable) GetVirtualDomains() []*DnsTable_DnsVirtualDomain
- func (*DnsTable) ProtoMessage()
- func (x *DnsTable) ProtoReflect() protoreflect.Message
- func (x *DnsTable) Reset()
- func (x *DnsTable) String() string
- type DnsTable_AddressList
- func (*DnsTable_AddressList) Descriptor() ([]byte, []int)deprecated
- func (x *DnsTable_AddressList) GetAddress() []string
- func (*DnsTable_AddressList) ProtoMessage()
- func (x *DnsTable_AddressList) ProtoReflect() protoreflect.Message
- func (x *DnsTable_AddressList) Reset()
- func (x *DnsTable_AddressList) String() string
- type DnsTable_DnsEndpoint
- func (*DnsTable_DnsEndpoint) Descriptor() ([]byte, []int)deprecated
- func (x *DnsTable_DnsEndpoint) GetAddressList() *DnsTable_AddressList
- func (x *DnsTable_DnsEndpoint) GetClusterName() string
- func (m *DnsTable_DnsEndpoint) GetEndpointConfig() isDnsTable_DnsEndpoint_EndpointConfig
- func (x *DnsTable_DnsEndpoint) GetServiceList() *DnsTable_DnsServiceList
- func (*DnsTable_DnsEndpoint) ProtoMessage()
- func (x *DnsTable_DnsEndpoint) ProtoReflect() protoreflect.Message
- func (x *DnsTable_DnsEndpoint) Reset()
- func (x *DnsTable_DnsEndpoint) String() string
- type DnsTable_DnsEndpoint_AddressList
- type DnsTable_DnsEndpoint_ClusterName
- type DnsTable_DnsEndpoint_ServiceList
- type DnsTable_DnsService
- func (*DnsTable_DnsService) Descriptor() ([]byte, []int)deprecated
- func (x *DnsTable_DnsService) GetProtocol() *DnsTable_DnsServiceProtocol
- func (x *DnsTable_DnsService) GetServiceName() string
- func (x *DnsTable_DnsService) GetTargets() []*DnsTable_DnsServiceTarget
- func (x *DnsTable_DnsService) GetTtl() *durationpb.Duration
- func (*DnsTable_DnsService) ProtoMessage()
- func (x *DnsTable_DnsService) ProtoReflect() protoreflect.Message
- func (x *DnsTable_DnsService) Reset()
- func (x *DnsTable_DnsService) String() string
- type DnsTable_DnsServiceList
- func (*DnsTable_DnsServiceList) Descriptor() ([]byte, []int)deprecated
- func (x *DnsTable_DnsServiceList) GetServices() []*DnsTable_DnsService
- func (*DnsTable_DnsServiceList) ProtoMessage()
- func (x *DnsTable_DnsServiceList) ProtoReflect() protoreflect.Message
- func (x *DnsTable_DnsServiceList) Reset()
- func (x *DnsTable_DnsServiceList) String() string
- type DnsTable_DnsServiceProtocol
- func (*DnsTable_DnsServiceProtocol) Descriptor() ([]byte, []int)deprecated
- func (x *DnsTable_DnsServiceProtocol) GetName() string
- func (x *DnsTable_DnsServiceProtocol) GetNumber() uint32
- func (m *DnsTable_DnsServiceProtocol) GetProtocolConfig() isDnsTable_DnsServiceProtocol_ProtocolConfig
- func (*DnsTable_DnsServiceProtocol) ProtoMessage()
- func (x *DnsTable_DnsServiceProtocol) ProtoReflect() protoreflect.Message
- func (x *DnsTable_DnsServiceProtocol) Reset()
- func (x *DnsTable_DnsServiceProtocol) String() string
- type DnsTable_DnsServiceProtocol_Name
- type DnsTable_DnsServiceProtocol_Number
- type DnsTable_DnsServiceTarget
- func (*DnsTable_DnsServiceTarget) Descriptor() ([]byte, []int)deprecated
- func (x *DnsTable_DnsServiceTarget) GetClusterName() string
- func (m *DnsTable_DnsServiceTarget) GetEndpointType() isDnsTable_DnsServiceTarget_EndpointType
- func (x *DnsTable_DnsServiceTarget) GetHostName() string
- func (x *DnsTable_DnsServiceTarget) GetPort() uint32
- func (x *DnsTable_DnsServiceTarget) GetPriority() uint32
- func (x *DnsTable_DnsServiceTarget) GetWeight() uint32
- func (*DnsTable_DnsServiceTarget) ProtoMessage()
- func (x *DnsTable_DnsServiceTarget) ProtoReflect() protoreflect.Message
- func (x *DnsTable_DnsServiceTarget) Reset()
- func (x *DnsTable_DnsServiceTarget) String() string
- type DnsTable_DnsServiceTarget_ClusterName
- type DnsTable_DnsServiceTarget_HostName
- type DnsTable_DnsVirtualDomain
- func (*DnsTable_DnsVirtualDomain) Descriptor() ([]byte, []int)deprecated
- func (x *DnsTable_DnsVirtualDomain) GetAnswerTtl() *durationpb.Duration
- func (x *DnsTable_DnsVirtualDomain) GetEndpoint() *DnsTable_DnsEndpoint
- func (x *DnsTable_DnsVirtualDomain) GetName() string
- func (*DnsTable_DnsVirtualDomain) ProtoMessage()
- func (x *DnsTable_DnsVirtualDomain) ProtoReflect() protoreflect.Message
- func (x *DnsTable_DnsVirtualDomain) Reset()
- func (x *DnsTable_DnsVirtualDomain) String() string
Constants ¶
This section is empty.
Variables ¶
var File_envoy_data_dns_v3_dns_table_proto protoreflect.FileDescriptor
Functions ¶
This section is empty.
Types ¶
type DnsTable ¶
type DnsTable struct {
// Control how many times Envoy makes an attempt to forward a query to an external DNS server
ExternalRetryCount uint32 `protobuf:"varint,1,opt,name=external_retry_count,json=externalRetryCount,proto3" json:"external_retry_count,omitempty"`
// Fully qualified domain names for which Envoy will respond to DNS queries. By leaving this
// list empty, Envoy will forward all queries to external resolvers
VirtualDomains []*DnsTable_DnsVirtualDomain `protobuf:"bytes,2,rep,name=virtual_domains,json=virtualDomains,proto3" json:"virtual_domains,omitempty"`
// This field is deprecated and no longer used in Envoy. The filter's behavior has changed
// internally to use a different data structure allowing the filter to determine whether a
// query is for known domain without the use of this field.
//
// This field serves to help Envoy determine whether it can authoritatively answer a query
// for a name matching a suffix in this list. If the query name does not match a suffix in
// this list, Envoy will forward the query to an upstream DNS server
//
// Deprecated: Marked as deprecated in envoy/data/dns/v3/dns_table.proto.
KnownSuffixes []*v3.StringMatcher `protobuf:"bytes,3,rep,name=known_suffixes,json=knownSuffixes,proto3" json:"known_suffixes,omitempty"`
// contains filtered or unexported fields
}
This message contains the configuration for the DNS Filter if populated from the control plane
func (*DnsTable) Descriptor
deprecated
func (*DnsTable) GetExternalRetryCount ¶
func (*DnsTable) GetKnownSuffixes
deprecated
func (x *DnsTable) GetKnownSuffixes() []*v3.StringMatcher
Deprecated: Marked as deprecated in envoy/data/dns/v3/dns_table.proto.
func (*DnsTable) GetVirtualDomains ¶
func (x *DnsTable) GetVirtualDomains() []*DnsTable_DnsVirtualDomain
func (*DnsTable) ProtoMessage ¶
func (*DnsTable) ProtoMessage()
func (*DnsTable) ProtoReflect ¶
func (x *DnsTable) ProtoReflect() protoreflect.Message
type DnsTable_AddressList ¶
type DnsTable_AddressList struct {
// This field contains a well formed IP address that is returned in the answer for a
// name query. The address field can be an IPv4 or IPv6 address. Address family
// detection is done automatically when Envoy parses the string. Since this field is
// repeated, Envoy will return as many entries from this list in the DNS response while
// keeping the response under 512 bytes
Address []string `protobuf:"bytes,1,rep,name=address,proto3" json:"address,omitempty"`
// contains filtered or unexported fields
}
This message contains a list of IP addresses returned for a query for a known name
func (*DnsTable_AddressList) Descriptor
deprecated
func (*DnsTable_AddressList) Descriptor() ([]byte, []int)
Deprecated: Use DnsTable_AddressList.ProtoReflect.Descriptor instead.
func (*DnsTable_AddressList) GetAddress ¶
func (x *DnsTable_AddressList) GetAddress() []string
func (*DnsTable_AddressList) ProtoMessage ¶
func (*DnsTable_AddressList) ProtoMessage()
func (*DnsTable_AddressList) ProtoReflect ¶
func (x *DnsTable_AddressList) ProtoReflect() protoreflect.Message
func (*DnsTable_AddressList) Reset ¶
func (x *DnsTable_AddressList) Reset()
func (*DnsTable_AddressList) String ¶
func (x *DnsTable_AddressList) String() string
type DnsTable_DnsEndpoint ¶
type DnsTable_DnsEndpoint struct {
// Types that are assignable to EndpointConfig:
//
// *DnsTable_DnsEndpoint_AddressList
// *DnsTable_DnsEndpoint_ClusterName
// *DnsTable_DnsEndpoint_ServiceList
EndpointConfig isDnsTable_DnsEndpoint_EndpointConfig `protobuf_oneof:"endpoint_config"`
// contains filtered or unexported fields
}
func (*DnsTable_DnsEndpoint) Descriptor
deprecated
func (*DnsTable_DnsEndpoint) Descriptor() ([]byte, []int)
Deprecated: Use DnsTable_DnsEndpoint.ProtoReflect.Descriptor instead.
func (*DnsTable_DnsEndpoint) GetAddressList ¶
func (x *DnsTable_DnsEndpoint) GetAddressList() *DnsTable_AddressList
func (*DnsTable_DnsEndpoint) GetClusterName ¶
func (x *DnsTable_DnsEndpoint) GetClusterName() string
func (*DnsTable_DnsEndpoint) GetEndpointConfig ¶
func (m *DnsTable_DnsEndpoint) GetEndpointConfig() isDnsTable_DnsEndpoint_EndpointConfig
func (*DnsTable_DnsEndpoint) GetServiceList ¶
func (x *DnsTable_DnsEndpoint) GetServiceList() *DnsTable_DnsServiceList
func (*DnsTable_DnsEndpoint) ProtoMessage ¶
func (*DnsTable_DnsEndpoint) ProtoMessage()
func (*DnsTable_DnsEndpoint) ProtoReflect ¶
func (x *DnsTable_DnsEndpoint) ProtoReflect() protoreflect.Message
func (*DnsTable_DnsEndpoint) Reset ¶
func (x *DnsTable_DnsEndpoint) Reset()
func (*DnsTable_DnsEndpoint) String ¶
func (x *DnsTable_DnsEndpoint) String() string
type DnsTable_DnsEndpoint_AddressList ¶
type DnsTable_DnsEndpoint_AddressList struct {
// Define a list of addresses to return for the specified endpoint
AddressList *DnsTable_AddressList `protobuf:"bytes,1,opt,name=address_list,json=addressList,proto3,oneof"`
}
type DnsTable_DnsEndpoint_ClusterName ¶
type DnsTable_DnsEndpoint_ClusterName struct {
// Define a cluster whose addresses are returned for the specified endpoint
ClusterName string `protobuf:"bytes,2,opt,name=cluster_name,json=clusterName,proto3,oneof"`
}
type DnsTable_DnsEndpoint_ServiceList ¶
type DnsTable_DnsEndpoint_ServiceList struct {
// Define a DNS Service List for the specified endpoint
ServiceList *DnsTable_DnsServiceList `protobuf:"bytes,3,opt,name=service_list,json=serviceList,proto3,oneof"`
}
type DnsTable_DnsService ¶
type DnsTable_DnsService struct {
// The name of the service without the protocol or domain name
ServiceName string `protobuf:"bytes,1,opt,name=service_name,json=serviceName,proto3" json:"service_name,omitempty"`
// The service protocol. This can be specified as a string or the numeric value of the protocol
Protocol *DnsTable_DnsServiceProtocol `protobuf:"bytes,2,opt,name=protocol,proto3" json:"protocol,omitempty"`
// The service entry time to live. This is independent from the DNS Answer record TTL
Ttl *durationpb.Duration `protobuf:"bytes,3,opt,name=ttl,proto3" json:"ttl,omitempty"`
// The list of targets hosting the service
Targets []*DnsTable_DnsServiceTarget `protobuf:"bytes,4,rep,name=targets,proto3" json:"targets,omitempty"`
// contains filtered or unexported fields
}
This message defines a service selection record returned for a service query in a domain
func (*DnsTable_DnsService) Descriptor
deprecated
func (*DnsTable_DnsService) Descriptor() ([]byte, []int)
Deprecated: Use DnsTable_DnsService.ProtoReflect.Descriptor instead.
func (*DnsTable_DnsService) GetProtocol ¶
func (x *DnsTable_DnsService) GetProtocol() *DnsTable_DnsServiceProtocol
func (*DnsTable_DnsService) GetServiceName ¶
func (x *DnsTable_DnsService) GetServiceName() string
func (*DnsTable_DnsService) GetTargets ¶
func (x *DnsTable_DnsService) GetTargets() []*DnsTable_DnsServiceTarget
func (*DnsTable_DnsService) GetTtl ¶
func (x *DnsTable_DnsService) GetTtl() *durationpb.Duration
func (*DnsTable_DnsService) ProtoMessage ¶
func (*DnsTable_DnsService) ProtoMessage()
func (*DnsTable_DnsService) ProtoReflect ¶
func (x *DnsTable_DnsService) ProtoReflect() protoreflect.Message
func (*DnsTable_DnsService) Reset ¶
func (x *DnsTable_DnsService) Reset()
func (*DnsTable_DnsService) String ¶
func (x *DnsTable_DnsService) String() string
type DnsTable_DnsServiceList ¶
type DnsTable_DnsServiceList struct {
Services []*DnsTable_DnsService `protobuf:"bytes,1,rep,name=services,proto3" json:"services,omitempty"`
// contains filtered or unexported fields
}
Define a list of service records for a given service
func (*DnsTable_DnsServiceList) Descriptor
deprecated
func (*DnsTable_DnsServiceList) Descriptor() ([]byte, []int)
Deprecated: Use DnsTable_DnsServiceList.ProtoReflect.Descriptor instead.
func (*DnsTable_DnsServiceList) GetServices ¶
func (x *DnsTable_DnsServiceList) GetServices() []*DnsTable_DnsService
func (*DnsTable_DnsServiceList) ProtoMessage ¶
func (*DnsTable_DnsServiceList) ProtoMessage()
func (*DnsTable_DnsServiceList) ProtoReflect ¶
func (x *DnsTable_DnsServiceList) ProtoReflect() protoreflect.Message
func (*DnsTable_DnsServiceList) Reset ¶
func (x *DnsTable_DnsServiceList) Reset()
func (*DnsTable_DnsServiceList) String ¶
func (x *DnsTable_DnsServiceList) String() string
type DnsTable_DnsServiceProtocol ¶
type DnsTable_DnsServiceProtocol struct {
// Types that are assignable to ProtocolConfig:
//
// *DnsTable_DnsServiceProtocol_Number
// *DnsTable_DnsServiceProtocol_Name
ProtocolConfig isDnsTable_DnsServiceProtocol_ProtocolConfig `protobuf_oneof:"protocol_config"`
// contains filtered or unexported fields
}
Specify the service protocol using a numeric or string value
func (*DnsTable_DnsServiceProtocol) Descriptor
deprecated
func (*DnsTable_DnsServiceProtocol) Descriptor() ([]byte, []int)
Deprecated: Use DnsTable_DnsServiceProtocol.ProtoReflect.Descriptor instead.
func (*DnsTable_DnsServiceProtocol) GetName ¶
func (x *DnsTable_DnsServiceProtocol) GetName() string
func (*DnsTable_DnsServiceProtocol) GetNumber ¶
func (x *DnsTable_DnsServiceProtocol) GetNumber() uint32
func (*DnsTable_DnsServiceProtocol) GetProtocolConfig ¶
func (m *DnsTable_DnsServiceProtocol) GetProtocolConfig() isDnsTable_DnsServiceProtocol_ProtocolConfig
func (*DnsTable_DnsServiceProtocol) ProtoMessage ¶
func (*DnsTable_DnsServiceProtocol) ProtoMessage()
func (*DnsTable_DnsServiceProtocol) ProtoReflect ¶
func (x *DnsTable_DnsServiceProtocol) ProtoReflect() protoreflect.Message
func (*DnsTable_DnsServiceProtocol) Reset ¶
func (x *DnsTable_DnsServiceProtocol) Reset()
func (*DnsTable_DnsServiceProtocol) String ¶
func (x *DnsTable_DnsServiceProtocol) String() string
type DnsTable_DnsServiceProtocol_Name ¶
type DnsTable_DnsServiceProtocol_Name struct {
// Specify the protocol name for the service.
Name string `protobuf:"bytes,2,opt,name=name,proto3,oneof"`
}
type DnsTable_DnsServiceProtocol_Number ¶
type DnsTable_DnsServiceProtocol_Number struct {
// Specify the protocol number for the service. Envoy will try to resolve the number to
// the protocol name. For example, 6 will resolve to "tcp". Refer to:
// https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml
// for protocol names and numbers
Number uint32 `protobuf:"varint,1,opt,name=number,proto3,oneof"`
}
type DnsTable_DnsServiceTarget ¶
type DnsTable_DnsServiceTarget struct {
// Specify the name of the endpoint for the Service. The name is a hostname or a cluster
//
// Types that are assignable to EndpointType:
//
// *DnsTable_DnsServiceTarget_HostName
// *DnsTable_DnsServiceTarget_ClusterName
EndpointType isDnsTable_DnsServiceTarget_EndpointType `protobuf_oneof:"endpoint_type"`
// The priority of the service record target
Priority uint32 `protobuf:"varint,3,opt,name=priority,proto3" json:"priority,omitempty"`
// The weight of the service record target
Weight uint32 `protobuf:"varint,4,opt,name=weight,proto3" json:"weight,omitempty"`
// The port to which the service is bound. This value is optional if the target is a
// cluster. Setting port to zero in this case makes the filter use the port value
// from the cluster host
Port uint32 `protobuf:"varint,5,opt,name=port,proto3" json:"port,omitempty"`
// contains filtered or unexported fields
}
Specify the target for a given DNS service [#next-free-field: 6]
func (*DnsTable_DnsServiceTarget) Descriptor
deprecated
func (*DnsTable_DnsServiceTarget) Descriptor() ([]byte, []int)
Deprecated: Use DnsTable_DnsServiceTarget.ProtoReflect.Descriptor instead.
func (*DnsTable_DnsServiceTarget) GetClusterName ¶
func (x *DnsTable_DnsServiceTarget) GetClusterName() string
func (*DnsTable_DnsServiceTarget) GetEndpointType ¶
func (m *DnsTable_DnsServiceTarget) GetEndpointType() isDnsTable_DnsServiceTarget_EndpointType
func (*DnsTable_DnsServiceTarget) GetHostName ¶
func (x *DnsTable_DnsServiceTarget) GetHostName() string
func (*DnsTable_DnsServiceTarget) GetPort ¶
func (x *DnsTable_DnsServiceTarget) GetPort() uint32
func (*DnsTable_DnsServiceTarget) GetPriority ¶
func (x *DnsTable_DnsServiceTarget) GetPriority() uint32
func (*DnsTable_DnsServiceTarget) GetWeight ¶
func (x *DnsTable_DnsServiceTarget) GetWeight() uint32
func (*DnsTable_DnsServiceTarget) ProtoMessage ¶
func (*DnsTable_DnsServiceTarget) ProtoMessage()
func (*DnsTable_DnsServiceTarget) ProtoReflect ¶
func (x *DnsTable_DnsServiceTarget) ProtoReflect() protoreflect.Message
func (*DnsTable_DnsServiceTarget) Reset ¶
func (x *DnsTable_DnsServiceTarget) Reset()
func (*DnsTable_DnsServiceTarget) String ¶
func (x *DnsTable_DnsServiceTarget) String() string
type DnsTable_DnsServiceTarget_ClusterName ¶
type DnsTable_DnsServiceTarget_ClusterName struct {
// Use a cluster name as the endpoint for a service.
ClusterName string `protobuf:"bytes,2,opt,name=cluster_name,json=clusterName,proto3,oneof"`
}
type DnsTable_DnsServiceTarget_HostName ¶
type DnsTable_DnsServiceTarget_HostName struct {
// Use a resolvable hostname as the endpoint for a service.
HostName string `protobuf:"bytes,1,opt,name=host_name,json=hostName,proto3,oneof"`
}
type DnsTable_DnsVirtualDomain ¶
type DnsTable_DnsVirtualDomain struct {
// A domain name for which Envoy will respond to query requests.
// Wildcard records are supported on the first label only, e.g. “*.example.com“ or “*.subdomain.example.com“.
// Names such as “*example.com“, “subdomain.*.example.com“, “*subdomain.example.com“, etc
// are not valid wildcard names and asterisk will be interpreted as a literal “*“ character.
// Wildcard records match subdomains on any levels, e.g. “*.example.com“ will match
// “foo.example.com“, “bar.foo.example.com“, “baz.bar.foo.example.com“, etc. In case there are multiple
// wildcard records, the longest wildcard match will be used, e.g. if there are wildcard records for
// “*.example.com“ and “*.foo.example.com“ and the query is for “bar.foo.example.com“, the latter will be used.
// Specific records will always take precedence over wildcard records.
Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
// The configuration containing the method to determine the address of this endpoint
Endpoint *DnsTable_DnsEndpoint `protobuf:"bytes,2,opt,name=endpoint,proto3" json:"endpoint,omitempty"`
// Sets the TTL in DNS answers from Envoy returned to the client. The default TTL is 300s
AnswerTtl *durationpb.Duration `protobuf:"bytes,3,opt,name=answer_ttl,json=answerTtl,proto3" json:"answer_ttl,omitempty"`
// contains filtered or unexported fields
}
func (*DnsTable_DnsVirtualDomain) Descriptor
deprecated
func (*DnsTable_DnsVirtualDomain) Descriptor() ([]byte, []int)
Deprecated: Use DnsTable_DnsVirtualDomain.ProtoReflect.Descriptor instead.
func (*DnsTable_DnsVirtualDomain) GetAnswerTtl ¶
func (x *DnsTable_DnsVirtualDomain) GetAnswerTtl() *durationpb.Duration
func (*DnsTable_DnsVirtualDomain) GetEndpoint ¶
func (x *DnsTable_DnsVirtualDomain) GetEndpoint() *DnsTable_DnsEndpoint
func (*DnsTable_DnsVirtualDomain) GetName ¶
func (x *DnsTable_DnsVirtualDomain) GetName() string
func (*DnsTable_DnsVirtualDomain) ProtoMessage ¶
func (*DnsTable_DnsVirtualDomain) ProtoMessage()
func (*DnsTable_DnsVirtualDomain) ProtoReflect ¶
func (x *DnsTable_DnsVirtualDomain) ProtoReflect() protoreflect.Message
func (*DnsTable_DnsVirtualDomain) Reset ¶
func (x *DnsTable_DnsVirtualDomain) Reset()
func (*DnsTable_DnsVirtualDomain) String ¶
func (x *DnsTable_DnsVirtualDomain) String() string