调用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
错误码
本操作无特有的错误,主要是权限验证类和参数设置类错误。更多信息,请参见错误码。