授权企业安全组规则

更新时间：2024-12-27

描述

该接口用于在企业安全组中授权新的安全组规则。

单次授权的企业安全组规则数目不得大于20；

请求结构

Plain Text

1PUT /v{version}/enterprise/security/{enterpriseSecurityGroupId}?{action}&clientToken={clientToken} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4
5{
6   "rules":{rules}
7}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必选	参数位置	描述
version	String	是	URL参数	API版本号，当前取值为1
action	String	是	Query参数	对企业安全组执行的动作，当前取值authorizeRule
clientToken	String	否	Query参数	幂等性Token，是一个长度不超过64位的ASCII字符串，详见ClientToken幂等性。
enterpriseSecurityGroupId	String	是	URL参数	授权新安全组规则的企业安全组ID
rules	List<EnterpriseSecurityGroupRuleModel>	是	RequestBody参数	待授权企业安全组规则

返回头域

除公共头域，无其它特殊头域。

返回参数

无特殊返回参数。

错误码

错误码	错误描述	HTTP状态码	中文解释
Esg.EsgResourceNotExist	Enterprise security group resource not exist.	404	目标企业安全组不存在
Esg.EsgRuleActionEmpty	Enterprise security group rule action(allow or deny) is required.	400	企业安全组规则action不允许为空
Esg.EsgRuleActionInvalid	Enterprise security group rule action(allow or deny) is invalid.	400	企业安全组规则action不合法
Esg.EsgRuleRemarkTooLong	Enterprise security group rule remark is too long.	400	企业安全组规则备注过长
Esg.EsgRuleProtocolEmpty	Enterprise security group rule protocol is required.	400	企业安全组规则协议类型不允许为空
Esg.EsgRuleProtocolInvalid	Enterprise security group rule protocol is invalid.	400	企业安全组规则协议类型不合法
Esg.EsgRulePortEmpty	Enterprise security group rule portRange is required.	400	企业安全组规则端口范围不允许为空
Esg.EsgRulePortFormatInvalid	Enterprise security group rule portRange is invalid.	400	企业安全组规则端口范围格式不正确
Esg.EsgRulePortDuplicate	Enterprise security group rule ports in portRange is duplicate.	400	企业安全组规则端口值重复，比如80-80或80,80,7000
Esg.EsgRulePortOrderError	Enterprise security group rule portRange order is wrong.	400	企业安全组规则端口范围顺序不正确，比如400-80
Esg.EsgRuleDispersedPortSizeExceed	Enterprise security group rule dispersed ports in portRange is limited 15 .	400	企业安全组规则端口范围离散值数量超限
Esg.EsgRulePortValueExceed	Enterprise security group rule port value is not in range 1-65535	400	企业安全组规则端口值超出范围
Esg.EsgRulePriorityEmpty	Enterprise security group rule priority is required.	400	企业安全组规则优先级不允许为空
Esg.EsgRulePriorityInvalid	Enterprise security group rule priority is not in range 1-1000.	400	企业安全组规则优先级取值超出范围
Esg.EsgRuleEthertypeEmpty	Enterprise security group rule ethertype is required.	400	企业安全组规则网络类型不允许为空
Esg.EsgRuleEthertypeInvalid	Enterprise security group rule ethertype is invalid.	400	企业安全组规则网络类型不合法
Esg.EsgRuleIpAddressEmpty	Enterprise security group rule ip(cidr) address is required.	400	企业安全组规则源IP/目的IP不允许为空
Esg.EsgRuleIpAddressError	Enterprise security group rule ip(cidr) address is incorrect.	400	企业安全组规则源IP/目的IP格式错误
Esg.EsgRuleDirectionEmpty	Enterprise security group rule direction is required.	400	企业安全组规则方向不允许为空
Esg.EsgRuleDirectionInvalid	Enterprise security group rule direction is invalid.	400	企业安全组规则方向不合法
Esg.EsgRuleDuplicated	Enterprise security group rule exist already.	400	企业安全组规则重复
Esg.EsgRuleExceedQuota	Enterprise security group rule number over limited.	400	企业安全组规则数量已达配额

请求示例

Plain Text

1PUT /v1/enterprise/security/esg-nky7qeom?authorizeRule&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 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
5
6{
7	"rules": [
8		{
9			"remark": "备注",
10			"protocol": "tcp",
11            "portRange": "1-65535",
12			"sourcePortRange": "1-65535",
13			"direction": "ingress",
14			"sourceIp": "all",
15            "localIp": "all",
16			"priority": 1000,
17            "action": "deny",
18            "ethertype": "IPv4"
19		}
20     ]
21}

返回示例

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

删除企业安全组

删除企业安全组规则

百度智能云

私有网络 VPC

私有网络 VPC

授权企业安全组规则