全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 阿里云办公 培训与认证 物联网
负载均衡

CreateLoadBalancerUDPListener

更新时间:2017-09-05 14:13:37

描述

  • 创建UDP Listener,为负载均衡实例创建基于UDP协议的Listener,包含基于UDP协议的策略及健康检查配置。

  • 新创建的Listener为Stoped状态,需调用StartLoadBalancerListener,使之生效。

  • UDP Listener的健康检查永远为开启状态,用户可设置健康检查时的各项参数配置,但是不能将健康检查关闭。

  • 注:当前负载均衡经典网络实例的UDP协议暂不支持查看源地址。

请求参数

名称 类型 是否必须 描述
Action String 操作接口名,系统规定参数。 取值:CreateLoadBalancerUDPListener。
RegionId String 地域ID。
LoadBalancerId String 负载均衡实例的唯一标识。
ListenerPort Integer 负载均衡实例前端使用的端口。取值:1-65535。
BackendServerPort Integer 负载均衡实例前端使用的端口。取值:1-65535。
Bandwidth Integer 监听的带宽上限值。

取值:-1/1-1000(单位为Mbps); 针对按固定带宽计费方式的公网类型实例,不同Listener上的Bandwidth分配的带宽峰值总和不能超出在创建负载均衡实例时设定的Bandwidth值,且不能将Listener上的Bandwidth设置为-1;针对按使用流量计费方式的公网类型实例,可以选择将Listener上的Bandwidth设置为-1,表示不限制带宽峰值。

Scheduler String 调度算法。

取值:wrr/wlc。

默认值:wrr。

PersistenceTimeout Integer 连接持久化的超时时间。取值: 0-3600(单位为秒)。

默认值:0

其中,0表示关闭。

HealthCheckConnectPort Integer 进行健康检查使用的端口。

取值: 1-65535

默认值:无

不设置此参数时,表示使用后端服务端口(BackendServerPort)。

HealthyThreshold Integer 判定健康检查结果为success的阈值。即,健康检查连续成功多少次后,将后端服务器的健康检查结果由fail改为success。

取值:1-10

默认值:3。

UnhealthyThreshold Integer 判定健康检查结果为success的阈值。即,健康检查连续成功多少次后,将后端服务器的健康检查结果由fail改为success。

取值:1-10

默认值:3。

HealthCheckTimeout Integer 健康检查的连接超时时间。

取值:1-50(单位为秒)

默认值:5。

HealthCheckInterval Integer 健康检查的间隔。

取值:1-5(单位为秒)

默认值:2。

VServerGroupId String 虚拟服务器组ID,虚拟服务器组ID和主备服务器组ID只能传其中一个,不允许二者都传。
MasterSlaveServerGroupId String 主备服务器组ID,虚拟服务器组ID和主备服务器组ID只能传其中一个,不允许二者都传。
HealthCheckReq String UDP监听健康检查的请求串,只允许包含字母、数字字符,最大长度限制为500字符。
HealthCheckExp String UDP监听健康检查的响应串,只允许包含字母、数字字符,最大长度限制为500字符。

返回参数

全是公共返回参数,详见 <公共请求参数>

示例

请求示例

  1. https://slb.aliyuncs.com/
  2. &Action=CreateLoadBalancerUDPListener
  3. &LoadBalancerId=139a00604ad-cn-east-hangzhou-01
  4. &ListenerPort=53
  5. &BackendServerPort=53
  6. &Bandwidth=-1
  7. &VServerGroupId=rsp-cige6j5e7p
  8. &<公共请求参数>

返回示例

  • XML 格式
    1. <?xml version="1.0" encoding="UTF-8"?>
    2. <CreateLoadBalancerUDPListenerResponse>
    3. <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
    4. </CreateLoadBalancerUDPListenerResponse>
  • JSON格式
    1. {"RequestId":" CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
    2. }
本文导读目录