Obtaining the Gateway Route List

This API is used to obtain the gateway route list.

For details, see Calling APIs.

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, the following identity policy-based permissions are required.
Action

Access Level

Resource Type (*: required)

Condition Key

Alias

Dependencies
asm:mesh:listGatewayRoutes

List

mesh *

g:EnterpriseProjectId

g:ResourceTag/<tag-key>

-

-

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
asm:mesh:listGatewayRoutes	List	mesh *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	-	-

POST /v3/meshes/{mesh_id}/gateways/{gateway}/routes

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
mesh_id	Yes	String	Mesh ID
gateway	Yes	String	Service name

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
Content-Type	Yes	String	Message body type (format) Range: application/json;charset=utf-8: The content is in JSON format and encoded using UTF-8. application/json: The content is in JSON format.
X-Auth-Token	Yes	String	API calling can be authenticated using a token or AK/SK. If you use a token, this parameter is mandatory and must be set to the token.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
Namespace	Yes	Map<String,String>	Namespace of the gateway whose route list is to be obtained. The key is namespace, and the value is the namespace name.

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
gatewayNamespace	String	Namespace that the gateway belongs to
routes	GatewayVirtualRoute object	Route list

**Table 5** GatewayVirtualRoute
Parameter	Type	Description
namespace	String	Namespace of a backend Service
matchRule	String	Matching rule. The value can be prefix (prefix matching) or exact (exact matching).
path	String	Matching path
serviceName	String	Backend Service name
servicePort	Integer	Backend Service port
rewrite	HTTPRewrite object	Rewriting rule

**Table 6** HTTPRewrite
Parameter	Type	Description
uri	String	Used to rewrite the URI path or prefix. If the original path is matched by prefix, the value provided in this field replaces the corresponding matched prefix.
authority	String	Used to rewrite the HTTP Host/Authority header