Application IPv6 BLB Security Group Related Interfaces Description
Bind regular security group for specified LoadBalancer (standard, application and IPv6), supporting batch binding.
Request structure
1 PUT /v{version}/blb/{blbId}/securitygroup?action={action}&clientToken={clientToken} HTTP/1.1
2 Host: blb.bj.baidubce.com
3 Authorization: authorization string
4
5 {
6 "securityGroupIds": securityGroupIds
7 }
Request headers
No special headers beyond common headers.
Request parameters
Parameter name
Types
Whether required
Parameter location
Description
version
String
Yes
URL parameter
API version number, current value is 1.
blbId
String
Yes
URL parameter
LoadBalancer identifier
clientToken
String
Yes
Query
Idempotency Token, with length no more than 64 characters.
action
String
Yes
Query
Parameter value for this API: bind
securityGroupIds
List Yes
RequestBody
List of bound regular security group IDs
Response Status Code
Respond with 200 after successful operation, and respond with error codes after failed operation, as shown in [Error Codes](BLB/API Reference/Error code.md)
Response headers
No special headers beyond common headers.
Response parameters
None
Request example
1 PUT /v1/blb/lb-j8UqijYf/securitygroup?bind&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2 Host: blb.bj.baidubce.com
3 Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf16
4
5 {
6 "securityGroupIds": ["g-4NxWoxeq", "g-4NxWoxea"]
7 }
Response example
1 HTTP/1.1 200 OK
2 Server: nginx/1.19.0
3 Date: Thu, 28 Apr 2022 11:06:00 GMT
4 Content-Type: application/json; charset=UTF-8
5 X-Bce-Request-Id: 70b6324a-7b10-4736-8872-4c29be8ef474
Description
Unbind regular security group for specified LoadBalancer (standard, application and IPv6), supporting batch unbinding.
Request structure
1 PUT /v{version}/blb/{blbId}/securitygroup?action={action}&clientToken={clientToken} HTTP/1.1
2 Host: blb.bj.baidubce.com
3 Authorization: authorization string
4
5 {
6 "securityGroupIds": securityGroupIds
7 }
Request headers
No special headers beyond common headers.
Request parameters
Parameter name
Types
Whether required
Parameter location
Description
version
String
Yes
URL parameter
API version number, current value is 1.
blbId
String
Yes
URL parameter
LoadBalancer identifier
clientToken
String
Yes
Query
Idempotency Token, with length no more than 64 characters.
action
String
Yes
Query
Parameter value for this API: unbind
securityGroupIds
List Yes
RequestBody
List of unbound regular security group IDs
Response Status Code
Respond with 200 after successful operation, and respond with error codes after failed operation, as shown in [Error Codes](BLB/API Reference/Error code.md)
Response headers
No special headers beyond common headers.
Response parameters
None
Request example
1 PUT /v1/blb/lb-j8UqijYf/securitygroup?unbind&clientToken=be31b98c-5e41-4838-9830-9be700de5a21 HTTP/1.1
2 Host: blb.bj.baidubce.com
3 Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf17
4
5 {
6 "securityGroupIds": ["g-4NxWoxeq", "g-4NxWoxea"]
7 }
Response example
1 HTTP/1.1 200 OK
2 Server: nginx/1.19.0
3 Date: Thu, 28 Apr 2022 11:06:00 GMT
4 Content-Type: application/json; charset=UTF-8
5 X-Bce-Request-Id: 70b6324a-7b10-4736-8872-4c29be8ef478
Description
Query security group information of specified LoadBalancer under user account by ID
Request structure
1 GET /v{version}/blb/{blbId}/securitygroup HTTP/1.1
2 Host: blb.bj.baidubce.com
3 Authorization: authorization string
Request headers
No special headers beyond common headers.
Request parameters
Parameter name
Types
Whether required
Parameter location
Description
version
String
Yes
URL parameter
API version number, current value is 1.
blbId
String
Yes
URL parameter
Identifier of LoadBalancer to be queried
Response Status Code
Respond with 200 after successful operation, and respond with error codes after failed operation, as shown in [Error Codes](BLB/API Reference/Error code.md)
Response headers
No special headers beyond common headers.
Response parameters
Parameter name
Types
Description
securityGroups
List<[BlbSecurityGroupModel](BLB/API Reference/Appendix.md#BlbSecurityGroupModel)>
Regular security group information, a collection composed of BlbSecurityGroupModel
Request example
1 GET /v1/blb/lb-j8UqijYf/securitygroup HTTP/1.1
2 Host: blb.bj.baidubce.com
3 Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf16
Response example
1 HTTP/1.1 200 OK
2 Server: nginx/1.19.0
3 Date: Thu, 28 Apr 2022 11:06:00 GMT
4 Content-Type: application/json; charset=UTF-8
5 X-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": "IPv6",
20 "portRange": "1-65535",
21 "protocol": "all",
22 "securityGroupRuleId": "r-gkv8yupumvx2"
23 }
24 ]
25 }
26 ]
27 }
Description
Bind enterprise security groups to specified LoadBalancer (standard, application and IPv6) (currently, each BLB instance supports binding up to 1 enterprise security group)
Request structure
1 PUT /v{version}/blb/{blbId}/enterprise/securitygroup?action={action}&clientToken={clientToken} HTTP/1.1
2 Host: blb.bj.baidubce.com
3 Authorization: authorization string
4
5 {
6 "enterpriseSecurityGroupIds": enterpriseSecurityGroupIds
7 }
Request headers
No special headers beyond common headers.
Request parameters
Parameter name
Types
Whether required
Parameter location
Description
version
String
Yes
URL parameter
API version number, current value is 1.
blbId
String
Yes
URL parameter
LoadBalancer identifier
clientToken
String
Yes
Query
Idempotency Token, with length no more than 64 characters.
action
String
Yes
Query
Parameter value for this API: bind
enterpriseSecurityGroupIds
List Yes
RequestBody
List of bound enterprise security group IDs
Response Status Code
Respond with 200 after successful operation, and respond with error codes after failed operation, as shown in [Error Codes](BLB/API Reference/Error code.md)
Response headers
No special headers beyond common headers.
Response parameters
None
Request example
1 PUT /v1/blb/lb-j8UqijYf/enterprise/securitygroup?bind&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2 Host: blb.bj.baidubce.com
3 Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf16
4
5 {
6 "enterpriseSecurityGroupIds": ["esg-g8z4qfj0m0bu"]
7 }
Response example
1 HTTP/1.1 200 OK
2 Server: nginx/1.19.0
3 Date: Thu, 28 Apr 2022 11:06:00 GMT
4 Content-Type: application/json; charset=UTF-8
5 X-Bce-Request-Id: 70b6324a-7b10-4736-8872-4c29be8ef474
Description
Unbind enterprise security group for specified LoadBalancer (standard, application and IPv6), supporting batch unbinding.
Request structure
1 PUT /v{version}/blb/{blbId}/enterprise/securitygroup?action={action}&clientToken={clientToken} HTTP/1.1
2 Host: blb.bj.baidubce.com
3 Authorization: authorization string
4
5 {
6 "enterpriseSecurityGroupIds": enterpriseSecurityGroupIds
7 }
Request headers
No special headers beyond common headers.
Request parameters
Parameter name
Types
Whether required
Parameter location
Description
version
String
Yes
URL parameter
API version number, current value is 1.
blbId
String
Yes
URL parameter
LoadBalancer identifier
clientToken
String
Yes
Query
Idempotency Token, with length no more than 64 characters.
action
String
Yes
Query
Parameter value for this API: unbind
enterpriseSecurityGroupIds
List Yes
RequestBody
List of unbound enterprise security group IDs
Response Status Code
Respond with 200 after successful operation, and respond with error codes after failed operation, as shown in [Error Codes](BLB/API Reference/Error code.md)
Response headers
No special headers beyond common headers.
Response parameters
None
Request example
1 PUT /v1/blb/lb-j8UqijYf/enterprise/securitygroup?unbind&clientToken=be31b98c-5e41-4838-9830-9be700de5a21 HTTP/1.1
2 Host: blb.bj.baidubce.com
3 Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf17
4
5 {
6 "enterpriseSecurityGroupIds": ["esg-gzsqygs59nxp"]
7 }
Response example
1 HTTP/1.1 200 OK
2 Server: nginx/1.19.0
3 Date: Thu, 28 Apr 2022 11:06:00 GMT
4 Content-Type: application/json; charset=UTF-8
5 X-Bce-Request-Id: 70b6324a-7b10-4736-8872-4c29be8ef478
Description
Query enterprise security group information of specified LoadBalancer under user account by ID
Request structure
1 GET /v{version}/blb/{blbId}/enterprise/securitygroup HTTP/1.1
2 Host: blb.bj.baidubce.com
3 Authorization: authorization string
Request headers
No special headers beyond common headers.
Request parameters
Parameter name
Types
Whether required
Parameter location
Description
version
String
Yes
URL parameter
API version number, current value is 1.
blbId
String
Yes
URL parameter
Identifier of LoadBalancer to be queried
Response Status Code
Respond with 200 after successful operation, and respond with error codes after failed operation, as shown in [Error Codes](BLB/API Reference/Error code.md)
Response headers
No special headers beyond common headers.
Response parameters
Parameter name
Types
Description
enterpriseSecurityGroups
List<[BlbEnterpriseSecurityGroupModel](BLB/API Reference/Appendix.md#BlbSecurityGroupModel)>
Enterprise security group information, a collection composed of BlbEnterpriseSecurityGroupModel
Request example
1 GET /v1/blb/lb-j8UqijYf/enterprise/securitygroup HTTP/1.1
2 Host: blb.bj.baidubce.com
3 Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf16
Response example
1 HTTP/1.1 200 OK
2 Server: nginx/1.19.0
3 Date: Thu, 28 Apr 2022 11:06:00 GMT
4 Content-Type: application/json; charset=UTF-8
5 X-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": "All protocols",
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 }
