普通型blb实例

更新时间：2024-01-23

创建BLB

创建一个BLB实例，返回分配的服务地址及实例ID。付费方式为后付费。需要实名认证，若未通过实名认证可以前往百度智能云官网控制台中的安全认证下的实名认证中进行认证

使用以下代码可以创建BLB实例

函数声明

func (c *Client) CreateLoadBalancer(args *CreateLoadBalancerArgs) (*CreateLoadBalancerResult, error)

参数含义

请参考OpenAPI文档：CreateLoadBalancer创建实例

返回值

操作成功：

{
    "blbId": "lb-BLuOPSLZ",
    "name": "blb-for-test",
    "address": "192.168.0.24",
     "desc": "myblb"
}

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_create_loadbalancer.go

查询已有BLB实例

查询用户账户下所有LoadBalancer的信息，支持按LoadBalancer的Name、Address进行模糊查询，支持按LoadBalancer的ID进行精确查询，支持按bccId进行查询，目前只支持单个bccId查询，并且仅支持精确查询。查询结果为包含该后端服务器的负载均衡实例。返回结果是多重查询条件的交集。如果BLB实例开启了公网访问，返回结果将会带上公网IP。结果支持marker分页，分页大小默认为1000，可通过maxKeys参数指定

使用以下代码可以查询已有BLB实例

函数声明

func (c *Client) DescribeLoadBalancers(args *DescribeLoadBalancersArgs) (*DescribeLoadBalancersResult, error)

参数含义

请参考OpenAPI文档：DescribeLoadBalancers查询已有的BLB实例

返回值

操作成功：

{
    "blbList": [
        {
            "blbId": "lb-a7e5zPPk",
            "status": available,
            "name": "test-blb",
            "desc": desc,
            "address": "192.168.0.23"
        },
        {
            "blbId": "lb-gj5gVpeq",
            "status": available,
            "name": "nametest",
            "desc": desc,
            "address": "192.168.0.24",
            "publicIp": "123.2.3.4"
        }
    ],
    "marker": "blb-0A20F971",
    "nextMarker": "blb-0A20FB09",
    "isTruncated": true,
    "maxKeys": 2
}

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_describe_loadbalancers.go

查询BLB实例详情

按ID查询用户账户下所有LoadBalancer的详细信息，包含LoadBalancer所有的监听器端口信息

使用以下代码可以查询BLB实例详情

函数声明

func (c *Client) DescribeLoadBalancerDetail(blbId string) (*DescribeLoadBalancerDetailResult, error)

参数含义

请参考OpenAPI文档：DescribeLoadBalancerDetail查询BLB实例详情

返回值

操作成功：

{
    "blbId":"lb-gj5gVpeq",
    "status":"available",
    "name":"nametest", 
    "desc":"",     
    "address":"192.168.0.2", 
    "publicIp":"123.2.3.4", 
    "cidr":"192.168.0.0/16", 
    "vpcName":"test",         
    "createTime":"2019-03-07T02:35:31Z",    
    "releaseTime":"2019-03-07T02:35:31Z",   
    "listener":[                            
    {
        "port":80,                      
        "backendPort":90,               
        "type": "TCP",                  
        "healthCheckType": "TCP",       
        "healthCheckstatus": "Alive"       
    }
    ]
}

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_describe_loadbalancer_detail.go

更新BLB

更新指定的单个LoadBalancer配置信息，包括LoadBalancer实例的名称和描述

使用以下代码可以更新BLB实例

函数声明

func (c *Client) UpdateLoadBalancer(blbId string, args *UpdateLoadBalancerArgs) error

参数含义

请参考OpenAPI文档：UpdateLoadBalancer更新实例

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_update_loadbalancer.go

删除BLB

释放指定LoadBalancer，被释放的LoadBalancer无法找回

使用以下代码可以删除BLB实例

函数声明

func (c *Client) DeleteLoadBalancer(blbId string) error

参数含义

请参考OpenAPI文档：DeleteLoadBalancer释放BLB实例

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_delete_loadbalancer.go

更新BLB ACL开关

更新指定的LoadBalancer是否支持ACL功能，支持更新类型（普通型、应用型、IPv6型）

使用以下代码可以更新BLB ACL开关

函数声明

func (c *Client) UpdateLoadBalancerAcl(blbId string, args *UpdateLoadBalancerAclArgs) error

参数含义

请参考OpenAPI文档：UpdateLoadBalancerAcl更新实例ACL功能

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_update_loadbalancer_acl.go

创建TCP监听器

在指定LoadBalancer下，创建一个基于TCP协议的监听器，监听一个前端端口，将发往该端口的所有TCP流量，转发到后端服务器监听的后端端口上。TCP监听器只支持TCP协议的健康检查，检查端口和后端服务器监听端口一致。

使用以下代码创建TCP监听器

函数声明

func (c *Client) CreateTCPListener(blbId string, args *CreateTCPListenerArgs) error

参数含义

请参考OpenAPI文档：CreateTCPListener创建TCP监听器

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_create_tcp_listener.go

创建UDP监听器

在指定LoadBalancer下，创建一个基于UDP协议的监听器，监听一个前端端口，将发往该端口的所有UDP流量，转发到后端服务器监听的后端端口上。UDP监听器支持UDP、ICMP协议的健康检查，检查端口和后端服务器监听端口一致。

使用以下代码创建UDP监听器

函数声明

func (c *Client) CreateUDPListener(blbId string, args *CreateUDPListenerArgs) error

参数含义

请参考OpenAPI文档：CreateUDPListener创建UDP监听器

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_create_udp_listener.go

创建HTTP监听器

在指定LoadBalancer下，创建一个基于HTTP协议的监听器，监听一个前端端口，将发往该端口的所有HTTP请求，转发到后端服务器监听的后端端口上。

使用以下代码创建HTTP监听器

函数声明

func (c *Client) CreateHTTPListener(blbId string, args *CreateHTTPListenerArgs) error

参数含义

请参考OpenAPI文档：CreateHTTPListener创建HTTP监听器

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_create_http_listener.go

创建HTTPS监听器

在指定LoadBalancer下，创建一个基于HTTPS协议的监听器，监听一个前端端口，将发往该端口的所有HTTPS请求，先通过SSL卸载转换为HTTP请求后，再转发到后端服务器监听的后端端口上。

使用以下代码创建HTTPS监听器

函数声明

func (c *Client) CreateHTTPSListener(blbId string, args *CreateHTTPSListenerArgs) error

参数含义

请参考OpenAPI文档：CreateHTTPSListener创建HTTPS监听器

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_create_https_listener.go

创建SSL监听器

在指定LoadBalancer下，创建一个基于SSL协议的监听器，监听一个前端端口，将发往该端口的所有SSL流量，通过SSL卸载转换为TCP请求后转发到后端服务器监听的后端端口上。SSL监听器只支持TCP协议的健康检查，检查端口和后端服务器监听端口一致。

使用以下代码创建SSL监听器

函数声明

func (c *Client) CreateSSLListener(blbId string, args *CreateSSLListenerArgs) error

参数含义

请参考OpenAPI文档：CreateSSLListener创建SSL监听器

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_create_ssl_listener.go

查询TCP监听器

查询指定LoadBalancer下所有TCP监听器的信息，支持按监听器端口进行匹配查询，结果支持marker分页，分页大小默认为1000，可通过maxKeys参数指定

使用以下代码可以查询tcp监听器

函数声明

func (c *Client) DescribeTCPListeners(blbId string, args *DescribeListenerArgs) (*DescribeTCPListenersResult, error)

参数含义

请参考OpenAPI文档：DescribeTCPListeners查询TCP监听器

返回值

操作成功：

{
    "listenerList": [
        {
            "listenerPort": 80,
            "backendPort": 80,
            "scheduler": "RoundRobin",
            "healthCheckTimeoutInSecond": 3,
            "healthCheckInterval": 3,
            "unhealthyThreshold": 3,
            "healthyThreshold": 3
        },
        {
            "listenerPort": 88,
            "backendPort": 88,
            "scheduler": "RoundRobin",
            "healthCheckTimeoutInSecond": 2,
            "healthCheckInterval": 4,
            "unhealthyThreshold": 3,
            "healthyThreshold": 3
        }
    ],
    "marker": "listener-0050",
    "nextMarker": null,
    "isTruncated": false,
    "maxKeys": 2
}

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_describe_tcp_listeners.go

查询UDP监听器

查询指定LoadBalancer下所有UDP监听器的信息，支持按监听器端口进行匹配查询，结果支持marker分页，分页大小默认为1000，可通过maxKeys参数指定

使用以下代码可以查询UDP监听器

函数声明

func (c *Client) DescribeUDPListeners(blbId string, args *DescribeListenerArgs) (*DescribeUDPListenersResult, error)

参数含义

请参考OpenAPI文档：DescribeUDPListeners查询UDP监听器

返回值

操作成功：

{
    "listenerList": [
        {
            "listenerPort": 80,
            "backendPort": 80,
            "scheduler": "RoundRobin",
            "healthCheckType": "UDP",
            "healthCheckTimeoutInSecond": 3,
            "healthCheckInterval": 3,
            "unhealthyThreshold": 3,
            "healthyThreshold": 3,
            "healthCheckString":"healthCheck",
            "udpSessionTimeout":90
        },
        {
            "listenerPort": 88,
            "backendPort": 88,
            "scheduler": "RoundRobin",
            "healthCheckType": "UDP",
            "healthCheckTimeoutInSecond": 2,
            "healthCheckInterval": 4,
            "unhealthyThreshold": 3,
            "healthyThreshold": 3,
            "healthCheckString":"healthCheck",
            "udpSessionTimeout": 90
        }
    ],
    "marker": "listener-0050",
    "nextMarker": null,
    "isTruncated": false,
    "maxKeys": 2
}

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_describe_udp_listeners.go

查询HTTP监听器

查询指定LoadBalancer下所有HTTP监听器的信息，支持按监听器端口进行匹配查询，结果支持marker分页，分页大小默认为1000，可通过maxKeys参数指定。

使用以下代码可以查询应用型HTTP监听器信息

函数声明

func (c *Client) DescribeHTTPListeners(blbId string, args *DescribeListenerArgs) (*DescribeHTTPListenersResult, error)

参数含义

请参考OpenAPI文档：DescribeHTTPListeners查询HTTP监听器

返回值

操作成功：

{
    "listenerList": [
        {
            "listenerPort": 90,
            "backendPort": 90,
            "scheduler": "LeastConnection",
            "healthCheckTimeoutInSecond": 4,
            "healthCheckInterval": 5,
            "unhealthyThreshold": 2,
            "healthyThreshold": 3,
            "keepSession": false,
            "keepSessionType": null,
            "keepSessionDuration": null,
            "keepSessionCookieName": null,
            "xForwardFor": false,
            "healthCheckType": "HTTP",
            "healthCheckPort": 90,
            "healthCheckURI": "/",
            "healthCheckNormalStatus": "http_2xx|http_3xx",
            "serverTimeout": 30,
   "redirectPort": 80
        },
        {
            "listenerPort": 95,
            "backendPort": 95,
            "scheduler": "LeastConnection",
            "healthCheckTimeoutInSecond": 4,
            "healthCheckInterval": 5,
            "unhealthyThreshold": 2,
            "healthyThreshold": 3,
            "keepSession": false,
            "keepSessionType": null,
            "keepSessionDuration": null,
            "keepSessionCookieName": null,
            "xForwardFor": false,
            "healthCheckType": "HTTP",
            "healthCheckPort": 95,
            "healthCheckURI": "/",
            "healthCheckNormalStatus": "http_1xx|http_2xx",
            "serverTimeout": 1800,
   "redirectPort": 80
        }
    ],
    "marker": "listener-005A",
    "nextMarker": "listener-0322",
    "isTruncated": true,
    "maxKeys": 2
}

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_describe_http_listeners.go

查询HTTPS监听器

查询指定LoadBalancer下所有HTTPS监听器的信息，支持按监听器端口进行匹配查询，结果支持marker分页，分页大小默认为1000，可通过maxKeys参数指定。

使用以下代码可以查询应用型HTTPS监听器信息

函数声明

func (c *Client) DescribeHTTPSListeners(blbId string, args *DescribeListenerArgs) (*DescribeHTTPSListenersResult, error)

参数含义

请参考OpenAPI文档：DescribeHTTPSListeners查询HTTPS监听器

返回值 操作成功：

{
    "listenerList": [
        {
            "listenerPort": 90,
            "backendPort": 90,
            "scheduler": "LeastConnection",
            "healthCheckTimeoutInSecond": 4,
            "healthCheckInterval": 5,
            "unhealthyThreshold": 2,
            "healthyThreshold": 3,
            "keepSession": false,
            "keepSessionType": null,
            "keepSessionDuration": null,
            "keepSessionCookieName": null,
            "xForwardFor": false,
            "healthCheckType": "HTTP",
            "healthCheckPort": 90,
            "healthCheckURI": "/",
            "healthCheckNormalStatus": "http_2xx|http_3xx",
            "serverTimeout": 30,
   "certIds": ["cert-zfj2ey2z4kmm"]
        },
        {
            "listenerPort": 95,
            "backendPort": 95,
            "scheduler": "LeastConnection",
            "healthCheckTimeoutInSecond": 4,
            "healthCheckInterval": 5,
            "unhealthyThreshold": 2,
            "healthyThreshold": 3,
            "keepSession": false,
            "keepSessionType": null,
            "keepSessionDuration": null,
            "keepSessionCookieName": null,
            "xForwardFor": false,
            "healthCheckType": "HTTP",
            "healthCheckPort": 95,
            "healthCheckURI": "/",
            "healthCheckNormalStatus": "http_1xx|http_2xx",
            "serverTimeout": 1800,
   "certIds": ["cert-zfj2ey2z4kmm"]
        }
    ],
    "marker": "listener-005A",
    "nextMarker": "listener-0322",
    "isTruncated": true,
    "maxKeys": 2
}

操作失败：

抛出异常，异常列表参考：异常列表 代码示例

具体代码示例参考：example_describe_https_listeners.go

查询SSL监听器

查询指定LoadBalancer下所有SSL监听器的信息，支持按监听器端口进行匹配查询，结果支持marker分页，分页大小默认为1000，可通过maxKeys参数指定

使用以下代码可以查询SSL监听器

函数声明

func (c *Client) DescribeSSLListeners(blbId string, args *DescribeListenerArgs) (*DescribeSSLListenersResult, error)

参数含义

请参考OpenAPI文档：DescribeSSLListeners查询SSL监听器

返回值

操作成功：

{
    "listenerList": [
        {
            "listenerPort": 80,
            "backendPort": 80,
            "scheduler": "RoundRobin",
            "healthCheckTimeoutInSecond": 3,
            "healthCheckInterval": 3,
            "unhealthyThreshold": 3,
            "healthyThreshold": 3
        },
        {
            "listenerPort": 88,
            "backendPort": 88,
            "scheduler": "RoundRobin",
            "healthCheckTimeoutInSecond": 2,
            "healthCheckInterval": 4,
            "unhealthyThreshold": 3,
            "healthyThreshold": 3
        }
    ],
    "marker": "listener-0050",
    "nextMarker": null,
    "isTruncated": false,
    "maxKeys": 2
}

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_describe_ssl_listeners.go

查询所有监听器

查询指定LoadBalancer下所有监听器的信息，支持按监听器端口进行匹配查询，结果支持marker分页，分页大小默认为1000，可通过maxKeys参数指定

使用以下代码可以查询所有监听器

函数声明

func (c *Client) DescribeAllListeners(blbId string, args *DescribeListenerArgs) (*DescribeAllListenersResult, error)

参数含义

请参考OpenAPI文档：DescribeAllListeners查询所有监听

返回值

操作成功：

{
    "nextMarker": "",
    "marker": "",
    "maxKeys": 1,
    "isTruncated": true,
    "listenerList": [
        {
        "listenerPort": 53,
        "backendPort": 53,
        "scheduler": "RoundRobin",
        "healthCheckTimeoutInSecond": 3,
        "healthCheckInterval": 3,
        "unhealthyThreshold": 3,
        "healthyThreshold": 3,
        "getBlbIp": false,
        "listenerType": "UDP",
        "udpSessionTimeout": 90,
        "healthCheckString": "\\00\\01\\01\\00\\00\\01\\00\\00\\00\\00\\00\\00\\05baidu\\03com\\00\\00\\01\\00\\01",
        "healthCheckType": "UDP"
    },
    {
        "listenerPort": 82,
        "backendPort": 80,
        "scheduler": "RoundRobin",
        "healthCheckTimeoutInSecond": 3,
        "healthCheckInterval": 3,
        "unhealthyThreshold": 3,
        "healthyThreshold": 3,
        "getBlbIp": false,
        "listenerType": "TCP",
        "tcpSessionTimeout": 900
    },
    {
        "listenerPort": 87,
        "backendPort": 80,
        "scheduler": "RoundRobin",
        "healthCheckTimeoutInSecond": 3,
        "healthCheckInterval": 3,
        "unhealthyThreshold": 3,
        "healthyThreshold": 3,
        "getBlbIp": false,
        "listenerType": "HTTP",
        "keepSession": false,
        "xForwardFor": true,
        "healthCheckType": "HTTP",
        "healthCheckPort": 80,
        "healthCheckURI": "/",
        "healthCheckNormalStatus": "http_2xx|http_3xx",
        "healthCheckHost": "",
        "serverTimeout": 30,
        "redirectPort": 0
    },
    {
        "listenerPort": 443,
        "backendPort": 80,
        "scheduler": "RoundRobin",
        "healthCheckTimeoutInSecond": 3,
        "healthCheckInterval": 3,
        "unhealthyThreshold": 3,
        "healthyThreshold": 3,
        "getBlbIp": false,
        "listenerType": "HTTPS",
        "keepSession": false,
        "xForwardFor": true,
        "healthCheckType": "HTTP",
        "healthCheckPort": 80,
        "healthCheckURI": "/",
        "healthCheckNormalStatus": "http_2xx|http_3xx",
        "healthCheckHost": "",
        "serverTimeout": 30,
        "certIds": [
            "cert-gs8bktrm7drp"
        ],
        "dualAuth": false,
        "encryptionType": "tls_cipher_policy_1_2_secure",
        "encryptionProtocols": [
            "tlsv12"
        ],
        "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"
    },
    {
        "listenerPort": 446,
        "backendPort": 80,
        "scheduler": "RoundRobin",
        "healthCheckTimeoutInSecond": 3,
        "healthCheckInterval": 3,
        "unhealthyThreshold": 3,
        "healthyThreshold": 3,
        "getBlbIp": false,
        "listenerType": "SSL",
        "certIds": [
            "cert-gs8bktrm7drp"
        ],
        "dualAuth": true,
        "clientCertIds": [
            "cert-0x037gwe4fmg"
        ],
        "encryptionType": "tls_cipher_policy_default",
        "encryptionProtocols": [
            "tlsv10",
            "tlsv11",
            "tlsv12"
        ],
        "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"
    }
    ]
}

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_describe_all_listeners.go

更新TCP监听器

更新指定LoadBalancer下的TCP监听器参数，请求参数中所有指定的字段都会被更新，未指定的字段保持不变，监听器通过端口指定。

使用以下代码更新TCP监听器

函数声明

func (c *Client) UpdateTCPListener(blbId string, args *UpdateTCPListenerArgs) error

参数含义

请参考OpenAPI文档：UpdateTCPListener更新TCP监听器

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_update_tcp_listener.go

更新UDP监听器

更新指定LoadBalancer下的UDP监听器参数，所有请求参数中指定的域都会被更新，未指定的域保持不变，监听器通过端口指定。

使用以下代码更新UDP监听器

函数声明

func (c *Client) UpdateUDPListener(blbId string, args *UpdateUDPListenerArgs) error

参数含义

请参考OpenAPI文档：UpdateUDPListener更新UDP监听器

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_update_udp_listener.go

更新HTTP监听器

更新指定LoadBalancer下的HTTP监听器参数，所有请求参数中指定的域都会被更新，未指定的域保持不变，监听器通过端口指定。

使用以下代码更新HTTP监听器

函数声明

func (c *Client) UpdateHTTPListener(blbId string, args *UpdateHTTPListenerArgs) error

参数含义

请参考OpenAPI文档：UpdateHTTPListener更新HTTP监听器

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_update_http_listener.go

更新HTTPS监听器

更新指定LoadBalancer下的HTTPS监听器参数，所有请求参数中指定的域都会被更新，未指定的域保持不变，监听器通过端口指定。

使用以下代码更新HTTPS监听器

函数声明

func (c *Client) UpdateHTTPSListener(blbId string, args *UpdateHTTPSListenerArgs) error

参数含义

请参考OpenAPI文档：UpdateHTTPSListener更新HTTPS监听器

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_update_https_listener.go

更新SSL监听器

更新指定LoadBalancer下的SSL监听器参数，所有请求参数中指定的域都会被更新，未指定的域保持不变，监听器通过端口指定。

使用以下代码更新SSL监听器

函数声明

func (c *Client) UpdateSSLListener(blbId string, args *UpdateSSLListenerArgs) error

参数含义

请参考OpenAPI文档：UpdateSSLListener更新SSL监听器

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_update_ssl_listener.go

释放监听器

释放指定LoadBalancer下的监听器，监听器通过监听端口来指定；支持批量释放

使用以下代码可以释放监听器

函数声明

func (c *Client) DeleteListeners(blbId string, args *DeleteListenersArgs) error

参数含义

请参考OpenAPI文档：DeleteListeners释放监听器

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_delete_listeners.go

添加后端服务器

为指定LoadBalancer添加后端服务器，支持批量添加

使用以下代码可以添加后端服务器

函数声明

func (c *Client) AddBackendServers(blbId string, args *AddBackendServersArgs) error

参数含义

请参考OpenAPI文档：AddBackendServers添加后端服务器

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_add_backend_servers.go

查询后端服务器健康状态

查询指定LoadBalancer下的后端服务器信息，需要指定监听端口，结果会返回后端服务器的健康状态；结果支持marker分页，分页大小默认为1000，可通过maxKeys参数指定

使用以下代码可以查询后端服务器健康状态

函数声明

func (c *Client) DescribeHealthStatus(blbId string, args *DescribeHealthStatusArgs) (*DescribeHealthStatusResult, error)

参数含义

请参考OpenAPI文档：DescribeHealthStatus查询后端服务器健康状态

返回值

操作成功：

{
    "backendServerList": [
        {
            "instanceId": "i-YfAixxxx",
            "weight": 50,
            "status": "Alive"
        }
    ],
    "type": "TCP",
    "listenerPort": 80,
    "backendPort": 80,
    "marker": "rs-0A6BE9BB",
    "isTruncated": false,
    "maxKeys": 1000
}

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_describe_health_status.go

查询后端服务器列表

查询指定LoadBalancer下的后端服务器列表；结果支持marker分页，分页大小默认为1000，可通过maxKeys参数指定

使用以下代码可以查询后端服务器列表

函数声明

func (c *Client) DescribeBackendServers(blbId string, args *DescribeBackendServersArgs) (*DescribeBackendServersResult, error)

参数含义

请参考OpenAPI文档：DescribeBackendServers查询后端服务器列表

返回值

操作成功：

{
    "backendServerList": [
        {
            "instanceId": "i-YfAxxxx",
            "weight": 50,
        }
    ],
    "marker": "rs-0A6BE9BB",
    "isTruncated": false,
    "maxKeys": 1000
}

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_describe_backend_servers.go

更新后端服务器

更新指定LoadBalancer下的后端服务器权重，支持批量修改

使用以下代码可以更新后端服务器

函数声明

func (c *Client) UpdateBackendServers(blbId string, args *UpdateBackendServersArgs) error

参数含义

请参考OpenAPI文档：UpdateBackendServers更新后端服务器

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_update_backend_servers.go

释放后端服务器

释放指定LoadBalancer下的后端服务器，后端服务器通过其标识符指定；支持批量释放

使用以下代码可以释放后端服务器

函数声明

func (c *Client) RemoveBackendServers(blbId string, args *RemoveBackendServersArgs) error

参数含义

请参考OpenAPI文档：RemoveBackendServers释放后端服务器

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_remove_backend_servers.go

绑定普通安全组

为指定LoadBalancer（普通型、应用型、IPv6型）绑定普通安全组，支持批量绑定

使用以下代码可以为指定LoadBalancer绑定普通安全组

函数声明

func (c *Client) BindSecurityGroups(blbId string, args *UpdateSecurityGroupsArgs) error

参数含义

请参考OpenAPI文档：BindSecurityGroups绑定普通安全组

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_bind_security_groups.go

解绑普通安全组

为指定LoadBalancer（普通型、应用型、IPv6型）解绑普通安全组，支持批量解绑

使用以下代码可以为指定LoadBalancer解绑普通安全组

函数声明

func (c *Client) UnbindSecurityGroups(blbId string, args *UpdateSecurityGroupsArgs) error

参数含义

请参考OpenAPI文档：UnbindSecurityGroups解绑普通安全组

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_unbind_security_groups.go

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

按ID查询用户账户下指定LoadBalancer的普通安全组信息

使用以下代码可以按ID查询用户账户下指定LoadBalancer的普通安全组信息

函数声明

func (c *Client) DescribeSecurityGroups(blbId string) (*DescribeSecurityGroupsResult, error)

参数含义

请参考OpenAPI文档： DescribeSecurityGroups查询BLB实例普通安全组列表

返回值

操作成功：

{
    "blbSecurityGroups": [
        {
            "securityGroupDesc": "", 
            "securityGroupId": "g-4NxWoxeq", 
            "securityGroupName": "securitygroup-name",
            "vpcName":"vpc-name",
            "securityGroupRules": [
                {
                    "destGroupId": "", 
                    "destIp": "all", 
                    "direction": "egress", 
                    "ethertype": "IPv4", 
                    "portRange": "1-65535", 
                    "protocol": "all", 
                    "securityGroupRuleId": "r-gkv8yupumvx2"
                }
            ]
        }
    ]
}

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_describe_security_groups.go

绑定企业安全组

为指定LoadBalancer（普通型、应用型、IPv6型）绑定企业安全组，支持批量绑定

使用以下代码可以为指定LoadBalancer绑定企业安全组

函数声明

func (c *Client) BindEnterpriseSecurityGroups(blbId string, args *UpdateEnterpriseSecurityGroupsArgs) error

参数含义

请参考OpenAPI文档： BindEnterpriseSecurityGroups绑定企业安全组

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_bind_enterprise_security_groups.go

解绑企业安全组

为指定LoadBalancer（普通型、应用型、IPv6型）解绑企业安全组，支持批量解绑

使用以下代码可以为指定LoadBalancer解绑企业安全组

函数声明

func (c *Client) UnbindEnterpriseSecurityGroups(blbId string, args *UpdateEnterpriseSecurityGroupsArgs) error

参数含义

请参考OpenAPI文档： UnbindEnterpriseSecurityGroups解绑企业安全组

返回值

操作成功：

返回200

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_unbind_enterprise_security_groups.go

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

按ID查询用户账户下指定LoadBalancer的企业安全组信息

使用以下代码可以按ID查询用户账户下指定LoadBalancer的企业安全组信息

函数声明

func (c *Client) DescribeEnterpriseSecurityGroups(blbId string) (*DescribeEnterpriseSecurityGroupsResult, error)

参数含义

请参考OpenAPI文档：DescribeEnterpriseSecurityGroups查询BLB实例企业安全组列表

返回值

操作成功：

{
  "enterpriseSecurityGroups": [{
    "enterpriseSecurityGroupId": "esg-g8z4qfj0m0bu",
    "enterpriseSecurityGroupName": "test0627",
    "enterpriseSecurityGroupDesc": "",
    "enterpriseSecurityGroupRules": [{
            "remark": "全部协议",
            "direction": "egress",
            "action": "allow",
            "priority": 1000,
            "ethertype": "IPv6",
            "portRange": "",
            "sourceIp": "",
            "destIp": "all",
            "enterpriseSecurityGroupRuleId": "esgr-9tzd4yijcwqu",
            "protocol": "all"
        },
        {
            "remark": "",
            "direction": "egress",
            "action": "allow",
            "priority": 1000,
            "ethertype": "IPv4",
            "portRange": "",
            "sourceIp": "",
            "destIp": "all",
            "enterpriseSecurityGroupRuleId": "esgr-9je09z6bd9wv",
            "protocol": "tcp"
        },
        {
            "remark": "",
            "direction": "ingress",
            "action": "allow",
            "priority": 1000,
            "ethertype": "IPv4",
            "portRange": "2",
            "sourceIp": "all",
            "destIp": "",
            "enterpriseSecurityGroupRuleId": "esgr-jcej4juqbh49",
            "protocol": "tcp"
        }
    ]}
}

操作失败：

抛出异常，异常列表参考：异常列表

代码示例

具体代码示例参考：example_describe_enterprise_security_groups.go

初始化

应用型blb实例

负载均衡 BLB

负载均衡 BLB

普通型blb实例

创建BLB

查询已有BLB实例

查询BLB实例详情

更新BLB

删除BLB

更新BLB ACL开关

创建TCP监听器

创建UDP监听器

创建HTTP监听器

创建HTTPS监听器

创建SSL监听器

查询TCP监听器

查询UDP监听器

查询HTTP监听器

查询SSL监听器

查询所有监听器

更新TCP监听器

更新UDP监听器

更新HTTP监听器

更新HTTPS监听器

更新SSL监听器

释放监听器

添加后端服务器

查询后端服务器健康状态

查询后端服务器列表

更新后端服务器

释放后端服务器

绑定普通安全组

解绑普通安全组

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

绑定企业安全组

解绑企业安全组

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