更新时间:2024-01-19 GMT+08:00
分享

创建Topic

功能介绍

创建Topic。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方式请参见API参考的“附录 > 获取项目ID”章节。

instance_id

String

实例ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

name

String

topic名称,以字母开头,仅能包含数字,字母,下划线(_),中划线(-),长度3-200字符。

app_id

String

集成应用key。

app_key

String

集成应用key。

partition

Integer

topic分区数,设置消费的并发数。

取值范围:1-100。

默认值:3。

replication

Integer

副本数,配置数据的可靠性。

取值范围:1-3。

默认值:3。

说明:
  • 消息集成轻量化版的副本数只能为1。

  • 基础版的取值范围: 1-3。

  • 专业版/高性能设备接入版(一百万)取值范围: 1-5。

  • 高性能设备接入版(一千万)取值范围:1-8。

access_policy

String

权限类型。

  • all:发布+订阅

  • pub:发布

  • sub:订阅

sync_message_flush

Boolean

是否使用同步落盘。默认值为false。同步落盘会导致性能降低。

sync_replication

Boolean

是否开启同步复制,开启后,客户端生产消息时相应的也要设置acks=-1,否则不生效,默认关闭。

retention_time

Integer

消息老化时间。默认值为72。取值范围1~168,单位小时。

tag

String

权限类型对应的标签。

当权限类型是all时,发布和订阅的标签用符号“&”隔开。

当有多个标签时,标签用符号“||”隔开。

description

String

描述。长度0-1000字符。

sensitive_word

String

敏感字段。

当有多个敏感字段时,敏感字段用符号“||”隔开。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

name

String

topic名称。

状态码: 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码: 403

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

请求示例

创建一个Topic,分区数为3,副本数为3,消息老化时间为72小时

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

{
  "name" : "topic-test-2",
  "app_id" : "c5abd910-02b1-4bc4-b587-c3fe4c49dab9",
  "partition" : 3,
  "access_policy" : "all",
  "replication" : 3,
  "retention_time" : 72,
  "sync_replication" : false,
  "sync_message_flush" : false,
  "tag" : "11 || 22 || aa || bb&11 || 22 || aa || bb",
  "description" : "test",
  "sensitive_word" : "sss || ddd"
}

响应示例

状态码: 200

OK

{
  "name" : "topic-mqs-test"
}

状态码: 400

Bad Request

{
  "error_code" : 400,
  "error_msg" : "Bad Request"
}

状态码: 403

Forbidden

{
  "error_code" : 403,
  "error_msg" : "Forbidden"
}

状态码

状态码

描述

200

OK

400

Bad Request

403

Forbidden

错误码

请参见错误码

分享:

    相关文档

    相关产品