調用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

    無。

返回消息

返回消息由返回狀態(tài)行、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

錯誤碼

本操作無特有的錯誤,主要是權限驗證類和參數(shù)設置類錯誤。更多信息,請參見錯誤碼