Todos os produtos
Search
Central de documentação

Simple Log Service:create_consumer_group

Última atualização: Jul 03, 2026

Cria um grupo de consumidores para um Logstore especificado.

Sintaxe da requisição

aliyunlog log create_consumer_group --project=<value> --logstore=<value> --consumer_group=<value> --timeout=<value> [--in_order=<value>] [--access-id=<value>] [--access-key=<value>] [--sts-token=<value>] [--region-endpoint=<value>] [--client-name=<value>] [--jmes-filter=<value>] [--format-output=<value>] [--decode-output=<value>]

Parâmetros da requisição

Parâmetros específicos do comando create_consumer_group.

Parameter

Type

Required

Example

Description

--project

String

Yes

aliyun-test-project

Nome do projeto.

--logstore

String

Yes

logstore-a

Nome do Logstore.

--consumer_group

String

Yes

consumer-group-1

Nome do grupo de consumidores. O nome deve ser exclusivo no projeto.

--timeout

Integer

Yes

300

Tempo limite. Unidade: segundos.

Os consumidores enviam heartbeats periódicos ao Log Service. Se nenhum heartbeat for recebido nesse período, o Log Service libera os recursos do consumidor.

--in_order

Boolean

No

true

Indica se os dados do shard são consumidos em sequência. Valores válidos:

  • true: consome os dados do shard sequencialmente. Após a divisão de um shard, o sistema consome primeiro o shard original e depois os novos shards simultaneamente.

  • false (padrão): consome os dados do shard sem garantia de ordem.

Para obter informações sobre os parâmetros globais da interface de linha de comando (CLI) do Log Service, consulte Parâmetros globais.

Exemplos

  • Crie um grupo de consumidores para o logstore-a com a conta padrão:

    aliyunlog log create_consumer_group --project="aliyun-test-project" --logstore="logstore-a" --consumer_group="consumer-group-1" --timeout="300" --in_order=true
  • Consulte o grupo de consumidores:

    aliyunlog log list_consumer_group --project="aliyun-test-project" --logstore="logstore-a"

    Resposta de exemplo:

    [
      {
        "name": "consumer-group-1",
        "order": true,
        "timeout": 300
      }
    ]

Códigos de erro

Se houver mensagem de erro, corrija o problema com base nos códigos de erro da operação de API relacionada. Para mais informações, consulte Códigos de erro.

Referência da API

CreateConsumerGroup