修改权限组
更新时间：2026-06-17
描述
修改权限组的可变属性，包括名称、描述和具体权限规则等。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/authgroup?action=ModifyAuthGroup&clientToken={clientToken} HTTP/1.1
2Host: rapidfs.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "instanceId": "rapidfs-nzQhBpIz",
7 "authGroupId": "ag-ye9Zbr87",
8 "authGroupName": "new test-authgroup",
9 "description": "new test for auth group",
10 "authInfos": [
11 {
12 "cidr": "127.0.0.0",
13 "mode": "ReadOnly"
14 }
15 ],
16 "originalAuthInfos": [
17 {
18 "cidr": "127.0.0.0",
19 "mode": "ReadOnly"
20 }
21 ]
22}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| clientToken | String | 是 | Query参数 | 保证API调用的幂等性 |
| authGroupId | String | 是 | RequestBody参数 | 权限组id |
| instanceId | String | 是 | RequestBody参数 | 所属 RapidFS 实例唯一 Id |
| authGroupName | String | 否 | RequestBody参数 | 权限组名称 |
| description | String | 否 | RequestBody参数 | 描述信息 |
| authInfos | List<AuthInfo> | 否 | RequestBody参数 | 修改之后的权限规则列表。默认权限组不允许增加或删除权限规则 |
| originalAuthInfos | List<AuthInfo> | 否 | RequestBody参数 | 表示修改前的权限规则列表，默认不传。可与 authInfos 搭配使用实现条件更新的效果，如果请求的权限规则列表与产品侧记录不一致，返回 400 |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
无
请求示例
Plain Text
1POST /v2/authgroup?action=ModifyAuthGroup&clientToken={clientToken} HTTP/1.1
2Host: rapidfs.bj.baidubce.com
3Authorization: authorization string
4{
5 "instanceId": "rapidfs-nzQhBpIz",
6 "authGroupId": "ag-ye9Zbr87",
7 "authGroupName": "new test-authgroup",
8 "description": "new test for auth group",
9 "authInfos": [
10 {
11 "cidr": "127.0.0.0",
12 "mode": "ReadOnly"
13 },
14 {
15 "cidr": "127.0.0.3",
16 "mode": "ReadOnly"
17 },
18 {
19 "cidr": "127.0.0.1",
20 "mode": "ReadWrite"
21 }
22 ],
23 "originalAuthInfos": [
24 {
25 "cidr": "127.0.0.0",
26 "mode": "ReadOnly"
27 },
28 {
29 "cidr": "127.0.0.1",
30 "mode": "ReadOnly"
31 },
32 {
33 "cidr": "127.0.0.2",
34 "mode": "ReadOnly"
35 }
36 ]
37}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
4{}评价此篇文章