调用SetLoadBalancerTCPListenerAttribute修改TCP监听的配置。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | SetLoadBalancerTCPListenerAttribute |
要执行的操作。 取值:SetLoadBalancerTCPListenerAttribute。 |
ListenerPort | Integer | 是 | 80 |
负载均衡实例前端使用的端口。 取值:1~65535。 |
LoadBalancerId | String | 是 | lb-bp1ygod3yctvg1y****** |
负载均衡实例ID。 |
RegionId | String | 是 | cn-hangzhou |
负载均衡实例的地域ID。 您可以从地域和可用区列表或通过调用DescribeRegions接口查询地域ID。 |
Bandwidth | Integer | 否 | 43 |
监听的带宽峰值,单位Mbps。取值:-1或1~5120。
|
Scheduler | String | 否 | wrr |
调度算法。取值:
说明 仅性能保障型实例支持sch和tch一致性哈希算法。
|
PersistenceTimeout | Integer | 否 | 0 |
会话保持的超时时间。取值:0~3600秒。 默认值:0,表示关闭会话保持。 |
EstablishedTimeout | Integer | 否 | 500 |
连接超时时间。 取值:10~900秒。 |
HealthyThreshold | Integer | 否 | 4 |
健康检查连续成功多少次后,将后端服务器的健康检查状态由失败判定为成功。 取值:2~10。 |
UnhealthyThreshold | Integer | 否 | 4 |
健康检查连续失败多少次后,将后端服务器的健康检查状态由成功判定为失败。 取值:2~10。 |
HealthCheckConnectTimeout | Integer | 否 | 100 |
接收来自运行状况检查的响应需要等待的时间。 如果后端ECS在指定的时间内没有正确响应,则判定为健康检查失败。 取值:1~300秒。 说明 如果HealthCheckConnectTimeout的值小于HealthCheckInterval的值,则HCTimeout无效,超时时间为HealthCheckInterval的值。
|
HealthCheckConnectPort | Integer | 否 | 8080 |
健康检查使用的端口。 取值:1~65535。 不设置此参数时,表示使用后端服务端口(BackendServerPort)。 |
HealthCheckInterval | Integer | 否 | 5 |
健康检查的时间间隔。取值:1~50秒。 |
HealthCheckDomain | String | 否 | 192.168.0.1 |
用于健康检查的域名。当TCP监听需要使用HTTP健康检查时可配置此参数,如不配置则按TCP健康检查。
|
HealthCheckURI | String | 否 | /test/index.html |
用于健康检查的URL。长度为1~80个字符,支持字母、数字和短划线(-)、正斜线(/)、半角句号(.)、百分号(%)、半角问号(?)、井号(#)和and(&)这些字符。URL不能只为正斜线(/),但必须以正斜线(/)开头。 当TCP监听需要使用HTTP健康检查时,可配置此参数。 如不配置,则使用TCP健康检查。 |
HealthCheckHttpCode | String | 否 | http_2xx |
健康检查正常的HTTP状态码,多个状态码用半角逗号(,)分割。 取值:http_2xx、http_3xx、http_4xx或http_5xx。 |
HealthCheckType | String | 否 | tcp |
健康检查类型。取值:tcp或http。 |
SynProxy | String | 否 | enable |
是否开启负载均衡的攻击防护功能SynProxy。 取值:
建议用户一般情况下不要调整这个参数,由负载均衡控制。 |
VServerGroup | String | 否 | on |
是否使用虚拟服务器组。 取值:
说明 VserverGroup和MasterSlaveServerGroup只允许一个值为on。
|
VServerGroupId | String | 否 | rsp-cige6j5***** |
虚拟服务器组ID。 |
MasterSlaveServerGroupId | String | 否 | rsp-cige****** |
主备服务器组ID。 说明 虚拟服务器组ID和主备服务器组ID只能选择一个。
|
MasterSlaveServerGroup | String | 否 | on |
是否使用主备服务器组。 取值:
VserverGroup和MasterSlaveServerGroup只允许一个值为on。 |
AclId | String | 否 | 12333 |
监听绑定的访问策略组ID。 当AclStatus参数值为on时,该参数必选。 |
AclType | String | 否 | white |
访问控制类型:
当AclStatus参数的值为on时,该参数有效。 |
AclStatus | String | 否 | off |
是否开启访问控制功能。 取值:
|
Description | String | 否 | test |
TCP监听描述。长度限制为1~80个字符,支持中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)和下划线(_)等字符。 |
ConnectionDrain | String | 否 | off |
是否开启连接优雅中断。取值:
|
ConnectionDrainTimeout | Integer | 否 | 300 |
设置连接优雅中断超时时间。当ConnectionDrain取值为on时,该选项必选。 取值范围:10~900秒。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | CEF72CEB-54B6-4AE8-B225-F876FF7BA984 |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=SetLoadBalancerTCPListenerAttribute
&ListenerPort=80
&LoadBalancerId=lb-bp1ygod3yctvg1y******
&<公共请求参数>
正常返回示例
XML
格式
<SetLoadBalancerTCPListenerAttributeResponse>
<RequestId>59B41B53-BC4B-481A-9D8D-2A0D20B3FCD1</RequestId>
</SetLoadBalancerTCPListenerAttributeResponse>
JSON
格式
{
"RequestId": "59B41B53-BC4B-481A-9D8D-2A0D20B3FCD1"
}
错误码
访问错误中心查看更多错误码。