All Products
Search
Document Center

Alibaba Cloud Service Mesh:DescribeIstioGatewayRoutes

Last Updated:Mar 05, 2024

Queries the routing rules for a Service Mesh (ASM) gateway.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
ServiceMeshIdstringYes

The ASM instance ID.

c08ba3fd1e6484b0f8cc1ad8fe10d****
IstioGatewayNamestringNo

The name of the ASM gateway.

ingressgateway

Response parameters

ParameterTypeDescriptionExample
object

The response body.

ManagementRoutesobject []

The routing rules.

ASMGatewayNamestring

The name of the ASM gateway.

ingressgateway
RouteNamestring

The name of the routing rule.

http-route
RoutePathstring

The path that is used to match request URLs.

/reviews/v1
Statusinteger

The status of the routing rule. Valid values:

  • 0: The routing rule is valid.
  • 1: The routing rule is invalid.
  • 2: An error occurs during the creation or update of the routing rule.
1
Priorityinteger

The priority of the routing rule. The value of this parameter is an integer. A smaller value indicates a higher priority.

1
Descriptionstring

The description of the routing rule.

demo route
Namespacestring

The namespace.

istio-demo
DestinationHostarray

Destination hosts list.

string

Destination host.

test.asm.aliyun.com
DestinationSubSetarray

Destination subset list.

string

Destination subset.

v1
RequestIdstring

The request ID.

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

Examples

Sample success responses

JSONformat

{
  "ManagementRoutes": [
    {
      "ASMGatewayName": "ingressgateway",
      "RouteName": "http-route",
      "RoutePath": "/reviews/v1",
      "Status": 1,
      "Priority": 1,
      "Description": "demo route",
      "Namespace": "istio-demo",
      "DestinationHost": [
        "test.asm.aliyun.com"
      ],
      "DestinationSubSet": [
        "v1"
      ]
    }
  ],
  "RequestId": "31d3a0f0-07ed-4f6e-9004-1804498c****"
}

Error codes

HTTP status codeError codeError message
500ERR500An internal server error occurred.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2022-08-25The Error code has changed. The response structure of the API has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 500
Output ParametersThe response structure of the API has changed.