文档首页 > > API参考> 队列与消息管理类接口> 创建消费组

创建消费组

分享
更新时间: 2019/08/06 GMT+08:00

功能介绍

创建消费组。

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

说明:

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

URI

POST /v1.0/{project_id}/queues/{queue_id}/groups

参数说明请参见表1

表1 参数说明

名称

类型

是否必选

说明

project_id

String

项目ID。

queue_id

String

指定的队列ID。

请求消息

请求参数

参数说明请参见表2

表2 参数说明

名称

类型

是否必选

说明

groups

Array

消费组信息。

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

表3 groups参数说明

名称

类型

是否必选

说明

name

String

消费组的名称。

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

请求示例

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

响应消息

响应参数

响应参数如表4所示。

表4 响应参数

参数

类型

描述

id

String

消费组的ID。

name

String

消费组的名称。

响应示例

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

状态码

操作成功的状态码如表5所示,操作失败的状态码请参考状态码

表5 状态码

状态码

描述

201

消费组创建成功。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区