使用 OnsTopicDelete 删除您账号下指定的 Topic。

OnsTopicDelete 接口一般是在应用下线等资源回收场景下使用。Topic 删除时后台需要做资源回收，速度较慢，因此不建议删除后立即又重新创建。如果删除失败，请根据错误码进行处理。

使用 OnsTopicDelete 接口时，请注意以下几点：

  • 默认仅限主账号使用本接口，RAM 子账号只有在被授予了相关权限后方可使用。
  • 删除 Topic 将导致该 Topic 下所有的发布订阅关系同时被清理，请慎重调用。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 OnsTopicDelete

系统规定参数。取值：OnsTopicDelete。
InstanceId String 是 MQ_INST_111111111111_DOxxxxxx

需删除的 Topic 所对应的实例 ID。
Topic String 是 test

指定删除的 Topic。

返回数据

名称 类型 示例值 描述
RequestId String 4189D4A6-231A-4028-8D89-F66A76C1F4F0

为公共参数，每个请求的 ID 都是唯一的，可用于排查和定位问题。

示例

请求示例

http(s)://[Endpoint]/?Action=OnsTopicDelete
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&Topic=test
&<公共请求参数>

正常返回示例

XML 格式 

<OnsTopicDeleteResponse>
  <RequestId>4189D4A6-231A-4028-8D89-F66A76C1F4F0</RequestId>
</OnsTopicDeleteResponse>

JSON 格式 

{
	"RequestId": "4189D4A6-231A-4028-8D89-F66A76C1F4F0"
}

错误码

访问错误中心查看更多错误码。