SetLoadBalancerUDPListenerAttribute_负载均衡_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

流控信息

请求速率为90/60(s)。更多流控信息,请前往配额中心查看

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
slb:SetLoadBalancerUDPListenerAttribute
Update
acl
acs:slb:{#regionId}:{#accountId}:acl/{#aclId}
loadbalancer
acs:slb:{#regionId}:{#accountId}:loadbalancer/{#loadbalancerId}
slb:tag
slb:tag

请求参数

字段名称字段详情
RegionIdstring

传统型负载均衡实例的地域 ID。展开详情

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
LoadBalancerIdstring

传统型负载均衡实例的 ID。

示例值:lb-bp1rtfnodmywb43ecu4sf-c****参考取值来源:
    CreateLoadBalancer
    DescribeLoadBalancers
ListenerPortinteger<int32>

传统型负载均衡实例前端使用的端口。展开详情

示例值:80取值 <= 65535
Bandwidthinteger<int32>

监听的带宽峰值,单位:Mbps。取值:展开详情

示例值:-1取值 <= 5120
Schedulerstring

调度算法。取值:展开详情

示例值:wrr
HealthyThresholdinteger<int32>

健康检查连续成功多少次后,将后端服务器的健康检查状态由 fail 判定为 success展开详情

示例值:4取值 <= 10
UnhealthyThresholdinteger<int32>

健康检查连续失败多少次后,将后端服务器的健康检查状态由 success 判定为 fail展开详情

示例值:4取值 <= 10
HealthCheckConnectTimeoutinteger<int32>

接收来自运行状况检查的响应需要等待的时间。如果后端 ECS 在指定的时间内没有正确响应,则判定为健康检查失败。单位:秒。展开详情

示例值:100取值 <= 300
HealthCheckConnectPortinteger<int32>

健康检查使用的端口。展开详情

示例值:80取值 <= 65535
HealthCheckIntervalinteger<int32>

健康检查的时间间隔,单位:秒。展开详情

示例值:5取值 <= 50
healthCheckReqstring

UDP 监听健康检查的请求串,只允许包含字母、数字,最大长度限制为 64 个字符。

示例值:hello
healthCheckExpstring

UDP 监听健康检查的响应串,只允许包含字母、数字,最大长度限制为 64 个字符。

示例值:ok
VServerGroupstring

是否使用虚拟服务器组。取值:展开详情

示例值:on参考取值来源:
    CreateVServerGroup
    DescribeVServerGroups
    SetVServerGroupAttribute
    AddVServerGroupBackendServers
    ModifyVServerGroupBackendServers
    RemoveVServerGroupBackendServers
VServerGroupIdstring

虚拟服务器组 ID。

示例值:rsp-cige6****参考取值来源:
    CreateVServerGroup
    DescribeVServerGroups
    SetVServerGroupAttribute
    AddVServerGroupBackendServers
    ModifyVServerGroupBackendServers
    RemoveVServerGroupBackendServers
MasterSlaveServerGroupIdstring

主备服务器组 ID。展开详情

示例值:rsp-0bfuc****参考取值来源:
    CreateMasterSlaveServerGroup
    DescribeMasterSlaveServerGroups
MasterSlaveServerGroupstring

是否使用主备服务器组。取值:展开详情

示例值:on参考取值来源:
    CreateMasterSlaveServerGroup
    DescribeMasterSlaveServerGroups
AclIdstring

监听绑定的访问策略组 ID。展开详情

示例值:off
AclTypestring

访问控制类型。取值:展开详情

示例值:white
AclStatusstring

是否开启访问控制功能。取值:展开详情

示例值:off
Descriptionstring

自定义监听名称。展开详情

示例值:udp_80
ProxyProtocolV2Enabledboolean

是否支持通过 Proxy Protocol 协议携带客户端源地址到后端服务器。取值:展开详情

示例值:false
HealthCheckSwitchstring

是否开启健康检查。取值:展开详情

示例值:on

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:CEF72CEB-54B6-4AE8-B225-F876FF7BA984

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
InvalidParameterValue.SpecNotSupport
The loadBalancer of shared spec does not support the parameter value, %s.诊断
400
OperationNotSupport.Acl
The cloud box instance does not support acl.诊断
400
InvalidParameterValue.RegionNotSupport
The region does not support the parameter value, %s.诊断
400
IpVersionConflict
The ip version of this LoadBalancer and the Acl is conflict.诊断
400
InvalidParameterValue.ZoneNotSupport
The zone does not support the parameter value, %s.诊断
400
OperationFailed.ServerGroupInUse
The VServerGroup or MasterSlaveServerGroup can not be close for this listener.诊断
400
InvalidParam.VServerGroupId
The specified VServerGroupId is invalid.诊断
400
MissingParam.HealthCheckConnectPort
The parameter HealthCheckConnectPort is required.诊断
400
InvalidParam.ListenerPort
The specified ListenerPort is invalid.诊断
400
InvalidParam.StartPort
The specified StartPort is invalid.诊断
400
InvalidParamSize.PortRange
The size of param PortRange is invalid.诊断
400
InvalidParam.EndPort
The specified EndPort is invalid.诊断
400
InvalidParam.PortRange
The specified PortRange is invalid.诊断
400
Duplicated.AclEntry
%s.诊断
400
InvalidParamLength.HealthCheckReq
The length of the parameter HealthCheckReq is invalid.诊断
400
InvalidParamLength.HealthCheckExp
The length of the parameter HealthCheckExp is invalid.诊断
400
InvalidParam.HealthCheckReq
The param HealthCheckReq is invalid.诊断
400
InvalidParam.HealthCheckExp
The param HealthCheckExp is invalid.诊断
400
ResourceNotFound.VServerGroup
%s.诊断
400
IllegalParam.FailoverThreshold
The parameter FailoverThreshold is illegal.诊断
400
IllegalParam.FailoverStrategy
The parameter FailoverStrategy is illegal.诊断
400
InvalidParameter.ZoneNotSupport
The zone does not support the parameter %s.诊断
400
MasterSlaveServerConflict
The servers are conflict for MasterSlaveGroup.诊断
400
MissingParam.VServerGroupId
The parameter VServerGroupId is missing.诊断
400
VipNotSupportQuicVersion
The listener does not support the parameter of QuicVersion.诊断
400
IllegalParam.HealthCheckType
The param of HealthCheckType is illegal.诊断
400
IllegalParam.HealthCheckMethod
The param of HealthCheckMethod is illegal.诊断
400
IllegalParam.HealthCheck
The param of HealthCheck is illegal.诊断
400
OperationDenied.MasterSlaveGroupLogEnabled
The operation is denied because of MasterSlaveGroupLogEnabled.诊断
400
OperationDenied.OnlyIpv4SlbSupport
The operation is not allowed because of OnlyIpv4SlbSupport.诊断
400
OperationDenied.FullNatModeNotAllowed
The operation is not allowed because of FullNatModeNotAllowed.诊断
400
SpecNotSupportParameter
The instance with share spec does not support FullNatEnabled parameter.诊断
400
Abs.VServerGroupIdAndMasterSlaveServerGroupId.MissMatch
Virtual service group ID or master slave server group ID is missing. Please check the input parameters.诊断
400
AclListenerOverLimit
This acl has reached the limit of binding to listeners.诊断
400
QuotaLimitExceeds.AclAttachedToListener
The number of Acl bound listeners has reached the quota limit诊断
400
QuotaLimitExceeds.TotalAclEntry
The number of Acl entries has reached the quota limit.诊断
400
QuotaLimitExceeds.AclListenerOverLimit
This acl has reached the limit of binding to listeners.诊断
403
UnauthorizedRegion
The specified region of is not authorized.诊断

变更历史

变更时间变更内容概要操作
2025-02-14
新增错误码403
2025-02-11
变更错误码400
2025-01-08
变更错误码400
2023-09-08
变更错误码400
2022-11-03
新增请求参数HealthCheckSwitch
2022-07-27
新增请求参数ProxyProtocolV2Enabled
2021-09-23
变更错误码400

相关示例

创建UDP/TCP/HTTP/HTTPS监听、查询和修改监听的配置
2021-11-16