Query enterprise security group list

Updated at：2025-10-16

Description

This API retrieves enterprise security group details for the user.

Request structure

Plain Text

1GET /v{version}/enterprise/security?marker={marker}&maxKeys={maxKeys}&instanceId={instanceId} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string

Request headers

There are no special headers required beyond the common headers.

Request parameters

Parameter name	Types	Required or not	Parameter location	Description
version	String	Yes	URL parameter	For API version No., the current value is 1
marker	String	No	Query	The starting position of the batch list query is a system-generated string
maxKeys	Integer	No	Query	Maximum number of items included per page, maximum: 1,000, default: 1,000
instanceId	String	No	Query	Enter the instance ID to fetch the enterprise security groups linked to that instance. Leave this parameter blank to query all created enterprise security groups.

Response headers

No special headers are required beyond the standard ones.

Response parameters

Parameter name	Types	Description
marker	String	Mark the starting position of the query.
isTruncated	Boolean	"True" means there is more data available, and "False" means this is the last page.
nextMarker	String	The marker value needed to retrieve the next page. This field does not appear if isTruncated is false.
maxKeys	Integer	Maximum number of items included per page
enterpriseSecurityGroups	List<[EnterpriseSecurityGroupModel](VPC/API Reference/Appendix.md#EnterpriseSecurityGroupModel)>	Enterprise security group information, a collection composed of EnterpriseSecurityGroupModel

Request example

Plain Text

1GET /v1/enterprise/security?instanceId=i-kjuinbcd HTTP/1.1
2Host: bcc.bj.baidubce.com
3Content-Type: application/json;charset=UTF-8
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

Response example

Plain Text

1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Wed, 03 Dec 2014 06:42:19 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS
6
7{
8    "nextMarker": "",
9    "marker": "",
10    "maxKeys": 1000,
11    "enterpriseSecurityGroups": [
12        {
13        "desc": "",
14        "id": "esg-4NxWoxeq",
15        "name": "test enterprise sg",
16        "createdTime":"2019-09-24T08:25:59Z",
17        "updatedTime":"2019-09-24T08:25:59Z",
18        "rules": [
19            {
20                "destIp": "all",
21                "localIp": "all",
22                "direction": "egress",
23                "ethertype": "IPv4",
24                "portRange": "1-65535",
25                "sourcePortRange": "1-65535",
26                "action":"allow",
27                "priority":"1000",
28                "protocol": "all",
29 "remark": "Remarks",
30                "enterpriseSecurityGroupRuleId": "esgr-gkv8yupumvx2",
31                "createdTime": "2020-07-27T13:00:52Z",
32                "updatedTime": "2020-07-27T13:00:52Z"
33            }
34        ],
35        "tags":[
36           {
37            "tagKey": "tagKey",
38            "tagValue": "tagValue"
39           }
40        ]
41      }
42    ],
43    "isTruncated": false
44}

Delete enterprise security group

Update enterprise security group rules

VPC VPC

VPC VPC

Query enterprise security group list