资源:TlsRoute
TlsRoute 定义应如何根据 SNI 和其他匹配的 L3 属性路由流量。
JSON 表示法 |
---|
{
"name": string,
"selfLink": string,
"createTime": string,
"updateTime": string,
"description": string,
"rules": [
{
object ( |
字段 | |
---|---|
name |
必需。TlsRoute 资源的名称。它匹配 |
selfLink |
仅限输出。此资源的服务器定义网址 |
createTime |
仅限输出。创建资源时的时间戳。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
updateTime |
仅限输出。更新资源时的时间戳。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
description |
可选。资源的自由文本说明。长度上限为 1024 个字符。 |
rules[] |
必需。用于定义流量路由和处理方式的规则。必须至少提供一个 RouteRule。如果存在多条规则,所执行的操作将是第一个匹配的规则。 |
meshes[] |
可选。网格定义了一个 TlsRoute 附加的网格列表,作为路由规则之一,用于路由由网格处理的请求。 每个网格引用都应与模式匹配: 附加网格的类型应为 SIDECAR |
gateways[] |
可选。网关定义了此 TlsRoute 附加的网关列表,作为路由规则之一,用于路由网关处理的请求。 每个网关引用都应匹配以下格式: |
labels |
可选。与 TlsRoute 资源关联的一组标签。 包含一系列 |
RouteRule
指定如何匹配流量以及如何在匹配流量时路由流量。
JSON 表示法 |
---|
{ "matches": [ { object ( |
字段 | |
---|---|
matches[] |
必需。RouteMatch 用于定义用于将请求与给定操作进行匹配的谓词。有多个匹配类型使用“OR”运算符求值。 |
action |
必需。用于定义如何路由匹配流量的详细规则。 |
RouteMatch
RouteMatch 用于定义用于将请求与给定操作进行匹配的谓词。有多个匹配类型可“AND”以求值。如果未指定 routeMatch 字段,则此规则将无条件匹配流量。
JSON 表示法 |
---|
{ "sniHost": [ string ], "alpn": [ string ] } |
字段 | |
---|---|
sniHost[] |
可选。要匹配的 SNI(服务器名称指示)。SNI 将与所有通配符网域进行匹配,即 |
alpn[] |
可选。要匹配的 ALPN(应用层协议协商)。例如:"http/1.1"、"h2"。sniHost 和 alpn 至少需要设置其中一个。您最多可以在所有匹配中设置 5 个 alpn。 |
RouteAction
有关路由流量和应用相关政策的规范。
JSON 表示法 |
---|
{
"destinations": [
{
object ( |
字段 | |
---|---|
destinations[] |
必需。流量应转发到的目标服务。必须至少提供一项目标服务。 |
idleTimeout |
可选。指定所选路由的空闲超时时间。闲置超时是指上游或下游连接上没有发送或接收任何字节的时间段。如果未设置,默认空闲超时时间为 1 小时。如果设置为 0 秒,则会停用超时。 该时长以秒为单位,最多包含九个小数位,以“ |
RouteDestination
描述要将流量路由到的目的地。
JSON 表示法 |
---|
{ "serviceName": string, "weight": integer } |
字段 | |
---|---|
serviceName |
必需。要将流量路由到的 BackendService 的网址。 |
weight |
可选。指定转发到 serviceName 字段所引用的后端的请求比例。计算公式如下:- 权重/总和(目标中的权重)所有目标中的权重的总和不必为 100。 |
方法 |
|
---|---|
|
在给定的项目和位置中创建新的 TlsRoute。 |
|
删除单个 TlsRoute。 |
|
获取单个 TlsRoute 的详细信息。 |
|
列出给定项目和位置中的 TlsRoute。 |
|
更新单个 TlsRoute 的参数。 |