使用SetTopicAttributes接口来修改主题的属性。

Request

Request的构造主要由以下几个部分组成:

  • 请求行

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

  • 特有URI参数

    metaoverride=true将会修改主题的属性

  • 特有Request Header

    无,请参见公共参数

  • Request Body

    Request Body为XML格式,XML格式中包含设置主题的属性。

参数名称 是否必选 说明 参数值
MaximumMessageSize 发送到该Topic的消息体最大长度,单位为Byte 1024(1 KB)- 65536(64 KB)范围内的某个整数值
LoggingEnabled 是否开启日志管理功能,取值说明如下:
  • True:表示启用;
  • False:表示停用。
True/False

Response

返回消息由返回状态行、HTTP头和消息体三部分组成

  • HTTP Status Code

    HTTP/1.1 204 No Content

  • 特有Response Header

    无,请参见公共参数

  • Response Body

示例

请求示例:

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>
			

返回示例:

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

Special error

错误代码 错误消息 状态码
TopicNotExist The topic you provided does not exist. 404