调用 CreateConsumerGroup 接口创建日志服务消费组(ConsumerGroup)。
本接口用于创建日志服务消费组。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
ProjectID | String | 是 | c7****** | 消费组所属的日志项目 ID。 |
TopicIDList | Array of String | 是 | ["a1******", "b2******"] | 消费组待消费的日志主题 ID 列表。 |
ConsumerGroupName | String | 是 | my-consumer-group | 消费组名称。命名规则请参考资源命名规则。 |
HeartbeatTTL | Integer | 是 | 60 | 心跳过期时间,单位为秒,取值范围为 1~300。 |
OrderedConsume | Boolean | 是 |
| 是否按顺序消费。
|
本接口无特有的返回参数。更多信息请见返回结构。
POST https://tls-{Region}.ivolces.com/CreateConsumerGroup HTTP/1.1 Content-Type: application/json { "ProjectID": "c7************", "TopicIDList": [ "a1******" ], "ConsumerGroupName": "my-consumer-group", "HeartbeatTTL": 60, "OrderedConsume": false }
HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
HTTP 状态码 | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | InvalidArgument | Invalid argument key %s, value %s, please check argument. | 参数不合法。 |
400 | InvalidArgument | Invalid argument key %s, value %s, acceptable value: %s please check argument. | 参数不合法。 |
400 | ExceedConsumerGroupProjectQuota | Exceed project's consumer group quota, projectID: %s | 超过日志项目消费组配额。 |
400 | ConsumerGroupAlreadyExists | consumer group already exists | 消费者组已存在。 |
500 | InternalServerError | We encountered an unexpected server error, please try again later. | 服务器内部错误。 |