更新时间:2023-08-16 GMT+08:00

创建主题或批量删除主题

功能介绍

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方式请参见获取项目ID

instance_id

String

实例ID。

表2 Query参数

参数

是否必选

参数类型

描述

action

String

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

请求参数

表3 请求Body参数

参数

是否必选

参数类型

描述

name

String

主题名称,只能由英文字母、数字、百分号、竖线、中划线、下划线组成,长度3~64个字符。

brokers

Array of strings

关联的代理。

queue_num

Number

队列数,范围1~50。

缺省值:8

permission

String

权限。

缺省值:all

topics

Array of strings

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

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

id

String

主题名称。

job_id

String

删除主题任务ID。

请求示例

创建一个主题,关联的代理为broker-0,队列数为3。

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

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

错误码

请参见错误码