普通型BLB安全组相关接口

更新时间：2025-01-03

BindSecurityGroups绑定普通安全组

描述

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

请求结构

PUT /v{version}/blb/{blbId}/securitygroup?{action}&clientToken={clientToken} HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: authorization string

{
    "securityGroupIds": securityGroupIds
}

请求头域

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

请求参数

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

返回状态码

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

返回头域

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

返回参数

无

请求示例

PUT /v1/blb/lb-j8UqijYf/securitygroup?bind&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
Host: blb.bj.baidubce.com
Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf16

{
	"securityGroupIds": ["g-4NxWoxeq", "g-4NxWoxea"]
}

响应示例

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

UnbindSecurityGroups解绑普通安全组

描述

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

请求结构

PUT /v{version}/blb/{blbId}/securitygroup?{action}&clientToken={clientToken} HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: authorization string

{
    "securityGroupIds": securityGroupIds
}

请求头域

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

请求参数

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

返回状态码

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

返回头域

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

返回参数

无

请求示例

PUT /v1/blb/lb-j8UqijYf/securitygroup?unbind&clientToken=be31b98c-5e41-4838-9830-9be700de5a21 HTTP/1.1
Host: blb.bj.baidubce.com
Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf17

{
	"securityGroupIds": ["g-4NxWoxeq", "g-4NxWoxea"]
}

响应示例

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

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

描述

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

请求结构

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

请求头域

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

请求参数

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

返回状态码

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

返回头域

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

返回参数

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

请求示例

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

响应示例

HTTP/1.1 200 OK
Server: nginx/1.19.0
Date: Thu, 28 Apr 2022 11:06:00 GMT
Content-Type: application/json; charset=UTF-8
X-Bce-Request-Id: dfd5d01f-a869-49eb-aba5-d853a3350428

{
    "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"
                }
            ]
        }
    ]
}

BindEnterpriseSecurityGroups绑定企业安全组

描述

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

请求结构

PUT /v{version}/blb/{blbId}/enterprise/securitygroup?{action}&clientToken={clientToken} HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: authorization string

{
    "enterpriseSecurityGroupIds": enterpriseSecurityGroupIds
}

请求头域

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

请求参数

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

返回状态码

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

返回头域

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

返回参数

无

请求示例

PUT /v1/blb/lb-j8UqijYf/enterprise/securitygroup?bind&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
Host: blb.bj.baidubce.com
Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf16

{
  "enterpriseSecurityGroupIds": ["esg-g8z4qfj0m0bu"]
}

响应示例

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

UnbindEnterpriseSecurityGroups解绑企业安全组

描述

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

请求结构

PUT /v{version}/blb/{blbId}/enterprise/securitygroup?{action}&clientToken={clientToken} HTTP/1.1
Host: blb.bj.baidubce.com
Authorization: authorization string

{
    "enterpriseSecurityGroupIds": enterpriseSecurityGroupIds
}

请求头域

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

请求参数

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

返回状态码

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

返回头域

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

返回参数

无

请求示例

PUT /v1/blb/lb-j8UqijYf/enterprise/securitygroup?unbind&clientToken=be31b98c-5e41-4838-9830-9be700de5a21 HTTP/1.1
Host: blb.bj.baidubce.com
Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf17

{
  "enterpriseSecurityGroupIds": ["esg-gzsqygs59nxp"]
}

响应示例

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

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

描述

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

请求结构

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

请求头域

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

请求参数

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

返回状态码

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

返回头域

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

返回参数

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

请求示例

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

响应示例

HTTP/1.1 200 OK
Server: nginx/1.19.0
Date: Thu, 28 Apr 2022 11:06:00 GMT
Content-Type: application/json; charset=UTF-8
X-Bce-Request-Id: dfd5d01f-a869-49eb-aba5-d853a3350428

{
  "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"
		}
	]}
}

普通型BLB后端服务器相关接口

应用型BLB接口

负载均衡 BLB

负载均衡 BLB

普通型BLB安全组相关接口

BindSecurityGroups绑定普通安全组

UnbindSecurityGroups解绑普通安全组

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

BindEnterpriseSecurityGroups绑定企业安全组

UnbindEnterpriseSecurityGroups解绑企业安全组

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