修改目標虛擬服務器組的轉發規則。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀?。≧ead)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
slb:SetRule | update |
|
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 負載均衡實例的地域 ID。 您可以通過調用 DescribeRegions 接口查詢地域 ID。 | cn-hangzhou |
RuleId | string | 是 | 轉發規則 ID。 | rule-3ejhkt**** |
VServerGroupId | string | 否 | 轉發規則的目標服務器組 ID。 | rsp-cige6**** |
RuleName | string | 否 | 轉發規則名稱,長度限制為 1~40 個字符,支持中文、字母、數字、短劃線(-)、正斜線(/)、半角句號(.)和下劃線(_)這些字符。 說明
同一個監聽內不同規則的名稱必須唯一。
| doctest |
ListenerSync | string | 否 | 是否繼承監聽的健康檢查、會話保持和調度算法配置。取值:
| off |
Scheduler | string | 否 | 調度算法。取值:
說明
在 ListenerSync 為 off 時必選且有效。
| wrr |
StickySession | string | 否 | 是否開啟會話保持,取值:
在 ListenerSync 為 off 時必選且有效。 | off |
StickySessionType | string | 否 | Cookie 的處理方式。取值:
說明
StickySession 為 on 時必選且有效。
| insert |
CookieTimeout | integer | 否 | Cookie 超時時間。單位:秒。取值范圍:1~86400。 說明
當 StickySession 為 on 且 StickySessionType 為 insert 時必選且有效。
| 123 |
Cookie | string | 否 | 服務器上配置的 Cookie。 長度為 1~200 個字符,只能包含 ASCII 英文字母和數字字符,不能包含半角逗號(,)、半角分號(;)或空格,也不能以美元($)開頭。 說明
當 StickySession 為 on 且 StickySessionType 為 server 時必選且有效。
| 23ffsa |
HealthCheck | string | 否 | 是否開啟健康檢查。取值:
說明
ListenerSync 為 off 時必選且有效,其他情況會忽略此參數。
| off |
HealthCheckDomain | string | 否 | 用于健康檢查的域名,取值:
說明
** HealthCheck**為 on 時有效。
| $_ip |
HealthCheckURI | string | 否 | 用于健康檢查的 URI。 說明
HealthCheck 為 on 時必選且有效。
| /example |
HealthyThreshold | integer | 否 | 健康檢查連續成功多少次后,將后端服務器的健康檢查狀態由失敗判定為成功。 取值范圍:2~10。 說明
HealthCheck 為 on 時必選且有效。
| 4 |
UnhealthyThreshold | integer | 否 | 健康檢查連續失敗多少次后,將后端服務器的健康檢查狀態由成功判定為失敗。 取值范圍:2~10。 說明
HealthCheck 為 on 時必選且有效。
| 4 |
HealthCheckTimeout | integer | 否 | 接收來自運行狀況檢查的響應需要等待的時間。如果后端 ECS 在指定的時間內沒有正確響應,則判定為健康檢查失敗。單位:秒。取值范圍:1~300。 說明
HealthCheck 為 on 時必選且有效。
| 20 |
HealthCheckInterval | integer | 否 | 健康檢查的時間間隔。單位:秒。取值范圍:1~50。 說明
HealthCheck 為 on 時必選且有效。
| 20 |
HealthCheckConnectPort | integer | 否 | 健康檢查使用的端口。取值范圍:1~65535。 說明
HealthCheck 為 on 時有效。
| 80 |
HealthCheckHttpCode | string | 否 | 健康檢查正常的 HTTP 狀態碼,多個狀態碼用半角逗號(,)分割。 取值:http_2xx或http_3xx 或http_4xx或http_5xx。 說明
HealthCheck 為 on 時必選且有效。
| http_2xx |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | InvalidParameter | The specified VServerGroupId does not belong to the LoadBalancerId of the rule. | 指定的服務器組和當前轉發規則不屬于同一個負載均衡實例。 |
400 | InvalidParameter.RegionNotSupport | The region does not support the parameter: %s. | 當前區域不支持指定參數。 |
訪問錯誤中心查看更多錯誤碼。