企业安全组

更新时间：2025-08-22

初始化

确认Endpoint

在确认您使用SDK，需要配置Endpoint时，理解Endpoint相关的概念。百度智能云目前开放了多区域支持，请参考区域选择说明。目前支持“华北-北京”、“华南-广州”、"华东-苏州"、"香港"、"金融华中-武汉"和"华北-保定"六个区域。对应Endpoint信息为：

访问区域	对应Endpoint
华北-北京	bcc.bj.baidubce.com
华南-广州	bcc.gz.baidubce.com
华东-苏州	bcc.su.baidubce.com
香港	bcc.hkg.baidubce.com
金融华中-武汉	bcc.fwh.baidubce.com
华北-保定	bcc.bd.baidubce.com

获取密钥

要使用百度智能云安全组，您需要拥有一个有效的 AK（Access Key ID）和SK(Secret Access Key)用来进行签名认证。AK/SK是由系统分配给用户的，均为字符串，用于标识用户，为访问BOS做签名验证。可以通过如下步骤获得并了解您的AK/SK信息：注册百度智能云账号创建AK/SK

新建EsgClient

EsgClient是企业安全组服务的客户端，为开发者与安全组服务进行交互提供了一系列的方法。

新建EsgClient时，需要先使用Endpoint、AK、SK对EsgClientConfiguration类型config实例进行配置，再使用config实例对EsgClient进行配置，配置示例如下：

Plain Text

1 static final String HOST = "";
2 static final String AK = "";
3 static final String SK = "";
4 EsgClientConfiguration config = new EsgClientConfiguration();
5 config.setCredentials(new DefaultBceCredentials(AK, SK));
6 config.setEndpoint(HOST);
7 EsgClient bccClient = new EsgClient(config);

新建企业安全组

函数声明

Plain Text

1public CreateSecurityGroupResponse createSecurityGroup(CreateSecurityGroupRequest request) {
2 }

参数含义

请参考OpenAPI文档创建企业安全组请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "enterpriseSecurityGroupId":"esg-p09p0ihp7498"
4}

操作失败

操作失败返回异常列表参考安全组异常列表

代码示例

具体代码示例参考：ExampleCreateEsg.java

列举企业安全组列表

函数声明

Plain Text

1  public ListEsgResponse listEsg(ListEsgRequest request) {
2 }

参数含义

请参考OpenAPI文档列举企业安全组请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "marker": "",
4    "isTruncated": false,
5    "maxKeys": 1000,
6    "enterpriseSecurityGroups": [
7        {
8            "id": "esg-cza4aa7z2wtd",
9            "name": "esgName",
10            "desc": "desc",
11            "createdTime": "2023-12-05T08:31:10Z",
12            "updatedTime": "2023-12-05T08:47:23Z",
13            "rules": [
14                {
15                    "remark": "",
16                    "direction": "ingress",
17                    "action": "allow",
18                    "priority": 100,
19                    "ethertype": "IPv4",
20                    "portRange": "2000-3000",
21                    "sourcePortRange": "",
22                    "localIp": "all",
23                    "sourceIp": "all",
24                    "destIp": "",
25                    "enterpriseSecurityGroupRuleId": "esgr-q4vza39iwgv0",
26                    "createdTime": "2023-12-05T08:43:14Z",
27                    "updatedTime": "2023-12-05T08:43:14Z",
28                    "protocol": "tcp"
29                }
30            ],
31            "tags": []
32        }
33    ]
34}

操作失败

操作失败返回异常列表参考安全组异常列表

代码示例

具体代码示例参考：ExampleEsgList.java

删除企业安全组

函数声明

Plain Text

1public void deleteEsg(String esgId) {
2}

参数含义

请参考OpenAPI文档删除企业安全组请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考安全组异常列表

代码示例

具体代码示例参考：ExampleDeleteEsg.java

授权企业安全组规则

函数声明

Plain Text

1public void authorizeSecurityGroupRule(SecurityGroupRuleOperateRequest request) {
2 }

参数含义

请参考OpenAPI文档授权企业安全组请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考安全组异常列表

代码示例

具体代码示例参考：ExampleAddEsgRule.java

删除企业安全组规则

函数声明

Plain Text

1 public void deleteEsgRule(String esgRuleId) {
2 }

参数含义

请参考OpenAPI文档撤销企业安全组请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考安全组异常列表

代码示例

具体代码示例参考：ExampleDeleteEsgRule.java

更新企业安全组规则

函数声明

Plain Text

1 public void updateEsgRule(UpdateEsgRuleRequest request){
2 }

参数含义

请参考OpenAPI文档更新企业安全组请求参数

返回值

操作成功

无返回值

操作失败

操作失败返回异常列表参考安全组异常列表

代码示例

具体代码示例参考：ExampleUpdateEsgRule.java

附录

公共返回信息metadata格式

Plain Text

1 {
2      "bceRequestId":"f5f0821d-45fe-439b-bbf4-fc48b639f84a",
3      "contentLength":28,
4      "contentType":"application/json;charset=UTF-8",
5      "date":1701917695000,
6      "server":"openresty/1.15.8.1"
7 }

Python-SDK

VPN

私有网络 VPC

私有网络 VPC

企业安全组

初始化

确认Endpoint

获取密钥

新建EsgClient

新建企业安全组

列举企业安全组列表

删除企业安全组

授权企业安全组规则

删除企业安全组规则

更新企业安全组规则

附录