全部產品
Search
文件中心

:DeleteTopic

更新時間:Jan 24, 2025

調用DeleteTopic介面刪除主題。

重要 使用者必須謹慎使用此介面,主題被刪除後,主題內所有訊息和訂閱該主題的Subscription也一併被刪除,且不可恢複。

授權資訊

預設僅限阿里雲帳號使用本介面,RAM使用者只有在被授予了相關API操作許可權後方可使用。本介面的授權資訊如下表所示。更多資訊,請參見授權策略和樣本

NameValue
APIDeleteTopic
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

錯誤碼

本操作無特有的錯誤,主要是許可權驗證類和參數設定類錯誤。更多資訊,請參見錯誤碼