全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 智能硬件
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 更多
日志服务

CreateConsumerGroup

更新时间:2018-05-28 10:15:12

在指定的 Logstore 上创建一个消费组。

示例:

POST /logstores/{logstoreName}/consumergroups

请求语法

  1. POST /logstores/<logstoreName>/consumergroups HTTP/1.1
  2. Authorization: <AuthorizationString>
  3. x-log-bodyrawsize: 0
  4. User-Agent: <UserAgent>
  5. x-log-apiversion: 0.6.0
  6. Host: <Project Endpoint>
  7. x-log-signaturemethod: hmac-sha1
  8. Date: <GMT Date>
  9. Content-Type: application/json
  10. Content-MD5: F58544E4D022CC28A93D0B7CC208A5AA
  11. Content-Length: <ContentLength>
  12. {
  13. "consumerGroup": <consumerGroup>,
  14. "timeout": <timeout>,
  15. "order": <order>
  16. }

请求参数

属性名称 类型 是否必须 描述
logstoreName string Logstore 的名称。
consumerGroup string 消费组名称,在Project 下必须唯一。
timeout integer 超时时间,在超时时间段内没有收到心跳,消费组将被删除。
order bool 是否按顺序消费。

请求头

CreateConsumerGroup 接口无特有请求头,关于 Log Service API 的公共请求头请参考 公共请求头

响应头

CreateConsumerGroup 接口无特有响应头,关于 Log Service API 的公共响应头请参考 公共响应头

响应元素

HTTP 状态码返回 200。

错误码

除了返回 Log Service API 的 通用错误码,还可能返回如下特有错误码:

HTTP状态码 ErrorCode ErrorMessage
400 ConsumerGroupAlreadyExist consumer group already exist
400 JsonInfoInvalid consumerGroup or timeout is of error format
404 ProjectNotExist The Project does not exist : {Project}
404 LogStoreNotExist logstore {logstoreName} dose not exist
500 InternalServerError Specified Server Error Message

示例

请求示例:
  1. POST /logstores/my-logstore/consumergroups HTTP/1.1
  2. Header:
  3. Authorization: LOG LTRTfdR7fbosJYad:OK7Sldsxcv/8gz6YtrrmzR19Tgh=
  4. x-log-bodyrawsize: 0
  5. User-Agent: sls-java-sdk-v-0.6.1
  6. x-log-apiversion: 0.6.0
  7. Host: my-project.cn-shanghai.log.aliyuncs.com
  8. x-log-signaturemethod: hmac-sha1
  9. Date: Fri, 04 May 2018 08:02:22 GMT
  10. Content-Type: application/json
  11. Content-MD5: F58544E4D022CC28A93D0B7CC208A5AA
  12. Content-Length: 65
  13. Connection: Keep-Alive
  14. Body:
  15. {
  16. "consumerGroup": "consumer-group-1",
  17. "timeout": 300,
  18. "order": true
  19. }
响应示例:
  1. HTTP/1.1 200
  2. Server: nginx/1.12.1
  3. Content-Length: 0
  4. Connection: close
  5. Access-Control-Allow-Origin: *
  6. Date: Fri, 04 May 2018 08:15:11 GMT
  7. x-log-requestid: 5AEC168FA796F4195BF404CB
本文导读目录