更新时间：2024-04-08 GMT+08:00
创建主题或批量删除主题
功能介绍
创建主题或批量删除主题。
URI
POST /v2/{project_id}/instances/{instance_id}/topics
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目ID，获取方式请参见获取项目ID。 |
instance_id |
是 |
String |
实例ID。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
action |
否 |
String |
批量删除topic时使用，不配置则为创建接口。删除操作：delete。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
name |
否 |
String |
主题名称，只能由英文字母、数字、百分号、竖线、中划线、下划线组成，长度3~64个字符。 |
brokers |
否 |
Array of strings |
关联的代理。 |
queue_num |
否 |
Number |
队列数，范围1~50。 缺省值：8 |
permission |
否 |
String |
权限。 缺省值：all |
message_type |
否 |
String |
消息类型（RocketMQ实例5.x版本才包含此参数）。 缺省值：all |
topics |
否 |
Array of strings |
主题列表，当批量删除主题时使用。 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
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 |
创建主题或批量删除主题成功。 |
错误码
请参见错误码。
父主题： Topic管理
