应用型BLB安全组相关接口

更新时间：2025-08-21

BindSecurityGroups绑定普通安全组

描述

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

请求结构

Plain Text

1PUT /v{version}/blb/{blbId}/securitygroup?{action}&clientToken={clientToken} HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization: authorization string
4
5{
6    "securityGroupIds": securityGroupIds
7}

请求头域

除公共头域外，无其他特殊头域

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1
blbId	String	是	URL参数	所属LoadBalancer的标识符
clientToken	String	是	Query参数	幂等性Token，长度不超过64位
action	String	是	Query参数	本接口中该参数取值bind
securityGroupIds	List	是	RequestBody参数	绑定的普通安全组ID列表

返回状态码

成功返回200，失败返回见错误码

返回头域

除公共头域外，无其他特殊头域

返回参数

无

请求示例

Plain Text

1PUT /v1/blb/lb-j8UqijYf/securitygroup?bind&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf16
4
5{
6	"securityGroupIds": ["g-4NxWoxeq", "g-4NxWoxea"]
7}

响应示例

Plain Text

1HTTP/1.1 200 OK
2Server: nginx/1.19.0
3Date: Thu, 28 Apr 2022 11:06:00 GMT
4Content-Type: application/json; charset=UTF-8
5X-Bce-Request-Id: 70b6324a-7b10-4736-8872-4c29be8ef474

UnbindSecurityGroups解绑普通安全组

描述

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

请求结构

Plain Text

1PUT /v{version}/blb/{blbId}/securitygroup?{action}&clientToken={clientToken} HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization: authorization string
4
5{
6    "securityGroupIds": securityGroupIds
7}

请求头域

除公共头域外，无其他特殊头域

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1
blbId	String	是	URL参数	所属LoadBalancer的标识符
clientToken	String	是	Query参数	幂等性Token，长度不超过64位
action	String	是	Query参数	本接口中该参数取值unbind
securityGroupIds	List	是	RequestBody参数	解绑的普通安全组ID列表

返回状态码

成功返回200，失败返回见错误码

返回头域

除公共头域外，无其他特殊头域

返回参数

无

请求示例

Plain Text

1PUT /v1/blb/lb-j8UqijYf/securitygroup?unbind&clientToken=be31b98c-5e41-4838-9830-9be700de5a21 HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf17
4
5{
6	"securityGroupIds": ["g-4NxWoxeq", "g-4NxWoxea"]
7}

响应示例

Plain Text

1HTTP/1.1 200 OK
2Server: nginx/1.19.0
3Date: Thu, 28 Apr 2022 11:06:00 GMT
4Content-Type: application/json; charset=UTF-8
5X-Bce-Request-Id: 70b6324a-7b10-4736-8872-4c29be8ef478

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

描述

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

请求结构

Plain Text

1GET /v{version}/blb/{blbId}/securitygroup HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其他特殊头域

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1
blbId	String	是	URL参数	要查询的LoadBalancer的标识符

返回状态码

成功返回200，失败返回见错误码

返回头域

除公共头域外，无其他特殊头域

返回参数

参数名称	类型	描述
securityGroups	List<BlbSecurityGroupModel>	普通安全组信息，由BlbSecurityGroupModel组成的集合

请求示例

Plain Text

1GET /v1/blb/lb-j8UqijYf/securitygroup HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf16

响应示例

Plain Text

1HTTP/1.1 200 OK
2Server: nginx/1.19.0
3Date: Thu, 28 Apr 2022 11:06:00 GMT
4Content-Type: application/json; charset=UTF-8
5X-Bce-Request-Id: dfd5d01f-a869-49eb-aba5-d853a3350428
6
7{
8    "blbSecurityGroups": [
9        {
10            "securityGroupDesc": "", 
11            "securityGroupId": "g-4NxWoxeq", 
12            "securityGroupName": "securitygroup-name",
13            "vpcName":"vpc-name",
14            "securityGroupRules": [
15                {
16                    "destGroupId": "", 
17                    "destIp": "all", 
18                    "direction": "egress", 
19                    "ethertype": "IPv4", 
20                    "portRange": "1-65535", 
21                    "protocol": "all", 
22                    "securityGroupRuleId": "r-gkv8yupumvx2"
23                }
24            ]
25        }
26    ]
27}

BindEnterpriseSecurityGroups绑定企业安全组

描述

为指定LoadBalancer（普通型、应用型、IPv6型）绑定企业安全组（目前每个BLB实例最多支持绑定1个企业安全组）

请求结构

Plain Text

1PUT /v{version}/blb/{blbId}/enterprise/securitygroup?{action}&clientToken={clientToken} HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization: authorization string
4
5{
6    "enterpriseSecurityGroupIds": enterpriseSecurityGroupIds
7}

请求头域

除公共头域外，无其他特殊头域

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1
blbId	String	是	URL参数	所属LoadBalancer的标识符
clientToken	String	是	Query参数	幂等性Token，长度不超过64位
action	String	是	Query参数	本接口中该参数取值bind
enterpriseSecurityGroupIds	List	是	RequestBody参数	绑定的企业安全组ID列表

返回状态码

成功返回200，失败返回见错误码

返回头域

除公共头域外，无其他特殊头域

返回参数

无

请求示例

Plain Text

1PUT /v1/blb/lb-j8UqijYf/enterprise/securitygroup?bind&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf16
4
5{
6  "enterpriseSecurityGroupIds": ["esg-g8z4qfj0m0bu"]
7}

响应示例

Plain Text

1HTTP/1.1 200 OK
2Server: nginx/1.19.0
3Date: Thu, 28 Apr 2022 11:06:00 GMT
4Content-Type: application/json; charset=UTF-8
5X-Bce-Request-Id: 70b6324a-7b10-4736-8872-4c29be8ef474

UnbindEnterpriseSecurityGroups解绑企业安全组

描述

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

请求结构

Plain Text

1PUT /v{version}/blb/{blbId}/enterprise/securitygroup?{action}&clientToken={clientToken} HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization: authorization string
4
5{
6    "enterpriseSecurityGroupIds": enterpriseSecurityGroupIds
7}

请求头域

除公共头域外，无其他特殊头域

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1
blbId	String	是	URL参数	所属LoadBalancer的标识符
clientToken	String	是	Query参数	幂等性Token，长度不超过64位
action	String	是	Query参数	本接口中该参数取值unbind
enterpriseSecurityGroupIds	List	是	RequestBody参数	解绑的企业安全组ID列表

返回状态码

成功返回200，失败返回见错误码

返回头域

除公共头域外，无其他特殊头域

返回参数

无

请求示例

Plain Text

1PUT /v1/blb/lb-j8UqijYf/enterprise/securitygroup?unbind&clientToken=be31b98c-5e41-4838-9830-9be700de5a21 HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf17
4
5{
6  "enterpriseSecurityGroupIds": ["esg-gzsqygs59nxp"]
7}

响应示例

Plain Text

1HTTP/1.1 200 OK
2Server: nginx/1.19.0
3Date: Thu, 28 Apr 2022 11:06:00 GMT
4Content-Type: application/json; charset=UTF-8
5X-Bce-Request-Id: 70b6324a-7b10-4736-8872-4c29be8ef478

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

描述

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

请求结构

Plain Text

1GET /v{version}/blb/{blbId}/enterprise/securitygroup HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其他特殊头域

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1
blbId	String	是	URL参数	要查询的LoadBalancer的标识符

返回状态码

成功返回200，失败返回见错误码

返回头域

除公共头域外，无其他特殊头域

返回参数

参数名称	类型	描述
enterpriseSecurityGroups	List<BlbEnterpriseSecurityGroupModel>	企业安全组信息，由BlbEnterpriseSecurityGroupModel组成的集合

请求示例

Plain Text

1GET /v1/blb/lb-j8UqijYf/enterprise/securitygroup HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf16

响应示例

Plain Text

1HTTP/1.1 200 OK
2Server: nginx/1.19.0
3Date: Thu, 28 Apr 2022 11:06:00 GMT
4Content-Type: application/json; charset=UTF-8
5X-Bce-Request-Id: dfd5d01f-a869-49eb-aba5-d853a3350428
6
7{
8  "enterpriseSecurityGroups": [{
9	"enterpriseSecurityGroupId": "esg-g8z4qfj0m0bu",
10	"enterpriseSecurityGroupName": "test0627",
11	"enterpriseSecurityGroupDesc": "",
12	"enterpriseSecurityGroupRules": [{
13			"remark": "全部协议",
14			"direction": "egress",
15			"action": "allow",
16			"priority": 1000,
17			"ethertype": "IPv6",
18			"portRange": "",
19			"sourceIp": "",
20			"destIp": "all",
21			"enterpriseSecurityGroupRuleId": "esgr-9tzd4yijcwqu",
22			"protocol": "all"
23		},
24		{
25			"remark": "",
26			"direction": "egress",
27			"action": "allow",
28			"priority": 1000,
29			"ethertype": "IPv4",
30			"portRange": "",
31			"sourceIp": "",
32			"destIp": "all",
33			"enterpriseSecurityGroupRuleId": "esgr-9je09z6bd9wv",
34			"protocol": "tcp"
35		},
36		{
37			"remark": "",
38			"direction": "ingress",
39			"action": "allow",
40			"priority": 1000,
41			"ethertype": "IPv4",
42			"portRange": "2",
43			"sourceIp": "all",
44			"destIp": "",
45			"enterpriseSecurityGroupRuleId": "esgr-jcej4juqbh49",
46			"protocol": "tcp"
47		}
48	]}
49}

应用型BLB监听器相关接口

普通型IPv6BLB接口

负载均衡 BLB

负载均衡 BLB

应用型BLB安全组相关接口

BindSecurityGroups绑定普通安全组

UnbindSecurityGroups解绑普通安全组

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

BindEnterpriseSecurityGroups绑定企业安全组

UnbindEnterpriseSecurityGroups解绑企业安全组

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