使用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>	否	用於判斷是否匹配的要求標頭部列表。
	object	否	用於判斷是否匹配的要求標頭部。
Name	string	否	Header 匹配的鍵。	x-request-id
MatchingMode	string	否	Header 值匹配方式，取值： `exact`：精準匹配。 `prefix`：首碼匹配。 `regex`：正則匹配。	exact
MatchingContent	string	否	用於 Header 匹配的內容。	v1
TLSMatchAttributes	array<object>	否	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<object>	否	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****"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。