All Products
Document Center


Last Updated: Oct 08, 2019



This API is used to modify subscription attributes.


A request includes the following parts:

  • Request line

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

  • Special URI parameter

    metaoverride=true: The attributes of the subscription will be modified.

  • Special request header

    None. For details, refer to Call method/Public parameters.

  • Request Body

    The request body is in XML format and contains the modified subscription attributes.

Parameter name Description Parameter value Required/Optional
NotifyStrategy Retry policy that will be applied when an error occurs during message push to the endpoint BACKOFF_RETRY or EXPONENTIAL_DECAY_RETRY; default value:BACKOFF_RETRY. For details about retry policies, refer to Basic Concepts/NotifyStrategy. Optional


The response message includes three parts: return status line, HTTP header, and message body.

  • HTTP Status Code

    HTTP/1.1 204 No Content

  • Special response header

    None. For details, refer to Call method/Public parameters.

  • Response Body


Special Error:

Error code Error message Status code
SubscriptionNotExist The subscription you provided does not exits. 404

Request example:

  1. PUT /topics/$TopicName/subscriptions/$SubscriptionName?metaoverride=true HTTP/1.1
  2. Host: $
  3. Date: Tue, 08 Dec 2015 06:09:22 GMT
  4. Authorization: MNS 15B4D3461F177624206A:rNT4xclLS297/n0UFYIezzHJI7Q=
  5. x-mns-version: 2015-06-06
  6. <?xml version="1.0" encoding="utf-8"?>
  7. <Subscription xmlns="">
  8. <NotifyStrategy>BACKOFF_RETRY</ NotifyStrategy>
  9. </Subscription>

Response example:

  1. HTTP/1.1 204 No Content
  2. x-mns-request-id:56667412B2B71C9C16000027
  3. x-mns-version: 2015-06-06