SetTopicAttributes

Description

This API is used to modify topic attributes.

Request

A request mainly includes the following parts:

Request line

PUT /topics/$TopicName?metaoverride=true HTTP/1.1
Special URI parameters

metaoverride=true: The attributes of the topic 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 configured topic attributes.

Parameter name	Description	Parameter value	Required/Optional
MaximumMessageSize	Maximum body length of a message sent to the topic, in the unit of bytes	An integer in the range of 1,024 (1 KB) to 65,536 (64 KB)	Optional
LoggingEnabled	Whether to enable log management. “True” indicates that log management is enabled, whereas “False” indicates that log management is disabled.	True/False	Optional

Response

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

None

Special error

Error code	Error message	Status code
TopicNotExist	The topic you provided does not exist.	404

Request example:

    PUT /topics/$TopicName?metaoverride=true HTTP/1.1
    Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
    x-mns-version: 2015-06-06
    Date: Tue, 08 Dec 2015 06:01:00 GMT
    Authorization:MNS 15B4D3461F177624206A:SeIRcZk3lKiP7bl19WB9Uz07bI8=
    <?xml version="1.0" encoding="utf-8"?>
    <Topic xmlns="http://mns.aliyuncs.com/doc/v1/">
          <MaximumMessageSize>65536</MaximumMessageSize>
        <LoggingEnabled>True</LoggingEnabled>
    </Topic>

Response example:

    HTTP/1.1 204 No Content
    x-mns-request-id:5666721CB2B71C9C1600001B
    x-mns-version: 2015-06-06