更新时间：2025-10-22 GMT+08:00
批量删除Group - BatchDeleteGroups
功能介绍
该接口用于批量删除Group。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
POST /v2/{project_id}/mqs/instances/{instance_id}/groups/batch-delete
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
instance_id | 是 | String | 实例ID。 |
project_id | 是 | String | 项目ID。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
[数组元素] | 否 | Array of strings | 所有需要删除的消费组ID。 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
failed_groups | Array of FailedGroupsEntity objects | 删除失败的消费组列表。 |
total | Integer | 删除失败的个数。 |
请求示例
批量删除消费组。
"POST https://{endpoint}/v2/{project_id}/mqs/instances/{instance_id}/groups/batch-delete"
{
"group_ids" : [ "get-sync-group0", "get-sync-group1" ]
} 响应示例
状态码：200
删除消费组成功。
{
"failed_groups" : [ ],
"total" : 0
} 状态码
状态码 | 描述 |
|---|---|
200 | 删除消费组成功。 |
错误码
请参见错误码。
父主题：消费组管理
