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

错误码

本操作无特有的错误,主要是权限验证类和参数设置类错误。更多信息,请参见错误码