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

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

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

调试

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

请求参数

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

系统规定参数。取值:OnsTopicDelete。

Topic String test

指定删除的 Topic

InstanceId String MQ_INST_111111111111_DOxxxxxx

需删除的 Topic 所对应的实例 ID。针对有独立命名空间的实例,该参数为必填。

返回数据

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

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

示例

请求示例


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

正常返回示例

XML 格式

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

JSON 格式

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

错误码

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