EventGatewayPolicyPatch
The schema of the policy to patch it.
A unique user-defined name of the policy.
Match pattern:^[\p{L}\p{N}][\p{L}\p{N} _\-\.']*[\p{L}\p{N}]$
>= 1 characters<= 255 characters
A human-readable description of the policy.
<= 512 characters
Whether the policy is enabled.
A string containing the boolean expression that determines whether the policy is applied.
<= 1000 characters
Example:context.topic.name.endsWith('my_suffix')
Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.
Example:{"env":"test"}
EventGatewayListenerPolicyPatch
The schema of the policy to patch it.
A unique user-defined name of the policy.
Match pattern:^[\p{L}\p{N}][\p{L}\p{N} _\-\.']*[\p{L}\p{N}]$
>= 1 characters<= 255 characters
A human-readable description of the policy.
<= 512 characters
Whether the policy is enabled.
Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.
Example:{"env":"test"}
TLSVersionRange
objectA range of TLS versions.
Default:{"min":"TLSv1.2","max":"TLSv1.3"}
Minimum TLS version to use.
Allowed values:TLSv1.2TLSv1.3
Default:TLSv1.2
Maximum TLS version to use.
Allowed values:TLSv1.2TLSv1.3
Default:TLSv1.3
Forward to Virtual Cluster
objectForwards requests to virtual clusters configured with port routing or SNI routing.
While there can be multiple of these policies configured on a listener, there can only be one instance of
port_mapping.
When multiple policies are configured, the first one that matches the connection is used.
If no policy matches, the connection is rejected.
When using port_mapping, there must be a mapping port for each broker on the backend cluster see
ForwardToClusterBySNIConfig for more details.
The type name of the policy.
Allowed values:forward_to_virtual_cluster
>= 1 characters<= 255 characters
A unique user-defined name of the policy.
<= 255 characters
A human-readable description of the policy.
Default:
<= 512 characters
Whether the policy is enabled.
Default:true
Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.
Example:{"env":"test"}
One OfThe configuration of the policy.
The configuration to forward requests to virtual clusters configured with SNI routing.
Show Child Parameters
ForwardToClusterByPortMappingConfig
objectThe configuration to forward request to destination and rewrite ports accordingly.
All broker ids must fit in the range of ports defined in the listener, if it doesn’t the metadata request will
return an error.
For example with ports: [9000, “9092-9094”, “9100”] and bootstrap_port: at_start and brokers with ids
1, 2, 3, 4 we will map: bootstrap to 9000 broker 1 to 9001, broker 2 to 9002, broker 3 to 9003, and broker 4
to 9004 and fail the metadata request as these ports are not open.
However, with the same configuration but with brokers with ids: 92,93,94,100 we will map: bootstrap to 9000,
broker 92 to 9092, broker 93 to 9093, broker 94 to 9094, and broker 100 to 9100.
In most cases users should use a single range ["9090-9094"] and bootstrap_port: at_start and connect with
<host>:9090 as bootstrap server. Being able to use multiple ranges is only useful when when dealing with
gaps in broker ids.
It is strongly discouraged to use port mapping in production.
Allowed values:port_mapping
Any OfA reference to a virtual cluster.
Reference a virtual cluster by its unique identifier.
Show Child Parameters
Virtual brokers are advertised to clients using this host. Any kind of host supported by kafka can be used. If not defined, it’s listen_address. If listen_address is 0.0.0.0 it’s the destination IP of the TCP connection.
Match pattern:^[a-z0-9](?:[a-z0-9\-]{0,61}[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9\-]{0,61}[a-z0-9])?)*$
If set to at_start, the first port will be used as a bootstrap port.
It provides a stable endpoint to use as the bootstrap server for clients, regardless of broker
IDs in the cluster.
Additionally, it offsets all ports by one, so for example, if there are 3 brokers (id=1, id=2, id=3)
then we will use 4 ports: 9092 (bootstrap), 9093 (id=1), 9094 (id=2), 9095 (id=3)
With none we will use 3 ports: 9092 (id=1), 9093 (id=2), 9094 (id=3).
Allowed values:noneat_start
Default:at_start
The lowest broker node ID in the cluster.
Default:0