分布式消息服务 DMS分布式消息服务 DMS

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

创建消费组

当前页面API为历史版本API,未来可能停止维护。请使用创建消费组

功能介绍

创建消费组。

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

创建消费组后系统内部完成初始化需要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

消费组创建成功。

分享:

    相关文档

    相关产品