調用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 錯誤碼
本操作無特有的錯誤,主要是許可權驗證類和參數設定類錯誤。更多資訊,請參見錯誤碼。