使用CreateIstioGatewayRoutes创建ASM网关路由-服务网格-阿里云

调用CreateIstioGatewayRoutes创建ASM网关对应的路由。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

servicemesh:CreateIstioGatewayRoutes

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
ServiceMeshId	string	是	服务网格实例 ID。	c08ba3fd1e6484b0f8cc1ad8fe10d****
IstioGatewayName	string	否	ASM 网关名称。	ingressgateway
GatewayRoute	object	否	网关路由信息。
RouteName	string	否	路由名称	reviews-v2-routes
RouteType	string	否	路由类型，取值：`HTTP`、`TLS`、`TCP`。	HTTP
MatchRequest	object	否	路由匹配规则。
URI	object	否	URI 匹配规则。
MatchingMode	string	否	路由规则匹配模式。取值： `exact`：精准匹配。 `prefix`：前缀匹配。 `regex`：正则匹配。	prefix
MatchingContent	string	否	用于匹配的内容。	/ratings/v2/
Headers	array	否	用于判断是否匹配的请求头部列表。
	object	否	用于判断是否匹配的请求头部。
Name	string	否	Header 匹配的键。	x-request-id
MatchingMode	string	否	Header 值匹配方式，取值： `exact`：精准匹配。 `prefix`：前缀匹配。 `regex`：正则匹配。	exact
MatchingContent	string	否	用于 Header 匹配的内容。	v1
TLSMatchAttributes	array	否	TLS 连接匹配属性列表。
	object	否	TLS 连接匹配属性。
TLSPort	integer	否	TLS 端口。	443
SNIHosts	array	否	服务器名称标识列表。
	string	否	SNI 值中可以使用通配符前缀，例如`*.com`将匹配`foo.example.com`和`example.com`。说明 SNI 值必须是相应虚拟服务主机的子集。	*.com
Ports	array	否	L4 目标端口列表。
	integer	否	指定主机上要寻址的端口。	443
RouteDestinations	array	否	L4 路由规则加权目的地列表。
	array<object>	否	L4 路由规则加权目的地
Destination	object	否	Destination 唯一标识请求或连接应转发到的服务实例。
Host	string	否	服务注册表中服务的名称。	reviews
Subset	string	否	服务中子集的名称。	v1
Port	object	否	端口
Number	integer	否	端口号	80
Weight	integer	否	服务子集权重。	80
HTTPAdvancedOptions	object	否	HTTP 路由高级配置选项。
HTTPRedirect	object	否	HTTP 重定向。
Uri	string	否	在重定向时，使用此值覆盖 URL 的路径部分。	/v1/getProductRatings
Authority	string	否	在重定向时，使用此值覆盖 URL 的`Authority/Host`部分。	newratings.default.svc.cluster.local
RedirectCode	integer	否	在重定向上，指定要在重定向响应中使用的 HTTP 状态代码。默认响应代码为 301。	301
Delegate	object	否	虚拟服务流量代理。
Name	string	否	名称。	reviews
Namespace	string	否	命名空间。	default
Rewrite	object	否	重写虚拟服务。
Uri	string	否	用这个值重写 URI 的路径（或前缀）部分。	/v1/getProductRatings
Authority	string	否	使用此值重写 Authority 或 Host 头。	newratings.default.svc.cluster.local
Timeout	string	否	超时时长。	5s
Retries	object	否	请求重试配置。
Attempts	integer	否	给定请求允许的重试次数。	3
PerTryTimeout	string	否	用于指定给定请求的每次尝试超时，例如`5s`。	5s
RetryOn	string	否	用于指定重试发生的条件，例如`connect-failure,refused-stream,503`。	connect-failure,refused-stream,503
RetryRemoteLocalities	object	否	用于指定重试是否应重试到其他位置的标志。
Value	boolean	否	用于指定重试是否应重试到其他位置的标志，取值： `true`：其他位置也重试。 `false`：其他位置不重试。默认`false`。	false
Fault	object	否	故障注入设置。
Delay	object	否	设置延迟。
FixedDelay	string	否	固定延迟时间。	5s
Percentage	object	否	将注入延迟的请求的百分比。
Value	number	否	将注入延迟的请求的百分比，用小数表示。	0.1
Abort	object	否	提前中止带有预先指定的错误码的请求。
HttpStatus	integer	否	HTTP 状态码。	400
Percentage	object	否	使用提供的错误码中止的请求的百分比。
Value	number	否	使用提供的错误码中止的请求的百分比，用小数表示。	0.1
Mirror	object	否	除了将请求转发到预期目标之外，还将 HTTP 通信镜像到另一个目标。
Host	string	否	服务注册表中服务的名称。	reviews.default.svc.cluster.local
Subset	string	否	服务中子集的名称。	v1
MirrorPercentage	object	否	流量镜像百分比。
Value	number	否	流量镜像百分比，用小数表示。	0.2
Namespace	string	否	命名空间	default
Domains	array	否	请求域名列表。
	string	否	域名。	test.asm.aliyun.com
RawVSRoute	any	否	Json 类型的字符串。和虚拟服务中的三种路由类型对应，提供高级功能的配置入口。此处的配置，将会覆盖 RouteName、RouteType、MatchRequest、HTTPAdvancedOptions 中的配置。	{ "http": { "route": [ { "destination": { "host": "httpbin" } } ], "name": "httpbin", "match": [ { "uri": { "prefix": "/" } } ], "fault": { "delay": { "fixedDelay": "2s", "percentage": { "value": 70 } } } } }
Priority	integer	否	路由优先级。整数，数字越小，优先级越高。	1
Status	integer	否	网关路由状态，取值： `0`：在线。 `1`：下线。 `2`：创建或更新错误。	1
Description	string	否	路由描述。	demo route

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	31d3a0f0-07ed-4f6e-9004-1804498c****

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

更多信息，参考变更详情。