全部产品
云市场

CreateTopic

更新时间:2019-10-09 14:55:54

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

描述

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

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

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

示例

请求示例:

  1. PUT /topics/$TopicName HTTP/1.1
  2. Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
  3. Date: Tue, 08 Dec 2015 05:57:57 GMT
  4. x-mns-version: 2015-06-06
  5. Authorization:MNS 15B4D3461F177624206A:eCtaUwfGS0oEfznzJEhWFxpf2yk=
  6. <?xml version="1.0" encoding="utf-8"?>
  7. <Topic xmlns="http://mns.aliyuncs.com/doc/v1/">
  8. <MaximumMessageSize>10240</MaximumMessageSize>
  9. <LoggingEnabled>True</LoggingEnabled>
  10. </Topic>

返回示例:

  1. HTTP/1.1 201 Created
  2. x-mns-request-id:56667165B2B71C9C16000013
  3. x-mns-version: 2015-06-06
  4. 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 256. 400