UpdateHttpApiRoute - 更新路由 - API Gateway

更新HttpApi的路由。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

apig:UpdateHttpApiRoute

none

*HttpApi

acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}

無

請求文法

PUT /v1/http-apis/{httpApiId}/routes/{routeId} HTTP/1.1

路徑參數

名稱	類型	必填	描述	樣本值
httpApiId	string	否	路由所屬的 HTTP API ID。	api-cqoub6tlhtgvof7***
routeId	string	否	路由 ID。	hr-cr82undlhtgrl***

請求參數

名稱	類型	必填	描述	樣本值
body	object	否	請求 Body。
domainIds	array	否	網域名稱 ID 列表。
	string	否	網域名稱 ID。	d-cr62ts5lhtgln***
match	HttpRouteMatch	否	路由 Match 規則。
backendConfig	object	否	路由的後端服務配置。
scene	string	否	後端服務情境。枚舉值： SingleService : 單服務 MultiServiceByRatio : 多服務按比例灰階 Redirect : Redirect Mock : Mock	SingleService
services	array<object>	否	後端服務列表。
	object	否	後端服務。
serviceId	string	否	服務 ID。	svc-cr6pk4tlhtgm58e***
protocol	string	否	服務合約： HTTP。 HTTPS。枚舉值： HTTPS : HTTPS HTTP : HTTP	HTTP
version	string	否	服務版本。	v1
weight	integer	否	流量比例的百分比值。	49
port	integer	否	服務連接埠, 動態連接埠不傳入。	8080
environmentId	string	否	環境 ID。	env-cquqsollhtgid***
description	string	否	路由描述。	商品中心服務路由
deployConfigs	array	否
	HttpApiDeployConfig	否
name	string	否
mcpRouteConfig	object	否
protocol	string	否
exposedUriPath	string	否
mcpStatisticsEnable	boolean	否
policyConfigs	array<object>	否
	array<object>	否
type	string	否
enable	boolean	否
aiFallbackConfig	object	否
serviceConfigs	array<object>	否
	object	否
serviceId	string	否
name	string	否
targetModelName	string	否
passThroughModelName	boolean	否
onlyRedirectUpstreamCode	boolean	否
routeEmbedded	boolean	否
aiSecurityGuardConfig	object	否
serviceAddress	string	否
checkRequest	boolean	否
checkResponse	boolean	否
checkRequestImage	boolean	否
checkResponseImage	boolean	否
requestCheckService	string	否
responseCheckService	string	否
requestImageCheckService	string	否
responseImageCheckService	string	否
riskAlertLevel	string	否
riskConfig	array<object>	否
	array<object>	否
type	string	否
level	string	否
consumerRules	object	否
pattern	string	否	迴圈規則。
matchType	string	否
bufferLimit	integer	否
pluginStatus	object	否
errorLogs	object	否
	string	否
serviceHealthy	boolean	否
pluginId	string	否
consumerRequestCheckService	array<object>	否
	object	否
name	string	否
requestCheckService	string	否
requestImageCheckService	string	否
matchType	string	否
modalityType	string	否
consumerResponseCheckService	array<object>	否
	object	否
name	string	否
responseCheckService	string	否
responseImageCheckService	string	否
matchType	string	否
modalityType	string	否
consumerRiskLevel	array<object>	否
	object	否
name	string	否
matchType	string	否
type	string	否
level	string	否
aiTokenRateLimitConfig	object	否
rules	array<object>	否
	object	否
limitType	string	否
matchKey	string	否
matchType	string	否
matchValue	string	否
limitMode	string	否
limitValue	integer	否
enableGlobalRules	boolean	否
globalRules	array<object>	否
	object	否
limitType	string	否
matchKey	string	否
matchType	string	否
matchValue	string	否
limitMode	string	否
limitValue	integer	否
redisConfig	object	否
host	string	否
port	integer	否
username	string	否
password	string	否
timeout	integer	否
databaseNumber	integer	否
pluginStatus	object	否
errorLogs	object	否
	string	否
serviceHealthy	boolean	否
pluginId	string	否
aiCacheConfig	object	否
cacheTTL	integer	否
redisConfig	object	否
host	string	否
port	integer	否
username	string	否
password	string	否
timeout	integer	否
databaseNumber	integer	否
vectorConfig	object	否
type	string	否
serviceHost	string	否
apiKey	string	否	apiKey
timeout	integer	否		6000
collectionId	string	否
threshold	number	否
embeddingConfig	object	否
type	string	否
serviceId	string	否
timeout	integer	否
modelName	string	否
cacheKeyStrategy	string	否
cacheMode	string	否
pluginStatus	object	否
errorLogs	object	否
	string	否
serviceHealthy	boolean	否
pluginId	string	否
aiNetworkSearchConfig	object	否
needReference	boolean	否
referenceFormat	string	否
referenceLocation	string	否
defaultLang	string	否
defaultEnable	boolean	否
searchFrom	array<object>	否
	array<object>	否
type	string	否
apiKey	string	否
count	integer	否
start	integer	否
timeoutMillisecond	integer	否
optionArgs	object	否
	string	否
endpoint	string	否
contentMode	string	否
industry	string	否
timeRange	string	否
searchEngineConfig	object	否	搜尋引擎配置
type	string	否
apiKey	string	否
count	integer	否
start	integer	否
timeoutMillisecond	integer	否
optionArgs	object	否
	string	否
endpoint	string	否
contentMode	string	否
industry	string	否
timeRange	string	否
searchRewrite	object	否
enable	boolean	否
serviceId	string	否
modelName	string	否
timeoutMillisecond	integer	否
maxCount	integer	否
pluginStatus	object	否
errorLogs	object	否
	string	否
serviceHealthy	boolean	否
pluginId	string	否
aiToolSelectionConfig	object	否
enableConditions	object	否
toolCountThreshold	integer	否
toolReranking	object	否
modelService	object	否
serviceId	string	否
modelName	string	否
timeoutMillisecond	integer	否
filteringMethod	string	否
topKPercent	integer	否
topNCount	integer	否
scoreThreshold	number	否
fallbackStrategy	string	否
queryRewriting	object	否
enabled	boolean	否
modelService	object	否
serviceId	string	否
modelName	string	否
timeoutMillisecond	integer	否
promptConfig	object	否
type	string	否
customPrompt	string	否
maxOutputTokens	integer	否
triggerConditions	object	否
messageCountThreshold	integer	否
contextSelection	object	否
type	string	否
value	integer	否
fallbackStrategy	string	否
pluginStatus	object	否
errorLogs	object	否
	string	否
serviceHealthy	boolean	否
pluginId	string	否
aiStatisticsConfig	object	否
logRequestContent	boolean	否
logResponseContent	boolean	否
semanticRouterConfig	object	否
timeoutMillisecond	integer	否

返回參數

名稱	類型	描述	樣本值
	object	結構體
requestId	string	請求 ID。	CBEEB8C1-108E-50F0-9BEA-DED79553C309
code	string	響應狀態代碼。	Ok
message	string	響應訊息。	success

樣本

正常返回樣本

JSON格式

{
  "requestId": "CBEEB8C1-108E-50F0-9BEA-DED79553C309",
  "code": "Ok",
  "message": "success"
}

錯誤碼

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

變更歷史

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