更新时间：2025-10-22 GMT+08:00
批量删除Group - BatchDeleteGroups
功能介绍
该接口用于批量删除Group。
授权信息
账号具备所有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 |
删除消费组成功。 |
错误码
请参见错误码。
父主题： 消费组管理
