更新时间:2021-06-16 GMT+08:00
分享

创建消费组

功能介绍

创建消费组。

可同时为指定队列创建多个消费组。

创建消费组后系统内部完成初始化需要1-3秒,如果创建消费组后立即进行操作,可能会导致消费失败。建议3秒后再操作该队列。

调试

您可以在API Explorer中调试该接口。

URI

POST /v2/{project_id}/queues/{queue_id}/groups

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

queue_id

String

指定的队列ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

groups

Array of GroupEntity objects

消费组信息。

每个队列最多能创建3个消费组,如果请求中的消费组个数超过3个,请求校验不通过,无法创建消费组。

表3 GroupEntity

参数

是否必选

参数类型

描述

name

String

消费组的名称。

长度不超过32位的字符串,仅包含a~z,A~Z,0~9、下划线(_)和中划线(-)。

响应参数

状态码: 201

表4 响应Body参数

参数

参数类型

描述

groups

Array<Object>

消费组信息。

表5 groups

参数

参数类型

描述

id

String

消费组的ID。

name

String

消费组的名称。

请求示例

POST https://{endpoint}/v2/{project_id}/queues/{queue_id}/groups

{
  "groups" : [ {
    "name" : "group-aa"
  } ]
}

响应示例

状态码: 201

消费组创建成功。

{
  "groups" : [ {
    "id" : "g-02fb1974-9be1-4eee-8448-ed2d3e89884a",
    "name" : "group-aa"
  } ]
}

状态码

状态码

描述

201

消费组创建成功。

错误码

请参见错误码

分享:

    相关文档

    相关产品

关闭导读