应用型BLB实例

更新时间：2024-01-11

获取Endpoint

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

获取AK/SK

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

新建AppBlbClient

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

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);
8AppBlbClient appBlbClient = new AppBlbClient(config);

创建BLB实例

函数声明

Plain Text

1public CreateBlbResponse createBlb(String name, String desc, String vpcId, String subnetId, List<Tag> tags) {
2}
3public CreateBlbResponse createBlb(CreateBlbRequest createBlbRequest) {
4}

参数含义

请参考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 void modifyBlbAttributes(String blbId, String name, String desc) {
2}
3public void modifyBlbAttributes(ModifyBlbAttributesRequest modifyBlbAttributesRequest) {
4}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleModifyAppBlbAttributes.java

查询已有的BLB实例

函数声明

Plain Text

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

参数含义

请参考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异常列表

代码示例

具体代码示例参考：ExampleListAppBlbs.java

查询BLB实例详情

函数声明

Plain Text

1public BlbInstance blbDetail(BlbDetailRequest request) {
2}

参数含义

请参考OpenAPI文档 describeloadbalancers查询已有的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异常列表

代码示例

具体代码示例参考：ExampleAppBlbDetail.java

释放BLB实例

函数声明

Plain Text

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

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleDeleteAppBlb.java

创建TCP监听器

函数声明

Plain Text

1public void createListener(BlbListenerRequest blbListenerRequest) {
2}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleCreateAppTcpListener.java

创建UDP监听器

函数声明

Plain Text

1public void createListener(BlbListenerRequest blbListenerRequest) {
2}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleCreateAppUdpListener.java

创建HTTP监听器

函数声明

Plain Text

1public void createListener(BlbListenerRequest blbListenerRequest) {
2}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleCreateAppHttpListener.java

创建HTTPS监听器

函数声明

Plain Text

1public void createListener(BlbListenerRequest blbListenerRequest) {
2}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleCreateAppHttpsListener.java

创建SSL监听器

函数声明

Plain Text

1public void createListener(BlbListenerRequest blbListenerRequest) {
2}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleCreateAppSslListener.java

更新TCP监听器

函数声明

Plain Text

1public void modifyListenerAttributes(BlbListenerRequest modifyListenerAttributesRequest) {
2}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleUpdateAppTcpListener.java

更新UDP监听器

函数声明

Plain Text

1public void modifyListenerAttributes(BlbListenerRequest modifyListenerAttributesRequest) {
2}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleUpdateAppUdpListener.java

更新HTTP监听器

函数声明

Plain Text

1public void modifyListenerAttributes(BlbListenerRequest modifyListenerAttributesRequest) {
2}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleUpdateAppHttpListener.java

更新HTTPS监听器

函数声明

Plain Text

1public void modifyListenerAttributes(BlbListenerRequest modifyListenerAttributesRequest) {
2}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleUpdateAppHTTPSListener.java

更新SSL监听器

函数声明

Plain Text

1public void modifyListenerAttributes(BlbListenerRequest modifyListenerAttributesRequest) {
2}

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleUpdateAppSSLListener.java

查询TCP监听器

函数声明

Plain Text

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

参数含义

请参考OpenAPI文档 describeapptcplisteners查询应用型tcp监听器请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "listenerList": [
4        {
5            "listenerPort" : 800,
6            "scheduler" : "RoundRobin",
7            "tcpSessionTimeout" : 900
8        },
9        {
10            "listenerPort" : 808,
11            "scheduler" : "RoundRobin",
12            "tcpSessionTimeout" : 900
13        }
14    ],
15    "marker": "listener-0050",
16    "nextMarker": null,
17    "isTruncated": false,
18    "maxKeys": 1000
19}

操作失败

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

代码示例

具体代码示例参考：ExampleDescribeAppTCPListeners.java

查询UDP监听器

函数声明

Plain Text

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

参数含义

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

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "listenerList": [
4        {
5            "listenerPort" : 53,
6            "scheduler" : "RoundRobin",
7            "udpSessionTimeout" : 30
8        },
9        {
10            "listenerPort" : 54,
11            "scheduler" : "RoundRobin",
12            "udpSessionTimeout" : 30
13        }
14    ],
15    "marker": "listener-0050",
16    "nextMarker": null,
17    "isTruncated": false,
18    "maxKeys": 1000
19}

操作失败

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

代码示例

具体代码示例参考：ExampleDescribeAppUDPListeners.java

查询HTTP监听器

函数声明

Plain Text

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

参数含义

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

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "listenerList": [
4        {
5            "listenerPort" : 80,
6            "scheduler" : "RoundRobin",
7            "keepSession" : false,
8            "xForwardedFor" : true,
9            "xForwardedProto" : false,
10            "serverTimeout" : 30,
11            "redirectPort" : 0
12        },
13        {
14            "listenerPort" : 801,
15            "scheduler" : "RoundRobin",
16            "keepSession" : false,
17            "xForwardedFor" : true,
18            "xForwardedProto" : false,
19            "serverTimeout" : 30,
20            "redirectPort" : 0
21        }
22    ],
23    "marker": "listener-005A",
24    "nextMarker": "listener-0322",
25    "isTruncated": true,
26    "maxKeys": 1000
27}

操作失败

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

代码示例

具体代码示例参考：ExampleDescribeAppHTTPListeners.java

查询HTTPS监听器

函数声明

Plain Text

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

参数含义

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

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "listenerList": [
4        {
5            "listenerPort" : 443,
6            "scheduler" : "RoundRobin",
7            "keepSession" : false,
8            "xForwardedFor" : true,
9            "xForwardedProto" : false,
10            "serverTimeout" : 30,
11            "certIds" : [ "cert-gs8bktrm7drp" ],
12            "encryptionType" : "tls_cipher_policy_default",
13            "encryptionProtocols" : [ "tlsv10", "tlsv11", "tlsv12" ],
14            "appliedCiphers" : "ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:AES128-GCM-SHA256:AES256-SHA:AES128-SHA:AES256-GCM-SHA384:AES256-SHA256:AES128-SHA256:DES-CBC3-SHA",
15            "dualAuth" : false,
16            "clientCertIds" : [ ]
17        },
18        {
19            "listenerPort" : 448,
20            "scheduler" : "RoundRobin",
21            "keepSession" : false,
22            "xForwardedFor" : true,
23            "xForwardedProto" : false,
24            "serverTimeout" : 30,
25            "certIds" : [ "cert-gs8bktrm7drp" ],
26            "encryptionType" : "tls_cipher_policy_default",
27            "encryptionProtocols" : [ "tlsv10", "tlsv11", "tlsv12" ],
28            "appliedCiphers" : "ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:AES128-GCM-SHA256:AES256-SHA:AES128-SHA:AES256-GCM-SHA384:AES256-SHA256:AES128-SHA256:DES-CBC3-SHA",
29            "dualAuth" : false,
30            "clientCertIds" : [ ]
31        }
32    ],
33    "marker": "listener-005A",
34    "nextMarker": "listener-0322",
35    "isTruncated": true,
36    "maxKeys": 1000
37}

操作失败

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

代码示例

具体代码示例参考：ExampleDescribeAppHTTPListeners.java

查询SSL监听器

函数声明

Plain Text

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

参数含义

请参考OpenAPI文档 describeappssllisteners查询应用型ssl监听器请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "listenerList" : [ 
4        {
5            "listenerPort" : 444,
6            "scheduler" : "RoundRobin",
7            "certIds" : [ "cert-gs8bktrm7drp" ],
8            "encryptionType" : "tls_cipher_policy_default",
9            "encryptionProtocols" : [ "tlsv10", "tlsv11", "tlsv12" ],
10            "appliedCiphers" : "ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:AES128-GCM-SHA256:AES256-SHA:AES128-SHA:AES256-GCM-SHA384:AES256-SHA256:AES128-SHA256:DES-CBC3-SHA",
11            "dualAuth" : false,
12            "clientCertIds" : [ ],
13            "serverTimeout" : 900
14        }, 
15        {
16            "listenerPort" : 445,
17            "scheduler" : "RoundRobin",
18            "certIds" : [ "cert-4cn1jhphn747" ],
19            "encryptionType" : "tls_cipher_policy_default",
20            "encryptionProtocols" : [ "tlsv10", "tlsv11", "tlsv12" ],
21            "appliedCiphers" : "ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:AES128-GCM-SHA256:AES256-SHA:AES128-SHA:AES256-GCM-SHA384:AES256-SHA256:AES128-SHA256:DES-CBC3-SHA",
22            "dualAuth" : false,
23            "clientCertIds" : [ ],
24            "serverTimeout" : 900
25        } 
26    ],
27    "marker": "listener-0050",
28    "nextMarker": null,
29    "isTruncated": false,
30    "maxKeys": 1000
31}

操作失败

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

代码示例

具体代码示例参考：ExampleDescribeAppSSLListeners.java

查询所有监听器

函数声明

Plain Text

1public ListListenerResponse<AllListener> listAllListener(String blbId) {
2}
3public ListListenerResponse listListener(ListListenerRequest listListenerRequest) {
4}

参数含义

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

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "listenerList" : [ 
4        {
5            "listenerPort" : 53,
6            "scheduler" : "RoundRobin",
7            "listenerType" : "UDP",
8            "udpSessionTimeout" : 900
9        }, 
10        {
11            "listenerPort" : 80,
12            "scheduler" : "RoundRobin",
13            "listenerType" : "HTTP",
14            "keepSession" : false,
15            "xForwardFor" : true,
16            "xForwardedProto" : false,
17            "serverTimeout" : 30,
18            "redirectPort" : 0
19        }, 
20        {
21            "listenerPort" : 443,
22            "scheduler" : "RoundRobin",
23            "listenerType" : "HTTPS",
24            "keepSession" : false,
25            "xForwardFor" : true,
26            "xForwardedProto" : false,
27            "serverTimeout" : 30,
28            "certIds" : [ "cert-gs8bktrm7drp" ],
29            "dualAuth" : false,
30            "encryptionType" : "tls_cipher_policy_default",
31            "encryptionProtocols" : [ "tlsv10", "tlsv11", "tlsv12" ],
32            "appliedCiphers" : "ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:AES128-GCM-SHA256:AES256-SHA:AES128-SHA:AES256-GCM-SHA384:AES256-SHA256:AES128-SHA256:DES-CBC3-SHA"
33        }, 
34        {
35            "listenerPort" : 444,
36            "scheduler" : "RoundRobin",
37            "listenerType" : "SSL",
38            "serverTimeout" : 900,
39            "certIds" : [ "cert-gs8bktrm7drp" ],
40            "dualAuth" : false,
41            "encryptionType" : "tls_cipher_policy_default",
42            "encryptionProtocols" : [ "tlsv10", "tlsv11", "tlsv12" ],
43            "appliedCiphers" : "ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:AES128-GCM-SHA256:AES256-SHA:AES128-SHA:AES256-GCM-SHA384:AES256-SHA256:AES128-SHA256:DES-CBC3-SHA"
44        },
45        {
46            "listenerPort" : 800,
47            "scheduler" : "RoundRobin",
48            "listenerType" : "TCP",
49            "tcpSessionTimeout" : 900
50        }
51    ],
52    "marker": "listener-0050",
53    "nextMarker": null,
54    "isTruncated": false,
55    "maxKeys": 1000
56}

操作失败

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

代码示例

具体代码示例参考：ExampleDescribeAppAllListeners.java

释放监听器

函数声明

Plain Text

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

参数含义

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

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleDeleteAppListeners.java

创建策略

函数声明

Plain Text

1public CreateAppPolicyResponse createPolicys(String blbId, Integer listenerPort, String type, List<AppPolicy> appPolicyVos) {
2}
3public CreateAppPolicyResponse createPolicys(AppPolicyRequest appPolicyRequest) {
4}

参数含义

请参考OpenAPI文档 createpolicys创建策略请求参数

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleCreatePolicys.java

查询策略列表

函数声明

Plain Text

1public ListAppPolicyResponse listPolicys(String blbId, Integer port) {
2}
3public ListAppPolicyResponse listPolicys(ListAppPolicyRequest listAppPolicyRequest) {
4}

参数含义

请参考OpenAPI文档 describepolicys查询对应blb端口下策略信息请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "policyList" : [ 
4        {
5            "id" : "policy-e18d7448",
6            "desc" : "",
7            "appServerGroupId" : "sg-b8221879",
8            "appServerGroupName" : "sgp-6FF0traU",
9            "groupType" : "Server",
10            "frontendPort" : 443,
11            "backendPort" : 80,
12            "portType" : "HTTP",
13            "priority" : 3,
14            "ruleList" : [ 
15                {
16                    "key" : "uri",
17                    "value" : "/aa"
18                } 
19            ]
20        }, 
21        {
22            "id" : "policy-ed24ea7d",
23            "desc" : "",
24            "appServerGroupId" : "sg-b8221879",
25            "appServerGroupName" : "sgp-6FF0traU",
26            "groupType" : "Server",
27            "frontendPort" : 443,
28            "backendPort" : 80,
29            "portType" : "HTTP",
30            "priority" : 2,
31            "ruleList" : [ 
32                {
33                    "key" : "host",
34                    "value" : "www.abc.com"
35                } 
36            ]
37        }
38    ],
39    "marker": "policy-e18d7448",
40    "nextMarker": null,
41    "isTruncated": false,
42    "maxKeys": 1000
43}

操作失败

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

代码示例

具体代码示例参考：ExampleDescribePolicys.java

删除策略

函数声明

Plain Text

1public void deletePolicys(String blbId, Integer port, List<String> policyIdList) {
2}
3public void deletePolicys(DeleteAppPolicyRequest deleteAppPolicyRequest) {
4}

参数含义

请参考OpenAPI文档 deletepolicys批量删除策略请求参数

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleDeletePolicys.java

创建应用型服务器组

函数声明

Plain Text

1public AppSgResponse createAppServerGroup(String blbId, String name, String desc, List<AppBackendServer> backendServerList) {
2}
3public AppSgResponse createAppServerGroup(AppSgRequest appSgRequest) {
4}

参数含义

请参考OpenAPI文档 createaappservergroup创建应用型服务器组请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "id" : "sg-0aae4f4c",
4    "name" : "sgp-udT9IBTO",
5    "desc" : "",
6    "status" : "available"
7}

操作失败

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

代码示例

具体代码示例参考：ExampleCreateAppServerGroup.java

更新服务器组

函数声明

Plain Text

1public void modifyAppServerGroupAttributes(String blbId, String sgId, String name, String desc) {
2}
3public void modifyAppServerGroupAttributes(AppSgRequest appSgRequest) {
4}

参数含义

请参考OpenAPI文档 updateappservergroup更新服务器组请求参数

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleUpdateAppServerGroup.java

查询服务器组列表

函数声明

Plain Text

1public ListAppSgResponse listAppServerGroup(String blbId, String name) {
2}
3public ListAppSgResponse listAppServerGroup(ListAppSgRequest listAppSgRequest) {
4}

参数含义

请参考OpenAPI文档 describeappservergroup查询服务器组请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "appServerGroupList" : [ 
4        {
5            "id" : "sg-0aae4f4c",
6            "name" : "sgp-udT9IBTO",
7            "desc" : "",
8            "status" : "available",
9            "portList" : [ ]
10        }, 
11        {
12            "id" : "sg-b8221879",
13            "name" : "sgp-6FF0traU",
14            "desc" : "",
15            "status" : "available",
16            "portList" : [ 
17                {
18                      "id" : "port-c5a87acf",
19                      "status" : "available",
20                      "port" : 80,
21                      "type" : "HTTP",
22                      "healthCheck" : "HTTP",
23                      "healthCheckPort" : 80,
24                      "healthCheckUrlPath" : "/",
25                      "healthCheckTimeoutInSecond" : 3,
26                      "healthCheckIntervalInSecond" : 3,
27                      "healthCheckDownRetry" : 3,
28                      "healthCheckUpRetry" : 3,
29                      "healthCheckNormalStatus" : "http_2xx|http_3xx",
30                      "udpHealthCheckString" : ""
31                }
32            ]
33        }
34    ],
35    "marker": "62672",
36    "nextMarker": null,
37    "isTruncated": false,
38    "maxKeys": 1000
39}

操作失败

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

代码示例

具体代码示例参考：ExampleDescribeAppServerGroup.java

删除服务器组

函数声明

Plain Text

1public void deleteAppServerGroup(String blbId, String sgId) {
2}
3public void deleteAppServerGroup(AppSgRequest appSgRequest) {
4}

参数含义

请参考OpenAPI文档 deleteappservergroup删除服务器组请求参数

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleDeleteAppServerGroup.java

创建服务器组端口

函数声明

Plain Text

1public AppSgPortResponse createAppServerGroupPort(AppSgPortRequest appSgPortRequest) {
2}

参数含义

请参考OpenAPI文档 createappservergroupport创建应用型服务器组端口请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "id" : "port-0b2c33c9",
4    "status" : "available"
5}

操作失败

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

代码示例

具体代码示例参考：ExampleCreateAppServerGroupPort.java

更新服务器组端口

函数声明

Plain Text

1public void modifyAppServerGroupPortAttributes(AppSgPortRequest appSgPortRequest) {
2}

参数含义

请参考OpenAPI文档 updateappservergroupport更新服务器组端口请求参数

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleUpdateAppServerGroupPort.java

删除服务器组端口

函数声明

Plain Text

1public void deleteAppServerGroupPort(String blbId, String sgId, List<String> portIdList) {
2}
3public void deleteAppServerGroupPort(AppSgPortRequest appSgPortRequest) {
4}

参数含义

请参考OpenAPI文档 deleteappservergroupport删除服务器组端口请求参数

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleDeleteAppServerGroupPort.java

添加应用型BLB后端RS

函数声明

Plain Text

1public void createBlbRs(String blbId, String sgId, List<AppBackendServer> backendServerList) {
2}
3public void createBlbRs(AppSgRequest appSgRequest) {
4}

参数含义

请参考OpenAPI文档 createblbrs添加应用型blb后端rs请求参数

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleCreateBlbRs.java

更新服务器组下挂载的RS权重

函数声明

Plain Text

1public void modifyBlbRs(String blbId, String sgId, List<AppBackendServer> backendServerList) {
2}
3public void modifyBlbRs(AppSgRequest appSgRequest) {
4}

参数含义

请参考OpenAPI文档 updateblbrs更新服务器组下挂载的rs权重请求参数

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleUpdateBlbRs.java

查询服务器组下的RS列表信息

函数声明

Plain Text

1public ListAppRsResponse listBlbRs(String blbId, String sgId) {
2}
3public ListAppRsResponse listBlbRs(ListAppRsRequest listAppRsRequest) {
4}

参数含义

请参考OpenAPI文档 describeblbrs查询服务器组下的rs列表信息请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "backendServerList" : [ 
4        {
5            "instanceId" : "i-q9dlHUJm",
6            "weight" : 100,
7            "privateIp" : "192.168.16.11",
8            "portList" : [ 
9                {
10                    "listenerPort" : 80,
11                    "backendPort" : "80",
12                    "portType" : "HTTP",
13                    "healthCheckPortType" : "HTTP",
14                    "status" : "unknown",
15                    "policyId" : "policy-58b2c7bf"
16                }
17            ]
18        }
19    ],
20    "marker": "apprs-6458619E",
21    "nextMarker": null,
22    "isTruncated": false,
23    "maxKeys": 1000
24}

操作失败

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

代码示例

具体代码示例参考：ExampleDescribeBlbRs.java

删除服务器组下挂载的RS

函数声明

Plain Text

1public void deleteBlbRs(String blbId, String sgId, List<String> backendServerIdList) {
2}
3public void deleteBlbRs(AppRsRequest appRsRequest) {
4}

参数含义

请参考OpenAPI文档 deleteblbrs删除服务器组下挂载的rs请求参数

返回值

操作成功

无返回值

操作失败

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

代码示例

具体代码示例参考：ExampleDeleteBlbRs.java

查询服务器组下绑定的RS

函数声明

Plain Text

1public ListAppRsMountResponse listBlbRsMount(String blbId, String sgId) {
2}
3public ListAppRsMountResponse listBlbRsMount(ListAppRsRequest listAppRsRequest) {
4}

参数含义

请参考OpenAPI文档 describersmount查询服务器组下绑定的server请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "backendServerList" : [ 
4        {
5            "instanceId" : "i-q9dlHUJm",
6            "weight" : 100,
7            "privateIp" : "192.168.16.11",
8            "portList" : [ 
9                {
10                    "listenerPort" : 80,
11                    "backendPort" : "80",
12                    "portType" : "HTTP",
13                    "healthCheckPortType" : "HTTP",
14                    "status" : "unknown",
15                    "policyId" : "policy-58b2c7bf"
16                }
17            ]
18        }
19    ]
20}

操作失败

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

代码示例

具体代码示例参考：ExampleDescribeRsMount.java

查询服务器组下未绑定的RS

函数声明

Plain Text

1public ListAppRsUnMountResponse listBlbRsUnMount(String blbId, String sgId) {
2}
3public ListAppRsUnMountResponse listBlbRsUnMount(ListAppRsRequest listAppRsRequest) {
4}

参数含义

请参考OpenAPI文档 describersunmount查询服务器组下未绑定的rs请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "backendServerList" : [ 
4        {
5            "instanceId" : "i-q9dlHUJm",
6            "privateIp" : "192.168.16.11"
7        }
8    ]
9}

操作失败

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

代码示例

具体代码示例参考：ExampleDescribeRsUnMount.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异常列表

代码示例

具体代码示例参考：ExampleListAppBlbSg.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        {
5	        "enterpriseSecurityGroupId": "esg-g8z4qfj0m0bu",
6	        "enterpriseSecurityGroupName": "test0627",
7	        "enterpriseSecurityGroupDesc": "",
8	        "enterpriseSecurityGroupRules": [
9                {
10                    "remark": "全部协议",
11                    "direction": "egress",
12                    "action": "allow",
13                    "priority": 1000,
14                    "ethertype": "IPv6",
15                    "portRange": "",
16                    "sourceIp": "",
17                    "destIp": "all",
18                    "enterpriseSecurityGroupRuleId": "esgr-9tzd4yijcwqu",
19                    "protocol": "all"
20		        },
21		        {
22                    "remark": "",
23                    "direction": "egress",
24                    "action": "allow",
25                    "priority": 1000,
26                    "ethertype": "IPv4",
27                    "portRange": "",
28                    "sourceIp": "",
29                    "destIp": "all",
30                    "enterpriseSecurityGroupRuleId": "esgr-9je09z6bd9wv",
31                    "protocol": "tcp"
32                },
33                {
34                    "remark": "",
35                    "direction": "ingress",
36                    "action": "allow",
37                    "priority": 1000,
38                    "ethertype": "IPv4",
39                    "portRange": "2",
40                    "sourceIp": "all",
41                    "destIp": "",
42                    "enterpriseSecurityGroupRuleId": "esgr-jcej4juqbh49",
43                    "protocol": "tcp"
44                }
45	        ]
46        }
47    ]
48}

操作失败

操作失败返回异常列表参考负载均衡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 }

普通型BLB实例

IPv6型BLB实例

负载均衡 BLB

应用型BLB实例

获取Endpoint

获取AK/SK

新建AppBlbClient

创建BLB实例

更新BLB实例

查询已有的BLB实例

查询BLB实例详情

释放BLB实例

创建TCP监听器

创建UDP监听器

创建HTTP监听器

创建HTTPS监听器

创建SSL监听器

更新TCP监听器

更新UDP监听器

更新HTTP监听器

更新HTTPS监听器

更新SSL监听器

查询TCP监听器

查询UDP监听器

查询HTTP监听器

查询HTTPS监听器

查询SSL监听器

查询所有监听器

释放监听器

创建策略

查询策略列表

删除策略

创建应用型服务器组

更新服务器组

查询服务器组列表

删除服务器组

创建服务器组端口

更新服务器组端口

删除服务器组端口

添加应用型BLB后端RS

更新服务器组下挂载的RS权重

查询服务器组下的RS列表信息

删除服务器组下挂载的RS

查询服务器组下绑定的RS

查询服务器组下未绑定的RS

绑定普通安全组

解绑普通安全组

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

绑定企业安全组

解绑企业安全组

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

附录