CreateTopic

描述

该接口用于创建一个新的主题。

主题名称是一个不超过255个字符的字符串，必须以字母或数字为首字符，剩余部分可以包含字母、数字和横划线(-)。

Request

请求消息由以下几个部分组成：

• 请求行

  PUT /topics/$TopicName HTTP/1.1

• 特有Request Header

  无，请参见公共参数。

• Request Body

  Request Body为XML格式，XML中包含创建主题的属性。

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

Response

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

• HTTP Status Code

  HTTP/1.1 201 Created

  同一个所有者在同一个地域的主题不能重名，当出现创建重名的主题时，如果创建主题的属性与已经存在的主题属性相同，返回204（No Content），否则返回409（Conflict）。

• 特有Response Header

  参数名称	说明
  Location	返回创建的TopicURL，格式如下：http://$AccountId.mns.<Region>.aliyuncs.com/topics/$TopicName

  其余返回Header请参见公共参数。

• Response Body

  无

示例

请求示例：

PUT /topics/$TopicName HTTP/1.1
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Tue, 08 Dec 2015 05:57:57 GMT
x-mns-version: 2015-06-06
Authorization:MNS 15B4D3461F177624206A:eCtaUwfGS0oEfznzJEhWFxpf2yk=

<?xml version="1.0" encoding="utf-8"?>
<Topic xmlns="http://mns.aliyuncs.com/doc/v1/">
    <MaximumMessageSize>10240</MaximumMessageSize>
    <LoggingEnabled>True</LoggingEnabled>
</Topic>
			

返回示例：

HTTP/1.1 201 Created
x-mns-request-id:56667165B2B71C9C16000013
x-mns-version: 2015-06-06
Location: http://$AccountId.mns.cn-hangzhou.aliyuncs.com/topics/$TopicName
			

Special error