CreateConsumerGroup

请求语法

POST /logstores/<logstoreName>/consumergroups HTTP/1.1
Authorization: <AuthorizationString>
x-log-bodyrawsize: 0
User-Agent: <UserAgent>
x-log-apiversion: 0.6.0
Host: <Project Endpoint>
x-log-signaturemethod: hmac-sha1
Date: <GMT Date>
Content-Type: application/json
Content-MD5: F58544E4D022CC28A93D0B7CC208A5AA
Content-Length: <ContentLength>
{
  "consumerGroup": <consumerGroup>,
  "timeout": <timeout>,
  "order": <order>
}

请求参数

• 请求头

  CreateConsumerGroup接口无特有请求头，关于Log Service API的公共请求头，请参见公共请求头。

• 参数列表

  属性名称	类型	是否必须	示例值	描述
  logstoreName	string	是	my-logstore	Logstore的名称。
  consumerGroup	string	是	consumer-group-1	消费组名称，在Project下必须唯一。
  timeout	integer	是	300	超时时间，在超时时间段内没有收到心跳，消费者将被删除。
  order	bool	是	true	在单个shard中是否按顺序消费。 true：表示在单个shard中按顺序消费。shard分裂后，先消费原shard数据，然后并列消费两个新shard的数据。 false：表示不按顺序消费。

返回数据

• 响应头

  CreateConsumerGroup接口无特有响应头，关于Log Service API的公共响应头，请参见公共响应头。

• 响应元素

  HTTP状态码返回200。

示例

• 请求示例

  POST /logstores/my-logstore/consumergroups HTTP/1.1
  Header:
  Authorization: LOG <yourAccessKeyId>:<yourSignature>
  x-log-bodyrawsize: 0
  User-Agent: sls-java-sdk-v-0.6.1
  x-log-apiversion: 0.6.0
  Host: my-project.cn-shanghai.log.aliyuncs.com
  x-log-signaturemethod: hmac-sha1
  Date: Fri, 04 May 2018 08:02:22 GMT
  Content-Type: application/json
  Content-MD5: F58544E4D022CC28A93D0B7CC208A5AA
  Content-Length: 65
  Connection: Keep-Alive
  Body:
  {
    "consumerGroup": "consumer-group-1",
    "timeout": 300,
    "order": true
  }

• 正常返回示例

  HTTP/1.1 200
  Server: nginx/1.12.1
  Content-Length: 0
  Connection: close
  Access-Control-Allow-Origin: *
  Date: Fri, 04 May 2018 08:15:11 GMT
  x-log-requestid: 5AEC168FA796F4195BF404CB

错误码

更多错误码，请参见通用错误码。