使用CreateTopic接口创建主题(Topic)。

描述

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

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

Request

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

  • 请求行

    PUT /topics/$TopicName HTTP/1.1

  • 特有Request Header

    无,请参见公共参数

  • Request Body

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

参数名称 是否必选 说明 参数值
MaximumMessageSize 发送到该主题的消息体最大长度,单位为Byte 1024(1KB) - 65536(64KB)范围内的某个整数值,默认值为65536(64KB)
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

错误代码 错误消息 状态码
TopicAlreadyExist The topic you want to create is already exists. 409
TopicNameLengthError Topic name length is out of range, should be between 1 and 255. 400