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

錯誤碼

本操作無特有的錯誤，主要是權限驗證類和參數設置類錯誤。更多信息，請參見錯誤碼。