調(diào)用UpdateIstioGatewayRoutes更新網(wǎng)關(guān)路由。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
請(qǐng)求參數(shù)
| 名稱(chēng) | 類(lèi)型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ServiceMeshId | string | 是 | 服務(wù)網(wǎng)格實(shí)例 ID。 | c08ba3fd1e6484b0f8cc1ad8fe10d**** |
| IstioGatewayName | string | 否 | ASM 網(wǎng)關(guān)名稱(chēng)。 | ingressgateway |
| GatewayRoute | object | 否 | 網(wǎng)關(guān)路由信息。 | |
| RouteName | string | 否 | 路由名稱(chēng)。 | reviews-v2-routes |
| RouteType | string | 否 | 路由類(lèi)型，取值： | HTTP |
| MatchRequest | object | 否 | 路由匹配規(guī)則。 | |
| URI | object | 否 | URI 匹配規(guī)則。 | |
| MatchingMode | string | 否 | 路由規(guī)則匹配模式。取值：
| prefix |
| MatchingContent | string | 否 | 用于匹配的內(nèi)容。 | /ratings/v2/ |
| Headers | object [] | 否 | 用于判斷是否匹配的請(qǐng)求頭部列表。 | |
| Name | string | 否 | Header 匹配的鍵。 | x-request-id |
| MatchingMode | string | 否 | Header 值匹配方式，取值：
| exact |
| MatchingContent | string | 否 | 用于 Header 匹配的內(nèi)容。 | v1 |
| TLSMatchAttributes | object [] | 否 | TLS 連接匹配屬性列表。 | |
| TLSPort | integer | 否 | TLS 端口。 | 443 |
| SNIHosts | array | 否 | 服務(wù)器名稱(chēng)標(biāo)識(shí)列表。 | |
| string | 否 | SNI 值中可以使用通配符前綴，例如 說(shuō)明
SNI 值必須是相應(yīng)虛擬服務(wù)主機(jī)的子集。
| *.com | |
| Ports | array | 否 | 端口列表。 | |
| integer | 否 | 指定主機(jī)上要尋址的端口.。 | 443 | |
| RouteDestinations | object [] | 否 | L4 路由規(guī)則加權(quán)目的地列表。 | |
| Destination | object | 否 | Destination 唯一標(biāo)識(shí)請(qǐng)求或連接應(yīng)轉(zhuǎn)發(fā)到的服務(wù)實(shí)例。 | |
| Host | string | 否 | 服務(wù)注冊(cè)表中服務(wù)的名稱(chēng)。 | reviews |
| Subset | string | 否 | 服務(wù)中子集的名稱(chēng)。 | v1 |
| Port | object | 否 | 目標(biāo)服務(wù)的端口。 說(shuō)明
當(dāng)路由的目標(biāo)服務(wù)有只有一個(gè)端口時(shí)，該字段可以不填寫(xiě)。如果有多個(gè)端口，需要指明端口號(hào)。
| |
| Number | integer | 否 | 端口號(hào) | 80 |
| Weight | integer | 否 | 服務(wù)子集權(quán)重。 | 80 |
| HTTPAdvancedOptions | object | 否 | HTTP 路由高級(jí)配置選項(xiàng)。 | |
| HTTPRedirect | object | 否 | HTTP 重定向。 | |
| Uri | string | 否 | 在重定向時(shí)，使用此值覆蓋 URL 的路徑部分。 | /v1/getProductRatings |
| Authority | string | 否 | 在重定向時(shí)，使用此值覆蓋 URL 的 Authority 或 Host 部分 | newratings.default.svc.cluster.local |
| RedirectCode | integer | 否 | 在重定向上，指定要在重定向響應(yīng)中使用的 HTTP 狀態(tài)代碼。默認(rèn)響應(yīng)代碼為 301。 | 301 |
| Delegate | object | 否 | 描述委托虛擬服務(wù)。 | |
| Name | string | 否 | 名稱(chēng)。 | reviews |
| Namespace | string | 否 | 命名空間。 | default |
| Rewrite | object | 否 | 重寫(xiě)虛擬服務(wù)。 | |
| Uri | string | 否 | 用這個(gè)值重寫(xiě) URI 的路徑（或前綴）部分。 | /v1/getProductRatings |
| Authority | string | 否 | 使用此值重寫(xiě) Authority 或 Host 頭。 | newratings.default.svc.cluster.local |
| Timeout | string | 否 | 超時(shí)時(shí)長(zhǎng)。 | 5s |
| Retries | object | 否 | 請(qǐng)求重試配置。 | |
| Attempts | integer | 否 | 給定請(qǐng)求允許的重試次數(shù)。 | 3 |
| RetryOn | string | 否 | 用于指定重試是否應(yīng)重試到其他位置的標(biāo)志，例如 | connect-failure,refused-stream,503 |
| RetryRemoteLocalities | object | 否 | 用于指定重試是否應(yīng)重試到其他位置的標(biāo)志。 | |
| Value | boolean | 否 | 用于指定重試是否應(yīng)重試到其他位置的標(biāo)志，取值：
默認(rèn) | false |
| PerTryTimeout | string | 否 | 請(qǐng)求的每次嘗試超時(shí)時(shí)間。 | 2s |
| Fault | object | 否 | 故障注入設(shè)置。 | |
| Delay | object | 否 | 設(shè)置延遲。 | |
| FixedDelay | string | 否 | 固定延遲時(shí)間。 | 5s |
| Percentage | object | 否 | 將注入延遲的請(qǐng)求的百分比。 | |
| Value | float | 否 | 將注入延遲的請(qǐng)求的百分比，用小數(shù)表示。 | 0.1 |
| Abort | object | 否 | 提前中止帶有預(yù)先指定的錯(cuò)誤碼的請(qǐng)求。 | |
| HttpStatus | integer | 否 | HTTP 狀態(tài)碼。 | 400 |
| Percentage | object | 否 | 使用提供的錯(cuò)誤碼中止的請(qǐng)求的百分比。 | |
| Value | float | 否 | 使用提供的錯(cuò)誤碼中止的請(qǐng)求的百分比，用小數(shù)表示。 | 0.1 |
| Mirror | object | 否 | 除了將請(qǐng)求轉(zhuǎn)發(fā)到預(yù)期目標(biāo)之外，還將 HTTP 通信鏡像到另一個(gè)目標(biāo)。 | |
| Host | string | 否 | 服務(wù)注冊(cè)表中服務(wù)的名稱(chēng)。 | reviews.default.svc.cluster.local |
| Subset | string | 否 | 服務(wù)中子集的名稱(chēng)。 | v1 |
| MirrorPercentage | object | 否 | 流量鏡像百分比。 | |
| Value | float | 否 | 流量鏡像百分比，用小數(shù)表示。 | 0.2 |
| Namespace | string | 否 | 命名空間 | default |
| Domains | array | 否 | 請(qǐng)求的域名列表。 | |
| string | 否 | 域名。 | test.asm.aliyun.com | |
| RawVSRoute | any | 否 | 序列化為 JSON 的 VirtualService 原始 YAML | {} |
| Priority | integer | 否 | 路由優(yōu)先級(jí)。整數(shù)，數(shù)字越小，優(yōu)先級(jí)越高。 | 1 |
| Status | integer | 否 | 網(wǎng)關(guān)路由狀態(tài)，取值：
| 1 |
| Description | string | 否 | 路由描述。 | demo route |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "31d3a0f0-07ed-4f6e-9004-1804498c****"
}錯(cuò)誤碼
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 | ||
|---|---|---|---|---|
| 2023-06-25 | API 內(nèi)部配置變更，不影響調(diào)用 | 看變更集 | ||
| ||||
| 2022-08-25 | API 內(nèi)部配置變更，不影響調(diào)用 | 看變更集 | ||
|