更新轉寄規則屬性,如條件、動作、名稱等。
介面說明
-
UpdateRuleAttribute 介面屬於非同步介面,即系統返回一個請求 ID,但該轉寄規則屬性尚未更新成功,系統背景更新任務仍在進行。您可以調用 ListRules 查詢轉寄規則屬性的更新狀態:
當轉寄規則屬性處於 Configuring 狀態時,表示轉寄規則屬性正在更新中。
當轉寄規則屬性處於 Available 狀態時,表示轉寄規則屬性更新成功。
-
一條轉寄規則最多支援添加的條件數(RuleConditions)和動作數(RuleActions)如下:
條件數:基礎版 5 條、標準版 10 條、WAF 增強版 10 條。
動作數:基礎版 3 條,標準版 5 條、WAF 增強版 5 條。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
alb:UpdateRuleAttribute |
update |
*LoadBalancer
*ServerGroup
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RuleId |
string |
是 |
轉寄規則 ID。 |
rule-4dp5i6ea**** |
| ClientToken |
string |
否 |
用戶端 Token,用於保證請求的等冪性。 從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。 說明
若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。 |
5A2CFF0E-5718-45B5-9D4D-70B3FF3898 |
| DryRun |
boolean |
否 |
是否只預檢此次請求,取值:
|
false |
| RuleConditions |
array<object> |
否 |
轉寄規則條件。 |
|
|
array<object> |
否 |
轉寄規則條件。 |
||
| CookieConfig |
object |
否 |
Cookie 配置。 |
|
| Values |
array |
否 |
Cookie 配置。 |
|
|
object |
否 |
Cookie 配置。 |
||
| Key |
string |
否 |
Cookie 鍵。長度為 1~100 個字元,支援小寫字母、可見字元、星號(*)和半形問號(?),不支援空格和 |
test |
| Value |
string |
否 |
Cookie 值。長度為 1~128 個字元,支援小寫英文字母、可見字元、星號(*)和半形問號(?),不支援空格和 |
test |
| HeaderConfig |
object |
否 |
頭欄位配置。 |
|
| Key |
string |
否 |
頭欄位鍵。長度為 1~40 個字元,支援字母、數字、短劃線(-)和底線(_),不支援 Cookie 和 Host。 |
Port |
| Values |
array |
否 |
頭欄位值。 |
|
|
string |
否 |
頭欄位值。同一個轉寄規則條件內頭欄位值不能重複。命名規則:
|
5006 |
|
| HostConfig |
object |
否 |
主機配置。 |
|
| Values |
array |
否 |
主機名稱列表。 |
|
|
string |
否 |
主機名稱。命名規則:
|
www.example.com |
|
| MethodConfig |
object |
否 |
要求方法配置。 |
|
| Values |
array |
否 |
要求方法列表。 |
|
|
string |
否 |
要求方法。 取值:HEAD、GET、POST、OPTIONS、PUT、PATCH 或 DELETE。 |
PUT |
|
| PathConfig |
object |
否 |
轉寄的路徑配置。 |
|
| Values |
array |
否 |
轉寄路徑列表。 |
|
|
string |
否 |
轉寄路徑。命名規則:
|
/test |
|
| QueryStringConfig |
object |
否 |
查詢字串配置。 |
|
| Values |
array |
否 |
查詢字串列表。最多支援添加 20 個查詢字串。 |
|
|
object |
否 |
查詢字串結構。 |
||
| Key |
string |
否 |
查詢字串鍵。長度為 1~100 個字元,支援小寫字母、可見字元、星號(*)和半形問號(?),不支援空格和 |
test |
| Value |
string |
否 |
查詢字串值。長度為 1~128 個字元,支援小寫字母、可見字元、星號(*)和半形問號(?),不支援空格和 |
test |
| Type |
string |
否 |
轉寄規則類型。最多支援添加 7 個轉寄規則類型。取值:
|
Host |
| ResponseStatusCodeConfig |
object |
否 |
響應狀態代碼配置。 |
|
| Values |
array |
否 |
響應狀態代碼列表。 |
|
|
string |
否 |
響應狀態代碼。 |
301 |
|
| ResponseHeaderConfig |
object |
否 |
標題條件配置。 |
|
| Key |
string |
否 |
頭欄位鍵。
|
test |
| Values |
array |
否 |
頭欄位值。 |
|
|
string |
否 |
頭欄位值。
|
50006 |
|
| SourceIpConfig |
object |
否 |
基於源 IP 業務流量匹配。最多支援添加 5 個基於源 IP 業務流量匹配。 |
|
| Values |
array |
否 |
添加一個或多個 IP 位址或者 IP 位址段。 |
|
|
string |
否 |
添加一個或多個 IP 位址或者 IP 位址段。 |
192.168.0.0/32 |
|
| RuleActions |
array<object> |
否 |
轉寄規則動作列表。 |
|
|
array<object> |
否 |
轉寄規則動作列表。 |
||
| FixedResponseConfig |
object |
否 |
固定響應內容配置。 |
|
| Content |
string |
否 |
返回的固定內容。最大 1 KB,只支援 ASCII 字元。 |
dssacav |
| ContentType |
string |
否 |
返回固定內容的格式。 取值:text/plain、text/css、text/html、application/javascript或application/json。 |
text/plain |
| HttpCode |
string |
否 |
返回的 HTTP 響應碼,僅支援 2xx、4xx、5xx 數字型字串,x 為任一數字。 |
200 |
| ForwardGroupConfig |
object |
否 |
轉寄組配置。 |
|
| ServerGroupTuples |
array |
否 |
轉寄到的目標伺服器組列表。 |
|
|
object |
否 |
轉寄到的目的伺服器組結構。 |
||
| ServerGroupId |
string |
否 |
轉寄到的目的伺服器組 ID。 |
sg--atstuj3rtoptyui**** |
| Weight |
integer |
否 |
權重。取值越大,權重越大,表示轉寄的訪問請求更多。取值範圍:0~100。
|
30 |
| ServerGroupStickySession |
object |
否 |
伺服器組之間會話保持。 |
|
| Enabled |
boolean |
否 |
是否開啟會話保持。取值:
|
false |
| Timeout |
integer |
否 |
逾時時間。單位:秒。取值範圍:1~86400。 |
2 |
| InsertHeaderConfig |
object |
否 |
寫入頭欄位配置。 |
|
| CoverEnabled |
boolean |
否 |
是否覆蓋請求中的值。取值:
|
false |
| Key |
string |
否 |
插入的頭欄位名稱,長度為 1~40 個字元,支援大小寫字母 a~z、數字、底線(_)和短劃線(-)。InsertHeaderConfig 中的頭欄位名稱不能重複。 說明
不允許將頭名稱設定為以下欄位(不區分大小寫): |
key |
| Value |
string |
否 |
插入的頭欄位內容。
|
UserDefined |
| ValueType |
string |
否 |
頭欄位內容類型。取值:
|
UserDefined |
| Order |
integer |
否 |
轉寄規則動作執行的順序,取值範圍:1~50000,按值從小到大執行動作。值不可為空,不能重複。最多支援添加 20 個轉寄規則動作執行的順序。 |
1 |
| RedirectConfig |
object |
否 |
重新導向配置。最多支援添加 20 個重新導向。 |
|
| Host |
string |
否 |
要跳轉的主機地址。取值:
|
www.example.com |
| HttpCode |
string |
否 |
跳轉方式,取值為 301、302、303、307 或 308。 |
301 |
| Path |
string |
否 |
要跳轉的路徑。取值:
|
/test |
| Port |
string |
否 |
要跳轉的連接埠。取值:
|
10 |
| Protocol |
string |
否 |
要跳轉的協議。取值:
說明
HTTPS 監聽僅支援跳轉 HTTPS 協議。 |
HTTP |
| Query |
string |
否 |
要跳轉的查詢字串。取值:
|
quert |
| RewriteConfig |
object |
否 |
重寫配置。 |
|
| Host |
string |
否 |
內部跳轉的目的主機地址。取值:
|
www.example.com |
| Path |
string |
否 |
要跳轉的路徑。取值:
|
/tsdf |
| Query |
string |
否 |
內部跳轉的查詢字串。取值:
|
quedsa |
| Type |
string |
否 |
動作類型。最多支援添加 11 個動作類型。取值:
說明
一個轉寄規則必須包含有一條 ForwardGroup(轉寄至)、Redirect(重新導向)或 FixedResponse(返回固定響應)轉寄動作,與其他類型轉寄動作並存時,必須放在最後執行。 |
ForwardGroup |
| TrafficLimitConfig |
object |
否 |
流量限速。 |
|
| QPS |
integer |
否 |
每秒請求次數。取值範圍:1~1000000。 |
100 |
| PerIpQps |
integer |
否 |
單 IP 每秒請求次數。 取值範圍:1 ~ 1000000。 說明
如果同時配置 QPS 參數,PerIpQps 參數的取值必須小於 QPS 參數的取值。 |
80 |
| TrafficMirrorConfig |
object |
否 |
流量鏡像。 |
|
| TargetType |
string |
否 |
鏡像的目標類型。取值:
|
ForwardGroupMirror |
| MirrorGroupConfig |
object |
否 |
流量鏡像至伺服器組。 |
|
| ServerGroupTuples |
array |
否 |
流量鏡像至伺服器組。 |
|
|
object |
否 |
流量鏡像至伺服器組。 |
||
| ServerGroupId |
string |
否 |
伺服器組 ID。 |
srg-00mkgijak0w4qgz9**** |
| RemoveHeaderConfig |
object |
否 |
去除 HTTP 頭部配置。 |
|
| Key |
string |
否 |
去除的頭欄位名稱,長度為 1~40 個字元,支援大小寫字母 a~z、數字、底線(_)和短劃線(-)。頭欄位名稱不能重複用於 RemoveHeader 中。
|
test |
| CorsConfig |
object |
否 |
跨域。 |
|
| AllowOrigin |
array |
否 |
允許的訪問來源列表。支援只配置一個元素
|
|
|
string |
否 |
允許的訪問來源。 |
http://test.com |
|
| AllowMethods |
array |
否 |
選擇跨域訪問時允許的 HTTP 方法。 |
|
|
string |
否 |
選擇跨域訪問時允許的 HTTP 方法。取值:
|
GET |
|
| AllowHeaders |
array |
否 |
允許跨域的 Header 列表。 |
|
|
string |
否 |
允許跨域的 Header 列表。支援配置為 |
test_123 |
|
| ExposeHeaders |
array |
否 |
允許暴露的 Header 列表。 |
|
|
string |
否 |
允許暴露的 Header 列表。支援配置為 |
test_123 |
|
| AllowCredentials |
string |
否 |
是否允許攜帶憑證資訊。取值:
|
on |
| MaxAge |
integer |
否 |
預檢請求在瀏覽器的最大緩衝時間,單位:秒。 取值範圍:-1~172800。 |
1000 |
| RuleName |
string |
否 |
轉寄規則名稱。 長度為 2~128 個英文或中文字元,必須以大小字母或中文開頭,可包含數字,半形句號(.),底線(_)和短劃線(-)。 |
rule-instance-test |
| Priority |
integer |
否 |
規則優先順序,取值範圍:1~10000。值越小表示優先順序越高。 說明
同一個監聽內規則優先順序必須唯一。 |
10 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
更新轉寄規則屬性。 |
||
| JobId |
string |
非同步任務 ID。 |
72dcd26b-f12d-4c27-b3af-18f6aed5**** |
| RequestId |
string |
請求 ID。 |
365F5378-41F6-4AE4-92F8-7FF34B540710 |
樣本
正常返回樣本
JSON格式
{
"JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
"RequestId": "365F5378-41F6-4AE4-92F8-7FF34B540710"
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | IncorrectStatus.Rule | The status of %s [%s] is incorrect. | 轉寄規則的目前狀態不支援本次操作。 |
| 400 | OperationDenied.IpGroupCanNotUsedForMirrorAction | The operation is not allowed because of %s. | 操作被拒絕,原因是%s。 |
| 400 | OperationDenied.SameGroupForForwardAndMirrorAction | The operation is not allowed because of %s. | 操作被拒絕,原因是%s。 |
| 400 | OperationDenied.GRPCServerGroup | The operation is not allowed because of %s. | 操作被拒絕,原因是存在綁定本GRPC伺服器組的監聽沒有啟用HTTP2.0。 |
| 400 | Conflict.Priority | There is already %s having the same configuration with %s. | 優先順序衝突,已經存在相同配置 |
| 400 | ResourceQuotaExceeded.ServerGroupAttachedNum | The quota of %s is exceeded for resource %s, usage %s/%s. | 伺服器組可被關聯數已超額度限制。 |
| 400 | ResourceQuotaExceeded.LoadBalancerServersNum | The quota of %s is exceeded for resource %s, usage %s/%s. | 後端伺服器數已超額度限制。 |
| 400 | ResourceQuotaExceeded.ServerAddedNum | The quota of %s is exceeded for resource %s, usage %s/%s. | 伺服器添加到組已超額度限制。 |
| 400 | QuotaExceeded.RuleWildcardsNum | The quota of %s is exceeded, usage %s/%s. | 配額%s已超額度限制,目前已使用%s,配額為%s。 |
| 400 | QuotaExceeded.RuleMatchEvaluationsNum | The quota of %s is exceeded, usage %s/%s. | 轉寄規則條件數已超額度限制。 |
| 400 | QuotaExceeded.RuleActionsNum | The quota of %s is exceeded, usage %s/%s. | 配額%s已超額度限制,目前已使用%s,配額為%s。 |
| 400 | Mismatch.Protocol | The %s is mismatched for %s and %s. | %s在%s和%s中不匹配。 |
| 400 | Mismatch.VpcId | The %s is mismatched for %s and %s. | %s在%s和%s中不匹配。 |
| 400 | OperationDenied.RewriteMissingForwardGroup | The operation is not allowed because of RewriteMissingForwardGroup. | 操作被拒絕,原因是RewriteMissingForwardGroup。 |
| 400 | ResourceInConfiguring.Listener | The specified listener is being configured, please try again later. | 資源正在變更配置中,請稍後重試。 |
| 400 | OperationDenied.ProtocolMustSameForForwardGroupAction | The operation is not allowed because of ProtocolMustSameForForwardGroupAction. | 操作被禁止,原因:必須是相同的協議 |
| 403 | Forbidden.ServerGroup | Authentication has failed for ServerGroup. | 對ServerGroup鑒權失敗 |
| 403 | Forbidden.LoadBalancer | Authentication is failed for %s. | 負載平衡操作鑒權失敗。 |
| 404 | ResourceNotFound.Rule | The specified resource %s is not found. | 資源%s不存在。 |
| 404 | ResourceNotFound.ServerGroup | The specified resource %s is not found. | 後端伺服器組不存在。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。