サブスクリプションのパラメーターを変更します。
認証
デフォルトでは、Alibaba Cloudアカウントのみがこの操作を呼び出すことができます。 RAMユーザーは、関連する権限が付与された後にのみ、この操作を呼び出すことができます。次の表に、この操作の認証情報を示します。 詳細については、「アクセス許可ポリシーと例」をご参照ください。
項目 | 値 |
API操作 | SetSubscriptionAttributes |
アクション | mns:SetSubscriptionAttributes |
リソース | acs:mns:$region:$accountid:/topics/$topicName/subscriptions/$subscriptionName |
リクエスト
リクエストは、次の部分で構成されます。
リクエスト行
PUT /topics/$TopicName/subscriptions/$SubscriptionName?metaoverride=true HTTP/1.1操作固有のURIパラメーター
サブスクリプションのパラメーターを変更するには、URIで
metaoverride=trueを指定します。操作固有のリクエストヘッダー
なし。
リクエスト本文
リクエスト本文はXML形式です。 リクエスト本文には、サブスクリプションの変更に使用されるパラメーターが含まれています。
パラメーター
タイプ
必須
例
説明
NotifyStrategy
ブール値
いいえ
BACKOFF_RETRY
MNSがエンドポイントにメッセージをプッシュするときにエラーが発生した場合に適用される再試行ポリシー。
有効な値:
BACKOFF_RETRY: 固定バックオフ間隔で再試行します。
EXPONENTIAL_DECAY_RETRY: 指数関数的バックオフで再試行します。
詳細については、「NotifyStrategy」をご参照ください。
デフォルト値:BACKOFF_RETRY。
レスポンス
レスポンスは、次の部分で構成されます。
HTTPステータスコード
HTTP/1.1 204 No Content操作固有のレスポンスヘッダー
なし。
レスポンス本文
なし。
例
リクエストの例
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 | 指定されたサブスクリプションは存在しません。 | 404 | 指定されたサブスクリプションが存在しないため返されたエラーメッセージです。 サブスクリプションを作成してください。 |