Modifies the parameters of a subscription.

Authorization

By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after these RAM users are granted related permissions. The following table describes the authorization information of this operation. For more information, see Permission policies and examples.

Item Value
API operation SetSubscriptionAttributes
Action mns:SetSubscriptionAttributes
Resource acs:mns:$region:$accountid:/topics/$topicName/subscriptions/$subscriptionName

Request

A request consists of the following parts:

  • Request line

    PUT /topics/$TopicName/subscriptions/$SubscriptionName?metaoverride=true HTTP/1.1

  • Operation-specific URI parameters

    To modify the parameters of a subscription, you can specify metaoverride=true in the URI.

  • Operation-specific request headers

    None.

  • Request body

    The request body is in the XML format. The request body includes the parameters that are used to modify a subscription.

    Parameter Type Required Example Description
    NotifyStrategy Boolean No BACKOFF_RETRY The retry policy that is applied if an error occurs when MNS pushes messages to the endpoint.
    Valid values:
    • BACKOFF_RETRY: retries with a fixed backoff interval.
    • EXPONENTIAL_DECAY_RETRY: retries with exponential backoff.
    For more information, see NotifyStrategy.

    Default value: BACKOFF_RETRY.

Response

A response consists of the following parts:

  • HTTP status code

    HTTP/1.1 204 No Content

  • Operation-specific response headers

    None.

  • Response body

    None.

Examples

Sample requests

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>

Sample success responses

HTTP/1.1 204 No Content
x-mns-request-id:56667412B2B71C9C1600****
x-mns-version: 2015-06-06

Error codes

Error code Error message HTTP status code Description
SubscriptionNotExist The subscription you provided does not exits. 404 The error message returned because the specified subscription does not exist. Create a subscription.