创建权限组规则
更新时间：2025-09-26
描述
为指定的权限组创建一条新的规则
请求
请求结构
Plain Text
1POST /v{version}/accessGroup/{agName}
2Host: cfs.bj.baidubce.com
3Authorization: authorization string
4{
5 "ip": ip,
6 "mask": mask,
7 "writeAccess": write,
8 "userAccess": user,
9 "priority": priority
10}请求头域：除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值1。 |
| agName | String | 是 | URL参数 | 指定创建的规则的权限组名字。 |
| ip | String | 是 | RequestBody参数 | 授权ip地址，虚拟VPC IP，允许单IP或结合mask参数设置网段，支持IPV4和IPV6，如10.10.1.123或2001::/16 |
| mask | int | 是 | RequestBody参数 | 结合ip参数实现指定网段，如果单IP则设置为32（IPV4）或128（IPV6） |
| writeAccess | String | 是 | RequestBody参数 | 读写规则，支持"read_only"表示只读, "read_write"表示读写 |
| userAccess | String | 是 | RequestBody参数 | 用户权限规则，支持"no_squash"表示不限制root用户, "root_squash"表示限制root用户, "all_squash"表示限制所有用户 |
| priority | int | 是 | RequestBody参数 | 规则优先级，优先级可选范围为1-100，1为最高优先级 |
响应
返回状态码：成功返回200，失败返回见错误码
返回头域：除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| accessRuleId | int | 权限组规则的标识符 |
示例
请求：
Plain Text
1POST /v1/accessGroup/ag_test HTTP/1.1
2HOST cfs.bj.baidubce.com
3Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
4{
5 "ip": "10.10.1.123"
6 "mask": 32
7 "writeAccess": "read_write"
8 "userAccess": "all_squash"
9 "priority": 99
10}响应：
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7
8{
9 "accessRuleId": 2
10}