使用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:停用。
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 |
在文档使用中是否遇到以下问题
更多建议
匿名提交