普通型BLB实例

负载均衡 BLB

  • 快速入门
  • 功能发布记录
  • 产品描述
    • 产品特性
    • 使用限制
    • 基本概念
    • 基本架构
    • 产品优势
    • 产品介绍
    • 应用场景
    • 性能规格说明
  • 典型实践
    • 通过Terraform实现BLB关联监听器、后端服务器、安全组等
    • BLB选型指南
    • 通过应用型BLB实例获取客户端信息
    • 使用IP组功能在跨地域VPC挂载后端服务器
    • 负载均衡安全防护策略
    • 使用IP组功能在同地域跨VPC挂载后端服务器
    • 通过应用型BLB实现多站点托管
    • 健康检查异常排查
    • 通过Terraform管理BLB
  • 操作指南
    • 多用户访问控制
    • 负载均衡专属集群
    • 负载均衡前后端使用协议对应关系
    • BLB监控项说明
    • 访问控制
    • 标签管理
    • 访问日志
    • 使用VPC流日志记录访问日志
    • 实名认证
    • 扩展域名
    • 应用型BLB实例
    • 服务发布点
    • 普通型IPv6 BLB实例
    • 应用型IPv6实例
    • 定制配置
    • IP组使用指南
    • 普通型BLB实例
      • 创建BLB普通型实例
      • 管理BLB普通型实例
  • 服务等级协议SLA
    • 百度云负载均衡可信云认证服务可用性说明
    • LBDC服务等级协议SLA
    • BLB服务等级协议SLA(V2.0)
  • API参考
    • 访问控制
    • 简介
    • 文档更新记录
    • 附录
    • 接口规范
    • API服务域名
    • 错误码
    • 应用型IPv6BLB接口
      • 应用型IPv6BLB监听器相关接口
      • 应用型IPv6BLB安全组相关接口
      • 应用型IPv6BLB实例相关接口
      • 应用型IPv6BLB服务器组相关接口
    • 普通型BLB接口
      • 普通型BLB实例相关接口
      • 普通型BLB安全组相关接口
      • 普通型BLB监听器相关接口
      • 普通型BLB后端服务器相关接口
    • 服务发布点接口
      • 服务发布点相关接口
    • 负载均衡专属集群LBDC接口
      • LBDC实例相关接口
    • BLB订单相关接口
      • BLB询价
      • BLB计费变更-后付费转预付费
      • BLB计费变更-预付费转后付费
      • BLB-变配
      • BLB计费变更-取消预付费转后付费
      • BLB退订接口
    • 应用型BLB接口
      • 应用型BLB服务器组相关接口
      • 应用型BLB实例相关接口
      • 应用型BLB监听器相关接口
      • 应用型BLB安全组相关接口
    • 普通型IPv6BLB接口
      • 普通型IPv6BLB相关接口
  • 常见问题
    • 计费类问题
    • 负载均衡专属集群类问题
    • 一般类问题
    • 常见问题总览
    • 性能类问题
    • 安全类问题
    • 配置类问题
    • 故障类问题
  • 产品定价
    • 负载均衡实例计费
    • 负载均衡专属集群计费
  • SDK
    • Python-SDK
      • 普通型blb实例
      • 负载均衡专属集群LBDC
      • 应用型blb实例
      • IPv6型BLB实例
      • 服务发布点
      • 初始化
      • 版本更新说明
      • 安装
      • 概述
    • Java-SDK
      • 普通型BLB实例
      • 负载均衡专属集群LBDC
      • 应用型BLB实例
      • IPv6型BLB实例
      • 服务发布点
      • 初始化
      • 版本更新说明
      • 安装SDK工具包
      • 概述
    • GO-SDK
      • 普通型blb实例
      • 负载均衡专属集群LBDC
      • 应用型blb实例
      • 版本变更记录
      • IPv6型BLB实例
      • 服务发布点
      • 初始化
      • 安装
      • 概述
    • PHP-SDK
      • 普通型blb实例
      • 初始化
      • 安装
      • 概述
所有文档
menu
没有找到结果,请重新输入

负载均衡 BLB

  • 快速入门
  • 功能发布记录
  • 产品描述
    • 产品特性
    • 使用限制
    • 基本概念
    • 基本架构
    • 产品优势
    • 产品介绍
    • 应用场景
    • 性能规格说明
  • 典型实践
    • 通过Terraform实现BLB关联监听器、后端服务器、安全组等
    • BLB选型指南
    • 通过应用型BLB实例获取客户端信息
    • 使用IP组功能在跨地域VPC挂载后端服务器
    • 负载均衡安全防护策略
    • 使用IP组功能在同地域跨VPC挂载后端服务器
    • 通过应用型BLB实现多站点托管
    • 健康检查异常排查
    • 通过Terraform管理BLB
  • 操作指南
    • 多用户访问控制
    • 负载均衡专属集群
    • 负载均衡前后端使用协议对应关系
    • BLB监控项说明
    • 访问控制
    • 标签管理
    • 访问日志
    • 使用VPC流日志记录访问日志
    • 实名认证
    • 扩展域名
    • 应用型BLB实例
    • 服务发布点
    • 普通型IPv6 BLB实例
    • 应用型IPv6实例
    • 定制配置
    • IP组使用指南
    • 普通型BLB实例
      • 创建BLB普通型实例
      • 管理BLB普通型实例
  • 服务等级协议SLA
    • 百度云负载均衡可信云认证服务可用性说明
    • LBDC服务等级协议SLA
    • BLB服务等级协议SLA(V2.0)
  • API参考
    • 访问控制
    • 简介
    • 文档更新记录
    • 附录
    • 接口规范
    • API服务域名
    • 错误码
    • 应用型IPv6BLB接口
      • 应用型IPv6BLB监听器相关接口
      • 应用型IPv6BLB安全组相关接口
      • 应用型IPv6BLB实例相关接口
      • 应用型IPv6BLB服务器组相关接口
    • 普通型BLB接口
      • 普通型BLB实例相关接口
      • 普通型BLB安全组相关接口
      • 普通型BLB监听器相关接口
      • 普通型BLB后端服务器相关接口
    • 服务发布点接口
      • 服务发布点相关接口
    • 负载均衡专属集群LBDC接口
      • LBDC实例相关接口
    • BLB订单相关接口
      • BLB询价
      • BLB计费变更-后付费转预付费
      • BLB计费变更-预付费转后付费
      • BLB-变配
      • BLB计费变更-取消预付费转后付费
      • BLB退订接口
    • 应用型BLB接口
      • 应用型BLB服务器组相关接口
      • 应用型BLB实例相关接口
      • 应用型BLB监听器相关接口
      • 应用型BLB安全组相关接口
    • 普通型IPv6BLB接口
      • 普通型IPv6BLB相关接口
  • 常见问题
    • 计费类问题
    • 负载均衡专属集群类问题
    • 一般类问题
    • 常见问题总览
    • 性能类问题
    • 安全类问题
    • 配置类问题
    • 故障类问题
  • 产品定价
    • 负载均衡实例计费
    • 负载均衡专属集群计费
  • SDK
    • Python-SDK
      • 普通型blb实例
      • 负载均衡专属集群LBDC
      • 应用型blb实例
      • IPv6型BLB实例
      • 服务发布点
      • 初始化
      • 版本更新说明
      • 安装
      • 概述
    • Java-SDK
      • 普通型BLB实例
      • 负载均衡专属集群LBDC
      • 应用型BLB实例
      • IPv6型BLB实例
      • 服务发布点
      • 初始化
      • 版本更新说明
      • 安装SDK工具包
      • 概述
    • GO-SDK
      • 普通型blb实例
      • 负载均衡专属集群LBDC
      • 应用型blb实例
      • 版本变更记录
      • IPv6型BLB实例
      • 服务发布点
      • 初始化
      • 安装
      • 概述
    • PHP-SDK
      • 普通型blb实例
      • 初始化
      • 安装
      • 概述
  • 文档中心
  • arrow
  • 负载均衡BLB
  • arrow
  • SDK
  • arrow
  • Java-SDK
  • arrow
  • 普通型BLB实例
本页目录
  • 获取Endpoint
  • 获取AK/SK
  • 新建BlbClient
  • 创建BLB实例
  • 查询已有的BLB实例
  • 查询BLB实例详情
  • 更新BLB实例
  • 释放BLB实例
  • 更新BLB实例ACL功能
  • 创建TCP监听器
  • 创建UDP监听器
  • 创建HTTP监听器
  • 创建HTTPS监听器
  • 创建SSL监听器
  • 查询TCP监听器
  • 查询UDP监听器
  • 查询HTTP监听器
  • 查询HTTPS监听器
  • 查询SSL监听器
  • 查询所有监听
  • 更新TCP监听器
  • 更新UDP监听器
  • 更新HTTP监听器
  • 更新HTTPS监听器
  • 更新SSL监听器
  • 释放监听器
  • 添加后端服务器
  • 查询后端服务器健康状态
  • 查询后端服务器列表
  • 更新后端服务器
  • 释放后端服务器
  • 绑定普通安全组
  • 解绑普通安全组
  • 查询BLB实例普通安全组列表
  • 绑定企业安全组
  • 解绑企业安全组
  • 查询BLB实例企业安全组列表
  • 附录

普通型BLB实例

更新时间:2025-08-21

获取Endpoint

在确认您使用SDK配置的Endpoint时,可先阅读开发人员指南中关于BLB服务域名的部分,理解Endpoint相关的概念。 百度智能云目前开放了多区域支持,请参考区域选择说明中网络产品BLB的部分。

注意: 负载均衡BLB API支持HTTP和HTTPS两种调用方式。为了提升数据的安全性,建议通过HTTPS调用

获取AK/SK

要使用百度智能云负载均衡BLB,您需要拥有一个有效的 AK(Access Key ID)和SK(Secret Access Key)用来进行签名认证。AK/SK是由系统分配给用户的,均为字符串,用于标识用户,为访问服务做签名验证。 可以通过如下步骤获得并了解您的AK/SK信息:

  1. 注册百度智能云账号
  2. 创建AK/SK

新建BlbClient

BlbClient是负载均衡BLB服务的客户端,为开发者与负载均衡BLB服务进行交互提供了一系列的方法。 新建BlbClient时,需要先使用Endpoint、AK、SK对BceClientConfigurationl类型的config实例进行配置,再使用config实例对BlbClient进行配置,具体配置方法如下:

Plain Text
1static final String ENDPOINT = ""
2static final String AK = "";
3static final String SK = "";
4
5BlbClientConfiguration config = new BlbClientConfiguration();
6config.setCredentials(new DefaultBceCredentials(ak, sk));
7config.setEndpoint(endpoint);
8BlbClient blbClient = new BlbClient(config);

创建BLB实例

函数声明

Plain Text
1public CreateBlbResponse createBlb(String name, String desc, String vpcId, String subnetId) {
2}
3public CreateBlbResponse createBlb(CreateBlbRequest createBlbRequest) {
4}

注意:
第一个接口只支持少量常用参数
第二个接口则可以支持较多参数,但需要创建request实例

参数含义

请参考OpenAPI文档 createloadbalancer创建实例请求参数

返回值

  • 操作成功
Plain Text
1{
2    "metadata":具体信息参考附录metadata部分,
3    "blbId": "lb-BLuOPSLZ",
4    "name": "blb-for-test",
5    "address": "192.168.0.24",
6	"desc": "myblb"
7}
  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleCreateBlb.java

查询已有的BLB实例

函数声明

Plain Text
1public ListBlbResponse listBlbs(String address, String name, String blbId, String bccId) {
2}
3public ListBlbResponse listBlbs(ListBlbRequest listBlbRequest) {
4}

注意:
第一个接口只支持少量常用参数
第二个接口则可以支持较多参数,但需要创建request实例

参数含义

请参考OpenAPI文档 describeloadbalancers查询已有的blb实例请求参数

返回值

  • 操作成功
Plain Text
1{
2    "metadata":具体信息参考附录metadata部分,
3    "blbList": [
4        {
5            "blbId": "lb-a7e5zPPk",
6            "status": available,
7            "name": "test-blb",
8			"desc": desc,
9            "address": "192.168.0.23"
10        },
11        {
12            "blbId": "lb-gj5gVpeq",
13            "status": available,
14            "name": "nametest",
15			"desc": desc,
16            "address": "192.168.0.24",
17			"publicIp": "123.2.3.4"
18        }
19    ],
20    "marker": "blb-0A20F971",
21    "nextMarker": "blb-0A20FB09",
22    "isTruncated": true,
23    "maxKeys": 2
24}
  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleListBlbs.java

查询BLB实例详情

函数声明

Plain Text
1public BlbInstance blbDetail(BlbDetailRequest request) {
2}

参数含义

请参考OpenAPI文档 describeloadbalancerdetail查询blb实例详情请求参数

返回值

  • 操作成功
Plain Text
1{
2    "metadata":具体信息参考附录metadata部分,
3    "blbId":"lb-gj5gVpeq",
4    "status":"available",
5    "name":"nametest", 
6    "desc":"",     
7    "address":"192.168.0.2", 
8    "publicIp":"123.2.3.4", 
9    "cidr":"192.168.0.0/16", 
10    "vpcName":"test",         
11    "createTime":"2019-03-07T02:35:31Z",    
12    "releaseTime":"2019-03-07T02:35:31Z",   
13    "listener":[                            
14        {
15            "port":80,                      
16            "backendPort":90,               
17            "type": "TCP",                  
18            "healthCheckType": "TCP",       
19            "healthCheckstatus": "Alive"       
20        }
21    ]
22}
  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleBlbDetail.java

更新BLB实例

函数声明

Plain Text
1public void modifyBlbAttributes(String blbId, String name, String desc) {
2}
3public void modifyBlbAttributes(ModifyBlbAttributesRequest modifyBlbAttributesRequest) {
4}

注意:
第一个接口只支持少量常用参数
第二个接口则可以支持较多参数,但需要创建request实例

参数含义

请参考OpenAPI文档 updateloadbalancer更新实例请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleModifyBlbAttributes.java

释放BLB实例

函数声明

Plain Text
1public void deleteBlb(String blbId) {
2}
3public void deleteBlb(DeleteBlbRequest deleteBlbRequest) {
4}

注意:
第一个接口只支持少量常用参数
第二个接口则可以支持较多参数,但需要创建request实例

参数含义

请参考OpenAPI文档 deleteloadbalancer释放blb实例请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleDeleteBlb.java

更新BLB实例ACL功能

函数声明

Plain Text
1public void updateLoadBalancerAcl(UpdateLoadBalancerAclRequest request) {
2}

参数含义

请参考OpenAPI文档 updateloadbalanceracl更新实例acl功能请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleUpdateLoadBalancerAcl.java

创建TCP监听器

函数声明

Plain Text
1public void createListener(BlbListenerRequest blbListenerRequest) {
2}

参数含义

请参考OpenAPI文档 createtcplistener创建tcp监听器请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleCreateTcpListener.java

创建UDP监听器

函数声明

Plain Text
1public void createListener(BlbListenerRequest blbListenerRequest) {
2}

参数含义

请参考OpenAPI文档 createudplistener创建udp监听器请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleCreateUdpListener.java

创建HTTP监听器

函数声明

Plain Text
1public void createListener(BlbListenerRequest blbListenerRequest) {
2}

参数含义

请参考OpenAPI文档 createhttplistener创建http监听器请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleCreateHttpListener.java

创建HTTPS监听器

函数声明

Plain Text
1public void createListener(BlbListenerRequest blbListenerRequest) {
2}

参数含义

请参考OpenAPI文档 createhttpslistener创建https监听器请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleCreateHttpsListener.java

创建SSL监听器

函数声明

Plain Text
1public void createListener(BlbListenerRequest blbListenerRequest) {
2}

参数含义

请参考OpenAPI文档 createssllistener创建ssl监听器请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleCreateSslListener.java

查询TCP监听器

函数声明

Plain Text
1public ListListenerResponse<TcpListener> listTcpListener(String blbId) {
2}
3public ListListenerResponse listListener(ListListenerRequest listListenerRequest) {
4}

注意:
第一个接口只支持少量常用参数
第二个接口则可以支持较多参数,但需要创建request实例

参数含义

请参考OpenAPI文档 describetcplisteners查询tcp监听器请求参数

返回值

  • 操作成功
Plain Text
1{
2    "metadata":具体信息参考附录metadata部分,
3    "listenerList": [
4        {
5            "listenerPort": 80,
6            "backendPort": 80,
7            "scheduler": "RoundRobin",
8            "healthCheckTimeoutInSecond": 3,
9            "healthCheckInterval": 3,
10            "unhealthyThreshold": 3,
11            "healthyThreshold": 3
12        },
13        {
14            "listenerPort": 88,
15            "backendPort": 88,
16            "scheduler": "RoundRobin",
17            "healthCheckTimeoutInSecond": 2,
18            "healthCheckInterval": 4,
19            "unhealthyThreshold": 3,
20            "healthyThreshold": 3
21        }
22    ],
23    "marker": "listener-0050",
24    "nextMarker": null,
25    "isTruncated": false,
26    "maxKeys": 2
27}
  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleListTcpListener.java

查询UDP监听器

函数声明

Plain Text
1public ListListenerResponse<UdpListener> listUdpListener(String blbId) {
2}
3public ListListenerResponse listListener(ListListenerRequest listListenerRequest) {
4}

注意:
第一个接口只支持少量常用参数
第二个接口则可以支持较多参数,但需要创建request实例

参数含义

请参考OpenAPI文档 describeudplisteners查询udp监听器请求参数

返回值

  • 操作成功
Plain Text
1{
2    "metadata":具体信息参考附录metadata部分,
3    "listenerList": [
4        {
5            "listenerPort": 80,
6            "backendPort": 80,
7            "scheduler": "RoundRobin",
8            "healthCheckType": "UDP",
9            "healthCheckTimeoutInSecond": 3,
10            "healthCheckInterval": 3,
11            "unhealthyThreshold": 3,
12            "healthyThreshold": 3,
13			"healthCheckString":"healthCheck",
14            "udpSessionTimeout":90
15        },
16        {
17            "listenerPort": 88,
18            "backendPort": 88,
19            "scheduler": "RoundRobin",
20            "healthCheckType": "UDP",
21            "healthCheckTimeoutInSecond": 2,
22            "healthCheckInterval": 4,
23            "unhealthyThreshold": 3,
24            "healthyThreshold": 3,
25			"healthCheckString":"healthCheck",
26            "udpSessionTimeout": 90
27        }
28    ],
29    "marker": "listener-0050",
30    "nextMarker": null,
31    "isTruncated": false,
32    "maxKeys": 2
33}
  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleListUdpListener.java

查询HTTP监听器

函数声明

Plain Text
1public ListListenerResponse<HttpListener> listHttpListener(String blbId) {
2}
3public ListListenerResponse listListener(ListListenerRequest listListenerRequest) {
4}

注意:
第一个接口只支持少量常用参数
第二个接口则可以支持较多参数,但需要创建request实例

参数含义

请参考OpenAPI文档 describehttplisteners查询http监听器请求参数

返回值

  • 操作成功
Plain Text
1{
2    "metadata":具体信息参考附录metadata部分,
3    "listenerList": [
4        {
5            "listenerPort": 90,
6            "backendPort": 90,
7            "scheduler": "LeastConnection",
8            "healthCheckTimeoutInSecond": 4,
9            "healthCheckInterval": 5,
10            "unhealthyThreshold": 2,
11            "healthyThreshold": 3,
12            "keepSession": false,
13            "keepSessionType": null,
14            "keepSessionDuration": null,
15            "keepSessionCookieName": null,
16            "xForwardFor": false,
17            "healthCheckType": "HTTP",
18            "healthCheckPort": 90,
19            "healthCheckURI": "/",
20            "healthCheckNormalStatus": "http_2xx|http_3xx",
21            "serverTimeout": 30,
22			"redirectPort": 80
23        },
24        {
25            "listenerPort": 95,
26            "backendPort": 95,
27            "scheduler": "LeastConnection",
28            "healthCheckTimeoutInSecond": 4,
29            "healthCheckInterval": 5,
30            "unhealthyThreshold": 2,
31            "healthyThreshold": 3,
32            "keepSession": false,
33            "keepSessionType": null,
34            "keepSessionDuration": null,
35            "keepSessionCookieName": null,
36            "xForwardFor": false,
37            "healthCheckType": "HTTP",
38            "healthCheckPort": 95,
39            "healthCheckURI": "/",
40            "healthCheckNormalStatus": "http_1xx|http_2xx",
41            "serverTimeout": 1800,
42			"redirectPort": 80
43        }
44    ],
45    "marker": "listener-005A",
46    "nextMarker": "listener-0322",
47    "isTruncated": true,
48    "maxKeys": 2
49}
  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleListHttpListener.java

查询HTTPS监听器

函数声明

Plain Text
1public ListListenerResponse<HttpsListener> listHttpsListener(String blbId) {
2}
3public ListListenerResponse listListener(ListListenerRequest listListenerRequest) {
4}

注意:
第一个接口只支持少量常用参数
第二个接口则可以支持较多参数,但需要创建request实例

参数含义

请参考OpenAPI文档 describehttpslisteners查询https监听器请求参数

返回值

  • 操作成功
Plain Text
1{
2    "metadata":具体信息参考附录metadata部分,
3    "listenerList": [
4        {
5            "listenerPort": 90,
6            "backendPort": 90,
7            "scheduler": "LeastConnection",
8            "healthCheckTimeoutInSecond": 4,
9            "healthCheckInterval": 5,
10            "unhealthyThreshold": 2,
11            "healthyThreshold": 3,
12            "keepSession": false,
13            "keepSessionType": null,
14            "keepSessionDuration": null,
15            "keepSessionCookieName": null,
16            "xForwardFor": false,
17            "healthCheckType": "HTTP",
18            "healthCheckPort": 90,
19            "healthCheckURI": "/",
20            "healthCheckNormalStatus": "http_2xx|http_3xx",
21            "serverTimeout": 30,
22			"certIds": ["cert-zfj2ey2z4kmm"]
23        },
24        {
25            "listenerPort": 95,
26            "backendPort": 95,
27            "scheduler": "LeastConnection",
28            "healthCheckTimeoutInSecond": 4,
29            "healthCheckInterval": 5,
30            "unhealthyThreshold": 2,
31            "healthyThreshold": 3,
32            "keepSession": false,
33            "keepSessionType": null,
34            "keepSessionDuration": null,
35            "keepSessionCookieName": null,
36            "xForwardFor": false,
37            "healthCheckType": "HTTP",
38            "healthCheckPort": 95,
39            "healthCheckURI": "/",
40            "healthCheckNormalStatus": "http_1xx|http_2xx",
41            "serverTimeout": 1800,
42			"certIds": ["cert-zfj2ey2z4kmm"]
43        }
44    ],
45    "marker": "listener-005A",
46    "nextMarker": "listener-0322",
47    "isTruncated": true,
48    "maxKeys": 2
49}
  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleCreateHttpsListener.java

查询SSL监听器

函数声明

Plain Text
1public ListListenerResponse<SslListener> listSslListener(String blbId) {
2}
3public ListListenerResponse listListener(ListListenerRequest listListenerRequest) {
4}

注意:
第一个接口只支持少量常用参数
第二个接口则可以支持较多参数,但需要创建request实例

参数含义

请参考OpenAPI文档 describessllisteners查询ssl监听器请求参数

返回值

  • 操作成功
Plain Text
1{
2    "metadata":具体信息参考附录metadata部分,
3    "listenerList": [
4        {
5            "listenerPort": 80,
6            "backendPort": 80,
7            "scheduler": "RoundRobin",
8            "healthCheckTimeoutInSecond": 3,
9            "healthCheckInterval": 3,
10            "unhealthyThreshold": 3,
11            "healthyThreshold": 3
12        },
13        {
14            "listenerPort": 88,
15            "backendPort": 88,
16            "scheduler": "RoundRobin",
17            "healthCheckTimeoutInSecond": 2,
18            "healthCheckInterval": 4,
19            "unhealthyThreshold": 3,
20            "healthyThreshold": 3
21        }
22    ],
23    "marker": "listener-0050",
24    "nextMarker": null,
25    "isTruncated": false,
26    "maxKeys": 2
27}
  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleListSslListener.java

查询所有监听

函数声明

Plain Text
1public ListListenerResponse<AllListener> listAllListener(String blbId) {
2}
3public ListListenerResponse<AllListener> listAllListener(ListAllListenerRequest request) {
4}

注意:
第一个接口只支持少量常用参数
第二个接口则可以支持较多参数,但需要创建request实例

参数含义

请参考OpenAPI文档 describealllisteners查询所有监听请求参数

返回值

  • 操作成功
Plain Text
1{
2      "metadata":具体信息参考附录metadata部分,
3      "marker" : "listener-0035",
4      "isTruncated" : false,
5      "maxKeys" : 1000,
6      "listenerList" : [ {
7        "listenerPort" : 53,
8        "backendPort" : 53,
9        "backendPortType" : "UDP",
10        "scheduler" : "RoundRobin",
11        "healthCheckTimeoutInSecond" : 3,
12        "healthCheckInterval" : 3,
13        "unhealthyThreshold" : 3,
14        "healthyThreshold" : 3,
15        "getBlbIp" : false,
16        "healthCheckValid" : 1,
17        "listenerType" : "UDP",
18        "udpSessionTimeout" : 30,
19        "healthCheckString" : "\\00\\01\\01\\00\\00\\01\\00\\00\\00\\00\\00\\00\\05baidu\\03com\\00\\00\\01\\00\\01",
20        "healthCheckType" : "UDP"
21      }, {
22        "listenerPort" : 80,
23        "backendPort" : 80,
24        "backendPortType" : "TCP",
25        "scheduler" : "RoundRobin",
26        "healthCheckTimeoutInSecond" : 3,
27        "healthCheckInterval" : 3,
28        "unhealthyThreshold" : 3,
29        "healthyThreshold" : 3,
30        "getBlbIp" : false,
31        "healthCheckValid" : 1,
32        "listenerType" : "TCP",
33        "tcpSessionTimeout" : 900
34      }, {
35        "listenerPort" : 81,
36        "backendPort" : 80,
37        "backendPortType" : "HTTP",
38        "scheduler" : "RoundRobin",
39        "healthCheckTimeoutInSecond" : 3,
40        "healthCheckInterval" : 3,
41        "unhealthyThreshold" : 3,
42        "healthyThreshold" : 3,
43        "getBlbIp" : false,
44        "healthCheckValid" : 1,
45        "listenerType" : "HTTP",
46        "keepSession" : false,
47        "xForwardFor" : true,
48        "healthCheckType" : "HTTP",
49        "healthCheckPort" : 80,
50        "healthCheckURI" : "/",
51        "healthCheckNormalStatus" : "http_2xx|http_3xx",
52        "healthCheckHost" : "",
53        "serverTimeout" : 30,
54        "redirectPort" : 0
55      } ]
56}
  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleListAllListener.java

更新TCP监听器

函数声明

Plain Text
1public void modifyListenerAttributes(BlbListenerRequest modifyListenerAttributesRequest) {
2}

参数含义

请参考OpenAPI文档 updatetcplistener更新tcp监听器请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleUpdateTcpListener.java

更新UDP监听器

函数声明

Plain Text
1public void modifyListenerAttributes(BlbListenerRequest modifyListenerAttributesRequest) {
2}

参数含义

请参考OpenAPI文档 updateudplistener更新udp监听器请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleUpdateUdpListener.java

更新HTTP监听器

函数声明

Plain Text
1public void modifyListenerAttributes(BlbListenerRequest modifyListenerAttributesRequest) {
2}

参数含义

请参考OpenAPI文档 updatehttplistener更新http监听器请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleUpdateHttpListener.java

更新HTTPS监听器

函数声明

Plain Text
1public void modifyListenerAttributes(BlbListenerRequest modifyListenerAttributesRequest) {
2}

参数含义

请参考OpenAPI文档 updatehttpslistener更新https监听器请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleUpdateHttpsListener.java

更新SSL监听器

函数声明

Plain Text
1public void modifyListenerAttributes(BlbListenerRequest modifyListenerAttributesRequest) {
2}

参数含义

请参考OpenAPI文档 updatessllistener更新ssl监听器请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleUpdateSslListener.java

释放监听器

函数声明

Plain Text
1public void deleteListener(String blbId, List<Integer> portList) {
2}
3public void deleteListener(DeleteListenerRequest deleteListenerRequest) {
4}

注意:
第一个接口只支持少量常用参数
第二个接口则可以支持较多参数,但需要创建request实例

参数含义

请参考OpenAPI文档 deletelisteners释放监听器请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleDeleteListeners.java

添加后端服务器

函数声明

Plain Text
1public void addBackendServers(String blbId, List<BackendServer> backendServerList) {
2}
3public void addBackendServers(AddBackendServersRequest addBackendServersRequest) {
4}

注意:
第一个接口只支持少量常用参数
第二个接口则可以支持较多参数,但需要创建request实例

参数含义

请参考OpenAPI文档 addbackendservers添加后端服务器请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleAddBackendServers.java

查询后端服务器健康状态

函数声明

Plain Text
1public ListBackendServerStatusResponse listBackendServerStatus(String blbId, int listenerPort) {
2}
3public ListBackendServerStatusResponse listBackendServerStatus(ListBackendServerStatusRequest listBackendServerStatusRequest) {
4}

注意:
第一个接口只支持少量常用参数
第二个接口则可以支持较多参数,但需要创建request实例

参数含义

请参考OpenAPI文档 describehealthstatus查询后端服务器健康状态请求参数

返回值

  • 操作成功
Plain Text
1{
2    "metadata":具体信息参考附录metadata部分,
3    "backendServerList": [
4        {
5            "instanceId": "i-YfAibl4A",
6            "weight": 50,
7            "status": "Alive"
8        },
9        {
10            "instanceId": "i-jBXABQ8D",
11            "weight": 60,
12            "status": "Dead"
13        }
14    ],
15    "type": "TCP",
16    "listenerPort": 88,
17    "backendPort": 88,
18    "marker": "rs-0A6BE9BB",
19    "nextMarker": null,
20    "isTruncated": false,
21    "maxKeys": 1000
22}
  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleListBackendServerStatus.java

查询后端服务器列表

函数声明

Plain Text
1public ListBackendServerResponse listBackendServers(String blbId) {
2}
3public ListBackendServerResponse listBackendServers(ListBackendServerRequest listBackendServerRequest) {
4}

注意:
第一个接口只支持少量常用参数
第二个接口则可以支持较多参数,但需要创建request实例

参数含义

请参考OpenAPI文档 describebackendservers查询后端服务器列表请求参数

返回值

  • 操作成功
Plain Text
1{
2    "metadata":具体信息参考附录metadata部分,
3    "backendServerList": [
4        {
5            "instanceId": "i-YfAibl4A",
6            "weight": 50,
7        }
8    ],
9    "marker": "rs-0A6BE9BB",
10    "nextMarker": null,
11    "isTruncated": false,
12    "maxKeys": 1000
13}
  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleListBackendServers.java

更新后端服务器

函数声明

Plain Text
1public void modifyBackendServerAttributes(String blbId, List<BackendServer> backendServerList) {
2}
3public void modifyBackendServerAttributes(ModifyBSAttributesRequest modifyBSAttributesRequest) {
4}

注意:
第一个接口只支持少量常用参数
第二个接口则可以支持较多参数,但需要创建request实例

参数含义

请参考OpenAPI文档 updatebackendservers更新后端服务器请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleModifyBackendServerAttributes.java

释放后端服务器

函数声明

Plain Text
1public void deleteBackendServers(String blbId, List<String> backendServerList) {
2}
3public void deleteBackendServers(DeleteBSRequest deleteBSRequest) {
4}

注意:
第一个接口只支持少量常用参数
第二个接口则可以支持较多参数,但需要创建request实例

参数含义

请参考OpenAPI文档 removebackendservers释放后端服务器请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleDeleteBackendServers.java

绑定普通安全组

函数声明

Plain Text
1public void bindSg(SgOperateRequest request) {
2}

参数含义

请参考OpenAPI文档 bindsecuritygroups绑定普通安全组请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleBindSg.java

解绑普通安全组

函数声明

Plain Text
1public void unBindSg(SgOperateRequest request) {
2}

参数含义

请参考OpenAPI文档 unbindsecuritygroups解绑普通安全组请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleUnBindSg.java

查询BLB实例普通安全组列表

函数声明

Plain Text
1public ListBlbSgResponse listBlbSg(ListBlbSgRequest request) {
2}

参数含义

请参考OpenAPI文档 describesecuritygroups查询blb实例普通安全组列表请求参数

返回值

  • 操作成功
Plain Text
1{
2    "metadata":具体信息参考附录metadata部分,
3    "blbSecurityGroups": [
4        {
5            "securityGroupDesc": "", 
6            "securityGroupId": "g-4NxWoxeq", 
7            "securityGroupName": "securitygroup-name",
8            "vpcName":"vpc-name",
9            "securityGroupRules": [
10                {
11                    "destGroupId": "", 
12                    "destIp": "all", 
13                    "direction": "egress", 
14                    "ethertype": "IPv4", 
15                    "portRange": "1-65535", 
16                    "protocol": "all", 
17                    "securityGroupRuleId": "r-gkv8yupumvx2"
18                }
19            ]
20        }
21    ]
22}
  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleListBlbSg.java

绑定企业安全组

函数声明

Plain Text
1public void bindEsg(EsgOperateRequest request) {
2}

参数含义

请参考OpenAPI文档 bindenterprisesecuritygroups绑定企业安全组请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleBindEsg.java

解绑企业安全组

函数声明

Plain Text
1public void unBindEsg(EsgOperateRequest request) {
2}

参数含义

请参考OpenAPI文档 unbindenterprisesecuritygroups解绑企业安全组请求参数

返回值

  • 操作成功

无返回值

  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleUnBindEsg.java

查询BLB实例企业安全组列表

函数声明

Plain Text
1public ListBlbEsgResponse listBlbEsg(ListBlbSgRequest request) {
2}

参数含义

请参考OpenAPI文档 describeenterprisesecuritygroups查询blb实例企业安全组列表请求参数

返回值

  • 操作成功
Plain Text
1{
2    "metadata":具体信息参考附录metadata部分,
3    "enterpriseSecurityGroups": [{
4		"enterpriseSecurityGroupId": "esg-g8z4qfj0m0bu",
5		"enterpriseSecurityGroupName": "test0627",
6		"enterpriseSecurityGroupDesc": "",
7		"enterpriseSecurityGroupRules": [{
8				"remark": "全部协议",
9				"direction": "egress",
10				"action": "allow",
11				"priority": 1000,
12				"ethertype": "IPv6",
13				"portRange": "",
14				"sourceIp": "",
15				"destIp": "all",
16				"enterpriseSecurityGroupRuleId": "esgr-9tzd4yijcwqu",
17				"protocol": "all"
18			},
19			{
20				"remark": "",
21				"direction": "egress",
22				"action": "allow",
23				"priority": 1000,
24				"ethertype": "IPv4",
25				"portRange": "",
26				"sourceIp": "",
27				"destIp": "all",
28				"enterpriseSecurityGroupRuleId": "esgr-9je09z6bd9wv",
29				"protocol": "tcp"
30			},
31			{
32				"remark": "",
33				"direction": "ingress",
34				"action": "allow",
35				"priority": 1000,
36				"ethertype": "IPv4",
37				"portRange": "2",
38				"sourceIp": "all",
39				"destIp": "",
40				"enterpriseSecurityGroupRuleId": "esgr-jcej4juqbh49",
41				"protocol": "tcp"
42			}
43		]
44	}]
45}
  • 操作失败

操作失败返回异常列表参考负载均衡BLB异常列表

代码示例

具体代码示例参考:ExampleListBlbEsg.java

附录

公共返回信息metadata格式

Plain Text
1 {
2      "bceRequestId":"f5f0821d-45fe-439b-bbf4-fc48b639f84a",
3      "contentLength":28,
4      "contentType":"application/json;charset=UTF-8",
5      "date":1701917695000,
6      "server":"openresty/1.15.8.1"
7 }

上一篇
Python-SDK
下一篇
负载均衡专属集群LBDC