Network addresses

Note

v2 API difference: Addresses now have .proto structure.

Pipe

[Pipe proto]

  1. {
  2. "path": "..."
  3. }

path

(string, REQUIRED) Unix Domain Socket path.

SocketAddress

[SocketAddress proto]

  1. {
  2. "protocol": "...",
  3. "address": "...",
  4. "port_value": "...",
  5. "named_port": "...",
  6. "resolver_name": "..."
  7. }

protocol

(SocketAddress.Protocol)

address

(string) The address for this socket. Listeners will bind to the address or outbound connections will be made. An empty address implies a bind to 0.0.0.0 or ::. It’s still possible to distinguish on an address via the prefix/suffix matching in FilterChainMatch after connection. For clusters, an address may be either an IP or hostname to be resolved via DNS. If it is a hostname, resolver_name should be set unless default (i.e. DNS) resolution is expected.

port_value

(uint32)

Precisely one of port_value, named_port must be set.

named_port

(string) This is only valid if resolver_name is specified below and the named resolver is capable of named port resolution.

Precisely one of port_value, named_port must be set.

resolver_name

(string) The name of the resolver. This must have been registered with Envoy. If this is empty, a context dependent default applies. If address is a hostname this should be set for resolution other than DNS. If the address is a concrete IP address, no resolution will occur.

Enum SocketAddress.Protocol

[SocketAddress.Protocol proto]

TCP

(DEFAULT)

BindConfig

[BindConfig proto]

  1. {
  2. "source_address": "{...}"
  3. }

source_address

(SocketAddress, REQUIRED) The address to bind to when creating a socket.

Address

[Address proto]

Addresses specify either a logical or physical address and port, which are used to tell Envoy where to bind/listen, connect to upstream and find management servers.

  1. {
  2. "socket_address": "{...}",
  3. "pipe": "{...}"
  4. }

socket_address

(SocketAddress)

Precisely one of socket_address, pipe must be set.

pipe

(Pipe)

Precisely one of socket_address, pipe must be set.

CidrRange

[CidrRange proto]

CidrRange specifies an IP Address and a prefix length to construct the subnet mask for a CIDR range.

  1. {
  2. "address_prefix": "...",
  3. "prefix_len": "{...}"
  4. }

address_prefix

(string, REQUIRED) IPv4 or IPv6 address, e.g. 192.0.0.0 or 2001:db8::.

prefix_len

(UInt32Value) Length of prefix, e.g. 0, 32.