調用SetSubscriptionAttributes介面修改Subscription的屬性。
授權資訊
預設僅限阿里雲帳號使用本介面,RAM使用者只有在被授予了相關API操作許可權後方可使用。本介面的授權資訊如下表所示。更多資訊,請參見授權策略和樣本。
Name | Value |
API | SetSubscriptionAttributes |
RAM授權操作 | mns:SetSubscriptionAttributes |
資源 | acs:mns:$region:$accountid:/topics/$topicName/subscriptions/$subscriptionName |
請求訊息
請求訊息由請求行、URL參數、HTTP頭和訊息體四部分組成:
請求行
PUT /topics/$TopicName/subscriptions/$SubscriptionName?metaoverride=true HTTP/1.1特有URI參數
metaoverride=true將會修改Subscription的屬性。特有Request Header
無。
Request Body
Request Body為XML格式,XML中包含修改Subscription的屬性。
參數名稱
類型
是否必選
樣本值
描述
NotifyStrategy
Boolean
否
BACKOFF_RETRY
向Endpoint推送訊息出現錯誤時的重試策略。
預設值:BACKOFF_RETRY。
返回訊息
返回訊息由返回狀態行、HTTP頭和訊息體三部分組成:
HTTP Status Code
HTTP/1.1 204 No Content特有Response Header
無。
Response Body
無。
樣本
請求樣本:
PUT /topics/$TopicName/subscriptions/$SubscriptionName?metaoverride=true HTTP/1.1
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Tue, 08 Dec 2015 06:09:22 GMT
Authorization: MNS 15B4D3461F177624206A:rNT4xclLS297/n0UFYIezzHJ****
x-mns-version: 2015-06-06
<?xml version="1.0" encoding="utf-8"?>
<Subscription xmlns="http://mns.aliyuncs.com/doc/v1/">
<NotifyStrategy>BACKOFF_RETRY</NotifyStrategy>
</Subscription>返回樣本:
HTTP/1.1 204 No Content
x-mns-request-id:56667412B2B71C9C1600****
x-mns-version: 2015-06-06錯誤碼
錯誤碼 | 錯誤訊息 | HTTP狀態代碼 | 描述內容 |
SubscriptionNotExist | The subscription you provided does not exits. | 404 | 訂閱不存在,請先建立訂閱。 |