调用Unsubscribe接口取消一个已创建的Subscription。
授权信息
默认仅限阿里云账号使用本接口,RAM用户只有在被授予了相关API操作权限后方可使用。本接口的授权信息如下表所示。更多信息,请参见授权策略和示例。
Name | Value |
---|---|
API | Unsubscribe |
RAM授权操作 | mns:Unsubscribe |
资源 | acs:mns:$region:$accountid:/topics/$topicName/subscriptions/$subscriptionName |
请求消息
请求消息由请求行、HTTP头和消息体三部分组成:
- 请求行
DELETE /topics/$TopicName/subscriptions/$SubscriptionName HTTP/1.1
- 特有Request Header
无。
- Request Body
无。
返回消息
返回消息由返回状态行、HTTP头和消息体三部分组成:
- HTTP Status Code
HTTP/1.1 204 No Content
如果Unsubscribe的Subscription不存在,返回204,取消订阅成功。
- 特有Response Header
无。
- Response Body
无。
示例
请求示例:
DELETE /topics/$TopicName/subscriptions/$SubscriptionName HTTP/1.1
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Tue, 08 Dec 2015 06:18:04 GMT
Authorization: MNS 15B4D3461F177624206A:UOEb7OmC9GX7G9BLY3XryP6v****
x-mns-version: 2015-06-06
返回示例:
HTTP/1.1 204 No Content
x-mns-request-id: 5666761CB2B71C9C1600****
x-mns-version: 2015-06-06
错误码
本操作无特有的错误,主要是权限验证类和参数设置类错误。更多信息,请参见错误码。