調用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ù)設置類錯誤。更多信息,請參見錯誤碼。