更新时间:2023-05-06 GMT+08:00
创建主题或批量删除主题
功能介绍
创建主题或批量删除主题。
URI
POST /v2/{project_id}/instances/{instance_id}/topics
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID。 |
| instance_id | 是 | String | 实例ID。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| action | 否 | String | 批量删除topic时使用,不配置则为创建接口。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| name | 否 | String | 主题名称。 |
| brokers | 否 | Array of strings | 关联的代理。 |
| queue_num | 否 | Number | 队列数。 缺省值:3 |
| permission | 否 | String | 权限。 缺省值:all |
| topics | 否 | Array of strings | 主题列表,当批量删除主题时使用。 |
响应参数
状态码: 200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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管理