LBDC实例相关接口

更新时间：2024-06-11

创建LBDC

请求结构

POST /v{version}/lbdc?clientToken={clientToken} HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: authorization string
 {
	"name": name,
	"type": type,
	"ccuCount": ccuCount,
    "desc": desc,
    "billing": {
        "paymentTiming": paymentTiming,  
		"reservation" : {
        	"reservationLength": reservationLength
         }
    },
	"renewReservation":{
    	"reservationLength": reservationLength
    },
    "tags": [
        {
          "tagKey": "hikwnf",
          "tagValue": "nwklwmflk"
        }
    ]
 }

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1
clientToken	String	否	Query参数	幂等性Token，是一个长度不超过64位的ASCII字符串
name	String	是	RequestBody参数	集群名称，长度1~65个字节，字母开头，_可包含字母数字-/.字符
type	String	是	RequestBody参数	集群类型，取值为"4Layer"或者"7Layer"
ccuCount	int	是	RequestBody参数	集群性能容量单位CCU（Cluster Capacity Unit）是用来衡量BLB集群处理流量时涉及的各个指标。
desc	String	否	RequestBody参数	LBDC的描述，最大支持200字符
billing	BillingForCreate	是	RequestBody参数	订单信息
renewReservation	ReservationForCreate	否	RequestBody参数	自动续费信息，是否开启自动续费任务
tags	List<Tag>	否	RequestBody参数	标签

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称	类型	描述
id	String	集群id
type	String	集群类型
desc	String	描述信息

请求示例

POST /v1/lbdc?clientToken=1849ef6b-f73c-4f5d-b88b-259ca47af849 HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2020-07-14T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
    "name": "abc",
	"type": "4Layer",
	"ccuCount": 1,
    "desc": "",
    "billing": {
        "paymentTiming": "Prepaid",  
		"reservation" : {
        	"reservationLength": 1
         }
     },
	"renewReservation":{
    	"reservationLength": 1
    },
    "tags": [
        {
          "tagKey": "hikwnf",
          "tagValue": "nwklwmflk"
        }
    ]
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Tus, 14 Jul 2020 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

 {
    "id": "bgw_group-a3t786p1",
	"name": "abc",
	"type": "4Layer",
	"desc":""
 }

升级LBDC

请求结构

PUT /v{version}/lbdc/{id}?{action}&clientToken={clientToken} HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: authorization string
 {
	"ccuCount": ccuCount
 }

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1
id	String	是	URL参数	升级的集群id
clientToken	String	否	Query参数	幂等性Token，是一个长度不超过64位的ASCII字符串
action	String	是	Query参数	本接口中该参数取值resize
ccuCount	int	是	RequestBody参数	集群性能容量单位CCU（Cluster Capacity Unit）是用来衡量BLB集群处理流量时涉及的各个指标。

返回头域

除公共头域，无其它特殊头域。

返回参数

无特殊返回参数

请求示例

PUT /v1/lbdc/bgw_group-a3t786p1?resize&clientToken=1849ef6b-f73c-4f5d-b88b-259ca47af849 HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2020-07-14T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
	"ccuCount": 1
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Tus, 14 Jul 2020 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

续费LBDC

请求结构

PUT /v{version}/lbdc/{id}?{action}&clientToken={clientToken} HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: authorization string
 {
	"billing":{
    	"reservation":{
        	"reservationLength": reservationLength
    	}
	}
 }

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1
id	String	是	URL参数	续费的集群id
clientToken	String	否	Query参数	幂等性Token，是一个长度不超过64位的ASCII字符串
action	String	是	Query参数	本接口中该参数取值purchaseReserved
billing	BillingForRenew	是	RequestBody参数	订单信息

返回头域

除公共头域，无其它特殊头域。

返回参数

无特殊返回参数

请求示例

PUT /v1/lbdc/bgw_group-a3t786p1?purchaseReserved&clientToken=1849ef6b-f73c-4f5d-b88b-259ca47af849 HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2020-07-14T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
	"billing":{
    	"reservation":{
        	"reservationLength":1
    	}
	}
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Tus, 14 Jul 2020 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

LBDC列表

请求结构

GET /v{version}/lbdc?id={id}&name={name} HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1
id	String	否	Query参数	要查询的集群id
name	String	否	Query参数	要查询的集群名称

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称	类型	描述
marker	String	标记查询的起始位置
isTruncated	boolean	true表示后面还有数据，false表示已经是最后一页
nextMarker	String	获取下一页所需要传递的marker值。当isTruncated为false时，该域不出现
maxKeys	int	每页包含的最大数量
clusterList	List<ClusterModel>	包含查询结果的LBDC列表

请求示例

GET /v1/lbdc?id=bgw_group-a3t786p1 HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2020-07-14T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Tus, 14 Jul 2020 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS


{
	"clusterList": [
    	{
        	"id": "bgw_group-a3t786p1",
        	"name": "abc",
        	"type": "4Layer",
			"status": "available",
        	"ccuCount": 1,
        	"createTime": "2021-08-25T06:13:09Z",
        	"expireTime": "2021-09-25T06:13:09Z",
        	"desc": ""
    	}
	],
	"marker": "bgw_group-a3t786p1",
	"nextMarker": null,
	"isTruncated": false,
	"maxKeys": 1000
}

LBDC详情

请求结构

GET /v{version}/lbdc/{id} HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1
id	String	是	URL参数	要查询的集群id

返回头域

除公共头域，无其它特殊头域。

4层返回参数

参数名称	类型	描述
id	String	集群id
name	String	集群名称
type	String	集群类型
status	String	集群状态
ccuCount	String	集群性能容量
createTime	String	集群创建时间
expireTime	String	集群失效时间
totalConnectCount	long	并发连接数
newConnectCps	long	新建连接速度
networkInBps	long	网络输入带宽
networkOutBps	long	网络输出带宽
tags	List<Tag>	标签

7层返回参数

参数名称	类型	描述
id	String	集群id
name	String	集群名称
type	String	集群类型
status	String	集群状态
ccuCount	String	集群性能容量
createTime	String	集群创建时间
expireTime	String	集群失效时间
totalConnectCount	long	并发连接数
networkInBps	long	网络输入带宽
networkOutBps	long	网络输出带宽
httpsQps	long	https的qps
httpQps	long	http的qps
httpNewConnectCps	long	http新建速度
httpsNewConnectCps	long	https新建速度
sslNewConnectCps	long	ssl新建速度
tags	List<Tag>	标签

请求示例

GET /v1/lbdc/bgw_group-a3t786p1 HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2020-07-14T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Tus, 14 Jul 2020 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS


{
	"id": "bgw_group-a3t786p1",
    "name": "abc",
    "type": "4Layer",
	"status": "available",
    "ccuCount": 1,
    "createTime": "2021-08-25T06:13:09Z",
    "expireTime": "2021-09-25T06:13:09Z",
    "desc": "",
	"totalConnectCount":100,
	"newConnectCps":100,
	"networkInBps":100,
	"networkOutBps":100,
    "tags": [
        {
          "tagKey": "hikwnf",
          "tagValue": "nwklwmflk"
        }
    ]
}

更新LBDC

请求结构

PUT /v{version}/lbdc/{id}?clientToken={clientToken} HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: authorization string

{
    "name":name,
    "desc":desc
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1
id	String	是	URL参数	集群id
clientToken	String	否	Query参数	幂等性Token，是一个长度不超过64位的ASCII字符串
name	String	否	RequestBody参数	集群名称。长度1~65个字节，字母开头，_可包含字母数字-/.字符。
desc	String	否	RequestBody参数	集群描述，最大支持200字符

返回头域

除公共头域，无其它特殊头域。

返回参数

无返回参数

请求示例

PUT /v1/lbdc/bgw_group-a3t786p1?clientToken=1849ef6b-f73c-4f5d-b88b-259ca47af849
Host: blb.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
	"name":"abc",
    "desc":""
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Thu, 16 Mar 2017 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

LBDC关联的BLB列表

请求结构

GET /v{version}/lbdc/{id}/blb HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1
id	String	否	URL参数	要查询的集群id

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称	类型	描述
blbList	List<AssociateBlbModel>	包含查询结果的BLB列表

请求示例

GET /v1/lbdc/bgw_group-a3t786p1/blb HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2020-07-14T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Tus, 14 Jul 2020 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS


{
	"blbList": [
    	{
        	"blbId": "lb-1c791997",
        	"name": "abc",
			"status": "available",
        	"blbType": "normal",
			"publicIp": "10.10.10.10",
        	"eipRouteType": "bgp",
        	"bandwidth": 20,
        	"address": "192.168.0.7",
        	"ipv6": "2400:da00:e003:1820::4",
        	"vpcId": "vpc-0n1hhh8759b0",
			"subnetId": "sbn-p09p0ihp7498"
    	}
	]
}

应用型IPv6BLB接口

服务发布点接口

百度智能云

负载均衡 BLB

负载均衡 BLB

LBDC实例相关接口

创建LBDC

升级LBDC

续费LBDC

LBDC列表

LBDC详情

更新LBDC

LBDC关联的BLB列表