调用DeleteTopic接口删除主题。

注意 使用者必须谨慎使用此接口,主题被删除后,主题内所有消息和订阅该主题的Subscription也一并被删除,且不可恢复。

授权信息

默认仅限阿里云账号使用本接口,RAM用户只有在被授予了相关API操作权限后方可使用。本接口的授权信息如下表所示。更多信息,请参见授权策略和示例

Name Value
API DeleteTopic
RAM授权操作 mns:DeleteTopic
资源 acs:mns:$region:$accountid:/topics/$topicName

请求消息

请求消息由请求行、HTTP头和消息体三部分组成:

  • 请求行

    DELETE /topics/$TopicName HTTP/1.1

  • 特有Request Header

    无。

  • Request Body

    无。

返回消息

返回消息由返回状态行、HTTP头和消息体三部分组成:

  • HTTP Status Code

    HTTP/1.1 204 No Content

    如果主题不存在,返回204,删除操作成功。

  • 特有Response Header

    无。

  • Response Body

    无。

示例

请求示例:

DELETE /topics/$TopicName HTTP/1.1
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Tue, 08 Dec 2015 06:05:08 GMT
Authorization: MNS 15B4D3461F177624206A:xit63dyKs83PTJF0hx3fd04C****
x-mns-version: 2015-06-06

返回示例:

HTTP/1.1 204 No Content
x-mns-request-id: 56667314B2B71C9C1600****
x-mns-version: 2015-06-06

错误码

本操作无特有的错误,主要是权限验证类和参数设置类错误。更多信息,请参见错误码