负载均衡BLB

    附录

    Model对象定义

    BLBModel

    参数名称 类型 描述
    blbId String LoadBalancer的标识符
    name String LoadBalancer的名称
    desc String LoadBalancer的描述
    address String 分配的内网服务地址IP,通过这个IP即能通过内网访问该实例
    status blbStatus BLB状态
    vpcId String vpc 的ID
    subnetId String subnet 的ID
    publicIp String 如果LoadBalancer绑定过EIP,则显示该项,否则不显示
    tags List<TagModel> 标签键值对列表
    allowDelete Boolean 是否允许删除

    TCPListenerModel

    参数名称 类型 描述
    listenerPort int 监听器的监听端口
    backendPort int 后端服务器的监听端口
    scheduler String 负载均衡算法,值为"RoundRobin"/"LeastConnection"/"Hash"
    healthCheckTimeoutInSecond int 健康检查超时
    healthCheckInterval int 健康检查间隔
    unhealthyThreshold int 不健康阈值,即连续多少次健康检查失败后,屏蔽该后端服务器
    healthyThreshold int 健康阈值,即连续多少次健康检查成功后,重新将该后端服务器置为可用
    tcpSessionTimeout int tcp设置连接超时时间(单位:秒),默认为900,需为10-4000间的整数

    UDPListenerModel

    参数名称 类型 描述
    listenerPort int 监听器的监听端口
    backendPort int 后端服务器的监听端口
    scheduler String 负载均衡算法,值为"RoundRobin"/"LeastConnection"/"Hash"
    healthCheckTimeoutInSecond int 健康检查超时
    healthCheckInterval int 健康检查间隔
    unhealthyThreshold int 不健康阈值,即连续多少次健康检查失败后,屏蔽该后端服务器
    healthyThreshold int 健康阈值,即连续多少次健康检查成功后,重新将该后端服务器置为可用
    healthCheckString String 健康发送的请求字符串,后端服务器收到后需要进行应答,支持标准转义如\00、\xf2,方便配置二进制格式请求

    HTTPListenerModel

    参数名称 类型 描述
    listenerPort int 监听器的监听端口
    backendPort int 后端服务器的监听端口
    scheduler String 负载均衡算法,值为"RoundRobin"/"LeastConnection"
    keepSession bool 是否开启会话保持功能,即同一个Client发出的请求都会到达同一个后端服务器
    keepSessionType String 会话保持的cookie处理方式,当且仅当开启会话保持时有效,值为"insert"/"rewrite"
    keepSessionDuration int 会话保持的cookie有效时间(单位:秒),当且仅当开启会话保持时有效
    keepSessionCookieName String 会话保持需要覆盖的cookie名称,当且仅当开启会话保持且keepSessionType="rewrite"时有效
    xForwardFor bool 是否开启获取Client真实IP,开启后后端服务器上可以通过X-Forwarded-For这个HTTP Header来获得Client端的真实地址
    healthCheckType String 健康检查协议,值为"HTTP"/"TCP"
    healthCheckPort int 健康检查端口
    healthCheckURI String 健康检查URI
    healthCheckTimeoutInSecond int 健康检查超时
    healthCheckInterval int 健康检查间隔
    unhealthyThreshold int 不健康阈值,即连续多少次健康检查失败后,屏蔽该后端服务器
    healthyThreshold int 健康阈值,即连续多少次健康检查成功后,重新将该后端服务器置为可用
    healthCheckNormalStatus String 健康检查正常时的HTTP状态码,支持5类状态码的组合,格式为http_1xx或http_2xx
    serverTimeout int 后端服务器最大超时(单位:秒)
    redirectPort int 将此监听器收到的请求转发到HTTPS监听器,HTTPS监听器通过这个端口指定

    HTTPSListenerModel

    参数名称 类型 描述
    listenerPort int 监听器的监听端口
    backendPort int 后端服务器的监听端口
    scheduler String 负载均衡算法,值为"RoundRobin"/"LeastConnection"
    keepSession bool 是否开启会话保持功能,即同一个Client发出的请求都会到达同一个后端服务器
    keepSessionType String 会话保持的cookie处理方式,当且仅当开启会话保持时有效,值为"insert"/"rewrite"
    keepSessionDuration int 会话保持的cookie有效时间(单位:秒),当且仅当开启会话保持时有效
    keepSessionCookieName String 会话保持需要覆盖的cookie名称,当且仅当开启会话保持且keepSessionType="rewrite"时有效
    xForwardFor bool 是否开启获取Client真实IP,开启后后端服务器上可以通过X-Forwarded-For这个HTTP Header来获得Client端的真实地址
    healthCheckType String 健康检查协议,值为"HTTP"/"TCP"
    healthCheckPort int 健康检查端口
    healthCheckURI String 健康检查URI
    healthCheckTimeoutInSecond int 健康检查超时
    healthCheckInterval int 健康检查间隔
    unhealthyThreshold int 不健康阈值,即连续多少次健康检查失败后,屏蔽该后端服务器
    healthyThreshold int 健康阈值,即连续多少次健康检查成功后,重新将该后端服务器置为可用
    healthCheckNormalStatus String 健康检查正常时的HTTP状态码,支持5类状态码的组合,格式为http_1xx 或 http_2xx
    serverTimeout int 后端服务器最大超时(单位:秒)
    certIds List<String> 加载的SSl证书,目前HTTPS监听器只能绑定一个SSL证书
    ie6Compatible bool 是否开启IE6兼容较早的SSL3.0

    BackendServerModel

    参数名称 类型 描述
    instanceId String 后端服务器标识符
    weight int 后端服务器权重,取值范围[0, 100],权重为0表示不要把流量转发到该后端服务器上

    BackendServerStatus

    参数名称 类型 描述
    instanceId String 后端服务器标识符
    weight int 后端服务器权重
    status String 后端服务器健康状态,值为"Alive"/"Dead"/"Unknown"

    AppBLBModel

    参数名称 类型 描述
    blbId String LoadBalancer的标识符
    name String LoadBalancer的名称
    desc String LoadBalancer的描述
    address String LoadBalancer的地址,点分十进制表示
    status blbStatus BLB状态
    subnetId String subnet 的ID
    vpcId String vpc短Id
    publicIp String 如果LoadBalancer绑定过EIP,则显示该项,否则不显示
    tags List 标签键值对列表
    allowDelete Boolean 是否允许删除

    TagModel

    参数名称 类型 描述
    tagKey String 标签的键,可包含大小写字母、数字、中文以及-_ /.特殊字符,长度1-65
    tagValue String 标签的值,可包含大小写字母、数字、中文以及-_ /.特殊字符,长度0-65

    ListenerModel

    参数名称 类型 描述
    port String 监听器端口
    type String 监听器协议类型

    AppTCPListenerModel

    参数名称 类型 描述
    listenerPort int 监听器的监听端口
    scheduler String 负载均衡算法,值为"RoundRobin"/"LeastConnection"
    tcpSessionTimeout int tcp设置连接超时时间(单位:秒),默认为900,需为10-4000间的整数

    AppUDPListenerModel

    参数名称 类型 描述
    listenerPort int 监听器的监听端口
    scheduler String 负载均衡算法,值为"RoundRobin"/"LeastConnection"/"Hash"

    AppHTTPListenerModel

    参数名称 类型 描述
    listenerPort int 监听器的监听端口
    scheduler String 负载均衡算法,值为"RoundRobin"/"LeastConnection"
    keepSession boolean 是否开启会话保持功能,即同一个Client发出的请求都会到达同一个后端服务器
    keepSessionType String 会话保持的cookie处理方式,当且仅当开启会话保持时有效,值为"insert"/"rewrite"
    keepSessionTimeout int 会话保持的cookie有效时间(单位:秒),当且仅当开启会话保持时有效
    keepSessionCookieName String 会话保持需要覆盖的cookie名称,当且仅当开启会话保持且keepSessionType="rewrite"时有效
    xForwardedFor boolean 是否开启获取Client真实IP,开启后后端服务器上可以通过X-Forwarded-For这个HTTP Header来获得Client端的真实地址
    serverTimeout int 后端服务器最大超时(单位:秒)
    redirectPort int 将此监听器收到的请求转发到HTTPS监听器,HTTPS监听器通过这个端口指定

    AppHTTPSListenerModel

    参数名称 类型 描述
    port int 监听器的监听端口
    scheduler String 负载均衡算法,值为"RoundRobin"/"LeastConnection"
    keepSession boolean 是否开启会话保持功能,即同一个Client发出的请求都会到达同一个后端服务器
    keepSessionType String 会话保持的cookie处理方式,当且仅当开启会话保持时有效,值为"insert"/"rewrite"
    keepSessionTimeout int 会话保持的cookie有效时间(单位:秒),当且仅当开启会话保持时有效
    keepSessionCookieName String 会话保持需要覆盖的cookie名称,当且仅当开启会话保持且keepSessionType="rewrite"时有效
    xForwardedFor boolean 是否开启获取Client真实IP,开启后后端服务器上可以通过X-Forwarded-For这个HTTP Header来获得Client端的真实地址
    serverTimeout int 后端服务器最大超时(单位:秒)
    certIds List\<String> 加载的SSl证书链
    encryptionType String 加密选项,支持三种类型:compatibleIE/incompatibleIE/userDefind,分别对应:兼容IE的加密方式/禁用不安全的加密方式/自定义加密方式,当encryptionType有值且合法时ie6Compatible字段传值不生效
    encryptionProtocols List\<String> 当encryptionType值为userDefind时协议类型列表,是以"sslv3"、"tlsv10"、"tlsv11"、"tlsv12"四种协议组合形成的字符串列表
    dualAuth boolean 是否开启双向认证,默认为关闭
    clientCertIds List\<String> 当dualAuth为true时,加载的客户端证书链

    AppSSLListenerModel

    参数名称 类型 描述
    listenerPort int 监听器的监听端口
    scheduler String 负载均衡算法,值为"RoundRobin"/"LeastConnection"/"Hash"
    certIds List\<String> 加载的SSl证书链
    encryptionType String 加密选项,支持三种类型:compatibleIE/incompatibleIE/userDefind,分别对应:兼容IE的加密方式/禁用不安全的加密方式/自定义加密方式,当encryptionType有值且合法时ie6Compatible字段传值不生效
    encryptionProtocols List\<String> 当encryptionType值为userDefind时协议类型列表,是以"sslv3"、"tlsv10"、"tlsv11"、"tlsv12"四种协议组合形成的字符串列表
    dualAuth boolean 是否开启双向认证,默认为关闭
    clientCertIds List\<String> 当dualAuth为true时,加载的客户端证书链

    SSLListenerModel

    参数名称 类型 描述
    listenerPort int 监听器的监听端口
    backendPort int 后端服务器的监听端口
    scheduler String 负载均衡算法,值为"RoundRobin"/"LeastConnection"/"Hash"
    healthCheckTimeoutInSecond int 健康检查超时
    healthCheckInterval int 健康检查间隔
    unhealthyThreshold int 不健康阈值,即连续多少次健康检查失败后,屏蔽该后端服务器
    healthyThreshold int 健康阈值,即连续多少次健康检查成功后,重新将该后端服务器置为可用
    certIds List\<String> 加载的SSl证书链
    ie6Compatible boolean 是否开启IE6兼容较早的SSL3.0
    encryptionType String 加密选项,支持三种类型:compatibleIE/incompatibleIE/userDefind,分别对应:兼容IE的加密方式/禁用不安全的加密方式/自定义加密方式,当encryptionType有值且合法时ie6Compatible字段传值不生效
    encryptionProtocols List\<String> 当encryptionType值为userDefind时协议类型列表,是以"sslv3"、"tlsv10"、"tlsv11"、"tlsv12"四种协议组合形成的字符串列表
    dualAuth boolean 是否开启双向认证,默认为关闭
    clientCertIds List\<String> 当dualAuth为true时,加载的客户端证书链
    serverTimeout int 后端服务器最大超时(单位:秒),默认900s,需为10-4000间的整数

    AppBackendServer

    参数名称 类型 描述
    instanceId String 后端服务器标识符
    weight int 后端服务器权重,取值范围0-100
    privateIp String 查询时返回值,后端绑定的该服务器ip地址
    portList List<AppRsPortModel> 查询时返回值,设置了相应策略,RS开放的端口列表

    AppRsPortModel

    参数名称 类型 描述
    listenerPort int 监听器端口
    backendPort String 后端开放的端口
    portType String 端口协议类型
    healthCheckPortType String 健康检查端口协议类型
    status String 端口状态,"Alive"/"Dead"/"Unknown"
    portId String 端口id
    policyId String 对应策略id

    AppServerGroup

    参数名称 类型 描述
    id String 后端服务器组标识符
    name String 后端服务器组名称
    desc String 后端服务器组描述
    status String 服务器组状态,详见blbStatus
    portList List<AppServerGroupPort> 服务器组开放的端口列表

    AppServerGroupPort

    参数名称 类型 描述
    id String 服务器组端口标识符
    port int 服务器组开放端口号
    type String 端口协议类型,"TCP"/"HTTP"
    status String 服务器组状态,详见blbStatus
    healthCheck String 健康检查协议,支持"HTTP"/"TCP"
    healthCheckPort int 健康检查端口
    healthCheckTimeoutInSecond int 健康检查超时(单位:秒),默认为3,需为1-60间的整数
    healthCheckIntervalInSecond int 健康检查间隔(单位:秒),默认为3,需为1-10间的整数
    healthCheckDownRetry int 不健康阈值,即连续多少次健康检查失败后,屏蔽该后端服务器。默认为3,需为2-5间的整数
    healthCheckUpRetry int 健康阈值,即连续多少次健康检查成功后,重新将该后端服务器置为可用。默认为3,需为2-5间的整数
    healthCheckNormalStatus String 健康检查正常时的HTTP状态码,支持5类状态码的组合,例如"http_1xx|http_2xx",默认"http_2xx|http_3xx"。当健康检查协议为"HTTP"时生效
    healthCheckUrlPath String 健康检查URI,默认/。当健康检查协议为"HTTP"时生效
    udpHealthCheckString String udp健康检查字符串,当端口类型为udp是有效

    AppPolicy

    参数名称 类型 描述
    id String 策略标识符
    desc String 策略描述默认为空
    appServerGroupId String 策略绑定服务器组标识符
    appServerGroupName String 策略绑定服务器组名称
    frontendPort int 前端服务器的监听端口
    backendPort int 目标端口号,当listenerPort对应监听器为TCP或SSL时需要传入对应服务器组(appServerGroupId)下开放的TCP端口号;当listenerPort对应监听器为HTTP或HTTPS时需要传入对应服务器组(appServerGroupId)下开放的HTTP端口号;当listenerPort对应监听器为UDP时需要传入对应服务器组(appServerGroupId)下开放的UDP端口号
    portType String 端口类型
    priority int 策略优先级,有效取值范围是1-32768
    ruleList List<AppRule> 策略规则列表

    AppRule

    参数名称 类型 描述
    key String 规则的类型,host/uri/*
    value String 通配符匹配字符串,详见ValueExample

    规则配置示例

    ValueExample

    key value 描述
    * * 全匹配
    host *.baidu.com 匹配以“.baidu.com”结尾的域名
    uri /abc/def.* 匹配以“/abc/def.”开头的URI路径

    状态编码定义

    blbStatus

    状态 描述
    creating 创建中
    available 运行中
    updating 更新中
    paused 已欠费
    unavailable 暂不可用
    上一篇
    应用型BLB接口
    下一篇
    文档更新记录