删除多角色服务
更新时间：2026-10-21
接口描述
删除多角色服务（服务组），同时删除组内的所有角色服务和 LLM 调度器，并清理网关上为该服务组创建的路由和消费者。
删除的特点：
- 服务组本身是同步删除的：接口返回成功后，再查询列表、访问信息会立即得到「不存在」。各角色服务的资源清理由后台异步完成。
- 同名服务组上有别的操作正在进行时（例如刚创建完、后台还在部署），删除会返回
503 ResourceBusy，等几秒后重试即可。 - 已经删除的服务组再次删除，返回
404 NotFound。 - 已经关联了流量策略的服务组不允许删除，需要先在控制台解除关联。后端代码会拒绝这种删除，但这个场景没有实测，返回的错误码未验证。
请求结构
Plain Text
1POST /?action=DeleteGroupService&serviceGroupId={serviceGroupId}
2HTTP/1.1
3Host:aihc.bj.baidubce.com
4version: v2
5Authorization:authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 参数类型 | 是否必须 | 参数位置 | 参数说明 |
|---|---|---|---|---|
| serviceGroupId | String | 是 | query | 服务组 ID |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| requestId | String | 唯一标识请求，用于日志排查 |
请求示例
Plain Text
1POST /?action=DeleteGroupService&serviceGroupId=g-xxxxxxxxxxxx
2HTTP/1.1
3Host:aihc.bj.baidubce.com
4version: v2
5Authorization:authorization string返回示例
Plain Text
1HTTP/1.1 200 OK
2
3{
4 "requestId": "f78ab14f-c970-4c90-b7ee-5b75fa636608"
5}评价此篇文章