調用CreateIstioGatewayRoutes創建ASM網關對應的路由。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ServiceMeshId | string | 是 | 服務網格實例 ID。 | c08ba3fd1e6484b0f8cc1ad8fe10d**** |
| IstioGatewayName | string | 否 | ASM 網關名稱。 | ingressgateway |
| GatewayRoute | object | 否 | 網關路由信息。 | |
| RouteName | string | 否 | 路由名稱 | reviews-v2-routes |
| RouteType | string | 否 | 路由類型，取值： | HTTP |
| MatchRequest | object | 否 | 路由匹配規則。 | |
| URI | object | 否 | URI 匹配規則。 | |
| MatchingMode | string | 否 | 路由規則匹配模式。取值：
| prefix |
| MatchingContent | string | 否 | 用于匹配的內容。 | /ratings/v2/ |
| Headers | object [] | 否 | 用于判斷是否匹配的請求頭部列表。 | |
| Name | string | 否 | Header 匹配的鍵。 | x-request-id |
| MatchingMode | string | 否 | Header 值匹配方式，取值：
| exact |
| MatchingContent | string | 否 | 用于 Header 匹配的內容。 | v1 |
| TLSMatchAttributes | object [] | 否 | TLS 連接匹配屬性列表。 | |
| TLSPort | integer | 否 | TLS 端口。 | 443 |
| SNIHosts | array | 否 | 服務器名稱標識列表。 | |
| string | 否 | SNI 值中可以使用通配符前綴，例如 說明
SNI 值必須是相應虛擬服務主機的子集。
| *.com | |
| Ports | array | 否 | L4 目標端口列表。 | |
| integer | 否 | 指定主機上要尋址的端口。 | 443 | |
| RouteDestinations | 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 的 | 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 |
| RetryOn | string | 否 | 用于指定重試發生的條件，例如 | connect-failure,refused-stream,503 |
| RetryRemoteLocalities | object | 否 | 用于指定重試是否應重試到其他位置的標志。 | |
| Value | boolean | 否 | 用于指定重試是否應重試到其他位置的標志，取值：
默認 | false |
| Fault | object | 否 | 故障注入設置。 | |
| Delay | object | 否 | 設置延遲。 | |
| FixedDelay | string | 否 | 固定延遲時間。 | 5s |
| Percentage | object | 否 | 將注入延遲的請求的百分比。 | |
| Value | float | 否 | 將注入延遲的請求的百分比，用小數表示。 | 0.1 |
| Abort | object | 否 | 提前中止帶有預先指定的錯誤碼的請求。 | |
| HttpStatus | integer | 否 | HTTP 狀態碼。 | 400 |
| Percentage | object | 否 | 使用提供的錯誤碼中止的請求的百分比。 | |
| Value | float | 否 | 使用提供的錯誤碼中止的請求的百分比，用小數表示。 | 0.1 |
| Mirror | object | 否 | 除了將請求轉發到預期目標之外，還將 HTTP 通信鏡像到另一個目標。 | |
| Host | string | 否 | 服務注冊表中服務的名稱。 | reviews.default.svc.cluster.local |
| Subset | string | 否 | 服務中子集的名稱。 | v1 |
| MirrorPercentage | object | 否 | 流量鏡像百分比。 | |
| Value | float | 否 | 流量鏡像百分比，用小數表示。 | 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 | 否 | 網關路由狀態，取值：
| 1 |
| Description | string | 否 | 路由描述。 | demo route |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "31d3a0f0-07ed-4f6e-9004-1804498c****"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 | ||
|---|---|---|---|---|
| 2023-06-25 | API 內部配置變更，不影響調用 | 看變更集 | ||
| ||||
| 2022-08-25 | API 內部配置變更，不影響調用 | 看變更集 | ||
|