消息队列 RocketMQ版
消息队列 RocketMQ版
消息队列 RocketMQ版
文档指南
请输入
产品动态
用户指南
实例管理
后台任务管理
Terraform
RocketMQ Agent
API 参考
实例管理
Topic管理
Group管理
消息查询
死信队列
密钥管理
风险巡检
白名单管理
终端节点服务
SDK 参考
RocketMQ 5.x
RocketMQ 4.x
RocketMQ 管控面SDK
最佳实践
- 文档首页
消息队列 RocketMQ版API 参考Group管理DeleteConsumerGroupSubscription - 删除消费组订阅关系
复制全文
下载 pdfDeleteConsumerGroupSubscription - 删除消费组订阅关系
文档反馈
问问助手调用 DeleteConsumerGroupSubscription 接口，删除指定消费组下某个 Topic 的订阅关系。
注意事项
- 仅 5.x 版本实例支持该操作。
- 若消费组下仍有消费者订阅该 Topic，则不允许删除。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：DeleteConsumerGroupSubscription
要执行的操作，取值：DeleteConsumerGroupSubscription。
Version string 必选 示例值：2023-01-01
API的版本，取值：2023-01-01。
InstanceId string 必选 示例值：rocketmq-cnai1f0c29ca****
待删除消费组订阅关系的实例 ID。
GroupId string 必选 示例值：gid-test
待删除消费组订阅关系的消费组 ID。
TopicName string 必选 示例值：topic-test
待删除消费组订阅关系的 Topic 名称。
返回参数
请求示例
POST /?Action=DeleteConsumerGroupSubscription&Version=2023-01-01 HTTP/1.1
Host: rocketmq.cn-beijing.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20260819T025038Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260819/cn-beijing/RocketMQ/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f
{
"InstanceId": "rocketmq-cnai1f0c29ca****",
"GroupId": "gid-test",
"TopicName": "topic-test"
}
返回示例
{
"ResponseMetadata": {
"RequestId": "20260819105042164206229229A6****",
"Action": "DeleteConsumerGroupSubscription",
"Version": "2023-01-01",
"Service": "RocketMQ",
"Region": "cn-beijing"
},
"Result": {}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
状态码 | 错误码 | 错误信息 | 说明 |
200 | OK | OK | 成功。 |
400 | InvalidTopicStatus | topic status is invalid. | Topic 状态不合法。 |
400 | OperationDenied.InvalidRequest | The request that you specified is not valid. | 请求异常，请检查后重试。 |
400 | InvalidParameter | The specified parameter %s is not valid. | 参数值%s无效，请检查后重试。 |
403 | OperationDenied.ResourceOccupied | The resource is busy now, please try again later. | 资源繁忙，可能由于指定资源正在被访问或回收。 |
403 | OperationDenied.AccountNotAuthorized | You are not authorized to perform this operation. | 您不具备相关权限，请授权或切换账号后重试。 |
403 | OperationDenied.VersionUnsupported | The current instance version does not support this operation.Please upgrade the instance and try again. | 当前实例版本不支持指定操作，请升级实例后再试。 |
403 | OperationDenied.NotAllow | The operation is not allow. %s | 操作不允许。 |
404 | InvalidTopicName.NotFound | The specified topic does not exist. | Topic 不存在。 |
404 | InvalidGroup.NotFound | The specified group does not exist. | Group 不存在。 |
404 | InvalidInstanceId.NotFound | The specified Instance ID does not exist. | 实例不存在。 |
500 | InternalError | The request failed due to some unknown error, exception or failure. | 内部错误，请稍后再试。 |
503 | ServiceUnavailable | The request failed due to a temporary failure of the server. | 当前服务暂时不可用。 |
最近更新时间：2026.08.19 16:06:10
这个页面对您有帮助吗？
有用
有用
无用
无用