消息队列 Kafka版
消息队列 Kafka版
消息队列 Kafka版
文档指南
请输入
用户指南
实例管理
Kafka Agent
API 参考
V2（2022-05-01）
OpenAPIV2
网络管理
Topic 管理
Group 管理
SASL 用户管理
白名单管理
附录
V1（2018-01-01）
实例管理
Topic 管理
Group 管理
SDK 参考
Apache Kafka SDK
Java 客户端 SDK
Go 客户端 SDK
Python 客户端 SDK
Volcengine SDK
Volcengine Python SDK
Volcengine Java SDK
最佳实践
- 文档首页
消息队列 Kafka版API 参考V2（2022-05-01）OpenAPIV2DeleteInstance - 删除实例
复制全文
下载 pdfDeleteInstance - 删除实例
文档反馈
问问助手调用 DeleteInstance 接口释放按量付费实例。
注意事项
- 实例被删除后无法恢复，请谨慎调用。
- 仅按量付费实例支持通过此接口删除。包年包月实例到期后自动删除，合同期内不支持删除。
- 删除实例前，需要确保实例中没有 Topic 和 Group；没有执行中的后台任务。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：DeleteInstance
要执行的操作，取值：DeleteInstance。
Version string 必选 示例值：2022-05-01
API的版本，取值：2022-05-01。
InstanceId string 必选 示例值：kafka-cnngqkfgdudt****
实例 ID。
返回参数
请求示例
POST /?Action=DeleteInstance&Version=2022-05-01 HTTP/1.1
Content-Type: application/json
Host: kafka.volcengineapi.com
X-Date: 20210328T100802Z
Authorization: HMAC-SHA256 Credential=AK********/20210328/cn-beijing/Kafka/request, SignedHeaders=x-date, Signature=********
{
"InstanceId": "kafka-cnng3s31v076****"
}
返回示例
{
"ResponseMetadata": {
"RequestId": "2023022719153124D1D2D50917B7639137",
"Action": "DeleteInstance",
"Version": "2022-05-01",
"Service": "Kafka",
"Region": "cn-beijing"
},
"Result": null
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
状态码 | 错误码 | 错误信息 | 说明 |
400 | OperationDenied.ChargeTypeIsPrepaid | It's forbidden to release a prepaid instance within validity period. | 不支持在合同期内删除实例。 |
400 | OperationDenied.InstancePrepaid | The operation is not permitted due to the instance charge type is prepaid. | 当前实例计费类型是预付费，无法执行该操作。 |
403 | OperationDenied.InstanceNotEmpty | The instance that you tried to delete is not empty. | 期望删除的实例不为空。 |
404 | InvalidInstance.NotFound | The specified instance does not exist. | 实例不存在。 |
最近更新时间：2025.08.08 17:47:27
这个页面对您有帮助吗？
有用
有用
无用
无用