文档首页> 分布式消息服务RocketMQ版> API参考（阿布扎比区域）> API V2（推荐）> Topic管理> 创建主题或批量删除主题
更新时间：2023-05-06 GMT+08:00
查看PDF

创建主题或批量删除主题

功能介绍

创建主题或批量删除主题。

URI

POST /v2/{project_id}/instances/{instance_id}/topics

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。

instance_id

是

String

实例ID。
表2 Query参数

参数

是否必选

参数类型

描述

action

否

String

批量删除topic时使用，不配置则为创建接口。

请求参数

表3 请求Body参数

参数

是否必选

参数类型

描述

name

否

String

主题名称。

brokers

否

Array of strings

关联的代理。

queue_num

否

Number

队列数。

缺省值：3

permission

否

String

权限。

缺省值：all

topics

否

Array of strings

主题列表，当批量删除主题时使用。

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

id

String

主题名称。

job_id

String

删除主题任务ID。

请求示例

创建主题。

POST https://{endpoint}/v2/{project_id}/instances/{instance_id}/topics

{
  "name" : "topic-test",
  "brokers" : [ "broker-0" ],
  "queue_num" : 3,
  "permission" : "all"
}

响应示例

状态码： 200

创建主题或批量删除主题成功。

{
  "id" : "topic-test"
}

状态码

状态码

描述

200

创建主题或批量删除主题成功。

错误码

请参见错误码。

父主题： Topic管理