すべてのプロダクト
Search
ドキュメントセンター

:SetSubscriptionAttributes

最終更新日:Mar 14, 2025

サブスクリプションのパラメーターを変更します。

認証

デフォルトでは、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

指定されたサブスクリプションが存在しないため返されたエラーメッセージです。 サブスクリプションを作成してください。