删除权限组
更新时间：2026-06-17
描述
本接口用于删除指定RapidFS实例下的权限组。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
使用该接口时，需要注意以下事项：
- 已绑定数据源的权限组不可删除，需先解绑所有关联资源
- 删除后将立即生效，所有依赖该权限组的访问控制规则会同步失效
请求结构
Plain Text
1POST /v{version}/authgroup?action=DeleteAuthGroup&clientToken={clientToken} HTTP/1.1
2Host: rapidfs.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "instanceId": "rapidfs-nzQhBpIz",
7 "authGroupId": "ag-ye9Zbr87"
8}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| clientToken | String | 是 | Query参数 | 保证API调用的幂等性 |
| instanceId | String | 是 | RequestBody参数 | 所属 RapidFS 实例唯一 Id |
| authGroupId | String | 是 | RequestBody参数 | 待删除的权限组id，权限组有绑定数据源的情况下会删除失败 |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
无
请求示例
Plain Text
1POST /v2/authgroup?action=DeleteAuthGroup&clientToken={clientToken}
2Host: rapidfs.bj.baidubce.com
3Authorization: authorization string
4{
5 "instanceId": "rapidfs-nzQhBpIz",
6 "authGroupId": "ag-ye9Zbr87"
7}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
4{}评价此篇文章