全部产品
Search
文档中心

服务网格 ASM:UpdateIstioGatewayRoutes - 更新网关路由

更新时间:Mar 05, 2024

调用UpdateIstioGatewayRoutes更新网关路由。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
ServiceMeshIdstring

服务网格实例 ID。

c08ba3fd1e6484b0f8cc1ad8fe10d****
IstioGatewayNamestring

ASM 网关名称。

ingressgateway
GatewayRouteobject

网关路由信息。

RouteNamestring

路由名称。

reviews-v2-routes
RouteTypestring

路由类型,取值:HTTPTLSTCP

HTTP
MatchRequestobject

路由匹配规则。

URIobject

URI 匹配规则。

MatchingModestring

路由规则匹配模式。取值:

  • exact:精准匹配。

  • prefix:前缀匹配。

  • regex:正则匹配。

prefix
MatchingContentstring

用于匹配的内容。

/ratings/v2/
Headersobject []

用于判断是否匹配的请求头部列表。

Namestring

Header 匹配的键。

x-request-id
MatchingModestring

Header 值匹配方式,取值:

  • exact:精准匹配。

  • prefix:前缀匹配。

  • regex:正则匹配。

exact
MatchingContentstring

用于 Header 匹配的内容。

v1
TLSMatchAttributesobject []

TLS 连接匹配属性列表。

TLSPortinteger

TLS 端口。

443
SNIHostsarray

服务器名称标识列表。

string

SNI 值中可以使用通配符前缀,例如*.com将匹配foo.example.comexample.com

说明 SNI 值必须是相应虚拟服务主机的子集。
*.com
Portsarray

端口列表。

integer

指定主机上要寻址的端口.。

443
RouteDestinationsobject []

L4 路由规则加权目的地列表。

Destinationobject

Destination 唯一标识请求或连接应转发到的服务实例。

Hoststring

服务注册表中服务的名称。

reviews
Subsetstring

服务中子集的名称。

v1
Portobject

目标服务的端口。

说明 当路由的目标服务有只有一个端口时,该字段可以不填写。如果有多个端口,需要指明端口号。
Numberinteger

端口号

80
Weightinteger

服务子集权重。

80
HTTPAdvancedOptionsobject

HTTP 路由高级配置选项。

HTTPRedirectobject

HTTP 重定向。

Uristring

在重定向时,使用此值覆盖 URL 的路径部分。

/v1/getProductRatings
Authoritystring

在重定向时,使用此值覆盖 URL 的 Authority 或 Host 部分

newratings.default.svc.cluster.local
RedirectCodeinteger

在重定向上,指定要在重定向响应中使用的 HTTP 状态代码。默认响应代码为 301。

301
Delegateobject

描述委托虚拟服务。

Namestring

名称。

reviews
Namespacestring

命名空间。

default
Rewriteobject

重写虚拟服务。

Uristring

用这个值重写 URI 的路径(或前缀)部分。

/v1/getProductRatings
Authoritystring

使用此值重写 Authority 或 Host 头。

newratings.default.svc.cluster.local
Timeoutstring

超时时长。

5s
Retriesobject

请求重试配置。

Attemptsinteger

给定请求允许的重试次数。

3
RetryOnstring

用于指定重试是否应重试到其他位置的标志,例如connect-failure,refused-stream,503

connect-failure,refused-stream,503
RetryRemoteLocalitiesobject

用于指定重试是否应重试到其他位置的标志。

Valueboolean

用于指定重试是否应重试到其他位置的标志,取值:

  • true:其他位置也重试

  • false:其他位置不重试

默认false

false
PerTryTimeoutstring

请求的每次尝试超时时间。

2s
Faultobject

故障注入设置。

Delayobject

设置延迟。

FixedDelaystring

固定延迟时间。

5s
Percentageobject

将注入延迟的请求的百分比。

Valuefloat

将注入延迟的请求的百分比,用小数表示。

0.1
Abortobject

提前中止带有预先指定的错误码的请求。

HttpStatusinteger

HTTP 状态码。

400
Percentageobject

使用提供的错误码中止的请求的百分比。

Valuefloat

使用提供的错误码中止的请求的百分比,用小数表示。

0.1
Mirrorobject

除了将请求转发到预期目标之外,还将 HTTP 通信镜像到另一个目标。

Hoststring

服务注册表中服务的名称。

reviews.default.svc.cluster.local
Subsetstring

服务中子集的名称。

v1
MirrorPercentageobject

流量镜像百分比。

Valuefloat

流量镜像百分比,用小数表示。

0.2
Namespacestring

命名空间

default
Domainsarray

请求的域名列表。

string

域名。

test.asm.aliyun.com
RawVSRouteany

序列化为 JSON 的 VirtualService 原始 YAML

{}
Priorityinteger

路由优先级。整数,数字越小,优先级越高。

1
Statusinteger

网关路由状态,取值:

  • 0:在线。

  • 1:下线。

  • 2:创建或更新错误。

1
Descriptionstring

路由描述。

demo route

返回参数

名称类型描述示例值
object

响应体。

RequestIdstring

请求 ID。

31d3a0f0-07ed-4f6e-9004-1804498c****

示例

正常返回示例

JSON格式

{
  "RequestId": "31d3a0f0-07ed-4f6e-9004-1804498c****"
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-06-25API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2022-08-25API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用